mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-27 02:20:28 +00:00
69 lines
1.9 KiB
Plaintext
69 lines
1.9 KiB
Plaintext
caption: tm-edit-bitmap-operation
|
|
created: 20160424204236050
|
|
modified: 20230803045807664
|
|
tags: Messages
|
|
title: WidgetMessage: tm-edit-bitmap-operation
|
|
type: text/vnd.tiddlywiki
|
|
|
|
\define resizeDescription()
|
|
<div>
|
|
|
|
Resizes the image to the specified width and height. Parameters include:
|
|
|
|
|!Name |!Description |
|
|
|width |Specifies the width the image is resized to |
|
|
|height |Specifies the height the image is resized to |
|
|
|
|
</div>
|
|
\end
|
|
|
|
\define clearDescription()
|
|
<div>
|
|
|
|
Clears the contents of the image and fills it with a solid colour. Parameters include:
|
|
|
|
|!Name |!Description |
|
|
|colour |Colour the image should be filled with, defaults to <<.value "White">> |
|
|
|
|
<<.tip "The colour field can take any normal CSS colour value, including the hexadecimal representation or the RGB format.">>
|
|
</div>
|
|
\end
|
|
|
|
|
|
A `tm-edit-bitmap-operation` invokes one of the available operations on a __surrounding__ bitmap editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the `event` object are required:
|
|
|
|
|!Name |!Description |
|
|
|param |Name of the operation to be executed, see ''below'' for a list of possible operations |
|
|
|//{any other params}// |Any other parameters are made available as variables within the context of the widget message. |
|
|
|
|
|
|
The `tm-edit-bitmap-operation` message is usually generated by a ButtonWidget or an [[ActionWidget|ActionWidgets]] and is handled by the surrounding bitmap editor.
|
|
|
|
! Bitmap Operations
|
|
|
|
At this point the following bitmap operations have been implemented:
|
|
|
|
|!Name |!Description |
|
|
|<<.def "resize">>|<<resizeDescription>> |
|
|
|<<.def "clear">>|<<clearDescription>> |
|
|
|
|
|
|
!Example
|
|
|
|
An example can be seen in [[$:/core/ui/EditorToolbar/size-dropdown]]:
|
|
|
|
```
|
|
<$button>
|
|
<$action-sendmessage
|
|
$message="tm-edit-bitmap-operation"
|
|
$param="resize"
|
|
width={{$config-title$/new-width}}
|
|
height={{$config-title$/new-height}}
|
|
/>
|
|
...
|
|
Resize
|
|
</$button>
|
|
```
|
|
|
|
|