Skip to content

Instantly share code, notes, and snippets.

@sonictk
Created October 3, 2015 07:21
Show Gist options
  • Save sonictk/76bfe6fbfae6f592c777 to your computer and use it in GitHub Desktop.
Save sonictk/76bfe6fbfae6f592c777 to your computer and use it in GitHub Desktop.
Maya Python API 2.0 autocompletions
This file has been truncated, but you can view the full file.
class MAngle(object):
"""
Manipulate angular data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def asAngMinutes(self, *args, **kwargs):
"""
Returns the angular value, converted to minutes of arc.
"""
pass
def asAngSeconds(self, *args, **kwargs):
"""
Returns the angular value, converted to seconds of arc.
"""
pass
def asDegrees(self, *args, **kwargs):
"""
Returns the angular value, converted to degrees.
"""
pass
def asRadians(self, *args, **kwargs):
"""
Returns the angular value, converted to radians.
"""
pass
def asUnits(self, *args, **kwargs):
"""
Returns the angular value, converted to the specified units.
"""
pass
def internalToUI(self, *args, **kwargs):
"""
Converts a value from Mayas internal units to the units used in the UI.
"""
pass
def internalUnit(self, *args, **kwargs):
"""
Returns the angular unit used internally by Maya.
"""
pass
kAngMinutes = 3
kAngSeconds = 4
kDegrees = 2
kInvalid = 0
kLast = 5
kRadians = 1
def setUIUnit(self, *args, **kwargs):
"""
Sets the angular unit used in Mayas UI.
"""
pass
def uiToInternal(self, *args, **kwargs):
"""
Converts a value from the units used in the UI to Mayas internal units.
"""
pass
def uiUnit(self, *args, **kwargs):
"""
Returns the units used to display angles in Mayas UI.
"""
pass
@property
def unit(self, *args, **kwargs):
"""
Angular units used by the angle.
"""
pass
@property
def value(self, *args, **kwargs):
"""
Value of the angle.
"""
pass
class MArgDatabase(MArgParser):
"""
Command argument list parser which extends MArgParser with the
ability to return arguments and objects as MSelectionLists
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def commandArgumentBool(self, *args, **kwargs):
"""
commandArgumentBool(argIndex) -> bool
Returns the specified command argument as a bool.
"""
pass
def commandArgumentDouble(self, *args, **kwargs):
"""
Alias for commandArgumentFloat().
"""
pass
def commandArgumentFloat(self, *args, **kwargs):
"""
commandArgumentFloat(argIndex) -> float
Returns the specified command argument as a float.
"""
pass
def commandArgumentInt(self, *args, **kwargs):
"""
commandArgumentInt(argIndex) -> int
Returns the specified command argument as an int.
"""
pass
def commandArgumentMAngle(self, *args, **kwargs):
"""
commandArgumentMAngle(argIndex) -> MAngle
Returns the specified command argument as an MAngle.
"""
pass
def commandArgumentMDistance(self, *args, **kwargs):
"""
commandArgumentMDistance(argIndex) -> MDistance
Returns the specified command argument as an MDistance.
"""
pass
def commandArgumentMSelectionList(self, *args, **kwargs):
"""
commandArgumentMSelectionList(argIndex) -> MSelectionList
Returns the specified command argument as an MSelectionList.
"""
pass
def commandArgumentMTime(self, *args, **kwargs):
"""
commandArgumentMTime(argIndex) -> MTime
Returns the specified command argument as an MTime.
"""
pass
def commandArgumentString(self, *args, **kwargs):
"""
commandArgumentString(argIndex) -> unicode string
Returns the specified command argument as a string.
"""
pass
def flagArgumentBool(self, *args, **kwargs):
"""
flagArgumentBool(flagName, argIndex) -> bool
Returns the specified argument of the specified single-use flag as
a bool.
"""
pass
def flagArgumentDouble(self, *args, **kwargs):
"""
flagArgumentDouble(flagName, argIndex) -> float
Alias for flagArgumentFloat().
"""
pass
def flagArgumentFloat(self, *args, **kwargs):
"""
flagArgumentFloat(flagName, argIndex) -> float
Returns the specified argument of the specified single-use flag as
a float.
"""
pass
def flagArgumentInt(self, *args, **kwargs):
"""
flagArgumentInt(flagName, argIndex) -> int
Returns the specified argument of the specified single-use flag as
an int.
"""
pass
def flagArgumentMAngle(self, *args, **kwargs):
"""
flagArgumentMAngle(flagName, argIndex) -> MAngle
Returns the specified argument of the specified single-use flag as
an MAngle.
"""
pass
def flagArgumentMDistance(self, *args, **kwargs):
"""
flagArgumentMDistance(flagName, argIndex) -> MDistance
Returns the specified argument of the specified single-use flag as
an MDistance.
"""
pass
def flagArgumentMSelectionList(self, *args, **kwargs):
"""
flagArgumentMSelectionList(flagName, argIndex) -> MSelectionList
Returns the specified argument of the specified single-use flag as
an MSelectionList.
"""
pass
def flagArgumentMTime(self, *args, **kwargs):
"""
flagArgumentMTime(flagName, argIndex) -> MTime
Returns the specified argument of the specified single-use flag as
an MTime.
"""
pass
def flagArgumentString(self, *args, **kwargs):
"""
flagArgumentString(flagName, argIndex) -> string
Returns the specified argument of the specified single-use flag as
a string.
"""
pass
def getFlagArgumentList(self, *args, **kwargs):
"""
getFlagArgumentList(flagName, occurrence) -> MArgList
Returns the arguments for the specified occurrence of the given
multi-use flag as an MArgList. Raises RuntimeError if the flag has
not been enabled for multi-use. Raises IndexError if occurrence is
out of range.
"""
pass
def getFlagArgumentPosition(self, *args, **kwargs):
"""
getFlagArgumentPosition(flagName, occurrence) -> int
Returns the position in the argument list of the specified occurrence
of the given flag. Raises IndexError if occurrence is out of range.
"""
pass
def getObjectList(self, *args, **kwargs):
"""
getObjectList() -> MSelectionList
If the commands MSyntax has set the object format to kSelectionList
then this method will return the objects passed to the command as an
MSelectionList. If any other object format is set then an empty
selection list will be returned.
"""
pass
def getObjectStrings(self, *args, **kwargs):
"""
getObjectStrings() -> tuple of unicode strings
If the commands MSyntax has set the object format to kStringObjects
then this method will return the objects passed to the command as a
tuple of strings. If any other object format is set then an empty
tuple will be returned.
"""
pass
@property
def isEdit(self, *args, **kwargs):
"""
True if the edit flag is present.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
isFlagSet(flagName) -> bool
Returns True if the given flag appears on the command line.
"""
pass
@property
def isQuery(self, *args, **kwargs):
"""
True if the query flag is present.
"""
pass
def numberOfFlagUses(self, *args, **kwargs):
"""
numberOfFlagUses(flagName) -> int
Returns the number of times that the flag appears on the command
line.
"""
pass
@property
def numberOfFlagsUsed(self, *args, **kwargs):
"""
Number of different flags used on the command line. If the same flag appears multiple times it is only counted once.
"""
pass
class MArgList(object):
"""
Argument list for passing to commands.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addArg(self, *args, **kwargs):
"""
addArg(arg) -> self , arg is a numeric value, MAngle, MDistance,
MTime, MPoint or MVector.
Add an argument to the end of the arg list.
"""
pass
def asAngle(self, *args, **kwargs):
"""
asAngle(index) -> MAngle
Return an argument as an MAngle.
"""
pass
def asBool(self, *args, **kwargs):
"""
asBool(index) -> bool
Return an argument as a boolean.
"""
pass
def asDistance(self, *args, **kwargs):
"""
asDistance(index) -> MDistance
Return an argument as an MDistance.
"""
pass
def asDouble(self, *args, **kwargs):
"""
asDouble(index) -> float
Alias for asFloat().
"""
pass
def asDoubleArray(self, *args, **kwargs):
"""
asDoubleArray(index) -> MDoubleArray
Return a sequence of arguments as an MDoubleArray.
"""
pass
def asFloat(self, *args, **kwargs):
"""
asFloat(index) -> float
Return an argument as a float.
"""
pass
def asInt(self, *args, **kwargs):
"""
asInt(index) -> int
Return an argument as an integer.
"""
pass
def asIntArray(self, *args, **kwargs):
"""
asIntArray(index) -> MIntArray
Return a sequence of arguments as an MIntArray.
"""
pass
def asMatrix(self, *args, **kwargs):
"""
asMatrix(index) -> MMatrix
Return a sequence of arguments as an MMatrix.
"""
pass
def asPoint(self, *args, **kwargs):
"""
asPoint(index) -> MPoint
Return a sequence of arguments as an MPoint.
"""
pass
def asString(self, *args, **kwargs):
"""
asString(index) -> string
Return an argument as a string.
"""
pass
def asStringArray(self, *args, **kwargs):
"""
asStringArray(index) -> list of strings
Return a sequence of arguments as a list of strings.
"""
pass
def asTime(self, *args, **kwargs):
"""
asTime(index) -> MTime
Return an argument as an MTime.
"""
pass
def asVector(self, *args, **kwargs):
"""
asVector(index) -> MVector
Return a sequence of arguments as an MVector.
"""
pass
def flagIndex(self, *args, **kwargs):
"""
flagIndex(shortFlag, longFlag=None) -> int
Return index of first occurrence of specified flag.
"""
pass
kInvalidArgIndex = -1
def lastArgUsed(self, *args, **kwargs):
"""
lastArgUsed() -> int
Return index of last argument used by the most recent as*() method.
"""
pass
class MArgParser(object):
"""
Command argument list parser.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def commandArgumentBool(self, *args, **kwargs):
"""
commandArgumentBool(argIndex) -> bool
Returns the specified command argument as a bool.
"""
pass
def commandArgumentDouble(self, *args, **kwargs):
"""
Alias for commandArgumentFloat().
"""
pass
def commandArgumentFloat(self, *args, **kwargs):
"""
commandArgumentFloat(argIndex) -> float
Returns the specified command argument as a float.
"""
pass
def commandArgumentInt(self, *args, **kwargs):
"""
commandArgumentInt(argIndex) -> int
Returns the specified command argument as an int.
"""
pass
def commandArgumentMAngle(self, *args, **kwargs):
"""
commandArgumentMAngle(argIndex) -> MAngle
Returns the specified command argument as an MAngle.
"""
pass
def commandArgumentMDistance(self, *args, **kwargs):
"""
commandArgumentMDistance(argIndex) -> MDistance
Returns the specified command argument as an MDistance.
"""
pass
def commandArgumentMTime(self, *args, **kwargs):
"""
commandArgumentMTime(argIndex) -> MTime
Returns the specified command argument as an MTime.
"""
pass
def commandArgumentString(self, *args, **kwargs):
"""
commandArgumentString(argIndex) -> unicode string
Returns the specified command argument as a string.
"""
pass
def flagArgumentBool(self, *args, **kwargs):
"""
flagArgumentBool(flagName, argIndex) -> bool
Returns the specified argument of the specified single-use flag as
a bool.
"""
pass
def flagArgumentDouble(self, *args, **kwargs):
"""
flagArgumentDouble(flagName, argIndex) -> float
Alias for flagArgumentFloat().
"""
pass
def flagArgumentFloat(self, *args, **kwargs):
"""
flagArgumentFloat(flagName, argIndex) -> float
Returns the specified argument of the specified single-use flag as
a float.
"""
pass
def flagArgumentInt(self, *args, **kwargs):
"""
flagArgumentInt(flagName, argIndex) -> int
Returns the specified argument of the specified single-use flag as
an int.
"""
pass
def flagArgumentMAngle(self, *args, **kwargs):
"""
flagArgumentMAngle(flagName, argIndex) -> MAngle
Returns the specified argument of the specified single-use flag as
an MAngle.
"""
pass
def flagArgumentMDistance(self, *args, **kwargs):
"""
flagArgumentMDistance(flagName, argIndex) -> MDistance
Returns the specified argument of the specified single-use flag as
an MDistance.
"""
pass
def flagArgumentMTime(self, *args, **kwargs):
"""
flagArgumentMTime(flagName, argIndex) -> MTime
Returns the specified argument of the specified single-use flag as
an MTime.
"""
pass
def flagArgumentString(self, *args, **kwargs):
"""
flagArgumentString(flagName, argIndex) -> string
Returns the specified argument of the specified single-use flag as
a string.
"""
pass
def getFlagArgumentList(self, *args, **kwargs):
"""
getFlagArgumentList(flagName, occurrence) -> MArgList
Returns the arguments for the specified occurrence of the given
multi-use flag as an MArgList. Raises RuntimeError if the flag has
not been enabled for multi-use. Raises IndexError if occurrence is
out of range.
"""
pass
def getFlagArgumentPosition(self, *args, **kwargs):
"""
getFlagArgumentPosition(flagName, occurrence) -> int
Returns the position in the argument list of the specified occurrence
of the given flag. Raises IndexError if occurrence is out of range.
"""
pass
def getObjectStrings(self, *args, **kwargs):
"""
getObjectStrings() -> tuple of unicode strings
If the commands MSyntax has set the object format to kStringObjects
then this method will return the objects passed to the command as a
tuple of strings. If any other object format is set then an empty
tuple will be returned.
"""
pass
@property
def isEdit(self, *args, **kwargs):
"""
True if the edit flag is present.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
isFlagSet(flagName) -> bool
Returns True if the given flag appears on the command line.
"""
pass
@property
def isQuery(self, *args, **kwargs):
"""
True if the query flag is present.
"""
pass
def numberOfFlagUses(self, *args, **kwargs):
"""
numberOfFlagUses(flagName) -> int
Returns the number of times that the flag appears on the command
line.
"""
pass
@property
def numberOfFlagsUsed(self, *args, **kwargs):
"""
Number of different flags used on the command line. If the same flag appears multiple times it is only counted once.
"""
pass
class MArrayDataBuilder(object):
"""
Array builder for arrays in data blocks.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addElement(self, *args, **kwargs):
"""
addElement(index) -> MDataHandle
Adds a new element to the array at the given index.
* index (int) - the index at which we wish to add the new element
Returns The handle for the new element
"""
pass
def addElementArray(self, *args, **kwargs):
"""
addElementArray(index) -> MArrayDataHandle
Adds a new element to the array at the given index. The added element is also an array.
* index (int) - the index at which we wish to add the new element
Returns The handle for the new array element
"""
pass
def addLast(self, *args, **kwargs):
"""
addLast() -> MDataHandle
Adds a new element to the end of the array. The index of the element will be the current highest index + 1.
Returns The handle for the new element
"""
pass
def addLastArray(self, *args, **kwargs):
"""
addLastArray() -> MArrayDataHandle
Adds a new element to the end of the array. The added element is also an array. The index of the element will the current highest index + 1.
Returns The handle for the new array element
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source) -> self
Copy data from source builder.
* source (MArrayDataBuilder) - The source object to copy from
"""
pass
def growArray(self, *args, **kwargs):
"""
growArray(amount) -> self
Grows the array storage by the given amount.
* amount (int) - the amount to grow the array by
"""
pass
def removeElement(self, *args, **kwargs):
"""
removeElement(index) -> self
Removes the specified element from the array
* index (int) - the element of the array to remove
"""
pass
def setGrowSize(self, *args, **kwargs):
"""
setGrowSize(size) -> self
Sets the grow size of the array. As elements are added to the array, the builder will allocate memory in chunks. This method tells the builder how many elements to allocate each time it grows the array.
* size (int) - the number of elements to allocate when growing the array
"""
pass
class MArrayDataHandle(object):
"""
Data block handle for array data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def builder(self, *args, **kwargs):
"""
builder() -> MArrayDataBuilder
Returns a builder for this handles array so that it can be expanded.
This method will raise an exception if the current array does not support array data builders. This can be changed in a nodes initialize routine using the usesArrayDataBuilder attribute in MFnAttribute.
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle().
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source) -> self
Copy data from source array.
* source (MArrayDataHandle) - The source object to copy from
"""
pass
def elementLogicalIndex(self, *args, **kwargs):
"""
elementLogicalIndex() -> int
Returns the index that we are currently at in the array. It is possible for the index to be invalid, in which case the return status will report an error. These may be sparse arrays so the element index returned will be a logical index.
Raises an exception if there is no current element (e.g. if there are no elements).
"""
pass
def inputArrayValue(self, *args, **kwargs):
"""
inputArrayValue() -> MArrayDataHandle
Gets a handle into this data block for the current array element. This method should be used when the array elements are also arrays. The data represented by the handle will be valid. If the data is from an dirty connection, then the connection will be evaluated.
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle().
"""
pass
def inputValue(self, *args, **kwargs):
"""
inputValue() -> MDataHandle
Gets a handle into this data block for the current array element. The data represented by the handle will be valid. If the data is from an dirty connection, then the connection will be evaluated.
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle().
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Specifies whether or not there are more elements to iterate over.
"""
pass
def jumpToLogicalElement(self, *args, **kwargs):
"""
jumpToLogicalElement(index) -> self
Jump to a specific logical element in the array.
Since the logical array is sparse its indices may not be consecutive and a binary search is used internally to find the element.
Thus when iterating through the elements of the array it is much faster to do so using physical indices.
* index (int) - the logical index to jump to
"""
pass
def jumpToPhysicalElement(self, *args, **kwargs):
"""
jumpToPhysicalElement(position) -> self
Jump to a specific physical element in the array.
Since physical elements are contiguous no search is required.
* position (int) - the array position to jump to
"""
pass
def next(self, *args, **kwargs):
"""
next() -> bool
Advance to the next element in the array.
Return True if there was a next element and False if there wasnt.
"""
pass
def outputArrayValue(self, *args, **kwargs):
"""
outputArrayValue() -> MArrayDataHandle
Gets a handle into this data block for the current array element. This method should be used when the array elements are also arrays. The arrays elements are not evaluated and may no longer be valid. Therefore, this handle should only be used for writing over the data.
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle().
"""
pass
def outputValue(self, *args, **kwargs):
"""
outputValue() -> MDataHandle
Gets a handle into this data block for the current array element. The element is not evaluated so its data may not be valid. Therefore, this handle should only be used for writing over the data.
This method can also be used to retrieve handles to individual elements of non-datablock array handles, such as those returned by MPlug.getValue() and MPlug.asMDataHandle().
"""
pass
def set(self, *args, **kwargs):
"""
set(builder) -> self
Sets the data for this array from the data in the builder object
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle().
* builder (MArrayDataBuilder) - the builder object
"""
pass
def setAllClean(self, *args, **kwargs):
"""
setAllClean() -> self
Marks every element of the array attribute represented by the handle as clean. This method should be used if a compute function is asked to compute a single element of a multi, but instead calculates all the elements. Calling <i>setAllClean</i> in this situation will prevent further calls to the nodes compute method for the other elements of the multi.
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle()
"""
pass
def setClean(self, *args, **kwargs):
"""
setClean() -> self
Marks the data that is represented by this handle as being clean. This should be done after recalculating the data from the inputs.
Do not use with an MArrayDataHandle which was returned by MPlug.asMDataHandle().
"""
pass
class MAttributeIndex(object):
"""
The index information for an attribute specification.
"""
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source) -> self
Copy data from source index.
* source (MAttributeIndex) - The source index to copy from
"""
pass
def getLower(self, *args, **kwargs):
"""
getLower() -> int/float
Returns the lower bound of the index.
"""
pass
def getUpper(self, *args, **kwargs):
"""
getUpper() -> int/float
Returns the upper bound of the index.
"""
pass
def getValue(self, *args, **kwargs):
"""
getValue() -> int/float
Returns the current value of the index.
Raises an exception if the index is a range.
"""
pass
def hasLowerBound(self, *args, **kwargs):
"""
hasLowerBound() -> bool
Returns True if a lower bound is specified.
"""
pass
def hasRange(self, *args, **kwargs):
"""
hasRange() -> bool
Returns True if a range was specified.
"""
pass
def hasUpperBound(self, *args, **kwargs):
"""
hasUpperBound() -> bool
Returns True if an upper bound is specified.
"""
pass
def hasValidRange(self, *args, **kwargs):
"""
hasValidRange() -> bool
Returns True if upper bound is greater than lower bound.
"""
pass
def isBounded(self, *args, **kwargs):
"""
isBounded() -> bool
Returns True if the index is bounded.
"""
pass
kFloat = 1
kInteger = 0
def setLower(self, *args, **kwargs):
"""
setLower(value) -> self
Sets the lower bound of the index.
"""
pass
def setType(self, *args, **kwargs):
"""
setType(type) -> self
Sets the type of attribute index.
See type() for a list of valid index types.
* type (int) - the index type to set
"""
pass
def setUpper(self, *args, **kwargs):
"""
setUpper(value) -> self
Sets the upper bound of the index.
"""
pass
def setValue(self, *args, **kwargs):
"""
setValue(value) -> self
Sets the value of the index.
Remark: calling this method with an integer value will change its type to kInteger, and subsequently calling with a float value will change it to kFloat.
"""
pass
def type(self, *args, **kwargs):
"""
type() -> int
Returns the type of attribute index.
Valid index types:
kInteger Integer index (e.g. mesh.cp[5])
kFloat Floating-poing index (e.g. curve.u[1.3])
"""
pass
class MAttributePattern(object):
"""
Manipulate attribute structure patterns.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addRootAttr(self, *args, **kwargs):
"""
Add the given root attribute to this pattern.
"""
pass
def attrPattern(self, *args, **kwargs):
"""
Return the specified pattern indexed from the global list.
"""
pass
def attrPatternCount(self, *args, **kwargs):
"""
Return the global number of patterns created.
"""
pass
def findPattern(self, *args, **kwargs):
"""
Return a pattern with the given name, None if not found.
"""
pass
def name(self, *args, **kwargs):
"""
Return the name of the attribute pattern.
"""
pass
def removeRootAttr(self, *args, **kwargs):
"""
Return the nth or passed-in root attribute from this pattern.
"""
pass
def rootAttr(self, *args, **kwargs):
"""
Return the nth root attribute in this pattern.
"""
pass
def rootAttrCount(self, *args, **kwargs):
"""
Return the number of root attributes in this pattern.
"""
pass
class MAttributeSpec(object):
"""
Class that encapsulates component/attribute information for generating selection items.
"""
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source) -> self
Copy data from source specification.
* source (MAttributeSpec) - The source specification to copy from
"""
pass
@property
def dimensions(self, *args, **kwargs):
"""
The dimensions of the attribute specification.
"""
pass
@property
def name(self, *args, **kwargs):
"""
The name of the attribute specification.
"""
pass
class MAttributeSpecArray(object):
"""
Array of MAttributeSpec values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MBoundingBox(object):
"""
3D axis-aligned bounding box.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
@property
def center(self, *args, **kwargs):
"""
Center point
"""
pass
def clear(self, *args, **kwargs):
"""
Empties the bounding box, setting its corners to (0, 0, 0).
"""
pass
def contains(self, *args, **kwargs):
"""
Returns True if a point lies within the bounding box.
"""
pass
@property
def depth(self, *args, **kwargs):
"""
Size in Z
"""
pass
def expand(self, *args, **kwargs):
"""
Expands the bounding box to include a point or other bounding box.
"""
pass
@property
def height(self, *args, **kwargs):
"""
Size in Y
"""
pass
def intersects(self, *args, **kwargs):
"""
Returns True if any part of a given bounding box lies within this one.
"""
pass
@property
def max(self, *args, **kwargs):
"""
Maximum corner point
"""
pass
@property
def min(self, *args, **kwargs):
"""
Minimum corner point
"""
pass
def transformUsing(self, *args, **kwargs):
"""
Multiplies the bounding boxs corners by a matrix.
"""
pass
@property
def width(self, *args, **kwargs):
"""
Size in X
"""
pass
class MCallbackIdArray(object):
"""
Array of MCallbackId values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MColor(object):
"""
Manipulate color data.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __div__(self, *args, **kwargs):
"""
x.__div__(y) <==> x/y
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __idiv__(self, *args, **kwargs):
"""
x.__idiv__(y) <==> x/=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __rdiv__(self, *args, **kwargs):
"""
x.__rdiv__(y) <==> y/x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
@property
def a(self, *args, **kwargs):
"""
alpha component
"""
pass
@property
def b(self, *args, **kwargs):
"""
blue component
"""
pass
@property
def g(self, *args, **kwargs):
"""
green component
"""
pass
def getColor(self, *args, **kwargs):
"""
Returns a list containing the colors components, in the specified color model.
"""
pass
kByte = 1
kCMY = 2
kCMYK = 3
kFloat = 0
kHSV = 1
def kOpaqueBlack(self, *args, **kwargs):
"""
Manipulate color data.
"""
pass
kRGB = 0
kShort = 2
@property
def r(self, *args, **kwargs):
"""
red component
"""
pass
def setColor(self, *args, **kwargs):
"""
Sets the colors components and color model.
"""
pass
class MColorArray(object):
"""
Array of MColor values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MCommandMessage(MMessage):
"""
Class used to register callbacks for command related messages.
The class also provides the following MessageType constants which
describe the different types of output messages:
kHistory #Command history
kDisplay #String to display unmodified
kInfo #General information
kWarning #Warning message
kError #Error message
kResult #Result from a command execution in the command window
kStackTrace #Stack trace
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addCommandCallback(self, *args, **kwargs):
"""
addCommandCallback(function, clientData=None) -> id
This method registers a callback for command messages that are
issued every time a MEL command is executed. It is only called
when actual commands are executed and not when scripts are
executed.
NOTE: Setting up a callback using this method will
degrade the performance of Maya since the installed callback will be
invoked repeatedly as MEL operations are processed.
* function - callable which will be passed a string containing the
MEL command being executed, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addCommandOutputCallback(self, *args, **kwargs):
"""
addCommandOutputCallback(function, clientData=None) -> id
This method registers a callback for whenever MEL commands generate
output such as that which is printed into the command window.
* function - callable which will be passed a string containing the
MEL command being executed, a MessageType constant (see class docs
for a list) indicating the message type and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addCommandOutputFilterCallback(self, *args, **kwargs):
"""
addCommandOutputFilterCallback(function, clientData=None) -> id
This method registers a callback for whenever MEL commands generate
output such as that which is printed into the command window.
Returning True in the callback will filter the output from the
script editor and command line., returning False will keep the output.
* function - callable which will be passed a string containing the
MEL command being executed, a MessageType constant (see class docs
for a list) indicating the message type and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addProcCallback(self, *args, **kwargs):
"""
addProcCallback(function, clientData=None) -> id
This method registers a callback that is executed every time a MEL
procedure is run. The callback will be executed once when the procedure
is about to be executed, and again when it has exited. If a non-existent
procedure is called the callback will be called once for entry but there
will be no call on exit.
The callback cannot be registered multiple times. To register a new
callback function for this, please de-register the original callback first
NOTE: Setting up a callback using this method can potentially degrade the
performance of Maya since the installed callback will be invoked
repeatedly as MEL procedures are executed.
* function - callable which will be passed a string containing the name
of the procedure being invoked, an integer indicating the ID for the
procedures invocation, a bool set to True if the procedure is being entered,
false otherwise, a ProcType constant (see below for a list) indicating the
type of call this is (MEL proc or MEL command), and the clientData object
ProcType constant can take the folowing values:
kMELProc
kMELCommand
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kDefaultAction = 0
kDisplay = 1
kDoAction = 2
kDoNotDoAction = 1
kError = 4
kHistory = 0
kInfo = 2
kMELCommand = 1
kMELProc = 0
kResult = 5
kStackTrace = 6
kWarning = 3
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MConditionMessage(MMessage):
"""
Class used to register callbacks for condition related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addConditionCallback(self, *args, **kwargs):
"""
addConditionCallback(conditionName, function, clientData=None) -> id
This method registers a callback for condition changed messages.
The callback function will be passed the new state of the
condition and any client data that the user wishes to pass in.
* conditionName (string) - the condition to register the
callback for
* function - callable which will be passed a bool indicating
the new state of the condition, and the clientData object.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
def getConditionNames(self, *args, **kwargs):
"""
getConditionNames() -> (string, string, ...)
This method returns the list of available condition names.
* return: tuple of available condition names.
"""
pass
def getConditionState(self, *args, **kwargs):
"""
getConditionState(name) -> bool
This method returns the current state of a condition.
* name (string) - the name of the condition.
* return: The current state of the condition.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MContainerMessage(MMessage):
"""
Class used to register callbacks for container related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addBoundAttrCallback(self, *args, **kwargs):
"""
addBoundAttrCallback(function, clientData=None) -> id
This method registers a callback that is called whenever an attribute
is bound or unbound on a container.
* function - callable which will be passed a Node (the container)
,a string indicating the name of the bound attr, and
the clientData object.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addPublishAttrCallback(self, *args, **kwargs):
"""
addPublishAttrCallback(function, clientData=None) -> id
This method registers a callback that is called whenever an attribute
is published or unpublished from a container.
* function - callable which will be passed a Node (the container)
,a string indicating the name of the published attr, and
the clientData object.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MDAGDrawOverrideInfo(object):
"""
A data structure to store the per path draw override information.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
@property
def displayType(self, *args, **kwargs):
"""
Display type (kDisplayTypeNormal, kDisplayTypeReference or kDisplayTypeTemplate)
"""
pass
@property
def enableShading(self, *args, **kwargs):
"""
Whether allow to draw shaded item
"""
pass
@property
def enableTexturing(self, *args, **kwargs):
"""
Whether allow to draw textured item
"""
pass
@property
def enableVisible(self, *args, **kwargs):
"""
Whether the whole geometry is visible
"""
pass
kDisplayTypeNormal = 0
kDisplayTypeReference = 1
kDisplayTypeTemplate = 2
kLODBoundingBox = 1
kLODFull = 0
@property
def lod(self, *args, **kwargs):
"""
Level of detail (kLODFull or kLODBoundingBox)
"""
pass
@property
def overrideEnabled(self, *args, **kwargs):
"""
Draw override enabled or not
"""
pass
@property
def playbackVisible(self, *args, **kwargs):
"""
Whether the object is visible during playback
"""
pass
class MDGContext(object):
"""
Dependency graph context.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source) -> self
Copy data from source context.
* source (MDGContext) - The source object to copy from
"""
pass
def getTime(self, *args, **kwargs):
"""
Returns the time at which this context is set to evaluate.
"""
pass
def isNormal(self, *args, **kwargs):
"""
Returns True if the context is set to evaluate normally. Returns False if the context is set to evaluate at a specific time.
"""
pass
def kNormal(self, *args, **kwargs):
"""
Dependency graph context.
"""
pass
class MDGMessage(MMessage):
"""
Class used to register callbacks for Dependency Graph related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addConnectionCallback(self, *args, **kwargs):
"""
addConnectionCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a connection
is made or broken in the dependency graph. This callback is triggered
after the given connection has been made or broken, unlike the addPreConnectionCallback
which is triggered before the operation.
* function - callable which will be passed a MPlug indicating the source
plug of the connection, a MPlug indicating the destination plug of the
connection, a boolean set to True if a new connection will be made,
False if it will be broken and the clientData object.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addDelayedTimeChangeCallback(self, *args, **kwargs):
"""
addDelayedTimeChangeCallback(function, clientData=None) -> id
This method registers a callback that is called whenever the time
changes in the dependency graph, but after the time changed callback.
* function - callable which will be passed a MTime object indicating
the new time and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addDelayedTimeChangeRunupCallback(self, *args, **kwargs):
"""
addDelayedTimeChangeRunupCallback(function, clientData=None) -> id
This method registers a callback that is called whenever the time
changes in the dependency graph, but after the other time changed callbacks
which can be used to invoke a dynamics solve or runup if needed
* function - callable which will be passed a MTime object indicating
the new time and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addForceUpdateCallback(self, *args, **kwargs):
"""
addForceUpdateCallback(function, clientData=None) -> id
This method registers a callback that is called after the time
changes and after all nodes have been evaluated in the
dependency graph.
* function - callable which will be passed a MTime object indicating
the new time and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeAddedCallback(self, *args, **kwargs):
"""
addNodeAddedCallback(function, nodeType, clientData=None) -> id
This method registers a callback that is called whenever a new node
is added to the dependency graph.
The nodeType argument allows you to specify the type of nodes that
will trigger the callback. The default node type is dependNode which
matches all nodes.
* function - callable which will be passed a MObject indicating
the new node and the clientData object
* nodeType (MString) - type of node that will trigger the callback
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeChangeUuidCheckCallback(self, *args, **kwargs):
"""
addNodeChangeUuidCheckCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a node
may have its UUID changed. Possible causes include the rename command,
and the UUID for a node being read from a file during file I/O.
Note that nodes are assigned a UUID when they are created; this does
not invoke this callback. During file I/O the stored UUID is applied as
a separate step after creation (which does invoke this callback).
Depending on the situation Maya may or may not use the new UUID by default.
For example, when importing a file, Maya reads the UUID from the file
but does not use it. The boolean argument to the callback function lets
the callback know whether Maya is intending to use the UUID or not.
The callback returns a MMessage.Action constant:
* kDefaultAction - The callback does not want to change whether the
UUID is used or not.
* kDoNotDoAction - Do not use the new UUID.
* kDoAction - Use the new UUID.
In any case, the callback may leave the new uuid as is, or may provide
a new uuid of its own choosing to be used instead.
* function - callable which will be passed a boolean indicating whether
the UUID will be applied, a MObject indicating the node whose UUID may
be changed, the MUuid that may be applied to the node (typically the one
read from the file, during file I/O) - the callback may provide its own
uuid to be applied by changing this parameter - and the clientData object.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeRemovedCallback(self, *args, **kwargs):
"""
addNodeRemovedCallback(function, nodeType, clientData=None) -> id
This method registers a callback that is called whenever a new node
is removed from the dependency graph.
The nodeType argument allows you to specify the type of nodes that
will trigger the callback. The default node type is dependNode which
matches all nodes.
* function - callable which will be passed a MObject indicating
the node being removed and the clientData object
* nodeType (MString) - type of node that will trigger the callback
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addPreConnectionCallback(self, *args, **kwargs):
"""
addPreConnectionCallback(function, clientData=None) -> id
This method registers a callback that is called whenever any connection
is made or broken in the dependency graph. This callback is triggered before
the given connection has been made or broken, unlike the addConnectionCallback
which is triggered after the operation.
* function - callable which will be passed a MPlug indicating the source
plug of the connection, a MPlug indicating the destination plug of the
connection, a boolean set to True if a new connection will be made,
False if it will be broken and the clientData object.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addTimeChangeCallback(self, *args, **kwargs):
"""
addTimeChangeCallback(function, clientData=None) -> id
This method registers a callback that is called whenever the time
changes in the dependency graph.
* function - callable which will be passed a MTime object indicating
the new time and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MDGModifier(object):
"""
Used to change the structure of the dependency graph.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
addAttribute(MObject node, MObject attribute) -> self
Adds an operation to the modifier to add a new dynamic attribute to the
given dependency node. If the attribute is a compound its children will
be added as well, so only the parent needs to be added using this method.
"""
pass
def addExtensionAttribute(self, *args, **kwargs):
"""
addExtensionAttribute(MNodeClass nodeClass, MObject attribute) -> self
Adds an operation to the modifier to add a new extension attribute to
the given node class. If the attribute is a compound its children will be
added as well, so only the parent needs to be added using this method.
"""
pass
def commandToExecute(self, *args, **kwargs):
"""
commandToExecute(command) -> self
Adds an operation to the modifier to execute a MEL command. The command
should be fully undoable otherwise unexpected results may occur. If
the command contains no undoable portions whatsoever, the call to
doIt() may fail, but only after executing the command. It is best to
use multiple commandToExecute() calls rather than batching multiple
commands into a single call to commandToExecute(). They will still be
undone together, as a single undo action by the user, but Maya will
better be able to recover if one of the commands fails.
"""
pass
def connect(self, *args, **kwargs):
"""
connect(MPlug source, MPlug dest) -> self
connect(MObject sourceNode, MObject sourceAttr,
MObject destNode, MObject destAttr) -> self
Adds an operation to the modifier that connects two plugs in the
dependency graph. It is the users responsibility to ensure that the
source and destination attributes are of compatible types. For instance,
if the source attribute is a nurbs surface then the destination must
also be a nurbs surface.
Plugs can either be specified with node and attribute MObjects or with
MPlugs.
"""
pass
def createNode(self, *args, **kwargs):
"""
createNode(typeName) -> MObject
createNode(MTypeId typeId) -> MObject
Adds an operation to the modifier to create a node of the given type.
The new node is created and returned but will not be added to the
Dependency Graph until the modifiers doIt() method is called. Raises
TypeError if the named node type does not exist or if it is a DAG node
type.
"""
pass
def deleteNode(self, *args, **kwargs):
"""
deleteNode(MObject node) -> self
Adds an operation to the modifer which deletes the specified node from
the Dependency Graph. If the modifier already contains other operations
on the same node (e.g. a disconnect) then they should be committed by
calling the modifiers doIt() before the deleteNode operation is added.
"""
pass
def disconnect(self, *args, **kwargs):
"""
disconnect(MPlug source, MPlug dest) -> self
disconnect(MObject sourceNode, MObject sourceAttr,
MObject destNode, MObject destAttr) -> self
Adds an operation to the modifier that breaks a connection between two
plugs in the dependency graph.
Plugs can either be specified with node and attribute MObjects or with
MPlugs.
"""
pass
def doIt(self, *args, **kwargs):
"""
doIt() -> self
Executes the modifiers operations. If doIt() is called multiple times
in a row, without any intervening calls to undoIt(), then only the
operations which were added since the previous doIt() call will be
executed. If undoIt() has been called then the next call to doIt() will
do all operations.
"""
pass
def linkExtensionAttributeToPlugin(self, *args, **kwargs):
"""
linkExtensionAttributeToPlugin(MObject plugin, MObject attribute) -> self
The plugin can call this method to indicate that the extension attribute
defines part of the plugin, regardless of the node type to which it
attaches itself. This requirement is used when the plugin is checked to
see if it is in use or if is able to be unloaded or if it is required as
part of a stored file. For compound attributes only the topmost parent
attribute may be passed in and all of its children will be included,
recursively. Thus its not possible to link a child attribute to a
plugin by itself. Note that the link is established immediately and is
not affected by the modifiers doIt() or undoIt() methods.
"""
pass
def newPlugValue(self, *args, **kwargs):
"""
newPlugValue(MPlug plug, MObject value) -> self
Adds an operation to the modifier to set the value of a plug, where
value is an MObject data wrapper, such as created by the various
MFn*Data classes.
"""
pass
def newPlugValueBool(self, *args, **kwargs):
"""
newPlugValueBool(MPlug plug, bool value) -> self
Adds an operation to the modifier to set a value onto a bool plug.
"""
pass
def newPlugValueChar(self, *args, **kwargs):
"""
newPlugValueChar(MPlug plug, int value) -> self
Adds an operation to the modifier to set a value onto a char (single
byte signed integer) plug.
"""
pass
def newPlugValueDouble(self, *args, **kwargs):
"""
newPlugValueDouble(MPlug plug, float value) -> self
Adds an operation to the modifier to set a value onto a double-precision
float plug.
"""
pass
def newPlugValueFloat(self, *args, **kwargs):
"""
newPlugValueFloat(MPlug plug, float value) -> self
Adds an operation to the modifier to set a value onto a single-precision
float plug.
"""
pass
def newPlugValueInt(self, *args, **kwargs):
"""
newPlugValueInt(MPlug plug, int value) -> self
Adds an operation to the modifier to set a value onto an int plug.
"""
pass
def newPlugValueMAngle(self, *args, **kwargs):
"""
newPlugValueMAngle(MPlug plug, MAngle value) -> self
Adds an operation to the modifier to set a value onto an angle plug.
"""
pass
def newPlugValueMDistance(self, *args, **kwargs):
"""
newPlugValueMDistance(MPlug plug, MDistance value) -> self
Adds an operation to the modifier to set a value onto a distance plug.
"""
pass
def newPlugValueMTime(self, *args, **kwargs):
"""
newPlugValueMTime(MPlug plug, MTime value) -> self
Adds an operation to the modifier to set a value onto a time plug.
"""
pass
def newPlugValueShort(self, *args, **kwargs):
"""
newPlugValueShort(MPlug plug, int value) -> self
Adds an operation to the modifier to set a value onto a short
integer plug.
"""
pass
def newPlugValueString(self, *args, **kwargs):
"""
newPlugValueString(MPlug plug, string value) -> self
Adds an operation to the modifier to set a value onto a string plug.
"""
pass
def pythonCommandToExecute(self, *args, **kwargs):
"""
pythonCommandToExecute(callable) -> selfpythonCommandToExecute(commandString) -> self
Adds an operation to the modifier to execute a Python command, which
can be passed as either a Python callable or a string containing the
text of the Python code to be executed. The command should be fully
undoable otherwise unexpected results may occur. If the command
contains no undoable portions whatsoever, the call to doIt() may fail,
but only after executing the command. It is best to use multiple calls
rather than batching multiple commands into a single call to
pythonCommandToExecute(). They will still be undone together, as a
single undo action by the user, but Maya will better be able to
recover if one of the commands fails.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
removeAttribute(MObject node, MObject attribute) -> self
Adds an operation to the modifier to remove a dynamic attribute from the
given dependency node. If the attribute is a compound its children will
be removed as well, so only the parent needs to be removed using this
method. The attribute MObject passed in will be set to kNullObj. There
should be no function sets attached to the attribute at the time of the
call as their behaviour may become unpredictable.
"""
pass
def removeExtensionAttribute(self, *args, **kwargs):
"""
removeExtensionAttribute(MNodeClass nodeClass, MObject attribute) -> self
Adds an operation to the modifier to remove an extension attribute from
the given node class. If the attribute is a compound its children will
be removed as well, so only the parent needs to be removed using this
method. The attribute MObject passed in will be set to kNullObj. There
should be no function sets attached to the attribute at the time of the
call as their behaviour may become unpredictable.
"""
pass
def removeExtensionAttributeIfUnset(self, *args, **kwargs):
"""
removeExtensionAttributeIfUnset(MNodeClass nodeClass,
MObject attribute) -> self
Adds an operation to the modifier to remove an extension attribute from
the given node class, but only if there are no nodes in the graph with
non-default values for this attribute. If the attribute is a compound
its children will be removed as well, so only the parent needs to be
removed using this method. The attribute MObject passed in will be set
to kNullObj. There should be no function sets attached to the attribute
at the time of the call as their behaviour may become unpredictable.
"""
pass
def removeMultiInstance(self, *args, **kwargs):
"""
removeMultiInstance(MPlug plug, bool breakConnections) -> self
Adds an operation to the modifier to remove an element of a multi (array) plug.
"""
pass
def renameNode(self, *args, **kwargs):
"""
renameNode(MObject node, string newName) -> self
Adds an operation to the modifer to rename a node.
"""
pass
def setNodeLockState(self, *args, **kwargs):
"""
setNodeLockState(MObject node, bool newState) -> self
Adds an operation to the modifier to set the lockState of a node.
"""
pass
def undoIt(self, *args, **kwargs):
"""
undoIt() -> self
Undoes all of the operations that have been given to this modifier. It
is only valid to call this method after the doIt() method has been
called.
"""
pass
def unlinkExtensionAttributeFromPlugin(self, *args, **kwargs):
"""
unlinkExtensionAttributeFromPlugin(MObject plugin,
MObject attribute) -> self
The plugin can call this method to indicate that it no longer requires
an extension attribute for its operation. This requirement is used when
the plugin is checked to see if it is in use or if is able to be unloaded
or if it is required as part of a stored file. For compound attributes
only the topmost parent attribute may be passed in and all of its
children will be unlinked, recursively. Thus its not possible to unlink
a child attribute from a plugin by itself. Note that the link is broken
immediately and is not affected by the modifiers doIt() or undoIt()
methods.
"""
pass
class MDagMessage(MMessage):
"""
Class used to register callbacks for Dag related messages.
The class also provides the following DagMessage constants which describe the different types of DAG operations:
kParentAdded
kParentRemoved
kChildAdded
kChildRemoved
kChildReordered
kInstanceAdded
kInstanceRemoved
kInvalidMsg
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAllDagChangesCallback(self, *args, **kwargs):
"""
addAllDagChangesCallback(function, clientData=None) -> id
This method registers a callback that is called whenever any
DAG change is made to any DAG node.
* function - callable which will be passed a DagMessage constant
indicating the operation which triggered the callback (see class
docs for a list), a MDagPath to the parent, a MDagPath to the child
,and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addAllDagChangesDagPathCallback(self, *args, **kwargs):
"""
addAllDagChangesDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever a DAG
change is made to the specified DAG path.
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a DagMessage constant
indicating the operation which triggered the callback (see class
docs for a list), a MDagPath to the parent, a MDagPath to the child
,and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addChildAddedCallback(self, *args, **kwargs):
"""
addChildAddedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a child is
added in the DAG.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addChildAddedDagPathCallback(self, *args, **kwargs):
"""
addChildAddedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever a child is
added to the specified DAG node.
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addChildRemovedCallback(self, *args, **kwargs):
"""
addChildRemovedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a child is
removed in the DAG.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addChildRemovedDagPathCallback(self, *args, **kwargs):
"""
addChildRemovedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever a child is
removed from the specified DAG node.
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addChildReorderedCallback(self, *args, **kwargs):
"""
addChildReorderedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a child is
reordered in the DAG.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addChildReorderedDagPathCallback(self, *args, **kwargs):
"""
addChildReorderedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever a child of
the specified DAG node is reordered
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addDagCallback(self, *args, **kwargs):
"""
addDagCallback(msgType, function, clientData=None) -> id
This method registers a callback that is called for specified
DAG changes on all nodes. The callback will also receive the
DagMessage
* msgType (DagMessage) - The type of DAG change to trigger the callback
* function - callable which will be passed a DagMessage constant
indicating the operation which triggered the callback (see class
docs for a list), a MDagPath to the parent, a MDagPath to the child
,and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addDagDagPathCallback(self, *args, **kwargs):
"""
addDagDagPathCallback(node, msgType, function, clientData=None) -> id
This method registers a callback that is called for specified a DAG
change is made to the specified DAG path. The callback receives the
DagMessage as well.
* node (MDagPath) - the DAG node to register the callback for
* msgType (DagMessage) - The type of DAG change to trigger the callback
(see class docs for a list)
* function - callable which will be passed a DagMessage constant
indicating the operation which triggered the callback, a MDagPath
to the parent, a MDagPath to the child
,and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addInstanceAddedCallback(self, *args, **kwargs):
"""
addInstanceAddedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever any node in the DAG
is instanced.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addInstanceAddedDagPathCallback(self, *args, **kwargs):
"""
addInstanceAddedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever the specified node
is instanced
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addInstanceRemovedCallback(self, *args, **kwargs):
"""
addInstanceRemovedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever an instance of any DAG
node is removed or deleted.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addInstanceRemovedDagPathCallback(self, *args, **kwargs):
"""
addInstanceRemovedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever an instance of the specified
node is removed.
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addParentAddedCallback(self, *args, **kwargs):
"""
addParentAddedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a parent is
added in the DAG.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addParentAddedDagPathCallback(self, *args, **kwargs):
"""
addParentAddedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever a parent is
added to the specified DAG node.
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addParentRemovedCallback(self, *args, **kwargs):
"""
addParentRemovedCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a parent is
removed in the DAG.
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addParentRemovedDagPathCallback(self, *args, **kwargs):
"""
addParentRemovedDagPathCallback(node, function, clientData=None) -> id
This method registers a callback that is called whenever a parent is
removed from the specified DAG node.
* node (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MDagPath to the parent,
a MDagPath to the child, and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addWorldMatrixModifiedCallback(self, *args, **kwargs):
"""
addWorldMatrixModifiedCallback(node, function, clientData=None) -> id
This method registers a callback that is called when a DAG node\s worldMatrix
changes.
Since a node\s worldMatrix is affected by the transforms of its ancestors in
the DAG, it\s possible for there to be two different nodes involved: the
trigger node, whose transform has changed, and the affected node, whose
worldMatrix is affected by the change to the trigger.
The trigger node may be the same as the affected node, or it may be one of
its ancestors.
The callback is placed on the affected node, but it is the trigger node which
is passed to the callback.
If the trigger node\s transformation is already dirty (i.e. it has not been
evaluated since it was last changed) then the callback will not be triggered.
So if the trigger node\s transformation is modified multiple times between
evaluations, only the first one will result in the callback being called.
* affectedNode (MDagPath) - the DAG node to register the callback for
* function - callable which will be passed a MObject indicating the node
whose transformation has changed, a MatrixModifiedFlags constant showing
what has changed (see below for complete list) and the clientData object
* clientData - User defined data passed to the callback function
Available MatrixModifiedFlags constants:
Individual flags:
kScaleX kScaleY kScaleZ
kShearXY kShearXZ kShearYZ
kRotateX kRotateY kRotateZ
kTranslateX kTranslateY kTranslateZ
kScalePivotX kScalePivotY kScalePivotZ
kRotatePivotX kRotatePivotY kRotatePivotZ
kScaleTransX kScaleTransY kScaleTransZ
kRotateTransX kRotateTransY kRotateTransZ
kRotateOrientX kRotateOrientY kRotateOrientZ
kRotateOrder
Composite flags
kAll
kScale = kScaleX | kScaleY | kScaleZ
kShear = kShearXY | kShearXZ | kShearYZ
kRotation = kRotateX | kRotateY | kRotateZ
kTranslation = kTranslateX | kTranslateY | kTranslateZ
kScalePivot = kScalePivotX | kScalePivotY | kScalePivotZ
kRotatePivot = kRotatePivotX | kRotatePivotY | kRotatePivotZ
kScalePivotTrans = kScaleTransX | kScaleTransY | kScaleTransZ
kRotatePivotTrans = kRotateTransX | kRotateTransY | kRotateTransZ
kRotateOrient = kRotateOrientX | kRotateOrientY | kRotateOrientZ
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kAll = 268435455
kChildAdded = 2
kChildRemoved = 3
kChildReordered = 4
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
kInstanceAdded = 5
kInstanceRemoved = 6
kInvalidMsg = -1
kLast = 7
kParentAdded = 0
kParentRemoved = 1
kRotateOrder = 134217728
kRotateOrient = 117440512
kRotateOrientX = 16777216
kRotateOrientY = 33554432
kRotateOrientZ = 67108864
kRotatePivot = 229376
kRotatePivotTrans = 14680064
kRotatePivotX = 32768
kRotatePivotY = 65536
kRotatePivotZ = 131072
kRotateTransX = 2097152
kRotateTransY = 4194304
kRotateTransZ = 8388608
kRotateX = 64
kRotateY = 128
kRotateZ = 256
kRotation = 448
kScale = 7
kScalePivot = 28672
kScalePivotTrans = 1835008
kScalePivotX = 4096
kScalePivotY = 8192
kScalePivotZ = 16384
kScaleTransX = 262144
kScaleTransY = 524288
kScaleTransZ = 1048576
kScaleX = 1
kScaleY = 2
kScaleZ = 4
kShear = 56
kShearXY = 8
kShearXZ = 16
kShearYZ = 32
kTranslateX = 512
kTranslateY = 1024
kTranslateZ = 2048
kTranslation = 3584
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MDagModifier(MDGModifier):
"""
Used to change the structure of the DAG
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
addAttribute(MObject node, MObject attribute) -> self
Adds an operation to the modifier to add a new dynamic attribute to the
given dependency node. If the attribute is a compound its children will
be added as well, so only the parent needs to be added using this method.
"""
pass
def addExtensionAttribute(self, *args, **kwargs):
"""
addExtensionAttribute(MNodeClass nodeClass, MObject attribute) -> self
Adds an operation to the modifier to add a new extension attribute to
the given node class. If the attribute is a compound its children will be
added as well, so only the parent needs to be added using this method.
"""
pass
def commandToExecute(self, *args, **kwargs):
"""
commandToExecute(command) -> self
Adds an operation to the modifier to execute a MEL command. The command
should be fully undoable otherwise unexpected results may occur. If
the command contains no undoable portions whatsoever, the call to
doIt() may fail, but only after executing the command. It is best to
use multiple commandToExecute() calls rather than batching multiple
commands into a single call to commandToExecute(). They will still be
undone together, as a single undo action by the user, but Maya will
better be able to recover if one of the commands fails.
"""
pass
def connect(self, *args, **kwargs):
"""
connect(MPlug source, MPlug dest) -> self
connect(MObject sourceNode, MObject sourceAttr,
MObject destNode, MObject destAttr) -> self
Adds an operation to the modifier that connects two plugs in the
dependency graph. It is the users responsibility to ensure that the
source and destination attributes are of compatible types. For instance,
if the source attribute is a nurbs surface then the destination must
also be a nurbs surface.
Plugs can either be specified with node and attribute MObjects or with
MPlugs.
"""
pass
def createNode(self, *args, **kwargs):
"""
createNode(typeName, parent=MObject.kNullObj) -> new DAG node MObject
createNode(typeId, parent=MObject.kNullObj) -> new DAG node MObject
Adds an operation to the modifier to create a DAG node of the specified
type. If a parent DAG node is provided the new node will be parented
under it. If no parent is provided and the new DAG node is a transform
type then it will be parented under the world. In both of these cases
the method returns the new DAG node.
If no parent is provided and the new DAG node is not a transform type
then a transform node will be created and the child parented under that. The new transform will be parented under the world and it is the
transform node which will be returned by the method, not the child.
None of the newly created nodes will be added to the DAG until the
modifiers doIt() method is called.
"""
pass
def deleteNode(self, *args, **kwargs):
"""
deleteNode(MObject node) -> self
Adds an operation to the modifer which deletes the specified node from
the Dependency Graph. If the modifier already contains other operations
on the same node (e.g. a disconnect) then they should be committed by
calling the modifiers doIt() before the deleteNode operation is added.
"""
pass
def disconnect(self, *args, **kwargs):
"""
disconnect(MPlug source, MPlug dest) -> self
disconnect(MObject sourceNode, MObject sourceAttr,
MObject destNode, MObject destAttr) -> self
Adds an operation to the modifier that breaks a connection between two
plugs in the dependency graph.
Plugs can either be specified with node and attribute MObjects or with
MPlugs.
"""
pass
def doIt(self, *args, **kwargs):
"""
doIt() -> self
Executes the modifiers operations. If doIt() is called multiple times
in a row, without any intervening calls to undoIt(), then only the
operations which were added since the previous doIt() call will be
executed. If undoIt() has been called then the next call to doIt() will
do all operations.
"""
pass
def linkExtensionAttributeToPlugin(self, *args, **kwargs):
"""
linkExtensionAttributeToPlugin(MObject plugin, MObject attribute) -> self
The plugin can call this method to indicate that the extension attribute
defines part of the plugin, regardless of the node type to which it
attaches itself. This requirement is used when the plugin is checked to
see if it is in use or if is able to be unloaded or if it is required as
part of a stored file. For compound attributes only the topmost parent
attribute may be passed in and all of its children will be included,
recursively. Thus its not possible to link a child attribute to a
plugin by itself. Note that the link is established immediately and is
not affected by the modifiers doIt() or undoIt() methods.
"""
pass
def newPlugValue(self, *args, **kwargs):
"""
newPlugValue(MPlug plug, MObject value) -> self
Adds an operation to the modifier to set the value of a plug, where
value is an MObject data wrapper, such as created by the various
MFn*Data classes.
"""
pass
def newPlugValueBool(self, *args, **kwargs):
"""
newPlugValueBool(MPlug plug, bool value) -> self
Adds an operation to the modifier to set a value onto a bool plug.
"""
pass
def newPlugValueChar(self, *args, **kwargs):
"""
newPlugValueChar(MPlug plug, int value) -> self
Adds an operation to the modifier to set a value onto a char (single
byte signed integer) plug.
"""
pass
def newPlugValueDouble(self, *args, **kwargs):
"""
newPlugValueDouble(MPlug plug, float value) -> self
Adds an operation to the modifier to set a value onto a double-precision
float plug.
"""
pass
def newPlugValueFloat(self, *args, **kwargs):
"""
newPlugValueFloat(MPlug plug, float value) -> self
Adds an operation to the modifier to set a value onto a single-precision
float plug.
"""
pass
def newPlugValueInt(self, *args, **kwargs):
"""
newPlugValueInt(MPlug plug, int value) -> self
Adds an operation to the modifier to set a value onto an int plug.
"""
pass
def newPlugValueMAngle(self, *args, **kwargs):
"""
newPlugValueMAngle(MPlug plug, MAngle value) -> self
Adds an operation to the modifier to set a value onto an angle plug.
"""
pass
def newPlugValueMDistance(self, *args, **kwargs):
"""
newPlugValueMDistance(MPlug plug, MDistance value) -> self
Adds an operation to the modifier to set a value onto a distance plug.
"""
pass
def newPlugValueMTime(self, *args, **kwargs):
"""
newPlugValueMTime(MPlug plug, MTime value) -> self
Adds an operation to the modifier to set a value onto a time plug.
"""
pass
def newPlugValueShort(self, *args, **kwargs):
"""
newPlugValueShort(MPlug plug, int value) -> self
Adds an operation to the modifier to set a value onto a short
integer plug.
"""
pass
def newPlugValueString(self, *args, **kwargs):
"""
newPlugValueString(MPlug plug, string value) -> self
Adds an operation to the modifier to set a value onto a string plug.
"""
pass
def pythonCommandToExecute(self, *args, **kwargs):
"""
pythonCommandToExecute(callable) -> selfpythonCommandToExecute(commandString) -> self
Adds an operation to the modifier to execute a Python command, which
can be passed as either a Python callable or a string containing the
text of the Python code to be executed. The command should be fully
undoable otherwise unexpected results may occur. If the command
contains no undoable portions whatsoever, the call to doIt() may fail,
but only after executing the command. It is best to use multiple calls
rather than batching multiple commands into a single call to
pythonCommandToExecute(). They will still be undone together, as a
single undo action by the user, but Maya will better be able to
recover if one of the commands fails.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
removeAttribute(MObject node, MObject attribute) -> self
Adds an operation to the modifier to remove a dynamic attribute from the
given dependency node. If the attribute is a compound its children will
be removed as well, so only the parent needs to be removed using this
method. The attribute MObject passed in will be set to kNullObj. There
should be no function sets attached to the attribute at the time of the
call as their behaviour may become unpredictable.
"""
pass
def removeExtensionAttribute(self, *args, **kwargs):
"""
removeExtensionAttribute(MNodeClass nodeClass, MObject attribute) -> self
Adds an operation to the modifier to remove an extension attribute from
the given node class. If the attribute is a compound its children will
be removed as well, so only the parent needs to be removed using this
method. The attribute MObject passed in will be set to kNullObj. There
should be no function sets attached to the attribute at the time of the
call as their behaviour may become unpredictable.
"""
pass
def removeExtensionAttributeIfUnset(self, *args, **kwargs):
"""
removeExtensionAttributeIfUnset(MNodeClass nodeClass,
MObject attribute) -> self
Adds an operation to the modifier to remove an extension attribute from
the given node class, but only if there are no nodes in the graph with
non-default values for this attribute. If the attribute is a compound
its children will be removed as well, so only the parent needs to be
removed using this method. The attribute MObject passed in will be set
to kNullObj. There should be no function sets attached to the attribute
at the time of the call as their behaviour may become unpredictable.
"""
pass
def removeMultiInstance(self, *args, **kwargs):
"""
removeMultiInstance(MPlug plug, bool breakConnections) -> self
Adds an operation to the modifier to remove an element of a multi (array) plug.
"""
pass
def renameNode(self, *args, **kwargs):
"""
renameNode(MObject node, string newName) -> self
Adds an operation to the modifer to rename a node.
"""
pass
def reparentNode(self, *args, **kwargs):
"""
reparentNode(MObject node, newParent=MObject.kNullObj) -> self
Adds an operation to the modifier to reparent a DAG node under a
specified parent.
If no parent is provided then the DAG node will be reparented under the
world, so long as it is a transform type. If it is not a transform type
then the doIt() will raise a RuntimeError.
"""
pass
def setNodeLockState(self, *args, **kwargs):
"""
setNodeLockState(MObject node, bool newState) -> self
Adds an operation to the modifier to set the lockState of a node.
"""
pass
def undoIt(self, *args, **kwargs):
"""
undoIt() -> self
Undoes all of the operations that have been given to this modifier. It
is only valid to call this method after the doIt() method has been
called.
"""
pass
def unlinkExtensionAttributeFromPlugin(self, *args, **kwargs):
"""
unlinkExtensionAttributeFromPlugin(MObject plugin,
MObject attribute) -> self
The plugin can call this method to indicate that it no longer requires
an extension attribute for its operation. This requirement is used when
the plugin is checked to see if it is in use or if is able to be unloaded
or if it is required as part of a stored file. For compound attributes
only the topmost parent attribute may be passed in and all of its
children will be unlinked, recursively. Thus its not possible to unlink
a child attribute from a plugin by itself. Note that the link is broken
immediately and is not affected by the modifiers doIt() or undoIt()
methods.
"""
pass
class MDagPath(object):
"""
Path to a DAG node from the top of the DAG.
"""
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def apiType(self, *args, **kwargs):
"""
Returns the type of the object at the end of the path.
"""
pass
def child(self, *args, **kwargs):
"""
Returns the specified child of the object at the end of the path.
"""
pass
def childCount(self, *args, **kwargs):
"""
Returns the number of objects parented directly beneath the object at the end of the path.
"""
pass
def exclusiveMatrix(self, *args, **kwargs):
"""
Returns the matrix for all transforms in the path, excluding the end object.
"""
pass
def exclusiveMatrixInverse(self, *args, **kwargs):
"""
Returns the inverse of exclusiveMatrix().
"""
pass
def extendToShape(self, *args, **kwargs):
"""
Extends the path to the specified shape node parented directly beneath the transform at the current end of the path.
"""
pass
def fullPathName(self, *args, **kwargs):
"""
Returns a string representation of the path from the DAG root to the paths last node.
"""
pass
def getAPathTo(self, *args, **kwargs):
"""
Returns the first path found to the given node.
"""
pass
def getAllPathsTo(self, *args, **kwargs):
"""
Returns all paths to the given node.
"""
pass
def getDisplayStatus(self, *args, **kwargs):
"""
Returns the display status for this path.
"""
pass
def getDrawOverrideInfo(self, *args, **kwargs):
"""
Returns the draw override information for this path.
"""
pass
def getPath(self, *args, **kwargs):
"""
Returns the specified sub-path of this path.
"""
pass
def hasFn(self, *args, **kwargs):
"""
Returns True if the object at the end of the path supports the given function set.
"""
pass
def inclusiveMatrix(self, *args, **kwargs):
"""
Returns the matrix for all transforms in the path, including the end object, if it is a transform.
"""
pass
def inclusiveMatrixInverse(self, *args, **kwargs):
"""
Returns the inverse of inclusiveMatrix().
"""
pass
def instanceNumber(self, *args, **kwargs):
"""
Returns the instance number of this path to the object at the end.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
Returns True if the object at the end of the path can be reached by more than one path.
"""
pass
def isTemplated(self, *args, **kwargs):
"""
Returns true if the DAG Node at the end of the path is templated.
"""
pass
def isValid(self, *args, **kwargs):
"""
Returns True if this is a valid path.
"""
pass
def isVisible(self, *args, **kwargs):
"""
Returns true if the DAG Node at the end of the path is visible.
"""
pass
def length(self, *args, **kwargs):
"""
Returns the number of nodes on the path, not including the DAGs root node.
"""
pass
def node(self, *args, **kwargs):
"""
Returns the DAG node at the end of the path.
"""
pass
def numberOfShapesDirectlyBelow(self, *args, **kwargs):
"""
Returns the number of shape nodes parented directly beneath the transform at the end of the path.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
Returns the minimum string representation which will uniquely identify the path.
"""
pass
def pathCount(self, *args, **kwargs):
"""
Returns the number of sub-paths which make up this path.
"""
pass
def pop(self, *args, **kwargs):
"""
Removes objects from the end of the path.
"""
pass
def push(self, *args, **kwargs):
"""
Extends the path to the specified child object, which must be parented directly beneath the object currently at the end of the path.
"""
pass
def set(self, *args, **kwargs):
"""
Replaces the current path held by this object with another.
"""
pass
def transform(self, *args, **kwargs):
"""
Returns the last transform node on the path.
"""
pass
class MDagPathArray(object):
"""
Array of MDagPath values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MDataBlock(object):
"""
Dependency node data block.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def context(self, *args, **kwargs):
"""
context() -> MDGContext
Returns a copy of the dependecy graph context for which this data block was created. The context is used to specify how a dependency node is going to be evaluated.
"""
pass
def inputArrayValue(self, *args, **kwargs):
"""
inputArrayValue(plug) -> MArrayDataHandle
inputArrayValue(attribute) -> MArrayDataHandle
Gets an array handle to this data block for the given plug/attributes data. This is only valid if the given plug has array data. The data represented by the handle will be valid. If the data is from a dirty connection, then the connection will be evaluated. If no connection is present, then the value that the plug has been set to will be returned. If the plug has not been set to a particular value, then the default value will be returned.
* plug (MPlug) - the plug whose data you wish to access
OR
* attribute (MObject) - the attribute whose data you wish to access
"""
pass
def inputValue(self, *args, **kwargs):
"""
inputValue(plug) -> MDataHandle
inputValue(attribute) -> MDataHandle
Gets a handle to this data block for the given plug/attributes data. The data represented by the handle is guaranteed to be valid for reading. If the data is from a dirty connection, then the connection will be evaluated. If no connection is present, then the value that the plug has been set to will be returned. If the plug has not been set to a particular value, then the default value will be returned.
* plug (MPlug) - the plug whose data you wish to access
OR
* attribute (MObject) - the attribute of the node that you want to access
"""
pass
def isClean(self, *args, **kwargs):
"""
isClean(plug) -> bool
isClean(attribute) -> bool
Queries the dependency graph to see whether the given plug/attribute is clean.
* plug (MPlug) - the plug that is to be query
OR
* attribute (MObject) - the attribute that is to be query.
"""
pass
def outputArrayValue(self, *args, **kwargs):
"""
outputArrayValue(plug) -> MArrayDataHandle
outputArrayValue(attribute) -> MArrayDataHandle
Gets a handle to this data block for the given plug/attributes data. No dependency graph evaluations will be done, and therefore the data is not guaranteed to be valid (i.e. it may be dirty). Typically, this method is used to get the handle during compute in order to write output data to it.
Another usage of this method is to access an input array attribute without evaluating any of its array elements. One can then use MArrayDataHandle.jumpToElement() to get to the particular element of interest, and evaluate its value using MArrayDataHandle.inputValue().
* plug (MPlug) - the plug whose data you wish to access
OR
* attribute (MObject) - the attribute whose data you wish to access
"""
pass
def outputValue(self, *args, **kwargs):
"""
outputValue(plug) -> MDataHandle
outputValue(attribute) -> MDataHandle
Gets a handle to this data block for the given plug/attributes data. The data is not guaranteed to be valid. No dependency graph evaluations will be done. Therefore, this handle should be used only for writing.
* plug (MPlug) - the plug whose data you wish to access
OR
* attribute (MObject) - the attribute of the node that you want to access
"""
pass
def setClean(self, *args, **kwargs):
"""
setClean(plug) -> self
setClean(attribute) -> self
Tells the dependency graph that the given plug/attribute has been updated and is now clean. This should be called after the data in the plug has been recalculated from the inputs of the node.
* plug (MPlug) - the plug that is to be marked clean
OR
* attribute (MObject) - the attribute that is to be marked clean
"""
pass
def setContext(self, *args, **kwargs):
"""
setContext(ctx) -> self
Set the dependency graph context for this data block. The context is used to specify how a dependency node is going to be evaluated, thus replacing the context for the given datablock. This does not modify the dirty state of the datablock so that they apply to the new context.
This function should not be used for timed evaluation.
* ctx (MDGContext) - the dependency graph context
"""
pass
class MDataHandle(object):
"""
Data handle for information contained in a data block.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def acceptedTypeIds(self, *args, **kwargs):
"""
acceptedTypeIds() -> array of MTypeIds
This method returns an array of MTypeIds.
"""
pass
def asAddr(self, *args, **kwargs):
"""
asAddr() -> long
Returns the data represented by this handle in the data block.
"""
pass
def asAngle(self, *args, **kwargs):
"""
asAngle() -> MAngle
Returns the data represented by this handle in the data block.
"""
pass
def asBool(self, *args, **kwargs):
"""
asBool() -> bool
Returns the data represented by this handle in the data block.
"""
pass
def asChar(self, *args, **kwargs):
"""
asChar() -> int
Returns the data represented by this handle in the data block.
"""
pass
def asDistance(self, *args, **kwargs):
"""
asDistance() -> MDistance
Returns the data represented by this handle in the data block.
"""
pass
def asDouble(self, *args, **kwargs):
"""
asDouble() -> float
Returns the data represented by this handle in the data block.
"""
pass
def asDouble2(self, *args, **kwargs):
"""
asDouble2() -> [float, float]
Returns the data represented by this handle in the data block.
"""
pass
def asDouble3(self, *args, **kwargs):
"""
asDouble3() -> [float, float, float]
Returns the data represented by this handle in the data block.
"""
pass
def asFloat(self, *args, **kwargs):
"""
asFloat() -> float
Returns the data represented by this handle in the data block.
"""
pass
def asFloat2(self, *args, **kwargs):
"""
asFloat2() -> [float, float]
Returns the data represented by this handle in the data block.
"""
pass
def asFloat3(self, *args, **kwargs):
"""
asFloat3() -> [float, float, float]
Returns the data represented by this handle in the data block.
"""
pass
def asFloatMatrix(self, *args, **kwargs):
"""
asFloatMatrix() -> MFloatMatrix
Returns the data represented by this handle in the data block.
"""
pass
def asFloatVector(self, *args, **kwargs):
"""
asFloatVector() -> MFloatVector
Returns the data represented by this handle in the data block.
"""
pass
def asGenericBool(self, *args, **kwargs):
"""
asGenericBool() -> bool
Returns the generic data represented by this handle in the data block.
"""
pass
def asGenericChar(self, *args, **kwargs):
"""
asGenericChar() -> int
Returns the generic data represented by this handle in the data block.
"""
pass
def asGenericDouble(self, *args, **kwargs):
"""
asGenericDouble() -> float
Returns the generic data represented by this handle in the data block.
"""
pass
def asGenericFloat(self, *args, **kwargs):
"""
asGenericFloat() -> float
Returns the generic data represented by this handle in the data block.
"""
pass
def asGenericInt(self, *args, **kwargs):
"""
asGenericInt() -> int
Returns the generic data represented by this handle in the data block.
"""
pass
def asGenericShort(self, *args, **kwargs):
"""
asGenericShort() -> int
Returns the generic data represented by this handle in the data block.
"""
pass
def asInt(self, *args, **kwargs):
"""
asInt() -> int
Returns the data represented by this handle in the data block.
"""
pass
def asInt2(self, *args, **kwargs):
"""
asInt2() -> [int, int]
Returns the data represented by this handle in the data block.
"""
pass
def asInt3(self, *args, **kwargs):
"""
asInt3() -> [int, int, int]
Returns the data represented by this handle in the data block.
"""
pass
def asMatrix(self, *args, **kwargs):
"""
asMatrix() -> MMatrix
Returns the data represented by this handle in the data block.
"""
pass
def asMesh(self, *args, **kwargs):
"""
asMesh() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the mesh function set and iterators. Even though this method does not return a reference to an MObject, modifications to the MObject instance will update the contents of the handle in the data block. The method MDataHandle.setClean() should be called after the data block has been modified.
The surface returned by this method will be in local space even if the connection is supplying world space geometry. This occurs mostly for efficiency reasons. In the case of a world space geometry connection, the MObject returned by this method will also contain the world space transformation matrix. This means that world space operations may be performed on this object using the mesh function set and iterators.
It is possible to get the matrix that defines the local to world transformation for this geometry using the MDataHandle.geometryTransformMatrix() method.
"""
pass
def asMeshTransformed(self, *args, **kwargs):
"""
asMeshTransformed() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the mesh function set (MFnMesh) or any of the mesh iterators.
If the incoming mesh comes with world space transformation data, then it will be applied to the data that is returned. In other words, the mesh that is returned will be the mesh as it exists in world space.
The mesh that is returned from this method should not be modified. This method is only provided to make it easier to take world space geometry as input.
"""
pass
def asNurbsCurve(self, *args, **kwargs):
"""
asNurbsCurve() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the nurbs curve function set and iterator. Even though this method does not return a reference to an MObject, modifications to the MObject instance will update the contents of the handle in the data block. The method MDataHandle.setClean() should be called after the data block has been modified.
The curve returned by this method will be in local space even if the connection is supplying world space geometry. This occurs mostly for efficiency reasons. In the case of a world space geometry connection, the MObject returned by this method will also contain the world space transformation matrix. This means that world space operations may be performed on this object using the nurbs curve function set and iterator.
It is possible to get the matrix that defines the local to world transformation for this geometry using the MDataHandle.geometryTransformMatrix() method.
"""
pass
def asNurbsCurveTransformed(self, *args, **kwargs):
"""
asNurbsCurveTransformed() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the nurbs curve function set (MFnNurbsCurve) or the nurbs curve CV iterator (MItCurveCV).
If the incoming curve comes with world space transformation data, then it will be applied to the data that is returned. In other words, the curve that is returned will be the curve as it exists in world space.
The curve that is returned from this method should not be modified. This method is only provided to make it easier to take world space geometry as input.
"""
pass
def asNurbsSurface(self, *args, **kwargs):
"""
asNurbsSurface() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the nurbs surface function set and iterator. Even though this method does not return a reference to an MObject, modifications to the MObject instance will update the contents of the handle in the data block. The method MDataHandle.setClean() should be called after the data block has been modified.
The surface returned by this method will be in local space even if the connection is supplying world space geometry. This occurs mostly for efficiency reasons. In the case of a world space geometry connection, the MObject returned by this method will also contain the world space transformation matrix. This means that world space operations may be performed on this object using the nurbs surface function set and iterator.
It is possible to get the matrix that defines the local to world transformation for this geometry using the MDataHandle.geometryTransformMatrix() method.
"""
pass
def asNurbsSurfaceTransformed(self, *args, **kwargs):
"""
asNurbsSurfaceTransformed() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the nurbs surface function set (MFnNurbsSurface) or the nurbs surface CV iterator (MItSurfaceCV).
If the incoming surface comes with world space transformation data, then it will be applied to the data that is returned. In other words, the surface that is returned will be the surface as it exists in world space.
The surface that is returned from this method should not be modified. This method is only provided to make it easier to take world space geometry as input.
"""
pass
def asPluginData(self, *args, **kwargs):
"""
asPluginData() -> MPxData
Returns the data represented by this handle in the data block. The object is returned as plugin data. This should be used to access data types defined by plugins.
"""
pass
def asShort(self, *args, **kwargs):
"""
asShort() -> int
Returns the data represented by this handle in the data block.
"""
pass
def asShort2(self, *args, **kwargs):
"""
asShort2() -> [int, int]
Returns the data represented by this handle in the data block.
"""
pass
def asShort3(self, *args, **kwargs):
"""
asShort3() -> [int, int, int]
Returns the data represented by this handle in the data block.
"""
pass
def asString(self, *args, **kwargs):
"""
asString() -> MString
Returns the data represented by this handle in the data block.
"""
pass
def asSubdSurface(self, *args, **kwargs):
"""
asSubdSurface() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the subdivision surface function set and iterator. Even though this method does not return a reference to an MObject, modifications to the MObject instance will update the contents of the handle in the data block. The method MDataHandle.setClean() should be called after the data block has been modified.
The subdivision surface returned by this method will be in local space even if the connection is supplying world space geometry. This occurs mostly for efficiency reasons. In the case of a world space geometry connection, the MObject returned by this method will also contain the world space transformation matrix. This means that world space operations may be performed on this object using the subdivision surface function set and iterator.
It is possible to get the matrix that defines the local to world transformation for this geometry using the MDataHandle.geometryTransformMatrix() method.
"""
pass
def asSubdSurfaceTransformed(self, *args, **kwargs):
"""
asSubdSurfaceTransformed() -> MObject
Returns the data represented by this handle in the data block. The object returned by this call may be used directly with the subdivision surface function set (MFnSubdSurface) or the subdivision surface iterators (MItSubdVertex, MItSubdFace, MItSubdEdge).
If the incoming surface comes with world space transformation data, then it will be applied to the data that is returned. In other words, the surface that is returned will be the surface as it exists in world space.
The surface that is returned from this method should not be modified. This method is only provided to make it easier to take world space geometry as input.
"""
pass
def asTime(self, *args, **kwargs):
"""
asTime() -> MTime
Returns the data represented by this handle in the data block.
"""
pass
def asUChar(self, *args, **kwargs):
"""
asUChar() -> int
Returns the data represented by this handle in the data block.
"""
pass
def asVector(self, *args, **kwargs):
"""
asVector() -> MVector
Returns the data represented by this handle in the data block.
"""
pass
def child(self, *args, **kwargs):
"""
child(MPlug) -> MDataHandle
child(MObject) -> MDataHandle
Get a handle to a child of this handle. This is used if you have a handle to a compound attribute.
"""
pass
def copy(self, *args, **kwargs):
"""
copy(src) -> self
Copies the attribute from the src attribute to the attribute referenced by this handle. This is the only method which can completely copy a compound attribute from one handle to another. The construct outputHandle.set (inputHandle.data()) will not work for compound or multi attributes.
* src (MDataHandle) - the handle to the attribute to copy.
"""
pass
def data(self, *args, **kwargs):
"""
data() -> MObject
Returns the data object from this handle. The object returned should be used with the appropriate data function set. This method is not valid for simple numeric types.
"""
pass
def geometryTransformMatrix(self, *args, **kwargs):
"""
geometryTransformMatrix() -> MMatrix
This method returns a reference to the local-to-world transformation matrix that can accompany a geometry data object. Only use this method on handles to geometry data (curves, surfaces, and meshes).
If no local-to-world transformation information has been provided then this will be an identity matrix.
"""
pass
def isGeneric(self, *args, **kwargs):
"""
isGeneric() -> [bool, isNumeric, isNull]
Returns True if this handle is for generic data. There are 2 forms of generic data. The first is for simple data and is used if the isNumeric parameter returns True. In this case, the asGeneric*() and setGeneric*() methods of this class are used to query and set values.
The second form of generic data is for more complex attribute types. As a result the type of the object must be checked and an appropriate attribute function set initialized with the object.Returns isNumeric True if this handle is for simple generic numeric data.
Returns isNull True if this handle is not set.
"""
pass
def isNumeric(self, *args, **kwargs):
"""
isNumeric() -> bool
Returns True if this handle is for simple numeric data. That means that the numeric data is directly accessible through the non-generic as*() and set*() methods of this handle. For example, depending on handle initialization, the asBool() may be called but the asGenericBool() should not be called.
"""
pass
def numericType(self, *args, **kwargs):
"""
numericType() -> int
Returns the type of data represented by this handle. This method is only valid for data handles of simple numeric types.
"""
pass
def set2Double(self, *args, **kwargs):
"""
set2Double(float, float) -> self
Set the data that this handle represents in the data block.
"""
pass
def set2Float(self, *args, **kwargs):
"""
set2Float(float, float) -> self
Set the data that this handle represents in the data block.
"""
pass
def set2Int(self, *args, **kwargs):
"""
set2Int(int, int) -> self
Set the data that this handle represents in the data block.
"""
pass
def set2Short(self, *args, **kwargs):
"""
set2Short(int, int) -> self
Set the data that this handle represents in the data block.
"""
pass
def set3Double(self, *args, **kwargs):
"""
set3Double(float, float, float) -> self
Set the data that this handle represents in the data block.
"""
pass
def set3Float(self, *args, **kwargs):
"""
set3Float(float, float, float) -> self
Set the data that this handle represents in the data block.
"""
pass
def set3Int(self, *args, **kwargs):
"""
set3Int(int, int, int) -> self
Set the data that this handle represents in the data block.
"""
pass
def set3Short(self, *args, **kwargs):
"""
set3Short(int, int, int) -> self
Set the data that this handle represents in the data block.
"""
pass
def setBool(self, *args, **kwargs):
"""
setBool(bool) -> self
Set the data that this handle represents in the data block.
"""
pass
def setChar(self, *args, **kwargs):
"""
setChar(int) -> self
Set the data that this handle represents in the data block.
"""
pass
def setClean(self, *args, **kwargs):
"""
setClean() -> self
Marks the data that is represented by this handle as being clean. This should be done after recalculating the data from the inputs.
"""
pass
def setDouble(self, *args, **kwargs):
"""
setDouble(float) -> self
Set the data that this handle represents in the data block.
"""
pass
def setFloat(self, *args, **kwargs):
"""
setFloat(float) -> self
Set the data that this handle represents in the data block.
"""
pass
def setGenericBool(self, *args, **kwargs):
"""
setGenericBool(bool, force) -> self
Set the data that this handle represents in the data block.
"""
pass
def setGenericChar(self, *args, **kwargs):
"""
setGenericChar(int, force) -> self
Set the data that this handle represents in the data block.
"""
pass
def setGenericDouble(self, *args, **kwargs):
"""
setGenericDouble(float, force) -> self
Set the data that this handle represents in the data block.
"""
pass
def setGenericFloat(self, *args, **kwargs):
"""
setGenericFloat(float, force) -> self
Set the data that this handle represents in the data block.
"""
pass
def setGenericInt(self, *args, **kwargs):
"""
setGenericInt(int, force) -> self
Set the data that this handle represents in the data block.
"""
pass
def setGenericShort(self, *args, **kwargs):
"""
setGenericShort(int, force) -> self
Set the data that this handle represents in the data block.
"""
pass
def setInt(self, *args, **kwargs):
"""
setInt(int) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMAngle(self, *args, **kwargs):
"""
setMAngle(MAngle) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMDistance(self, *args, **kwargs):
"""
setMDistance(MDistance) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMFloatMatrix(self, *args, **kwargs):
"""
setMFloatMatrix(MFloatMatrix) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMFloatVector(self, *args, **kwargs):
"""
setMFloatVector(MFloatVector) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMMatrix(self, *args, **kwargs):
"""
setMMatrix(MMatrix) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMObject(self, *args, **kwargs):
"""
setMObject(MObject) -> self
Set the data that this handle represents in the data block. This method assumes that the MObject is a dependency graph data object. These objects can be created using the appropriate MFn..Data function set.
Note that this method cannot be used to copy compound or multi attributes from one handle to another via the construct outputHandle.set (inputHandle.data()).
To copy these user defined attributes, the method MDataHandle.copy() must be used.
"""
pass
def setMPxData(self, *args, **kwargs):
"""
setMPxData(MPxData) -> self
Set the data that this handle represents in the data block. This method takes a pointer to a user defined data object. The data block will become the new owner of the data object that you pass in. Do not delete it.
"""
pass
def setMTime(self, *args, **kwargs):
"""
setMTime(MTime) -> self
Set the data that this handle represents in the data block.
"""
pass
def setMVector(self, *args, **kwargs):
"""
setMVector(MVector) -> self
Set the data that this handle represents in the data block.
"""
pass
def setShort(self, *args, **kwargs):
"""
setShort(int) -> self
Set the data that this handle represents in the data block.
"""
pass
def setString(self, *args, **kwargs):
"""
setString(string) -> self
Set the data that this handle represents in the data block.
"""
pass
def type(self, *args, **kwargs):
"""
type() -> int
Returns the type of data represented by this handle.
"""
pass
def typeId(self, *args, **kwargs):
"""
typeId() -> MTypeId
Returns the type of data represented by this handle as a type id. A type id is a four character code that is used to identify the data type.
If no data exists for this handle, the type id will be 0x0.
"""
pass
class MDistance(object):
"""
Manipulate distance data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def asCentimeters(self, *args, **kwargs):
"""
Return the distance value, converted to centimeters.
"""
pass
def asFeet(self, *args, **kwargs):
"""
Return the distance value, converted to feet.
"""
pass
def asInches(self, *args, **kwargs):
"""
Return the distance value, converted to inches.
"""
pass
def asKilometers(self, *args, **kwargs):
"""
Return the distance value, converted to kilometers.
"""
pass
def asMeters(self, *args, **kwargs):
"""
Return the distance value, converted to meters.
"""
pass
def asMiles(self, *args, **kwargs):
"""
Return the distance value, converted to miles.
"""
pass
def asMillimeters(self, *args, **kwargs):
"""
Return the distance value, converted to millimeters.
"""
pass
def asUnits(self, *args, **kwargs):
"""
Return the distance value, converted to the specified units.
"""
pass
def asYards(self, *args, **kwargs):
"""
Return the distance value, converted to yards.
"""
pass
def internalToUI(self, *args, **kwargs):
"""
Convert a value from Mayas internal units to the units used in the UI.
"""
pass
def internalUnit(self, *args, **kwargs):
"""
Return the distance unit used internally by Maya.
"""
pass
kCentimeters = 6
kFeet = 2
kInches = 1
kInvalid = 0
kKilometers = 7
kLast = 9
kMeters = 8
kMiles = 4
kMillimeters = 5
kYards = 3
def setUIUnit(self, *args, **kwargs):
"""
Change the units used to display distances in Mayas UI.
"""
pass
def uiToInternal(self, *args, **kwargs):
"""
Convert a value from the units used in the UI to Mayas internal units.
"""
pass
def uiUnit(self, *args, **kwargs):
"""
Return the units used to display distances in Mayas UI.
"""
pass
@property
def unit(self, *args, **kwargs):
"""
Distance units currently in use.
"""
pass
@property
def value(self, *args, **kwargs):
"""
Value of the distance in the current units.
"""
pass
class MDoubleArray(object):
"""
Array of double values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MEulerRotation(object):
"""
X, Y and Z rotations, applied in a specified order.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __isub__(self, *args, **kwargs):
"""
x.__isub__(y) <==> x-=y
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __neg__(self, *args, **kwargs):
"""
x.__neg__() <==> -x
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __rsub__(self, *args, **kwargs):
"""
x.__rsub__(y) <==> y-x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def __sub__(self, *args, **kwargs):
"""
x.__sub__(y) <==> x-y
"""
pass
def alternateSolution(self, *args, **kwargs):
"""
Returns an equivalent rotation which is not simply a multiple.
"""
pass
def asMatrix(self, *args, **kwargs):
"""
Returns the rotation as an equivalent matrix.
"""
pass
def asQuaternion(self, *args, **kwargs):
"""
Returns the rotation as an equivalent quaternion.
"""
pass
def asVector(self, *args, **kwargs):
"""
Returns the X, Y and Z rotations as a vector.
"""
pass
def bound(self, *args, **kwargs):
"""
Returns a new MEulerRotation having this rotation, but with each rotation component bound within +/- PI.
"""
pass
def boundIt(self, *args, **kwargs):
"""
In-place bounding of each rotation component to lie wthin +/- PI.
"""
pass
def closestCut(self, *args, **kwargs):
"""
Returns the rotation which is full spin multiples of this one and comes closest to target.
"""
pass
def closestSolution(self, *args, **kwargs):
"""
Returns the equivalent rotation which comes closest to a target.
"""
pass
def computeAlternateSolution(self, *args, **kwargs):
"""
Returns an equivalent rotation which is not simply a multiple.
"""
pass
def computeBound(self, *args, **kwargs):
"""
Returns an equivalent rotation with each rotation component bound within +/- PI.
"""
pass
def computeClosestCut(self, *args, **kwargs):
"""
Returns the rotation which is full spin multiples of the src and comes closest to target.
"""
pass
def computeClosestSolution(self, *args, **kwargs):
"""
Returns the equivalent rotation which comes closest to a target.
"""
pass
def decompose(self, *args, **kwargs):
"""
Extracts a rotation from a matrix.
"""
pass
def incrementalRotateBy(self, *args, **kwargs):
"""
Increase this rotation by a given angle around the specified axis. The update is done in series of small increments to avoid flipping.
"""
pass
def inverse(self, *args, **kwargs):
"""
Returns a new MEulerRotation containing the inverse rotation of this one and reversed rotation order.
"""
pass
def invertIt(self, *args, **kwargs):
"""
In-place inversion of the rotation. Rotation order is also reversed.
"""
pass
def isEquivalent(self, *args, **kwargs):
"""
Returns true if this rotation has the same order as another and their X, Y and Z components are within a tolerance of each other.
"""
pass
def isZero(self, *args, **kwargs):
"""
Returns true if the X, Y and Z components are each within a tolerance of 0.0.
"""
pass
def kIdentity(self, *args, **kwargs):
"""
X, Y and Z rotations, applied in a specified order.
"""
pass
def kTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
kXYZ = 0
kXZY = 3
kYXZ = 4
kYZX = 1
kZXY = 2
kZYX = 5
@property
def order(self, *args, **kwargs):
"""
Rotation order
"""
pass
def reorder(self, *args, **kwargs):
"""
Returns a new MEulerRotation having this rotation, reordered to use the given rotation order.
"""
pass
def reorderIt(self, *args, **kwargs):
"""
In-place reordering to use the given rotation order.
"""
pass
def setToAlternateSolution(self, *args, **kwargs):
"""
Replace this rotation with an alternate solution.
"""
pass
def setToClosestCut(self, *args, **kwargs):
"""
Replace this rotation with the closest cut to a target.
"""
pass
def setToClosestSolution(self, *args, **kwargs):
"""
Replace this rotation with the closest solution to a target.
"""
pass
def setValue(self, *args, **kwargs):
"""
Set the rotation.
"""
pass
@property
def x(self, *args, **kwargs):
"""
X rotation in radians
"""
pass
@property
def y(self, *args, **kwargs):
"""
Y rotation in radians
"""
pass
@property
def z(self, *args, **kwargs):
"""
Z rotation in radians
"""
pass
class MEventMessage(MMessage):
"""
Class used to register callbacks for event related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addEventCallback(self, *args, **kwargs):
"""
addEventCallback(eventName, function, clientData=None) -> id
This method registers a callback for event occurred messages.
The callback function will be passed the any client data that
was provided when the callback was registered.
* eventName (string) - the event to register the
callback for
* function - callable which will be passed the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
def getEventNames(self, *args, **kwargs):
"""
getEventNames() -> (string, string, ...)
This method returns the list of available event names.
* return: tuple of available event names.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MExternalContentInfoTable(object):
"""
This is a table of all the external content for a given node.
"""
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addResolvedEntry(self, *args, **kwargs):
"""
addResolvedEntry(key, unresolvedLocation, resolvedLocation, contextNodeFullName, roles) -> self
Add an entry in the table.
* key (string) - An arbitrary string defined by the caller. This will typically be an attribute name for situations where the content location is stored verbatim in a plugs value.
* unresolvedLocation (string) - Path as stored in the node (i.e. without any token replacement performed).
* resolvedLocation (string) - Full path to the content if it exists at the time of creation of this object.
* contextNodeFullName (string) - The fullname of the URI owner (node) if it applies, an empty string otherwise.
* roles (list of strings) - An enumeration of all roles this content plays in the context of the node. The actual strings are not rigidly defined as of this writing. This is mostly for offline browsing of the content info: to assist in sorting content by role. A better content type system may be introduced later on to formalize this.
"""
pass
def addUnresolvedEntry(self, *args, **kwargs):
"""
addUnresolvedEntry(key, unresolvedLocation, contextNodeFullName, roles=None) -> self
Add an entry in the table. The resolved location will be inferred from the applications built-in file resolving for the specified file type. This will automatically add entries into the roles vector that correspond to the search rules for this file type.
* key (string) - See documentation of MExternalContentInfoTable.addResolvedEntry().
* unresolvedLocation (string) - See documentation of MExternalContentInfoTable.addResolvedEntry().
* contextNodeFullName (string) - See documentation of MExternalContentInfoTable.addResolvedEntry().
* roles (list of strings) - See documentation of MExternalContentInfoTable.addResolvedEntry().
"""
pass
def getEntry(self, *args, **kwargs):
"""
getEntry(index) -> [key, unresolvedLocation, resolvedLocation, contextNodeFullName, roles]
Retrieves external content entry based on its position in the table.
* index (unsigned int) - Position of the entry to retrieve information from.
"""
pass
def getInfo(self, *args, **kwargs):
"""
getInfo(key) -> [unresolvedLocation, resolvedLocation, contextNodeFullName, roles]
Retrieves external content information based on its key.
* key (string) - See documentation of MExternalContentInfoTable.addResolvedEntry().
"""
pass
class MExternalContentLocationTable(object):
"""
This is a table of the all the external content locations for a given node.
"""
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addEntry(self, *args, **kwargs):
"""
addEntry(key, location) -> self
Adds an external content location and its key to the table.
* key (string) - An arbitrary string defined by the node. This will typically be an attribute name for situations where the content location is stored verbatim in a plugs value.* location (string) - Full path to the content referenced by the key.
"""
pass
def getEntry(self, *args, **kwargs):
"""
getEntry(index) -> [key, location]
Retrieves external content entry based on its position in the table.
* index (unsigned int) - Position of the entry to retrieve information from.
"""
pass
def getLocation(self, *args, **kwargs):
"""
getLocation(key) -> string
Retrieves an entrys location based on the associated key.
* key (string) - See documentation of MExternalContentLocationTable.addEntry().
"""
pass
class MFileObject(object):
"""
Manipulate filenames and search paths.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source) -> self
Copy data from source file object.
* source (MFileObject) - The source file object to copy from
"""
pass
def exists(self, *args, **kwargs):
"""
exists(index=None) -> bool
Checks to see if the file exists and is readable.
If index is None tests for the fullName file, else tests the file constructed from the indicated portion of the path element and filename element.
* index (int) - Index of the path element to be used in searching for the file.
"""
pass
def expandedFullName(self, *args, **kwargs):
"""
expandedFullName() -> string
Returns the pathname of a file constructed from the unresolved file object values. The file name will consist of the the expanded raw path and raw name elements.
All variables in the path element are expanded, and the first path (the part before the first separator (:) in the path) is prepended to the filename element to construct the fullName.
After expanding environment variables Maya may perform additional modifications to the full file name in order to resolve it to a valid location on disk. This resolved full file name can be accessed through resolvedFullName().
"""
pass
def expandedPath(self, *args, **kwargs):
"""
expandedPath() -> string
Returns the raw path element of the unresolved file object with all environment variables expanded. In the case that the path expands to multiple paths, the first expanded path will be returned.
After expanding environment variables Maya may perform additional modifications to the path in order to resolve it to a valid location on disk. This resolved path can be accessed through resolvedPath().
"""
pass
def fullName(self, *args, **kwargs):
"""
fullName(index) -> string
Returns the pathname of a file constructed from the indicated portion of the path element and filename element.
All variables in the path element are expanded, and the indicated path portion is prepended to the filename element to construct the fullName.
* index (int) - the index of the desired path portion.
"""
pass
def getResolvedFullName(self, *args, **kwargs):
"""
getResolvedFullName(rawFullName) -> string
Returns the full path to the resolved file, or an empty string if the resolution was unsuccessful.
* rawFullName (string) - The fully specified unresolved path.
"""
pass
def getResolvedFullNameAndExistsStatus(self, *args, **kwargs):
"""
getResolvedFullNameAndExistsStatus(rawFullName, method=kNone) -> (string, bool)
Returns the full path to the resolved file, or an empty string if the resolution was unsuccessful, and a boolean that indicate if the resolved path exists or not.
* rawFullName (string) - The fully specified unresolved path
* resolveMethod (int) - To resolve method to use, default is kNone.
Valid resolve methods:
kNone The resolved path is simply the resulting path after converting
the raw value to its expanded form. If the path contains environment variables,
the resolved value will be the first path returned from their expansion.
Relative paths will be considered to be relative to root of the current project.
The resolution algorithm will not check if this file actually exists - the
resolution will be considered successful whether it exists or not.
With this mode, the resolver will not continue on to attempt to resolve
using any other resolve method.
The user must explicitly check MFileObject.exists() to determine if it is an
existing path.
kExact Checks if expanded paths exist. If paths are relative, assume its relative to
the current workspace (so check workspace current directory, file-rule directory and
root directory).
kDirMap Checks path against mappings defined with the dirmap command. Only for absolute paths
kReferenceMappings Check path against any previously re-mapped reference locations. If kRelative/kBaseName
are set, then even if we have an absolute path, convert to relative and/or baseName and
look for them in directories provided to the missing reference dialog.
kRelative Strips away the project directory, and treats path as relative. Relative to the current
workspace, that is. So look in the workspace current directory, file-rules directory
and the root directory.
kBaseName Strips away everything but the base file name and look in the current workspace,
kInputFile This mode is the default on file open and import, and is suitable for
files that are to be used as input files. The file will be checked for
existence.
Combination of kExact, kDirMap, kRelative and kBaseName.
kInputReference This mode is the default on file reference. In addition to the checks done for
a regular input file, it will also check the reference mappings.
Combination of kInputFile and kReferenceMappings.
kStrict Combination of kExact and kDirMap.
"""
pass
def isAbsolutePath(self, *args, **kwargs):
"""
isAbsolutePath(fileName) -> bool
Checks a file path string and determines if it represents an absolute file path. An absolute path can uniquely identify a directory or file.
* fileName (string) - the string used to check if it is absolute
"""
pass
def isSet(self, *args, **kwargs):
"""
isSet() -> bool
Checks to see if both file and path elements of the file object have been set.
"""
pass
kBaseName = 32
kDirMap = 4
kExact = 2
kInputFile = 54
kInputReference = 62
kNone = 1
kReferenceMappings = 8
kRelative = 16
kStrict = 6
def overrideResolvedFullName(self, *args, **kwargs):
"""
overrideResolvedFullName(fullFileName) -> self
Normally when a raw file name is set, Maya will perform a series of operations on it in an attempt to resolve it to a valid file name. This final resolved file name can be accessed through the resolvedName(), resolvedPath(), and resolvedFullFileName() methods and can be quite different from the originally specified raw file name.
This method will override the normal Maya path resolution process and explicitly set the resolved file name. This path does not have to be a valid file path, but if any / characters appear in the given name then the resolved path element of the file object is set to everything in name up to, but not including the last /. The resolved filename is set to the part of name after the final /.
Once the resolved file name is set, it is only guaranteed to be retained in the file object so long as the raw file path is not updated. Once the rawPath, rawName or rawFullName are set, the normal Maya path resolution process will be re-invoked and the resolved path and filename will be updated.
- fullFileName (string) - the string used to override the path and filename.
"""
pass
def path(self, *args, **kwargs):
"""
path(index) -> string
Returns the indicated portion of the path element of the file object. All variables in the path element are expanded, and the portion indicated by the argument is extracted and returned.
* index (int) - the index of the desired path portion.
"""
pass
def pathCount(self, *args, **kwargs):
"""
pathCount() -> int
Returns the number of paths in the path element of the file object.
This will be equal to one more than the number of : characters specified of the rawPath attribute.
"""
pass
def rawFullName(self, *args, **kwargs):
"""
rawFullName() -> string
Returns the unresolved full file name (path plus filename) of the MFileObject with all environment variables unexpanded.
This method differs from expandedFullName() in that it returns the unexpanded instead of expanded values.
"""
pass
def rawName(self, *args, **kwargs):
"""
rawName() -> string
Returns the unresolved filename element of the MFileObject.
"""
pass
def rawPath(self, *args, **kwargs):
"""
rawPath() -> string
Returns the path element of the MFileObject with all environment variables unexpanded.
"""
pass
@property
def resolveMethod(self, *args, **kwargs):
"""
The file-path resolution steps this file object will use.
"""
pass
def resolvedFullName(self, *args, **kwargs):
"""
resolvedFullName() -> string
Returns the first pathname of a file constructed from the path and filename elements. All variables in the path element are expanded, and the first path (the part before the first : in the path) is prepended to the filename element. After expanding all environment variables Maya may then perform additional modifications, such as prepending directories to a relative path name, in order to resolve the path to a valid location on disk.
The resolution is performed using the ResolveMethod of the file object.
By default, this will be set to kNone. While this is suitable in many situations, it may not be appropriate if the file is expected to exist.
Refer to getResolvedFullNameAndExistsStatus() for more information about how the resolution mode is used.
Failure to resolve the path according to the specifications of the file object will result in an empty return value.
"""
pass
def resolvedName(self, *args, **kwargs):
"""
resolvedName() -> string
Returns the resolved filename element of the file object.
"""
pass
def resolvedPath(self, *args, **kwargs):
"""
resolvedPath() -> string
Returns the resolved path element of the file object. In order to build the resolved path, Maya first expands all environment variables and then may perform additional modifications, such as prepending directories to a relative path name, in order to resolve the path to a valid location on disk.
"""
pass
def setRawFullName(self, *args, **kwargs):
"""
setRawFullName(fullFileName) -> self
This method combines the functions of the setRawName and setRawPath methods in that it sets both the path and filename from the given name.
If any \/\ characters appear in the given name then the path element of the MFileObject is set to everything in name up to, but not including the last \/\. The filename is set to the part of name after the final \/\.
If no \/\ characters appear in the given name then the path element is set to . and the filename is set to the given name.
Note that if the specified fullFileName is relative, contains environment variables, or does not exist, the full names returned by resolvedFullName() and expandedFullName() may not match the fullFileName. See the description of resolvedFullName() and expandedFullName() for more information.
Also note that for URI-based file paths (e.g. arrow:uri_path_to_file), setRawFullName will not call setRawName and setRawPath (raw name and path will remain empty). Use resolvedName and resolvedPath to retrieve the resolved file path, or rawFullName to retrieve the unresolved file path.
* fullFileName (string) - The string used to initialize the path and filename.
"""
pass
def setRawName(self, *args, **kwargs):
"""
setRawName(fileName) -> self
Set the unresolved filename element of the MFileObject instance. This name should not contain any / characters, it should indicate simply the name of a file. The directories in which this name will be searched for are specified by setRawPath.
* fileName (string) - The filename to set.
"""
pass
def setRawPath(self, *args, **kwargs):
"""
setRawPath(pathName) -> self
Set the unresolved path element of the MFileObject instance. This should contain a list of directories, each separated by a single : character. The pathnames can contain Unix environment variables in the form $VARNAME. These will be expanded when paths to actual filenames are constructed.
Note that if the specified pathName is relative, contains environment variables, or does not exist, the paths returned by resolvedPath() and expandedPath() may not match the rawPath. See the description of resolvedPath() and expandedPath() for more information.
* pathName (string) - The path string.
"""
pass
class MFloatArray(object):
"""
Array of float values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MFloatMatrix(object):
"""
4x4 matrix with single-precision elements.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __isub__(self, *args, **kwargs):
"""
x.__isub__(y) <==> x-=y
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __rsub__(self, *args, **kwargs):
"""
x.__rsub__(y) <==> y-x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def __sub__(self, *args, **kwargs):
"""
x.__sub__(y) <==> x-y
"""
pass
def adjoint(self, *args, **kwargs):
"""
Returns a new matrix containing this matrixs adjoint.
"""
pass
def det3x3(self, *args, **kwargs):
"""
Returns the determinant of the 3x3 matrix formed by the first 3 elements of the first 3 rows of this matrix.
"""
pass
def det4x4(self, *args, **kwargs):
"""
Returns this matrixs determinant.
"""
pass
def getElement(self, *args, **kwargs):
"""
Returns the matrix element for the specified row and column.
"""
pass
def homogenize(self, *args, **kwargs):
"""
Returns a new matrix containing the homogenized version of this matrix.
"""
pass
def inverse(self, *args, **kwargs):
"""
Returns a new matrix containing this matrixs inverse.
"""
pass
def isEquivalent(self, *args, **kwargs):
"""
Test for equivalence of two matrices, within a tolerance.
"""
pass
def kTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
def setElement(self, *args, **kwargs):
"""
Sets the matrix element for the specified row and column.
"""
pass
def setToIdentity(self, *args, **kwargs):
"""
Sets this matrix to the identity.
"""
pass
def setToProduct(self, *args, **kwargs):
"""
Sets this matrix to the product of the two matrices passed in.
"""
pass
def transpose(self, *args, **kwargs):
"""
Returns a new matrix containing this matrixs transpose.
"""
pass
class MFloatPoint(object):
"""
3D point with single-precision coordinates.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __div__(self, *args, **kwargs):
"""
x.__div__(y) <==> x/y
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __isub__(self, *args, **kwargs):
"""
x.__isub__(y) <==> x-=y
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __rdiv__(self, *args, **kwargs):
"""
x.__rdiv__(y) <==> y/x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __rsub__(self, *args, **kwargs):
"""
x.__rsub__(y) <==> y-x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def __sub__(self, *args, **kwargs):
"""
x.__sub__(y) <==> x-y
"""
pass
def cartesianize(self, *args, **kwargs):
"""
Convert point to cartesian form.
"""
pass
def distanceTo(self, *args, **kwargs):
"""
Return distance between this point and another.
"""
pass
def homogenize(self, *args, **kwargs):
"""
Convert point to homogenous form.
"""
pass
def isEquivalent(self, *args, **kwargs):
"""
Test for equivalence of two points, within a tolerance.
"""
pass
def kOrigin(self, *args, **kwargs):
"""
3D point with single-precision coordinates.
"""
pass
def kTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
def rationalize(self, *args, **kwargs):
"""
Convert point to rational form.
"""
pass
@property
def w(self, *args, **kwargs):
"""
W coordinate
"""
pass
@property
def x(self, *args, **kwargs):
"""
X coordinate
"""
pass
@property
def y(self, *args, **kwargs):
"""
Y coordinate
"""
pass
@property
def z(self, *args, **kwargs):
"""
Z coordinate
"""
pass
class MFloatPointArray(object):
"""
Array of MFloatPoint values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MFloatVector(object):
"""
3D vector with single-precision coordinates.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __div__(self, *args, **kwargs):
"""
x.__div__(y) <==> x/y
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __idiv__(self, *args, **kwargs):
"""
x.__idiv__(y) <==> x/=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __isub__(self, *args, **kwargs):
"""
x.__isub__(y) <==> x-=y
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __neg__(self, *args, **kwargs):
"""
x.__neg__() <==> -x
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __rdiv__(self, *args, **kwargs):
"""
x.__rdiv__(y) <==> y/x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __rsub__(self, *args, **kwargs):
"""
x.__rsub__(y) <==> y-x
"""
pass
def __rxor__(self, *args, **kwargs):
"""
x.__rxor__(y) <==> y^x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def __sub__(self, *args, **kwargs):
"""
x.__sub__(y) <==> x-y
"""
pass
def __xor__(self, *args, **kwargs):
"""
x.__xor__(y) <==> x^y
"""
pass
def angle(self, *args, **kwargs):
"""
Returns the angle, in radians, between this vector and another.
"""
pass
def isEquivalent(self, *args, **kwargs):
"""
Returns True if this vector and another are within a given tolerance of being equal.
"""
pass
def isParallel(self, *args, **kwargs):
"""
Returns True if this vector and another are within the given tolerance of being parallel.
"""
pass
def kOneVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
def kXaxisVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kXnegAxisVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kYaxisVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kYnegAxisVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kZaxisVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kZeroVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def kZnegAxisVector(self, *args, **kwargs):
"""
3D vector with single-precision coordinates.
"""
pass
def length(self, *args, **kwargs):
"""
Returns the magnitude of this vector.
"""
pass
def normal(self, *args, **kwargs):
"""
Returns a new vector containing the normalized version of this one.
"""
pass
def normalize(self, *args, **kwargs):
"""
Normalizes this vector in-place and returns a new reference to it.
"""
pass
def transformAsNormal(self, *args, **kwargs):
"""
Returns a new vector which is calculated by postmultiplying this vector by the transpose of the given matrix and then normalizing the result.
"""
pass
@property
def x(self, *args, **kwargs):
"""
X coordinate
"""
pass
@property
def y(self, *args, **kwargs):
"""
Y coordinate
"""
pass
@property
def z(self, *args, **kwargs):
"""
Z coordinate
"""
pass
class MFloatVectorArray(object):
"""
Array of MFloatVector values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MFn(object):
"""
Static class providing constants for all API types.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
kAISEnvFacade = 967
kAddDoubleLinear = 5
kAdskMaterial = 1055
kAffect = 6
kAimConstraint = 111
kAir = 257
kAlignCurve = 41
kAlignManip = 902
kAlignSurface = 42
kAmbientLight = 303
kAngle = 270
kAngleBetween = 21
kAnimBlend = 786
kAnimBlendInOut = 787
kAnimCurve = 7
kAnimCurveTimeToAngular = 8
kAnimCurveTimeToDistance = 9
kAnimCurveTimeToTime = 10
kAnimCurveTimeToUnitless = 11
kAnimCurveUnitlessToAngular = 12
kAnimCurveUnitlessToDistance = 13
kAnimCurveUnitlessToTime = 14
kAnimCurveUnitlessToUnitless = 15
kAnimLayer = 1008
kAnimLayerClip = 1091
kAnimLayerClipRotation = 1093
kAnimLayerClipSingle = 1092
kAnisotropy = 614
kAnnotation = 271
kAnyGeometryVarGroup = 115
kArcLength = 273
kAreaLight = 305
kArrayMapper = 521
kArrowManip = 123
kAssembly = 1069
kAsset = 1006
kAttachCurve = 43
kAttachSurface = 44
kAttribute = 558
kAttribute2Double = 739
kAttribute2Float = 740
kAttribute2Int = 742
kAttribute2Long = 742
kAttribute2Short = 741
kAttribute3Double = 743
kAttribute3Float = 744
kAttribute3Int = 746
kAttribute3Long = 746
kAttribute3Short = 745
kAttribute4Double = 871
kAudio = 22
kAverageCurveManip = 149
kAvgCurves = 45
kAvgNurbsSurfacePoints = 47
kAvgSurfacePoints = 46
kAxesActionManip = 124
kBackground = 23
kBallProjectionManip = 125
kBarnDoorManip = 150
kBase = 1
kBaseLattice = 249
kBendLattice = 335
kBevel = 48
kBevelManip = 151
kBevelPlus = 890
kBezierCurve = 1042
kBezierCurveData = 1043
kBezierCurveToNurbs = 1045
kBinaryData = 738
kBirailSrf = 49
kBlend = 27
kBlendColorSet = 731
kBlendColors = 31
kBlendDevice = 30
kBlendManip = 152
kBlendNodeAdditiveRotation = 1021
kBlendNodeAdditiveScale = 1020
kBlendNodeBase = 1009
kBlendNodeBoolean = 1010
kBlendNodeDouble = 1011
kBlendNodeDoubleAngle = 1012
kBlendNodeDoubleLinear = 1013
kBlendNodeEnum = 1014
kBlendNodeFloat = 1015
kBlendNodeFloatAngle = 1016
kBlendNodeFloatLinear = 1017
kBlendNodeInt16 = 1018
kBlendNodeInt32 = 1019
kBlendNodeTime = 1040
kBlendShape = 336
kBlendTwoAttr = 28
kBlendWeighted = 29
kBlindData = 748
kBlindDataTemplate = 749
kBlinn = 368
kBlinnMaterial = 383
kBoundary = 53
kBox = 858
kBoxData = 857
kBrownian = 501
kBrush = 757
kBulge = 490
kBulgeLattice = 337
kBump = 32
kBump3d = 33
kButtonManip = 153
kCTE = 1094
kCacheBase = 987
kCacheBlend = 988
kCacheFile = 977
kCacheTrack = 989
kCacheableNode = 984
kCaddyManipBase = 1095
kCamera = 250
kCameraManip = 154
kCameraPlaneManip = 143
kCameraSet = 999
kCameraView = 34
kCenterManip = 134
kChainToSpline = 35
kCharacter = 680
kCharacterMap = 795
kCharacterMappingData = 734
kCharacterOffset = 681
kChecker = 491
kChoice = 36
kChooser = 764
kCircle = 54
kCircleManip = 126
kCirclePointManip = 231
kCircleSweepManip = 128
kClampColor = 39
kClientDevice = 1065
kClip = 801
kClipGhostShape = 1070
kClipLibrary = 772
kClipScheduler = 771
kClipToGhostData = 1071
kCloseCurve = 55
kCloseSurface = 57
kClosestPointOnMesh = 979
kClosestPointOnSurface = 56
kCloth = 492
kCloud = 502
kCluster = 251
kClusterFilter = 346
kClusterFlexor = 300
kCoiManip = 155
kCollision = 253
kColorBackground = 24
kColorMgtGlobals = 1089
kColorProfile = 1054
kCommCornerManip = 605
kCommCornerOperManip = 606
kCommEdgeOperManip = 603
kCommEdgePtManip = 602
kCommEdgeSegmentManip = 604
kComponent = 528
kComponentListData = 576
kComponentManip = 666
kCompoundAttribute = 568
kConcentricProjectionManip = 129
kCondition = 37
kCone = 96
kConstraint = 922
kContainer = 1001
kContainerBase = 1056
kContourProjectionManip = 1100
kContrast = 38
kControl = 479
kCopyColorSet = 730
kCopyUVSet = 799
kCpManip = 156
kCrater = 503
kCreaseSet = 1078
kCreate = 40
kCreateBPManip = 828
kCreateBezierManip = 1041
kCreateCVManip = 157
kCreateColorSet = 728
kCreateEPManip = 158
kCreateSectionManip = 815
kCreateUVSet = 800
kCrossSectionEditManip = 816
kCrossSectionManager = 814
kCubicProjectionManip = 130
kCurve = 266
kCurveCVComponent = 529
kCurveCurveIntersect = 633
kCurveEPComponent = 530
kCurveEdManip = 159
kCurveFromMeshCoM = 924
kCurveFromMeshEdge = 632
kCurveFromSubdivEdge = 827
kCurveFromSubdivFace = 833
kCurveFromSurface = 58
kCurveFromSurfaceBnd = 59
kCurveFromSurfaceCoS = 60
kCurveFromSurfaceIso = 61
kCurveInfo = 62
kCurveKnotComponent = 531
kCurveNormalizerAngle = 991
kCurveNormalizerLinear = 992
kCurveParamComponent = 532
kCurveSegmentManip = 160
kCurveVarGroup = 116
kCylinder = 98
kCylindricalProjectionManip = 131
kDOF = 323
kDPbirailSrf = 50
kDagContainer = 1057
kDagNode = 107
kDagPose = 682
kDagSelectionItem = 555
kData = 575
kData2Double = 585
kData2Float = 586
kData2Int = 587
kData2Long = 587
kData2Short = 588
kData3Double = 589
kData3Float = 590
kData3Int = 591
kData3Long = 591
kData3Short = 592
kData4Double = 872
kDblTrsManip = 190
kDecayRegionCapComponent = 541
kDecayRegionComponent = 542
kDefaultLightList = 317
kDeformBend = 617
kDeformBendManip = 623
kDeformFlare = 620
kDeformFlareManip = 626
kDeformFunc = 616
kDeformSine = 621
kDeformSineManip = 627
kDeformSquash = 619
kDeformSquashManip = 625
kDeformTwist = 618
kDeformTwistManip = 624
kDeformWave = 622
kDeformWaveManip = 628
kDeleteColorSet = 729
kDeleteComponent = 318
kDeleteUVSet = 792
kDeltaMush = 349
kDependencyNode = 4
kDetachCurve = 63
kDetachSurface = 64
kDiffuseMaterial = 381
kDimension = 269
kDimensionManip = 232
kDirectedDisc = 276
kDirectionManip = 161
kDirectionalLight = 308
kDiscManip = 132
kDiskCache = 854
kDispatchCompute = 319
kDisplacementShader = 321
kDisplayLayer = 725
kDisplayLayerManager = 726
kDistance = 272
kDistanceBetween = 322
kDistanceManip = 630
kDofManip = 162
kDoubleAngleAttribute = 560
kDoubleArrayData = 577
kDoubleIndexedComponent = 706
kDoubleLinearAttribute = 562
kDoubleShadingSwitch = 611
kDrag = 258
kDropOffFunction = 817
kDropoffLocator = 282
kDropoffManip = 163
kDummy = 254
kDummyConnectable = 324
kDynAirManip = 716
kDynArrayAttrsData = 721
kDynAttenuationManip = 720
kDynBase = 712
kDynBaseFieldManip = 715
kDynEmitterManip = 713
kDynFieldsManip = 714
kDynGlobals = 761
kDynNewtonManip = 717
kDynParticleSetComponent = 553
kDynSpreadManip = 719
kDynSweptGeometryData = 735
kDynTurbulenceManip = 718
kDynamicConstraint = 981
kDynamicsController = 325
kEdgeComponent = 538
kEditCurve = 812
kEditCurveManip = 813
kEditMetadata = 1077
kEditsManager = 1085
kEmitter = 255
kEnableManip = 136
kEnumAttribute = 565
kEnvBall = 484
kEnvChrome = 486
kEnvCube = 485
kEnvFacade = 966
kEnvFogMaterial = 375
kEnvFogShape = 278
kEnvSky = 487
kEnvSphere = 488
kExplodeNurbsShell = 684
kExpression = 327
kExtendCurve = 65
kExtendCurveDistanceManip = 164
kExtendSurface = 66
kExtendSurfaceDistanceManip = 708
kExtract = 328
kExtrude = 67
kExtrudeManip = 165
kFFD = 338
kFFblendSrf = 68
kFFfilletSrf = 69
kFacade = 964
kFfdDualBase = 339
kField = 256
kFileBackground = 25
kFileTexture = 493
kFilletCurve = 70
kFilter = 329
kFilterClosestSample = 330
kFilterEuler = 331
kFilterSimplify = 332
kFitBspline = 71
kFixedLineManip = 233
kFlexor = 299
kFloatAngleAttribute = 561
kFloatArrayData = 1025
kFloatLinearAttribute = 563
kFloatMatrixAttribute = 572
kFloatVectorArrayData = 1002
kFlow = 72
kFluid = 904
kFluidData = 906
kFluidEmitter = 910
kFluidGeom = 905
kFluidTexture2D = 899
kFluidTexture3D = 898
kFollicle = 925
kForceUpdateManip = 687
kFosterParent = 1080
kFourByFourMatrix = 767
kFractal = 494
kFreePointManip = 133
kFreePointTriadManip = 137
kGammaCorrect = 333
kGenericAttribute = 569
kGeoConnectable = 326
kGeoConnector = 912
kGeomBind = 1088
kGeometric = 265
kGeometryConstraint = 113
kGeometryData = 704
kGeometryFilt = 334
kGeometryOnLineManip = 142
kGeometryVarGroup = 114
kGlobalCacheControls = 853
kGlobalStitch = 693
kGranite = 504
kGravity = 259
kGreasePencilSequence = 1076
kGreasePlane = 1074
kGreasePlaneRenderShape = 1075
kGrid = 495
kGroundPlane = 290
kGroupId = 351
kGroupParts = 352
kGuide = 353
kGuideLine = 301
kHairConstraint = 930
kHairSystem = 926
kHairTubeShader = 937
kHandleRotateManip = 216
kHardenPointCurve = 73
kHardwareReflectionMap = 877
kHardwareRenderGlobals = 520
kHardwareRenderingGlobals = 1059
kHeightField = 911
kHikEffector = 951
kHikFKJoint = 953
kHikFloorContactMarker = 973
kHikGroundPlane = 974
kHikHandle = 955
kHikIKEffector = 952
kHikSolver = 954
kHistorySwitch = 978
kHsvToRgb = 354
kHwShaderNode = 880
kHyperGraphInfo = 355
kHyperLayout = 356
kHyperLayoutDG = 993
kHyperView = 357
kIkEffector = 119
kIkHandle = 120
kIkRPManip = 167
kIkSolver = 358
kIkSplineManip = 166
kIkSystem = 364
kIllustratorCurve = 74
kImageAdd = 651
kImageBlur = 657
kImageColorCorrect = 656
kImageData = 645
kImageDepth = 659
kImageDiff = 652
kImageDisplay = 660
kImageFilter = 658
kImageLoad = 646
kImageMotionBlur = 662
kImageMultiply = 653
kImageNetDest = 649
kImageNetSrc = 648
kImageOver = 654
kImagePlane = 365
kImageRender = 650
kImageSave = 647
kImageSource = 783
kImageUnder = 655
kImageView = 661
kImplicitCone = 885
kImplicitSphere = 886
kInsertKnotCrv = 75
kInsertKnotSrf = 76
kInstancer = 754
kIntArrayData = 578
kIntersectSurface = 77
kInvalid = 0
kIsoparmComponent = 533
kIsoparmManip = 146
kItemList = 557
kJiggleDeformer = 852
kJoint = 121
kJointCluster = 348
kJointClusterManip = 168
kJointTranslateManip = 229
kKeyframeDelta = 939
kKeyframeDeltaAddRemove = 942
kKeyframeDeltaBlockAddRemove = 943
kKeyframeDeltaBreakdown = 947
kKeyframeDeltaInfType = 944
kKeyframeDeltaMove = 940
kKeyframeDeltaScale = 941
kKeyframeDeltaTangent = 945
kKeyframeDeltaWeighted = 946
kKeyframeRegionManip = 990
kKeyingGroup = 679
kLambert = 366
kLambertMaterial = 382
kLast = 1107
kLattice = 279
kLatticeComponent = 539
kLatticeData = 579
kLatticeGeom = 280
kLayeredShader = 371
kLayeredTexture = 796
kLeastSquares = 373
kLeather = 505
kLight = 302
kLightDataAttribute = 570
kLightFogMaterial = 374
kLightInfo = 372
kLightLink = 760
kLightList = 376
kLightManip = 169
kLightProjectionGeometry = 234
kLightSource = 377
kLightSourceMaterial = 385
kLimitManip = 135
kLineArrowManip = 235
kLineManip = 147
kLineModifier = 968
kLinearLight = 306
kLocator = 281
kLodGroup = 765
kLodThresholds = 763
kLookAt = 112
kLuminance = 378
kMCsolver = 359
kMPbirailSrf = 51
kMakeGroup = 379
kMandelbrot = 1072
kMandelbrot3D = 1073
kManip2DContainer = 192
kManipContainer = 148
kManipulator = 230
kManipulator2D = 205
kManipulator3D = 122
kMarble = 506
kMarker = 283
kMarkerManip = 210
kMaterial = 380
kMaterialFacade = 965
kMaterialInfo = 386
kMatrixAdd = 387
kMatrixArrayData = 595
kMatrixAttribute = 571
kMatrixData = 580
kMatrixFloatData = 664
kMatrixHold = 388
kMatrixMult = 389
kMatrixPass = 390
kMatrixWtAdd = 391
kMembrane = 1026
kMentalRayTexture = 932
kMergeVertsToolManip = 1027
kMesh = 296
kMeshComponent = 543
kMeshData = 581
kMeshEdgeComponent = 544
kMeshFaceVertComponent = 548
kMeshFrEdgeComponent = 546
kMeshGeom = 297
kMeshMapComponent = 808
kMeshPolygonComponent = 545
kMeshVarGroup = 117
kMeshVertComponent = 547
kMeshVtxFaceComponent = 737
kMessageAttribute = 573
kMidModifier = 392
kMidModifierWithMatrix = 393
kModel = 3
kModifyEdgeBaseManip = 829
kModifyEdgeCrvManip = 820
kModifyEdgeManip = 821
kMotionPath = 438
kMotionPathManip = 170
kMountain = 496
kMoveUVShellManip2D = 702
kMoveVertexManip = 755
kMultDoubleLinear = 766
kMultiSubVertexComponent = 551
kMultilisterLight = 440
kMultiplyDivide = 441
kMute = 921
kNBase = 986
kNCloth = 995
kNComponent = 982
kNId = 1024
kNIdData = 1023
kNLE = 1083
kNObject = 1004
kNObjectData = 1003
kNParticle = 996
kNRigid = 997
kNamedObject = 2
kNearestPointOnCurve = 1053
kNewton = 260
kNodeGraphEditorBookmarkInfo = 1103
kNodeGraphEditorBookmarks = 1102
kNodeGraphEditorInfo = 1101
kNoise = 870
kNonAmbientLight = 304
kNonDagSelectionItem = 556
kNonExtendedLight = 307
kNonLinear = 615
kNormalConstraint = 238
kNucleus = 985
kNumericAttribute = 559
kNumericData = 584
kNurbsBoolean = 685
kNurbsCircular2PtArc = 635
kNurbsCircular3PtArc = 634
kNurbsCube = 80
kNurbsCurve = 267
kNurbsCurveData = 583
kNurbsCurveGeom = 268
kNurbsCurveToBezier = 1044
kNurbsPlane = 79
kNurbsSquare = 613
kNurbsSurface = 294
kNurbsSurfaceData = 582
kNurbsSurfaceGeom = 295
kNurbsTesselate = 78
kNurbsToSubdiv = 752
kObjectAttrFilter = 672
kObjectBinFilter = 933
kObjectFilter = 668
kObjectMultiFilter = 669
kObjectNameFilter = 670
kObjectRenderFilter = 673
kObjectScriptFilter = 674
kObjectTypeFilter = 671
kOcean = 866
kOceanShader = 889
kOffsetCos = 81
kOffsetCosManip = 171
kOffsetCurve = 82
kOffsetCurveManip = 172
kOffsetSurface = 636
kOffsetSurfaceManip = 644
kOldGeometryConstraint = 442
kOpticalFX = 443
kOrientConstraint = 239
kOrientationComponent = 549
kOrientationLocator = 286
kOrientationMarker = 284
kOrthoGrid = 291
kPASolver = 360
kPairBlend = 917
kParamDimension = 275
kParentConstraint = 242
kParticle = 311
kParticleAgeMapper = 444
kParticleCloud = 445
kParticleColorMapper = 446
kParticleIncandecenceMapper = 447
kParticleSamplerInfo = 798
kParticleTransparencyMapper = 448
kPartition = 449
kPassContributionMap = 779
kPfxGeometry = 935
kPfxHair = 936
kPfxToon = 961
kPhong = 369
kPhongExplorer = 370
kPhongMaterial = 384
kPivotComponent = 534
kPivotManip2D = 191
kPlace2dTexture = 450
kPlace3dTexture = 451
kPlanarProjectionManip = 207
kPlanarTrimSrf = 83
kPlane = 288
kPlugin = 574
kPluginBlendShape = 1106
kPluginCameraSet = 1000
kPluginClientDevice = 1066
kPluginConstraintNode = 1005
kPluginData = 593
kPluginDeformerNode = 607
kPluginDependNode = 452
kPluginEmitterNode = 723
kPluginFieldNode = 722
kPluginGeometryData = 759
kPluginGeometryFilter = 1105
kPluginHardwareShader = 881
kPluginHwShaderNode = 882
kPluginIkSolver = 753
kPluginImagePlaneNode = 994
kPluginLocatorNode = 453
kPluginManipContainer = 688
kPluginManipulatorNode = 1022
kPluginMotionPathNode = 439
kPluginObjectSet = 914
kPluginParticleAttributeMapperNode = 998
kPluginShape = 703
kPluginSkinCluster = 1104
kPluginSpringNode = 724
kPluginThreadedDevice = 1067
kPluginTransformNode = 903
kPlusMinusAverage = 454
kPointArrayData = 594
kPointConstraint = 240
kPointLight = 309
kPointManip = 236
kPointMatrixMult = 455
kPointOnCurveInfo = 84
kPointOnCurveManip = 208
kPointOnLineManip = 211
kPointOnPolyConstraint = 1048
kPointOnSurfaceInfo = 85
kPointOnSurfaceManip = 212
kPoleVectorConstraint = 243
kPolyAppend = 396
kPolyAppendVertex = 788
kPolyArrow = 969
kPolyAutoProj = 842
kPolyAutoProjManip = 957
kPolyAverageVertex = 841
kPolyBevel = 394
kPolyBevel2 = 1086
kPolyBevel3 = 1090
kPolyBlindData = 750
kPolyBoolOp = 609
kPolyBridgeEdge = 983
kPolyCBoolOp = 1087
kPolyCaddyManip = 1096
kPolyChipOff = 397
kPolyCloseBorder = 398
kPolyCollapseEdge = 399
kPolyCollapseF = 400
kPolyColorDel = 733
kPolyColorMod = 732
kPolyColorPerVertex = 727
kPolyComponentData = 975
kPolyCone = 430
kPolyConnectComponents = 1049
kPolyContourProj = 1099
kPolyCreaseEdge = 949
kPolyCreateFacet = 436
kPolyCreateToolManip = 140
kPolyCreator = 428
kPolyCube = 431
kPolyCut = 892
kPolyCutManip = 896
kPolyCutManipContainer = 895
kPolyCylProj = 401
kPolyCylinder = 432
kPolyDelEdge = 402
kPolyDelFacet = 403
kPolyDelVertex = 404
kPolyDuplicateEdge = 963
kPolyEdgeToCurve = 1007
kPolyEditEdgeFlow = 1079
kPolyExtrudeEdge = 785
kPolyExtrudeFacet = 405
kPolyExtrudeManip = 1062
kPolyExtrudeManipContainer = 1063
kPolyExtrudeVertex = 916
kPolyFlipEdge = 784
kPolyFlipUV = 879
kPolyHelix = 976
kPolyHoleFace = 1047
kPolyLayoutUV = 843
kPolyMapCut = 406
kPolyMapDel = 407
kPolyMapSew = 408
kPolyMapSewMove = 844
kPolyMappingManip = 194
kPolyMergeEdge = 409
kPolyMergeFacet = 410
kPolyMergeUV = 900
kPolyMergeVert = 690
kPolyMesh = 433
kPolyMirror = 948
kPolyModifierManip = 195
kPolyModifierManipContainer = 1097
kPolyMoveEdge = 411
kPolyMoveFacet = 412
kPolyMoveFacetUV = 413
kPolyMoveUV = 414
kPolyMoveUVManip = 193
kPolyMoveVertex = 415
kPolyMoveVertexManip = 196
kPolyMoveVertexUV = 416
kPolyNormal = 417
kPolyNormalPerVertex = 751
kPolyNormalizeUV = 878
kPolyPinUV = 950
kPolyPipe = 972
kPolyPlanProj = 418
kPolyPlatonicSolid = 971
kPolyPoke = 893
kPolyPokeManip = 897
kPolyPrimitive = 429
kPolyPrimitiveMisc = 970
kPolyPrism = 958
kPolyProj = 419
kPolyProjectCurve = 1060
kPolyProjectionManip = 174
kPolyPyramid = 959
kPolyQuad = 420
kPolyReduce = 762
kPolyRemesh = 1098
kPolySelectEditFeedbackManip = 1030
kPolySeparate = 456
kPolySewEdge = 689
kPolySmooth = 421
kPolySmoothFacet = 691
kPolySmoothProxy = 934
kPolySoftEdge = 422
kPolySphProj = 423
kPolySphere = 434
kPolySpinEdge = 1046
kPolySplit = 424
kPolySplitEdge = 806
kPolySplitRing = 960
kPolySplitToolManip = 141
kPolySplitVert = 802
kPolyStraightenUVBorder = 901
kPolySubdEdge = 425
kPolySubdFacet = 426
kPolyToSubdiv = 677
kPolyToolFeedbackManip = 1029
kPolyToolFeedbackShape = 312
kPolyTorus = 435
kPolyTransfer = 840
kPolyTriangulate = 427
kPolyTweak = 395
kPolyTweakUV = 701
kPolyUVRectangle = 1058
kPolyUnite = 437
kPolyVertexNormalManip = 197
kPolyWedgeFace = 894
kPositionMarker = 285
kPostProcessList = 457
kPrecompExport = 780
kPrimitive = 86
kProjectCurve = 87
kProjectTangent = 88
kProjectTangentManip = 177
kProjection = 458
kProjectionManip = 173
kProjectionMultiManip = 176
kProjectionUVManip = 175
kPropModManip = 178
kPropMoveTriadManip = 138
kProxy = 108
kProxyManager = 956
kPsdFileTexture = 938
kQuadPtOnLineManip = 179
kQuadShadingSwitch = 915
kRBFsurface = 89
kRPsolver = 362
kRadial = 261
kRadius = 274
kRamp = 497
kRampBackground = 26
kRampShader = 887
kRbfSrfManip = 180
kRebuildCurve = 90
kRebuildSurface = 91
kRecord = 459
kReference = 747
kReflect = 367
kRemapColor = 928
kRemapHsv = 929
kRemapValue = 927
kRenderBox = 859
kRenderCone = 97
kRenderGlobals = 516
kRenderGlobalsList = 517
kRenderLayer = 777
kRenderLayerManager = 778
kRenderPass = 775
kRenderPassSet = 776
kRenderQuality = 518
kRenderRect = 277
kRenderSetup = 515
kRenderSphere = 298
kRenderTarget = 781
kRenderUtilityList = 460
kRenderedImageSource = 782
kRenderingList = 1061
kResolution = 519
kResultCurve = 16
kResultCurveTimeToAngular = 17
kResultCurveTimeToDistance = 18
kResultCurveTimeToTime = 19
kResultCurveTimeToUnitless = 20
kReverse = 461
kReverseCrvManip = 182
kReverseCurve = 92
kReverseCurveManip = 181
kReverseSurface = 93
kReverseSurfaceManip = 183
kRevolve = 94
kRevolveManip = 184
kRevolvedPrimitive = 95
kRevolvedPrimitiveManip = 185
kRgbToHsv = 462
kRigid = 314
kRigidConstraint = 313
kRigidDeform = 340
kRigidSolver = 463
kRock = 507
kRotateBoxManip = 214
kRotateLimitsManip = 217
kRotateManip = 215
kRotateUVManip2D = 699
kRoundConstantRadius = 637
kRoundConstantRadiusManip = 640
kRoundRadiusCrvManip = 639
kRoundRadiusManip = 638
kSCsolver = 361
kSPbirailSrf = 52
kSamplerInfo = 471
kScaleConstraint = 244
kScaleLimitsManip = 218
kScaleManip = 219
kScalePointManip = 822
kScaleUVManip2D = 700
kScalingBoxManip = 220
kScreenAlignedCircleManip = 127
kScript = 631
kScriptManip = 221
kSculpt = 341
kSectionManip = 809
kSelectionItem = 554
kSelectionList = 600
kSelectionListData = 667
kSelectionListOperator = 675
kSequenceManager = 1037
kSequencer = 1038
kSet = 464
kSetGroupComponent = 552
kSetRange = 467
kSfRevolveManip = 832
kShaderGlow = 468
kShaderList = 469
kShadingEngine = 320
kShadingMap = 470
kShape = 248
kShapeFragment = 472
kShot = 1039
kShrinkWrapFilter = 1084
kSimpleVolumeShader = 473
kSingleIndexedComponent = 705
kSingleShadingSwitch = 610
kSketchPlane = 289
kSkin = 100
kSkinBinding = 1050
kSkinClusterFilter = 678
kSkinShader = 665
kSl60 = 474
kSmear = 907
kSmoothCurve = 692
kSmoothTangentSrf = 774
kSnapUVManip2D = 1081
kSnapshot = 475
kSnapshotPath = 913
kSnapshotShape = 850
kSnow = 508
kSoftMod = 252
kSoftModFilter = 347
kSoftModManip = 629
kSolidFractal = 509
kSphere = 99
kSphereData = 596
kSphericalProjectionManip = 222
kSplineSolver = 363
kSpotCylinderManip = 187
kSpotLight = 310
kSpotManip = 186
kSpring = 315
kSprite = 292
kSquareSrf = 709
kSquareSrfManip = 710
kStateManip = 145
kStencil = 498
kStereoCameraMaster = 1036
kStitchAsNurbsShell = 683
kStitchSrf = 101
kStitchSrfManip = 686
kStoryBoard = 476
kStringArrayData = 598
kStringData = 597
kStringShadingSwitch = 908
kStroke = 756
kStrokeGlobals = 758
kStucco = 510
kStudioClearCoat = 909
kStyleCurve = 891
kSubCurve = 102
kSubSurface = 773
kSubVertexComponent = 550
kSubdAddTopology = 883
kSubdAutoProj = 868
kSubdBlindData = 794
kSubdBoolean = 818
kSubdCleanTopology = 884
kSubdCloseBorder = 855
kSubdDelFace = 849
kSubdExtrudeFace = 830
kSubdHierBlind = 793
kSubdLayoutUV = 864
kSubdMapCut = 863
kSubdMapSewMove = 865
kSubdMappingManip = 876
kSubdMergeVert = 856
kSubdModifier = 845
kSubdModifyEdge = 819
kSubdMoveEdge = 847
kSubdMoveFace = 848
kSubdMoveVertex = 846
kSubdPlanProj = 873
kSubdProjectionManip = 875
kSubdSplitFace = 860
kSubdSubdivideFace = 869
kSubdTweak = 874
kSubdTweakUV = 862
kSubdiv = 676
kSubdivCVComponent = 694
kSubdivCollapse = 797
kSubdivCompId = 790
kSubdivData = 803
kSubdivEdgeComponent = 695
kSubdivFaceComponent = 696
kSubdivGeom = 804
kSubdivMapComponent = 851
kSubdivReverseFaces = 807
kSubdivSurfaceVarGroup = 831
kSubdivToNurbs = 811
kSubdivToPoly = 711
kSummaryObject = 477
kSuper = 478
kSurface = 293
kSurfaceCVComponent = 535
kSurfaceEPComponent = 536
kSurfaceEdManip = 769
kSurfaceFaceComponent = 770
kSurfaceInfo = 103
kSurfaceKnotComponent = 537
kSurfaceLuminance = 480
kSurfaceRangeComponent = 540
kSurfaceShader = 481
kSurfaceVarGroup = 118
kSymmetryConstraint = 241
kSymmetryLocator = 824
kSymmetryMapCurve = 826
kSymmetryMapVector = 825
kTangentConstraint = 245
kTexLattice = 200
kTexLatticeDeformManip = 199
kTexSmoothManip = 201
kTexSmudgeUVManip = 198
kTextButtonManip = 643
kTextCurves = 104
kTextManip = 918
kTexture2d = 489
kTexture3d = 500
kTextureBakeSet = 465
kTextureDeformer = 342
kTextureDeformerHandle = 343
kTextureEnv = 483
kTextureList = 482
kTextureManip3D = 223
kThreadedDevice = 1064
kThreePointArcManip = 641
kTime = 513
kTimeAttribute = 564
kTimeFunction = 931
kTimeToUnitConversion = 514
kTimeWarp = 1068
kToggleManip = 224
kToggleOnLineManip = 144
kToolContext = 1082
kToonLineAttributes = 962
kTorus = 608
kTowPointManip = 139
kTowPointOnCurveManip = 209
kTowPointOnSurfaceManip = 768
kTransferAttributes = 980
kTransform = 110
kTransformBoxManip = 823
kTransformGeometry = 601
kTranslateBoxManip = 225
kTranslateLimitsManip = 226
kTranslateManip = 227
kTranslateManip2D = 206
kTranslateUVManip = 213
kTranslateUVManip2D = 698
kTriadManip = 237
kTrim = 105
kTrimLocator = 287
kTrimManip = 228
kTrimWithBoundaries = 923
kTriplanarProjectionManip = 188
kTripleIndexedComponent = 707
kTripleShadingSwitch = 612
kTrsInsertManip = 203
kTrsManip = 189
kTrsTransManip = 202
kTrsXformManip = 204
kTurbulence = 262
kTweak = 344
kTwoPointArcManip = 642
kTxSl = 511
kTypedAttribute = 567
kUInt64ArrayData = 805
kUVManip2D = 697
kUint64SingleIndexedComponent = 1028
kUnderWorld = 109
kUniform = 263
kUnitAttribute = 566
kUnitConversion = 522
kUnitToTimeConversion = 523
kUnknown = 525
kUnknownDag = 316
kUnknownTransform = 246
kUntrim = 106
kUnused1 = 834
kUnused2 = 835
kUnused3 = 836
kUnused4 = 837
kUnused5 = 838
kUnused6 = 839
kUseBackground = 524
kUvChooser = 789
kVectorArrayData = 599
kVectorProduct = 526
kVertexBakeSet = 466
kVertexWeightSet = 1052
kViewColorManager = 663
kViewManip = 919
kVolumeAxis = 791
kVolumeBindManip = 1051
kVolumeFog = 861
kVolumeLight = 888
kVolumeNoise = 867
kVolumeShader = 527
kVortex = 264
kWater = 499
kWeightGeometryFilt = 345
kWire = 350
kWood = 512
kWorld = 247
kWrapFilter = 736
kWriteToColorBuffer = 1032
kWriteToDepthBuffer = 1034
kWriteToFrameBuffer = 1031
kWriteToLabelBuffer = 1035
kWriteToVectorBuffer = 1033
kXformManip = 920
kXsectionSubdivEdit = 810
class MFnAttribute(MFnBase):
"""
Base class for attribute functionsets.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnBase(object):
"""
Base class for function sets.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnCamera(MFnDagNode):
"""
Function set for cameras.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addChild(self, *args, **kwargs):
"""
addChild(node, index=kNextPos, keepExistingParents=False) -> self
Makes a node a child of this one.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def aspectRatio(self, *args, **kwargs):
"""
aspectRatio() -> float
Returns the aspect ratio for the camera.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
@property
def boundingBox(self, *args, **kwargs):
"""
Nodes bounding box, in object space.
"""
pass
@property
def cameraScale(self, *args, **kwargs):
"""
The camera scale.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
@property
def centerOfInterest(self, *args, **kwargs):
"""
The linear distance from the cameras eye point to the center of interest.
"""
pass
def centerOfInterestPoint(self, *args, **kwargs):
"""
centerOfInterestPoint(space=kObject) -> MPoint
Returns the center of interest point for the camera.
* space (int) - Specifies the coordinate system for this operation
"""
pass
def child(self, *args, **kwargs):
"""
child(index) -> MObject
Returns the specified child of this node.
"""
pass
def childCount(self, *args, **kwargs):
"""
childCount() -> int
Returns the number of nodes which are children of this one.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def computeDepthOfField(self, *args, **kwargs):
"""
computeDepthOfField(nearLimit=None) -> self
Compute the depth of field
* nearLimit (float) - the near limit
"""
pass
def copyViewFrom(self, *args, **kwargs):
"""
copyViewFrom(otherCamera) -> self
Copy the camera settings related to the perspective from the given camera view.
This method will only work when the world space information for the camera is available, i.e. when the function set has been initialized with a DAG path.
* otherCamera (MDagPath) - Camera to copy view from
"""
pass
def create(self, *args, **kwargs):
"""
create(parent=None) -> MObject
Creates a perspective camera. A parent can be specified for the new camera, otherwise a transform is created.
The camera is positioned at (0, 0, 0), its center of interest at (0, 0, -1), which implies that the view-direction is pointing in the direction of the negative z-axis, and its up-direction along the positive Y axis.
* parent (MObject) - The parent of the new camera
"""
pass
def dagPath(self, *args, **kwargs):
"""
dagPath() -> MDagPath
Returns the DAG path to which this function set is attached. Raises a TypeError if the function set is attached to an MObject rather than a path.
"""
pass
def dagRoot(self, *args, **kwargs):
"""
dagRoot() -> MObject
Returns the root node of the first path leading to this node.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
def duplicate(self, *args, **kwargs):
"""
duplicate(instance=False, instanceLeaf=False) -> MObject
Duplicates the DAG hierarchy rooted at the current node.
"""
pass
def eyePoint(self, *args, **kwargs):
"""
eyePoint(space=kObject) -> MPoint
Returns the eye point for the camera.
* space (int) - Specifies the coordinate system for this operation
"""
pass
@property
def fStop(self, *args, **kwargs):
"""
The f-stop value for the camera.
"""
pass
@property
def farClippingPlane(self, *args, **kwargs):
"""
The distance to the far clipping plane.
"""
pass
@property
def farFocusDistance(self, *args, **kwargs):
"""
The farthest distance within the well-focus region
"""
pass
@property
def filmFit(self, *args, **kwargs):
"""
How the digital image is to be fitted to the film back.
Valid values:
* kFillFilmFit The system calculates both horizontal and vertical fits and then applies the one that makes the digital image larger than the film back.
* kHorizontalFilmFit The digital image is made to fit the film back exactly in the horizontal direction. This then gives each pixel a horizontal size = (film back width) / (horizontal resolution). The pixel height is then = (pixel width) / (pixel aspect ratio). Now that the pixel has a size, resolution gives us a complete image. That image will match the film back exactly in width. It will almost never match in height, either being too tall or too short. By playing with the numbers you can get it pretty close though.
* kVerticalFilmFit The same idea as horizontal fit, only applied vertically. Thus the digital image will match the film back exactly in height, but miss in width.
* kOverscanFilmFit Over-scanning the film gate in the camera view allows us to choreograph action outside of the frustum from within the camera view without having to resort to a dolly or zoom. This feature is also essential for animating image planes.
"""
pass
@property
def filmFitOffset(self, *args, **kwargs):
"""
The film fit offset for the camera.
"""
pass
@property
def filmRollOrder(self, *args, **kwargs):
"""
The order in which the film back rotation is applied with respect to the pivot point.
Valid values:
* kRotateTranslate The film back is first rotated before it is translated by the pivot value.
* kTranslateRotate The film back is translated by the pivot before it is rotated.
"""
pass
@property
def filmRollValue(self, *args, **kwargs):
"""
The film roll value for film back.
"""
pass
@property
def filmTranslateH(self, *args, **kwargs):
"""
The horizontal film translate value. This value corresponds to the normalized viewport.
"""
pass
@property
def filmTranslateV(self, *args, **kwargs):
"""
The vertical film translate value. This value corresponds to the normalized viewport, [-1,1].
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
@property
def focalLength(self, *args, **kwargs):
"""
The focal length for the camera.
This is the distance along the lens axis between the lens and the film plane when focal distance is infinitely large. This is an optical property of the lens. Specified in millimeters.
"""
pass
@property
def focusDistance(self, *args, **kwargs):
"""
The focus distance for the camera. This value sets the focus at a certain distance in front of the camera.
"""
pass
def fullPathName(self, *args, **kwargs):
"""
fullPathName() -> string
Returns the full path of the attached object, from the root of the DAG on down.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getAllPaths(self, *args, **kwargs):
"""
getAllPaths() -> MDagPathArray
Returns all of the DAG paths which lead to the object to which this function set is attached.
"""
pass
def getAspectRatioLimits(self, *args, **kwargs):
"""
getAspectRatioLimits() -> (float, float)
Returns the minimum and maximum aspect ratio limits for the camera.
"""
pass
def getConnectedSetsAndMembers(self, *args, **kwargs):
"""
getConnectedSetsAndMembers(instance, renderableSetsOnly) -> (MObjectArray, MObjectArray)
Returns a tuple containing an array of sets and an array of the
components of the DAG object which are in those sets. If the entire object is in a set, then the corresponding entry in the comps array will have no elements in it.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def getFilmApertureLimits(self, *args, **kwargs):
"""
getFilmApertureLimits() -> (float, float)
Returns the maximum and minimum film aperture limits for the camera.
"""
pass
def getFilmFrustum(self, *args, **kwargs):
"""
getFilmFrustum(distance, applyPanZoom=False) -> (float, float, float, float)
Returns the film frustum for the camera (horizontal size, vertical size, horizontal offset and vertical offset). The frustum defines the projective transformation.
* distance (float) - Specifies the focal length
* applyPanZoom (bool) - specifies whether to apply 2D pan/zoom
"""
pass
def getFilmFrustumCorners(self, *args, **kwargs):
"""
getFilmFrustumCorners(distance, applyPanZoom=False) -> MPointArray
Returns the film frustum for the camera. The frustum defines the projective transformation.
element 0 is the bottom left
element 1 is the top left
element 2 is the top right
element 3 is the bottom right
* distance (float) - Specifies the focal length
* applyPanZoom (bool) - specifies whether to apply 2D pan/zoom
"""
pass
def getFocalLengthLimits(self, *args, **kwargs):
"""
getFocalLengthLimits() -> (float, float)
Returns the maximum and minimum focal length limits for the camera.
"""
pass
def getPath(self, *args, **kwargs):
"""
getPath() -> MDagPath
Returns the DAG path to which this function set is attached, or the first path to the node if the function set is attached to an MObject.
"""
pass
def getPortFieldOfView(self, *args, **kwargs):
"""
getPortFieldOfView(int, int) -> (float, float)
Returns the horizontal and vertical field of view in radians from the given viewport width and height.
* width (int) - width of viewport
* height (int) - height of viewport
"""
pass
def getRenderingFrustum(self, *args, **kwargs):
"""
getRenderingFrustum(windowAspect) -> (float, float, float, float)
Returns the rendering frustum (left, right, bottom and top) for the camera.
This is the frustum that the maya renderer uses.
* windowAspect (float) - windowAspect
"""
pass
def getViewParameters(self, *args, **kwargs):
"""
getViewParameters(windowAspect, applyOverscan=False, applySqueeze=False, applyPanZoom=False) -> (float, float, float, float)
Returns the intermediate viewing frustum (apertureX, apertureY, offsetX and offsetY) parameters for the camera. The aperture and offset are used by getViewingFrustum() and getRenderingFrustum() to compute the extent (left, right, top, bottom) of the frustum in the following manner:
left = focal_to_near * (-0.5*apertureX + offsetX)
right = focal_to_near * (0.5*apertureX + offsetX)
bottom = focal_to_near * (-0.5*apertureY + offsetY)
top = focal_to_near * (0.5*apertureY + offsetY)
Here, focal_to_near is equal to cameraScale if the camera is orthographic, or it is equal to ((nearClippingPlane / (focalLength * MM_TO_INCH)) * cameraScale) where MM_TO_INCH equals 0.03937.
* windowAspect (float) - windowAspect
* applyOverscan (bool) - specifies whether to apply overscan
* applySqueeze (bool) - specifies whether to apply the lens squeeze ratio of the camera
* applyPanZoom (bool) - specifies whether to apply 2D pan/zoom
"""
pass
def getViewingFrustum(self, *args, **kwargs):
"""
getViewingFrustum(windowAspect, applyOverscan=False, applySqueeze=False, applyPanZoom=False) -> (float, float, float, float)
Returns the viewing frustum (left, right, bottom and top) for the camera.
* windowAspect (float) - windowAspect
* applyOverscan (bool) - specifies whether to apply overscan
* applySqueeze (bool) - specifies whether to apply the lens squeeze ratio of the camera
* applyPanZoom (bool) - specifies whether to apply 2D pan/zoom
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasChild(self, *args, **kwargs):
"""
hasChild(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasParent(self, *args, **kwargs):
"""
hasParent(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def hasSamePerspective(self, *args, **kwargs):
"""
hasSamePerspective(otherCamera) -> bool
Returns True if the camera has same perspective settings as the given camera.
This method will only work when the world space information for the camera is available, i.e. when the function set has been initialized with a DAG path.
* otherCamera (MDagPath) - Camera to compare perspective with
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
def horizontalFieldOfView(self, *args, **kwargs):
"""
horizontalFieldOfView() -> float
Returns the horizontal field of view for the camera.
"""
pass
@property
def horizontalFilmAperture(self, *args, **kwargs):
"""
The horizontal film aperture for the camera.
"""
pass
@property
def horizontalFilmOffset(self, *args, **kwargs):
"""
The horizontal offset of the film. Unit used is inches.
"""
pass
@property
def horizontalPan(self, *args, **kwargs):
"""
The camera 2D horizontal pan value. Unit is inches.
"""
pass
@property
def horizontalRollPivot(self, *args, **kwargs):
"""
The horizontal roll pivot for film back roll.
"""
pass
@property
def horizontalShake(self, *args, **kwargs):
"""
The horizontal offset of the film due to the shake attribute. Unit used is inches.
"""
pass
@property
def inModel(self, *args, **kwargs):
"""
True if the node has been added to the model.
"""
pass
@property
def inUnderWorld(self, *args, **kwargs):
"""
True if this node is in the underworld of another node (e.g. a curve on surface is in the underworld of the surface).
"""
pass
def instanceCount(self, *args, **kwargs):
"""
instanceCount(indirect) -> int
Returns the number of instances for this node.
"""
pass
def isChildOf(self, *args, **kwargs):
"""
isChildOf(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
@property
def isClippingPlanes(self, *args, **kwargs):
"""
Whether or not manual clipping planes are activated.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
@property
def isDepthOfField(self, *args, **kwargs):
"""
Whether or not the depth of field calculation is performed for the camera.
"""
pass
@property
def isDisplayFilmGate(self, *args, **kwargs):
"""
Whether or not the film gate icons are displayed when looking through the camera.
"""
pass
@property
def isDisplayGateMask(self, *args, **kwargs):
"""
Whether or not the film gate is displayed shaded.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isInstanceable(self, *args, **kwargs):
"""
True if instancing is allowed for this node.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
isInstanced(indirect=True) -> bool
Returns True if this node is instanced.
"""
pass
def isInstancedAttribute(self, *args, **kwargs):
"""
isInstancedAttribute(attr) -> bool
Returns True if the specified attribute is an instanced attribute of this node.
"""
pass
@property
def isIntermediateObject(self, *args, **kwargs):
"""
True if this node is just an intermediate in part of a larger calculation (e.g. input to a deformer).
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
@property
def isMotionBlur(self, *args, **kwargs):
"""
Wheter or not motion blur is on/off for the camera.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
def isOrtho(self, *args, **kwargs):
"""
isOrtho() -> bool
Returns True if the camera is in orthographic mode.
"""
pass
def isParentOf(self, *args, **kwargs):
"""
isParentOf(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
@property
def isVerticalLock(self, *args, **kwargs):
"""
Determines if vertical lock is turned on for the camera.
"""
pass
kExtensionAttr = 3
kFillFilmFit = 0
kHorizontalFilmFit = 1
kInvalid = 4
kInvalidAttr = 4
kLocalDynamicAttr = 1
kNextPos = 255
kNormalAttr = 2
kOverscanFilmFit = 3
kRotateTranslate = 0
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
kTranslateRotate = 1
kVerticalFilmFit = 2
@property
def lensSqueezeRatio(self, *args, **kwargs):
"""
The lens squeeze ratio for the camera
"""
pass
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
@property
def nearClippingPlane(self, *args, **kwargs):
"""
The distance to the near clipping plane.
"""
pass
@property
def nearFocusDistance(self, *args, **kwargs):
"""
The nearest distance within the well-focus region
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def objectColor(self, *args, **kwargs):
"""
Index from 0 to 7 indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorRGB(self, *args, **kwargs):
"""
RGB value indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorType(self, *args, **kwargs):
"""
Determines whether the default color, indexed object color, orRGB object color is used for this object.
"""
pass
@property
def orthoWidth(self, *args, **kwargs):
"""
The orthographic projection width.
"""
pass
@property
def overscan(self, *args, **kwargs):
"""
The percent of overscan for this camera.
"""
pass
@property
def panZoomEnabled(self, *args, **kwargs):
"""
The toggle value for the camera 2D pan/zoom enabled attribute.
If this attribute is False, the 2D pan/zoom values are ignored by the camera.
"""
pass
def parent(self, *args, **kwargs):
"""
parent(index) -> MObject
Returns the specified parent of this node.
"""
pass
def parentCount(self, *args, **kwargs):
"""
parentCount() -> int
Returns the number of parents this node has.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
partialPathName() -> string
Returns the minimum path string necessary to uniquely identify the attached object.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def postProjectionMatrix(self, *args, **kwargs):
"""
postProjectionMatrix(context=None) -> MFloatMatrix
Returns the post projection matrix used to compute film roll on the film back plane.
* context (MDGContext) - DG time-context to specify time of evaluation
"""
pass
@property
def postScale(self, *args, **kwargs):
"""
The post projection matrixs post-scale value.
"""
pass
@property
def preScale(self, *args, **kwargs):
"""
The post projection matrixs pre-scale value.
"""
pass
def projectionMatrix(self, *args, **kwargs):
"""
projectionMatrix(context=None) -> MFloatMatrix
Returns the orthographic or perspective projection matrix for the camera.
The projection matrix that mayas software renderer uses is almost identical to the OpenGL projection matrix. The difference is that maya uses a left hand coordinate system and so the entries [2][2] and [3][2] are negated.
* context (MDGContext) - DG time-context to specify time of evaluation
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def removeChild(self, *args, **kwargs):
"""
removeChild(node) -> self
Removes the child, specified by MObject, reparenting it under the world.
"""
pass
def removeChildAt(self, *args, **kwargs):
"""
removeChildAt(index) -> self
Removes the child, specified by index, reparenting it under the world.
"""
pass
@property
def renderPanZoom(self, *args, **kwargs):
"""
The toggle value for the camera render 2D pan/zoom attribute.
If this attribute is False, the 2D pan/zoom values will not affect the output render.
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def rightDirection(self, *args, **kwargs):
"""
rightDirection(space=kObject) -> MVector
Returns the right direction vector for the camera.
* space (int) - Specifies the coordinate system for this operation
"""
pass
def set(self, *args, **kwargs):
"""
set(wsEyeLocation, wsViewDirection, wsUpDirection, horizFieldOfView, aspectRatio) -> self
Convenience routine to set the camera viewing parameters. The specified values should be in world space where applicable.
This method will only work when the world space information for the camera is available, i.e. when the function set has been initialized with a DAG path.
* wsEyeLocation (MPoint) - Eye location to set in world space
* wsViewDirection (MVector) - View direction to set in world space
* wsUpDirection (MVector) - Up direction to set in world space
* horizFieldOfView (float) - The horizontal field of view to set
* aspectRatio (float) - The aspect ratio to set
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setAspectRatio(self, *args, **kwargs):
"""
setAspectRatio(aspectRatio) -> self
Set the aspect ratio of the View. The aspect ratio is expressed as width/height. This also modifies the entitys scale transformation to reflect the new aspect ratio.
* aspectRatio (float) - The aspect ratio to be set
"""
pass
def setCenterOfInterestPoint(self, *args, **kwargs):
"""
setCenterOfInterestPoint(centerOfInterest, space=kObject) -> self
Positions the center-of-interest of the camera keeping the eye-point fixed in space. This method changed the orientation and translation of the cameras transform attributes as well as the center-of-interest distance.
This method will only work when the world space information for the camera is available, i.e. when the function set has been initialized with a DAG path.
* centerOfInterest (MPoint) - Center of interest point to be set
* space (int) - Specifies the coordinate system for this operation
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setEyePoint(self, *args, **kwargs):
"""
setEyePoint(eyeLocation, space=kObject) -> self
Positions the eye-point of the camera keeping the center of interest fixed in space. This method changed the orientation and translation of the cameras transform attributes as well as the center-of-interest distance.
This method will only work when the world space information for the camera is available, i.e. when the function set has been initialized with a DAG path.
* eyeLocation (MPoint) - The eye location to set
* space (int) - Specifies the coordinate system for this operation
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setHorizontalFieldOfView(self, *args, **kwargs):
"""
setHorizontalFieldOfView(fov) -> self
Sets the horizontal field of view for the camera.
* fov (float) - The horizontal field of view value to be set
"""
pass
def setIsOrtho(self, *args, **kwargs):
"""
setIsOrtho(orthoState, useDist=None) -> self
Switch the camera in and out of orthographic mode. When the switch happens, the camera has to calculate a new fov or ortho width, each of which is based on the other and a set distance. The caller can specify the distance; otherwise the center of interest is used.
* orthoState (bool) - If True then the camera will be orthographic
* useDist (float) - distance to use.
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setNearFarClippingPlanes(self, *args, **kwargs):
"""
setNearFarClippingPlanes(near, far) -> self
Set the distances to the Near and Far Clipping Planes.
* near (float) - The near clipping plane value to be set
* far (float) - The far clipping plane value to be set
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(MObject or MDagPath) -> self
Attaches the function set to the specified node or DAG path.
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def setVerticalFieldOfView(self, *args, **kwargs):
"""
setVerticalFieldOfView(fov) -> self
Sets the vertical field of view for the camera.
* fov (float) - The vertical field of view value to be set
"""
pass
@property
def shakeEnabled(self, *args, **kwargs):
"""
The toggle value for the camera shake enabled attribute.
If this attribute is False, the horizontalShake and verticalShake values are ignored by the camera.
"""
pass
@property
def shakeOverscan(self, *args, **kwargs):
"""
The camera shake overscan value. Unit is a multiplier to the film aperture.
"""
pass
@property
def shakeOverscanEnabled(self, *args, **kwargs):
"""
The toggle value for the camera shake overscan attribute.
If this attribute is False, the shakeOverscan value is ignored by the camera.
"""
pass
@property
def shutterAngle(self, *args, **kwargs):
"""
The shutter angle which is one of the variables used to compute motion blur. The shutter angle is specified in radians.
"""
pass
@property
def stereoHIT(self, *args, **kwargs):
"""
The camera stereo horizontal image translation (stereo HIT) value. Unit is inches.
"""
pass
@property
def stereoHITEnabled(self, *args, **kwargs):
"""
The toggle value for the stereo HIT enabled attribute.
If this attribute is False, the stereoHIT value is ignored by the camera.
"""
pass
def transformationMatrix(self, *args, **kwargs):
"""
transformationMatrix() -> MMatrix
Returns the object space transformation matrix for this DAG node.
"""
pass
@property
def tumblePivot(self, *args, **kwargs):
"""
The tumble pivot value for the camera. The pivot value will be in world space coordinates unless usePivotAsLocalSpace is True in which case the pivot is a relative offset.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
def upDirection(self, *args, **kwargs):
"""
upDirection(space=kObject) -> MVector
Returns the up direction vector for the camera.
* space (int) - Specifies the coordinate system for this operation
"""
pass
@property
def useObjectColor(self, *args, **kwargs):
"""
If True then the node will be drawn using its objectColor, otherwise it will be drawn using Mayas default color. Thismethod is deprecated, use objectColorType instead.
"""
pass
@property
def usePivotAsLocalSpace(self, *args, **kwargs):
"""
The local axis tumble setting for this camera.True if using local space tumbling for this camera, or False if using the current global tumble setting in Maya.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
def verticalFieldOfView(self, *args, **kwargs):
"""
verticalFieldOfView() -> float
Returns the vertical field of view for the camera.
"""
pass
@property
def verticalFilmAperture(self, *args, **kwargs):
"""
The vertical film aperture for the camera.
"""
pass
@property
def verticalFilmOffset(self, *args, **kwargs):
"""
The vertical offset of the film. Unit used is inches.
"""
pass
@property
def verticalPan(self, *args, **kwargs):
"""
The camera 2D vertical pan value. Unit is inches.
"""
pass
@property
def verticalRollPivot(self, *args, **kwargs):
"""
The vertical roll pivot for film back roll.
"""
pass
@property
def verticalShake(self, *args, **kwargs):
"""
The vertical film-based camera shake value. Unit used is inches.
"""
pass
def viewDirection(self, *args, **kwargs):
"""
viewDirection(space=kObject) -> MVector
Returns the view direction for the camera
* space (int) - Specifies the coordinate system for this operation
"""
pass
@property
def zoom(self, *args, **kwargs):
"""
The camera 2D zoom value, which is the percent over the film viewable frustum to display
"""
pass
class MFnComponent(MFnBase):
"""
This is the base class for all function sets which deal with
component objects.
__init__()
Initializes a new, empty MFnComponent object
__init__(MObject component)
Initializes a new MFnComponent function set, attached to the specified component.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
@property
def componentType(self, *args, **kwargs):
"""
Type of the component. (MFn Type constant)
"""
pass
@property
def elementCount(self, *args, **kwargs):
"""
Number of elements in the component.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hasWeights(self, *args, **kwargs):
"""
True if the component has weights associated with its elements.
"""
pass
@property
def isComplete(self, *args, **kwargs):
"""
Marking a component as complete means that it represents a full set
of indices from 0 to elementCount-1
"""
pass
@property
def isEmpty(self, *args, **kwargs):
"""
True if the component contains no elements.
"""
pass
def isEqual(self, *args, **kwargs):
"""
isEqual(MObject other) -> bool
Returns True if other refers to the same component as the
one to which the function set is currently attached.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def weight(self, *args, **kwargs):
"""
weight(index) -> MWeight
Returns the weight associated with the specified element,
where index can range from 0 to elementCount-1.
"""
pass
class MFnComponentListData(MFnData):
"""
MFnComponentListData allows the creation and manipulation of component list
(represented as MObjects) data objects for use in the dependency graph.
__init__()
Initializes a new, empty MFnComponentListData object.
__init__(MObject)
Initializes a new MFnComponentListData function set, attached
to the specified object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def add(self, *args, **kwargs):
"""
add(MObject) -> self
Adds the specified component to the end of the list.
"""
pass
def clear(self, *args, **kwargs):
"""
clear() -> self
Removes all of the components from the list.
"""
pass
def create(self, *args, **kwargs):
"""
create() -> MObject
Creates a new, empty component list, attaches it to the
function set and returns an MObject which references it.
"""
pass
def get(self, *args, **kwargs):
"""
get(index) -> MObject
Returns a copy of the component at the specified index.
Raises IndexError if the index is out of range.
"""
pass
def has(self, *args, **kwargs):
"""
has(MObject) -> bool
Returns True if the list contains the specified
component, False otherwise.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def length(self, *args, **kwargs):
"""
length() -> int
Returns the number of components in the list.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def remove(self, *args, **kwargs):
"""
remove(MObject) -> self
remove(index) -> self
Removes the specified component from the list.
No exception is raised if the component is not in the list,
raises IndexError if index is out of range
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnCompoundAttribute(MFnAttribute):
"""
Functionset for creating and working with compound attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addChild(self, *args, **kwargs):
"""
Add a child attribute.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
def child(self, *args, **kwargs):
"""
Returns one of the attributes children, specified by index.
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new compound attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def getAddAttrCmds(self, *args, **kwargs):
"""
Returns a list of MEL addAttr commands capable of recreating the attribute and all of its children.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def numChildren(self, *args, **kwargs):
"""
Returns number of child attributes currently parented under the compound attribute.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
def removeChild(self, *args, **kwargs):
"""
Remove a child attribute.
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnDagNode(MFnDependencyNode):
"""
Function set for operating on DAG nodes.
__init__()
Initializes a new, empty MFnDagNode functionset.
__init__(MObject)
Initializes a new MFnDagNode functionset and attaches it to a
DAG node.
__init__(MDagPath)
Initializes a new MFnDagNode functionset and attaches it to a
DAG path.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addChild(self, *args, **kwargs):
"""
addChild(node, index=kNextPos, keepExistingParents=False) -> self
Makes a node a child of this one.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
@property
def boundingBox(self, *args, **kwargs):
"""
Nodes bounding box, in object space.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
def child(self, *args, **kwargs):
"""
child(index) -> MObject
Returns the specified child of this node.
"""
pass
def childCount(self, *args, **kwargs):
"""
childCount() -> int
Returns the number of nodes which are children of this one.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def create(self, *args, **kwargs):
"""
create(type, name=None, parent=MObject.kNullObj) -> MObject
Creates a new DAG node of the specified type, with the given name.
The type may be either a type name or a type ID. If no name is given
then a unique name will be generated by combining the type name with
an integer.
If a parent is given then the new node will be parented under it and
the functionset will be attached to the newly-created node. The
newly-created node will be returned.
If no parent is given and the new node is a transform, it will be
parented under the world and the functionset will be attached to the
newly-created transform. The newly-created transform will be returned.
If no parent is given and the new node is not a transform then a
transform node will be created under the world, the new node will be
parented under it, and the functionset will be attached to the
transform. The transform will be returned.
"""
pass
def dagPath(self, *args, **kwargs):
"""
dagPath() -> MDagPath
Returns the DAG path to which this function set is attached. Raises a TypeError if the function set is attached to an MObject rather than a path.
"""
pass
def dagRoot(self, *args, **kwargs):
"""
dagRoot() -> MObject
Returns the root node of the first path leading to this node.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
def duplicate(self, *args, **kwargs):
"""
duplicate(instance=False, instanceLeaf=False) -> MObject
Duplicates the DAG hierarchy rooted at the current node.
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
def fullPathName(self, *args, **kwargs):
"""
fullPathName() -> string
Returns the full path of the attached object, from the root of the DAG on down.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getAllPaths(self, *args, **kwargs):
"""
getAllPaths() -> MDagPathArray
Returns all of the DAG paths which lead to the object to which this function set is attached.
"""
pass
def getConnectedSetsAndMembers(self, *args, **kwargs):
"""
getConnectedSetsAndMembers(instance, renderableSetsOnly) -> (MObjectArray, MObjectArray)
Returns a tuple containing an array of sets and an array of the
components of the DAG object which are in those sets. If the entire object is in a set, then the corresponding entry in the comps array will have no elements in it.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def getPath(self, *args, **kwargs):
"""
getPath() -> MDagPath
Returns the DAG path to which this function set is attached, or the first path to the node if the function set is attached to an MObject.
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasChild(self, *args, **kwargs):
"""
hasChild(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasParent(self, *args, **kwargs):
"""
hasParent(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
@property
def inModel(self, *args, **kwargs):
"""
True if the node has been added to the model.
"""
pass
@property
def inUnderWorld(self, *args, **kwargs):
"""
True if this node is in the underworld of another node (e.g. a curve on surface is in the underworld of the surface).
"""
pass
def instanceCount(self, *args, **kwargs):
"""
instanceCount(indirect) -> int
Returns the number of instances for this node.
"""
pass
def isChildOf(self, *args, **kwargs):
"""
isChildOf(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isInstanceable(self, *args, **kwargs):
"""
True if instancing is allowed for this node.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
isInstanced(indirect=True) -> bool
Returns True if this node is instanced.
"""
pass
def isInstancedAttribute(self, *args, **kwargs):
"""
isInstancedAttribute(attr) -> bool
Returns True if the specified attribute is an instanced attribute of this node.
"""
pass
@property
def isIntermediateObject(self, *args, **kwargs):
"""
True if this node is just an intermediate in part of a larger calculation (e.g. input to a deformer).
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
def isParentOf(self, *args, **kwargs):
"""
isParentOf(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
kExtensionAttr = 3
kInvalidAttr = 4
kLocalDynamicAttr = 1
kNextPos = 255
kNormalAttr = 2
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def objectColor(self, *args, **kwargs):
"""
Index from 0 to 7 indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorRGB(self, *args, **kwargs):
"""
RGB value indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorType(self, *args, **kwargs):
"""
Determines whether the default color, indexed object color, orRGB object color is used for this object.
"""
pass
def parent(self, *args, **kwargs):
"""
parent(index) -> MObject
Returns the specified parent of this node.
"""
pass
def parentCount(self, *args, **kwargs):
"""
parentCount() -> int
Returns the number of parents this node has.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
partialPathName() -> string
Returns the minimum path string necessary to uniquely identify the attached object.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def removeChild(self, *args, **kwargs):
"""
removeChild(node) -> self
Removes the child, specified by MObject, reparenting it under the world.
"""
pass
def removeChildAt(self, *args, **kwargs):
"""
removeChildAt(index) -> self
Removes the child, specified by index, reparenting it under the world.
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(MObject or MDagPath) -> self
Attaches the function set to the specified node or DAG path.
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def transformationMatrix(self, *args, **kwargs):
"""
transformationMatrix() -> MMatrix
Returns the object space transformation matrix for this DAG node.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
@property
def useObjectColor(self, *args, **kwargs):
"""
If True then the node will be drawn using its objectColor, otherwise it will be drawn using Mayas default color. Thismethod is deprecated, use objectColorType instead.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
class MFnData(MFnBase):
"""
Base class for dependency graph data function sets.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnDependencyNode(MFnBase):
"""
Function set for operating on dependency nodes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new node of the given type.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
kExtensionAttr = 3
kInvalidAttr = 4
kLocalDynamicAttr = 1
kNormalAttr = 2
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
class MFnDoubleArrayData(MFnData):
"""
Function set for node data consisting of an array of doubles.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as an MDoubleArray.
"""
pass
def copyTo(self, *args, **kwargs):
"""
Replaces the elements of an array with those in the encapsulated array.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new double array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnDoubleIndexedComponent(MFnComponent):
"""
This function set allows you to create, edit, and query double indexed
components. Double indexed components store 2 dimensional index values.
__init__()
Initializes a new, empty MFnDoubleIndexedComponent object
__init__(MObject component)
Initializes a new MFnDoubleIndexedComponent function set, attached
to the specified component.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addElement(self, *args, **kwargs):
"""
addElement(uIndex, vIndex) -> self
addElement([uIndex, vIndex]) -> self
Adds the element identified by (uIndex, vIndex) to the component.
"""
pass
def addElements(self, *args, **kwargs):
"""
addElements(sequence of [uIndex, vIndex]) -> self
Adds the specified elements to the component. Each item in the
elements sequence is itself a sequence of two ints which are the U and
V indices of an element to be added.
"""
pass
@property
def componentType(self, *args, **kwargs):
"""
Type of the component. (MFn Type constant)
"""
pass
def create(self, *args, **kwargs):
"""
create(MFn Type constant) -> MObject
Creates a new, empty component, attaches it to the function set and
returns an MObject which references it.
"""
pass
@property
def elementCount(self, *args, **kwargs):
"""
Number of elements in the component.
"""
pass
def getCompleteData(self, *args, **kwargs):
"""
getCompleteData() -> (numU, numV)
Returns a tuple containing the number of U and V indices in the complete
component, or (0,0) if the component is not complete.
"""
pass
def getElement(self, *args, **kwargs):
"""
getElement(index) -> (uIndex, vIndex)
Returns the indexth element of the component as a tuple containing the
elements U and V indices.
"""
pass
def getElements(self, *args, **kwargs):
"""
getElements() -> list of (uIndex, vIndex)
Returns all of the components elements as a list of tuples with each
tuple containing the U and V indices of a single element.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hasWeights(self, *args, **kwargs):
"""
True if the component has weights associated with its elements.
"""
pass
@property
def isComplete(self, *args, **kwargs):
"""
Marking a component as complete means that it represents a full set
of indices from 0 to elementCount-1
"""
pass
@property
def isEmpty(self, *args, **kwargs):
"""
True if the component contains no elements.
"""
pass
def isEqual(self, *args, **kwargs):
"""
isEqual(MObject other) -> bool
Returns True if other refers to the same component as the
one to which the function set is currently attached.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setCompleteData(self, *args, **kwargs):
"""
setCompleteData(numU, numV) -> self
Marks the component as complete (i.e. contains all possible elements).
numU and numV indicate the number of U and V indices in the complete
component (i.e. the max U index is numU-1 and the max V index is numV-1).
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def weight(self, *args, **kwargs):
"""
weight(index) -> MWeight
Returns the weight associated with the specified element,
where index can range from 0 to elementCount-1.
"""
pass
class MFnEnumAttribute(MFnAttribute):
"""
Functionset for creating and working with enumeration attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addField(self, *args, **kwargs):
"""
Add an item to the enumeration with a specified UI name and corresponding attribute value.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new enumeration attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def default(self, *args, **kwargs):
"""
Default value
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def fieldName(self, *args, **kwargs):
"""
Returns the name of the enumeration item which has a given value.
"""
pass
def fieldValue(self, *args, **kwargs):
"""
Returns the value of the enumeration item which has a given name.
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def getMax(self, *args, **kwargs):
"""
Returns the maximum value of all the enumeration items.
"""
pass
def getMin(self, *args, **kwargs):
"""
Returns the minimum value of all the enumeration items.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setDefaultByName(self, *args, **kwargs):
"""
Set the default value using the name of an enumeration item. Equivalent to: attr.default = attr.fieldValue(name)
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnGenericAttribute(MFnAttribute):
"""
Functionset for creating and working with attributes which can accept several different types of data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addDataType(self, *args, **kwargs):
"""
Adds the specified Maya data type to the list of those accepted by the attribute.
"""
pass
def addNumericType(self, *args, **kwargs):
"""
Adds the specified numeric type to the list of those accepted by the attribute.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
def addTypeId(self, *args, **kwargs):
"""
Adds the specified data typeId to the list of those accepted by the attribute.
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new generic attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
def removeDataType(self, *args, **kwargs):
"""
Removes the specified Maya data type from the list of those accepted by the attribute.
"""
pass
def removeNumericType(self, *args, **kwargs):
"""
Removes the specified numeric type from the list of those accepted by the attribute.
"""
pass
def removeTypeId(self, *args, **kwargs):
"""
Removes the specified data typeId from the list of those accepted by the attribute.
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnGeometryData(MFnData):
"""
This class is the function set for geometry data.
Geometry data adds matrix and grouping (set) information to regular
data and is used to pass geometry types such as mesh, lattice, and
NURBS shape data through DG connections.
__init__()
Initializes a new, empty MFnGeometryData object
__init__(MObject)
Initializes a new MFnGeometryData function set, attached
to the specified object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addObjectGroup(self, *args, **kwargs):
"""
addObjectGroup(id) -> self
Adds an object group with the given id to the object.
"""
pass
def addObjectGroupComponent(self, *args, **kwargs):
"""
addObjectGroupComponent(id, MObject component) -> self
Adds the members of the given component to the object group
with the given id.
"""
pass
def changeObjectGroupId(self, *args, **kwargs):
"""
changeObjectGroupId(sourceId, destId) -> self
Changes the id of the object group with the given id to the new id.
"""
pass
def copyObjectGroups(self, *args, **kwargs):
"""
copyObjectGroups(MObject inGeom) -> self
Copies the object groups from the given geometry data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasObjectGroup(self, *args, **kwargs):
"""
hasObjectGroup(id) -> self
Returns True if an object group with the given id is
contained in the data.
"""
pass
@property
def isIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is the identity.
"""
pass
@property
def isNotIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is not the identity.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
@property
def matrix(self, *args, **kwargs):
"""
MMatrix used to convert the object into local space.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def objectGroup(self, *args, **kwargs):
"""
objectGroup(index) -> int
Returns the id of the indexth object group contained by the object.
"""
pass
def objectGroupComponent(self, *args, **kwargs):
"""
objectGroupComponent(id) -> MObject
Returns a component which contains the members of the object group
with the given id.
"""
pass
@property
def objectGroupCount(self, *args, **kwargs):
"""
The number of object groups contained by the object.
"""
pass
def objectGroupType(self, *args, **kwargs):
"""
objectGroupType(id) -> MFn Type constant
Returns the type of the component that the object group with the
given id contains.
"""
pass
def removeObjectGroup(self, *args, **kwargs):
"""
removeObjectGroup(id) -> self
Removes an object group with the given id from the object.
"""
pass
def removeObjectGroupComponent(self, *args, **kwargs):
"""
removeObjectGroupComponent(id, MObject component) -> self
Removes the members of the given component from the object group
with the given id.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setObjectGroupComponent(self, *args, **kwargs):
"""
setObjectGroupComponent(id, MObject component) -> self
Sets the members of the object group with the given id
to be only those in the given component.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnIntArrayData(MFnData):
"""
Function set for node data consisting of an array of ints.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as an MIntArray.
"""
pass
def copyTo(self, *args, **kwargs):
"""
Replaces the elements of an array with those in the encapsulated array.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new int array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnLightDataAttribute(MFnAttribute):
"""
Functionset for creating and working with light data attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
def child(self, *args, **kwargs):
"""
Returns one of the attributes children, specified by index.
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new light data attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def default(self, *args, **kwargs):
"""
Default values for the light data attributes child attributes.
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnMatrixArrayData(MFnData):
"""
Function set for node data consisting of an array of MMatrix.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as an MMatrixArray.
"""
pass
def copyTo(self, *args, **kwargs):
"""
Replaces the elements of an array with those in the encapsulated array.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new MMatrix array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnMatrixAttribute(MFnAttribute):
"""
Functionset for creating and working with matrix attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new matrix attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def default(self, *args, **kwargs):
"""
Default value
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kDouble = 1
kFloat = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnMatrixData(MFnData):
"""
Function set for matrix node data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new matrix data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def isTransformation(self, *args, **kwargs):
"""
Returns True if the attached object is an MTransformationMatrix, False if it is an MMatrix.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def matrix(self, *args, **kwargs):
"""
Returns the encapsulated matrix as an MMatrix.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets the value of the encapsulated matrix.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def transformation(self, *args, **kwargs):
"""
Returns the encapsulated matrix as an MTransformationMatrix.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnMesh(MFnDagNode):
"""
Function set for operation on meshes (polygonal surfaces).
__init__()
Initializes a new, empty MFnMesh object.
__init__(MDagPath path)
Initializes a new MFnMesh object and attaches it to the DAG path
of a mesh node.
__init__(MObject nodeOrData)
Initializes a new MFnMesh object and attaches it to a mesh
node or mesh data object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addChild(self, *args, **kwargs):
"""
addChild(node, index=kNextPos, keepExistingParents=False) -> self
Makes a node a child of this one.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def addHoles(self, *args, **kwargs):
"""
addHoles(faceIndex, vertices, loopCounts, mergeVertices=True, pointTolerance=kPointTolerance) -> self
Adds holes to a mesh polygon.
loopCounts is an array of vertex counts.
The first entry gives the count of vertices that make up the
first hole to add to the polygon (using that many entries in vertexArray). The following
entries in loopCounts give the count of vertices that make up each remaining hole,
using the following entries in vertexArray.
Therefore the sum of the entries of loopCounts should equal the total
length of vertexArray.
Note that holes should normally be specified with the opposite winding order
to the exterior polygon.
"""
pass
def addPolygon(self, *args, **kwargs):
"""
addPolygon(vertices, mergeVertices=True, pointTolerance=kPointTolerance, loopCounts=None) -> faceId
Adds a new polygon to the mesh, returning the index of the new
polygon. If mergeVertices is True and a new vertex is within
pointTolerance of an existing one, then they are merged by reusing
the existing vertex and discarding the new one.
loopCounts allows for polygons with holes. If supplied, it is an array of integer vertex
counts. The first entry gives the count of vertices that make up the
exterior of the polygon (using that many entries in vertexArray). The following
entries in loopCounts give the count of vertices that make up each hole,
using the following entries in vertexArray.
Therefore the sum of the entries of loopCounts should equal the total
length of vertexArray.
Note that holes should normally be specified with the opposite winding order
to the exterior polygon.
"""
pass
def allIntersections(self, *args, **kwargs):
"""
allIntersections(raySource, rayDirection, space, maxParam,
testBothDirections, faceIds=None, triIds=None, idsSorted=False,
accelParams=None, tolerance=kIntersectTolerance, sortHits=False)
-> (hitPoints, hitRayParams, hitFaces, hitTriangles, hitBary1s, hitBary2s)
Finds all intersection of a ray starting at raySource and travelling
in rayDirection with the mesh.
If faceIds is specified, then only those faces will be considered
for intersection. If both faceIds and triIds are given, then the
triIds will be interpreted as face-relative and each pair of entries
will be taken as a (face, triangle) pair to be considered for
intersection. Thus, the face-triangle pair (10, 0) means the first
triangle on face 10. If neither faceIds nor triIds is given, then
all face-triangles in the mesh will be considered.
The maxParam and testBothDirections flags can be used to control the
radius of the search around the raySource point.
The search proceeds by testing all applicable face-triangles looking
for intersections. If the accelParams parameter is given then the
mesh builds an intersection acceleration structure based on it. This
acceleration structure is used to speed up the intersection
operation, sometimes by a factor of several hundred over the non-
accelerated case. Once created, the acceleration structure is cached
and will be reused the next time this method (or anyIntersection()
or allIntersections()) is called with an identically-configured
MMeshIsectAccelParams object. If a different MMeshIsectAccelParams
object is used, then the acceleration structure will be deleted and
re-created according to the new settings. Once created, the
acceleration structure will persist until either the object is
destroyed (or rebuilt by a construction history operation), or the
freeCachedIntersectionAccelerator() method is called. The
cachedIntersectionAcceleratorInfo() and
globalIntersectionAcceleratorsInfo() methods provide useful
information about the resource usage of individual acceleration
structures, and of all such structures in the system.
If the ray hits the mesh, the details of the intersection points
will be returned as a tuple containing the following:
* hitPoints (MFloatPointArray) - coordinates of the points hit, in
the space specified by the caller.* hitRayParams (MFloatArray) - parametric distances along the ray to
the points hit.* hitFaces (MIntArray) - IDs of the faces hit
* hitTriangles (MIntArray) - face-relative IDs of the triangles hit
* hitBary1s (MFloatArray) - first barycentric coordinate of the
points hit. If the vertices of the hitTriangle are (v1, v2, v3)
then the barycentric coordinates are such that the hitPoint =
(*hitBary1)*v1 + (*hitBary2)*v2 + (1-*hitBary1-*hitBary2)*v3.* hitBary2s (MFloatArray) - second barycentric coordinate of the
points hit.
If no point was hit then the arrays will all be empty.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def anyIntersection(self, *args, **kwargs):
"""
anyIntersection(raySource, rayDirection, space, maxParam,
testBothDirections, faceIds=None, triIds=None, idsSorted=False,
accelParams=None, tolerance=kIntersectTolerance)
-> (hitPoint, hitRayParam, hitFace, hitTriangle, hitBary1, hitBary2)
Finds any intersection of a ray starting at raySource and travelling
in rayDirection with the mesh.
If faceIds is specified, then only those faces will be considered
for intersection. If both faceIds and triIds are given, then the
triIds will be interpreted as face-relative and each pair of entries
will be taken as a (face, triangle) pair to be considered for
intersection. Thus, the face-triangle pair (10, 0) means the first
triangle on face 10. If neither faceIds nor triIds is given, then
all face-triangles in the mesh will be considered.
The maxParam and testBothDirections flags can be used to control the
radius of the search around the raySource point.
The search proceeds by testing all applicable face-triangles looking
for intersections. If the accelParams parameter is given then the
mesh builds an intersection acceleration structure based on it. This
acceleration structure is used to speed up the intersection
operation, sometimes by a factor of several hundred over the non-
accelerated case. Once created, the acceleration structure is cached
and will be reused the next time this method (or anyIntersection()
or allIntersections()) is called with an identically-configured
MMeshIsectAccelParams object. If a different MMeshIsectAccelParams
object is used, then the acceleration structure will be deleted and
re-created according to the new settings. Once created, the
acceleration structure will persist until either the object is
destroyed (or rebuilt by a construction history operation), or the
freeCachedIntersectionAccelerator() method is called. The
cachedIntersectionAcceleratorInfo() and
globalIntersectionAcceleratorsInfo() methods provide useful
information about the resource usage of individual acceleration
structures, and of all such structures in the system.
If the ray hits the mesh, the details of the intersection point
will be returned as a tuple containing the following:
* hitPoint (MFloatPoint) - coordinates of the point hit, in
the space specified by the caller.* hitRayParam (float) - parametric distance along the ray to
the point hit.* hitFace (int) - ID of the face hit
* hitTriangle (int) - face-relative ID of the triangle hit
* hitBary1 (float) - first barycentric coordinate of the
point hit. If the vertices of the hitTriangle are (v1, v2, v3)
then the barycentric coordinates are such that the hitPoint =
(*hitBary1)*v1 + (*hitBary2)*v2 + (1-*hitBary1-*hitBary2)*v3.* hitBary2 (float) - second barycentric coordinate of the point hit.
If no point was hit then the arrays will all be empty.
"""
pass
def assignColor(self, *args, **kwargs):
"""
assignColor(faceId, vertexIndex, colorId, colorSet=) -> self
Assigns a color from a colorSet to a specified vertex of a face.
"""
pass
def assignColors(self, *args, **kwargs):
"""
assignColors(colorIds, colorSet=) -> self
Assigns colors to all of the meshs face-vertices. The colorIds
sequence must contain an entry for every vertex of every face, in
face order, meaning that the entries for all the vertices of face 0
come first, followed by the entries for the vertices of face 1, etc.
"""
pass
def assignUV(self, *args, **kwargs):
"""
assignUV(faceId, vertexIndex, uvId, uvSet=) -> self
Assigns a UV coordinate from a uvSet to a specified vertex of a face.
"""
pass
def assignUVs(self, *args, **kwargs):
"""
assignUVs(uvCounts, uvIds, uvSet=) -> self
Assigns UV coordinates to the meshs face-vertices.
uvCounts contains the number of UVs to assign for each of the meshs
faces. That number must equal the number of vertices in the
corresponding face or be 0 to indicate that no UVs will be assigned
to that face.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
def autoUniformGridParams(self, *args, **kwargs):
"""
autoUniformGridParams() -> MMeshIsectAccelParams
Creates an object which specifies a uniform voxel grid structure
which can be used by the intersection routines to speed up their
operation. The number of voxel cells to use will be determined
automatically based on the density of triangles in the mesh. The
grid acceleration structure will be cached with the mesh, so that
if the same MMeshIsectAccelParams configuration is used on the next
intersect call, the acceleration structure will not need to be rebuilt.
"""
pass
def booleanOp(self, *args, **kwargs):
"""
booleanOp(Boolean Operation constant, MFnMesh, MFnMesh) -> self
Replaces this meshs geometry with the result of a boolean operation
on the two specified meshes.
"""
pass
def booleanOps(self, *args, **kwargs):
"""
booleanOps(Boolean Operation constant, MObjectArray, bool) -> self
Replaces this meshs geometry with the result of a boolean operation
on the specified meshes.
"""
pass
@property
def boundingBox(self, *args, **kwargs):
"""
Nodes bounding box, in object space.
"""
pass
def cachedIntersectionAcceleratorInfo(self, *args, **kwargs):
"""
cachedIntersectionAcceleratorInfo() -> string
Retrieves a string that describes the intersection acceleration
structure for this object, if any. The string will be of the
following form:
10x10x10 uniform grid, (build time 0.5s), (memory footprint 2000KB)
It describes the configuration of the cached intersection
accelerator, as well as how long it took to build it, and how much
memory it is currently occupying. If the mesh has no cached
intersection accelerator, the empty string is returned.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
@property
def checkSamePointTwice(self, *args, **kwargs):
"""
Controls whether polygons created or added through the functionset
are checked for duplicate points.
"""
pass
def child(self, *args, **kwargs):
"""
child(index) -> MObject
Returns the specified child of this node.
"""
pass
def childCount(self, *args, **kwargs):
"""
childCount() -> int
Returns the number of nodes which are children of this one.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def cleanupEdgeSmoothing(self, *args, **kwargs):
"""
cleanupEdgeSmoothing() -> self
Updates the mesh after setEdgeSmoothing has been done. This should
be called only once, after all the desired edges have been had their
smoothing set. If you dont call this method, the normals may not be
correct, and the object will look odd in shaded mode.
"""
pass
def clearBlindData(self, *args, **kwargs):
"""
clearBlindData(compType) -> self
clearBlindData(compType, blindDataId, compId=None, attr=) -> self
The first version deletes all blind data from all the meshs
components of the given type (an MFn Type constant).
The second version deletes values of the specified blind data type
from the meshs components of a given type. If a component ID is
provided then the data is only deleted from that component,
otherwise it is deleted from all of the meshs components of the
specified type. If a blind data attribute name is provided then only
data for that attribute is deleted, otherwise data for all of the
blind data types attributes is deleted.
"""
pass
def clearColors(self, *args, **kwargs):
"""
clearColors(colorSet=) -> self
Clears out all colors from a colorSet, and leaves behind an empty
colorset. This method should be used if it is needed to shrink the
actual size of the color set. In this case, the user should call
clearColors(), setColors() and then assignColors() to rebuild the
mapping info.
When called on mesh data, the colors are removed. When called on a
shape with no history, the colors are removed and the attributes are
set on the shape. When called on a shape with history, the
polyColorDel command is invoked and a polyColorDel node is created.
If no colorSet is specified the meshs current color set will be used.
"""
pass
def clearGlobalIntersectionAcceleratorInfo(self, *args, **kwargs):
"""
clearGlobalIntersectionAcceleratorInfo()
Clears the total count, total build time, and peak memory
fields from the information string returned by
globalIntersectionAcceleratorsInfo(). It will not cause information
about currently existing accelerators to be lost.
"""
pass
def clearUVs(self, *args, **kwargs):
"""
clearUVs(uvSet=) -> self
Clears out all uvs from a uvSet, and leaves behind an empty
uvset. This method should be used if it is needed to shrink the
actual size of the uv set. In this case, the user should call
clearUVs(), setUVs() and then assignUVs() to rebuild the
mapping info.
When called on mesh data, the uvs are removed. When called on a
shape with no history, the uvs are removed and the attributes are
set on the shape. When called on a shape with history, the
polyMapDel command is invoked and a polyMapDel node is created.
If no uvSet is specified the meshs current uv set will be used.
"""
pass
def closestIntersection(self, *args, **kwargs):
"""
closestIntersection(raySource, rayDirection, space, maxParam,
testBothDirections, faceIds=None, triIds=None, idsSorted=False,
accelParams=None, tolerance=kIntersectTolerance)
-> (hitPoint, hitRayParam, hitFace, hitTriangle, hitBary1, hitBary2)
Finds the closest intersection of a ray starting at raySource and
travelling in rayDirection with the mesh.
If faceIds is specified, then only those faces will be considered
for intersection. If both faceIds and triIds are given, then the
triIds will be interpreted as face-relative and each pair of entries
will be taken as a (face, triangle) pair to be considered for
intersection. Thus, the face-triangle pair (10, 0) means the first
triangle on face 10. If neither faceIds nor triIds is given, then
all face-triangles in the mesh will be considered.
The maxParam and testBothDirections flags can be used to control the
radius of the search around the raySource point.
The search proceeds by testing all applicable face-triangles looking
for intersections. If the accelParams parameter is given then the
mesh builds an intersection acceleration structure based on it. This
acceleration structure is used to speed up the intersection
operation, sometimes by a factor of several hundred over the non-
accelerated case. Once created, the acceleration structure is cached
and will be reused the next time this method (or anyIntersection()
or allIntersections()) is called with an identically-configured
MMeshIsectAccelParams object. If a different MMeshIsectAccelParams
object is used, then the acceleration structure will be deleted and
re-created according to the new settings. Once created, the
acceleration structure will persist until either the object is
destroyed (or rebuilt by a construction history operation), or the
freeCachedIntersectionAccelerator() method is called. The
cachedIntersectionAcceleratorInfo() and
globalIntersectionAcceleratorsInfo() methods provide useful
information about the resource usage of individual acceleration
structures, and of all such structures in the system.
If the ray hits the mesh, the details of the intersection point
will be returned as a tuple containing the following:
* hitPoint (MFloatPoint) - coordinates of the point hit, in
the space specified by the caller.* hitRayParam (float) - parametric distance along the ray to
the point hit.* hitFace (int) - ID of the face hit
* hitTriangle (int) - face-relative ID of the triangle hit
* hitBary1 (float) - first barycentric coordinate of the
point hit. If the vertices of the hitTriangle are (v1, v2, v3)
then the barycentric coordinates are such that the hitPoint =
(*hitBary1)*v1 + (*hitBary2)*v2 + (1-*hitBary1-*hitBary2)*v3.* hitBary2 (float) - second barycentric coordinate of the point hit.
If no point was hit then the arrays will all be empty.
"""
pass
def collapseEdges(self, *args, **kwargs):
"""
collapseEdges(seq of int) -> self
Collapses edges into vertices. The two vertices that create each
given edge are replaced in turn by one vertex placed at the average
of the two initial vertex.
"""
pass
def collapseFaces(self, *args, **kwargs):
"""
collapseFaces(seq of int) -> self
Collapses faces into vertices. Adjacent faces will be collapsed
together into a single vertex. Non-adjacent faces will be collapsed
into their own, separate vertices.
"""
pass
def copy(self, *args, **kwargs):
"""
copy(MObject, parent=kNullObj) -> MObject
Creates a new mesh with the same geometry as the source. Raises
TypeError if the source is not a mesh node or mesh data object or it
contains an empty mesh.
If the parent is a kMeshData wrapper (e.g. from MFnMeshData.create())
then a mesh data object will be created and returned and the wrapper
will be set to reference it.
If the parent is a transform type node then a mesh node will be
created and parented beneath it and the return value will be the
mesh node.
If the parent is any other type of node a TypeError will be raised.
If no parent is provided then a transform node will be created and
returned and a mesh node will be created and parented under the
transform.
"""
pass
def copyInPlace(self, *args, **kwargs):
"""
copyInPlace(MObject) -> self
Replaces the current meshs geometry with that from the source.
Raises TypeError if the source is not a mesh node or mesh data
object or it contains an empty mesh.
"""
pass
def copyUVSet(self, *args, **kwargs):
"""
copyUVSet(fromName, toName, modifier=None) -> string
Copies the contents of one UV set into another.
If the source UV set does not exist, or if it has the same name as
the destination, then no copy will be made.
If the destination UV set exists then its contents will be replace
by a copy of the source UV set.
If the destination UV set does not exist then a new UV set will be
created and the source UV set will be copied into it. The name of
the UV set will be that provided with a number appended to the end
to ensure uniqueness.
The final name of the destination UV set will be returned.
This method is only valid for functionsets which are attached to
mesh nodes, not mesh data.
"""
pass
def create(self, *args, **kwargs):
"""
create(vertices, polygonCounts, polygonConnects, uValues=None, vValues=None, parent=kNullObj) -> MObject
Creates a new polygonal mesh and sets this function set to operate
on it. This method is meant to be as efficient as possible and thus
assumes that all the given data is topologically correct.
If UV values are supplied both parameters must be given and they
must contain the same number of values, otherwise IndexError will be
raised. Note that the UVs are simply stored in the mesh, not
assigned to any vertices. To assign them use assignUVs().
If the parent is a kMeshData wrapper (e.g. from MFnMeshData.create())
then a mesh data object will be created and returned and the wrapper
will be set to reference it.
If the parent is a transform type node then a mesh node will be
created and parented beneath it and the return value will be the
mesh node.
If the parent is any other type of node a TypeError will be raised.
If no parent is provided then a transform node will be created and
returned and a mesh node will be created and parented under the
transform.
"""
pass
def createBlindDataType(self, *args, **kwargs):
"""
createBlindDataType(blindDataId, ((longName, shortName, typeName), ...)) -> self
Create a new blind data type with the specified attributes.
Each element of the attrs sequence is a tuple containing the long
name, short name and type name of the attribute. Valid type names
are int, float, double, boolean, string or binary.
Raises RuntimeError if the blind data id is already in use or an
invalid format was specified.
"""
pass
def createColorSet(self, *args, **kwargs):
"""
createColorSet(name, clamped, rep=kRGBA, modifier=None, instances=None) -> string
Creates a new, empty color set for this mesh.
If no name is provided colorSet# will be used, where # is a number
that makes the name unique for this mesh. If a name is provided but
it conflicts with that of an existing color set then a number will
be appended to the proposed name to make it unique.
The return value is the final name used for the new color set.
This method will only work when the functionset is attached to a
mesh node, not mesh data.
"""
pass
def createInPlace(self, *args, **kwargs):
"""
createInPlace(vertices, polygonCounts, polygonConnects) -> self
Replaces the existing polygonal mesh with a new one. This method is
meant to be as efficient as possible and thus assumes that all the
given data is topologically correct.
The vertices may be given as a sequence of MFloatPoints or a
sequence of MPoints, but not a mix of the two.
"""
pass
def createUVSet(self, *args, **kwargs):
"""
createUVSet(name, modifier=None, instances=None) -> string
Creates a new, empty UV set for this mesh.
If a UV set with proposed name already exists then a number will be
appended to the proposed name to name it unique.
If the proposed name is empty then a name of the form uvSet# will be
used where # is a number chosen to ensure that the name is unique.
The name used for the UV set will be returned.
This method is only valid for functionsets which are attached to
mesh nodes, not mesh data.
"""
pass
def currentColorSetName(self, *args, **kwargs):
"""
currentColorSetName(instance=kInstanceUnspecified) -> string
Get the name of the current color set. The current color set is
the one used for color operations when no color set is explicitly
specified.
On instanced meshes, color sets may be applied on a per-instance
basis or may be shared across all instances. When the color sets are
per-instance, the concept of the current color set has two levels of
granularity. Namely, the current color set applies to one or more
instances, plus there are other color sets in the same color set
family that apply to different instances. The instance arguement is
used to indicate that if this is a per-instance color set, you are
interested in the name of the color set that applies to the
specified instance. When the index is not specified, the current
color set will be returned regardless of which instance it is for.
If there is no current color set, then an empty string will be
returned.
"""
pass
def currentUVSetName(self, *args, **kwargs):
"""
currentUVSetName(instance=kInstanceUnspecified) -> string
Get the name of the current uv set. The current uv set is
the one used for uv operations when no uv set is explicitly
specified.
On instanced meshes, uv sets may be applied on a per-instance
basis or may be shared across all instances. When the uv sets are
per-instance, the concept of the current uv set has two levels of
granularity. Namely, the current uv set applies to one or more
instances, plus there are other uv sets in the same uv set
family that apply to different instances. The instance arguement is
used to indicate that if this is a per-instance uv set, you are
interested in the name of the uv set that applies to the
specified instance. When the index is not specified, the current
uv set will be returned regardless of which instance it is for.
If there is no current uv set, then an empty string will be
returned.
"""
pass
def dagPath(self, *args, **kwargs):
"""
dagPath() -> MDagPath
Returns the DAG path to which this function set is attached. Raises a TypeError if the function set is attached to an MObject rather than a path.
"""
pass
def dagRoot(self, *args, **kwargs):
"""
dagRoot() -> MObject
Returns the root node of the first path leading to this node.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
def deleteColorSet(self, *args, **kwargs):
"""
deleteColorSet(colorSet, modifier=None, currentSelection=None) -> self
Deletes a color set from the mesh.
This method is only valid for functionsets which are attached to
mesh nodes, not mesh data.
"""
pass
def deleteEdge(self, *args, **kwargs):
"""
deleteEdge(edgeId, modifier=None) -> self
Deletes the specified edge.
"""
pass
def deleteFace(self, *args, **kwargs):
"""
deleteFace(faceId, modifier=None) -> self
Deletes the specified face.
"""
pass
def deleteUVSet(self, *args, **kwargs):
"""
deleteUVSet(uvSet, modifier=None, currentSelection=None) -> self
Deletes a uv set from the mesh.
This method is only valid for functionsets which are attached to
mesh nodes, not mesh data.
"""
pass
def deleteVertex(self, *args, **kwargs):
"""
deleteVertex(vertexId, modifier=None) -> self
Deletes the specified vertex.
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
@property
def displayColors(self, *args, **kwargs):
"""
Determines if the meshs colors are displayed. Attempting to turn
color display on when the functionset is attached to mesh data (as
opposed to a mesh node) will raise TypeError.
"""
pass
def duplicate(self, *args, **kwargs):
"""
duplicate(instance=False, instanceLeaf=False) -> MObject
Duplicates the DAG hierarchy rooted at the current node.
"""
pass
def duplicateFaces(self, *args, **kwargs):
"""
duplicateFaces(faces, translation=None) -> self
Duplicates a set of faces and detaches them from the rest of the
mesh. The resulting mesh will contain one more independant piece of
geometry.
"""
pass
def extractFaces(self, *args, **kwargs):
"""
extractFaces(faces, translation=None) -> self
Detaches a set of faces from the rest of the mesh. The resulting
mesh will contain one more independant piece of geometry.
"""
pass
def extrudeEdges(self, *args, **kwargs):
"""
extrudeEdges(edges, extrusionCount=1, translation=None, extrudeTogether=True, thickness=0.0, offset=0.0) -> self
Extrude the given edges along a vector. The resulting mesh will have
extra parallelograms coming out of the given edges and going to the
new extruded edges. The length of the new polygon is determined by
the length of the vector. The extrusionCount parameter is the number
of subsequent extrusions per edges and represents the number of
polygons that will be created from each given edge to the extruded
edges.
The difference between using thickness or offset instead of providing
a vector with the translation variable is that the translation will
be applied to each vertex in the extrusion along its local direction. This
can result in vertices being moved the same distance, but the angles between
the original components are not maintained so the overall shape is not the
same.
Both the thickness and offset variables will attempt to move the components
a distance that will maintain angles between edges at the border of the
extrusion.
"""
pass
def extrudeFaces(self, *args, **kwargs):
"""
extrudeFaces(faces, extrusionCount=1, translation=None, extrudeTogether=True, thickness=0.0, offset=0.0) -> self
Extrude the given faces along a vector. The resulting mesh will have
extra parallelograms coming out of the given faces and going to the
new extruded faces. The length of the new polygon is determined by
the length of the vector. The extrusionCount parameter is the number
of subsequent extrusions per faces and represents the number of
polygons that will be created from each given face to the extruded
faces.
The difference between using thickness or offset instead of providing
a vector with the translation variable is that the translation will
be applied to each vertex in the extrusion along its local direction. This
can result in vertices being moved the same distance, but the angles between
the original components are not maintained so the overall shape is not the
same.
Both the thickness and offset variables will attempt to move the components
a distance that will maintain angles between edges at the border of the
extrusion.
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
def freeCachedIntersectionAccelerator(self, *args, **kwargs):
"""
freeCachedIntersectionAccelerator() -> self
If the mesh has a cached intersection accelerator structure, then
this routine forces it to be deleted. Ordinarily, these structures
are cached so that series of calls to the closestIntersection(),
allIntersections(), and anyIntersection() methods can reuse the same
structure. Once the client is finished with these intersection
operations, however, they are responsible for freeing the acceleration
structure, which is what this method does.
"""
pass
def fullPathName(self, *args, **kwargs):
"""
fullPathName() -> string
Returns the full path of the attached object, from the root of the DAG on down.
"""
pass
def generateSmoothMesh(self, *args, **kwargs):
"""
generateSmoothMesh(parent=kNullObj, options=None) -> MObject
Creates a new polygonal mesh which is a smoothed version of the one
to which the functionset is attached. If an options object is supplied
it will be used to direct the smoothing operation, otherwise the
meshs Smooth Mesh Preview attributes will be used.
If the parent is a kMeshData wrapper (e.g. from MFnMeshData.create())
then a mesh data object will be created and returned.
If the parent is a transform type node then a mesh node will be
created and parented beneath it and the return value will be the
mesh node.
If the parent is any other type of node a TypeError will be raised.
If no parent is provided then a transform node will be created and
returned and a mesh node will be created and parented under the
transform.
Note that, unlike the create functions, this function does not set
the functionset to operate on the new mesh, but leaves it attached
to the original mesh.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getAllPaths(self, *args, **kwargs):
"""
getAllPaths() -> MDagPathArray
Returns all of the DAG paths which lead to the object to which this function set is attached.
"""
pass
def getAssignedUVs(self, *args, **kwargs):
"""
getAssignedUVs(uvSet=) -> (counts, uvIds)
Returns a tuple containing all of the UV assignments for the specified
UV set. The first element of the tuple is an array of counts giving
the number of UVs assigned to each face of the mesh. The count will
either be zero, indicating that that faces vertices do not have UVs
assigned, or else it will equal the number of the faces vertices.
The second element of the tuple is an array of UV IDs for all of the
face-vertices which have UVs assigned.
"""
pass
def getAssociatedColorSetInstances(self, *args, **kwargs):
"""
getAssociatedColorSetInstances(colorSet) -> MIntArray
Returns the instance numbers associated with the specified Color set.
If the color map is shared across all instances, an empty array will
be returned.
This method will only work if the functionset is attached to a mesh
node. It will raise RuntimeError if the functionset is attached to
mesh data.
"""
pass
def getAssociatedUVSetInstances(self, *args, **kwargs):
"""
getAssociatedUVSetInstances(uvSet) -> MIntArray
Returns the instance numbers associated with the specified UV set.
If the uv map is shared across all instances, an empty array will be
returned.
This method will only work if the functionset is attached to a mesh
node. It will raise RuntimeError if the functionset is attached to
mesh data.
"""
pass
def getAssociatedUVSetTextures(self, *args, **kwargs):
"""
getAssociatedUVSetTextures(uvSet) -> MObjectArray
Returns the texture nodes which are using the specified UV set. If
the texture has a 2d texture placement, the texture, and not the
placement will be returned.
This method will only work if the functionset is attached to a mesh
node. It will raise RuntimeError if the functionset is attached to
mesh data.
"""
pass
def getBinaryBlindData(self, *args, **kwargs):
"""
getBinaryBlindData(compId, compType, blindDataId, attr) -> string
getBinaryBlindData(compType, blindDataId, attr)
-> (MIntArray, [string, string, ...])
The first version returns the value of the specified blind data
attribute from the specified mesh component.
The second version returns a tuple containing an array of component
IDs and an array of values for the specified blind data attribute
for all of the meshs components of the specified type.
Both versions raise RuntimeError if the attribute is not of binary
type.
"""
pass
def getBinormals(self, *args, **kwargs):
"""
getBinormals(space=MSpace.kObject, uvSet=) -> MFloatVectorArray
Returns the binormal vectors for all face-vertices.
This method is not threadsafe.
"""
pass
def getBlindDataAttrNames(self, *args, **kwargs):
"""
getBlindDataAttrNames(blindDataId) -> ((longName, shortName, typeName), ...)
Returns a tuple listing the attributes of the given blind data type.
Each element of the tuple is itself a tuple containing the long
name, short name and type name of the attribute. Type names can be
int, float, double, boolean, string or binary.
"""
pass
def getBlindDataTypes(self, *args, **kwargs):
"""
getBlindDataTypes(MFn Type constant) -> MIntArray
Returns all the blind data IDs associated with the given component
type on this mesh.
"""
pass
def getBoolBlindData(self, *args, **kwargs):
"""
getBoolBlindData(compId, compType, blindDataId, attr) -> bool
getBoolBlindData(compType, blindDataId, attr) -> (MIntArray, MIntArray)
The first version returns the value of the specified blind data
attribute from the specified mesh component.
The second version returns a tuple containing an array of component
IDs and an array of values for the specified blind data attribute
for all of the meshs components of the specified type.
Both versions raise RuntimeError if the attribute is not of
boolean type.
"""
pass
def getClosestNormal(self, *args, **kwargs):
"""
getClosestNormal(MPoint, space=MSpace.kObject) -> (MVector, int)
Returns a tuple containing the normal at the closest point on the
mesh to the given point and the ID of the face in which that closest
point lies.
"""
pass
def getClosestPoint(self, *args, **kwargs):
"""
getClosestPoint(MPoint, space=MSpace.kObject) -> (MPoint, int)
Returns a tuple containing the closest point on the mesh to the
given point and the ID of the face in which that closest point lies.
This method is not threadsafe.
"""
pass
def getClosestPointAndNormal(self, *args, **kwargs):
"""
getClosestPointAndNormal(MPoint, space=MSpace.kObject)
-> (MPoint, MVector, int)
Returns a tuple containing the closest point on the mesh to the
given point, the normal at that point, and the ID of the face in
which that point lies.
This method is not threadsafe.
"""
pass
def getColor(self, *args, **kwargs):
"""
getColor(colorId, colorSet=) -> MColor
Returns a color from a colorSet. Raises IndexError if the colorId is
out of range.
"""
pass
def getColorIndex(self, *args, **kwargs):
"""
getColorIndex(faceId, localVertexId, colorSet=) -> int
Returns the index into the specified colorSet of the color used by a
specific face-vertex. This can be used to index into the sequence
returned by getColors().
"""
pass
def getColorRepresentation(self, *args, **kwargs):
"""
getColorRepresentation(colorSet) -> Color Representation constant
Returns the Color Representation used by the specified color set.
"""
pass
def getColorSetFamilyNames(self, *args, **kwargs):
"""
getColorSetFamilyNames() -> (string, ...)
Returns the names of all of the color set families on this object. A
color set family is a set of per-instance sets with the same name
with each individual set applying to one or more instances. A set
which is shared across all instances will be the sole member of its
family.
Given a color set family name, getColorSetsInFamily() may be used to
determine the names of the associated individual sets.
"""
pass
def getColorSetNames(self, *args, **kwargs):
"""
getColorSetNames() -> (string, ...)
Returns the names of all the color sets on this object.
"""
pass
def getColorSetsInFamily(self, *args, **kwargs):
"""
getColorSetsInFamily(familyName) -> (string, ...)
Returns the names of all of the color sets that belong to the
specified family. Per-instance sets will have multiple sets in a
family, with each individual set applying to one or more instances.
A set which is shared across all instances will be the sole member
of its family and will share the same name as its family.
"""
pass
def getColors(self, *args, **kwargs):
"""
getColors(colorSet=) -> MColorArray
Returns all of the colors in a colorSet. If no colorSet is specified
then the default colorSet is used.
Use the index returned by getColorIndex() to access the returned
array.
"""
pass
def getConnectedSetsAndMembers(self, *args, **kwargs):
"""
getConnectedSetsAndMembers(instance, renderableSetsOnly) -> (MObjectArray, MObjectArray)
Returns a tuple containing an array of sets and an array of the
components of the DAG object which are in those sets. If the entire object is in a set, then the corresponding entry in the comps array will have no elements in it.
"""
pass
def getConnectedShaders(self, *args, **kwargs):
"""
getConnectedShaders(instance) -> (MObjectArray, MIntArray)
Returns a tuple containing an array of shaders (sets) and an array
of ints mapping the meshs polygons onto those shaders. For each
polygon in the mesh there will be corresponding value in the second
array. If it is -1 that means that the polygon is not assigned to a
shader, otherwise it indicates the index into the first array of the
shader to which that polygon is assigned.
This method will only work if the functionset is attached to a mesh
node. It will raise RuntimeError if the functionset is attached to
mesh data.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getCreaseEdges(self, *args, **kwargs):
"""
getCreaseEdges() -> (MUintArray, MDoubleArray)
Returns a tuple containing two arrays. The first contains the mesh-
relative/global IDs of the meshs creased edges and the second
contains the associated crease data.
Please note that to make effective use of the creasing variable in
software outside of Maya may require a license under patents owned
by Pixar(R).
"""
pass
def getCreaseVertices(self, *args, **kwargs):
"""
getCreaseVertices() -> (MUintArray, MDoubleArray)
Returns a tuple containing two arrays. The first contains the mesh-
relative/global IDs of the meshs creased vertices and the second
contains the associated crease data.
Please note that to make effective use of the creasing variable in
software outside of Maya may require a license under patents owned
by Pixar(R).
"""
pass
def getDoubleBlindData(self, *args, **kwargs):
"""
getDoubleBlindData(compId, compType, blindDataId, attr) -> float
getDoubleBlindData(compType, blindDataId, attr) -> (MIntArray, MDoubleArray)
The first version returns the value of the specified blind data
attribute from the specified mesh component.
The second version returns a tuple containing an array of component
IDs and an array of values for the specified blind data attribute
for all of the meshs components of the specified type.
Both versions raise RuntimeError if the attribute is not of
double type.
"""
pass
def getEdgeVertices(self, *args, **kwargs):
"""
getEdgeVertices(edgeId) -> (int, int)
Returns a tuple containing the mesh-relative/global IDs of the
edges two vertices. The indices can be used to refer to the
elements in the array returned by the getPoints() method.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def getFaceAndVertexIndices(self, *args, **kwargs):
"""
getFaceAndVertexIndices(faceVertexIndex, localVertex=True) -> (int, int)
Returns a tuple containg the faceId and vertexIndex represented by
the given face-vertex index. This is the reverse of the operation
performed by getFaceVertexIndex().
If localVertex is True then the returned vertexIndex is the face-
relative/local index, otherwise it is the mesh-relative/global index.
"""
pass
def getFaceNormalIds(self, *args, **kwargs):
"""
getFaceNormalIds(faceId) -> MIntArray
Returns the IDs of the normals for all the vertices of a given face.
These IDs can be used to index into the arrays returned by getNormals().
"""
pass
def getFaceUVSetNames(self, *args, **kwargs):
"""
getFaceUVSetNames(faceId) -> (string, ...)
Returns the names of all of the uv sets mapped to the specified face.
This method is not threadsafe.
"""
pass
def getFaceVertexBinormal(self, *args, **kwargs):
"""
getFaceVertexBinormal(faceId, vertexId, space=MSpace.kObject, uvSet=) -> MVector
Returns the binormal vector at a given face vertex.
This method is not threadsafe.
"""
pass
def getFaceVertexBinormals(self, *args, **kwargs):
"""
getFaceVertexBinormals(faceId, space=MSpace.kObject, uvSet=) -> MFloatVectorArray
Returns all the per-vertex-per-face binormals for a given face.
This method is not threadsafe.
"""
pass
def getFaceVertexColors(self, *args, **kwargs):
"""
getFaceVertexColors(colorSet=, defaultUnsetColor=None) -> MColorArray
Returns colors for all the meshs face-vertices.
The colors are returned in face order: e.g. F0V0, F0V1.. F0Vn, F1V0,
etc... Use the index returned by getFaceVertexIndex() if you wish to
index directly into the returned color array.
If no face has color for that vertex, the entry returned will be
defaultUnsetColor. If a color was set for some but not all the faces
for that vertex, the ones where the color has not been explicitly set
will return (0,0,0). If a vertex has shared color, the same value
will be set for all its vertes/faces.
If the colorSet is not specified, the default color set will be used.
If the defaultUnsetColor is not given, then (-1, -1, -1, -1) will be
used.
"""
pass
def getFaceVertexIndex(self, *args, **kwargs):
"""
getFaceVertexIndex(faceId, vertexIndex, localVertex=True) -> int
Returns the index for a specific face-vertex into an array of face-
vertex values, such as those returned by getFaceVertexBinormals(),
getFaceVertexColors(), getFaceVertexNormals(), etc.
The values in the target arrays are presumed to be in face order:
F0V0, F0V1.. F0Vn, F1V0, etc...
If localVertex is True then vertexIndex must be a face-relative/local
index. If localVertex is False then vertexIndex must be a mesh-
relative/global index.
The opposite operation is performed by the getFaceAndVertexIndices()
method.
"""
pass
def getFaceVertexNormal(self, *args, **kwargs):
"""
getFaceVertexNormal(faceId, vertexId, space=MSpace.kObject) -> MVector
Returns the per-vertex-per-face normal for a given face and vertex.
This method is not threadsafe.
"""
pass
def getFaceVertexNormals(self, *args, **kwargs):
"""
getFaceVertexNormals(faceId, space=MSpace.kObject) -> MFloatVectorArray
Returns the normals for a given face.
This method is not threadsafe.
"""
pass
def getFaceVertexTangent(self, *args, **kwargs):
"""
getFaceVertexTangent(faceId, vertexId, space=MSpace.kObject, uvSet=) -> MVector
Return the normalized tangent vector at a given face vertex.
The tangent is defined as the surface tangent of the polygon running
in the U direction defined by the uv map.
This method is not threadsafe.
"""
pass
def getFaceVertexTangents(self, *args, **kwargs):
"""
getFaceVertexTangents(faceId, space=MSpace.kObject, uvSet=) -> MFloatVectorArray
Returns all the per-vertex-per-face tangents for a given face.
The tangent is defined as the surface tangent of the polygon running
in the U direction defined by the uv map.
This method is not threadsafe.
"""
pass
def getFloatBlindData(self, *args, **kwargs):
"""
getFloatBlindData(compId, compType, blindDataId, attr) -> float
getFloatBlindData(compType, blindDataId, attr) -> (MIntArray, MFloatArray)
The first version returns the value of the specified blind data
attribute from the specified mesh component.
The second version returns a tuple containing an array of component
IDs and an array of values for the specified blind data attribute
for all of the meshs components of the specified type.
Both versions raise RuntimeError if the attribute is not of
float type.
"""
pass
def getFloatPoints(self, *args, **kwargs):
"""
getFloatPoints(space=MSpace.kObject) -> MFloatPointArray
Returns an MFloatPointArray containing the meshs vertices.
"""
pass
def getHoles(self, *args, **kwargs):
"""
getHoles() -> ((face, (v1, v2, ...)), (face, (v1, v2, ...)), ...)
Returns a tuple describing the holes in the mesh. Each element of the
tuple is itself a tuple. The first element of the sub-tuple is the
integer ID of the face in which the hole occurs. The second element
of the sub-tuple is another tuple containing the mesh-relative/global
IDs of the vertices which make up the hole.
Take the following return value as an example:
((3, (7, 2, 6)), (5, (11, 10, 3, 4)))
This says that the mesh has two holes. The first hole is in face 3
and consists of vertices 7, 2 and 6. The second hole is in face 5 and
consists of vertices 11, 10, 3 and 4.
"""
pass
def getIntBlindData(self, *args, **kwargs):
"""
getIntBlindData(compId, compType, blindDataId, attr) -> int
getIntBlindData(compType, blindDataId, attr) -> (MIntArray, MIntArray)
The first version returns the value of the specified blind data
attribute from the specified mesh component.
The second version returns a tuple containing an array of component
IDs and an array of values for the specified blind data attribute
for all of the meshs components of the specified type.
Both versions raise RuntimeError if the attribute is not of
int type.
"""
pass
def getInvisibleFaces(self, *args, **kwargs):
"""
getInvisibleFaces() -> MUintArray
Returns the invisible faces of the mesh. Invisible faces are like
lightweight holes in that they are not rendered but do not require
additional geometry the way that holes do. They have the advantage
over holes that if the mesh is smoothed then their edges will be
smoothed as well, while holes will retain their hard edges.
Invisible faces can be set using the setInvisibleFaces() method or
the polyHole command.
"""
pass
def getNormalIds(self, *args, **kwargs):
"""
getNormalIds() -> (MIntArray, MIntArray)
Returns the normal IDs for all of the meshs polygons as a tuple of
two int arrays. The first array contains the number of vertices for
each polygon and the second contains the normal IDs for each polygon-
vertex. These IDs can be used to index into the array returned by
getNormals().
"""
pass
def getNormals(self, *args, **kwargs):
"""
getNormals(space=MSpace.kObject) -> MFloatVectorArray
Returns a copy of the meshs normals. The normals are the per-polygon
per-vertex normals. To find the normal for a particular vertex-face,
use getFaceNormalIds() to get the index into the array.
This method is not threadsafe.
"""
pass
def getPath(self, *args, **kwargs):
"""
getPath() -> MDagPath
Returns the DAG path to which this function set is attached, or the first path to the node if the function set is attached to an MObject.
"""
pass
def getPoint(self, *args, **kwargs):
"""
getPoint(vertexId, space=MSpace.kObject) -> MPoint
Returns the position of specified vertex.
"""
pass
def getPointAtUV(self, *args, **kwargs):
"""
getPointAtUV(faceId, u, v, space=MSpace.kObject, uvSet=, tolerance=0.0) -> MPoint
Returns the position of the point at the give UV value in the
specified face.
This method is not threadsafe.
"""
pass
def getPoints(self, *args, **kwargs):
"""
getPoints(space=MSpace.kObject) -> MPointArray
Returns a copy of the meshs vertex positions as an MPointArray.
"""
pass
def getPolygonNormal(self, *args, **kwargs):
"""
getPolygonNormal(polygonId, space=MSpace.kObject) -> MVector
Returns the per-polygon normal for the given polygon.
This method is not threadsafe.
"""
pass
def getPolygonTriangleVertices(self, *args, **kwargs):
"""
getPolygonTriangleVertices(polygonId, triangleId) -> (int, int, int)
Returns the mesh-relative/global IDs of the 3 vertices of the
specified triangle of the specified polygon. These IDs can be used
to index into the arrays returned by getPoints() and getFloatPoints().
"""
pass
def getPolygonUV(self, *args, **kwargs):
"""
getPolygonUV(polygonId, vertexId, uvSet=) -> (float, float)
Returns a tuple containing the U and V values at a specified vertex
of a specified polygon.
This method is not threadsafe.
"""
pass
def getPolygonUVid(self, *args, **kwargs):
"""
getPolygonUVid(polygonId, vertexId, uvSet=) -> int
Returns the ID of the UV at a specified vertex of a specified polygon.
This method is not threadsafe.
"""
pass
def getPolygonVertices(self, *args, **kwargs):
"""
getPolygonVertices(polygonId) -> MIntArray
Returns the mesh-relative/global vertex IDs the specified polygon.
These IDs can be used to index into the arrays returned by getPoints()
and getFloatPoints().
"""
pass
def getSmoothMeshDisplayOptions(self, *args, **kwargs):
"""
getSmoothMeshDisplayOptions() -> MMeshSmoothOptions
Returns the options currently in use when smoothing the mesh for display.
"""
pass
def getStringBlindData(self, *args, **kwargs):
"""
getStringBlindData(compId, compType, blindDataId, attr) -> string
getStringBlindData(compType, blindDataId, attr)
-> (MIntArray, [string, string, ...])
The first version returns the value of the specified blind data
attribute from the specified mesh component.
The second version returns a tuple containing an array of component
IDs and an array of values for the specified blind data attribute
for all of the meshs components of the specified type.
Both versions raise RuntimeError if the attribute is not of string
type.
"""
pass
def getTangentId(self, *args, **kwargs):
"""
getTangentId(faceId, vertexId) -> int
Returns the ID of the tangent for a given face and vertex.
"""
pass
def getTangents(self, *args, **kwargs):
"""
getTangents(space=MSpace.kObject, uvSet=) -> MFloatVectorArray
Return the tangent vectors for all face vertices. The tangent is
defined as the surface tangent of the polygon running in the U
direction defined by the uv map.
This method is not threadsafe.
"""
pass
def getTriangleOffsets(self, *args, **kwargs):
"""
getTriangleOffsets() -> (MIntArray, MIntArray)
Returns the number of triangles for every polygon face and the
offset into the vertex indices array for each triangle vertex (see getVertices()).
The triangleVertices array holds each vertex for each triangle in sequence,
so it has three times as many elements as there are triangles.
(i.e. three times the sum of the elements of the triangleCounts array)
"""
pass
def getTriangles(self, *args, **kwargs):
"""
getTriangles() -> (MIntArray, MIntArray)
Returns a tuple describing the meshs triangulation. The first
element of the tuple is an array giving the number of triangles for
each of the meshs polygons. The second tuple gives the ids of the
vertices of all the triangles.
"""
pass
def getUV(self, *args, **kwargs):
"""
getUV(uvId, uvSet=) -> (float, float)
Returns a tuple containing the u and v values of the specified UV.
"""
pass
def getUVAtPoint(self, *args, **kwargs):
"""
getUVAtPoint(point, space=MSpace.kObject, uvSet=) -> (float, float, int)
Returns a tuple containing the u and v coordinates of the point on
the mesh closest to the given point, and the ID of the face
containing that closest point.
This method is not threadsafe.
"""
pass
def getUVSetFamilyNames(self, *args, **kwargs):
"""
getUVSetFamilyNames() -> (string, ...)
Returns the names of all of the uv set families on this object. A
uv set family is a set of per-instance sets with the same name
with each individual set applying to one or more instances. A set
which is shared across all instances will be the sole member of its
family.
Given a uv set family name, getUVSetsInFamily() may be used to
determine the names of the associated individual sets.
"""
pass
def getUVSetNames(self, *args, **kwargs):
"""
getUVSetNames() -> (string, ...)
Returns the names of all the uv sets on this object.
"""
pass
def getUVSetsInFamily(self, *args, **kwargs):
"""
getUVSetsInFamily(familyName) -> (string, ...)
Returns the names of all of the uv sets that belong to the
specified family. Per-instance sets will have multiple sets in a
family, with each individual set applying to one or more instances.
A set which is shared across all instances will be the sole member
of its family and will share the same name as its family.
"""
pass
def getUVs(self, *args, **kwargs):
"""
getUVs(uvSet=) -> (MFloatArray, MFloatArray)
Returns a tuple containing an array of U values and an array of V
values, representing all of the UVs for the given UV set.
"""
pass
def getUvShellsIds(self, *args, **kwargs):
"""
getUvShellsIds(uvSet=) -> (int, MIntArray)
Returns a tuple containing describing how the specified UV sets UVs
are grouped into shells. The first element of the tuple is the number
of distinct shells. The second element of the tuple is an array of
shell indices, one per uv, indicating which shell that uv is part of.
"""
pass
def getVertexColors(self, *args, **kwargs):
"""
getVertexColors(colorSet=, defaultUnsetColor=None) -> MColorArray
Gets colors for all vertices of the given colorSet. If no face has
color for that vertex, the entry returned will be defaultUnsetColor.
If a color was set for some or all the faces for that vertex, an
average of those vertex/face values where the color has been set will
be returned.
If the colorSet is not specified, the default color set will be used.
If the defaultUnsetColor is not given, then (-1, -1, -1, -1) will be
used.
"""
pass
def getVertexNormal(self, *args, **kwargs):
"""
getVertexNormal(vertexId, angleWeighted, space=MSpace.kObject) -> MVector
Returns the normal at the given vertex. The returned normal is a
single per-vertex normal, so unshared normals at a vertex will be
averaged.
If angleWeighted is set to true, the normals are computed by an
average of surrounding face normals weighted by the angle subtended
by the face at the vertex. If angleWeighted is set to false, a simple
average of surround face normals is returned.
The simple average evaluation is significantly faster than the angle-
weighted average.
This method is not threadsafe.
"""
pass
def getVertexNormals(self, *args, **kwargs):
"""
getVertexNormals(angleWeighted, space=MSpace.kObject) -> MFloatVectorArray
Returns all the vertex normals. The returned normals are per-vertex
normals, so unshared normals at a vertex will be averaged.
If angleWeighted is set to True, the normals are computed by an
average of surrounding face normals weighted by the angle subtended
by the face at the vertex. If angleWeighted is set to false, a simple
average of surround face normals is returned.
The simple average evaluation is significantly faster than the angle-
weighted average.
This method is not threadsafe.
"""
pass
def getVertices(self, *args, **kwargs):
"""
getVertices() -> (MIntArray, MIntArray)
Returns the mesh-relative/global vertex IDs for all of the meshs
polygons as a tuple of two int arrays. The first array contains the
number of vertices for each polygon and the second contains the mesh-
relative IDs for each polygon-vertex. These IDs can be used to index
into the arrays returned by getPoints() and getFloatPoints().
"""
pass
def globalIntersectionAcceleratorsInfo(self, *args, **kwargs):
"""
globalIntersectionAcceleratorsInfo() -> string
Returns a string that describes the system-wide resource usage for
cached mesh intersection accelerators. The string will be of the
following form:
total 10 accelerators created (2 currently active - total current memory = 10000KB), total build time = 10.2s, peak memory = 14567.1KB
This means that:
* a total of 10 intersection accelerators have been created as
instructed by calls to closestIntersection(), allIntersections(),
or anyIntersection() with non-NULL accelParams values. Thesen structures are destroyed and re-created when intersection requests
with differing acceleration parameters are passed in for the same
mesh, so it is useful to see this value, which is the total count
of how many have been created. In this case, 8 of the 10 created
have been destroyed, either automatically or via calls to the
freeCachedIntersectionAccelerator() method
* the total memory footprint for the 2 accelerators currently in
existence is 10,000KB
* the total build time for all 10 structures that have been created
is 10.2 seconds
* the peak of total memory usage for all accelerators in the system
was 14567.1KB
Calling clearGlobalIntersectionAcceleratorInfo() will clear the
total count, total build time, and peak memory fields from
this information. It will not cause information about currently
existing accelerators to be lost.
"""
pass
def hasAlphaChannels(self, *args, **kwargs):
"""
hasAlphaChannels(colorSet) -> bool
Returns True if the color set has an alpha channel.
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasBlindData(self, *args, **kwargs):
"""
hasBlindData(compType, compId=None, blindDataId=None) -> bool
Returns true if any component of the given type on this mesh has
blind data. If a component ID is provided then only that particular
component is checked. If a blind data ID is provided then only blind
data of that type is checked.
"""
pass
def hasChild(self, *args, **kwargs):
"""
hasChild(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
def hasColorChannels(self, *args, **kwargs):
"""
hasColorChannels(colorSet) -> bool
Returns True if the color set has RGB channels.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasParent(self, *args, **kwargs):
"""
hasParent(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
@property
def inModel(self, *args, **kwargs):
"""
True if the node has been added to the model.
"""
pass
@property
def inUnderWorld(self, *args, **kwargs):
"""
True if this node is in the underworld of another node (e.g. a curve on surface is in the underworld of the surface).
"""
pass
def instanceCount(self, *args, **kwargs):
"""
instanceCount(indirect) -> int
Returns the number of instances for this node.
"""
pass
def isBlindDataTypeUsed(self, *args, **kwargs):
"""
isBlindDataTypeUsed(blindDataId) -> bool
Returns True if the blind data type is already in use anywhere in the scene.
"""
pass
def isChildOf(self, *args, **kwargs):
"""
isChildOf(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def isColorClamped(self, *args, **kwargs):
"""
isColorClamped(colorSet) -> bool
Returns True if the color sets RGBA components are clamped to the
range 0 to 1.
"""
pass
def isColorSetPerInstance(self, *args, **kwargs):
"""
isColorSetPerInstance(colorSet) -> bool
Returns True if the color set is per-instance, and False if it is
shared across all instances.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
def isEdgeSmooth(self, *args, **kwargs):
"""
isEdgeSmooth(edgeId) -> bool
Returns True if the edge is smooth, False if it is hard.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isInstanceable(self, *args, **kwargs):
"""
True if instancing is allowed for this node.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
isInstanced(indirect=True) -> bool
Returns True if this node is instanced.
"""
pass
def isInstancedAttribute(self, *args, **kwargs):
"""
isInstancedAttribute(attr) -> bool
Returns True if the specified attribute is an instanced attribute of this node.
"""
pass
@property
def isIntermediateObject(self, *args, **kwargs):
"""
True if this node is just an intermediate in part of a larger calculation (e.g. input to a deformer).
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
def isNormalLocked(self, *args, **kwargs):
"""
isNormalLocked(normalId) -> bool
Returns True if the normal is locked, False otherwise.
"""
pass
def isParentOf(self, *args, **kwargs):
"""
isParentOf(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
def isPolygonConvex(self, *args, **kwargs):
"""
isPolygonConvex(faceId) -> bool
Returns True if the polygon is convex, False if it is concave.
"""
pass
def isRightHandedTangent(self, *args, **kwargs):
"""
isRightHandedTangent(tangentId, uvSet=) -> bool
Returns True if the normal, tangent, and binormal form a right handed
coordinate system, False otherwise.
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
def isUVSetPerInstance(self, *args, **kwargs):
"""
isUVSetPerInstance(uvSet) -> bool
Returns True if the UV set is per-instance, and False if it is shared
across all instances.
"""
pass
kAlpha = 1
kDifference = 2
kExtensionAttr = 3
kInstanceUnspecified = -1
kInternalPoint = 1
def kIntersectTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
kIntersection = 3
kInvalid = 2
kInvalidAttr = 4
kLocalDynamicAttr = 1
kNextPos = 255
kNormalAttr = 2
kOnEdge = 0
def kPointTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
kRGB = 3
kRGBA = 4
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
kUnion = 1
def lockFaceVertexNormals(self, *args, **kwargs):
"""
lockFaceVertexNormals(seq of faceIds, seq of vertIds) -> self
Locks the normals for the given face/vertex pairs.
"""
pass
def lockVertexNormals(self, *args, **kwargs):
"""
lockVertexNormals(sequence of vertIds) -> self
Locks the shared normals for the specified vertices.
"""
pass
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
@property
def numColorSets(self, *args, **kwargs):
"""
Number of color sets.
"""
pass
def numColors(self, *args, **kwargs):
"""
numColors(colorSet=) -> int
Returns the number of colors in the given color set. If no color set
is specified then the meshs current color set will be used.
"""
pass
@property
def numEdges(self, *args, **kwargs):
"""
Number of edges.
"""
pass
@property
def numFaceVertices(self, *args, **kwargs):
"""
Total number of vertices within faces. Shared vertices are counted
for each face which uses them.
"""
pass
@property
def numNormals(self, *args, **kwargs):
"""
Number of per-polygon per-vertex normals.
"""
pass
@property
def numPolygons(self, *args, **kwargs):
"""
Number of polygons (faces).
"""
pass
@property
def numUVSets(self, *args, **kwargs):
"""
Number of UV (texture coordinate) sets.
"""
pass
def numUVs(self, *args, **kwargs):
"""
numUVs(uvSet=) -> int
Returns the number of UVs (texture coordinates) in the given UV set.
If no UV set is specified then the meshs current UV set will be used.
"""
pass
@property
def numVertices(self, *args, **kwargs):
"""
Number of distinct vertices. Shared vertices are only counted once.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def objectColor(self, *args, **kwargs):
"""
Index from 0 to 7 indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorRGB(self, *args, **kwargs):
"""
RGB value indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorType(self, *args, **kwargs):
"""
Determines whether the default color, indexed object color, orRGB object color is used for this object.
"""
pass
def onBoundary(self, *args, **kwargs):
"""
onBoundary(faceId) -> bool
Returns true if the face is on the border of the mesh, meaning that
one or more of its edges is a border edge.
"""
pass
def parent(self, *args, **kwargs):
"""
parent(index) -> MObject
Returns the specified parent of this node.
"""
pass
def parentCount(self, *args, **kwargs):
"""
parentCount() -> int
Returns the number of parents this node has.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
partialPathName() -> string
Returns the minimum path string necessary to uniquely identify the attached object.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def polygonVertexCount(self, *args, **kwargs):
"""
polygonVertexCount(faceId) -> int
Returns the number of vertices in the given polygon. Raises
ValueError if the polygon ID is invalid.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def removeChild(self, *args, **kwargs):
"""
removeChild(node) -> self
Removes the child, specified by MObject, reparenting it under the world.
"""
pass
def removeChildAt(self, *args, **kwargs):
"""
removeChildAt(index) -> self
Removes the child, specified by index, reparenting it under the world.
"""
pass
def removeFaceColors(self, *args, **kwargs):
"""
removeFaceColors(seq of faceIds) -> self
Removes colors from all vertices of the specified faces.
"""
pass
def removeFaceVertexColors(self, *args, **kwargs):
"""
removeFaceVertexColors(seq of faceIds, seq of vertexIds) -> self
Removes colors from the specified face/vertex pairs.
"""
pass
def removeVertexColors(self, *args, **kwargs):
"""
removeVertexColors(seq of vertexIds) -> self
Removes colors from the specified vertices in all of the faces which
share those vertices.
"""
pass
def renameUVSet(self, *args, **kwargs):
"""
renameUVSet(origName, newName, modifier=None) -> self
Renames a UV set. The set must exist and the new name cannot be the
same as that of an existing set.
This method is only valid for functionsets which are attached to mesh
nodes, not mesh data.
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setBinaryBlindData(self, *args, **kwargs):
"""
setBinaryBlindData(compId, compType, blindDataId, attr, data) -> self
setBinaryBlindData(seq of compId, compType, blindDataId, attr, data) -> self
The first version sets the value of a binary blind data attribute
on a single component of the mesh. The data must be a single string.
The second version sets the value of a binary blind data attribute
on multiple components of the mesh. If the data is a sequence of
strings then it must provide a value for each component in compIds.
If it is a single string then all of the specified components will
have their blind data set to that value.
"""
pass
def setBoolBlindData(self, *args, **kwargs):
"""
setBoolBlindData(compId, compType, blindDataId, attr, data) -> self
setBoolBlindData(seq of compId, compType, blindDataId, attr, data) -> self
The first version sets the value of a boolean blind data attribute
on a single component of the mesh. The data must be a single boolean.
The second version sets the value of a boolean blind data attribute
on multiple components of the mesh. If the data is a sequence of
booleans then it must provide a value for each component in compIds.
If it is a single boolean then all of the specified components will
have their blind data set to that value.
"""
pass
def setColor(self, *args, **kwargs):
"""
setColor(colorId, MColor, colorSet=, rep=kRGBA) -> self
Sets a color in the specified colorSet. If no colorSet is given the
current colorSet will be used. If the colorId is greater than or
equal to numColors() then the colorSet will be grown to accommodate
the specified color.
"""
pass
def setColors(self, *args, **kwargs):
"""
setColors(seq of MColor, colorSet=, rep=kRGBA) -> self
Sets all the colors of the specified colorSet. If no colorSet is
given the current colorSet will be used. After using this method to
set the color values, you can call assignColors() to assign the
corresponding color ids to the geometry.
The color sequence must be at least as large as the current color set
size. You can determine the color set size by calling numColors() for
the default color set, or numColors(colorSet) for a named color set.
If the sequence is larger than the color set size, then the color set
for this mesh will be expanded to accommodate the new color values.
In order to shrink the colorSet you have to clear its existing
colors. E.g: clearColors(), setColors( ... ), assignColors()
"""
pass
def setCreaseEdges(self, *args, **kwargs):
"""
setCreaseEdges(edgeIds, seq of float) -> self
Sets the specified edges of the mesh as crease edges.
Please note that to make effective use of the creasing variable in
software outside of Maya may require a license under patents owned by
Pixar(R).
"""
pass
def setCreaseVertices(self, *args, **kwargs):
"""
setCreaseVertices(edgeIds, seq of float) -> self
Sets the specified edges of the mesh as crease edges.
Please note that to make effective use of the creasing variable in
software outside of Maya may require a license under patents owned by
Pixar(R).
"""
pass
def setCurrentColorSetName(self, *args, **kwargs):
"""
setCurrentColorSetName(colorSet, modifier=None, currentSelection=None) -> self
Sets the current color set for this object. The current color set
is the one used when no color set name is specified for a color
operation. If the specified color set does not exist then the current
color set will not be changed.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
This method may change the current selection. If the currentSelection
(MSelectionList) parameter is provided then the current selection
will be saved to it prior to the change. This is useful for
supporting full undo of the change.
This method is only valid for functionsets which are attached to mesh
nodes, not mesh data.
"""
pass
def setCurrentUVSetName(self, *args, **kwargs):
"""
setCurrentUVSetName(uvSet, modifier=None, currentSelection=None) -> self
Sets the current uv set for this object. The current uv set is the
one used when no uv set name is specified for a uv operation. If the
specified uv set does not exist then the current uv set will not be
changed.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
This method may change the current selection. If the currentSelection
(MSelectionList) parameter is provided then the current selection
will be saved to it prior to the change. This is useful for
supporting full undo of the change.
This method is only valid for functionsets which are attached to mesh
nodes, not mesh data.
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setDoubleBlindData(self, *args, **kwargs):
"""
setDoubleBlindData(compId, compType, blindDataId, attr, data) -> self
setDoubleBlindData(seq of compId, compType, blindDataId, attr, data) -> self
The first version sets the value of a double blind data attribute
on a single component of the mesh. The data must be a single float.
The second version sets the value of a double blind data attribute
on multiple components of the mesh. If the data is a sequence of
floats then it must provide a value for each component in compIds.
If it is a single float then all of the specified components will
have their blind data set to that value.
"""
pass
def setEdgeSmoothing(self, *args, **kwargs):
"""
setEdgeSmoothing(edgeId, smooth=True) -> self
Sets the specified edge to be hard or smooth. You must use the
cleanupEdgeSmoothing() method after all the desired edges on your
mesh have had setEdgeSmoothing() done. Use the updateSurface() method
to indicate the mesh needs to be redrawn.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setFaceColor(self, *args, **kwargs):
"""
setFaceColor(color, faceId, rep=kRGBA) -> self
Sets the face-vertex color for all vertices on this face.
"""
pass
def setFaceColors(self, *args, **kwargs):
"""
setFaceColors(colors, faceIds, rep=kRGBA) -> self
Sets the colors of the specified faces. For each face in the faceIds
sequence the corresponding color from the colors sequence will be
applied to all of its vertices.
"""
pass
def setFaceVertexColor(self, *args, **kwargs):
"""
setFaceVertexColor(color, faceId, vertexId, modifier=None, rep=kRGBA) -> self
Sets a face-specific normal at a vertex.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
"""
pass
def setFaceVertexColors(self, *args, **kwargs):
"""
setFaceVertexColors(colors, faceIds, vertexIds, modifier=None, rep=kRGBA) -> self
Sets the colors of the specified face/vertex pairs.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
"""
pass
def setFaceVertexNormal(self, *args, **kwargs):
"""
setFaceVertexNormal(normal, faceId, vertexId, space=MSpace.kObject, modifier=None) -> self
Sets a face-specific normal at a vertex.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
"""
pass
def setFaceVertexNormals(self, *args, **kwargs):
"""
setFaceVertexNormal(normals, faceIds, vertexIds, space=MSpace.kObject) -> self
Sets normals for the given face/vertex pairs.
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setFloatBlindData(self, *args, **kwargs):
"""
setFloatBlindData(compId, compType, blindDataId, attr, data) -> self
setFloatBlindData(seq of compId, compType, blindDataId, attr, data) -> self
The first version sets the value of a float blind data attribute
on a single component of the mesh. The data must be a single float.
The second version sets the value of a float blind data attribute
on multiple components of the mesh. If the data is a sequence of
floats then it must provide a value for each component in compIds.
If it is a single float then all of the specified components will
have their blind data set to that value.
"""
pass
def setIntBlindData(self, *args, **kwargs):
"""
setIntBlindData(compId, compType, blindDataId, attr, data) -> self
setIntBlindData(seq of compId, compType, blindDataId, attr, data) -> self
The first version sets the value of a int blind data attribute
on a single component of the mesh. The data must be a single int.
The second version sets the value of a int blind data attribute
on multiple components of the mesh. If the data is a sequence of
ints then it must provide a value for each component in compIds.
If it is a single int then all of the specified components will
have their blind data set to that value.
"""
pass
def setInvisibleFaces(self, *args, **kwargs):
"""
setInvisibleFaces(faceIds, makeVisible=False) -> self
Sets the specified faces of the mesh to be visible or invisible. See
the getInvisibleFaces() method for a description of invisible faces.
"""
pass
def setIsColorClamped(self, *args, **kwargs):
"""
setIsColorClamped(colorSet, clamped) -> self
Sets whether the color sets RGBA components should be clamped to the
range 0 to 1.
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setNormals(self, *args, **kwargs):
"""
setNormals(normals, space=MSpace.kObject) -> self
Sets the meshs normals (user normals).
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(MObject or MDagPath) -> self
Attaches the function set to the specified node or DAG path.
"""
pass
def setPoint(self, *args, **kwargs):
"""
setPoint(vertexId, MPoint, space=MSpace.kObject) -> self
Sets the position of specified vertex.
Note that if you modify the position of a vertex for a mesh node (as
opposed to mesh data), a tweak will be created. If you have a node
with no history, the first time that a tweak is created, the
underlying pointers under the MFnMesh object may change. You will
need to call syncObject() to make sure that the object is valid.
Subsequent calls to setPoint() on the same object do not require a
syncObject() call.
"""
pass
def setPoints(self, *args, **kwargs):
"""
setPoints(points, space=MSpace.kObject) -> self
Sets the positions of the meshs vertices. The positions may be
given as a sequence of MFloatPoints or a sequence of MPoints, but
not a mix of the two.
"""
pass
def setSmoothMeshDisplayOptions(self, *args, **kwargs):
"""
setSmoothMeshDisplayOptions(MMeshSmoothOptions) -> self
Sets the options to use when smoothing the mesh for display.
"""
pass
def setSomeColors(self, *args, **kwargs):
"""
setSomeColors(colorIds, colors, colorSet=, rep=kRGBA) -> self
Sets specific colors in a colorSet.
If the largest colorId in the sequence is larger than numColors()
then the colorSet will be grown to accommodate the new color values.
If you have added new colorIds, you can call assignColors to assign
the colorIds to the geometry. If you are modifying existing colors,
they will already be referenced by the existing mesh data.
"""
pass
def setSomeUVs(self, *args, **kwargs):
"""
setSomeUVs(uvIds, uValues, vValues, uvSet=) -> self
Sets the specified texture coordinates (uvs) for this mesh. The uv
value sequences and the uvIds sequence must all be of equal size. If
the largest uvId in the array is larger than numUVs() then the uv
list for this mesh will be grown to accommodate the new uv values.
If a named uv set is given, the array will be grown when the largest
uvId is larger than numUVs(uvSet).
If you have added new uvIds, you must call one of the assignUV
methods to assign the uvIds to the geometry. If you are modifying
existing UVs, you do not need to call one of the assignUV methods.
"""
pass
def setStringBlindData(self, *args, **kwargs):
"""
setStringBlindData(compId, compType, blindDataId, attr, data) -> self
setStringBlindData(seq of compId, compType, blindDataId, attr, data) -> self
The first version sets the value of a string blind data attribute
on a single component of the mesh. The data must be a single string.
The second version sets the value of a string blind data attribute
on multiple components of the mesh. If the data is a sequence of
strings then it must provide a value for each component in compIds.
If it is a single string then all of the specified components will
have their blind data set to that value.
"""
pass
def setUV(self, *args, **kwargs):
"""
setUV(uvId, u, v, uvSet=) -> self
Sets the specified texture coordinate.
The uvId is the element in the uv list that will be set. If the uvId
is greater than or equal to numUVs() then the uv list will be grown
to accommodate the specified uv. If the UV being added is new, thenyou must call one of the assignUV methods in order to update the
geometry.
"""
pass
def setUVs(self, *args, **kwargs):
"""
setUVs(uValues, vValues, uvSet=) -> self
Sets all of the texture coordinates (uvs) for this mesh. The uv
value sequences must be of equal size and must be at least as large
as the current UV set size. You can determine the UV set size by
calling numUVs() for the default UV set, or numUVs(uvSet) for a
named UV set.
If the sequences are larger than the UV set size, then the uv list
for this mesh will be grown to accommodate the new uv values.
After using this method to set the UV values, you must call one of
the assignUV methods to assign the corresponding UV ids to the
geometry.
In order to shrink the uvs array, do the following: clearUVs(),
setUVs(...), assignUVs(). These steps will let you to create an
array of uvs which is smaller than the original one.
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def setVertexColor(self, *args, **kwargs):
"""
setVertexColor(color, vertexId, modifier=None, rep=kRGBA) -> self
Sets the color for a vertex in all the faces which share it.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
"""
pass
def setVertexColors(self, *args, **kwargs):
"""
setVertexColors(colors, vertexIds, modifier=None, rep=kRGBA) -> self
Sets the colors of the specified vertices. For each vertex in the
vertexIds sequence, the corresponding color from the colors sequence
will be applied to the vertex in all of the faces which share it.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
"""
pass
def setVertexNormal(self, *args, **kwargs):
"""
setVertexNormal(normal, vertexId, space=MSpace.kObject, modifier=None) -> self
Sets the shared normal at a vertex.
If modifier (MDGModifier) is provided then the operation will be
added to the modifier and will not take effect until the modifiers
doIt() is called. Otherwise it will take effect immediately.
"""
pass
def setVertexNormals(self, *args, **kwargs):
"""
setVertexNormal(normals, vertexIds, space=MSpace.kObject) -> self
Sets the shared normals for the given vertices.
"""
pass
def sortIntersectionFaceTriIds(self, *args, **kwargs):
"""
sortIntersectionFaceTriIds(faceIds, triIds=none) -> self
Convenience routine for sorting faceIds or face/triangle ids before
passing them into the closestIntersection(), allIntersections(), or
anyIntersection() methods. When using an acceleration structure with
an intersection operation it is essential that any faceId or
faceId/triId arrays be sorted properly to ensure optimal performance.
Both arguments must be MIntArrays.
"""
pass
def split(self, *args, **kwargs):
"""
split(((kOnEdge, int, float), (kInternalPoint, MFloatPoint), ...)) -> self
Each tuple in the placements sequence consists of a Split Placement
constant followed by one or two parameters.
If the Split Placement is kOnEdge then the tuple will contain two
more elements giving the int id of the edge to split, and a float
value between 0 and 1 indicating how far along the edge to do the
split. The same edge cannot be split more than once per call.
If the Split Placement is kInternalPoint then the tuple will contain
just one more element giving an MFloatPoint within the face.
All splits must begin and end on an edge meaning that the first and
last tuples in the placements sequence must be kOnEdge placements.
"""
pass
def subdivideEdges(self, *args, **kwargs):
"""
subdivideEdges(edges, numDivisions) -> self
Subdivides edges at regular intervals. For example, if numDivisions
is 2 then two equally-spaced vertices will be added to each of the
specified edges: one 1/3 of the way along the edge and a second 2/3
of the way along the edge.
"""
pass
def subdivideFaces(self, *args, **kwargs):
"""
subdivideFaces(faces, numDivisions) -> self
Subdivides each specified face into a grid of smaller faces.
Triangles are subdivided into a grid of smaller triangles and quads
are subdivided into a grid of smaller quads. Faces with more than
four edges are ignored.
The numDivisions parameter tells how many times to subdivide each
edge of the face. Internal points and edges are introduced as needed
to create a grid of smaller faces.
"""
pass
def syncObject(self, *args, **kwargs):
"""
syncObject() -> self
If a non-api operation happens that many have changed the
underlying Maya object attached to this functionset, calling this
method will make sure that the functionset picks up those changes.
In particular this call should be used after calling mel commands
which might affect the mesh. Note that this only applies when the
functionset is attached to a mesh node. If its attached to mesh
data the it is not necessary to call this method.
"""
pass
def transformationMatrix(self, *args, **kwargs):
"""
transformationMatrix() -> MMatrix
Returns the object space transformation matrix for this DAG node.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
def uniformGridParams(self, *args, **kwargs):
"""
uniformGridParams(xDiv, yDiv, zDiv) -> MMeshIsectAccelParams
Creates an object which specifies a uniform voxel grid structure
which can be used by the intersection routines to speed up their
operation. This object specifies the number of voxel cells to be
used in the x, y, and z dimensions. The grid acceleration structure
will be cached with the mesh, so that if the same MMeshIsectAccelParams
configuration is used on the next intersect call, the acceleration
structure will not need to be rebuilt.
"""
pass
def unlockFaceVertexNormals(self, *args, **kwargs):
"""
unlockFaceVertexNormals(seq of faceIds, seq of vertIds) -> self
Unlocks the normals for the given face/vertex pairs.
"""
pass
def unlockVertexNormals(self, *args, **kwargs):
"""
unlockVertexNormals(sequence of vertIds) -> self
Unlocks the shared normals for the specified vertices.
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
Signal that this polygonal mesh has changed and needs to be redrawn.
"""
pass
@property
def useObjectColor(self, *args, **kwargs):
"""
If True then the node will be drawn using its objectColor, otherwise it will be drawn using Mayas default color. Thismethod is deprecated, use objectColorType instead.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
class MFnMeshData(MFnGeometryData):
"""
MFnMeshData allows the creation and manipulation of Mesh
data objects for use in the dependency graph.
__init__()
Initializes a new, empty MFnMeshData object
__init__(MObject)
Initializes a new MFnMeshData function set, attached
to the specified object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addObjectGroup(self, *args, **kwargs):
"""
addObjectGroup(id) -> self
Adds an object group with the given id to the object.
"""
pass
def addObjectGroupComponent(self, *args, **kwargs):
"""
addObjectGroupComponent(id, MObject component) -> self
Adds the members of the given component to the object group
with the given id.
"""
pass
def changeObjectGroupId(self, *args, **kwargs):
"""
changeObjectGroupId(sourceId, destId) -> self
Changes the id of the object group with the given id to the new id.
"""
pass
def copyObjectGroups(self, *args, **kwargs):
"""
copyObjectGroups(MObject inGeom) -> self
Copies the object groups from the given geometry data object.
"""
pass
def create(self, *args, **kwargs):
"""
create() -> MObject
Creates a new mesh data object, attaches it to this function set
and returns an MObject which references it.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasObjectGroup(self, *args, **kwargs):
"""
hasObjectGroup(id) -> self
Returns True if an object group with the given id is
contained in the data.
"""
pass
@property
def isIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is the identity.
"""
pass
@property
def isNotIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is not the identity.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
@property
def matrix(self, *args, **kwargs):
"""
MMatrix used to convert the object into local space.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def objectGroup(self, *args, **kwargs):
"""
objectGroup(index) -> int
Returns the id of the indexth object group contained by the object.
"""
pass
def objectGroupComponent(self, *args, **kwargs):
"""
objectGroupComponent(id) -> MObject
Returns a component which contains the members of the object group
with the given id.
"""
pass
@property
def objectGroupCount(self, *args, **kwargs):
"""
The number of object groups contained by the object.
"""
pass
def objectGroupType(self, *args, **kwargs):
"""
objectGroupType(id) -> MFn Type constant
Returns the type of the component that the object group with the
given id contains.
"""
pass
def removeObjectGroup(self, *args, **kwargs):
"""
removeObjectGroup(id) -> self
Removes an object group with the given id from the object.
"""
pass
def removeObjectGroupComponent(self, *args, **kwargs):
"""
removeObjectGroupComponent(id, MObject component) -> self
Removes the members of the given component from the object group
with the given id.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setObjectGroupComponent(self, *args, **kwargs):
"""
setObjectGroupComponent(id, MObject component) -> self
Sets the members of the object group with the given id
to be only those in the given component.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnMessageAttribute(MFnAttribute):
"""
Functionset for creating and working with message attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new message attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnNumericAttribute(MFnAttribute):
"""
Functionset for creating and working with numeric attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
def child(self, *args, **kwargs):
"""
Returns the specified child attribute of the parent attribute currently attached to the function set.
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new simple or compound numeric attribute, attaches it to the function set and returns it in an MObject.
"""
pass
def createAddr(self, *args, **kwargs):
"""
Creates a new address attribute, attaches it to the function set and returns it in an MObject.
"""
pass
def createColor(self, *args, **kwargs):
"""
Creates a new color attribute, attaches it to the function set and returns it in an MObject.
"""
pass
def createPoint(self, *args, **kwargs):
"""
Creates a new 3D point attribute, attaches it to the function set and returns it in an MObject.
"""
pass
@property
def default(self, *args, **kwargs):
"""
Default value
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def getMax(self, *args, **kwargs):
"""
Returns the attributes hard maximum value(s).
"""
pass
def getMin(self, *args, **kwargs):
"""
Returns the attributes hard minimum value(s).
"""
pass
def getSoftMax(self, *args, **kwargs):
"""
Returns the attributes soft maximum value.
"""
pass
def getSoftMin(self, *args, **kwargs):
"""
Returns the attributes soft minimum value.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasMax(self, *args, **kwargs):
"""
Returns True if a hard maximum value has been specified for the attribute.
"""
pass
def hasMin(self, *args, **kwargs):
"""
Returns True if a hard minimum value has been specified for the attribute.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasSoftMax(self, *args, **kwargs):
"""
Returns True if a soft maximum value has been specified for the attribute.
"""
pass
def hasSoftMin(self, *args, **kwargs):
"""
Returns True if a soft minimum value has been specified for the attribute.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def numericType(self, *args, **kwargs):
"""
Returns the numeric type of the attribute currently attached to the function set.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setMax(self, *args, **kwargs):
"""
Sets the attributes hard maximum value(s).
"""
pass
def setMin(self, *args, **kwargs):
"""
Sets the attributes hard minimum value(s).
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setSoftMax(self, *args, **kwargs):
"""
Sets the attributes soft maximum value.
"""
pass
def setSoftMin(self, *args, **kwargs):
"""
Sets the attributes soft minimum value.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnNumericData(MFnData):
"""
Function set for non-simple numeric node data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new numeric data object.
"""
pass
def getData(self, *args, **kwargs):
"""
Returns a list containing the attached data objects data.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
k2Double = 15
k2Float = 12
k2Int = 8
k2Long = 8
k2Short = 5
k3Double = 16
k3Float = 13
k3Int = 9
k3Long = 9
k3Short = 6
k4Double = 17
kAddr = 18
kAny = 24
kBoolean = 1
kByte = 2
kChar = 3
kComponentList = 13
kDouble = 14
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloat = 11
kFloatArray = 8
kInt = 7
kInt64 = 10
kIntArray = 9
kInvalid = 0
kLast = 19
kLattice = 15
kLong = 7
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kShort = 4
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def numericType(self, *args, **kwargs):
"""
Returns the type of data in the attached data object.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setData(self, *args, **kwargs):
"""
Sets the value of the data in the attached data object.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnNurbsCurve(MFnDagNode):
"""
NURBS (Non-Uniform Rational B-Spline) curve function set.
The shape of a NURBS curve is defined by an array of CVs
(control vertices), an array of knot values, a degree, and a
form. There are 3 possible forms for the curve: open,
closed and periodic.
The open and closed forms are quite similar, and in fact a
closed curve will become an open curve if either the first
or last CV is moved so that they are no longer coincident.
To create an open or closed curve of degree N with M spans,
you must provide M+N CVs. This implies that for a degree N
curve, you must specify at least N+1 CVs to get a curve with
a single span.
The number of knots required for a curve is M + 2N - 1. If
you want the curve to start exactly at the first CV and end
exactly at the last CV, then the knot vector must be
structured to have degree N multiplicity at the beginning
and end. This means that the first N knots must be
identical, and the last N knots must be identical.
A periodic curve is a special case of a closed curve.
Instead of having just the first and last CVs coincident,
the last N CVs in the curve must overlap the first N CVs.
This results in a curve with no tangent break at the seam
where the ends meet. The last N CVs in a periodic curve are
permanently bound to the first N CVs, and Maya will not
allow those last N CVs to be repositioned. If one or more
of the first N CVs of the curve are repositioned, the
overlapping CVs will remain bound, and will also be moved.
In order to create a periodic curve, you must specify at
least 2N+1 CVs, so that that last N can overlap the first N
and you still have 1 non-overlapping CV left. The number of
CVs required to create a periodic curve is still N+M (with a
lower limit of 2N+1), but you must ensure that the positions
of the last N CVs are identical to the positions of the
first N.
You still need M + 2N - 1 knots for a periodic curve, but
the knot values required are more restrictive than for open
or closed curves because of the overlap at the ends, The
difference between the first N pairs of knots values should
be equal to the difference between the last N pairs.
Additionally there can be no knot multiplicity at the ends
of the curve, because that would compromise the tangent
continuity property. So an example knot sequence could begin
with knots at { -(N-2), -(N-1), ... , 0}.
Note that some third party applications use a different
format for knots, where the number of knots required for a
curve is M+2N+1 rather than M+2N-1 as used in Maya. Both
knot representations are equivalent mathematically. To
convert from one of these external representations into the
Maya representation, simply omit the first and last knots
from the external representation when creating the Maya
representation. To convert from the Maya representation into
the external representation, add two new knots at the
beginning and end of the Maya knot sequence. The value of
these new knots depends on the existing knot sequence. For a
knot sequence with multiple end knots, simply duplicate the
existing first and last knots once more, for example:
Maya representation: {0,0,0,...,N,N,N}
External representation: {0,0,0,0,...,N,N,N,N}
For a knot sequence with uniform end knots, create the new
knots offset at an interval equal to the existing first and
last knot intervals, for example:
Maya representation: {0,1,2,...,N,N+1,N+2}
External representation: {-1,0,1,2,...,N,N+1,N+2,N+3}
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addChild(self, *args, **kwargs):
"""
addChild(node, index=kNextPos, keepExistingParents=False) -> self
Makes a node a child of this one.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def area(self, *args, **kwargs):
"""
area(tolerance=kPointTolerance) -> float
Returns the area bounded by the curve. The curve must be closed and
planar. A value of 0.0 will be returned if area cannot be determined.
* tolerance (float) - Amount of error allowed in the calculation
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
@property
def boundingBox(self, *args, **kwargs):
"""
Nodes bounding box, in object space.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
def child(self, *args, **kwargs):
"""
child(index) -> MObject
Returns the specified child of this node.
"""
pass
def childCount(self, *args, **kwargs):
"""
childCount() -> int
Returns the number of nodes which are children of this one.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def closestPoint(self, *args, **kwargs):
"""
closestPoint(testPoint, guess=None, tolerance=kPointTolerance,
space=kObject) -> (MPoint, float)
Returns a tuple containing the point on the curve which is closest
to testPoint, and the parameter value at which that point occurs.
* testPoint (MPoint) - point to get closest to
* guess (float) - a guess as to roughly where on the curve the
closest point will be. If the guess is in the
correct span than it can significantly speed
up the search. If not then it may slow down
the search a bit. If no guess is supplied
then the search will begin at the start of
the curve.
* tolerance (float) - maximum allowed distance between the curve
and the returned point.
* space (MSpace constant) - coordinate space to use for the points
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source, parent=MObject.kNullObj) -> MObject
Returns a new NURBS curve which is a copy of source and resets
the functionset to operate on it.
* parent (MObject)
- the parent/owner of the new curve. If its a NURBS
curve data wrapper (MFn.kNurbsCurveData) then the
created curve will be returned as a geometry object
(MFn.kNurbsCurveGeom) owned by the wrapper. If
parent is a DAG node then the new curve will be
returned as nurbsCurve node parented under it. If
parent is not provided then a new top-level
transform will be created with the new curve parented
beneath it as a nurbsCurve node. In this last case it
will be the transform node which is returned.
"""
pass
def create(self, *args, **kwargs):
"""
create(cvs, knots, degree, form, is2D, rational, parent=kNullObj)
-> self
create(subCurves, parent=kNullObj) -> self
Returns a newly created curve and resets the functionset to operate
on it. The first version creates the curve based on the control
vertices and knots provided while the second creates the curve as a
copy of the provided subCurves, all joined together.
* cvs (MPointArray or seq of MPoint)
- positions of the control vertices
* knots (MDoubleArray seq of float)
- parameter values of the knots. There must be
(# spans + 2*degree - 1) knots provided and they must
appear in non-decreasing order.
* degree (int) - degree of the curve to create
* form (int) - one of kOpen, kClosed or kPeriodic
* is2d (bool)- if True the Z-coordinates of cvs will be ignored,
giving a curve in the local XY plane.
* rational (bool)
- set True if you want the new curve to be rational
* parent (MObject)
- the parent/owner of the new curve. If its a NURBS
curve data wrapper (MFn.kNurbsCurveData) then the
created curve will be returned as a geometry object
(MFn.kNurbsCurveGeom) owned by the wrapper. If
parent is a DAG node then the new curve will be
returned as nurbsCurve node parented under it. If
parent is not provided then a new top-level
transform will be created with the new curve parented
beneath it as a nurbsCurve node. In this last case it
will be the transform node which is returned.
* subCurves (MObjectArray or seq of MObject)
- array of curves from which the new curve will be built
The curves must all be in the same direction, must not
intersect themselves or each other, the start of each
curve in the array must be coincident with the end of
the previous curve in the array, and the curves must be
be at least C0 continuous (i.e. tangent breaks are okay).
"""
pass
def createWithEditPoints(self, *args, **kwargs):
"""
createWithEditPoints(eps, degree, form, is2D, rational, uniform,
parent=kNullObj) -> MObject
Returns a new curve based on the given edit points (i.e. points
which lie on the curve) and resets the functionset to operate on it.
* eps (MPointArray or seq of MPoint)
- positions of the edit points
* degree (int) - degree of the curve to create
* form (int) - one of kOpen, kClosed or kPeriodic
* is2d (bool)- if True the Z-coordinates of eps will be ignored,
giving a curve in the local XY plane.
* rational (bool)
- set True if you want the new curve to be rational
* uniform (bool)
- if True then parameter values of the knots will be
uniformly spaced, otherwise they will be based on
chord length.
* parent (MObject)
- the parent/owner of the new curve. If its a NURBS
curve data wrapper (MFn.kNurbsCurveData) then the
created curve will be returned as a geometry object
(MFn.kNurbsCurveGeom) owned by the wrapper. If
parent is a DAG node then the new curve will be
returned as nurbsCurve node parented under it. If
parent is not provided then a new top-level
transform will be created with the new curve parented
beneath it as a nurbsCurve node. In this last case it
will be the transform node which is returned.
"""
pass
def cvPosition(self, *args, **kwargs):
"""
cvPosition(index, space=kObject) -> MPoint
Returns the position of a single control vertex.
* index (int) - index of the CV to return
* space (int) - an MSpace constant giving the coordinate space in
which the point is given
"""
pass
def cvPositions(self, *args, **kwargs):
"""
cvPositions(space=kObject) -> MPointArray
Returns the positions of all of the curves control vertices.
* space (int) - an MSpace constant giving the coordinate space in
which the point is given
"""
pass
def cvs(self, *args, **kwargs):
"""
cvs(startIndex[, endIndex]) -> MObject
Returns a CV or a range of CVs as a component. MItCurveCV can be
used to examine or modify the CVs in the component. Any modifications
made to them will affect the curve. After all modifications are done,
updateCurve() should be called to have the curve recalculate its
cached geometry.
* startIndex (int) - start of the range of CVs to return.
* endIndex (int) - end of the range of CVs to return. If not
provided then only the CV specified by
startIndex will be returned.
"""
pass
def dagPath(self, *args, **kwargs):
"""
dagPath() -> MDagPath
Returns the DAG path to which this function set is attached. Raises a TypeError if the function set is attached to an MObject rather than a path.
"""
pass
def dagRoot(self, *args, **kwargs):
"""
dagRoot() -> MObject
Returns the root node of the first path leading to this node.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
@property
def degree(self, *args, **kwargs):
"""
The degree of the curve or 0 if the degree cannot be determined.
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
def distanceToPoint(self, *args, **kwargs):
"""
distanceToPoint(point, space=kObject) -> float
Returns the distance from the given point to the point on the curve
which is closest to it.
* point (MPoint) - the point to calculate the distance to
* space (int) - an MSpace constant giving the coordinate space in
which the point is given
"""
pass
def duplicate(self, *args, **kwargs):
"""
duplicate(instance=False, instanceLeaf=False) -> MObject
Duplicates the DAG hierarchy rooted at the current node.
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findParamFromLength(self, *args, **kwargs):
"""
findParamFromLength(length) -> float
Returns the parameter value corresponding to a given length along
the curve. If the parameter value cannot be determined the the value
for the end point of the curve is returned.
* length (float) - distance along the curve
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
@property
def form(self, *args, **kwargs):
"""
The form of the curve: kOpen, kClosed, kPeriodic or kInvalid
"""
pass
def fullPathName(self, *args, **kwargs):
"""
fullPathName() -> string
Returns the full path of the attached object, from the root of the DAG on down.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getAllPaths(self, *args, **kwargs):
"""
getAllPaths() -> MDagPathArray
Returns all of the DAG paths which lead to the object to which this function set is attached.
"""
pass
def getConnectedSetsAndMembers(self, *args, **kwargs):
"""
getConnectedSetsAndMembers(instance, renderableSetsOnly) -> (MObjectArray, MObjectArray)
Returns a tuple containing an array of sets and an array of the
components of the DAG object which are in those sets. If the entire object is in a set, then the corresponding entry in the comps array will have no elements in it.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getDerivativesAtParam(self, *args, **kwargs):
"""
getDerivativesAtParam(param, space=kObject) -> (MPoint, MVector[, MVector])
Evaluates the curve at the given parameter value, returning a tuple
containing the position and first derivative at that value. If dUU
is True then the returned tuple will include the second derivative
as well as its third element.
* param (float) - parameter value at which to do the evaluation
* space (int) - an MSpace constant giving the coordinate space in
which the point is given
* dUU (bool) - if True include the second derivative in the result.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def getParamAtPoint(self, *args, **kwargs):
"""
getParamAtPoint(point, tolerance=kPointTolerance, space=kObject) -> float
Returns the parameter value corresponding to the given point on the
curve.
* point (MPoint) - point on curve.
* tolerance (float) - max distance point can be from the curve and
still be considered to lie on it.
* space (int) - an MSpace constant giving the coordinate space
in which the point is given
"""
pass
def getPath(self, *args, **kwargs):
"""
getPath() -> MDagPath
Returns the DAG path to which this function set is attached, or the first path to the node if the function set is attached to an MObject.
"""
pass
def getPointAtParam(self, *args, **kwargs):
"""
getPointAtParam(param, space=kObject) -> MPoint
Returns the point on the curve at the given parameter value.
* param (float) - parameter value at which to find the point
* space (int) - an MSpace constant giving the coordinate space in
which the point should be returned
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasChild(self, *args, **kwargs):
"""
hasChild(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
@property
def hasHistoryOnCreate(self, *args, **kwargs):
"""
True if the curve was created with history.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasParent(self, *args, **kwargs):
"""
hasParent(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
@property
def inModel(self, *args, **kwargs):
"""
True if the node has been added to the model.
"""
pass
@property
def inUnderWorld(self, *args, **kwargs):
"""
True if this node is in the underworld of another node (e.g. a curve on surface is in the underworld of the surface).
"""
pass
def instanceCount(self, *args, **kwargs):
"""
instanceCount(indirect) -> int
Returns the number of instances for this node.
"""
pass
def isChildOf(self, *args, **kwargs):
"""
isChildOf(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isInstanceable(self, *args, **kwargs):
"""
True if instancing is allowed for this node.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
isInstanced(indirect=True) -> bool
Returns True if this node is instanced.
"""
pass
def isInstancedAttribute(self, *args, **kwargs):
"""
isInstancedAttribute(attr) -> bool
Returns True if the specified attribute is an instanced attribute of this node.
"""
pass
@property
def isIntermediateObject(self, *args, **kwargs):
"""
True if this node is just an intermediate in part of a larger calculation (e.g. input to a deformer).
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
def isParamOnCurve(self, *args, **kwargs):
"""
isParamOnCurve(param) -> bool
Returns True if the given parameter value lies on the curve (i.e. is
within the curves knot domain), False otherwise.
* param (float) - parameter value to test
"""
pass
def isParentOf(self, *args, **kwargs):
"""
isParentOf(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
@property
def isPlanar(self, *args, **kwargs):
"""
True if the curve is planar.
"""
pass
def isPointOnCurve(self, *args, **kwargs):
"""
isPointOnCurve(point, tolerance=kPointTolerance, space=kObject) -> bool
Returns True if the given point lies on the curve, False otherwise.
* point (MPoint) - point to test.
* tolerance (float) - max distance point can be from the curve and
still be considered to lie on it.
* space (int) - an MSpace constant giving the coordinate space
in which the point is given
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
kClosed = 2
kExtensionAttr = 3
kInvalid = 0
kInvalidAttr = 4
kLast = 4
kLocalDynamicAttr = 1
kNextPos = 255
kNormalAttr = 2
kOpen = 1
kPeriodic = 3
def kPointTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
def knot(self, *args, **kwargs):
"""
knot(index) -> float
Returns the parameter value of a single knot.
* index (int) - index of the knot to return. These range from 0 to
(numKnots - 1)
"""
pass
@property
def knotDomain(self, *args, **kwargs):
"""
A tuple containing a pair of floats corresponding to the maximum and
minimum parameter values for this curve.
"""
pass
def knots(self, *args, **kwargs):
"""
knots() -> MDoubleArray
Returns the parameter values for all of the curves knots.
"""
pass
def length(self, *args, **kwargs):
"""
length(tolerance=kPointTolerance) -> float
Returns the arc length of this curve or 0.0 if it cannot be computed.
* tolerance (float) - max error allowed in the calculation.
"""
pass
def makeMultipleEndKnots(self, *args, **kwargs):
"""
makeMultipleEndKnots() -> self
Sets the curves end knots to have full multiplicity. This ensures
that the end points interpolate the first and last CVs (i.e. lie
directly on them). It can also be used to convert a periodic curve
to a closed curve.
"""
pass
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
def normal(self, *args, **kwargs):
"""
normal(param, space=kObject) -> MVector
Returns the normal at the given parameter value on the curve. For
degree 1 curves the normal is the vector at right angles to the
curve that lies in the average plane of the curve. For higher degrees
the normal is defined by the local curvature at the parameter.
* param (float) - parameter value at which to find the normal
* space (int) - an MSpace constant giving the coordinate space in
which the normal should be returned
"""
pass
@property
def numCVs(self, *args, **kwargs):
"""
Number of CVs in the curve or 0 if the number of CVs cannot be
determined.
"""
pass
@property
def numKnots(self, *args, **kwargs):
"""
Number of knots in the curve or 0 if the number of knots cannot be
determined.
"""
pass
@property
def numSpans(self, *args, **kwargs):
"""
Number of spans in the curve or 0 if the number of spans cannot be
determined.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def objectColor(self, *args, **kwargs):
"""
Index from 0 to 7 indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorRGB(self, *args, **kwargs):
"""
RGB value indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorType(self, *args, **kwargs):
"""
Determines whether the default color, indexed object color, orRGB object color is used for this object.
"""
pass
def parent(self, *args, **kwargs):
"""
parent(index) -> MObject
Returns the specified parent of this node.
"""
pass
def parentCount(self, *args, **kwargs):
"""
parentCount() -> int
Returns the number of parents this node has.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
partialPathName() -> string
Returns the minimum path string necessary to uniquely identify the attached object.
"""
pass
@property
def planeNormal(self, *args, **kwargs):
"""
MVector of the normal to the plane of the curve, if the curve is
planar, or None if the curve is not planar.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def removeChild(self, *args, **kwargs):
"""
removeChild(node) -> self
Removes the child, specified by MObject, reparenting it under the world.
"""
pass
def removeChildAt(self, *args, **kwargs):
"""
removeChildAt(index) -> self
Removes the child, specified by index, reparenting it under the world.
"""
pass
def removeKnot(self, *args, **kwargs):
"""
removeKnot(param, removeAll=False) -> self
Removes one or more knots at the given parameter value.
If there are multiple knots at the parameter value then removeAll
determines which ones will be removed. If it is True then they will
all be removed. If it is False then all but one will be removed.
* param (float) - parameter of the knot
* removeAll (bool) - how to handle multiple knots at the same param
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def reverse(self, *args, **kwargs):
"""
reverse() -> self
Reverses the direction of the curve.
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setCVPosition(self, *args, **kwargs):
"""
setCVPosition(index, point, space=kObject) -> self
Sets the position of a single control vertex of the curve.
* index (int) - index of the cv
* point (MPoint) - new position for the cv
* space (int) - an MSpace constant giving the coordinate space
in which the point is given
"""
pass
def setCVPositions(self, *args, **kwargs):
"""
setCVPositions(points, space=kObject) -> self
Sets the positions of all of the curves control vertices.
* points (MPointArray or seq of MPoint)
- the points to be set. The array/sequence must
contain exactly the same number of points as the
curve has control vertices.
* space (int) - an MSpace constant giving the coordinate space
in which the points are given
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setKnot(self, *args, **kwargs):
"""
setKnot(index, param) -> self
Sets the parameter value of a single knot.
* index (int) - index of the knot
* param (float) - new parameter value for the knot
"""
pass
def setKnots(self, *args, **kwargs):
"""
setKnots(params, startIndex, endIndex) -> self
Sets the parameter values of a contiguous group of knots.
* params (MDoubleArray of seq of float)
- the parameter values to set, one per knot in
the range
* startIndex (int) - first knot in the range to be set
* endIndex (int) - last knot in the range to be set
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(MObject or MDagPath) -> self
Attaches the function set to the specified node or DAG path.
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def tangent(self, *args, **kwargs):
"""
tangent(param, space=kObject) -> MVector
Returns the normalized tangent vector at the given parameter value
on the curve.
* param (float) - parameter value at which to find the tangent
* space (int) - an MSpace constant giving the coordinate space in
which the tangent should be returned
"""
pass
def transformationMatrix(self, *args, **kwargs):
"""
transformationMatrix() -> MMatrix
Returns the object space transformation matrix for this DAG node.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
def updateCurve(self, *args, **kwargs):
"""
updateCurve() -> self
Tells the shape node which represents the curve in the scene, if
any, that the curve has changed and needs to be redrawn.
"""
pass
@property
def useObjectColor(self, *args, **kwargs):
"""
If True then the node will be drawn using its objectColor, otherwise it will be drawn using Mayas default color. Thismethod is deprecated, use objectColorType instead.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
class MFnNurbsCurveData(MFnGeometryData):
"""
MFnNurbsCurveData allows the creation and manipulation of Nurbs Curve
data objects for use in the dependency graph.
__init__()
Initializes a new, empty MFnNurbsCurveData object
__init__(MObject)
Initializes a new MFnNurbsCurveData function set, attached
to the specified object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addObjectGroup(self, *args, **kwargs):
"""
addObjectGroup(id) -> self
Adds an object group with the given id to the object.
"""
pass
def addObjectGroupComponent(self, *args, **kwargs):
"""
addObjectGroupComponent(id, MObject component) -> self
Adds the members of the given component to the object group
with the given id.
"""
pass
def changeObjectGroupId(self, *args, **kwargs):
"""
changeObjectGroupId(sourceId, destId) -> self
Changes the id of the object group with the given id to the new id.
"""
pass
def copyObjectGroups(self, *args, **kwargs):
"""
copyObjectGroups(MObject inGeom) -> self
Copies the object groups from the given geometry data object.
"""
pass
def create(self, *args, **kwargs):
"""
create() -> MObject
Creates a new nurbs curve data object, attaches it to this function set
and returns an MObject which references it.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasObjectGroup(self, *args, **kwargs):
"""
hasObjectGroup(id) -> self
Returns True if an object group with the given id is
contained in the data.
"""
pass
@property
def isIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is the identity.
"""
pass
@property
def isNotIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is not the identity.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
@property
def matrix(self, *args, **kwargs):
"""
MMatrix used to convert the object into local space.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def objectGroup(self, *args, **kwargs):
"""
objectGroup(index) -> int
Returns the id of the indexth object group contained by the object.
"""
pass
def objectGroupComponent(self, *args, **kwargs):
"""
objectGroupComponent(id) -> MObject
Returns a component which contains the members of the object group
with the given id.
"""
pass
@property
def objectGroupCount(self, *args, **kwargs):
"""
The number of object groups contained by the object.
"""
pass
def objectGroupType(self, *args, **kwargs):
"""
objectGroupType(id) -> MFn Type constant
Returns the type of the component that the object group with the
given id contains.
"""
pass
def removeObjectGroup(self, *args, **kwargs):
"""
removeObjectGroup(id) -> self
Removes an object group with the given id from the object.
"""
pass
def removeObjectGroupComponent(self, *args, **kwargs):
"""
removeObjectGroupComponent(id, MObject component) -> self
Removes the members of the given component from the object group
with the given id.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setObjectGroupComponent(self, *args, **kwargs):
"""
setObjectGroupComponent(id, MObject component) -> self
Sets the members of the object group with the given id
to be only those in the given component.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnNurbsSurface(MFnDagNode):
"""
NURBS (Non-Uniform Rational B-Spline) surface function set.
The shape of a NURBS surface is defined by an array of CVs
(control vertices), an array of knot values in the U direction
and an array of knot values in the V direction, a degree in U
and in V, and a form in U and in V.
The U and V knot vectors for NURBS surfaces are of size
(spansInU + 2*degreeInU -1) and (spansInV + 2*degreeInV -1).
Note: spans = numCVs - degree.
There are 3 possible forms for the surface in the U and V
directions: open, closed and periodic. These forms are described
below. Note that the descriptions below apply to both the U and
V directions.
The open and closed forms are quite similar, and in fact a
closed surface will become an open surface if either the first
or last CV is moved so that they are no longer coincident. To
create an open or closed surface, of degree N, with M spans, you
must provide M+N CVs. This implies that for a degree N surface,
you must specify at least N+1 CVs to get a surface with a single
span.
The number of knots required for the surface is M + 2N - 1. If
you want the surface to start exactly at the first CV and end
exactly at the last CV, then the knot vector must be structured
to have degree N multiplicity at the beginning and end. This
means that the first N knots must be identical, and the last N
knots must be identical.
A periodic surface is a special case of a closed surface.
Instead of having just the first and last CVs coincident, the
last N CVs in the surface, where N is equal to the degree,
overlap the first N CVs. This results in a surface with no
tangent break where the ends meet. The last N CVs in a periodic
surface are permanently bound to the first N CVs, and Maya will
not allow those last N CVs to be repositioned. If one or more
of the first N CVs of the surface are repositioned, the
overlapping CVs will remain bound, and will also be moved.
In order to create a periodic surface, you must specify at least
2N+1 CVs, so that that last N can overlap the first N and you
still have 1 non-overlapping CV left. The number of CVs
required to create a periodic surface is still N+M (with a
lower limit of 2N+1), but you must ensure that the positions
of the last N CVs are identical to the positions of the
first N.
You still need M + 2N - 1 knots for a periodic surface, but
the knot values required are more restrictive than for open
or closed surfaces because of the overlap of the last N CVs.
The first N knots should be specified at the beginning of
the knot array as values { -(N-1), -(N-2), ... 0 } in order
to implement the overlap. Additionally there can be no knot
multiplicity at the end of the surface, because that would
compromise the tangent continuity property.
Note that some third party applications use a different
format for knots, where the number of knots required for a
surface is M+2N+1 rather than M+2N-1 as used in Maya. Both
knot representations are equivalent mathematically. To
convert from one of these external representations into the
Maya representation, simply omit the first and last knots
from the external representation when creating the Maya
representation. To convert from the Maya representation into
the external representation, add two new knots at the
beginning and end of the Maya knot sequence. The value of
these new knots depends on the existing knot sequence. For a
knot sequence with multiple end knots, simply duplicate the
existing first and last knots once more, for example:
Maya representation: {0,0,0,...,N,N,N}
External representation: {0,0,0,0,...,N,N,N,N}
For a knot sequence with uniform end knots, create the new
knots offset at an interval equal to the existing first and
last knot intervals, for example:
Maya representation: {0,1,2,...,N,N+1,N+2}
External representation: {-1,0,1,2,...,N,N+1,N+2,N+3}
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addChild(self, *args, **kwargs):
"""
addChild(node, index=kNextPos, keepExistingParents=False) -> self
Makes a node a child of this one.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def area(self, *args, **kwargs):
"""
area(space=kObject, tolerance=kPointTolerance) -> float
Returns the surfaces area, or 0.0 if the area cannot be determined.
"""
pass
def assignUV(self, *args, **kwargs):
"""
assignUV(patchId, cornerIndex, uvId) -> self
Maps a texture coordinate (uv) to a the specified corner of a patch.
Note that API methods that modify uv data will work correctly when
called through a plug-in node that is in the history of the shape,
or when used on a surface shape that does not have history.
Modifying uvs directly on a shape with history will result in the
modifications getting over-written by the next evaluation of the
history attached to the shape.
* patchId (int) - Patch to map to.
* cornerIndex (int) - Corner of the patch to map to.
* uvId (int) - Index into the uv list of the UV to map.
"""
pass
def assignUVs(self, *args, **kwargs):
"""
assignUVs(uvCounts, uvIds) -> self
Maps all texture coordinates for the surface. setUV() and setUVs()
are used to create the texture coordinate table for the surface.
After the table is created, this method is used to map those values
to each patch on a per-corner basis.
The uvCounts array should contain the number of uvs per patch.
Since uvs are mapped per-patch per-corner, the entries in this array
should match the corner counts for each patch in the surface.
If an entry in this array is 0 then the corresponding patch will
not be mapped.
The sum of all the entries in the uvCounts array must be equal to
the size of the uvIds array or this method will fail.
The uvIds array should contain the UV indices that will be mapped to
each patch-corner in the surface. The entries in this array specify
which uvs in the surfaces uv table are mapped to each patch-corner.
Each entry in the uvIds array must be less than numUVs().
The size of the uvIds array is equivalent to adding up all of the
entries in the uvCounts array, so for a cube with all patches mapped
there would be 24 entries.
Note that API methods that modify uv data will work correctly when
called through a plug-in node that is in the history of the shape,
or when used on a surface shape that does not have history.
Modifying uvs directly on a shape with history will result in the
modifications getting over-written by the next evaluation of the
history attached to the shape.
* uvCounts (MIntArray or seq of int)
- UV counts for each patch in the surface.
* uvIds (MIntArray or seq of int)
- UV indices to be mapped to each patch-corner.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
def boundaryType(self, *args, **kwargs):
"""
boundaryType(region, boundary) -> int
Returns the type of the specified boundary. The surface must be a
trimmed surface. Valid boundary types are:
kInner - an inner (clockwise) boundary
kOuter - an outser (counter clockwise) boundary
kSegment - a curve on a patch
kClosedSegment - a closed curve on a patch
kInvalidBoundary - an invalid boundary type
* region (int) - Region containing the boundary
* boundary (int) - Index of the boundary within the region.
"""
pass
@property
def boundingBox(self, *args, **kwargs):
"""
Nodes bounding box, in object space.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
def child(self, *args, **kwargs):
"""
child(index) -> MObject
Returns the specified child of this node.
"""
pass
def childCount(self, *args, **kwargs):
"""
childCount() -> int
Returns the number of nodes which are children of this one.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def clearUVs(self, *args, **kwargs):
"""
clearUVs() -> self
Clears out all texture coordinates for the nurbsSurface, and leaves
behind an empty UVset.
This method should be used if it is needed to shrink the size of the
UV table. In this case, the user should call clearUVs, setUVs and
then assignUVs to rebuild the mapping info.
When called on a dataNurbsSurface the UVs are removed. When called
on a shape with no history, the UVs are removed and the attributes
are set on the shape. When called on a shape with history, the
polyDelMap command is invoked and a polyMapDel node is created.
"""
pass
def closestPoint(self, *args, **kwargs):
"""
closestPoint(testPoint, uStart=None, vStart=None,
ignoreTrimBoundaries=False, tolerance=kPointTolerance,
space=kObject) -> (MPoint, float, float)
Returns the closest point on the surface to the specified test point
The return value is a tuple containing the position of the point and
and its U and V texture parameters.
Performance can be greatly increased by supplying starting U and V
parameter values which are reasonably close to the final point.
Specifying these values will invoke a special algorithm which will
begin to search for the closest point at the given parameter value,
and will check the local surface to see which direction will bring
it closer to the given point. It then offsets in this direction and
repeats the process, iteratively traversing the surface until it
finds the closest point.
This algorithm will fail if it encounters a seam before reaching
the closest point, or if it finds a local closest point, such as a
bulge on a mesh where an offset in any direction will take it
further from the given point, even if that is not the true closest
point on the mesh. For this reason it is advisable to avoid using
this option unless absolutely sure that the initial point will be
a good enough approximation to the final point that these
conditions will not occur.
* testPoint (MPoint) - Position of the point to be checked
* uStart (float) - Initial guess of a U parameter near where the
where the closest point is expected to be.
* vStart (float) - Initial guess of a V parameter near where the
where the closest point is expected to be.
* ignoreTrimBoundaries (bool)
- For trimmed surfaces, if this is true the
trim curves will be ignored and the entire
untrimmed surface searched.
* tolerance (float) - How close to the surface must a point be to
be considered on the surface.
* space (int) - an MSpace constant giving the coordinate
space which testPoint is in. The returned
point will be in the same space.
"""
pass
def copy(self, *args, **kwargs):
"""
copy(source, parent=kNullObj) -> MObject
Returns a new NURBS surface, which is a copy of the source surface,
and sets the functionset to operate on it.
* source (MObject)- The surface to copy.
* parent (MObject)- The parent/owner of the new surface. If its a
NURBS surface data wrapper (MFn.kNurbsSurfaceData)
then the created surface will be returned as a
geometry object (MFn.kNurbsSurfaceGeom) owned by
the wrapper. If parent is a DAG node then the
new surface will be returned as nurbsSurface node
parented under it. If parent is not provided
then a new top-level transform will be created
with the new surface parented beneath it as a
nurbsSurface node. In this last case it will be
the transform node which is returned.
"""
pass
def create(self, *args, **kwargs):
"""
create(cvs, uKnots, vKnots, uDegree, vDegree, uForm, vForm,
rational, parent=kNullObj) -> MObject
Returns a new NURBS surface created from the specified data and sets
the function set to operate on it.
* cvs (MPointArray or seq of MPoint)
- The control vertices.
* uKnots (MDoubleArray or seq of float)
- Parameter values for the knots in the U direction.
* vKnots (MDoubleArray or seq of float)
- Parameter values for the knots in the V direction.
* uDegree (int) - Degree of the basis functions in the U direction.
* vDegree (int) - Degree of the basis functions in the V direction.
* uForm (int) - A Form constant (kOpen, kClosed, kPeriodic) giving
the surfaces form in the U direction.
* vForm (int) - A Form constant (kOpen, kClosed, kPeriodic) giving
the surfaces form in the V direction.
* rational (bool) - Create as rational (True) or non-rational (False)
surface.
* parent (MObject)- The parent/owner of the new surface. If its a
NURBS surface data wrapper (MFn.kNurbsSurfaceData)
then the created surface will be returned as a
geometry object (MFn.kNurbsSurfaceGeom) owned by
the wrapper. If parent is a DAG node then the
new surface will be returned as nurbsSurface node
parented under it. If parent is not provided
then a new top-level transform will be created
with the new surface parented beneath it as a
nurbsSurface node. In this last case it will be
the transform node which is returned.
"""
pass
def cv(self, *args, **kwargs):
"""
cv(uIndex, vIndex) -> MObject
Returns a component for the specified control vertex.
* uIndex (int) - U index of the CV.
* vIndex (int) - V index of the CV.
"""
pass
def cvPosition(self, *args, **kwargs):
"""
cvPosition(uIndex, vIndex, space=kObject) -> MPoint
Returns the position of the specified control vertex.
* uIndex (int) - U index of the CV.
* vIndex (int) - V index of the CV.
* space (int) - an MSpace constant giving the coordinate
space which the point should be returned.
"""
pass
def cvPositions(self, *args, **kwargs):
"""
cvPositions(space=kObject) -> MPointArray
Returns the positions of all the surfaces control vertices.
* space (int) - an MSpace constant giving the coordinate
space which the points should be returned.
"""
pass
def cvsInU(self, *args, **kwargs):
"""
cvsInU(startUIndex, endUIndex, vIndex) -> MObject
Returns a component for a set of control vertices in the U direction.
* startUIndex (int) - U index of the first CV to return.
* endUIndex (int) - U index of the last CV to return.
* vIndex (int) - V index for all of the returned CVs.
"""
pass
def cvsInV(self, *args, **kwargs):
"""
cvsInV(startVIndex, endVIndex, uIndex) -> MObject
Returns a component for a set of control vertices in the V direction.
* startVIndex (int) - V index of the first CV to return.
* endVIndex (int) - V index of the last CV to return.
* uIndex (int) - U index for all of the returned CVs.
"""
pass
def dagPath(self, *args, **kwargs):
"""
dagPath() -> MDagPath
Returns the DAG path to which this function set is attached. Raises a TypeError if the function set is attached to an MObject rather than a path.
"""
pass
def dagRoot(self, *args, **kwargs):
"""
dagRoot() -> MObject
Returns the root node of the first path leading to this node.
"""
pass
@property
def dataObject(self, *args, **kwargs):
"""
If the functionset was created using an MFn.kNurbsSurfaceData object
then this attribute will contain an MObject which references that
data object. Otherwise it will contain MObject.kNullObj.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
@property
def degreeInU(self, *args, **kwargs):
"""
The degree of the surface in the U direction or 0 if the degree
cannot be determined.
"""
pass
@property
def degreeInV(self, *args, **kwargs):
"""
The degree of the surface in the V direction or 0 if the degree
cannot be determined.
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
def distanceToPoint(self, *args, **kwargs):
"""
distanceToPoint(point, space=kObject) -> float
Returns the distance from the given point to the closest point on
the surface.
* point (MPoint) - Point to calculate distance to.
* space (int) - An MSpace constant giving the coordinate space in
which the point has been specified.
"""
pass
def duplicate(self, *args, **kwargs):
"""
duplicate(instance=False, instanceLeaf=False) -> MObject
Duplicates the DAG hierarchy rooted at the current node.
"""
pass
def edge(self, *args, **kwargs):
"""
edge(region, boundary, edge, paramEdge=False) -> MObjectArray
Return the specified edge of a trim boundary.
For each region of a trimmed surface there may be several boundary
curves: an outer curve and possibly several inner boundary curves
(which define holes). These boundary curves are made up of one or
more curves called edges.
The edge is returned as an MObjectArray as it may consist of more
than one curve. The returned edge, or trim curve, can be a 2D parameter
edge or a 3D edge curve. Note that for closed surfaces some of the
3d edges may be 0 length in which case an empty MObjectArray is
returned. An example of this is the poles of a sphere.
* region (int) - Index of trimmed region containing the edge.
* boundary (int) - Index of boundary within trimmed region.
* edge (int) - Index of the edge within the boundary.
* paramEdge (bool) - If True a 2D parameter edge is returned,
otherwise a 3D edge is returned.
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
@property
def formInU(self, *args, **kwargs):
"""
Form of the surface in the U direction. Can be one of kOpen,
kClosed, kPeriodic or kInvalid.
"""
pass
@property
def formInV(self, *args, **kwargs):
"""
Form of the surface in the V direction. Can be one of kOpen,
kClosed, kPeriodic or kInvalid.
"""
pass
def fullPathName(self, *args, **kwargs):
"""
fullPathName() -> string
Returns the full path of the attached object, from the root of the DAG on down.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getAllPaths(self, *args, **kwargs):
"""
getAllPaths() -> MDagPathArray
Returns all of the DAG paths which lead to the object to which this function set is attached.
"""
pass
def getAssignedUVs(self, *args, **kwargs):
"""
getAssignedUVs() -> (MIntArray, MIntArray)
Returns the indices of all UVs which have been mapped to the surface.
The return value is a tuple with an array containing the number
of UVs for each patch in the surface, and a second array containing
the indices of the UVs mapped to each corner of those patches. This
is the same format as the arrays taken by the assignUVs() method.
"""
pass
def getConnectedSetsAndMembers(self, *args, **kwargs):
"""
getConnectedSetsAndMembers(instance, renderableSetsOnly) -> (MObjectArray, MObjectArray)
Returns a tuple containing an array of sets and an array of the
components of the DAG object which are in those sets. If the entire object is in a set, then the corresponding entry in the comps array will have no elements in it.
"""
pass
def getConnectedShaders(self, *args, **kwargs):
"""
getConnectedShaders(instanceNumber) -> (MObjectArray, MIntArray)
Returns a tuple containing an array of all the shaders (sets)
connected to the specified instance of this surface, and an array of
patch/shader assignments. The second array will hold, for each patch
in the surface, an index into the first array. If a patch does not
have a shader assigned to it, the value of the index will be -1.
The shader objects can be derived from the sets returned.
Note: This method will only work with a MFnNurbsSurface function set
which has been initialized with an MFn::kNurbsSurface.
See also getConnectedSetsAndMembers.
* instanceNumber (int) - Determines which instance of the surface to
query. This will be zero if there is only
one instance.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getDerivativesAtParam(self, *args, **kwargs):
"""
getDerivativesAtParam(uParam, vParam, space=kObject, secondOrder=False)
-> (MPoint, MVector, MVector)
-> (MPoint, MVector, MVector, MVector, MVector, MVector)
Evaluates the surface at the given (u,v) coordinates, returning a
tuple containing the position at that point, the first derivative
vector in U, and the first derivative vector in V. If secondOrder
is True then the tuple will also contain three additional vectors:
the second order partial derivative with respect to U (dUU), the
second order partial derivative with respect to V (dVV), and the
second order partial derivative with respect to U then V (dUV).
None of the vectors will be normalized.
* uParam (float) - U parameter value at which to do the evaluation.
* vParam (float) - V parameter value at which to do the evaluation.
* space (int) - An MSpace constant giving the coordinate space in
which to perform the calculation.
* secondOrder (bool)
- If True, second order derivatives will be included
in the result. Note that this will increase
computation time.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def getParamAtPoint(self, *args, **kwargs):
"""
getParamAtPoint(point, ignoreTrimBoundaries, tolerance=kPointTolerance,
space=kObject) -> (float, float)
Returns a tuple containing the parameter values corresponding to the
given point on the surface (or underlying surface).
* point (MPoint) - Location of the parameter to obtain.
* ignoreTrimBoundaries (bool)
- For trimmed surfaces, if this is true the
trim curves will be ignored and the entire
untrimmed surface searched.
* tolerance (float) - Accuracy to be used in the operation.
* space (int) - An MSpace constant giving the coordinate space
in which to perform the operation.
"""
pass
def getPatchUV(self, *args, **kwargs):
"""
getPatchUV(patchId, cornerIndex) -> (float, float)
Returns a tuple containing the texture texture coordinate for a
corner of a patch. Since texture coordinates (UVs) are stored
per-patch per-corner you must specify both the patch and the corner
that the u and v values are mapped to.
* patchId (int) - Patch of interest.
* cornerIndex (int) - Corner of interest.
"""
pass
def getPatchUVid(self, *args, **kwargs):
"""
getPatchUVid(patchId, cornerIndex) -> int
Returns the id of the texture coordinate for a single corner of a patch.
* patchId (int) - Patch of interest.
* cornerIndex (int) - Corner of interest.
"""
pass
def getPatchUVs(self, *args, **kwargs):
"""
getPatchUVs(patchId) -> (MFloatArray, MFloatArray)
Returns a tuple containing the values of the texture coordinates on
all corners of the specified patch. The tuple contains an array of U
coordinates and an array of V coordinates, both the same length.
* patchId (int) - Patch of interest.
"""
pass
def getPath(self, *args, **kwargs):
"""
getPath() -> MDagPath
Returns the DAG path to which this function set is attached, or the first path to the node if the function set is attached to an MObject.
"""
pass
def getPointAtParam(self, *args, **kwargs):
"""
getPointAtParam(uParam, vParam, space=kObject) -> MPoint
"""
pass
def getUV(self, *args, **kwargs):
"""
getUV(uvId) -> (float, float)
Returns a tuple containing the U and V values for the a texture coordinate
* uvId (int) - Id of the texture coordinate of intest.
"""
pass
def getUVs(self, *args, **kwargs):
"""
getUVs() -> (MFloatArray, MFloatArray)
Returns all of the surfaces texture coordinates as a tuple containing
an array of U values and an array of V values.
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasChild(self, *args, **kwargs):
"""
hasChild(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
@property
def hasHistoryOnCreate(self, *args, **kwargs):
"""
True if the surface was created with history.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasParent(self, *args, **kwargs):
"""
hasParent(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
@property
def inModel(self, *args, **kwargs):
"""
True if the node has been added to the model.
"""
pass
@property
def inUnderWorld(self, *args, **kwargs):
"""
True if this node is in the underworld of another node (e.g. a curve on surface is in the underworld of the surface).
"""
pass
def instanceCount(self, *args, **kwargs):
"""
instanceCount(indirect) -> int
Returns the number of instances for this node.
"""
pass
def intersect(self, *args, **kwargs):
"""
intersect(rayStart, rayDir, tolerance=kPointTolerance, space=kObject,
distance=False, exactHit=False, all=False)
-> (MPoint, float, float[, float][, bool])
-> (MPointArray, MDoubleArray, MDoubleArray[, MDoubleArray][, bool])
-> None
Returns the closest point of intersection of a ray with the surface
as a tuple containing the point of intersection and the U and V
parameters at that point.
* rayStart (MPoint) - Starting point for the ray.
* rayDir (MVector) - Direction of the ray
* tolerance (float) - Accuracy to be used in the operation.
* space (int) - An MSpace constant giving the coordinate space
in which to perform the operation.* distance (bool) - If True the distance from rayStart to the
point of intersection will be appended to the
returned tuple.
* exactHit (bool) - If True then a boolean value indicating if the
point of intersection was an exact hit will be
appended to the returned tuple.
* all (bool) - If True then all points of intersection will
be returned. In this case the point of
intersection, U and V parameters, and distance
(if requested) will all be returned as arrays.
"""
pass
@property
def isBezier(self, *args, **kwargs):
"""
True if the knot spacing gives a Bezier surface.
"""
pass
def isChildOf(self, *args, **kwargs):
"""
isChildOf(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
def isFlipNorm(self, *args, **kwargs):
"""
isFlipNorm(region) -> bool
Checks whether the normal for the specified region is flipped
This method is only valid for trimmed surfaces.
region (int) - Region to check.
"""
pass
@property
def isFoldedOnBispan(self, *args, **kwargs):
"""
True if surface contains are any folds or creases on bispan
boundaries, including trimmed regions.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isInstanceable(self, *args, **kwargs):
"""
True if instancing is allowed for this node.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
isInstanced(indirect=True) -> bool
Returns True if this node is instanced.
"""
pass
def isInstancedAttribute(self, *args, **kwargs):
"""
isInstancedAttribute(attr) -> bool
Returns True if the specified attribute is an instanced attribute of this node.
"""
pass
@property
def isIntermediateObject(self, *args, **kwargs):
"""
True if this node is just an intermediate in part of a larger calculation (e.g. input to a deformer).
"""
pass
def isKnotU(self, *args, **kwargs):
"""
isKnotU(param) -> bool
Checks if the specified parameter value is a knot value in the U
direction.
* param (float) - Parameter value to check.
"""
pass
def isKnotV(self, *args, **kwargs):
"""
isKnotV(param) -> bool
Checks if the specified parameter value is a knot value in the V
direction.
* param (float) - Parameter value to check.
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
def isParamOnSurface(self, *args, **kwargs):
"""
isParamOnSurface(uParam, vParam) -> bool
Checks if the specified parameter point is on this surface.
* uParam (float) - U parameter value.
* vParam (float) - V parameter value.
"""
pass
def isParentOf(self, *args, **kwargs):
"""
isParentOf(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
def isPointInTrimmedRegion(self, *args, **kwargs):
"""
isPointInTrimmedRegion(uParam, vParam) -> bool
Checks if the given point is in a trimmed away region of a trimmed
surface. A trimmed away region is the part of the surface that is
cut away as a result of a trim operation.
* uParam (float) - U parameter of the point to check.
* vParam (float) - V parameter of the point to check.
"""
pass
def isPointOnSurface(self, *args, **kwargs):
"""
isPointOnSurface(point, tolerance=kPointTolerance, space=kObject) -> bool
Checks if the given point is on this surface.
* point (MPoint) - Point to check.
* tolerance (float) - Accuracy to be used in the operation.
* space (int) - An MSpace constant giving the coordinate space
in which to perform the operation
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
@property
def isTrimmedSurface(self, *args, **kwargs):
"""
True if the surface is a trimmed surface.
"""
pass
@property
def isUniform(self, *args, **kwargs):
"""
True if the knot spacing is uniform.
"""
pass
kClosed = 2
kClosedSegment = 4
kExtensionAttr = 3
kInner = 2
kInvalid = 0
kInvalidAttr = 4
kInvalidBoundary = 0
kLast = 4
kLocalDynamicAttr = 1
kNextPos = 255
kNormalAttr = 2
kOpen = 1
kOuter = 1
kPeriodic = 3
def kPointTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
kSegment = 3
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
@property
def knotDomainInU(self, *args, **kwargs):
"""
A tuple containing a pair of floats corresponding to the maximum and
minimum U parameter values for this surface.
"""
pass
@property
def knotDomainInV(self, *args, **kwargs):
"""
A tuple containing a pair of floats corresponding to the maximum and
minimum V parameter values for this surface.
"""
pass
def knotInU(self, *args, **kwargs):
"""
knotInU(index) -> float
Returns the knot value at the specified U index. U knots are indexed
from 0 to numKnotsInU-1.
* index (int) - Index of the U knot to return.
"""
pass
def knotInV(self, *args, **kwargs):
"""
knotInV(index) -> float
Returns the knot value at the specified V index. V knots are indexed
from 0 to numKnotsInV-1.
* index (int) - Index of the V knot to return.
"""
pass
def knotsInU(self, *args, **kwargs):
"""
knotsInU() -> MDoubleArray
Returns all of the surfaces knots in the U direction.
"""
pass
def knotsInV(self, *args, **kwargs):
"""
knotsInV() -> MDoubleArray
Returns all of the surfaces knots in the V direction.
"""
pass
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
def normal(self, *args, **kwargs):
"""
normal(uParam, vParam, space=kObject) -> MVector
Returns the normal at the given parameter value on the surface.
* uParam (float) - U parameter at which to obtain normal.
* vParam (float) - V parameter at which to obtain normal.
* space (int) - An MSpace constant giving the coordinate space
in which to perform the operation
"""
pass
def numBoundaries(self, *args, **kwargs):
"""
numBoundaries(region) -> unsigned int
Returns the number of boundaries for the specified region. The
surface must be a trimmed surface.
For each region there may be several boundary curves, an outer curve
and possibly several inner boundary curves which define holes. These
boundary curves are made up of one or more curves called edges.
* region (int) - Region of interest.
"""
pass
@property
def numCVsInU(self, *args, **kwargs):
"""
Number of CVs in the surface in the U direction or 0 if the number
of CVs cannot be determined.
"""
pass
@property
def numCVsInV(self, *args, **kwargs):
"""
Number of CVs in the surface in the V direction or 0 if the number
of CVs cannot be determined.
"""
pass
def numEdges(self, *args, **kwargs):
"""
numEdges(region, boundary) -> unsigned int
Returns the number of edges for the specified trim boundary.
For each region there may be several boundary curves, an outer curve
and possibly several inner boundary curves which define holes. These
boundary curves are made up of one or more curves called edges.
* region (int) - Region of interest.
* boundary (int) - Boundary of interest
"""
pass
@property
def numKnotsInU(self, *args, **kwargs):
"""
Number of knots in the surface in the U direction or 0 if the number
of knots cannot be determined.
"""
pass
@property
def numKnotsInV(self, *args, **kwargs):
"""
Number of knots in the surface in the V direction or 0 if the number
of knots cannot be determined.
"""
pass
@property
def numNonZeroSpansInU(self, *args, **kwargs):
"""
Number of spans in the U direction which are non-zero (i.e. their
max param value is greater than their min param value).
"""
pass
@property
def numNonZeroSpansInV(self, *args, **kwargs):
"""
Number of spans in the V direction which are non-zero (i.e. their
max param value is greater than their min param value).
"""
pass
@property
def numPatches(self, *args, **kwargs):
"""
Number of non-zero patches on the surface.
"""
pass
@property
def numPatchesInU(self, *args, **kwargs):
"""
Number of non-zero patches in the U direction.
"""
pass
@property
def numPatchesInV(self, *args, **kwargs):
"""
Number of non-zero patches in the V direction.
"""
pass
@property
def numRegions(self, *args, **kwargs):
"""
Number of trimmed regions for this surface or 0 if the surface is
not a trimmed surface.
"""
pass
@property
def numSpansInU(self, *args, **kwargs):
"""
Number of spans in the U direction, including zero-length spans.
"""
pass
@property
def numSpansInV(self, *args, **kwargs):
"""
Number of spans in the V direction, including zero-length spans.
"""
pass
@property
def numUVs(self, *args, **kwargs):
"""
Number of texture (uv) coordinates for this surface. The uvs are
stored in a list which is referenced by patches requiring textures
on a per-patch per-patchCorner basis. This attribute contains the
number of elements in this list.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def objectColor(self, *args, **kwargs):
"""
Index from 0 to 7 indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorRGB(self, *args, **kwargs):
"""
RGB value indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorType(self, *args, **kwargs):
"""
Determines whether the default color, indexed object color, orRGB object color is used for this object.
"""
pass
def parent(self, *args, **kwargs):
"""
parent(index) -> MObject
Returns the specified parent of this node.
"""
pass
def parentCount(self, *args, **kwargs):
"""
parentCount() -> int
Returns the number of parents this node has.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
partialPathName() -> string
Returns the minimum path string necessary to uniquely identify the attached object.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def projectCurve(self, *args, **kwargs):
"""
projectCurve(curve[, direction], keepHistory=False) -> self
Projects the given curve onto the surface, creating a curve on surface.
* direction (MVector) - Direction of projection. If not supplied
then surface normals will be used.
* keepHistory (bool) - Determines whether the construction history
of the projection should be retained.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def removeChild(self, *args, **kwargs):
"""
removeChild(node) -> self
Removes the child, specified by MObject, reparenting it under the world.
"""
pass
def removeChildAt(self, *args, **kwargs):
"""
removeChildAt(index) -> self
Removes the child, specified by index, reparenting it under the world.
"""
pass
def removeKnotInU(self, *args, **kwargs):
"""
removeKnotInU(param, removeAll=False) -> self
Removes one or more U knots at the specified parameter value from
from the surface.
* param (float) - U parameter value of the knot to remove.
* removeAll (bool) - If True and there are multiple knots at the
parameter value then they will all be removed.
Otherwise, all but one will be removed.
"""
pass
def removeKnotInV(self, *args, **kwargs):
"""
removeKnotInV(param, removeAll=False) -> self
Removes one or more V knots at the specified parameter value from
from the surface.
* param (float) - V parameter value of the knot to remove.
* removeAll (bool) - If True and there are multiple knots at the
parameter value then they will all be removed.
Otherwise, all but one will be removed.
"""
pass
def removeOneKnotInU(self, *args, **kwargs):
"""
removeOneKnotInU(param) -> self
Removes one U knot at the specified parameter value. If there are
multiple knots at that the value the others are retained.
* param (float) - U parameter value of the knot to remove.
"""
pass
def removeOneKnotInV(self, *args, **kwargs):
"""
removeOneKnotInV(param) -> self
Removes one V knot at the specified parameter value. If there are
multiple knots at that the value the others are retained.
* param (float) - V parameter value of the knot to remove.
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setCVPosition(self, *args, **kwargs):
"""
setCVPosition(uIndex, vIndex, point, space=kObject) -> self
"""
pass
def setCVPositions(self, *args, **kwargs):
"""
setCVPositions(points, space=kObject) -> self
Set the positions of all of the surfaces CVs.
(numCVsInU * numCVsInV) points must be provided. Converting from
U and V indices to array indices is done by:
array index = numCVsInV * U index + V index
To keep this method as fast as possible, no checking of the data is
performed beyond ensuring that the total number of CVs passed in is
correct. It is up to the caller to ensure that the CVs provide a
valid surface, for example by ensuring that overlapping CVs in
periodic surfaces have the same positions.
* points (MPointArray or seq of MPoint)
- Positions of the CVs.
* space (int) - An MSpace constant giving the coordinate space
in which to perform the operation
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setKnotInU(self, *args, **kwargs):
"""
setKnotInU(index, param) -> self
Sets the value of an existing U knot. U knots are indexed from 0 to
numKnotsInU-1. Note that this method does not insert a new knot, it
simply changes the value of an existing knot.
If a knot value is set that breaks the non-decreasing requirement
for the knot array, the knot value will be changed and an exception
raised.
* index (int) - U index of the knot to set.
* param (float) - New parameter value for the knot.
"""
pass
def setKnotInV(self, *args, **kwargs):
"""
setKnotInV(index, param) -> self
Sets the value of an existing V knot. V knots are indexed from 0 to
numKnotsInV-1. Note that this method does not insert a new knot, it
simply changes the value of an existing knot.
If a knot value is set that breaks the non-decreasing requirement
for the knot array, the knot value will be changed and an exception
raised.
* index (int) - V index of the knot to set.
* param (float) - New parameter value for the knot.
"""
pass
def setKnotsInU(self, *args, **kwargs):
"""
setKnotsInU(params, startIndex, endIndex) -> self
Sets the values of a range of U knots.
* params (MDoubleArray or seq of float)
- Parameter values to set at the knots. One value
per knot in the range.
* startIndex (int) - Index of the first U knot to set.
* endIndex (int) - Index of the last U knot to set.
"""
pass
def setKnotsInV(self, *args, **kwargs):
"""
setKnotsInV(params, startIndex, endIndex) -> self
Sets the values of a range of V knots.
* params (MDoubleArray or seq of float)
- Parameter values to set at the knots. One value
per knot in the range.
* startIndex (int) - Index of the first V knot to set.
* endIndex (int) - Index of the last V knot to set.
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(MObject or MDagPath) -> self
Attaches the function set to the specified node or DAG path.
"""
pass
def setUV(self, *args, **kwargs):
"""
setUV(uvId, u, v) -> self
Sets a single texture coordinate. If uvId is greater than or equal
to numUVs then the surfaces uv list will be grown to accommodate it.
Note that API methods that modify uv data work correctly either when
called through a plug-in node that is in the history of the shape,
or when used on a surface shape that does not have history.
Modifying uvs directly on a shape with history will result in the
modifications getting over-written by the next evaluation of the
history attached to the shape.
* uvId (int) - Index of the element in the surfaces uv list to set.
* u (float) - U value to set the uv to.
* v (float) - V value to set the uv to.
"""
pass
def setUVs(self, *args, **kwargs):
"""
setUVs(uList, vList) -> self
Sets all of the texture coordinates (uvs) for this surface. The
arrays must be of equal length and must be at least of length numUVs.
If the arrays are larger than numUVs then the uv list for this surface
will be grown to accommodate the new uv values.
After using this method to set the UV values, you can call
assignUVs to assign the corresponding UVids to the geometry.
Note that API methods that modify uv data work correctly either when
called through a plug-in node that is in the history of the shape,
or when used on a surface shape that does not have history.
Modifying uvs directly on a shape with history will result in the
modifications getting over-written by the next evaluation of the
history attached to the shape.
* uList (MFloatArray or seq of float) - U values to set
* vList (MFloatArray or seq of float) - V values to set
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def tangents(self, *args, **kwargs):
"""
tangents(uParam, vParam, space=kObject) -> (MVector, MVector)
Returns the tangents in the U and V directions at a given parameter
value on the surface. The returned tangent vectors are normalized.
This method does not fail if the given parameter lies within a
trimmed away region of a trimmed surface. Use isPointInTrimmedRegion()
to determine if the uv point lies within such a region.
* uParam (float) - U parameter value at which to obtain the tangents.
* vParam (float) - V parameter value at which to obtain the tangents.
* space (int) - An MSpace constant giving the coordinate space
in which to perform the operation
"""
pass
def transformationMatrix(self, *args, **kwargs):
"""
transformationMatrix() -> MMatrix
Returns the object space transformation matrix for this DAG node.
"""
pass
def trim(self, *args, **kwargs):
"""
trim(regionsToKeepU, regionsToKeepV, keepHistory=False) -> self
Trims the surface to its curves on surface. Regions which are kept
are specified by passing in arrays of u,v parameters.
This method will create a new trimmed surface in the DAG. The surface
attached to this function set will remain unchanged.
* regionsToKeepU (MDoubleArray or seq of float)
- U parameters of points within the regions
to be kept.
* regionsToKeepV (MDoubleArray or seq of float)
- V parameters of points within the regions
to be kept.
* keepHistory (bool) - Determines whether the construction history
of the operation should be retained.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
Signals that this surface has changed and needs to be recalculated.
This method is useful when a large number of CVs for the surface are
being modified. Instead of updating the surface every time a CV is
changed it is more efficient to call this method once after all the
updates are complete.
"""
pass
@property
def useObjectColor(self, *args, **kwargs):
"""
If True then the node will be drawn using its objectColor, otherwise it will be drawn using Mayas default color. Thismethod is deprecated, use objectColorType instead.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
class MFnNurbsSurfaceData(MFnGeometryData):
"""
MFnNurbsSurfaceData allows the creation and manipulation of Nurbs Surface
data objects for use in the dependency graph.
__init__()
Initializes a new, empty MFnNurbsSurfaceData object
__init__(MObject)
Initializes a new MFnNurbsSurfaceData function set, attached
to the specified object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addObjectGroup(self, *args, **kwargs):
"""
addObjectGroup(id) -> self
Adds an object group with the given id to the object.
"""
pass
def addObjectGroupComponent(self, *args, **kwargs):
"""
addObjectGroupComponent(id, MObject component) -> self
Adds the members of the given component to the object group
with the given id.
"""
pass
def changeObjectGroupId(self, *args, **kwargs):
"""
changeObjectGroupId(sourceId, destId) -> self
Changes the id of the object group with the given id to the new id.
"""
pass
def copyObjectGroups(self, *args, **kwargs):
"""
copyObjectGroups(MObject inGeom) -> self
Copies the object groups from the given geometry data object.
"""
pass
def create(self, *args, **kwargs):
"""
create() -> MObject
Creates a new nurbs surface data object, attaches it to this function set
and returns an MObject which references it.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasObjectGroup(self, *args, **kwargs):
"""
hasObjectGroup(id) -> self
Returns True if an object group with the given id is
contained in the data.
"""
pass
@property
def isIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is the identity.
"""
pass
@property
def isNotIdentity(self, *args, **kwargs):
"""
True if the matrix for the geometry is not the identity.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
@property
def matrix(self, *args, **kwargs):
"""
MMatrix used to convert the object into local space.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def objectGroup(self, *args, **kwargs):
"""
objectGroup(index) -> int
Returns the id of the indexth object group contained by the object.
"""
pass
def objectGroupComponent(self, *args, **kwargs):
"""
objectGroupComponent(id) -> MObject
Returns a component which contains the members of the object group
with the given id.
"""
pass
@property
def objectGroupCount(self, *args, **kwargs):
"""
The number of object groups contained by the object.
"""
pass
def objectGroupType(self, *args, **kwargs):
"""
objectGroupType(id) -> MFn Type constant
Returns the type of the component that the object group with the
given id contains.
"""
pass
def removeObjectGroup(self, *args, **kwargs):
"""
removeObjectGroup(id) -> self
Removes an object group with the given id from the object.
"""
pass
def removeObjectGroupComponent(self, *args, **kwargs):
"""
removeObjectGroupComponent(id, MObject component) -> self
Removes the members of the given component from the object group
with the given id.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setObjectGroupComponent(self, *args, **kwargs):
"""
setObjectGroupComponent(id, MObject component) -> self
Sets the members of the object group with the given id
to be only those in the given component.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnPlugin(MFnBase):
"""
Register and deregister plug-in services with Maya.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def apiVersion(self, *args, **kwargs):
"""
Return the API version required by the plug-in.
"""
pass
def deregisterAttributePatternFactory(self, *args, **kwargs):
"""
Deregister a user defined attribute pattern factory type from Maya.
"""
pass
def deregisterCommand(self, *args, **kwargs):
"""
Deregister a user defined command from Maya.
"""
pass
def deregisterData(self, *args, **kwargs):
"""
Deregister a user defined data type from Maya.
"""
pass
def deregisterNode(self, *args, **kwargs):
"""
Deregister a user defined dependency node from Maya.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def loadPath(self, *args, **kwargs):
"""
Return the full path name of the file from which the plug-in was loaded.
"""
pass
def name(self, *args, **kwargs):
"""
Return the plug-ins name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def registerAttributePatternFactory(self, *args, **kwargs):
"""
Register a new attribute pattern factory type with Maya.
"""
pass
def registerCommand(self, *args, **kwargs):
"""
Register a new command with Maya.
"""
pass
def registerData(self, *args, **kwargs):
"""
Register a new data type with Maya.
"""
pass
def registerNode(self, *args, **kwargs):
"""
Register a new dependency node with Maya.
"""
pass
def registerShape(self, *args, **kwargs):
"""
Register a new user defined shape node with Maya.
To deregister the shape node use the MFnPlugin.deregisterNode().
"""
pass
def setName(self, *args, **kwargs):
"""
Set the plug-ins name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def vendor(self, *args, **kwargs):
"""
Return the plug-ins vendor string.
"""
pass
@property
def version(self, *args, **kwargs):
"""
Plug-in version string.
"""
pass
class MFnPluginData(MFnData):
"""
MFnPluginData allows the creation and manipulation of plugin
data objects for use in the dependency graph.
__init__()
Initializes a new, empty MFnPluginData object
__init__(MObject)
Initializes a new MFnPluginData function set, attached
to the specified object.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def create(self, *args, **kwargs):
"""
create(id) -> MObject
Create an instance of the specified user defined data type and attach it to this functionset.
* id (MTypeId) - the unique MTypeId of the user defined data class derived from MPxData.
"""
pass
def data(self, *args, **kwargs):
"""
data() -> MPxData
Return the user defined data held in this instance
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def typeId(self, *args, **kwargs):
"""
typeId() -> MTypeId
Return the unique MTypeId of the user defined data that is held by this instance
"""
pass
class MFnPointArrayData(MFnData):
"""
Function set for node data consisting of an array of MPoints.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as an MPointArray.
"""
pass
def copyTo(self, *args, **kwargs):
"""
Replaces the elements of an array with those in the encapsulated array.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new MPoint array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnSingleIndexedComponent(MFnComponent):
"""
This function set allows you to create, edit, and query single indexed components.
Single indexed components store 1 dimensional index values.
__init__()
Initializes a new, empty MFnSingleIndexedComponent object
__init__(MObject component)
Initializes a new MFnSingleIndexedComponent function set, attached to the specified component.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addElement(self, *args, **kwargs):
"""
addElement(int element) -> self
Adds the specified element to the component.
"""
pass
def addElements(self, *args, **kwargs):
"""
addElements([int]) -> self
addElements(MIntArray) -> self
Adds the specified elements to the component.
"""
pass
@property
def componentType(self, *args, **kwargs):
"""
Type of the component. (MFn Type constant)
"""
pass
def create(self, *args, **kwargs):
"""
create(MFn Type constant) -> MObject
Creates a new, empty component, attaches it to the function set and
returns an MObject which references it.
"""
pass
def element(self, *args, **kwargs):
"""
element(index) -> int
Returns the indexth element of the component.
"""
pass
@property
def elementCount(self, *args, **kwargs):
"""
Number of elements in the component.
"""
pass
@property
def elementMax(self, *args, **kwargs):
"""
Biggest element plus 1 in the component.
"""
pass
def getCompleteData(self, *args, **kwargs):
"""
getCompleteData() -> int
Returns the number of elements in the complete component, or 0 if the component is not complete.
"""
pass
def getElements(self, *args, **kwargs):
"""
getElements() -> MIntArray
Returns all of the components elements.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hasWeights(self, *args, **kwargs):
"""
True if the component has weights associated with its elements.
"""
pass
@property
def isComplete(self, *args, **kwargs):
"""
Marking a component as complete means that it represents a full set
of indices from 0 to elementCount-1
"""
pass
@property
def isEmpty(self, *args, **kwargs):
"""
True if the component contains no elements.
"""
pass
def isEqual(self, *args, **kwargs):
"""
isEqual(MObject other) -> bool
Returns True if other refers to the same component as the
one to which the function set is currently attached.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setCompleteData(self, *args, **kwargs):
"""
setCompleteData(numElements) -> self
Marks the component as complete (i.e. contains all possible elements).
numElements indicates the number of elements in the complete component.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def weight(self, *args, **kwargs):
"""
weight(index) -> MWeight
Returns the weight associated with the specified element,
where index can range from 0 to elementCount-1.
"""
pass
class MFnStringArrayData(MFnData):
"""
Function set for node data consisting of an array of string.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as a list of unicode objects.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new string array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnStringData(MFnData):
"""
Function set for string node data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new string data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets the value of the encapsulated string.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def string(self, *args, **kwargs):
"""
Returns the encapsulated string as a unicode object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnTransform(MFnDagNode):
"""
Function set for operating on transform nodes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
Adds a new dynamic attribute to the node.
"""
pass
def addChild(self, *args, **kwargs):
"""
addChild(node, index=kNextPos, keepExistingParents=False) -> self
Makes a node a child of this one.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
Adds content info to the specified table from a file path attribute.
"""
pass
def allocateFlag(self, *args, **kwargs):
"""
Allocates a flag on all nodes for use by the named plugin and returns the flags index.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns an attribute of the node, given either its index or name.
"""
pass
def attributeClass(self, *args, **kwargs):
"""
Returns the class of the specified attribute.
"""
pass
def attributeCount(self, *args, **kwargs):
"""
Returns the number of attributes on the node.
"""
pass
@property
def boundingBox(self, *args, **kwargs):
"""
Nodes bounding box, in object space.
"""
pass
def canBeWritten(self, *args, **kwargs):
"""
Returns true if the node will be written to file.
"""
pass
def child(self, *args, **kwargs):
"""
child(index) -> MObject
Returns the specified child of this node.
"""
pass
def childCount(self, *args, **kwargs):
"""
childCount() -> int
Returns the number of nodes which are children of this one.
"""
pass
def classification(self, *args, **kwargs):
"""
Returns the classification string for the named node type.
"""
pass
def clearRestPosition(self, *args, **kwargs):
"""
Clears the transforms rest position matrix.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new transform node and attaches it to the function set.
"""
pass
def dagPath(self, *args, **kwargs):
"""
dagPath() -> MDagPath
Returns the DAG path to which this function set is attached. Raises a TypeError if the function set is attached to an MObject rather than a path.
"""
pass
def dagRoot(self, *args, **kwargs):
"""
dagRoot() -> MObject
Returns the root node of the first path leading to this node.
"""
pass
def deallocateAllFlags(self, *args, **kwargs):
"""
Deallocates all node flags which are currently allocated to the named plugin.
"""
pass
def deallocateFlag(self, *args, **kwargs):
"""
Deallocates the specified node flag, which was previously allocated by the named plugin using allocateFlag().
"""
pass
def dgCallbackIds(self, *args, **kwargs):
"""
Returns DG timing information for a specific callback type, broken down by callbackId.
"""
pass
def dgCallbacks(self, *args, **kwargs):
"""
Returns DG timing information broken down by callback type.
"""
pass
def dgTimer(self, *args, **kwargs):
"""
Returns a specific DG timer metric for a given timer type.
"""
pass
def dgTimerOff(self, *args, **kwargs):
"""
Turns DG timing off for this node.
"""
pass
def dgTimerOn(self, *args, **kwargs):
"""
Turns DG timing on for this node.
"""
pass
def dgTimerQueryState(self, *args, **kwargs):
"""
Returns the current DG timer state for this node.
"""
pass
def dgTimerReset(self, *args, **kwargs):
"""
Resets all DG timers for this node.
"""
pass
def duplicate(self, *args, **kwargs):
"""
duplicate(instance=False, instanceLeaf=False) -> MObject
Duplicates the DAG hierarchy rooted at the current node.
"""
pass
def enableLimit(self, *args, **kwargs):
"""
Enables or disables a specified limit type.
"""
pass
def findAlias(self, *args, **kwargs):
"""
Returns the attribute which has the given alias.
"""
pass
def findPlug(self, *args, **kwargs):
"""
Returns a plug for the given attribute.
"""
pass
def fullPathName(self, *args, **kwargs):
"""
fullPathName() -> string
Returns the full path of the attached object, from the root of the DAG on down.
"""
pass
def getAffectedAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which are affected by the specified attribute.
"""
pass
def getAffectingAttributes(self, *args, **kwargs):
"""
Returns all of the attributes which affect the specified attribute.
"""
pass
def getAliasAttr(self, *args, **kwargs):
"""
Returns the nodes alias attribute, which is a special attribute used to store information about the nodes attribute aliases.
"""
pass
def getAliasList(self, *args, **kwargs):
"""
Returns all of the nodes attribute aliases.
"""
pass
def getAllPaths(self, *args, **kwargs):
"""
getAllPaths() -> MDagPathArray
Returns all of the DAG paths which lead to the object to which this function set is attached.
"""
pass
def getConnectedSetsAndMembers(self, *args, **kwargs):
"""
getConnectedSetsAndMembers(instance, renderableSetsOnly) -> (MObjectArray, MObjectArray)
Returns a tuple containing an array of sets and an array of the
components of the DAG object which are in those sets. If the entire object is in a set, then the corresponding entry in the comps array will have no elements in it.
"""
pass
def getConnections(self, *args, **kwargs):
"""
Returns all the plugs which are connected to attributes of this node.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
Gets the external content (files) that this node depends on.
"""
pass
def getPath(self, *args, **kwargs):
"""
getPath() -> MDagPath
Returns the DAG path to which this function set is attached, or the first path to the node if the function set is attached to an MObject.
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node has an attribute with the given name.
"""
pass
def hasChild(self, *args, **kwargs):
"""
hasChild(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasParent(self, *args, **kwargs):
"""
hasParent(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
def hasUniqueName(self, *args, **kwargs):
"""
Returns True if the nodes name is unique.
"""
pass
@property
def inModel(self, *args, **kwargs):
"""
True if the node has been added to the model.
"""
pass
@property
def inUnderWorld(self, *args, **kwargs):
"""
True if this node is in the underworld of another node (e.g. a curve on surface is in the underworld of the surface).
"""
pass
def instanceCount(self, *args, **kwargs):
"""
instanceCount(indirect) -> int
Returns the number of instances for this node.
"""
pass
def isChildOf(self, *args, **kwargs):
"""
isChildOf(node) -> bool
Returns True if the specified node is a parent of this one.
"""
pass
@property
def isDefaultNode(self, *args, **kwargs):
"""
True if this is a default node, created automatically by Maya.
"""
pass
def isFlagSet(self, *args, **kwargs):
"""
Returns the state of the specified node flag.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if the node is from a referenced file, False if the node is part of the main scene.
"""
pass
@property
def isInstanceable(self, *args, **kwargs):
"""
True if instancing is allowed for this node.
"""
pass
def isInstanced(self, *args, **kwargs):
"""
isInstanced(indirect=True) -> bool
Returns True if this node is instanced.
"""
pass
def isInstancedAttribute(self, *args, **kwargs):
"""
isInstancedAttribute(attr) -> bool
Returns True if the specified attribute is an instanced attribute of this node.
"""
pass
@property
def isIntermediateObject(self, *args, **kwargs):
"""
True if this node is just an intermediate in part of a larger calculation (e.g. input to a deformer).
"""
pass
def isLimited(self, *args, **kwargs):
"""
Returns True if the specified limit type is enabled.
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if the node is locked against changes.
"""
pass
def isNewAttribute(self, *args, **kwargs):
"""
Returns True if the specified attribute was added in the current scene, and not by by one of its referenced files.
"""
pass
def isParentOf(self, *args, **kwargs):
"""
isParentOf(node) -> bool
Returns True if the specified node is a child of this one.
"""
pass
@property
def isShared(self, *args, **kwargs):
"""
True if the node is shared.
"""
pass
def isTrackingEdits(self, *args, **kwargs):
"""
Returns True if the node is referenced or in an assembly that is tracking edits.
"""
pass
kExtensionAttr = 3
kInvalidAttr = 4
kLocalDynamicAttr = 1
kNextPos = 255
kNormalAttr = 2
kRotateMaxX = 13
kRotateMaxY = 15
kRotateMaxZ = 17
kRotateMinX = 12
kRotateMinY = 14
kRotateMinZ = 16
kScaleMaxX = 1
kScaleMaxY = 3
kScaleMaxZ = 5
kScaleMinX = 0
kScaleMinY = 2
kScaleMinZ = 4
kShearMaxXY = 7
kShearMaxXZ = 9
kShearMaxYZ = 11
kShearMinXY = 6
kShearMinXZ = 8
kShearMinYZ = 10
kTimerInvalidState = 3
kTimerMetric_callback = 0
kTimerMetric_callbackNotViaAPI = 6
kTimerMetric_callbackViaAPI = 5
kTimerMetric_compute = 1
kTimerMetric_computeDuringCallback = 7
kTimerMetric_computeNotDuringCallback = 8
kTimerMetric_dirty = 2
kTimerMetric_draw = 3
kTimerMetric_fetch = 4
kTimerMetrics = 9
kTimerOff = 0
kTimerOn = 1
kTimerType_count = 2
kTimerType_inclusive = 1
kTimerType_self = 0
kTimerTypes = 3
kTimerUninitialized = 2
kTranslateMaxX = 19
kTranslateMaxY = 21
kTranslateMaxZ = 23
kTranslateMinX = 18
kTranslateMinY = 20
kTranslateMinZ = 22
def limitValue(self, *args, **kwargs):
"""
Returns the value of the specified limit.
"""
pass
def name(self, *args, **kwargs):
"""
Returns the nodes name.
"""
pass
@property
def namespace(self, *args, **kwargs):
"""
Name of the namespace which contains the node.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def objectColor(self, *args, **kwargs):
"""
Index from 0 to 7 indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorRGB(self, *args, **kwargs):
"""
RGB value indicating the color in which the node is to be drawn when inactive, assuming that it is drawable.
"""
pass
@property
def objectColorType(self, *args, **kwargs):
"""
Determines whether the default color, indexed object color, orRGB object color is used for this object.
"""
pass
def parent(self, *args, **kwargs):
"""
parent(index) -> MObject
Returns the specified parent of this node.
"""
pass
def parentCount(self, *args, **kwargs):
"""
parentCount() -> int
Returns the number of parents this node has.
"""
pass
def partialPathName(self, *args, **kwargs):
"""
partialPathName() -> string
Returns the minimum path string necessary to uniquely identify the attached object.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
Name of the plugin which registered the node type, if any.
"""
pass
def plugsAlias(self, *args, **kwargs):
"""
Returns the alias for a plugs attribute.
"""
pass
def removeAttribute(self, *args, **kwargs):
"""
Removes a dynamic attribute from the node.
"""
pass
def removeChild(self, *args, **kwargs):
"""
removeChild(node) -> self
Removes the child, specified by MObject, reparenting it under the world.
"""
pass
def removeChildAt(self, *args, **kwargs):
"""
removeChildAt(index) -> self
Removes the child, specified by index, reparenting it under the world.
"""
pass
def reorderedAttribute(self, *args, **kwargs):
"""
Returns one of the nodes attribute, based on the order in which they are written to file.
"""
pass
def resetFromRestPosition(self, *args, **kwargs):
"""
Resets the transform from its rest position matrix.
"""
pass
def restPosition(self, *args, **kwargs):
"""
Returns the transforms rest position matrix.
"""
pass
def rotateBy(self, *args, **kwargs):
"""
Adds an MEulerRotation or MQuaternion to the transforms rotation.
"""
pass
def rotateByComponents(self, *args, **kwargs):
"""
Adds to the transforms rotation using the individual components of an MEulerRotation or MQuaternion.
"""
pass
def rotateOrientation(self, *args, **kwargs):
"""
Returns the MQuaternion which orients the local rotation space.
"""
pass
def rotatePivot(self, *args, **kwargs):
"""
Returns the transforms rotate pivot.
"""
pass
def rotatePivotTranslation(self, *args, **kwargs):
"""
Returns the transforms rotate pivot translation.
"""
pass
def rotation(self, *args, **kwargs):
"""
Returns the transforms rotation as an MEulerRotation or MQuaternion.
"""
pass
def rotationComponents(self, *args, **kwargs):
"""
Returns the transforms rotation as the individual components of an MEulerRotation or MQuaternion.
"""
pass
def rotationOrder(self, *args, **kwargs):
"""
Returns the order of rotations when the transforms rotation is expressed as an MEulerRotation.
"""
pass
def scale(self, *args, **kwargs):
"""
Returns a list containing the transforms XYZ scale components.
"""
pass
def scaleBy(self, *args, **kwargs):
"""
Multiplies the transforms XYZ scale components by a sequence of three floats.
"""
pass
def scalePivot(self, *args, **kwargs):
"""
Returns the transforms scale pivot.
"""
pass
def scalePivotTranslation(self, *args, **kwargs):
"""
Returns the transforms scale pivot translation.
"""
pass
def setAlias(self, *args, **kwargs):
"""
Adds or removes an attribute alias.
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
Used to prevent the node from being written to file.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
Changes the location of external content.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
Sets content info in the specified attribute from the table.
"""
pass
def setFlag(self, *args, **kwargs):
"""
Sets the state of the specified node flag.
"""
pass
def setLimit(self, *args, **kwargs):
"""
Sets the value of the specified limit.
"""
pass
def setName(self, *args, **kwargs):
"""
Sets the nodes name.
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(MObject or MDagPath) -> self
Attaches the function set to the specified node or DAG path.
"""
pass
def setRestPosition(self, *args, **kwargs):
"""
Sets the transforms rest position matrix.
"""
pass
def setRotateOrientation(self, *args, **kwargs):
"""
Sets the MQuaternion which orients the local rotation space.
"""
pass
def setRotatePivot(self, *args, **kwargs):
"""
Sets the transforms rotate pivot.
"""
pass
def setRotatePivotTranslation(self, *args, **kwargs):
"""
Sets the transforms rotate pivot translation.
"""
pass
def setRotation(self, *args, **kwargs):
"""
Sets the transforms rotation using an MEulerRotation or MQuaternion.
"""
pass
def setRotationComponents(self, *args, **kwargs):
"""
Sets the transforms rotation using the individual components of an MEulerRotation or MQuaternion.
"""
pass
def setRotationOrder(self, *args, **kwargs):
"""
Sets the transforms rotation order.
"""
pass
def setScale(self, *args, **kwargs):
"""
Sets the transforms scale components.
"""
pass
def setScalePivot(self, *args, **kwargs):
"""
Sets the transforms scale pivot.
"""
pass
def setScalePivotTranslation(self, *args, **kwargs):
"""
Sets the transforms scale pivot translation.
"""
pass
def setShear(self, *args, **kwargs):
"""
Sets the transforms shear.
"""
pass
def setTransformation(self, *args, **kwargs):
"""
Sets the transforms attribute values to represent the given transformation matrix.
"""
pass
def setTranslation(self, *args, **kwargs):
"""
Sets the transforms translation.
"""
pass
def setUuid(self, *args, **kwargs):
"""
Sets the nodes UUID.
"""
pass
def shear(self, *args, **kwargs):
"""
Returns a list containing the transforms shear components.
"""
pass
def shearBy(self, *args, **kwargs):
"""
Multiplies the transforms shear components by a sequence of three floats.
"""
pass
def transformation(self, *args, **kwargs):
"""
Returns the transformation matrix represented by this transform.
"""
pass
def transformationMatrix(self, *args, **kwargs):
"""
transformationMatrix() -> MMatrix
Returns the object space transformation matrix for this DAG node.
"""
pass
def translateBy(self, *args, **kwargs):
"""
Adds an MVector to the transforms translation.
"""
pass
def translation(self, *args, **kwargs):
"""
Returns the transforms translation as an MVector.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
MTypeId for the nodes type.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the nodes type.
"""
pass
@property
def useObjectColor(self, *args, **kwargs):
"""
If True then the node will be drawn using its objectColor, otherwise it will be drawn using Mayas default color. Thismethod is deprecated, use objectColorType instead.
"""
pass
def userNode(self, *args, **kwargs):
"""
Returns the MPxNode object for a plugin node.
"""
pass
def uuid(self, *args, **kwargs):
"""
Returns the nodes UUID.
"""
pass
class MFnTripleIndexedComponent(MFnComponent):
"""
This function set allows you to create, edit, and query triple indexed
components. Triple indexed components store 3 dimensional index values.
__init__()
Initializes a new, empty MFnTripleIndexedComponent object
__init__(MObject component)
Initializes a new MFnTripleIndexedComponent function set, attached
to the specified component.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addElement(self, *args, **kwargs):
"""
addElement(sIndex, tIndex, uIndex) -> self
addElement([sIndex, tIndex, uIndex]) -> self
Adds the element identified by (sIndex, tIndex, uIndex) to the component.
"""
pass
def addElements(self, *args, **kwargs):
"""
addElements(sequence of [sIndex, tIndex, uIndex]) -> self
Adds the specified elements to the component. Each item in the
elements sequence is itself a sequence of three ints which are the
S, T and U indices of an element to be added.
"""
pass
@property
def componentType(self, *args, **kwargs):
"""
Type of the component. (MFn Type constant)
"""
pass
def create(self, *args, **kwargs):
"""
create(MFn Type constant) -> MObject
Creates a new, empty component, attaches it to the function set and
returns an MObject which references it.
"""
pass
@property
def elementCount(self, *args, **kwargs):
"""
Number of elements in the component.
"""
pass
def getCompleteData(self, *args, **kwargs):
"""
getCompleteData() -> (numS, numT, numU)
Returns a tuple containing the number of S, T and U indices in
the complete component, or (0,0,0) if the component is not complete.
"""
pass
def getElement(self, *args, **kwargs):
"""
getElement(index) -> (sIndex, tIndex, uIndex)
Returns the indexth element of the component as a tuple containing the
elements S, T and U indices.
"""
pass
def getElements(self, *args, **kwargs):
"""
getElements() -> list of (sIndex, tIndex, uIndex)
Returns all of the components elements as a list of tuples with each
tuple containing the S, T and U indices of a single element.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hasWeights(self, *args, **kwargs):
"""
True if the component has weights associated with its elements.
"""
pass
@property
def isComplete(self, *args, **kwargs):
"""
Marking a component as complete means that it represents a full set
of indices from 0 to elementCount-1
"""
pass
@property
def isEmpty(self, *args, **kwargs):
"""
True if the component contains no elements.
"""
pass
def isEqual(self, *args, **kwargs):
"""
isEqual(MObject other) -> bool
Returns True if other refers to the same component as the
one to which the function set is currently attached.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def setCompleteData(self, *args, **kwargs):
"""
setCompleteData(numS, numT, numU) -> self
Marks the component as complete (i.e. contains all possible elements).
numS, numT and numU indicate the number of S, T and U indices
in the complete component (i.e. the max S index is numS-1, the max T
index is numT-1 and the max U index is numU-1).
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def weight(self, *args, **kwargs):
"""
weight(index) -> MWeight
Returns the weight associated with the specified element,
where index can range from 0 to elementCount-1.
"""
pass
class MFnTypedAttribute(MFnAttribute):
"""
Functionset for creating and working typed attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
def attrType(self, *args, **kwargs):
"""
Returns the type of data handled by the attribute.
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new type attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def default(self, *args, **kwargs):
"""
Default value
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kDelete = 0
kNothing = 2
kReset = 1
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnUInt64ArrayData(MFnData):
"""
Function set for node data consisting of an array of MUint64.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as an MUint64Array.
"""
pass
def copyTo(self, *args, **kwargs):
"""
Replaces the elements of an array with those in the encapsulated array.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new MUint64 array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MFnUnitAttribute(MFnAttribute):
"""
Functionset for creating and working with angle, distance and time attributes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def accepts(self, *args, **kwargs):
"""
Returns True if this attribute can accept a connection of the given type.
"""
pass
def addToCategory(self, *args, **kwargs):
"""
Adds the attribute to a category
"""
pass
@property
def affectsAppearance(self, *args, **kwargs):
"""
Does the attribute affect how the node is drawn in Mayas viewport?
"""
pass
@property
def affectsWorldSpace(self, *args, **kwargs):
"""
Does the attribute affect the nodes worldSpace matrix?
"""
pass
@property
def array(self, *args, **kwargs):
"""
Is the attribute an array?
"""
pass
@property
def cached(self, *args, **kwargs):
"""
Should the attributes value be cached in the datablock?
"""
pass
@property
def channelBox(self, *args, **kwargs):
"""
Should the attribute be displayed in the Channel Box?
"""
pass
@property
def connectable(self, *args, **kwargs):
"""
Can connections be made to the attribute?
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new unit attribute, attaches it to the function set and returns it as an MObject.
"""
pass
@property
def default(self, *args, **kwargs):
"""
Default value
"""
pass
@property
def disconnectBehavior(self, *args, **kwargs):
"""
What should happen when the attribute loses an incoming connection?
"""
pass
@property
def dynamic(self, *args, **kwargs):
"""
Is the attribute a dynamic attribute?
"""
pass
@property
def extension(self, *args, **kwargs):
"""
Is the attribute an extension attribute?
"""
pass
def getAddAttrCmd(self, *args, **kwargs):
"""
Returns a string containing a MEL addAttr command capable of recreating the attribute.
"""
pass
def getMax(self, *args, **kwargs):
"""
Returns the attributes hard maximum value.
"""
pass
def getMin(self, *args, **kwargs):
"""
Returns the attributes hard minimum value.
"""
pass
def getSoftMax(self, *args, **kwargs):
"""
Returns the attributes soft maximum value.
"""
pass
def getSoftMin(self, *args, **kwargs):
"""
Returns the attributes soft minimum value.
"""
pass
def hasCategory(self, *args, **kwargs):
"""
Checks to see if the attribute has a given category
"""
pass
def hasMax(self, *args, **kwargs):
"""
Returns True if the attribute has a hard maximum value.
"""
pass
def hasMin(self, *args, **kwargs):
"""
Returns True if the attribute has a hard minimum value.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
def hasSoftMax(self, *args, **kwargs):
"""
Returns True if the attribute has a soft maximum value.
"""
pass
def hasSoftMin(self, *args, **kwargs):
"""
Returns True if the attribute has a soft minimum value.
"""
pass
@property
def hidden(self, *args, **kwargs):
"""
If True the attribute will not be displayed in the Attribute Editor.
"""
pass
@property
def indeterminant(self, *args, **kwargs):
"""
Hint to DG that this attribute may not always be used when computing the attributes which are dependent upon it.
"""
pass
@property
def indexMatters(self, *args, **kwargs):
"""
If False, connectAttr -nextAvailable can be used with this attribute. If True then an explicit index must be provided.
"""
pass
@property
def internal(self, *args, **kwargs):
"""
Will the node handle the attributes data storage itself, outside of the nodes data block?
"""
pass
kAngle = 1
kDelete = 0
kDistance = 2
kInvalid = 0
kLast = 4
kNothing = 2
kReset = 1
kTime = 3
@property
def keyable(self, *args, **kwargs):
"""
Can keys be set on the attribute?
"""
pass
@property
def name(self, *args, **kwargs):
"""
Attributes long name.
"""
pass
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
@property
def parent(self, *args, **kwargs):
"""
Parent attribute. MObject::kNullObj if attr has no parent.
"""
pass
@property
def readable(self, *args, **kwargs):
"""
Is the attribute readable?
"""
pass
@property
def renderSource(self, *args, **kwargs):
"""
Is the attribute a render source?
"""
pass
def setMax(self, *args, **kwargs):
"""
Sets the attributes hard maximum value.
"""
pass
def setMin(self, *args, **kwargs):
"""
Sets the attributes hard minimum value.
"""
pass
def setNiceNameOverride(self, *args, **kwargs):
"""
Sets a nice UI name for this attribute rather than using the default derived from its long name.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def setSoftMax(self, *args, **kwargs):
"""
Sets the attributes soft maximum value.
"""
pass
def setSoftMin(self, *args, **kwargs):
"""
Sets the attributes soft minimum value.
"""
pass
@property
def shortName(self, *args, **kwargs):
"""
Attributes short name.
"""
pass
@property
def storable(self, *args, **kwargs):
"""
Should the attributes value be preserved when the node is written to file?
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
def unitType(self, *args, **kwargs):
"""
Returns the type of data handled by the attribute.
"""
pass
@property
def usedAsColor(self, *args, **kwargs):
"""
Should the attribute be treated as a color in the UI?
"""
pass
@property
def usedAsFilename(self, *args, **kwargs):
"""
Should the attribute be treated as a file name in the UI?
"""
pass
@property
def usesArrayDataBuilder(self, *args, **kwargs):
"""
Array attributes only: does the attribute create elements using MArrayDataBuilder?
"""
pass
@property
def worldSpace(self, *args, **kwargs):
"""
DAG nodes only: if the node is instanced, will the attribute have separate values for each instance?
"""
pass
@property
def writable(self, *args, **kwargs):
"""
Is the attribute writable?
"""
pass
class MFnVectorArrayData(MFnData):
"""
Function set for node data consisting of an array of MVectors.
"""
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns the encapsulated array as an MVectorArray.
"""
pass
def copyTo(self, *args, **kwargs):
"""
Replaces the elements of an array with those in the encapsulated array.
"""
pass
def create(self, *args, **kwargs):
"""
Creates a new MVector array data object.
"""
pass
def hasObj(self, *args, **kwargs):
"""
Returns True if the function set is compatible with the specified Maya object.
"""
pass
kAny = 24
kComponentList = 13
kDoubleArray = 7
kDynArrayAttrs = 19
kDynSweptGeometry = 20
kFloatArray = 8
kIntArray = 9
kInvalid = 0
kLast = 25
kLattice = 15
kMatrix = 5
kMatrixArray = 12
kMesh = 14
kNId = 23
kNObject = 22
kNumeric = 1
kNurbsCurve = 16
kNurbsSurface = 17
kPlugin = 2
kPluginGeometry = 3
kPointArray = 10
kSphere = 18
kString = 4
kStringArray = 6
kSubdSurface = 21
kVectorArray = 11
def object(self, *args, **kwargs):
"""
Returns a reference to the object to which the function set is currently attached, or MObject.kNullObj if none.
"""
pass
def set(self, *args, **kwargs):
"""
Sets values in the encapsulated array.
"""
pass
def setObject(self, *args, **kwargs):
"""
Attaches the function set to the specified Maya object.
"""
pass
def type(self, *args, **kwargs):
"""
Returns the type of the function set.
"""
pass
class MGlobal(object):
"""
Static class providing common API global functions.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def animSelectionMask(self, *args, **kwargs):
"""
animSelectionMask() -> MSelectionMask
Returns the animation selection mask.
"""
pass
def componentSelectionMask(self, *args, **kwargs):
"""
componentSelectionMask() -> MSelectionMask
Returns the component selection mask.
"""
pass
def displayError(self, *args, **kwargs):
"""
displayError(msg) -> None
Display an error in the script editor.
"""
pass
def displayInfo(self, *args, **kwargs):
"""
displayInfo(msg) -> None
Display an informational message in the script editor.
"""
pass
def displayWarning(self, *args, **kwargs):
"""
displayWarning(msg) -> None
Display a warning in the script editor.
"""
pass
def getActiveSelectionList(self, *args, **kwargs):
"""
getActiveSelectionList() -> MSelectionList
Return an MSelectionList containing the nodes, components and
plugs currently selected in Maya.
"""
pass
def getFunctionSetList(self, *args, **kwargs):
"""
getFunctionSetList(MObject) -> (string, string, ...)
Returns a tuple of strings that represent the type of each function
set that will accept this object.
"""
pass
def getRichSelection(self, *args, **kwargs):
"""
getRichSelection(defaultToActiveSelection=True) -> MRichSelection
Returns the current rich selection (usually the active selection with
any soft selection and symmetry applied). If no rich selection exists
and defaultToActiveSelection is True, the current active selection
will be returned instead.
"""
pass
def getSelectionListByName(self, *args, **kwargs):
"""
getSelectionListByName(name) -> MSelectionList
Returns an MSelectionList with all of the objects that match the
specified name. The name may use the same type of regular expressions
as can be used in MEL commands. For example, the pattern pCube* will
match all occurrences of objects whose names begin with pCube.
"""
pass
kAddToHeadOfList = 4
kAddToList = 2
kBaseUIMode = 3
kBatch = 1
kInteractive = 0
kLibraryApp = 2
kRemoveFromList = 3
kReplaceList = 0
kSelectComponentMode = 1
kSelectLeafMode = 3
kSelectObjectMode = 0
kSelectRootMode = 2
kSelectTemplateMode = 4
kSurfaceSelectMethod = 0
kWireframeSelectMethod = 1
kXORWithList = 1
def miscSelectionMask(self, *args, **kwargs):
"""
miscSelectionMask() -> MSelectionMask
Returns the miscellaneous selection mask.
"""
pass
def objectSelectionMask(self, *args, **kwargs):
"""
objectSelectionMask() -> MSelectionMask
Returns the object selection mask.
"""
pass
def selectionMode(self, *args, **kwargs):
"""
selectionMode() -> int
Get current selection mode:
kSelectObjectMode Objects are selected as a whole. Components are not directly accessible.
kSelectComponentMode Components such as vertices are selectable in this mode.
kSelectRootMode Selecting the child in a hierarchy will also select its root DAG node.
kSelectLeafMode Selecting the child in a hierarchy will result only in that child being selected.
kSelectTemplateMode Templated objects are selectable in this mode.
"""
pass
def setActiveSelectionList(self, *args, **kwargs):
"""
setActiveSelectionList(MSelectionList, listAdjustment=kReplaceList) -> None
Set the active selection list.
The selection items on the given list will update the contents of the active selection
list as indicated by the listAdjustment parameter.
Valid listAdjustment values are:
kReplaceList #Totally replace the list with the given items.
kXORWithList #Any of the items which are already on the list will be removed.
#Any which are not already on the list will be added to the end
#of the list.
kAddToList #Remove the items from the list.
kAddToHeadOfList #Add the items to the beginning of the list.
"""
pass
def setAnimSelectionMask(self, *args, **kwargs):
"""
setAnimSelectionMask(mask) -> selfsetAnimSelectionMask(type) -> self
Set the animation selection mask to the supplied value.
* mask (MSelectionMask) - The selection mask.
* type (int) - The selection type (see MSelectionMask.addMask() for a list of values).
"""
pass
def setComponentSelectionMask(self, *args, **kwargs):
"""
setComponentSelectionMask(mask) -> selfsetComponentSelectionMask(type) -> self
Set the component selection mask to the supplied value.
* mask (MSelectionMask) - The selection mask.
* type (int) - The selection type (see MSelectionMask.addMask() for a list of values).
"""
pass
def setMiscSelectionMask(self, *args, **kwargs):
"""
setMiscSelectionMask(mask) -> selfsetMiscSelectionMask(type) -> self
Set the miscellaneous selection mask to the supplied value.
* mask (MSelectionMask) - The selection mask.
* type (int) - The selection type (see MSelectionMask.addMask() for a list of values).
"""
pass
def setObjectSelectionMask(self, *args, **kwargs):
"""
setObjectSelectionMask(mask) -> selfsetObjectSelectionMask(type) -> self
Set the object selection mask to the supplied value.
* mask (MSelectionMask) - The selection mask.
* type (int) - The selection type (see MSelectionMask.addMask() for a list of values).
"""
pass
def setRichSelection(self, *args, **kwargs):
"""
setRichSelection(MRichSelection) -> None
Set the current rich selection.
"""
pass
def setSelectionMode(self, *args, **kwargs):
"""
setSelectionMode(int) -> None
Set the current selection mode.
See selectionMode() for a list of valid modes.
"""
pass
class MImage(object):
"""
Manipulate color data.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def create(self, *args, **kwargs):
"""
create(width, height, channels=4, type=kByte) -> self
Create a new MImage object. Allocates memory for an RGBA array of pixels
of the given size. If an object was already in memory, it is released first.
* width (unsigned int) - the desired images width in pixels.
* height (unsigned int) - the desired images height in pixels.
* channels (unsigned int) - the desired number of channels per pixel.
* type (int) - the desired pixel format (kByte or kFloat, see MImage.pixelType() description for details.)
"""
pass
def depth(self, *args, **kwargs):
"""
depth() -> int
Get the color depth (in bytes) of the currently opened image.
"""
pass
def depthMap(self, *args, **kwargs):
"""
depthMap() -> long
Returns a long containing a C++ float pointer which points to the depth data.
"""
pass
def filter(self, *args, **kwargs):
"""
filter(sourceFormat, targetFormat, scale=1.0, offset=1.0) -> self
Modify the content of the image by applying a filter.
The dimension of the image remains the same; only the RGBA components get affected.
* sourceFormat (MImageFilterFormat) - the format of the source image.
* targetFormat (MImageFilterFormat) - the format of the resulting image.* scale (float) - vary depending on the source/target format.
* offset (float) - vary depending on the source/target format.
The scale argument for this filter can vary from -256.0 to 256.0, although typical values range from 1.0 to 10.0.
The offset argument is currently ignored and should be left to the default value of 0.0.
"""
pass
def filterExists(self, *args, **kwargs):
"""
filterExists(sourceFormat, targetFormat) -> bool
Return whether or not a given source format can be directly converted to a given target format.
* sourceFormat (MImageFilterFormat) - the format of the source image.
* targetFormat (MImageFilterFormat) - the format of the resulting image.
"""
pass
def floatPixels(self, *args, **kwargs):
"""
floatPixels() -> long
Returns a long containing a C++ float pointer which points to the pixel data.
This data is uncompressed and tightly packed, of size (width * height * depth * sizeof( float)) bytes.
"""
pass
def getDepthMapRange(self, *args, **kwargs):
"""
getDepthMapRange() -> [minValue, maxValue]
Compute the minimum and maximum depth values (range) for any stored depth buffer.
"""
pass
def getDepthMapSize(self, *args, **kwargs):
"""
getDepthMapSize() -> [width, height]
Returns the size of the depth map buffer.
"""
pass
def getSize(self, *args, **kwargs):
"""
getSize() -> [width, height]
Get the width and height of the currently opened image.
"""
pass
def haveDepth(self, *args, **kwargs):
"""
haveDepth() -> bool
Returns True if this instance of MImage contains a depth map.
"""
pass
def isRGBA(self, *args, **kwargs):
"""
isRGBA() -> bool
Query flag which indicates whether the pixel information is in RGBA sequence or BGRA sequence.
If no pixel data exists, then False will be returned.
"""
pass
kByte = 1
kFloat = 2
kHeightFieldBumpFormat = 1
kNoFormat = 0
kNormalMapBumpFormat = 2
kUnknown = 0
kUnknownFormat = 3
def pixelType(self, *args, **kwargs):
"""
pixelType() -> int
Get the current pixel format of the image: kUnknown Format not known or invalid.
kByte One byte per channel, ranging from 0 to 255.
kFloat One float per channel, ranging from 0.0 to 1.0.
"""
pass
def pixels(self, *args, **kwargs):
"""
pixels() -> long
Returns a long containing a C++ unsigned char pointer which points to the pixel data.
This data is uncompressed and tightly packed, of size (width * height * depth) bytes.
For the moment, pixels are always stored in a RGBA (depth=4 bytes) pixel format.
"""
pass
def readDepthMap(self, *args, **kwargs):
"""
readDepthMap(pathname) -> self
Reads the depth map from the specified file and place the result into the depth map array of this MImage instance.
"""
pass
def readFromFile(self, *args, **kwargs):
"""
readFromFile(pathname, type=kByte) -> self
Attempt to identify and open the specified image file.
* pathname (string) - the full path of the image file that should be opened.
* type (MPixelType) - the desired pixel format. kUnknown attempts to load the native pixel type.
"""
pass
def readFromTextureNode(self, *args, **kwargs):
"""
readFromTextureNode(fileTextureObject, type=kByte) -> self
Attempt to read the content of the given file texture node.
* fileTextureObject (MObject) - an object that refers to the file texture node that should be read.
* type (MPixelType) - the desired pixel format. kUnknown attempts to load the native pixel type.
"""
pass
def release(self, *args, **kwargs):
"""
release() -> self
Release the current image. If there is no current image, the call is ignored.
"""
pass
def resize(self, *args, **kwargs):
"""
resize(width, height, preserveAspectRatio=True) -> self
Resize the currently opened image to the specified dimension, or to the closest
width/height that is preserves the original aspect ratio.* width (unsigned int) - the desired images width in pixels.
* height (unsigned int) - the desired images height in pixels.
* preserveAspectRatio (bool) - specifies whether the aspect ratio should be preserved or not.
If this flag is set, the given width and height are interpreted as the maximum dimensions allowable.
"""
pass
def setDepthMap(self, *args, **kwargs):
"""
setDepthMap(depth, width, heigth) -> self
Specifies the depth map resolution and data.
* depth (float*) - float buffer that contains depth values.
* width (unsigned int) - the width of the depth buffer.
* height (unsigned int) - the height of the depth buffer.
* depth (MFloatArray) - float array that contains depth values.
* width (unsigned int) - the width of the depth buffer.
* height (unsigned int) - the height of the depth buffer.
"""
pass
def setFloatPixels(self, *args, **kwargs):
"""
setFloatPixels(pixels, width, height, channels=4) -> self
Copy the uncompressed pixels array passed in into the MImage.
This array is tightly packed, of size (width * height * depth) bytes.
For the moment, pixels are always stored in a RGBA (depth=4 bytes) pixel format.
* pixels (float*) - the variable containing a block of pixels.
* width (unsigned int) - the variable that will be set to the images width in pixels.
* height (unsigned int) - the variable that will be set to the images height in pixels.
* channels (unsigned int) - the number of channels per pixel.
"""
pass
def setPixels(self, *args, **kwargs):
"""
setPixels(pixels, width, height) -> self
Copy the uncompressed pixels array passed in into the MImage.
This array is tightly packed, of size (width * height * depth) bytes.
For the moment, pixels are always stored in a RGBA (depth=4 bytes) pixel format.
* pixels (unsigned char*) - the variable containing a block of pixels.
* width (unsigned int) - the variable that will be set to the images width in pixels.
* height (unsigned int) - the variable that will be set to the images height in pixels.
"""
pass
def setRGBA(self, *args, **kwargs):
"""
setRGBA(bool) -> self
Sets a flag to indicate that pixel information is in RGBA sequence or BGRA sequence.
Pixel data must have been allocated before this call is made.
"""
pass
def verticalFlip(self, *args, **kwargs):
"""
verticalFlip() -> bool
Flips the image vertically.
"""
pass
def writeToFile(self, *args, **kwargs):
"""
writeToFile(pathname, outputFormat=iff) -> self
Save the content of this image in a file. By default, the file is saved in IFF format.
Optionally, the file can also be converted in a variety of image formats.
"""
pass
def writeToFileWithDepth(self, *args, **kwargs):
"""
writeToFileWithDepth(pathname, outputFormat=iff, writeDepth=False) -> self
Save the content of this image in a file. By default, the file is saved in IFF format.
Optionally, the file can also be converted in a variety of image formats.
If the writeDepth parameter is True then any depth information stored in MImage will be written to file.
"""
pass
class MInt64Array(object):
"""
Array of MInt64 values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MIntArray(object):
"""
Array of int values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MItMeshEdge(object):
"""
An iterator for traversing a meshs edges.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def center(self, *args, **kwargs):
"""
center(space=kObject) -> MPoint
Returns the center point of the edge, in the given transformation space.
* space (MSpace constant) - The transformation space
"""
pass
def connectedToEdge(self, *args, **kwargs):
"""
connectedToEdge(index) -> bool
Determines whether the given edge is connected to the current edge.
* index (int) - Index of edge to check.
"""
pass
def connectedToFace(self, *args, **kwargs):
"""
connectedToFace(index) -> bool
Determines whether the given face contains the current edge.
* index (int) - Index of face to check.
"""
pass
def count(self, *args, **kwargs):
"""
count() -> int
Return the number of edges in the iteration
"""
pass
def currentItem(self, *args, **kwargs):
"""
currentItem() -> MObject
Returns the current edge in the iteration as a component.
Components are used to specify one or more edges and are useful in operating on groups of non-contiguous edges for a surface.
Components do not contain any information about the surface that they refer to so an MDagPath must be specified when dealing with components.
"""
pass
def geomChanged(self, *args, **kwargs):
"""
geomChanged() -> self
Resets the geom pointer in the MItMeshEdge. If youre using MFnMesh to
update Normals or Color per vertex while iterating, you must call geomChanged
on the iterator immediately after the MFnMesh call to make sure that your
geometry is up to date. A crash may result if this method is not called.
A similar approach must be taken for updating upstream vertex tweaks
with an MPlug. After the update, call this method.
"""
pass
def getConnectedEdges(self, *args, **kwargs):
"""
getConnectedEdges() -> MIntArray
Returns the indices of edges connected to the current edge.
"""
pass
def getConnectedFaces(self, *args, **kwargs):
"""
getConnectedFaces() -> MIntArray
Returns the indices of the faces connected to the current edge.
Normally a boundary edge will only have one face connected to it and
an internal edge will have two, but if the mesh has manifold geometry
then the edge may have three or more faces connected to it.
"""
pass
def index(self, *args, **kwargs):
"""
index() -> int
Returns the index of the current edge in the iteration.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Indicates if all of the edges have been traversed yet.
"""
pass
@property
def isSmooth(self, *args, **kwargs):
"""
True if the edge is smooth, False if it is hard.
"""
pass
def length(self, *args, **kwargs):
"""
length(space=kObject) -> float
Returns the length of the edge, in the given transformation space.
* space (MSpace constant) - The transformation space
"""
pass
def next(self, *args, **kwargs):
"""
next() -> self
Advances to the next edge in the iteration.
"""
pass
def numConnectedEdges(self, *args, **kwargs):
"""
numConnectedEdges() -> int
Returns the number of edges connected to the current edge.
"""
pass
def numConnectedFaces(self, *args, **kwargs):
"""
numConnectedFaces() -> int
Returns the number of faces connected to the current edge.
"""
pass
def onBoundary(self, *args, **kwargs):
"""
onBoundary() -> bool
Determines if the current edge is a border edge.
"""
pass
def point(self, *args, **kwargs):
"""
point(whichVertex, space=kObject) -> MPoint
Returns the position of one of the current edges vertices, int the
given transformation space.
* whichVertex (0 or 1) - Which of the edges two vertices to return
* space (MSpace constant) - The transformation space
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
reset(mesh) -> self
reset(mesh, component=None) -> self
Reset the iterator to the first edge of the mesh.
Reset the iterator to the first edge of the specified mesh
* mesh (MObject) - The polygon for the iteration
Reset the iterator with the given mesh and component.
If component is None then the iteration will be for all edges in the mesh.
* mesh (MDagPath) - The mesh to iterate over
* component (MObject) - The edges of the mesh to iterate over
"""
pass
def setIndex(self, *args, **kwargs):
"""
setIndex(index) -> int
Sets the index of the current edge to be accessed. The current edge
will no longer be in sync with any previous iteration.
Returns the index of the edge which was current before the change.
* index (int) - The index of desired edge to access.
"""
pass
def setPoint(self, *args, **kwargs):
"""
setPoint(point, whichVertex, space=kObject) -> self
Sets the position of one of the current edges vertices, in the given
transformation space.
* point (MPoint) - The new position for the specified vertex
* whichVertex (0 or 1) - Which of the edges 2 vertices to set.
* space (MSpace constant) - The transformation space
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
Tells Maya that mesh has been changed and needs to redraw itself.
"""
pass
def vertexId(self, *args, **kwargs):
"""
vertexId(whichVertex) -> int
Returns the global index (as opposed to face-relative index) of one of
the edges vertices.
* whichVertex (0 or 1) - Which of the edges 2 vertices to use.
"""
pass
class MItMeshFaceVertex(object):
"""
An iterator for traversing a meshs face vertices.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def currentItem(self, *args, **kwargs):
"""
currentItem() -> MObject
Returns the current faceVertex as a double-indexed component.
"""
pass
def faceId(self, *args, **kwargs):
"""
faceId() -> int
Returns the current face index.
"""
pass
def faceVertexId(self, *args, **kwargs):
"""
faceVertexId() -> int
Returns the relative index of the vertex within the current face. This
index together with the faceId can be used for a fast access to get
various info stored per vertex (normals, uvs, colors).
"""
pass
def geomChanged(self, *args, **kwargs):
"""
geomChanged() -> self
Resets the geom pointer in the MItMeshFaceVertex. If youre using
MFnMesh to update Normals or Color per vertex while iterating, you
must call geomChanged on the iterator immediately after the MFnMesh
call to make sure that your geometry is up to date. A crash may result
if this method is not called. A similar approach must be taken for
updating upstream vertex tweaks with an MPlug. After the update, call
this method.
"""
pass
def getBinormal(self, *args, **kwargs):
"""
getBinormal(space=MSpace.kObject, uvSet=) -> MVector
Returns the face vertex binormal associated with the UV set.
"""
pass
def getColor(self, *args, **kwargs):
"""
getColor(colorSetName=) -> MColor
Returns a color of the current face vertex.
"""
pass
def getColorIndex(self, *args, **kwargs):
"""
getColorIndex(colorSetName=) -> int
Return a color index of the current face vertex.
"""
pass
def getNormal(self, *args, **kwargs):
"""
getNormal(space=MSpace.kObject) -> MVector
Returns the face vertex normal.
"""
pass
def getTangent(self, *args, **kwargs):
"""
getTangent(space=MSpace.kObject, uvSet=) -> MVector
Returns the face vertex tangent associated with the given UV set. The
tangent is defined as the surface tangent of the polygon running in
the U direction.
"""
pass
def getUV(self, *args, **kwargs):
"""
getUV(uvSet=) -> (float, float)
Returns the texture coordinate for the current face vertex.
"""
pass
def getUVIndex(self, *args, **kwargs):
"""
getUVIndex(uvSet=) -> int
Returns the index of the texture coordinate for the current face
vertex. This index refers to an element of the meshs texture
coordinate array as returned by MFnMesh::getUVs().
"""
pass
def hasColor(self, *args, **kwargs):
"""
hasColor() -> bool
Returns whether the current face vertex has a color-per-vertex set.
"""
pass
def hasUVs(self, *args, **kwargs):
"""
hasUVs(uvSet=) -> bool
Returns whether the current face vertex has UVs mapped in the given
set.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Indicates if all of the face vertices have been traversed.
"""
pass
def next(self, *args, **kwargs):
"""
next() -> self
Advances to the next face vertex in the iteration.
"""
pass
def normalId(self, *args, **kwargs):
"""
normalId() -> int
Returns the normal index for the specified vertex. This index refers
to an element in the normal array returned by MFnMesh::getNormals().
These normals are per-face per-vertex normals.
"""
pass
def position(self, *args, **kwargs):
"""
position(space=MSpace.kObject) -> MPoint
Returns the position of the current face vertex.
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
reset(mesh) -> self
reset(mesh, component=None) -> self
Reset the iterator to the first face vertex of the mesh.
Reset the iterator to the first face vertex of the specified mesh.
* mesh (MObject) - The mesh for the iteration
Reset the iterator with the given mesh and component.
If component is None then the iteration will be for all face vertices in the mesh.
* mesh (MDagPath) - The mesh to iterate over
* component (MObject) - The faces of the mesh to iterate over
"""
pass
def setIndex(self, *args, **kwargs):
"""
setIndex(faceId, faceVertexId) -> (oldFaceId, oldFaceVertexId)
Sets the index of the current face vertex to be accessed. The current
face vertex will no longer be in sync with any previous iteration.
Returns the indices of the old face and vertex.
* faceId (int) - Index of desired face to access.
* faceVertexId (int) - Face-relative index of desired vertex to access.
* oldFaceId (int) - Index of the face which was current before the change.
* oldFaceVertexId (int) - Face-relative index of the vertex which was current before the change.
"""
pass
def tangentId(self, *args, **kwargs):
"""
tangentId() -> int
Returns the tangent index for the current face vertex. This index
refers to an element in the array returned by MFnMesh::getTangents.
These tangents are per-face per-vertex.
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
Tells Maya that mesh has been changed and needs to redraw itself.
"""
pass
def vertexId(self, *args, **kwargs):
"""
vertexId() -> int
Returns the global (as opposed to face-relative) index of the
current vertex.
"""
pass
class MItMeshPolygon(object):
"""
This class is the iterator for polygonal surfaces (meshes).
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def center(self, *args, **kwargs):
"""
center(space=kObject) -> MPoint
Return the position of the center of the current polygon
* space (int) - The coordinate system for this operation
"""
pass
def count(self, *args, **kwargs):
"""
count() -> int
Return the number of polygons in the iteration
"""
pass
def currentItem(self, *args, **kwargs):
"""
currentItem() -> MObject
Get the current polygon in the iteration as a component.
Components are used to specify one or more polygons and are usefull in operating on groups of non-contiguous polygons for a surface.
Components do not contain any information about the surface that they refer to so an MDagPath must be specified when dealing with components.
"""
pass
def geomChanged(self, *args, **kwargs):
"""
geomChanged() -> self
Reset the geom pointer in the MItMeshPolygon. This is now being handled automatically inside the iterator, and users should no longer need to call this method directly to sync up the iterator to changes made by MFnMesh
"""
pass
def getArea(self, *args, **kwargs):
"""
getArea(space=kObject) -> float
This method gets the area of the face
* space (int) - World Space or Object Space
"""
pass
def getColor(self, *args, **kwargs):
"""
getColor(colorSetName=None) -> MColor
getColor(vertexIndex) -> MColor
This method gets the color of the specifed vertex in this face
* index (int) - The face-relative vertex index on this face
Or the average color of the all the vertices in this face
* colorSetName (string) - Name of the color set.
"""
pass
def getColorIndex(self, *args, **kwargs):
"""
getColorIndex(vertexIndex, colorSetName=None) -> int
This method returns the colorIndex for a vertex of the current face.
* vertexIndex (int) - Face-relative index of vertex.
* colorSetName (string) - Name of the color set.
"""
pass
def getColorIndices(self, *args, **kwargs):
"""
getColorIndices(colorSetName=None) -> MIntArray
This method returns the colorIndices for each vertex on the face.
* colorSetName (string) - Name of the color set.
"""
pass
def getColors(self, *args, **kwargs):
"""
getColors(colorSetName=None) -> MColorArray
This method gets the color of the each vertex in the current face.
* colorSetName (string) - Name of the color set.
"""
pass
def getConnectedEdges(self, *args, **kwargs):
"""
getConnectedEdges() -> MIntArray
This method gets the indices of the edges connected to the vertices of the current face, but DOES not include the edges contained in the current face
"""
pass
def getConnectedFaces(self, *args, **kwargs):
"""
getConnectedFaces() -> MIntArray
This method gets the indices of the faces connected to the current face.
"""
pass
def getConnectedVertices(self, *args, **kwargs):
"""
getConnectedVertices() -> MIntArray
This method gets the object-relative indices of the vertices surrounding the vertices of the current face, but does not include the vertices of the current face
"""
pass
def getEdges(self, *args, **kwargs):
"""
getEdges() -> MIntArray
This method gets the indices of the edges contained in the current face.
"""
pass
def getNormal(self, *args, **kwargs):
"""
getNormal(space=kObject) -> MVector
getNormal(verexIndex, space=kObject) -> MVector
Return the face normal of the current polygon.
* space (int) - The transformation space
Returns the vertex-face normal for the vertex in the current polygon.
* index (int) - face-relative vertex index of the vertex whose normal to retrieve
* space (int) - The transformation space
"""
pass
def getNormals(self, *args, **kwargs):
"""
getNormals(space=kObject) -> MVectorArray
Returns the normals for all vertices in the current face
* space (int) - The transformation space
"""
pass
def getPointAtUV(self, *args, **kwargs):
"""
getPointAtUV(uvPoint, space=kObject, uvSet=None, tolerance=0) -> MPoint
Return the position of the point at the given UV value in the current polygon.
* uvPoint ([float, float]) - The UV value to try to locate
* space (int) - The coordinate system for this operation
* uvSet (string) - UV set to work with
* tolerance (float) - tolerance value to compare float data type
"""
pass
def getPoints(self, *args, **kwargs):
"""
getPoints(space=kObject) -> MPointArray
Retrieves the positions of the vertices on the current face/polygon that the iterator is pointing to. Vertex positions will be inserted into the given array and will be indexed using face-relative vertex IDs (ie. ordered from 0 to (vertexCount of the face) - 1), which should not be confused with the vertexIDs of each vertex in relation to the entire mesh object.
* space (int) - The coordinate system for this operation
"""
pass
def getTriangle(self, *args, **kwargs):
"""
getTriangle(localTriIndex, space=kObject) -> [MPointArray, MIntArray]
Get the vertices and vertex positions of the given triangle in the current faces triangulation.
* localTriIndex (int) - Local index of the desired triangle in this face
* space (int) - World Space or Object Space
"""
pass
def getTriangles(self, *args, **kwargs):
"""
getTriangles(space=kObject) -> [MPointArray, MIntArray]
Get the vertices and vertex positions of all the triangles in the current faces triangulation
* space (int) - World Space or Object Space
"""
pass
def getUV(self, *args, **kwargs):
"""
getUV(vertexId, uvSet=None) -> [float, float]
Return the texture coordinate for the given vertex.
* vertex (int) - The face-relative vertex index to get UV for
* uvSet (string) - UV set to work with
"""
pass
def getUVArea(self, *args, **kwargs):
"""
getUVArea(uvSet=None) -> float
This method gets the UV area of the face
* uvSet (string) - UV set to work with
"""
pass
def getUVAtPoint(self, *args, **kwargs):
"""
getUVAtPoint(pt, space=kObject, uvSet=None) -> [float, float]
Find the point closest to the given point in the current polygon, and return the UV value at that point.
* pt (MPoint) - The point to try to get UV for
* space (int) - The coordinate system for this operation
* uvSet (string) - UV set to work with
"""
pass
def getUVIndex(self, *args, **kwargs):
"""
getUVIndex(vertex, uvSet=None) -> int
Returns the index of the texture coordinate for the given vertex.
This index refers to an element of the texture coordinate array for the polygonal object returned by MFnMesh.getUVs.
* vertex (int) - The face-relative vertex index of the current polygon
* uvSet (string) - UV set to work with
"""
pass
def getUVIndexAndValue(self, *args, **kwargs):
"""
getUVIndexAndValue(vertex, uvSet=None) -> [int, float, float]
Return the index and value of the texture coordinate for the given vertex. This index refers to an element of the texture coordinate array for the polygonal object returned by MFnMesh.getUVs.
* vertex (int) - The face-relative vertex index of the current polygon
* uvSet (string) - UV set to work with
"""
pass
def getUVSetNames(self, *args, **kwargs):
"""
getUVSetNames() -> list of strings
This method is used to find the UV set names mapped to the current face
"""
pass
def getUVs(self, *args, **kwargs):
"""
getUVs(uvSet=None) -> [MFloatArray, MFloatArray]
Return the all the texture coordinates for the vertices of this face (in local vertex order).
* uvSet (string) - UV set to work with
"""
pass
def getVertices(self, *args, **kwargs):
"""
getVertices() -> MIntArray
This method gets the indices of the vertices of the current face
"""
pass
def hasColor(self, *args, **kwargs):
"""
hasColor() -> bool
hasColor(localVertexIndex) -> bool
This method determines whether the current face has color-per-vertex set for any or the given vertex
* localVertexIndex (int) - face-relative vertex index to check for color on
"""
pass
def hasUVs(self, *args, **kwargs):
"""
hasUVs(uvSet=None) -> bool
Tests whether this face has UVs mapped or not (either all the vertices for a face should have UVs, or none of them do, so the UV count for a face is either 0, or equal to the number of vertices).
* uvSet (string) - UV set to work with
"""
pass
def hasValidTriangulation(self, *args, **kwargs):
"""
hasValidTriangulation() -> bool
This method checks if the face has a valid triangulation. If it doesnt, then the face was bad geometry: it may gave degenerate points or cross over itself.
"""
pass
def index(self, *args, **kwargs):
"""
index() -> int
Returns the index of the current polygon
"""
pass
def isConnectedToEdge(self, *args, **kwargs):
"""
isConnectedToEdge(index) -> bool
This method determines whether the given face is adjacent to the current face
* index (int) - Index of the face to be tested for
"""
pass
def isConnectedToFace(self, *args, **kwargs):
"""
isConnectedToFace(index) -> bool
This method determines whether the given face is adjacent to the current face
* index (int) - Index of the face to be tested for
"""
pass
def isConnectedToVertex(self, *args, **kwargs):
"""
isConnectedToVertex(index) -> bool
This method determines whether the given vertex shares an edge with a vertex in the current face
* index (int) - Index of the face to be tested for
"""
pass
def isConvex(self, *args, **kwargs):
"""
isConvex() -> bool
This method checks if the face is convex.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Indicates if all of the polygons have been traversed yet.
"""
pass
def isHoled(self, *args, **kwargs):
"""
isHoled() -> bool
This method checks if the face has any holes.
"""
pass
def isLamina(self, *args, **kwargs):
"""
isLamina() -> bool
This method checks if the face is a lamina (the face is folded over onto itself).
"""
pass
def isPlanar(self, *args, **kwargs):
"""
isPlanar() -> bool
This method checks if the face is planar
"""
pass
def isStarlike(self, *args, **kwargs):
"""
isStarlike() -> bool
This method checks if the face is starlike. That is, a line from the centre to any vertex lies entirely within the face.
"""
pass
def next(self, *args, **kwargs):
"""
next() -> self
Advance to the next edge in the iteration.
"""
pass
def normalIndex(self, *args, **kwargs):
"""
normalIndex(vertex) -> int
Returns the normal index for the specified vertex.
This index refers to an element in the normal array returned by MFnMesh.getNormals. These normals are per-polygon per-vertex normals. See the MFnMesh description for more information on normals.
* localVertexIndex (int) - The face-relative index of the vertex to examine for the current polygon
"""
pass
def numColors(self, *args, **kwargs):
"""
numColors(colorSetName=None) -> int
This method checks for the number of colors on vertices in this face
* colorSetName (string) - Name of the color set.
"""
pass
def numConnectedEdges(self, *args, **kwargs):
"""
numConnectedEdges() -> int
This method checks for the number of connected edges on the vertices of this face
"""
pass
def numConnectedFaces(self, *args, **kwargs):
"""
numConnectedFaces() -> int
This method checks for the number of connected faces
"""
pass
def numTriangles(self, *args, **kwargs):
"""
numTriangles() -> int
This Method checks for the number of triangles in this face in the current triangulation
"""
pass
def onBoundary(self, *args, **kwargs):
"""
onBoundary() -> bool
This method determines whether the current face is on a boundary
"""
pass
def point(self, *args, **kwargs):
"""
point(index, space=kObject) -> MPoint
Return the position of the vertex at index in the current polygon.
* index (int) - The face-relative index of the vertex in the current polygon
* space (int) - The coordinate system for this operation
"""
pass
def polygonVertexCount(self, *args, **kwargs):
"""
polygonVertexCount() -> int
Return the number of vertices for the current polygon
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
reset(polyObject) -> self
reset(polyObject, component=None) -> self
Reset the iterator to the first polygon
Reset the iterator to the first polygon in the supplied surface
* polyObject (MObject) - The polygon for the iteration
Reset the iterator with the given surface and component.
If component is None then the iteration will be for all polygons in the given surface.
* polyObject (MDagPath) - The surface (mesh) to iterate over
* component (MObject) - The polygons (faces) of the polyObject to iterate over
"""
pass
def setIndex(self, *args, **kwargs):
"""
setIndex(index) -> int
This method sets the index of the current face to be accessed.
The current face will no longer be in sync with any previous iteration.
Returns the index of the current face in the iteration
* index (int) - The index of desired face to access.
"""
pass
def setPoint(self, *args, **kwargs):
"""
setPoint(point, index, space=kObject) -> self
Set the vertex at the given index in the current polygon.
* point (MPoint) - The new position for the vertex
* index (int) - The face-relative index of the vertex in the current polygon
* space (int) - The coordinate system for this operation
"""
pass
def setPoints(self, *args, **kwargs):
"""
setPoints(pointArray, space=kObject) -> self
Sets new locations for vertices of the current polygon that the iterator is pointing to.
* pointArray (MPointArray) - The new positions for the vertices.
* space (int) - The coordinate system for this operation.
"""
pass
def setUV(self, *args, **kwargs):
"""
setUV(vertexId, uvPoint, uvSet=None) -> self
Modify the UV value for the given vertex in the current face.
If the face is not already mapped, this method will fail.
* vertexId (int) - face-relative index of the vertex to set UV for.
* uvPoint ([float, float]) - The UV values to set it to
* uvSet (string) - UV set to work with
"""
pass
def setUVs(self, *args, **kwargs):
"""
setUVs(uArray, vArray, uvSet=None) -> self
Modify the UV value for all vertices in the current face.
If the face has not already been mapped, this method will fail.
* uArray (MFloatArray) - All the U values - in local face order
* vArray (MFloatArray) - The corresponding V values
* uvSet (string) - UV set to work with
"""
pass
def tangentIndex(self, *args, **kwargs):
"""
tangentIndex(localVertexIndex) -> int
Returns the tangent (or binormal) index for the specified vertex.
This index refers to an element in the normal array returned by MFnMesh.getTangents. These tangent or binormals are per-polygon per-vertex.
See the MFnMesh description for more information on tangents and binormals.
* localVertexIndex(int) - The face-relative index of the vertex to examine for the current polygon
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
Signal that this polygonal surface has changed and needs to redraw itself.
"""
pass
def vertexIndex(self, *args, **kwargs):
"""
vertexIndex(index) -> int
Returns the object-relative index of the specified vertex of the current polygon.
The index returned may be used to refer to an element in the vertex list returned by MFnMesh.getPoints.
* index (int) - The face-relative index of the vertex in the polygon
"""
pass
def zeroArea(self, *args, **kwargs):
"""
zeroArea() -> bool
This method checks if its a zero area face
"""
pass
def zeroUVArea(self, *args, **kwargs):
"""
zeroUVArea(uvSet=None) -> bool
This method checks if the UV area of the face is zero
* uvSet (string) - UV set to work with
"""
pass
class MItMeshVertex(object):
"""
This class is the iterator for polygonal surfaces (meshes).
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def connectedToEdge(self, *args, **kwargs):
"""
connectedToEdge(index) -> bool
This method determines whether the given edge contains the current vertex
* index (int) - Index of edge to check.
"""
pass
def connectedToFace(self, *args, **kwargs):
"""
connectedToFace(index) -> bool
This method determines whether the given face contains the current vertex
* index (int) - Index of face to check.
"""
pass
def count(self, *args, **kwargs):
"""
count() -> int
Return the number of vertices in the iteration
"""
pass
def currentItem(self, *args, **kwargs):
"""
currentItem() -> MObject
Get the current vertex in the iteration as a component.
Components are used to specify one or more vertices and are usefull in operating on groups of non-contiguous vertices for a surface.
Components do not contain any information about the surface that they refer to so an MDagPath must be specified when dealing with components.
"""
pass
def geomChanged(self, *args, **kwargs):
"""
geomChanged() -> self
Reset the geom pointer in the MItMeshVertex. If youre using MFnMesh to
update Normals or Color per vertex while iterating, you must call geomChanged
on the iteratior immediately after the MFnMesh call to make sure that your
geometry is up to date. A crash may result if this method is not called.
A similar approach must be taken for updating upstream vertex tweaks
with an MPlug. After the update, call this method.
"""
pass
def getColor(self, *args, **kwargs):
"""
getColor(colorSetName=None) -> MColor
getColor(faceIndex, colorSetName=None) -> MColor
This method gets the average color of the vertex
* colorSetName (string) - Name of the color set.
This method gets the color of the current vertex in the specified face
* index (int) - The face to get the color for this vertex for* colorSetName (string) - Name of the color set.
"""
pass
def getColorIndices(self, *args, **kwargs):
"""
getColorIndices(colorSetName=None) -> MIntArray
This method returns the colorIndices into the color array see MFnMesh::getColors()
of the current vertex.
* colorSetName (string) - Name of the color set.
"""
pass
def getColors(self, *args, **kwargs):
"""
getColors(colorSetName=None) -> MColorArray
This method gets the colors of the current vertex for each face it
belongs to. If no colors are assigned to the vertex at all, the
return values will be (-1 -1 -1 1). If some but not all of the
vertex/face colors have been explicitly set, the ones that have not
been set will be (0, 0, 0, 1).
* colorSetName (string) - Name of the color set.
"""
pass
def getConnectedEdges(self, *args, **kwargs):
"""
getConnectedEdges() -> MIntArray
This method gets the indices of the edges contained in the current vertex.
"""
pass
def getConnectedFaces(self, *args, **kwargs):
"""
getConnectedFaces() -> MIntArray
This method gets the indices of the faces connected to the current vertex.
"""
pass
def getConnectedVertices(self, *args, **kwargs):
"""
getConnectedVertices() -> MIntArray
This method gets the indices of the vertices surrounding the current vertex.
"""
pass
def getNormal(self, *args, **kwargs):
"""
getNormal(space=kObject) -> MVector
getNormal(faceIndex, space=kObject) -> MVector
Return the normal or averaged normal if unshared of the current vertex.
* space (int) - The transformation space
Return the normal of the current vertex in the specified face.
* faceIndex (int) - face index to get normal for
* space (int) - The transformation space
"""
pass
def getNormalIndices(self, *args, **kwargs):
"""
getNormalIndices() -> MIntArray
This method returns the normal indices of the face/vertex associated
with the current vertex.
"""
pass
def getNormals(self, *args, **kwargs):
"""
getNormals(space=kObject) -> MVectorArray
Return the normals of the current vertex for all faces
* space (int) - The transformation space
"""
pass
def getOppositeVertex(self, *args, **kwargs):
"""
getOppositeVertex(edgeId) -> int
This method gets the other vertex of the given edge
* edgeId (int) - The edge to get the other vertex for
"""
pass
def getUV(self, *args, **kwargs):
"""
getUV(uvSet=None) -> [float, float]getUV(faceId, uvSet=None) -> [float, float]
Get the shared UV value at this vertex.
* uvSet (string) - Name of the uv set to work with.
Get the UV value for the give facen at the current vertex.
* faceId (int) - Index of the required face
* uvSet (string) - Name of the uv set to work with
"""
pass
def getUVIndices(self, *args, **kwargs):
"""
getUVIndices(uvSet=None) -> MIntArray
This method returns the uv indices into the normal array see MFnMesh::getUVs()
of the current vertex.
* uvSet (string) - Name of the uv set.
"""
pass
def getUVs(self, *args, **kwargs):
"""
getUVs(uvSet=None) -> [MFloatArray, MFloatArray, MIntArray]
Get the UV values for all mapped faces at the current vertex.
If at least one face was mapped the method will succeed.
* uvSet (string) - Name of the uv set to work with
"""
pass
def hasColor(self, *args, **kwargs):
"""
hasColor() -> bool
hasColor(index) -> bool
This method determines whether the current Vertex has a color set
for one or more faces.
* index (int) - Index of face to check
"""
pass
def index(self, *args, **kwargs):
"""
index() -> int
Returns the index of the current vertex in the vertex list for this
polygonal object.
Polygonal objects contain a list of vertices. Faces and edges are
specified as indicies from this list, in this way vertices can
be shared amoung faces and edges.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Indicates if all of the vertices have been traversed yet.
"""
pass
def next(self, *args, **kwargs):
"""
next() -> self
Advance to the next edge in the iteration.
"""
pass
def numConnectedEdges(self, *args, **kwargs):
"""
numConnectedEdges() -> int
This Method checks for the number of connected Edges on this vertex
"""
pass
def numConnectedFaces(self, *args, **kwargs):
"""
numConnectedFaces() -> int
This Method checks for the number of Connected Faces
"""
pass
def numUVs(self, *args, **kwargs):
"""
numUVs(uvSet=None) -> int
This method returns the number of unique UVs mapped on this vertex
* uvSet (string) - Name of the uv set to work with
"""
pass
def onBoundary(self, *args, **kwargs):
"""
onBoundary() -> bool
This method determines whether the current vertex is on a Boundary
"""
pass
def position(self, *args, **kwargs):
"""
position(space=kObject) -> MPoint
Return the position of the current vertex in the specified space.
Object space ignores all transformations for the polygon, world space
includes all such transformations.
* space (int) - The transformation space
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
reset(polyObject) -> self
reset(polyObject, component=None) -> self
Reset the iterator to the first polygon
Reset the iterator to the first polygon in the supplied polygon
* polyObject (MObject) - The polygon for the iteration
Reset the iterator with the given surface and component.
If component is None then the iteration will be for all vertices in the given polygon.
* polyObject (MDagPath) - The surface (mesh) to iterate over
* component (MObject) - The vertices of the polyObject to iterate over
"""
pass
def setIndex(self, *args, **kwargs):
"""
setIndex(index) -> int
This method sets the index of the current vertex to be accessed.
The current vertex will no longer be in sync with any previous iteration.
* index (int) - The index of desired vertex to access.
"""
pass
def setPosition(self, *args, **kwargs):
"""
setPosition(point, space=kObject) -> self
Set the position of the current vertex in the given space.
* point (MPoint) - The new position for the current vertex
* space (int) - The Transformation space
"""
pass
def setUV(self, *args, **kwargs):
"""
setUV(uvPoint, uvSet=None) -> selfsetUV(faceId, uvPoint, uvSet=None) -> self
Set the shared UV value at this vertex
* uvPoint ([float, float]) - The UV values to set
* uvSet (string) - Name of the UV set to work with
Set the UV value for the given face at the current vertex
* faceId (int) - Index of required face
* uvPoint ([float, float]) - The UV values to set
* uvSet (string) - Name of the UV set to work with
"""
pass
def setUVs(self, *args, **kwargs):
"""
setUVs(uArray, vArray, faceIds, uvSet=None) -> self
Set the UV value for the specified faces at the current vertex.
If the face is not already mapped, the value will not be set.
If at least ne face was previously mapped, the method should succeed.
If no faces were mapped, the method will fail.
* uArray (MFloatArray) - All the U values - in local face order
* vArray (MFloatArray) - The corresponding V values
* faceIds (MIntArray) - The corresponding face Ids
* uvSet (string) - UV set to work with
"""
pass
def translateBy(self, *args, **kwargs):
"""
translateBy(vector, space=kObject) -> self
Translate the current vertex by the amount specified
by the given vector.
* vector (MVector) - The amount of translation
* space (int) - The Transformation space
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
Signal that this polygonal surface has changed and needs to redraw itself.
"""
pass
class MItSelectionList(object):
"""
Class for iterating over the items in an MSelection list.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def getComponent(self, *args, **kwargs):
"""
getComponent() -> (MDagPath, MObject)
This method retrieves the dag path and the component of the current selection item.
"""
pass
def getDagPath(self, *args, **kwargs):
"""
getDagPath() -> MDagPath
This method retrieves the dag path of the current selection item.
"""
pass
def getDependNode(self, *args, **kwargs):
"""
getDependNode() -> MObject
This method retrieves the dependency node of the current selection item
"""
pass
def getPlug(self, *args, **kwargs):
"""
getPlug() -> MPlug
This method retrieves the plug of the current selection item.
"""
pass
def getStrings(self, *args, **kwargs):
"""
getStrings() -> list of strings
Get the string representation of the current item in the selection list.
It is possible that it will require more than one string to represent the item (the item may contain groups of CVs for example)
"""
pass
def hasComponents(self, *args, **kwargs):
"""
hasComponents() -> bool
Returns whether or not the current selection item has components.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Specifies whether or not there is anything more to iterator over.
"""
pass
def itemType(self, *args, **kwargs):
"""
itemType() -> int
Returns the current selection item type.
kDagSelectionItem selection item is in the DAG
kAnimSelectionItem selection item is a keyset
kDNselectionItem selection item is a dependency node
"""
pass
kAnimSelectionItem = 1
kDNselectionItem = 2
kDagSelectionItem = 0
kPlugSelectionItem = 3
kUnknownItem = -1
def next(self, *args, **kwargs):
"""
next() -> self
Advance to the next item. If components are selected then advance to next component.
If a filter is specified then the next item will be one that matches the filter.
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
Reset the iterator.
If a filter has been specified then the current item will be the first selected item that matches the filter.
"""
pass
def setFilter(self, *args, **kwargs):
"""
setFilter(filter) -> self
Apply a filter to the iteration.
Selection items not matching the filter type will be excluded from the iteration.
"""
pass
class MItSurfaceCV(object):
"""
NURBS surface CV iterator.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def currentItem(self, *args, **kwargs):
"""
currentItem() -> MObject
Get the current CV in the iteration as a component.
Components are used to specify one or more CVs and are useful in operating on groups of non-contiguous CVs for a curve or surface.
Components do not contain any information about the surface that they refer to so an MDagPath must be specified when dealing with components.
"""
pass
def hasHistoryOnCreate(self, *args, **kwargs):
"""
hasHistoryOnCreate() -> bool
This method determines if the shape was created with history.
If the object that this iterator is attached to is not a shape then this method will raise.
"""
pass
def index(self, *args, **kwargs):
"""
index() -> int
Get the index of the current CV as it appears in CV array for this surface.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Returns True if the iteration is finished, i.e. there are no more CVs to iterate on.
"""
pass
def isRowDone(self, *args, **kwargs):
"""
isRowDone() -> bool
Returns True if the current row has no more CVs to iterate over.
The row can be in the U or V direction depending on what value of useURows has been set in the constructor.
"""
pass
def next(self, *args, **kwargs):
"""
next() -> self
Advance to the next CV in the iteration.
If the iterator is already at the last CV then this method has no effect. Use isDone() to determine if the iterator is at the last CV.
"""
pass
def nextRow(self, *args, **kwargs):
"""
nextRow() -> self
Advance to the next row in the iteration.
The row can be in the U or V direction depending on what value of useURows has been set in the constructor.
"""
pass
def position(self, *args, **kwargs):
"""
position(space=kObject) -> MPoint
Returns the position of the current CV in the iteration in the specified space.
* space (int) - The coordinate space in which the CV is set
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
reset(surface, useURows=True) -> self
reset(surface, component, useURows=True) -> self
Reset the iterator to the first CV.
Or
Reset the iterator to iterate over all CVs on the specified surface.
* surface (MObject) - The surface for the iteration
* useURows (bool) - If True then the iterator will iterate in the U direction, otherwise it will be in the V direction.
Or
Reset the iterator to iterate over the CVs of the given surface that are specified in the given component. If the component is NULL then the iteration will be over all CVs on the surface.
* surface (MDagPath) - The surface for the iteration
* component (MObject) - A group of CVs to be iterated on
* useURows (bool) - If True then the iterator will iterate in the U direction, otherwise it will be in the V direction.
"""
pass
def setPosition(self, *args, **kwargs):
"""
setPosition(point, space=kObject) -> self
Set the position of the current CV in the iteration to the specified point.
* point (MPoint) - The new position for the current CV in the iteration
* space (int) - The coordinate space in which the CV is set
"""
pass
def translateBy(self, *args, **kwargs):
"""
translateBy(vector, space=kObject) -> self
Move the current CV in the iteration by the sepcified vector.
* vector (MVector) - The translation vector
* space (int) - The coordinate space in which the CV is set
"""
pass
def updateSurface(self, *args, **kwargs):
"""
updateSurface() -> self
This method is used to signal the surface that it has been changed and needs to redraw itself.
When modifying a large number of CVs, it is most efficient to call this method after all of the CVs have been modified.
"""
pass
def uvIndices(self, *args, **kwargs):
"""
uvIndices() -> (indexU, indexV)
Get the u and v index of the current CV.
"""
pass
class MLockMessage(MMessage):
"""
Class used to register callbacks for model related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kAddAttr = 5
kChildReorder = 4
kCreateChildInstance = 6
kCreateNodeInstance = 5
kCreateParentInstance = 7
kDefaultAction = 0
kDelete = 2
kDoAction = 2
kDoNotDoAction = 1
kGroup = 1
kInvalid = 0
kInvalidDAG = 0
kInvalidPlug = 0
kLast = 10
kLastDAG = 8
kLastPlug = 8
kLockAttr = 9
kLockNode = 3
kPlugAttrValChange = 3
kPlugConnect = 6
kPlugDisconnect = 7
kPlugLockAttr = 1
kPlugRemoveAttr = 4
kPlugRenameAttr = 5
kPlugUnlockAttr = 2
kRemoveAttr = 6
kRename = 1
kRenameAttr = 7
kReparent = 3
kUnGroup = 2
kUnlockAttr = 8
kUnlockNode = 4
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
def setNodeLockDAGQueryCallback(self, *args, **kwargs):
"""
setNodeLockDAGQueryCallback(dagPath, function, clientData=None) -> id
This methods registers a callback that is invoked in any situation
involving a locking condition on DAG level changes. When called,
the API user can make a decision on how to handle the given locking
situation. The programmer can either accept the default action, or
they can deny the default action. The decision is returned through a
decision variable which is passed to the callback function.
The callback function takes the following parameters:
* dagPath - The DAG path that the event occurred on.
* otherPath - The other path involved, e.g. the new parent.
* clientData - User defined data passed to the callback function.
* eventType - Description of the event.
And return True to accept the default behavior and False to
reject it.
The meanings of the dagPath and otherPath parameters for each
eventType, and default actions associated with those event types, are
as follows:
kGroup
* dagPath - Path of the node to be grouped.
* otherPath - Path of the group node.
* default actions - If dagPath
is locked then the default action is to not allow the grouping.
If dagPath is unlocked then dagPath
can be grouped with otherPath.
kUnGroup
* dagPath - Path of the node attempted to ungroup.
* otherPath - Path of the group node.
* default actions - If dagPath is locked then
the default action is to not allow the ungrouping. If dagPath
is unlocked then dagPath can be ungrouped from otherPath.
kReparent
* dagPath - Path of the node which is being reparented.
* otherPath - Path of the new parent, if any. When
reparenting to the world, otherPath will be invalid.
* default actions - If dagPath is locked then
the default action is to not allow the reparenting. If dagPath
is unlocked then dagPath can be parented to otherPath.
kChildReorder
* dagPath - Path of the child node to be reordered.
* otherPath - Path of the parent node.
* default actions - If dagPath is locked then
the default action is to not allow the reordering. If dagPath
is unlocked then dagPath can be reordered on otherPath.
kCreateNodeInstance
* dagPath - Path of the node which is being instanced.
* otherPath - Invalid Path.
* default actions - If dagPath is locked then
the default action is to not allow the instance to be created.
If dagPath is unlocked then dagPath can be instanced.
kCreateChildInstance
* dagPath - Path of the node whose child is being
instanced.
* otherPath - Path of the child node.
* default actions - If dagPath is locked then
the default action is to not allow the instance to be created.
If dagPath is unlocked then dagPath can be instanced.
* dagPath (MDagPath) - The path to attach the callback.
* function - the callback function (see below for the description)
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def setNodeLockQueryCallback(self, *args, **kwargs):
"""
setNodeLockQueryCallback(node, function, clientData=None) -> id
This methods registers a callback that is invoked in any locking
condition on node properties, e.g. name, lock status, etc. When
called, the API user can make a decision on how to handle the given
locking situation. The programmer can either accept the default
action, or they can deny the default action. The decision is returned
through a decision variable which is passed to the callback function.
The callback function takes the following parameters:
* node - The node that triggered the callback.
* aux - Any auxiliary data that may be needed, e.g.
the attribute about to be added.
* clientData - User defined data passed to the
callback function.
* eventType - Description of the event.
And return True to accept the default behavior and False to
reject it.
The meanings of the node and aux parameters for each
eventType, and default actions associated with those event types, are
as follows:
kRename
* node - The node that the user is attempting to rename.
* aux - MObject.kNullObj
* default actions - If node is locked then the
default action is to not allow the rename. Otherwise,
if node is unlocked then node can be renamed.
kDelete * node - The node that the user is attempting to delete.
* aux - MObject.kNullObj
* default actions - If node is locked then the
default action is to not allow the delete. If node is unlocked
then the node can be deleted.
kLockNode * node - The node that the user is attempting to lock.
* aux - MObject.kNullObj
* default actions - If node is unlocked then the
default action is to ALLOW the node to be locked. The callback
is not invoked when the user tries to unlock an already unlocked
node.
kUnlockNode * node - The node that the user is attempting to unlock.
* aux - MObject.kNullObj
* default actions - If node is locked then the
default action is to ALLOW the unlock. The callback is not invoked
when the user tries to unlock an already unlocked node.
kAddAttr * node - The node that is having an attribute added.
* aux - MObject of the attribute to be added. Note:
the attribute does not belong to the node yet. You can only
access the attribute information using MFnAttribute.
* default actions - If node is locked then the default
action is to not allow to the addition of aux. If node
is unlocked then aux can be added to the node.
kRemoveAttr
* node - The node that is having an attribute removed.
* aux - The attribute to be removed. In certain
situations the user is allowed to do a global delete,
e.g. deleteAttr -at AttrName [nodes]. In these cases the plug is not
created until checks have been performed; so aux ==
MObject.kNullObj
* default actions - If node is locked then the default
action is to not allow the attribute removal. If node is
unlocked then aux can be removed.
kRenameAttr
* node - The node that is having an attribute renamed.
* aux - The attribute.
* default actions - If node is locked then the default
action is to not allow the rename. If node is unlocked then
aux can be renamed.
kUnlockAttr
* node - The node that is having an attribute unlocked.
* aux - The attribute to be unlocked.
* default actions - If node is locked then the default
action is to not allow the unlock. If node is unlocked then
aux attribute can be unlocked.
kLockAttr
* node - The node that is having an attribute locked.
* aux - The attribute to be locked.
* default actions - If node is locked then the default
action is to not allow the locking of aux. If node is
unlocked then aux can be locked.
* node (MObject) - The node to register the callback for.
* function - the callback function (see below for description)
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def setPlugLockQueryCallback(self, *args, **kwargs):
"""
setPlugLockQueryCallback(plug, function, clientData=None) -> id
This method registers a callback that is invoked in any locking
condition on a plug, e.g. plug unlock, plug lock, connections, etc.
When the callback is invoked, the API programmer can make a decision on
how to handle the given locking situation. The programmer can either
accept the default action, or they can deny the default action.
The decision is made through the decision variable described above.
The callback function takes the following parameters:
* plug - The plug that triggered the callback.
* otherPlug - The other plug involved in the callback.
This is only valid during connect and disconnect events.
clientData - User defined data passed to the
callback function.
* eventType - Description of the event.
And return True to accept the default behavior and False to
reject it.
The meanings of the plug and otherPlug parameters for each
eventType, and default actions associated with those event types, are
as follows:
kPlugLockAttr
* plug - The plug that the user is attempting to lock.
* otherPlug - None.
* default actions - If plug is unlocked then the
default action is to allow the plug to be locked.
kPlugUnlockAttr
* plug - The plug that the user is attempting to unlock.
* otherPlug - None.
* default actions - If plug is locked then the
default action is to allow the plug to be unlocked.
kPlugAttrValChange
* plug - The plug that the user is attempting to change.
* otherPlug - None.
* default actions - If plug is locked then the
default action is to not allow plug to change. If plug is
unlocked then plug can change.
kPlugRemoveAttr
* plug - The plug that the user is attempting to remove.
* otherPlug - None.
* default actions - If plug is locked then the
default action is to not allow removal. Otherwise, if plug is
unlocked then plug can be removed.
kPlugRenameAttr
* plug - The plug that the user is attempting to rename.
* otherPlug - None.
* default actions - If plug is locked then the default
action is to not allow the rename. Otherwise, if plug is
unlocked then plug can be renamed.
kPlugConnect
* plug - The plug that is to be connected (incoming
connection).
* otherPlug - The source plug of the connection being made.
* default actions - If plug is locked then the
connection is DENIED. If plug is unlocked then otherPlug can
be connected to plug.
kPlugDisconnect
* plug - The plug that it is having an incoming connection broken.
* otherPlug - The source plug of the connection being made.
* default actions - If plug is locked then the
default action is to DENY the connection from being broken. If
plug is unlocked then otherPlug can be disconnected from
plug.
* plug (MPlug) - the plug to attach the callback
* function - the callback function (see below for description)
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
class MMatrix(object):
"""
4x4 matrix with double-precision elements.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __isub__(self, *args, **kwargs):
"""
x.__isub__(y) <==> x-=y
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __rsub__(self, *args, **kwargs):
"""
x.__rsub__(y) <==> y-x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def __sub__(self, *args, **kwargs):
"""
x.__sub__(y) <==> x-y
"""
pass
def adjoint(self, *args, **kwargs):
"""
Returns a new matrix containing this matrixs adjoint.
"""
pass
def det3x3(self, *args, **kwargs):
"""
Returns the determinant of the 3x3 matrix formed by the first 3 elements of the first 3 rows of this matrix.
"""
pass
def det4x4(self, *args, **kwargs):
"""
Returns this matrixs determinant.
"""
pass
def getElement(self, *args, **kwargs):
"""
Returns the matrix element for the specified row and column.
"""
pass
def homogenize(self, *args, **kwargs):
"""
Returns a new matrix containing the homogenized version of this matrix.
"""
pass
def inverse(self, *args, **kwargs):
"""
Returns a new matrix containing this matrixs inverse.
"""
pass
def isEquivalent(self, *args, **kwargs):
"""
Test for equivalence of two matrices, within a tolerance.
"""
pass
def isSingular(self, *args, **kwargs):
"""
Returns True if this matrix is singular.
"""
pass
def kIdentity(self, *args, **kwargs):
"""
4x4 matrix with double-precision elements.
"""
pass
def kTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
def setElement(self, *args, **kwargs):
"""
Sets the matrix element for the specified row and column.
"""
pass
def setToIdentity(self, *args, **kwargs):
"""
Sets this matrix to the identity.
"""
pass
def setToProduct(self, *args, **kwargs):
"""
Sets this matrix to the product of the two matrices passed in.
"""
pass
def transpose(self, *args, **kwargs):
"""
Returns a new matrix containing this matrixs transpose.
"""
pass
class MMatrixArray(object):
"""
Array of MMatrix values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MMeshIntersector(object):
"""
Provides methods for efficiently finding the closest point on
the surface of a mesh. An octree algorithm is used to find the
closest point.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def create(self, *args, **kwargs):
"""
create(mesh, matrix) -> self
Creates the internal data required by the intersector. It is a
compute-heavy operation and should only be called when necessary.
mesh (MObject) - the mesh to be used
matrix (MMatrix) - transformation to use to bring points into the
meshs object space.
"""
pass
def getClosestPoint(self, *args, **kwargs):
"""
getClosestPoint(referencePoint, maxDistance=sys.float_info.max) -> MPointOnMesh
Finds the closest point within maxDistance of the reference point
(MPoint) which lies on the surface of the mesh. The reference point
will first be transformed by the matrix passed in the create() call,
so if, for example, you want to specify reference points in world
space then the matrix passed to create() should provide the mapping
from world space to the meshs object space.
Returns an MPointOnMesh object if a closest point is found, or None
if no closest point is found (e.g. referencePoint is not within
maxDistance of the mesh).
Raises ValueError if create() has not yet been called for this
intersector.
"""
pass
@property
def isCreated(self, *args, **kwargs):
"""
True if the intersector has been created, False otherwise.
"""
pass
class MMeshIsectAccelParams(object):
"""
Opaque class used to store parameters used by MFnMeshs
intersection calculations for later re-use.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
class MMeshSmoothOptions(object):
"""
Options for control of smooth mesh generation.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
@property
def boundaryRule(self, *args, **kwargs):
"""
Determines how boundary edges and vertices are creased.
"""
pass
@property
def divisions(self, *args, **kwargs):
"""
Number of subdivisions used in smoothing.
"""
pass
kCatmullClark = 0
kCreaseAll = 1
kCreaseEdge = 2
kInvalid = -1
kInvalidSubdivision = -1
kLast = 3
kLastSubdivision = 4
kLegacy = 0
kOpenSubdivCatmullClarkAdaptive = 3
kOpenSubdivCatmullClarkUniform = 2
@property
def keepBorderEdge(self, *args, **kwargs):
"""
If True, border edges will not be smoothed.
"""
pass
@property
def keepHardEdge(self, *args, **kwargs):
"""
If True, hard edges will not be smoothed.
"""
pass
@property
def propEdgeHardness(self, *args, **kwargs):
"""
If True, the hardness of edges in the base cage will be propagated to the edges of the smoothed mesh which derive from them.
"""
pass
@property
def smoothUVs(self, *args, **kwargs):
"""
If True, UVs will be smoothed as well as geometry. If False, only geometry will be smoothed.
"""
pass
@property
def smoothness(self, *args, **kwargs):
"""
The degree of smoothness desired. Ranges from 0.0 (hard) to 1.0 (fully smoothed).
"""
pass
@property
def subdivisionType(self, *args, **kwargs):
"""
Determines subdivision algorithm used for mesh smoothing.
"""
pass
class MMessage(object):
"""
Base class for message callbacks.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MModelMessage(MMessage):
"""
Class used to register callbacks for model related messages.The class also provides the following Message constants which
describe the different types supported by the addCallback method:
kActiveListModified #active selection changes
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAfterDuplicateCallback(self, *args, **kwargs):
"""
addAfterDuplicateCallback(function, clientData=None) -> id
This method registers a callback that is called after a duplicate
command is made. The callback will be called after everything is
duplicated.
* function - callable which will be passed the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addBeforeDuplicateCallback(self, *args, **kwargs):
"""
addBeforeDuplicateCallback(function, clientData=None) -> id
This method registers a callback that is called whenever a duplicate
command is made. The callback will be called before anything is
duplicated.
* function - callable which will be passed the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addCallback(self, *args, **kwargs):
"""
addCallback(message, function, clientData=None) -> id
Adds a new callback for the specified model message.
* message (Message constant, see class doc for a list) - the model
message that will trigger the callback
* function - callable which will be passed the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeAddedToModelCallback(self, *args, **kwargs):
"""
addNodeAddedToModelCallback(dagNode, function, clientData=None) -> id
This method registers a callback that is called when a dag node is about
to be added to the Maya model.
* dagNode (MObject) - Node that should acquire the callback
* function - callable which will be passed a MObject indicating
the node being added to the model and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeRemovedFromModelCallback(self, *args, **kwargs):
"""
addNodeRemovedFromModelCallback(dagNode, function, clientData=None) -> id
This method registers a callback that is called when the
specified dag node is being removed from the Maya model.
* dagNode (MObject) - Node that should acquire the callback
* function - callable which will be passed a MObject indicating
the node being removed to the model and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kActiveListModified = 0
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MNodeClass(object):
"""
A class for performing node class-level operations in the dependency graph.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addExtensionAttribute(self, *args, **kwargs):
"""
Adds an extension attribute to the node class. An extension attribute is a class-level attribute which has been added dynamically to a node class. Because it is added at the class level, all nodes of that class will have the given attribute, and will only store the attributes value if it differs from the default. Returns the type of the object at the end of the path.
"""
pass
def attribute(self, *args, **kwargs):
"""
If passed an int: Returns the node classs ith attribute. Raises IndexError if index is out of bounds. If passed a string, Returns the node classs attribute having the given name. Returns MObject.kNullObj if the class does not have an attribute with that name.
"""
pass
@property
def attributeCount(self, *args, **kwargs):
"""
Number of attributes the node class has. Includes extension attributes, since those are applied to the entire node class, but not dynamic attributes, since those are only applied to individual nodes.
"""
pass
@property
def classification(self, *args, **kwargs):
"""
This is a string that is used in dependency nodes that are also shaders to provide more detailed type information to the rendering system.
"""
pass
def getAttributes(self, *args, **kwargs):
"""
Returns an MObjectArray array containing all of the node classs attributes.
"""
pass
def hasAttribute(self, *args, **kwargs):
"""
Returns True if the node class has an attribute of the given name, False otherwise.
"""
pass
@property
def pluginName(self, *args, **kwargs):
"""
File path of the plug-in in which the node class is defined. The empty string is returned for Mayas built-in node types.
"""
pass
def removeExtensionAttribute(self, *args, **kwargs):
"""
Removes an extension attribute from the node class. Raises ValueError if attr is not an extension attribute of this node class.
"""
pass
def removeExtensionAttributeIfUnset(self, *args, **kwargs):
"""
Removes an extension attribute from the node class, but only if there are no nodes in the graph with non-default values for this attribute. Returns True if the attribute was removed, False otherwise. Raises ValueError if attr is not an extension attribute of this node class.
"""
pass
@property
def typeId(self, *args, **kwargs):
"""
Type ID for the node class.
"""
pass
@property
def typeName(self, *args, **kwargs):
"""
Name of the node class. This is the name that is given to the createNode command to create nodes of this type.
"""
pass
class MNodeMessage(MMessage):
"""
Class used to register callbacks for dependency node messages of specific dependency nodes.
The class also provides the following AttributeMessage constants which describe
the type of attribute changed/addedOrRemoved messages that has occurred:
kConnectionMade #a connection has been made to an attribute of this node
kConnectionBroken #a connection has been broken for an attribute of this node
kAttributeEval #an attribute of this node has been evaluated
kAttributeSet #an attribute value of this node has been set
kAttributeLocked #an attribute of this node has been locked
kAttributeUnlocked #an attribute of this node has been unlocked
kAttributeAdded #an attribute has been added to this node
kAttributeRemoved #an attribute has been removed from this node
kAttributeRenamed #an attribute of this node has been renamed
kAttributeKeyable #an attribute of this node has been marked keyable
kAttributeUnkeyable #an attribute of this node has been marked unkeyable
kIncomingDirection #the connection was coming into the node
kAttributeArrayAdded #an array attribute has been added to this node
kAttributeArrayRemoved #an array attribute has been removed from this node
kOtherPlugSet #the otherPlug data has been set
The class also provides the following KeyableChangeMsg constants which
allows user to prevent attributes from becoming (un)keyable:
kKeyChangeInvalid
kMakeKeyable
kMakeUnkeyable
kKeyChangeLast
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttributeAddedOrRemovedCallback(self, *args, **kwargs):
"""
addAttributeAddedOrRemovedCallback(node, function, clientData=None) -> id
Registers callbacks for attribute add/removed messages.
This is a more specific version of addAttributeChanged as only attribute
added and attribute removed messages will trigger the callback.
* node (MObject) - the node to register the callback for
* function - callable which will be passed an AttributeMessage constant (see
class doc for a list) containing the kind of attribute change triggering
the callback, a MObject indicating the nodes plug where the connection
changed and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addAttributeChangedCallback(self, *args, **kwargs):
"""
addAttributeChangedCallback(node, function, clientData=None) -> id
This method registers a callback for attribute changed messages.
See the AttributeChanged enum for a list of all possible messages
that will trigger the callback.
Note: Attribute Changed messages will not be generated
while Maya is either in playback or scrubbing modes. If you need to
do something during playback or scrubbing you will have to register
a callback for the timeChanged message which is the only
message that is sent during those modes.
The callback function will be passed the type of attribute message
that has occurred, the plug(s) for the attributes, and any client
data that the user wishes to pass in.
* node (MObject) - the node to register the callback for
* function - callable which will be passed an AttributeMessage constant (see
class doc for a list) containing the kind of attribute change triggering
the callback, a MObject indicating the nodes plug where the connection
changed, a MObject indicating the plug opposite the nodes plug where the
connection changed and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addKeyableChangeOverride(self, *args, **kwargs):
"""
addKeyableChangeOverride(plug, function, clientData=None) -> id
This method registers a callback that is invoked by any class that
changes the keyable state of an attribute. When the callback is
invoked, the API programmer can make a decision on how to handle
the given keyable change event. The programmer can either accept
the keyable state change by returning True
or reject it by returning False.
Note: you can only attach one callback keyable change override
callback per attribute. It is an error to attach more than one
callback to the same attribute.
* plug (MPlug) - The plug to which to attach the callback.
* function - callable which will be passed a MPlug indicating the plug that
has triggered the callback, the clientData object, and a KeyableChangeMsg
constant (see class doc for a list) containing the kind of Keyable change
the callback, a MObject indicating the nodes plug where the connection.
User can return True to accept the keyable state change or False to reject it.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNameChangedCallback(self, *args, **kwargs):
"""
addNameChangedCallback(node, function, clientData=None) -> id
Registers a callback for name changed messages.
* node (MObject) - the node. If this is a NULL MObject then the callback
applies to all node name changes.
* function - callable which will be passed a MObject indicating the node whose
names changed, a string containing the previous name of the node and the
clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeAboutToDeleteCallback(self, *args, **kwargs):
"""
addNodeAboutToDeleteCallback(node, function, clientData=None) -> id
Registers a callback which will get called when a node is about to
be deleted.
The callback will be passed the MDGModifer that will be used to
delete the node. This modifier can be used to do any DG modifications,
such as disconnections, before the node is deleted. These operations are
also stored and performed when the deletion operation is undone or redone.
The callback registered with this method will only get called when the
deletion operation is first performed. Undos and redos will be handled solely
through the MDGModifier which was passed to the callback on the original
deletion. If you also wish to receive notification of deletion events
when they are redone, you should register an additional callback using
addNodePreRemovalCallback().
When a node is deleted Maya automatically breaks all connections to that
node. This process takes place after the callback has been called. This
means that if you use the passed-in MDGModifier to break any
connections to the node you must be sure to call the modifiers doIt() method
before returning from the callback. Otherwise Maya will see that the connections
still exist and try to delete them again, which can lead to errors.
Note that it uses the passed-in MDGModifier to perform all the disconnections and
connections. This ensures that if the deletion is undone or redone then all of
the connections will be restored correctly.
After it is done breaking connections, the callback calls the
modifiers doIt() method to commit those disconnections. As noted
above, this is necessary to ensure that Maya doesnt see the
connections and try to break them again later on.
* node (MObject) - the node to register the callback for
* function - callable which will be passed a MObject indicating the node that
will be deleted, a MDGModifier indicating the DG modifier used to delete the
node and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeDestroyedCallback(self, *args, **kwargs):
"""
addNodeDestroyedCallback(node, function, clientData=None) -> id
Registers a callback which will get called when a nodes destructor is
called.
* node (MObject) - the node to register the callback for
* function - callable which will be passed the clientData object
* clientData - User defined data that will be passed to the callback
function
* return: Identifier used for removing the callback.
"""
pass
def addNodeDirtyCallback(self, *args, **kwargs):
"""
addNodeDirtyCallback(node, function, clientData=None) -> id
Registers a callback for node dirty messages.
* node (MObject) - the node to register the callback for
* function - callable which will be passed a MObject indicating the node
that has become dirty and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodeDirtyPlugCallback(self, *args, **kwargs):
"""
addNodeDirtyPlugCallback(node, function, clientData=None) -> id
Registers a callback for node dirty messages. This callback provides
the plug on the node that was dirtied. Only provides dirty information
on input plugs.
* node (MObject) - the node to register the callback for
* function - callable which will be passed a MObject indicating the node
that has become dirty, a MPlug indicating the plug on the node that has
become dirty and the clientData object * clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addNodePreRemovalCallback(self, *args, **kwargs):
"""
addNodePreRemovalCallback(node, function, clientData=None) -> id
Registers a callback which will get called before a node is deleted.
This callback is called before connections on the node are removed.
Unlike the aboutToDelete callback, this callback will be invoked whenever
the node is deleted, even during a redo.
Pre-removal and aboutToDelete callbacks serve different purposes. If DG
changes need to be made when a node is deleted, the aboutToDelete callback
should be used to add undoable operations to an MDGModifier to perform
these changes. When the desired actions cannot be accomplished using the
MDGModifier passed to the aboutToDelete callback, this callback can be
used to receive notification of the deletion event, even during redo.
Note that this callback method should not perform any DG operations.
* node (MObject) - the node to register the callback for
* function - callable which will be passed a MObject indicating the node
that is being deleted and the clientData object
* clientData - User defined data that will be passed to the callback
function
* return: Identifier used for removing the callback.
"""
pass
def addUuidChangedCallback(self, *args, **kwargs):
"""
addUuidChangedCallback(node, function, clientData=None) -> id
Registers a callback for UUID changed messages.
* node (MObject) - the node to register the callback for
* function - callable which will be passed a MObject indicating the node
that is being modified, a MUuid containing the previous UUID of the node
and the clientData object
* clientData - User defined data that will be passed to the callback
function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kAttributeAdded = 64
kAttributeArrayAdded = 4096
kAttributeArrayRemoved = 8192
kAttributeEval = 4
kAttributeKeyable = 512
kAttributeLocked = 16
kAttributeRemoved = 128
kAttributeRenamed = 256
kAttributeSet = 8
kAttributeUnkeyable = 1024
kAttributeUnlocked = 32
kConnectionBroken = 2
kConnectionMade = 1
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
kIncomingDirection = 2048
kKeyChangeInvalid = 0
kKeyChangeLast = 3
kLast = 32768
kMakeKeyable = 1
kMakeUnkeyable = 2
kOtherPlugSet = 16384
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MObject(object):
"""
Opaque wrapper for internal Maya objects.
"""
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def apiType(self, *args, **kwargs):
"""
Returns the function set type for the object.
"""
pass
@property
def apiTypeStr(self, *args, **kwargs):
"""
(readonly) String containing the objects type name.
"""
pass
def hasFn(self, *args, **kwargs):
"""
Tests whether object is compatible with the specified function set.
"""
pass
def isNull(self, *args, **kwargs):
"""
Tests whether there is an internal Maya object.
"""
pass
def kNullObj(self, *args, **kwargs):
"""
Opaque wrapper for internal Maya objects.
"""
pass
class MObjectArray(object):
"""
Array of MObject values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MObjectHandle(object):
"""
Generic Class for validating MObjects.
"""
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def assign(self, *args, **kwargs):
"""
assign(source) -> self
Assigns this MObjectHandle to an instance of another MObjectHandle, or to a MObject instance.
* source (MObject/MObjectHandle) - other instance to assign from.
"""
pass
def hashCode(self, *args, **kwargs):
"""
hashCode() -> int
Returns a hash code for the internal Maya object referenced by the MObject within this MObjectHandle. If the MObject is null or no longer alive then 0 will be returned, otherwise the hash code is guaranteed to be non-zero
"""
pass
def isAlive(self, *args, **kwargs):
"""
isAlive() -> bool
Returns the live state of the associated MObject. An object can still be alive but not valid (eg. a deleted object that resides in the undo queue).
"""
pass
def isValid(self, *args, **kwargs):
"""
isValid() -> bool
Returns the validity of the associated MObject.
"""
pass
def object(self, *args, **kwargs):
"""
object() -> MObject
Returns the MObject associated with this handle. The returned MObject will be MObject.kNullObj if the object is invalid.
"""
pass
class MObjectSetMessage(MMessage):
"""
Class used to register callbacks for set modified related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addSetMembersModifiedCallback(self, *args, **kwargs):
"""
addSetMembersModifiedCallback(node, function, clientData=None) -> id
Registers callbacks for set modified messages.
* node (MObject) - the set that has triggered a setModified event
* function (MMessage::MNodeFunction) - the callback function
* function - callable which will be passed a MObject indicating the
set that has triggered a setModified event and the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MPlane(object):
"""
This class describes a mathematical plane.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def distance(self, *args, **kwargs):
"""
distance() -> float
Returns the distance of the plane along the normal.
"""
pass
def distanceToPoint(self, *args, **kwargs):
"""
distanceToPoint(point, signed=False) -> float
Returns the distance from the plane to the specified point.
* point (MVector) - The point from which to calculate the distance
* signed (bool) - Whether to return a signed or unsigned distance
"""
pass
def normal(self, *args, **kwargs):
"""
normal() -> MVector
Returns the normal of the plane.
"""
pass
def setPlane(self, *args, **kwargs):
"""
setPlane(a, b, c, d) -> self
setPlane(n, d) -> self
Set the equation of the plane.
From values : ax + by + cz + d = 0
* a (float) - The plane equations x coefficent
* b (float) - The plane equations y coefficent
* c (float) - The plane equations z coefficent
* d (float) - The plane equations constant distance term
From a normal and offset
* n (MVector) - The planes normal
* d (float) - The offset of the plane along the normal
"""
pass
class MPlug(object):
"""
Create and access dependency node plugs.
"""
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def array(self, *args, **kwargs):
"""
Returns a plug for the array of plugs of which this plug is an element.
"""
pass
def asBool(self, *args, **kwargs):
"""
Retrieves the plugs value, as a boolean.
"""
pass
def asChar(self, *args, **kwargs):
"""
Retrieves the plugs value, as a single-byte integer.
"""
pass
def asDouble(self, *args, **kwargs):
"""
Retrieves the plugs value, as a double-precision float.
"""
pass
def asFloat(self, *args, **kwargs):
"""
Retrieves the plugs value, as a single-precision float.
"""
pass
def asInt(self, *args, **kwargs):
"""
Retrieves the plugs value, as a regular integer.
"""
pass
def asMAngle(self, *args, **kwargs):
"""
Retrieves the plugs value, as an MAngle.
"""
pass
def asMDataHandle(self, *args, **kwargs):
"""
Retrieve the current value of the attribute this plug references.
"""
pass
def asMDistance(self, *args, **kwargs):
"""
Retrieves the plugs value, as an MDistance.
"""
pass
def asMObject(self, *args, **kwargs):
"""
Retrieves the plugs value, as as an MObject containing a direct reference to the plugs data.
"""
pass
def asMTime(self, *args, **kwargs):
"""
Retrieves the plugs value, as an MTime.
"""
pass
def asShort(self, *args, **kwargs):
"""
Retrieves the plugs value, as a short integer.
"""
pass
def asString(self, *args, **kwargs):
"""
Retrieves the plugs value, as a string.
"""
pass
def attribute(self, *args, **kwargs):
"""
Returns the attribute currently referenced by this plug.
"""
pass
def child(self, *args, **kwargs):
"""
Returns a plug for the specified child attribute of this plug.
"""
pass
def connectedTo(self, *args, **kwargs):
"""
Returns an array of plugs which are connected to this one.
"""
pass
def connectionByPhysicalIndex(self, *args, **kwargs):
"""
Returns a plug for the indexth connected element of this plug.
"""
pass
def constructHandle(self, *args, **kwargs):
"""
Constructs a data handle for the plug.
"""
pass
def copy(self, *args, **kwargs):
"""
Copies one plug to another.
"""
pass
def destructHandle(self, *args, **kwargs):
"""
Destroys a data handle previously constructed using constructHandle().
"""
pass
def elementByLogicalIndex(self, *args, **kwargs):
"""
Returns a plug for the element of this plug array having the specified logical index.
"""
pass
def elementByPhysicalIndex(self, *args, **kwargs):
"""
Returns a plug for the element of this plug array having the specified physical index.
"""
pass
def evaluateNumElements(self, *args, **kwargs):
"""
Like numElements() but evaluates all connected elements first to ensure that they are included in the count.
"""
pass
def getExistingArrayAttributeIndices(self, *args, **kwargs):
"""
Returns an array of all the plugs logical indices which are currently in use.
"""
pass
def getSetAttrCmds(self, *args, **kwargs):
"""
Returns a list of strings containing the setAttr commands (in MEL syntax) for this plug and all of its descendents.
"""
pass
@property
def info(self, *args, **kwargs):
"""
Description of the plug for debugging purposes, in the form node:attr1.attr2[].attr3...
"""
pass
@property
def isArray(self, *args, **kwargs):
"""
True if plug is an array of plugs.
"""
pass
@property
def isCaching(self, *args, **kwargs):
"""
True if plugs value is being cached.
"""
pass
@property
def isChannelBox(self, *args, **kwargs):
"""
True if plug will appear in Mayas Channel Box.
"""
pass
@property
def isChild(self, *args, **kwargs):
"""
True if plug is a child of a compound parent.
"""
pass
@property
def isCompound(self, *args, **kwargs):
"""
True if plug is compound parent with children.
"""
pass
@property
def isConnected(self, *args, **kwargs):
"""
True if plug has any connections.
"""
pass
@property
def isDestination(self, *args, **kwargs):
"""
True if plug is the destination of a connection.
"""
pass
@property
def isDynamic(self, *args, **kwargs):
"""
True if plug is for a dynamic attribute.
"""
pass
@property
def isElement(self, *args, **kwargs):
"""
True if plug is an element of an array of plugs.
"""
pass
def isFreeToChange(self, *args, **kwargs):
"""
Returns a value indicating if the plugs value can be changed, after taking into account the effects of locking and connections.
"""
pass
@property
def isFromReferencedFile(self, *args, **kwargs):
"""
True if plug is part of a connection from a referenced file.
"""
pass
@property
def isIgnoredWhenRendering(self, *args, **kwargs):
"""
True if connetions to plug are ignored during rendering.
"""
pass
@property
def isKeyable(self, *args, **kwargs):
"""
True if keys can be set on plug from Mayas UI.
"""
pass
@property
def isLocked(self, *args, **kwargs):
"""
True if plug is locked against changes.
"""
pass
@property
def isNetworked(self, *args, **kwargs):
"""
True if plug is networked.
"""
pass
@property
def isNull(self, *args, **kwargs):
"""
True if plug does not reference an attribute.
"""
pass
@property
def isProcedural(self, *args, **kwargs):
"""
True if plug is procedural.
"""
pass
@property
def isSource(self, *args, **kwargs):
"""
True if plug is the source of a connection.
"""
pass
kAll = 0
kChanged = 2
kChildrenNotFreeToChange = 2
kFreeToChange = 0
kLastAttrSelector = 3
kNonDefault = 1
kNotFreeToChange = 1
def logicalIndex(self, *args, **kwargs):
"""
Returns this plugs logical index within its parent array.
"""
pass
def name(self, *args, **kwargs):
"""
Returns the name of the plug.
"""
pass
def node(self, *args, **kwargs):
"""
Returns the node that this plug belongs to.
"""
pass
def numChildren(self, *args, **kwargs):
"""
Returns the number of children this plug has.
"""
pass
def numConnectedChildren(self, *args, **kwargs):
"""
Returns the number of this plugs children which have connections.
"""
pass
def numConnectedElements(self, *args, **kwargs):
"""
Returns the number of this plugs elements which have connections.
"""
pass
def numElements(self, *args, **kwargs):
"""
Returns the number of the plugs logical indices which are currently in use. Connected elements which have not yet been evaluated may not yet fully exist and may be excluded from the count.
"""
pass
def parent(self, *args, **kwargs):
"""
Returns a plug for the parent of this plug.
"""
pass
def partialName(self, *args, **kwargs):
"""
Returns the name of the plug, formatted according to various criteria.
"""
pass
def selectAncestorLogicalIndex(self, *args, **kwargs):
"""
Changes the logical index of the specified attribute in the plugs path.
"""
pass
def setAttribute(self, *args, **kwargs):
"""
Switches the plug to reference the given attribute of the same node as the previously referenced attribute.
"""
pass
def setBool(self, *args, **kwargs):
"""
Sets the plugs value as a boolean.
"""
pass
def setChar(self, *args, **kwargs):
"""
Sets the plugs value as a single-byte integer.
"""
pass
def setDouble(self, *args, **kwargs):
"""
Sets the plugs value as a double-precision float.
"""
pass
def setFloat(self, *args, **kwargs):
"""
Sets the plugs value as a single-precision float.
"""
pass
def setInt(self, *args, **kwargs):
"""
Sets the plugs value as a regular integer.
"""
pass
def setMAngle(self, *args, **kwargs):
"""
Sets the plugs value as an MAngle.
"""
pass
def setMDataHandle(self, *args, **kwargs):
"""
Sets the plugs value as a data handle.
"""
pass
def setMDistance(self, *args, **kwargs):
"""
Sets the plugs value as an MDistance.
"""
pass
def setMObject(self, *args, **kwargs):
"""
Sets the plugs value as an MObject.
"""
pass
def setMPxData(self, *args, **kwargs):
"""
Sets the plugs value using custom plug-in data.
"""
pass
def setMTime(self, *args, **kwargs):
"""
Sets the plugs value as an MTime.
"""
pass
def setNumElements(self, *args, **kwargs):
"""
Pre-allocates space for count elements in an array of plugs.
"""
pass
def setShort(self, *args, **kwargs):
"""
Sets the plugs value as a short integer.
"""
pass
def setString(self, *args, **kwargs):
"""
Sets the plugs value as a string.
"""
pass
class MPlugArray(object):
"""
Array of MPlug values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MPoint(object):
"""
3D point with double-precision coordinates.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __div__(self, *args, **kwargs):
"""
x.__div__(y) <==> x/y
"""
pass
def __eq__(self, *args, **kwargs):
"""
x.__eq__(y) <==> x==y
"""
pass
def __ge__(self, *args, **kwargs):
"""
x.__ge__(y) <==> x>=y
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __gt__(self, *args, **kwargs):
"""
x.__gt__(y) <==> x>y
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __isub__(self, *args, **kwargs):
"""
x.__isub__(y) <==> x-=y
"""
pass
def __le__(self, *args, **kwargs):
"""
x.__le__(y) <==> x<=y
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __lt__(self, *args, **kwargs):
"""
x.__lt__(y) <==> x<y
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(y) <==> x*y
"""
pass
def __ne__(self, *args, **kwargs):
"""
x.__ne__(y) <==> x!=y
"""
pass
def __radd__(self, *args, **kwargs):
"""
x.__radd__(y) <==> y+x
"""
pass
def __rdiv__(self, *args, **kwargs):
"""
x.__rdiv__(y) <==> y/x
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(y) <==> y*x
"""
pass
def __rsub__(self, *args, **kwargs):
"""
x.__rsub__(y) <==> y-x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def __sub__(self, *args, **kwargs):
"""
x.__sub__(y) <==> x-y
"""
pass
def cartesianize(self, *args, **kwargs):
"""
Convert point to cartesian form.
"""
pass
def distanceTo(self, *args, **kwargs):
"""
Return distance between this point and another.
"""
pass
def homogenize(self, *args, **kwargs):
"""
Convert point to homogenous form.
"""
pass
def isEquivalent(self, *args, **kwargs):
"""
Test for equivalence of two points, within a tolerance.
"""
pass
def kOrigin(self, *args, **kwargs):
"""
3D point with double-precision coordinates.
"""
pass
def kTolerance(self, *args, **kwargs):
"""
float(x) -> floating point number
Convert a string or number to a floating point number, if possible.
"""
pass
def rationalize(self, *args, **kwargs):
"""
Convert point to rational form.
"""
pass
@property
def w(self, *args, **kwargs):
"""
W coordinate
"""
pass
@property
def x(self, *args, **kwargs):
"""
X coordinate
"""
pass
@property
def y(self, *args, **kwargs):
"""
Y coordinate
"""
pass
@property
def z(self, *args, **kwargs):
"""
Z coordinate
"""
pass
class MPointArray(object):
"""
Array of MPoint values.
"""
def __add__(self, *args, **kwargs):
"""
x.__add__(y) <==> x+y
"""
pass
def __contains__(self, *args, **kwargs):
"""
x.__contains__(y) <==> y in x
"""
pass
def __delitem__(self, *args, **kwargs):
"""
x.__delitem__(y) <==> del x[y]
"""
pass
def __delslice__(self, *args, **kwargs):
"""
x.__delslice__(i, j) <==> del x[i:j]
Use of negative indices is not supported.
"""
pass
def __getitem__(self, *args, **kwargs):
"""
x.__getitem__(y) <==> x[y]
"""
pass
def __getslice__(self, *args, **kwargs):
"""
x.__getslice__(i, j) <==> x[i:j]
Use of negative indices is not supported.
"""
pass
def __iadd__(self, *args, **kwargs):
"""
x.__iadd__(y) <==> x+=y
"""
pass
def __imul__(self, *args, **kwargs):
"""
x.__imul__(y) <==> x*=y
"""
pass
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __len__(self, *args, **kwargs):
"""
x.__len__() <==> len(x)
"""
pass
def __mul__(self, *args, **kwargs):
"""
x.__mul__(n) <==> x*n
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __rmul__(self, *args, **kwargs):
"""
x.__rmul__(n) <==> n*x
"""
pass
def __setitem__(self, *args, **kwargs):
"""
x.__setitem__(i, y) <==> x[i]=y
"""
pass
def __setslice__(self, *args, **kwargs):
"""
x.__setslice__(i, j, y) <==> x[i:j]=y
Use of negative indices is not supported.
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def append(self, *args, **kwargs):
"""
Add a value to the end of the array.
"""
pass
def clear(self, *args, **kwargs):
"""
Remove all elements from the array.
"""
pass
def copy(self, *args, **kwargs):
"""
Replace the array contents with that of another or of a compatible Python sequence.
"""
pass
def insert(self, *args, **kwargs):
"""
Insert a new value into the array at the given index.
"""
pass
def remove(self, *args, **kwargs):
"""
Remove an element from the array.
"""
pass
def setLength(self, *args, **kwargs):
"""
Grow or shrink the array to contain a specific number of elements.
"""
pass
@property
def sizeIncrement(self, *args, **kwargs):
"""
Number of elements by which to grow the array when necessary.
"""
pass
class MPointOnMesh(object):
"""
This class is used to return information about a point on the
surface of a mesh: 3D position, normal, barycentric coordinates,
etc. The point can be anywhere on the mesh, not just at its
vertices.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
@property
def barycentricCoords(self, *args, **kwargs):
"""
(float, float) Tuple containing the barycentric coordinates of the
point. If the triangle has vertices (A, B, C) then barycentric
coordinates of (u, v) mean that the 3D position of the point is
u*A + v*B + (1 - u - v)*C. The barycentric coordinates are
particularly useful when interpolating attributes from one mesh to
another.
"""
pass
@property
def face(self, *args, **kwargs):
"""
(int) Mesh-global index of the face containing the point.
"""
pass
@property
def normal(self, *args, **kwargs):
"""
(MFloatVector) Surface normal vector at the point.
"""
pass
@property
def point(self, *args, **kwargs):
"""
(MFloatPoint) 3D position of the point.
"""
pass
@property
def triangle(self, *args, **kwargs):
"""
(int) Face-local index of the triangle containing the point.
"""
pass
class MPolyMessage(MMessage):
"""
Class used to register callbacks for poly related messages.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addPolyComponentIdChangedCallback(self, *args, **kwargs):
"""
addPolyComponentIdChangedCallback(node, (wantVertIds, wantEdgeIds, wantFaceIds), function, clientData=None) -> id
This method registers a callback that should be called whenever a poly
component id is modified.
Currently, there are some cases where the component ids for a polygonal
mesh can be modified without generating a callback or without generating a
correct mapping. These cases are outlined below.
- Polygonal mesh has construction history enabled, and there is more than
one topology changing operation in the history. In this case, the
callback is only called when the component ID mapping changes for the
most recent operation, and performs the mapping with respect to the
input and output meshes for this operation node.
- Polygonal mesh has construction history enabled, and the most recent
topology changing operation is no longer the most recent operation.
In this case, no id remapping callbacks will be invoked when the
attributes on the operation node are changed in the history.
- When undo is used to revert a topology changing operation, the callback
will not be invoked. The MEventMessage class can be used to get
notification when undo is performed.
Component id mapping should always work correctly when construction history
is off. It should also work correctly when construction history is on and
only the most recent operation is permitted to be adjusted (eg. changing
the distance parameter for a merge vertex node, when merge vertices was the
most recent operation.) In either case, undo will not produce a poly
message callback.
* node (MObject) - the node the callback function should listen to
*(wantVertIds, wantEdgeIds, wantFaceIds) - tuple of 3 booleans specifying
what arrays should be provided to the callback function when it is
invoked: (vertex indices, edge indices, face indices).
* function - callable which will be passed a tuple and the clientData object.
The tuple will contain three MUintArrays which are, respectively, the vertex,
edge and face ids of the modified components. Only the arrays which were requested
when the callback was registered will contain data, the others will be empty.
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def addPolyTopologyChangedCallback(self, *args, **kwargs):
"""
addPolyTopologyChangedCallback(node, function, clientData=None) -> id
This method registers a callback that will be called when a node impacting
the topology of a meshShape is modified. Because the callback is invoked
before the mesh has evaluated, the new topology data cannot be
queried at the time the callback is received. If you want to receive a
callback at a time when the new mesh data can be queried, use the
following technique:
- Use this method to register a topology-changed callback.
- In the topology-changed callback, add an MNodeMessage.addAttributeChangedCallback on the mesh shape.
- In the attribute-changed callback, check the inputs for an MNodeMessage.kAttributeEval message received by the outMesh plug of the mesh.
- Once you have received the eval message on that plug, the attribute-changed callback can be removed and the mesh topology can be queried.
* node (MObject) - the node the callback function should listen to
* function - callable which will be passed the clientData object
* clientData - User defined data passed to the callback function
* return: Identifier used for removing the callback.
"""
pass
def currentCallbackId(self, *args, **kwargs):
"""
currentCallbackId() -> id
Returns the callback ID of the currently executing callback. If called
outside of a callback, an invalid MCallbackId and failed status will
be returned.
"""
pass
kDefaultAction = 0
kDoAction = 2
kDoNotDoAction = 1
def nodeCallbacks(self, *args, **kwargs):
"""
nodeCallbacks(node) -> ids
Returns a list of callback IDs registered to a given node.
* node (MObject) - Node to query for callbacks.
* ids (MCallbackIdArray) - Array to store the list of callback IDs.
"""
pass
def removeCallback(self, *args, **kwargs):
"""
removeCallback(id) -> None
Removes the specified callback from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* id (MCallbackId) - identifier of callback to be removed
"""
pass
def removeCallbacks(self, *args, **kwargs):
"""
removeCallbacks(ids) -> None
Removes all of the specified callbacks from Maya.
This method must be called for all callbacks registered by a
plug-in before that plug-in is unloaded.
* idList (MCallbackIdArray) - list of callbacks to be removed.
"""
pass
class MPxAttributePatternFactory(object):
"""
Base class for custom attribute pattern factories.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
class MPxCommand(object):
"""
Base class for custom commands.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def appendToResult(self, *args, **kwargs):
"""
Append a value to the result to be returned by the command.
"""
pass
def clearResult(self, *args, **kwargs):
"""
Clears the commands result.
"""
pass
@property
def commandString(self, *args, **kwargs):
"""
Command string to be echoed to the user.
"""
pass
def currentResult(self, *args, **kwargs):
"""
Returns the commands current result.
"""
pass
def currentResultType(self, *args, **kwargs):
"""
Returns the type of the current result.
"""
pass
def displayError(self, *args, **kwargs):
"""
Display an error message.
"""
pass
def displayInfo(self, *args, **kwargs):
"""
Display an informational message.
"""
pass
def displayWarning(self, *args, **kwargs):
"""
Display a warning message.
"""
pass
def doIt(self, *args, **kwargs):
"""
Called by Maya to execute the command.
"""
pass
def hasSyntax(self, *args, **kwargs):
"""
Called by Maya to determine if the command provides an MSyntax object describing its syntax.
"""
pass
@property
def historyOn(self, *args, **kwargs):
"""
Determines if construction history is on for the command.
"""
pass
def isCurrentResultArray(self, *args, **kwargs):
"""
Returns true if the commands current result is an array of values.
"""
pass
def isUndoable(self, *args, **kwargs):
"""
Called by Maya to determine if the command supports undo.
"""
pass
kDouble = 1
kLong = 0
kNoArg = 3
kString = 2
def redoIt(self, *args, **kwargs):
"""
Called by Maya to redo a previously undone command.
"""
pass
def setResult(self, *args, **kwargs):
"""
Set the value of the result to be returned by the command.
"""
pass
def syntax(self, *args, **kwargs):
"""
Returns the commands MSyntax object, if it has one.
"""
pass
def undoIt(self, *args, **kwargs):
"""
Called by Maya to undo a previously executed command.
"""
pass
class MPxData(object):
"""
Base Class for User-defined Dependency Graph Data Types.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def copy(self, *args, **kwargs):
"""
copy(src) -> self
This method initializes an instance of an MPxData derived class from another existing instance. This method can be thought of as the second half of a copy constructor for the class. The default constructor has already been called for the instance, and this method is used to set the private data by copying the values from an existing instance.
This method must be implemented by the derived class.
* src (MPxData) - The object from which to copy the private data
"""
pass
kData = 0
kGeometryData = 1
kLast = 2
def name(self, *args, **kwargs):
"""
name() -> string
Returns the name of the custom data type.
This method must be implemented by the derived class.
"""
pass
def readASCII(self, *args, **kwargs):
"""
readASCII(argList, endOfTheLastParsedElement) -> int
Creates Data in Data Block as specified by input from ASCII file record.
Returns the new last argument parsed by this method.
* argList (MArgList) - List of arguments read from ASCII record* endOfTheLastParsedElement (int) - points to last argument already parsed.
"""
pass
def readBinary(self, *args, **kwargs):
"""
readBinary(in, length) -> int
Creates Data in Data Block as specified by binary data from the given stream.
Returns the numbers of data bytes processed.
* in (bytearray) - Input stream
* length (int) - Length in bytes of binary data to be read.
"""
pass
def typeId(self, *args, **kwargs):
"""
typeId() -> MTypeId
Determines the type id of the Data object.
This method must be implemented by the derived class.
"""
pass
def writeASCII(self, *args, **kwargs):
"""
writeASCII() -> string
Encodes Data in accordance with the ASCII file format and returns as string.
"""
pass
def writeBinary(self, *args, **kwargs):
"""
writeBinary() -> bytearray
Encodes Data in accordance with the binary file format and returns as bytearray.
"""
pass
class MPxGeometryData(MPxData):
"""
Base Class for User-defined Dependency Graph Geometry Data Types.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def copy(self, *args, **kwargs):
"""
copy(src) -> self
This method initializes an instance of an MPxData derived class from another existing instance. This method can be thought of as the second half of a copy constructor for the class. The default constructor has already been called for the instance, and this method is used to set the private data by copying the values from an existing instance.
This method must be implemented by the derived class.
* src (MPxData) - The object from which to copy the private data
"""
pass
def deleteComponent(self, *args, **kwargs):
"""
deleteComponent(compList) -> bool
This method should be overridden if this data is to support component deletion. For user defined shapes (MPxSurfaceShape) which support components, this method must be overridden if component deletion is to be supported when the shape has history.
Returns True if the deletion was successfull, False otherwise.
* compList (MObjectArray) - a list of components that are to be deleted
"""
pass
def deleteComponentsFromGroups(self, *args, **kwargs):
"""
deleteComponentsFromGroups(compList, groupIdArray, groupComponentArray) -> bool
This method should be overridden to modify the groups that flows along with the geometry, as part of the data, based on the components being deleted. It should intelligently update the groups based on what gets deleted. The class MFnGeometryData can be used to access and modify grouping information for data.
Returns True if the deletion was successfull, False otherwise.
The groupIdArray and groupComponentArray should contain the updated grouping information after the deletion has occurred.
* compList (MObjectArray) - a list of components that are to be deleted
* groupIdArray [OUT] (MIntArray) - array of group ids
* groupComponentArray (MObjectArray) - array of updated components, one for each group id
"""
pass
def getMatrix(self, *args, **kwargs):
"""
getMatrix(matrix) -> bool
Gets the matrix associated to MPxGeometryData and retursn True if is identity
* matrix [OUT] (MMatrix) - the returned matrix that takes a point from local object space to world space.
"""
pass
def iterator(self, *args, **kwargs):
"""
iterator(componentList, component, useComponents, world=None) -> MPxGeometryIterator
Associates a control point based geometry iterator with this data.
This method is used in conjunction with MPxSurfaceShape and should be overridden if your shape is to support mayas deformations.
The useComponents argument specifies whether the iteration is over the given componentList or the component.
Returns an iterator for your geometry.
* componentList (MObjectArray) - a list of components that are to be iterated over.
* component (MObject) - a component to be iterator over.
* useComponents (bool) - if True then componentList is to be iterated over, otherwise the iteration is on component.
* world (bool) - specifies whether the iteration is for world space data.
"""
pass
kData = 0
kGeometryData = 1
kLast = 2
@property
def matrix(self, *args, **kwargs):
"""
The matrix associated to MPxGeometryData.
"""
pass
def name(self, *args, **kwargs):
"""
name() -> string
Returns the name of the custom data type.
This method must be implemented by the derived class.
"""
pass
def readASCII(self, *args, **kwargs):
"""
readASCII(argList, endOfTheLastParsedElement) -> int
Creates Data in Data Block as specified by input from ASCII file record.
Returns the new last argument parsed by this method.
* argList (MArgList) - List of arguments read from ASCII record* endOfTheLastParsedElement (int) - points to last argument already parsed.
"""
pass
def readBinary(self, *args, **kwargs):
"""
readBinary(in, length) -> int
Creates Data in Data Block as specified by binary data from the given stream.
Returns the numbers of data bytes processed.
* in (bytearray) - Input stream
* length (int) - Length in bytes of binary data to be read.
"""
pass
def smartCopy(self, *args, **kwargs):
"""
smartCopy(srcGeom) -> self
This method is used in conjunction with MPxSurfaceShape classes which support mayas deformations.
This method is used to prvoide maya with an efficient way to copy the source data into the memory of this data with as little memory allocation as possible.
This method is not mandatory and only needs to be overridden to improve performance of deformations on shapes.
* srcGeom (MPxGeometryData) - the data to be copied
"""
pass
def typeId(self, *args, **kwargs):
"""
typeId() -> MTypeId
Determines the type id of the Data object.
This method must be implemented by the derived class.
"""
pass
def updateCompleteVertexGroup(self, *args, **kwargs):
"""
updateCompleteVertexGroup(component) -> bool
This method is used in conjunction with MPxSurfaceShape classes which support maya\s deformations.
This method should make sure that complete vertex group data is up-to-date.
If the given component is not complete (i.e. it represents all elements of your geometry) then you must mark is as complete using the methods of MFnComponent and return true if the component was updated, false if it was already complete.
This method is used by deformers when deforming the whole object and not just selected components.
Returns true if the component was updated, false if it was already complete.
* component (MObject) - the component to test
"""
pass
def writeASCII(self, *args, **kwargs):
"""
writeASCII() -> string
Encodes Data in accordance with the ASCII file format and returns as string.
"""
pass
def writeBinary(self, *args, **kwargs):
"""
writeBinary() -> bytearray
Encodes Data in accordance with the binary file format and returns as bytearray.
"""
pass
class MPxGeometryIterator(object):
"""
Base class for user defined geometry iterators.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def component(self, *args, **kwargs):
"""
component() -> MObject
Returns a component for the current item in the iteration.
"""
pass
@property
def currentPoint(self, *args, **kwargs):
"""
The current index of the iteration.
This value is used when iterating over all elements of your geometry, i.e. when there are no components specified.
"""
pass
def geometry(self, *args, **kwargs):
"""
geometry() -> long/object
Returns the user geometry that this iterator is iterating over.
"""
pass
def hasNormals(self, *args, **kwargs):
"""
hasNormals() -> bool
Returns whether the underlying geometry has normals.
"""
pass
def hasPoints(self, *args, **kwargs):
"""
hasPoints() -> bool
Returns whether the underlying geometry has point data.
"""
pass
def index(self, *args, **kwargs):
"""
index() -> int
Returns a unique index for the current item in the iteration.
If the iteration is over the whole geometry then this index is the same as current point. If the iteration is over some elements of the geometry specified by a component then this index is the index in your geometry.
"""
pass
def indexUnsimplified(self, *args, **kwargs):
"""
indexUnsimplified() -> int
Returns a unique index for the current item in the iteration.
Rather than being the iterator index this is the index for the actual item when simplification is skipping items. This index will be equal to index() if no simplification, otherwise it will be larger.
"""
pass
def isDone(self, *args, **kwargs):
"""
isDone() -> bool
Returns whether all the items have been traversed yet.
"""
pass
def iteratorCount(self, *args, **kwargs):
"""
iteratorCount() -> int
Returns an estimate of how many items will be iterated over.
"""
pass
@property
def maxPoints(self, *args, **kwargs):
"""
The largest index that will be iterated over.
This value is used when iterating over all elements of your geometry, i.e. when there are no components specified.
"""
pass
def next(self, *args, **kwargs):
"""
next() -> self
Advances to the next component.
"""
pass
def point(self, *args, **kwargs):
"""
point() -> MPoint
Returns the current components positional data.
"""
pass
def reset(self, *args, **kwargs):
"""
reset() -> self
Resets the iterator to the start of the components so that another pass over them may be made.
"""
pass
def setObject(self, *args, **kwargs):
"""
setObject(shape) -> self
Optional method to set a shape object to iterate over to allow tweaking of the shapes history (input geometry).
* shape (MPxSurfaceShape) - a user defined shape object.
"""
pass
def setPoint(self, *args, **kwargs):
"""
setPoint(point) -> self
Sets the current components positional data.
* point (MPoint) - the new positional value to set.
"""
pass
def setPointGetNext(self, *args, **kwargs):
"""
setPointGetNext(point) -> int
Sets the current components positional data, and returns the next index value.
* point (MPoint) - the positional value to set.
"""
pass
class MPxNode(object):
"""
Base class for user defined dependency nodes.
"""
def __init__(self, *args, **kwargs):
"""
x.__init__(...) initializes x; see help(type(x)) for signature
"""
pass
def __repr__(self, *args, **kwargs):
"""
x.__repr__() <==> repr(x)
"""
pass
def __str__(self, *args, **kwargs):
"""
x.__str__() <==> str(x)
"""
pass
def addAttribute(self, *args, **kwargs):
"""
addAttribute(attr) -> None
This method adds a new attribute to a user defined node type during the types initialization.
This method will only work during the static initialization method of the user defined node class. The initialization method is the one that is passed into MFnPlugin.registerNode(). The attributes must first be created using one of the MFnAttribute classes, and can then be added using this method.
For compound attributes, the proper way to use this method is by calling it with the parent attribute. If a compound attribute is passed, this method will add all of its children.
NOTE: A failure will occur if you attempt to call addAttribute() on the children of a compound attribute.
* attr (MObject) - new attribute to add.
"""
pass
def addExternalContentForFileAttr(self, *args, **kwargs):
"""
addExternalContentForFileAttr(table, attr) -> bool
This method is a helper for derived clases implementing getExternalContent(). It augments the external content info table passed in with an entry describing external content whose location is described by the specified attribute.
The method will not overwrite existing items, i.e. items with the same key. (attribute name). In this context, overwriting an item means the caller has called this function twice with the same attribute, or that two separate but identically named attributes were used. If replacing an entry is the desired effect, it is the callers responsibility to erase the previous item first.
* table [OUT] (MExternalContentInfoTable) - table The table in which the new entry will be added.
* attr (MObject) - The attribute for which the plug value will be queried for a location.
Returns True if an item was sucessfully added to the table. False if the attribute does not describe a non-empty location, or an item with the same key was already present in the table.
"""
pass
def attributeAffects(self, *args, **kwargs):
"""
attributeAffects(whenChanges, isAffected) -> None
This method specifies that a particular input attribute affects a specific output attribute. This is required to make evaluation efficient. When an input changes, only the affected outputs will be computed. Output attributes cannot be keyable - if they are keyable, this method will fail.
This method must be called for every attribute dependency when initializing the nodes attributes. The attributes must first be added using the MPxNode.addAttribute() method. Failing to call this method will cause the node not to update when its inputs change. If there are no calls to this method in a nodes initialization, then the compute method will never be called.
This method will only work during the static initialization method of the user defined node class. The initialization method is the one that is passed into MFnPlugin.registerNode(). As a result, it does not work with dynamic attributes. For an alternate solution which handles dynamic as well as non-dynamic attributes refer to MPxNode.setDependentsDirty.()
* whenChanges (MObject) - input attribute - MObject that points to an input attribute that has already been added.
* isAffected (MObject) - affected output attribute - MObject that points to an output attribute that has already been added.
"""
pass
def compute(self, *args, **kwargs):
"""
compute(plug, dataBlock) -> self
This method should be overridden in user defined nodes.
Recompute the given output based on the nodes inputs. The plug represents the data value that needs to be recomputed, and the data block holds the storage for all of the nodes attributes.
The MDataBlock will provide smart handles for reading and writing this nodes attribute values. Only these values should be used when performing computations.
When evaluating the dependency graph, Maya will first call the compute method for this node. If the plug that is provided to the compute indicates that that the attribute was defined by the Maya parent node, the compute method should return None. When this occurs, Maya will call the internal Maya node from which the user-defined node is derived to compute the plugs value.
This means that a user defined node does not need to be concerned with computing inherited output attributes. However, if desired, these can be safely recomputed by this method to change the behaviour of the node.
* plug (MPlug) - plug representing the attribute that needs to be recomputed.
* block (MDataBlock) - data block containing storage for the nodes attributes.
"""
pass
def connectionBroken(self, *args, **kwargs):
"""
connectionBroken( plug, otherPlug, asSrc) -> self
This method gets called when connections are broken with attributes of this node.
* plug (MPlug) - attribute on this node.
* otherPlug (MPlug) - attribute on other node.
* asSrc (bool) - is this plug a source of the connection.
"""
pass
def connectionMade(self, *args, **kwargs):
"""
connectionMade(plug, otherPlug, asSrc) -> self
This method gets called when connections are made to attributes of this node.
* plug (MPlug) - attribute on this node.
* otherPlug (MPlug) - attribute on other node.
* asSrc (bool) - is this plug a source of the connection.
"""
pass
def copyInternalData(self, *args, **kwargs):
"""
copyInternalData(node) -> self
This method is overriden by nodes that store attribute data in some internal format.
On duplication this method is called on the duplicated node with the node being duplicated passed as the parameter. Overriding this method gives your node a chance to duplicate any internal data youve been storing and manipulating outside of normal attribute data.
* node (MPxNode) - the node that is being duplicated.
"""
pass
def doNotWrite(self, *args, **kwargs):
"""
doNotWrite() -> bool
use this method to query the do not write state of this proxy node. True is returned if this node will not be saved when the maya model is written out.
"""
pass
def forceCache(self, *args, **kwargs):
"""
forceCache(ctx=fsNormal) -> MDataBlock
Get the datablock for this node. If there is no datablock then one will be created.
NOTE: This should be used only in places where fast access to the datablock outside of a compute is critical such as the transformUsing method of MPxSurfaceShape.
* ctx (MDGContext) - The context in which the node will evaluate.
"""
pass
def getExternalContent(self, *args, **kwargs):
"""
getExternalContent(table) -> self
The table populated by this method must include the location of all the content (files) used by this node, including those that do not exist. See MExternalContentInfoTable for details.
Keys used to add items to this table will be the same that get passed to setExternalContent through its MExternalContentLocationTable parameter to perform a batched change of content location.
When implementing getExternalContent, you are responsible for forwarding the call to the base class when it makes sense to do so, so that base classes can also add their external content to the table.
The default implementation does nothing.
* table [OUT] (MExternalContentInfoTable) - Content information table that this method must populate.
"""
pass
def getFilesToArchive(self, *args, **kwargs):
"""
getFilesToArchive(shortName=False, unresolvedName=False, markCouldBeImageSequence=False) -> list of strings
Use this method to return all external files used by this node. This file list will be used by the File > Archive zip feature, maya.exe -archive and the `file -q -list` mel command.
Only include files that exist.
If shortName is True, return just the filename portion of the path. Otherwise, return a full path.
If unresolvedName is True, return the path before any resolution has been done (i.e leave it as a relative path, include unexpanded environment variables, tildes, ..s etc). Otherwise, resolve the file path and return an absolute path (to resolve with standard Maya path resolution, use MFileObject.resolvedFullName()).
* shortName (bool) - If True, only add the filename of the path.
* unresolvedName (bool) - If True, add paths before any resolution, rather than absolute paths.
* markCouldBeImageSequence (bool) - If True, append an asterisk after any file path that could be an image sequence (note: only used by maya.exe -archive).
"""
pass
def getInternalValueInContext(self, *args, **kwargs):
"""
getInternalValueInContext(plug, dataHandle, ctx) -> bool
This method is overriden by nodes that store attribute data in some internal format.
The internal state of attributes can be set or queried using the setInternal and internal methods of MFnAttribute.
When internal attribute values are queried via getAttr or MPlug.getValue() this method is called.
* plug (MPlug) - the attribute that is being queried.
* dataHandle [OUT] (MDataHandle) - the dataHandle to store the attribute value.
* ctx (MDGContext) - the context the method is being evaluated in.
"""
pass
def inheritAttributesFrom(self, *args, **kwargs):
"""
inheritAttributesFrom(parentClassName) -> None
This method allows a class of plugin node to inherit all of the attributes of a second class of plugin node.
This method will only work during the static initialization method of the user defined node class and must be called before any other attributes have been added. The initialization method is the one that is passed into MFnPlugin.registerNode().
A plugin node may only inherit attributes from one other class of plugin node. Attempting to call this method multiple times within a nodes initialization method will result in an error.
Both node classes must be registered using the same MPxNode type, listed in MPxNode.type().
* parentClassName (string) - class of node to inherit attributes from.
"""
pass
def internalArrayCount(self, *args, **kwargs):
"""
internalArrayCount(plug, ctx) -> int
This method is overriden by nodes that have internal array attributes which are not stored in Mayas datablock. This method is used by Maya to determine the non-sparse count of array elements during file io. If the internal array is stored sparsely, you should return the maximum index of the array plus one. If the internal array is non-sparse then return the length of the array.
This method does not need to be implemented for attributes that are stored in the datablock since Maya will use the datablock size.
If this method is overriden, it should return -1 for attributes which it does not handle. Maya will use the datablock size to determine the array length when -1 is returned.
* plug (MPlug) - the array plug.
* ctx (MDGContext) - the context.
"""
pass
def isAbstractClass(self, *args, **kwargs):
"""
isAbstractClass() -> bool
Override this class to return True if this node is an abstract node. An abstract node can only be used as a base class. It cannot be created using the createNode command.
It is not necessary to override this method.
"""
pass
def isPassiveOutput(self, *args, **kwargs):
"""
isPassiveOutput(plug) -> bool
This method may be overridden by the user defined node if it wants to provide output attributes which do not prevent value modifications to the destination attribute. For example, output plugs on animation curve nodes are passive. This allows the attributes driven by the animation curves to be set to new values by the user.
* plug (MPlug) - plug representing output in question.
"""
pass
kAssembly = 22
kBlendShape = 25
kCameraSetNode = 16
kClientDeviceNode = 20
kConstraintNode = 17
kDeformerNode = 2
kDependNode = 0
kEmitterNode = 6
kFieldNode = 5
kFluidEmitterNode = 13
kGeometryFilter = 24
kHardwareShader = 9
kHwShaderNode = 10
kIkSolverNode = 8
kImagePlaneNode = 14
kLast = 26
kLocatorNode = 1
kManipContainer = 3
kManipulatorNode = 18
kMotionPathNode = 19
kObjectSet = 12
kParticleAttributeMapperNode = 15
kSkinCluster = 23
kSpringNode = 7
kSurfaceShape = 4
kThreadedDeviceNode = 21
kTransformNode = 11
def legalConnection(self, *args, **kwargs):
"""
legalConnection(plug, otherPlug, asSrc) -> bool/None
This method allows you to check for legal connections being made to attributes of this node.
You should return None to specify that maya should handle this connection if you are unable to determine if it is legal.
* plug (MPlug) - attribute on this node.
* otherPlug (MPlug) - attribute on other node.
* asSrc (bool) - is this plug a source of the connection.
"""
pass
def legalDisconnection(self, *args, **kwargs):
"""
legalDisconnection(plug, otherPlug, arsSrc) -> bool/None
This method allows you to check for legal disconnections being made to attributes of this node.
You should return None to specify that maya should handle this disconnection if you are unable to determine if it is legal.
* plug (MPlug) - attribute on this node.
* otherPlug (MPlug) - attribute on other node.
* asSrc (boool) - is this plug a source of the connection.
"""
pass
def passThroughToMany(self, *args, **kwargs):
"""
passThroughToMany(plug, plugArray) -> bool
This method is overriden by nodes that want to control the traversal behavior of some Maya search algorithms which traverse the history/future of shape nodes looking for directly related nodes. In particular, the Artisan paint code uses this method when searching for paintable nodes, and the disk cache code uses this method when searching for upstream cacheFile nodes.
If this method is not implemented or returns False, the base class Maya implementation of this method calls passThroughToOne and returns the results of that call.
* plug (MPlug) - the plug.
* plugArray (MPlugArray) - the corresponding plugs.
"""
pass
def passThroughToOne(self, *args, **kwargs):
"""
passThroughToOne(plug) -> plug
This method may be overriden by nodes that have a one-to-one relationship between an input attribute and a corresponding output attribute. This method is used by Maya to perform the following capabilities:
- When this node is deleted, the delete command will rewire the source of the input attribute to the destination of the output attribute if the source and destination are connected to nodes that are not deleted.
- History traversal algorithms such as the bakePartialHistory command use this method to direct its traversal through a shapes construction history.
- The base class Maya implementation of passThroughToAll will call this method if passThroughToAll returns False.
* plug (MPlug) - the plug.
"""
pass
def postConstructor(self, *args, **kwargs):
"""
postConstructor() -> self
Internally maya creates two objects when a user defined node is created, the internal MObject and the user derived object.
The association between the these two objects is not made until after the MPxNode constructor is called. This implies that no MPxNode member function can be called from the MPxNode constructor.
The postConstructor will get called immediately after the constructor when it is safe to call any MPxNode member function.
"""
pass
def setDependentsDirty(self, *args, **kwargs):
"""
setDependentsDirty(plug, plugArray) -> self
This method can be overridden in user defined nodes to specify which plugs should be set dirty based upon an input plug which Maya is marking dirty. The list of plugs for Maya to mark dirty is returned by the plug array. This method handles both dynamic as well as non-dynamic plugs and is useful in the following ways:
- Allows attributeAffects-style relationships to be handled for dynamically-added attributes. Since MPxNode.attributeAffects() can only be used with non-dynamic attributes, use of this method allows a way for all attributes of a node to affect one another, both dynamic and non-dynamic.
- Provides more flexible relationships than what is available with MPxNode.attributeAffects(). For example, you may wish to not dirty plugs when the current frame is one. However, as the routine is called during dirty propagation, there are restrictions on what can be done within the routine, most importantly you must not cause any dependency graph computation. For details, see the IMPORTANT NOTE below.
This method is designed to work harmoniously with MPxNode.attributeAffects() on the same node. Alternately, you can do all affects relationships within a yourNode.setDependentsDirty() implementation.
The body of a user-implemented setDependentsDirty() implementation might look like the following example, which causes the plug called B to be set dirty whever plug A is changed, i.e. A affects B.
* plug (MPlug) - plug which is being set dirty by Maya.
* plugArray the programmer should add any plugs which they want to set dirty to this list.
"""
pass
def setDoNotWrite(self, *args, **kwargs):
"""
setDoNotWrite(bool) -> self
Use this method to mark the do not write state of this proxy node. If set, this node will not be saved when the Maya model is written out.
NOTES:
1. Plug-in requires information will be written out with the model when saved. But a subsequent reload and resave of the file will cause these to go away.
2. If this node is a DAG and has a parent or children, the do not write flag of the parent or children will not be set. It is the developer\s responsibility to ensure that the resulting scene file is capable of being read in without errors due to unwritten nodes.
"""
pass
def setExternalContent(self, *args, **kwargs):
"""
setExternalContent(table) -> self
This is useful in the context of content relocation. This will be called while the scene is being loaded to apply path changes performed externally. Consequently, interaction with the rest of the scene must be kept to a minimum. It is however valid to call this method outside of scene loading contexts.
The keys in the map must be the same as the ones provided by the node in getExternalContent. The values are the new locations.
When implementing setExternalContent, you are responsible for forwarding the call to the base class when it makes sense to do so, so that base classes can also set their external content.
The default implementation does nothing.
* table Key->location table with new content locations.
"""
pass
def setExternalContentForFileAttr(self, *args, **kwargs):
"""
setExternalContentForFileAttr(attr, table) -> bool
This method is a helper for derived clases implementing setExternalContent(). It assigns a value to a plug with the one from the table whose key is the same as the passed in attribute name.
The method will not write to the plug if the attribute is not found in the table.
* attr (MObject) - The attribute of the plug we want to write to.
* table (MExternalContentLocationTable) - A table which may hold or not the value for a given plug.
Returns True if the plug was successfully written to. False if no entry in the table was named after the attribute or if no plug was found.
"""
pass
def setInternalValueInContext(self, *args, **kwargs):
"""
setInternalValueInContext(plug, dataHandle, ctx) -> bool
This method is overriden by nodes that store attribute data in some internal format.
The internal state of attributes can be set or queried using the setInternal and internal methods of MFnAttribute.
When internal attribute values are set via setAttr or MPlug.setValue() this method is called.
Another use for this method is to impose attribute limits.
* plug (MPlug) - the attribute that is being set.
* dataHandle (MDataHandle) - the dataHandle containing the value to set.
* ctx (MDGContext) - the context the method is being evaluated in.
"""
pass
def setMPSafe(self, *args, **kwargs):
"""
setMPSafe(bool) -> self
Set a flag to specify if a user defined shading node is safe for multi-processor rendering. For a shading node to be MP safe, it cannot access any shared global data and should only use attributes in the datablock to get input data and store output data.
This flag does NOT mark a node thread safe for parallel DG evaluation in Viewport 2.0. To mark a node thread safe for parallel DG evaluation see the setNodeTypeFlag mel command.
NOTE: This should be called from the postConstructor() method for shading node plug-ins only. If a shading node is non-safe, then it will only be useful during single processor rendering.
"""
pass
def shouldSave(self, *args, **kwargs):
"""
shouldSave(plug) -> bool/None
This method may be overridden by the user defined node. It should only be required to override this on rare occasions.
This method determines whether a specific attribute of this node should be written out during a file save. The default behavior is to only write the value if it differs from the default and is not being supplied by a connection. This behavior should be sufficient in most cases.
This method is not called for ramp attributes since they should always be written.
* plug (MPlug) - plug representing the attribute to be saved.
"""
pass
def thisMObject(self, *args, **kwargs):
"""
thisMObject() -> MObject
Returns the MObject associated with this user defined node. This makes it possible to use MFnDependencyNode or to construct plugs to this nodes attributes.
"""
pass
def type(self, *args, **kwargs):
"""
type() -> int
Returns the type of node that this is. This is used to differentiate user defined nodes that are derived off different MPx base classes.
It is not necessary to override this method.
kDependNode Custom node derived from MPxNode
kLocatorNode Custom locator derived from MPxLocatorNode
kDeformerNode Custom deformer derived from MPxDeformerNode
kManipContainer Custom container derived from MPxManipContainer
kSurfaceShape Custom shape derived from MPxSurfaceShape
kFieldNode Custom field derived from MPxFieldNode
kEmitterNode Custom emitter derived from MPxEmitterNode
kSpringNode Custom spring derived from MPxSpringNode
kIkSolverNode Custom IK solver derived from MPxIkSolverNode
kHardwareShader Custom shader derived from MPxHardwareShader
kHwShaderNode Custom shader derived from MPxHwShaderNode
kTransformNode Custom transform derived from MPxTransform
kObjectSet Custom set derived from MPxObjectSet
kFluidEmitterNode Custom fluid emitter derived from MpxFluidEmitterNode
kImagePlaneNode Custom image plane derived from MPxImagePlane
kParticleAttributeMapperNode Custom particle attribute mapper derived from MPxParticleAttributeMapperNode
kCameraSetNode Custom director derived from MPxCameraSet
kConstraintNode Custom constraint derived from MPxConstraint
kManipulatorNode Custom manipulator derived from MPxManipulatorNode
kClientDeviceNode Custom threaded device derived from MPxThreadedDeviceNode
kThreadedDeviceNode Custom threaded device node
kAssembly Custom assembly derived from MPxAssembly
kSkinCluster Custom deformer derived from MPxSkinCluster
kGeometryFilter Custom deformer derived from MPxGeometryFilter
kBlendShape Custom deformer derived from MPxBlendShape
"""
pass
def typeId(self, *args, **kwargs):
"""
typeId() -> MTypeId
Returns the TYPEID of this node.
"""
pass
def typeName(self, *args, **kwargs):
"""
typeName() -> string
Returns the type name of this node. The type name identifies the node type to the ASCII file format
"""
pass
class MPxSurfaceShape(MPxNode):
"""
View raw

(Sorry about that, but we can’t show files that are this big right now.)

View raw

(Sorry about that, but we can’t show files that are this big right now.)

View raw

(Sorry about that, but we can’t show files that are this big right now.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment