The main takeaway from this update is the API. This new version is a first step towards v1.0. Now, most common operations can be reused via “actuator.api” import. On of the neat things about this release is a “state” object. With this object the user is now can store the state between sequence executions. One of the many applications is cycling through tools or brushes.
Fixes and changes
- Fix: Once created, script steps and Filter steps of the same type share the settings.
- Change: Simplified menu, Tools – Augmented Brush – Actuator – Configure is now Tools – Augmented Brush – Actuator: Configure
API
Note that the API is a subject to change in the future. Keep watch on console output for deprecation warnings.
For up to date API reference consult this page.
Keystrokes
Functions:
- send_keystroke – generate keystroke like “Ctrl+J” by providing the string with a keystroke. Only supported on Windows.
List of supported keys:
‘LMButton’, ‘RMButton’, ‘MMButton’, ‘Backspace’, ‘Tab’, ‘Enter’, ‘Shift’, ‘Ctrl’, ‘Alt’, ‘CapsLock’, ‘Esc’, ‘Space’, ‘PgUp’, ‘PgDn’, ‘End’, ‘Home’, ‘Left’, ‘Up’, ‘Right’, ‘Down’, ‘Ins’, ‘Del’, ‘0’, ‘1’, ‘2’, ‘3’, ‘4’, ‘5’, ‘6’, ‘7’, ‘8’, ‘9’, ‘A’, ‘B’, ‘C’, ‘D’, ‘E’, ‘F’, ‘G’, ‘H’, ‘I’, ‘J’, ‘K’, ‘L’, ‘M’, ‘N’, ‘O’, ‘P’, ‘Q’, ‘R’, ‘S’, ‘T’, ‘U’, ‘V’, ‘W’, ‘X’, ‘Y’, ‘Z’, ‘LWin’, ‘RWin’, ‘-‘, ‘.’, ‘/’, ‘F1’, ‘F2’, ‘F3’, ‘F4’, ‘F5’, ‘F6’, ‘F7’, ‘F8’, ‘F9’, ‘F10’, ‘F11’, ‘F12’, ‘F13’, ‘F14’, ‘F15’, ‘F16’, ‘F17’, ‘F18’, ‘F19’, ‘F20’, ‘F21’, ‘F22’, ‘F23’, ‘F24’
User Interface
Is a bulk part of the api. With these symbold use will be able to quickly construct interactive sequence without much of a coding.
Dialogs
Classes:
- CustomIntDialog – Create this dialog to extract the integer value from a user
- SelectItemsDialog – Dialog to let the user select multiple items with a checkbox
Functions:
- get_color_with_dialog – Show color-picker dialog to select color
- get_selected_items – Provide the function with a list of items and get list of selected indices
Actions
Scripting alternatives to built in actions.
Classes:
- Action – analog of Krita.instance().action(“”)
There are following actions implemented:
- deselect
- duplicate
Color
Functionality to manipulate colors
Functions:
- rgba_to_hexa – Convert RGBA (123, 245, 123, 210) to HEX with alpha (#945d5dff)
- rgba_to_hex – Convert RGBA (123, 245, 123, 210) to HEX without (#945d5d)
- hex_to_rgb – Convert HEX color #945d5d to RGB value (231, 12, 54)
- rgb_to_hsl – Convert RGB to HSL
- hex_to_hsl – Convert HEX color string to HSL
- rgb_to_hsv – Convert RGB to HSV
- hex_to_hsv – Convert HEX string to HSV
Utils
Functions:
- halt – wait for some time before continuing operations
Objects:
- state – Pure python dictionary. Useful to save state between sequence executions. Preserves the state only during application runtime. After closing the application the state is lost.