!Warning: This page is currently under construction and the information it contains may be uncomplete and/or inaccurate.
Description
Designer functions were added in version 5.1/6 of Kinetic Designer.
They enable the operator to control different aspects of the current show directly from within a Javascript node.
Syntax
- Functions should be called with the prefix
designer.
in the javascript
- When passing
String
arguments, take care to use double quotes "
around the string. i.e. ("String argument"
)
- When passing
boolean
arguments use true
or false
- Take care that all arguments are filled for a function when calling it or the function call will be ignored by the script.
When certain arguments can be omitted from function calls, the manual page will explicitly describe all possible syntaxes.
*Note: When specifying targets, if several items in your show share the same name, the lists will be parsed from top to bottom and only the first item will be targeted.
Functions
Task
Timelines
Devices
Graphs
Variables
3D Scenes
3D Materials
File & Media Management
deleteFile() |
Delete a file |
copyFile() |
Copy a file |
renameFile() |
Rename a file |
renameTimestamped() |
Rename a file with a timestamped extension |
resizeImageToMaxWidth() |
Resize an image to a maximum width |
resizeImageToMaxHeight() |
Resize and image to a maximum height |
updateMediaPath() |
Update a target media using a file path |
updateMediaPathByTag() |
Update a target media using a file path. Target media with a tag |
Tools
addToLog() |
Add a message to Kinetic’s Console panel |
clearLog() |
Clear Kinetic’s Console panel |
addLogToClipboard() |
Copy Kinetic’s Console panel log to the clipboard |
msToHHMMSSFF() |
Convert milliseconds into a timecode formatted string |
Kinetic Designer
saveShow() |
Save current Show |
saveShowIncremental() |
Save current Show and increment filename. Equivalent to the Save+ option of the File top menu |
saveShowAs() |
Save current Show with a specific filename |
doBackup() |
Perform an automatic backup of the show in the /backup/ folder |
enableOnAir() |
Activate ON AIR on the Designer |
disableOnAir() |
Disable ON AIR on the Designer |
onlineAllVnode() |
Turn all VNodes online |
offlineAllVnode() |
Turn all VNodes offline |
haltDesigner() |
Power off the Designer |
rebootDesigner() |
Reboot the Designer |
quitDesigner() |
Quit the Designer application |
rescanMedia() |
Rescan for new new media added |
rescanMediaForce() |
Force the rescan of all media |
offAllTestPatterns() |
Turn off all test patterns |
offAllControlPoints() |
Turn off all control points |
offAllBlindOutput() |
Blind all outputs |
offAllSoloXmap() |
Remove all Solo modes from XMaps |
Special Functions
node.sendTriggerEvent() |
Send a TriggerEvent on an output pin of the Javascript node |
node.setValue() |
Set the value of an output pin on a Javascript node |
Visual Code
Add a link to Visual Code IDE
Explain here information on the typescript file and where it should be placed for auto-completion and help tooltips to work in Visual Code.