Sidebar

reference:scripting_reference:scripting_objects:scriptcommand

In a script's OnInit method it can call the ScriptInitData.AddCommand method to add commands to the Opus internal command set. Each call to AddCommand returns a ScriptCommand object that the script needs to initialize.

Property Name Return Type Description

desc

string

Use this to set a description for the command, that is displayed in the Customize dialog when the user selects the command from the Commands tab.

fayt

object:ScriptFAYTCommand

Returns a ScriptFAYTCommand object that you can use to initialise this command to extend the FAYT field.

hide

bool

Set to True to hide this command from the drop-down command list shown in the command editor. This lets you add commands that can still be used in buttons and hotkeys but won't clutter up the command list.

icon

string

Use this property to assign a default icon to this command. You can specify the name of an internal icon (if you want to specify an icon from a particular set, use setname:iconname - use this if you have bundled your script in a script package with its own icon set) or the path of an external icon or image file.

label

string

Use this to set a label for the command. This is displayed in the Commands tab of the Customize dialog (under the Script Commands category), and will form the default label of the button created if the user drags that command out to a toolbar.

The actual name of the command (used to invoke the command) is assigned through the name property.

method

string

This is the name of the method that Opus will call in your script when the command is invoked. This would typically be set to OnXXXXX where XXXXX is the name of the command, however any method name can be used.

When the method is invoked it is passed a single argument, a ScriptCommandData object. Generically this method is referred to as OnScriptCommand.

name

string

This is the name of the command. This determines the name that will invoke the command when it is used in buttons and hotkeys.

noprogress

bool

Set to false if you don't want your command to display a progress indicator if more than one file is selected.

template

string

This lets you specify an optional command line template for the command. This is a string in the form ARGNAME1/MOD,ARGNAME2/MOD,ARGNAME3/MOD, etc, where ARGNAME is the name of the argument and /MOD are one or more modifiers used to indicate the argument type. The command line template can specify as many arguments as needed.

When your command is invoked and its OnScriptCommand event is triggered, any arguments supplied on the command line are parsed according to this template and provided via the ScriptCommandData.func.args property.