nuke.Scale_Knob¶
-
class
nuke.
Scale_Knob
¶ Bases:
Array_Knob
Methods
- return
Class name.
Return the AnimationCurve for the channel ‘chan’ and view ‘view’.
- param view
Optional view.
- return
List of knob values.
- return
Number of elements in array.
Delete animation.
Clear flag.
Copies the i’th channel of the AnimationCurve curve to this object.
Copies the AnimationCurves from curves to this object.
- 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
Default value.
Deletes the AnimationCurve.
- return
Dimensions in array.
- return
True if the knob is enabled, False if it’s disabled.
- param message
message to put the knob in error.
- return
Frame number.
Set value of the knob to a user defined script (TCL syntax, as in .nk file).
Returns the fully-qualified name of the knob within the node.
Return derivative at time ‘t’ and index ‘i’.
Returns whether the input flag is set.
Return integral at time interval [t1, t2] and index ‘i’.
Return index of the keyframe at time ‘t’ and channel ‘c’.
Get all unique keys on the knob.
Return time of the keyframe at time ‘t’ and channel ‘c’.
Return n’th derivative at time ‘t’ and index ‘i’.
Return number of keys at channel ‘c’.
self.value(index, view, time) -> Floating point or List of floating point values (in case some are different).
self.valueAt(time, index, view) -> Floating point or List of floating point values (in case some are different).
- param index
Optional index.
- return
Height of array of values.
- param index
Optional index.
- param index
Optional index.
Returns True if there is a keyframe at specified time, optional index and view, otherwise returns False.
- return
label.
- return
Maximum value.
self.max() -> Maximum value.
- return
Minimum value.
self.min() -> Minimum value.
- return
name.
Return name for dimension n.
Return the node that this knob belongs to.
- return
True if any of the values is not set to the default, False otherwise.
Remove key.
Remove keyframe at specified time, optional index and view.
Resize the array.
Create an Animation object.
- param s
Sequence of floating-point values.
Enable or disable the knob.
Set the expression for a knob.
Logical OR of the argument and existing knob flags.
Set a key on element ‘index’, at time and view.
- param s
New label.
- param s
New name.
Set range of values.
Set to just hold a single value or not.
- param s
New tooltip.
Set index to value at time and view.
Set value of element ‘index’ at time for view.
Show or hide the knob.
- param view
Optional view. Default is current view.
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.
Return value for dimension n.
Return value for this knob at specified time, optional index and view.
- return
List of knob values.
- return
True if the knob is visible, False if it’s hidden.
- param message
message to put a warning on the knob.
- return
Width of array of values.
Return value for x.
Return value for y.
Return value for z.
-
Class
() → Class name.¶ - Returns
Class name.
-
animation
(chan, view) → AnimationCurve or None.¶ Return the AnimationCurve for the channel ‘chan’ and view ‘view’. The view argument is optional. :param channel: The channel index. :param view: Optional view. :return: AnimationCurve or None.
-
animations
(view) → AnimationCurve list.¶ - Parameters
view – Optional view.
- Returns
AnimationCurve list.
Example: b = nuke.nodes.Blur() k = b[‘size’] k.setAnimated(0) a = k.animations() a[0].setKey(0, 11) a[0].setKey(10, 20)
-
array
() → List of knob values.¶ - Returns
List of knob values.
Should only be used for knobs that are neither animated nor get their values from a ValueProvider. For knobs like that, use Array_Knob.getValue, instead
-
arraySize
() → Number of elements in array.¶ - Returns
Number of elements in array.
-
clearAnimated
(index, view) → True if succeeded, False otherwise.¶ Delete animation. :param index: Optional index. :param view: Optional view. :return: True if succeeded, False otherwise.
-
clearFlag
(f) → None.¶ Clear flag. :param f: Flag. :return: None.
-
copyAnimation
(channel, curve, view) → None.¶ Copies the i’th channel of the AnimationCurve curve to this object. The view is optional and defaults to the current view. :param channel: The channel index. :param curve: AnimationCurve. :param view: Optional view. Defaults to current. :return: None.
-
copyAnimations
(curves, view) → None.¶ Copies the AnimationCurves from curves to this object. The view is optional and defaults to the current view. :param curves: AnimationCurve list. :param view: Optional view. Defaults to current. :return: None.
-
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.
-
defaultValue
() → Default value.¶ - Returns
Default value.
-
deleteAnimation
(curve) → None. Raises ValueError if not found.¶ Deletes the AnimationCurve. :param curve: An AnimationCurve instance which belongs to this Knob. :return: None. Raises ValueError if not found.
-
dimensions
() → Dimensions in array.¶ - Returns
Dimensions in array.
-
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.
-
frame
() → Frame number.¶ - Returns
Frame number.
-
fromScript
(s) → True if successful, False otherwise.¶ Set value of the knob to a user defined script (TCL syntax, as in .nk file). Return True if successful. :param s: Nuke script to be set on knob. :return: True if successful, False otherwise.
-
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’ and index ‘i’.
-
getFlag
(f) → Bool.¶ Returns whether the input flag is set. :param f: Flag. :return: True if set, False otherwise.
-
getIntegral
()¶ Return integral at time interval [t1, t2] and index ‘i’.
-
getKeyIndex
()¶ Return index of the keyframe at time ‘t’ and channel ‘c’.
-
getKeyList
()¶ Get all unique keys on the knob. Returns list.
-
getKeyTime
()¶ Return time of the keyframe at time ‘t’ and channel ‘c’.
-
getNthDerivative
()¶ Return n’th derivative at time ‘t’ and index ‘i’.
-
getNumKeys
()¶ Return number of keys at channel ‘c’.
-
getValue
()¶ self.value(index, view, time) -> Floating point or List of floating point values (in case some are different). :param index: Optional index. Default is 0. :param view: Optional view. :param time: Optional time. :return: Floating point or List of floating point values (in case some are different).
-
getValueAt
()¶ self.valueAt(time, index, view) -> Floating point or List of floating point values (in case some are different). Return value for this knob at specified time, optional index and view. :param time: Time. :param index: Optional index. Default is 0. :param view: Optional view. :return: Floating point or List of floating point values (in case some are different).
-
hasExpression
(index) → True if has expression, False otherwise.¶ - Parameters
index – Optional index.
- Returns
True if has expression, False otherwise.
-
height
() → Height of array of values.¶ - Returns
Height of array of values.
-
isAnimated
(index, view) → True if animated, False otherwise.¶ - Parameters
index – Optional index.
view – Optional view.
- Returns
True if animated, False otherwise.
-
isKey
(index, view) → True if succeeded, False otherwise.¶ - Parameters
index – Optional index.
view – Optional view.
- Returns
True if succeeded, False otherwise.
-
isKeyAt
(time, index, view) → True if succeeded, False otherwise.¶ Returns True if there is a keyframe at specified time, optional index and view, otherwise returns False. :param time: Time. :param index: Optional index. :param view: Optional view. :return: True if succeeded, False otherwise.
-
label
() → label.¶ - Returns
label.
-
max
() → Maximum value.¶ - Returns
Maximum value.
-
maximum
()¶ self.max() -> Maximum value. :return: Maximum value.
-
min
() → Minimum value.¶ - Returns
Minimum value.
-
minimum
()¶ self.min() -> Minimum value. :return: Minimum value.
-
name
() → name.¶ - Returns
name.
-
names
(n) → string¶ Return name for dimension n. The argument n is an integer.
-
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.
-
notDefault
() → True if any of the values is not set to the default, False otherwise.¶ - Returns
True if any of the values is not set to the default, False otherwise.
-
removeKey
(index, view) → True if succeeded, False otherwise.¶ Remove key. :param index: Optional index. :param view: Optional view. :return: True if succeeded, False otherwise.
-
removeKeyAt
(time, index, view) → True if succeeded, False otherwise.¶ Remove keyframe at specified time, optional index and view. Return True if successful. :param time: Time. :param index: Optional index. :param view: Optional view. :return: True if succeeded, False otherwise.
-
resize
(w, h) → True if successful, False otherwise.¶ Resize the array. :param w: New width :param h: Optional new height :return: True if successful, False otherwise.
-
setAnimated
(index, view) → True if succeeded, False otherwise.¶ Create an Animation object. Return True if successful, in which case caller must initialise it by calling setValue() or setValueAt(). :param index: Optional index. :param view: Optional view. :return: True if succeeded, False otherwise.
-
setDefaultValue
(s) → None.¶ - Parameters
s – Sequence of floating-point values.
- Returns
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.
-
setKeyAt
(time, index, view) → None.¶ Set a key on element ‘index’, at time and view. :param time: Time. :param index: Optional index. :param view: Optional view. :return: None.
-
setLabel
(s) → None.¶ - Parameters
s – New label.
- Returns
None.
-
setName
(s) → None.¶ - Parameters
s – New name.
- Returns
None.
-
setRange
(f1, f2) → None.¶ Set range of values. :param f1 Min value. :param f2 Max value. :return: None.
-
setSingleValue
(b, view) → None.¶ Set to just hold a single value or not. :param b: Boolean object. :param view: Optional view. Default is current view. :return: None.
-
setTooltip
(s) → None.¶ - Parameters
s – New tooltip.
- Returns
None.
-
setValue
(value, index, time, view) → True if value changed, False otherwise. Safe to ignore.¶ Set index to value at time and view. :param value: Floating point value. :param index: Optional index. :param time: Optional time. :param view: Optional view. :return: True if value changed, False otherwise. Safe to ignore.
-
setValueAt
(value, time, index, view) → bool.¶ Set value of element ‘index’ at time for view. If the knob is animated, it will set a new keyframe or change an existing one. Index and view are optional. Return True if successful. :param value: Floating point value. :param time: Time. :param index: Optional index. :param view: Optional view. :return: True if value changed, False otherwise. Safe to ignore.
-
setVisible
(visible) → None.¶ Show or hide the knob. :param visible: True to show the knob, False to hide it.
-
singleValue
(view) → True if holds a single value.¶ - Parameters
view – Optional view. Default is current view.
- Returns
True if holds a single value.
-
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) → String.¶ Return the value of the knob in script syntax. :param quote: Optional, default is False. Specify True to return the knob value quoted in {}. :param context: Optional context, default is current, None will be “contextless” (all views, all keys) as in a .nk file. :return: String.
-
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
(n, oc) → float¶ Return value for dimension n. The optional argument oc is an OutputContext.
-
valueAt
(time, index, view) → Floating point or List of floating point values (in case some are different).¶ Return value for this knob at specified time, optional index and view. :param time: Time. :param index: Optional index. Default is 0. :param view: Optional view. :return: Floating point or List of floating point values (in case some are different).
-
vect
() → List of knob values.¶ - Returns
List of knob values.
Should only be used for knobs that are neither animated nor get their values from a ValueProvider. For knobs like that, use Array_Knob.getValue, instead
-
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.
-
width
() → Width of array of values.¶ - Returns
Width of array of values.
-
x
(oc) → float¶ Return value for x. The optional oc argument is an OutputContext
-
y
(oc) → float¶ Return value for y. The optional oc argument is an OutputContext
-
z
(oc) → float¶ Return value for z. The optional oc argument is an OutputContext