Methods Signatures
Create a new pose morph tag. |
Add a morph to the morph tag. |
|
Get the morph base of the morph tag. |
|
Retrieves the index for the given morph. |
|
Retrieves the number of morphs targets as shown in the user interface.
|
|
Return the morph ID. |
|
Retrieves the morph at index.
|
|
Retrieves the active morph (usually the one selected). |
|
Remove a morph by index. |
|
Get the index of the current active morph. |
|
Set the active morph index. |
|
Get the mode of the morph tag. |
|
Initialize the morphs. |
|
Update the morphs. |
|
Must be called before doing anything to a morph tag.
|
|
Retrieves the PSD color used for feedback. |
|
Sets the PSD color used for feedback. |
|
Checks if PSD color feedback is enabled or disabled. |
|
Sets the enable/disable state of the PSD color used for feedback. |
|
Retrieves the PSD orient radian threshold used in automatic weighting. |
|
Sets the PSD orient radian threshold used in automatic weighting. |
|
Retrieves the PSD twist radian threshold used in automatic weighting. |
|
Sets the PSD twist radian threshold used in automatic weighting. |
|
Retrieves the PSD position distance threshold used in automatic weighting. |
|
|
Sets the PSD position distance threshold used in automatic weighting. |
Retrieves the description ID for the morph slider at morphIndex. |
Inheritance
Parent Class:
Methods Documentation
-
CAPoseMorphTag.
__init__
(self)¶ Create a new pose morph tag.
-
CAPoseMorphTag.
AddMorph
(self)¶ Add a morph to the morph tag.
- Return type
- Returns
The new morph.
-
CAPoseMorphTag.
GetMorphBase
(self)¶ Get the morph base of the morph tag.
- Return type
- Returns
The morph base.
-
CAPoseMorphTag.
GetMorphIndex
(self, morph)¶ Retrieves the index for the given morph.
New in version R17.053.
- Parameters
morph (c4d.modules.character.CAMorph) – The morph to search for.
- Return type
int
- Returns
The index for morph.
-
CAPoseMorphTag.
GetMorphCount
(self)¶ - Retrieves the number of morphs targets as shown in the user interface.The value returned here indicates the maximum morph index, which is one less than this value due to being zero based.
- Return type
int
- Returns
The morph count.
-
CAPoseMorphTag.
GetMorphID
(self, index)¶ Return the morph ID.
- Parameters
index (int) – The index of the morph.
- Raises
IndexError – If the morph index is out of range : 0<=index<
GetMorphCount()
.- Return type
- Returns
The morph ID.
-
CAPoseMorphTag.
GetMorph
(self, index)¶ - Retrieves the morph at index.The parameter index is zero-based and index 0 will return the base morph, while the morphs starting from index 1 will be the user defined morphs.
- Parameters
index (int) – The index of the morph.
- Raises
IndexError – If the morph index is out of range : 0<=index<
GetMorphCount()
.- Return type
- Returns
The morph.
-
CAPoseMorphTag.
GetActiveMorph
(self)¶ Retrieves the active morph (usually the one selected).
New in version R17.053.
- Return type
- Returns
The active morph.
-
CAPoseMorphTag.
RemoveMorph
(self, index)¶ Remove a morph by index.
- Parameters
index (int) – The index of the morph.
- Raises
IndexError – If the morph index is out of range : 0<=index<
GetMorphCount()
.
-
CAPoseMorphTag.
GetActiveMorphIndex
(self)¶ Get the index of the current active morph.
- Return type
int
- Returns
The index.
-
CAPoseMorphTag.
SetActiveMorphIndex
(self, index)¶ Set the active morph index.
New in version R17.053.
- Parameters
index (int) – The active morph index to set.
- Raises
IndexError – If the morph index is out of range : 0<=index<
GetMorphCount()
.
-
CAPoseMorphTag.
GetMode
(self)¶ Get the mode of the morph tag.
- Return type
int
- Returns
The mode.
-
CAPoseMorphTag.
InitMorphs
(self)¶ Initialize the morphs.
-
CAPoseMorphTag.
UpdateMorphs
(self)¶ Update the morphs.
-
CAPoseMorphTag.
ExitEdit
(self, doc, apply)¶ - Must be called before doing anything to a morph tag.If the user is in Edit mode and making changes to the morph, these are not applied until this function is called and, if not called, they are lost.Set apply to True if any user changes should be stored. This is normally the case.
- Parameters
doc (c4d.documents.BaseDocument) – The document.
apply (bool) – Set to False if any user changes should be stored, otherwise set to True.
- Return type
bool
- Returns
True if successful, otherwise False.
-
CAPoseMorphTag.
GetPSDFeedbackColor
(self)¶ Retrieves the PSD color used for feedback.
New in version R19.
- Return type
- Returns
The PSD feedback color.
-
CAPoseMorphTag.
SetPSDFeedbackColor
(self, color)¶ Sets the PSD color used for feedback.
New in version R19.
- Parameters
color (c4d.Vector) – The PSD feedback color to set.
- Return type
bool
- Returns
True if successful, otherwise False.
-
CAPoseMorphTag.
GetPSDFeedbackColorEnabled
(self)¶ Checks if PSD color feedback is enabled or disabled.
New in version R19.
- Return type
bool
- Returns
True if PSD color feedback is enabled, otherwise False.
-
CAPoseMorphTag.
SetPSDFeedbackColorEnabled
(self, active)¶ Sets the enable/disable state of the PSD color used for feedback.
New in version R19.
- Parameters
active (bool) – True to enable PSD color feedback, otherwise False.
- Return type
bool
- Returns
True if successful, otherwise False.
-
CAPoseMorphTag.
GetPSDOrientThreshold
(self)¶ Retrieves the PSD orient radian threshold used in automatic weighting.
New in version R19.
- Return type
float
- Returns
The PSD orient threshold (in radian).
-
CAPoseMorphTag.
SetPSDOrientThreshold
(self, radianThreshold)¶ Sets the PSD orient radian threshold used in automatic weighting.
New in version R19.
- Parameters
radianThreshold (float) – The PSD orient threshold to set (in radian).
- Return type
bool
- Returns
True if successful, otherwise False.
-
CAPoseMorphTag.
GetPSDTwistThreshold
(self)¶ Retrieves the PSD twist radian threshold used in automatic weighting.
New in version R19.
- Return type
float
- Returns
The PSD twist threshold (in radian).
-
CAPoseMorphTag.
SetPSDTwistThreshold
(self, radianThreshold)¶ Sets the PSD twist radian threshold used in automatic weighting.
New in version R19.
- Parameters
radianThreshold (float) – The PSD twist threshold to set (in radian).
- Return type
bool
- Returns
True if successful, otherwise False.
-
CAPoseMorphTag.
GetPSDPositionThreshold
(self)¶ Retrieves the PSD position distance threshold used in automatic weighting.
New in version R19.
- Return type
float
- Returns
The PSD position threshold (distance).
-
CAPoseMorphTag.
SetPSDPositionThreshold
(self, distanceThreshold)¶ Sets the PSD position distance threshold used in automatic weighting.
New in version R19.
- Parameters
distanceThreshold (float) – The PSD position threshold to set (distance).
- Return type
bool
- Returns
True if successful, otherwise False.
-
CAPoseMorphTag.
GetMorphPSDID
(self, morphIndex, psdAttributeID)¶ Retrieves the description ID for the morph slider at morphIndex.
New in version R19.
- Parameters
morphIndex (int) – The morph index: 0 <= morphIndex <
GetMorphCount()
.psdAttributeID (int) – The attribute ID defined in tcaposemorph.h: ID_CA_POSE_PSD_ORIENT_INTERP_WEIGHT <= psdAttributeID < ID_CA_POSE_PSD_AUTOWEIGHT_INTERP.
- Raises
IndexError – If morphIndex is out of range.
- Return type
- Returns
The description ID of the specified attribute.