class TangentCalculator
TangentCalculator calculates tangent vectors for geometry data objects. One corner field of texture coordinates must exist, as well as normals. The tangents are placed into two corner fields called "Tangents" and "Bitangents". If any of these fields already exists, it is replaced by the new field.
Properties
| Property | Description |
|---|
| TangentCalculatorType | Sets/Gets the tangent calculator type, types listed in TangentSpaceMethod. |
Methods
| Method | Description |
|---|
| CalculateTangents | Calculates the tangents of a geometry data object. |
| CalculateTangentsForNodeHierarchy | Calculates the tangents of a tree of scene nodes (only the geometry nodes of course). |
| GetClass | Get the name of the TangentCalculator class. |
| IsA | Returns true if TangentCalculator is a or is a descendant of the class named as the type parameter. |
| IsNull | Returns true if the TangentCalculator object is invalid. |
| SetTexCoordsSetId | The TexCoords field id to use for the tangent calculation. If set to -1, all texture coordinates will get corresponding tangent fields. |
Static methods
| Method | Description |
|---|
| IsClassA | Returns true if the class is a or is a descendant of the class named as the type parameter. |
| SafeCast | SafeCast makes sure the input object is of a class that can be cast into spTangentCalculator, and if this is the case, returns the object cast into spTangentCalculator. |
Properties details
TangentCalculatorType
Sets/Gets the tangent calculator type, types listed in TangentSpaceMethod.
Syntax
SetTangentCalculatorType parameters
GetTangentCalculatorType return value
Type: ETangentSpaceMethod
Default: OrthonormalRightHanded
| Key | Value | Comment |
|---|
| OrthonormalRightHanded | 0 | Standard method, creates an orthonormal tangent space (right-handed) |
| Autodesk3dsMax | 1 | 3dsMax compatible method, creates tangent space that is compatible with the 3dsMax renderer |
| OrthonormalLeftHanded | 2 | Creates an orthonormal tangent space (left-handed, D3D compatible) |
Syntax
SetTangentCalculatorType parameters
GetTangentCalculatorType return value
Type: ``````
Default: OrthonormalRightHanded
| Key | Value | Comment |
|---|
| OrthonormalRightHanded | 0 | Standard method, creates an orthonormal tangent space (right-handed) |
| Autodesk3dsMax | 1 | 3dsMax compatible method, creates tangent space that is compatible with the 3dsMax renderer |
| OrthonormalLeftHanded | 2 | Creates an orthonormal tangent space (left-handed, D3D compatible) |
Syntax
SetTangentCalculatorType parameters
GetTangentCalculatorType return value
Type: ETangentSpaceMethod
Default: OrthonormalRightHanded
| Key | Value | Comment |
|---|
| ETangentSpaceMethod_OrthonormalRightHanded | 0 | Standard method, creates an orthonormal tangent space (right-handed) |
| ETangentSpaceMethod_Autodesk3dsMax | 1 | 3dsMax compatible method, creates tangent space that is compatible with the 3dsMax renderer |
| ETangentSpaceMethod_OrthonormalLeftHanded | 2 | Creates an orthonormal tangent space (left-handed, D3D compatible) |
Methods details
CalculateTangents
Calculates the tangents of a geometry data object.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
| GeometryData | geom | | | The geometry object receives new fields, as described in the class description. |
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
| GeometryData | geom | | | The geometry object receives new fields, as described in the class description. |
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| geom | GeometryData | | | The geometry object receives new fields, as described in the class description. |
CalculateTangentsForNodeHierarchy
Calculates the tangents of a tree of scene nodes (only the geometry nodes of course).
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
SceneNode | node | | | Is the scene node that will have itselfs and its childrens tangents calculated. |
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
SceneNode | node | | | Is the scene node that will have itselfs and its childrens tangents calculated. |
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| node | SceneNode | | | Is the scene node that will have itselfs and its childrens tangents calculated. |
GetClass
Get the name of the TangentCalculator class.
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: spString
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: string
Syntax
Parameters
GetClass takes no parameters.
Return value
Type: str
IsA
Returns true if TangentCalculator is a or is a descendant of the class named as the type parameter.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
const char * | type | | | Name of the class to check if TangentCalculator is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
string | type | | | Name of the class to check if TangentCalculator is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| type | str | | | Name of the class to check if TangentCalculator is, or is a descendant of. |
Return value
Type: bool
IsNull
Returns true if the TangentCalculator object is invalid.
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
Syntax
Parameters
IsNull takes no parameters.
Return value
Type: bool
SetTexCoordsSetId
The TexCoords field id to use for the tangent calculation. If set to -1, all texture coordinates will get corresponding tangent fields.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
rid | value | | | The TexCoords set id. |
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
rid | value | | | The TexCoords set id. |
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| value | int | | | The TexCoords set id. |
Static methods details
IsClassA
Returns true if the class is a or is a descendant of the class named as the type parameter.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
const char * | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
string | type | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| type | str | | | Name of the class to check if the class is, or is a descendant of. |
Return value
Type: bool
SafeCast
SafeCast makes sure the input object is of a class that can be cast into spTangentCalculator, and if this is the case, returns the object cast into spTangentCalculator.
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
Object | object | | | Object to cast. |
Return value
Type: TangentCalculator
Syntax
Parameters
| Type | Name | Min | Max | Description |
|---|
Object | object | | | Object to cast. |
Return value
Type: TangentCalculator
Syntax
Parameters
| Name | Type | Min | Max | Description |
|---|
| object | Object | | | Object to cast. |
Return value
Type: TangentCalculator
