nuke.PythonCustomKnob¶
-
class
nuke.
PythonCustomKnob
¶ Bases:
Script_Knob
Methods
- return
Class name.
Clear animation for channel ‘c’.
Clear flag.
Get the current command.
- param message
message to put the knob in error, and do a popup.
- param message
message to put out to the error console, attached to the knob, if the verbosity level is set high enough.
- return
True if the knob is enabled, False if it’s disabled.
- param message
message to put the knob in error.
Execute the command.
Initialise from script.
Returns the fully-qualified name of the knob within the node.
Return derivative at time ‘t’ for channel ‘c’.
Returns whether the input flag is set.
Return integral at the interval [t1, t2] for channel ‘c’.
Return keyframe index at time ‘t’ for channel ‘c’.
Get all unique keys on the knob.
Return index of the keyframe at time ‘t’ for channel ‘c’.
Return nth derivative at time ‘t’ for channel ‘c’.
Return number of keyframes for channel ‘c’.
Returns the custom knob object as created in the by the ‘command’ argument to the PyCuston_Knob constructor.
Get the non-evaluated value of this knob - also see value() :param oc: Optional parameter specifying the output context.
self.value(oc) -> str
Return value at time ‘t’ for channel ‘c’.
Return True if animation at index ‘index’ has an expression.
Return True if channel ‘c’ is animated.
Return True if there is a keyframe at the current frame for channel ‘c’.
Return True if there is a keyframe at time ‘t’ for channel ‘c’.
- return
label.
- return
name.
Return the node that this knob belongs to.
Remove key for channel ‘c’.
Remove key at time ‘t’ for channel ‘c’.
Set channel ‘c’ to be animated.
Set the new command for this knob.
Enable or disable the knob.
Set the expression for a knob.
Logical OR of the argument and existing knob flags.
- param s
New label.
- param s
New name.
self.setValue(val, view=’default’) -> None
- param s
New tooltip.
Set the new command for this knob.
Sets the value ‘val’ at channel ‘chan’ for time ‘time’.
Show or hide the knob.
Split the view away from the current knob value.
Return the value of the knob in script syntax.
- return
tooltip.
Unsplit the view so that it shares a value with other views.
Get the current command.
- return
True if the knob is visible, False if it’s hidden.
- param message
message to put a warning on the knob.
-
Class
() → Class name.¶ - Returns
Class name.
-
clearAnimated
()¶ Clear animation for channel ‘c’. Return True if successful.
-
clearFlag
(f) → None.¶ Clear flag. :param f: Flag. :return: None.
-
command
() → str¶ Get the current command. :return: The current command as a string, or None if there is no current command.
-
critical
(message) → None.¶ - Parameters
message – message to put the knob in error, and do a popup.
- Returns
None.
-
debug
(message) → None.¶ - Parameters
message – message to put out to the error console, attached to the knob, if the verbosity level is set high enough.
- Returns
None.
-
enabled
() → Boolean.¶ - Returns
True if the knob is enabled, False if it’s disabled.
-
error
(message) → None.¶ - Parameters
message – message to put the knob in error.
- Returns
None.
-
execute
() → None¶ Execute the command. :return: None.
-
fromScript
()¶ Initialise from script.
-
fullyQualifiedName
(channel=- 1) → string¶ Returns the fully-qualified name of the knob within the node. This can be useful for expression linking.
- Parameters
channel – Optional parameter, specifies the channel number of the sub-knob (for example, channels of 0 and 1 would refer to the x and y of a XY_Knob respectively), leave blank or set to -1 to get the qualified name of the knob only.
- Returns
The string of the qualified knob or sub-knob, which can be used directly in expression links.
-
getDerivative
()¶ Return derivative at time ‘t’ for channel ‘c’.
-
getFlag
(f) → Bool.¶ Returns whether the input flag is set. :param f: Flag. :return: True if set, False otherwise.
-
getIntegral
()¶ Return integral at the interval [t1, t2] for channel ‘c’.
-
getKeyIndex
()¶ Return keyframe index at time ‘t’ for channel ‘c’.
-
getKeyList
()¶ Get all unique keys on the knob. Returns list.
-
getKeyTime
()¶ Return index of the keyframe at time ‘t’ for channel ‘c’.
-
getNthDerivative
()¶ Return nth derivative at time ‘t’ for channel ‘c’.
-
getNumKeys
()¶ Return number of keyframes for channel ‘c’.
-
getObject
()¶ Returns the custom knob object as created in the by the ‘command’ argument to the PyCuston_Knob constructor.
-
getText
(oc) → string¶ Get the non-evaluated value of this knob - also see value() :param oc: Optional parameter specifying the output context. Return text associated with knob.
-
getValue
()¶ self.value(oc) -> str
Get the evaluated value of this knob as a string - also see getText(). :param oc: Optional parameter specifying the output context. :return: String value.
-
getValueAt
()¶ Return value at time ‘t’ for channel ‘c’.
-
hasExpression
(index=- 1) → bool¶ Return True if animation at index ‘index’ has an expression. :param index: Optional index parameter. Defaults to -1 if not specified. This can be specified as a keyword parameter if desired. :return: True if has expression, False otherwise.
-
isAnimated
()¶ Return True if channel ‘c’ is animated.
-
isKey
()¶ Return True if there is a keyframe at the current frame for channel ‘c’.
-
isKeyAt
()¶ Return True if there is a keyframe at time ‘t’ for channel ‘c’.
-
label
() → label.¶ - Returns
label.
-
name
() → name.¶ - Returns
name.
-
node
() → nuke.Node¶ Return the node that this knob belongs to. If the node has been cloned, we’ll always return a reference to the original. :return: The node which owns this knob, or None if the knob has no owner yet.
-
removeKey
()¶ Remove key for channel ‘c’. Return True if successful.
-
removeKeyAt
()¶ Remove key at time ‘t’ for channel ‘c’. Return True if successful.
-
setAnimated
()¶ Set channel ‘c’ to be animated.
-
setCommand
(cmd) → None¶ Set the new command for this knob. :param cmd: String containing a TCL command. :return: None.
-
setEnabled
(enabled) → None.¶ Enable or disable the knob. :param enabled: True to enable the knob, False to disable it.
-
setExpression
(expression, channel=- 1, view=None) → bool¶ Set the expression for a knob. You can optionally specify a channel to set the expression for.
- Parameters
expression – The new expression for the knob. This should be a string.
channel – Optional parameter, specifying the channel to set the expression for. This should be an integer.
view – Optional view parameter. Without, this command will set the expression for the current view theinterface is displaying. Can be the name of the view or the index.
- Returns
True if successful, False if not.
-
setFlag
(f) → None.¶ Logical OR of the argument and existing knob flags. :param f: Flag. :return: None.
-
setLabel
(s) → None.¶ - Parameters
s – New label.
- Returns
None.
-
setName
(s) → None.¶ - Parameters
s – New name.
- Returns
None.
-
setText
()¶ self.setValue(val, view=’default’) -> None
Set value of knob. :param val: The new value. :param view: Optional parameter specifying which view to set the value for. If omitted, the value will be set for the default view. :return: None
-
setTooltip
(s) → None.¶ - Parameters
s – New tooltip.
- Returns
None.
-
setValue
(cmd) → None¶ Set the new command for this knob. :param cmd: String containing a TCL command. :return: None.
-
setValueAt
(val, time, chan) → bool¶ Sets the value ‘val’ at channel ‘chan’ for time ‘time’. :return: True if successful, False if not.
-
setVisible
(visible) → None.¶ Show or hide the knob. :param visible: True to show the knob, False to hide it.
-
splitView
(view) → None.¶ Split the view away from the current knob value. :param view: Optional view. Default is current view. :return: None.
-
toScript
(quote, context=current) → string.¶ Return the value of the knob in script syntax. Pass True for quote to return results quoted in {}. Pass None for context to get results for all views and key times (as stored in a .nk file).
-
tooltip
() → tooltip.¶ - Returns
tooltip.
-
unsplitView
(view) → None.¶ Unsplit the view so that it shares a value with other views. :param view: Optional view. Default is current view. :return: None.
-
value
() → str¶ Get the current command. :return: The current command as a string, or None if there is no current command.
-
visible
() → Boolean.¶ - Returns
True if the knob is visible, False if it’s hidden.
-
warning
(message) → None.¶ - Parameters
message – message to put a warning on the knob.
- Returns
None.