This reference page is linked to from the following overview topics: Supported Scene Elements, FBX Scenes, Textures, List of Python Fbx classes.
#include <fbxtexture.h>
This class is the base class for textures, ie classes FbxFileTexture, FbxLayeredTexture and FbxProceduralTexture.
It describes image mapping on top of a geometry.
ExportDocument/main.cxx, ImportScene/DisplayMaterial.cxx, ImportScene/DisplayMesh.cxx, ImportScene/DisplayTexture.cxx, ImportScene/DisplayTexture.h, Layers/main.cxx, and ViewScene/SceneContext.cxx.
Definition at line 26 of file fbxtexture.h.
Texture Properties |
|
| enum | EUnifiedMappingType
{ eUMT_UV, eUMT_XY, eUMT_YZ, eUMT_XZ, eUMT_SPHERICAL, eUMT_CYLINDRICAL, eUMT_ENVIRONMENT, eUMT_PROJECTION, eUMT_BOX, eUMT_FACE, eUMT_NO_MAPPING } |
| Internal enum for texture mapping types.
More... |
|
| enum | ETextureUse6
{ eTEXTURE_USE_6_STANDARD, eTEXTURE_USE_6_SPHERICAL_REFLEXION_MAP, eTEXTURE_USE_6_SPHERE_REFLEXION_MAP, eTEXTURE_USE_6_SHADOW_MAP, eTEXTURE_USE_6_LIGHT_MAP, eTEXTURE_USE_6_BUMP_NORMAL_MAP } |
| Internal enum for texture usage. More... |
|
| enum | EWrapMode { eRepeat, eClamp } |
| Wrap modes. More... |
|
| enum | EBlendMode
{ eTranslucent, eAdditive, eModulate, eModulate2, eOver } |
| Blend modes. More... |
|
| enum | EAlignMode { eLeft, eRight, eTop, eBottom } |
| Align indices for cropping. More... |
|
| enum | ECoordinates { eU, eV, eW } |
| Texture coordinates. More... |
|
| enum | EAlphaSource { eNone, eRGBIntensity, eBlack } |
| Controls if the Alpha computation of the
current texture comes from the Alpha channel, RGB Intensity
channel, or if there is No Alpha. More... |
|
| enum | EMappingType
{ eNull, ePlanar, eSpherical, eCylindrical, eBox, eFace, eUV, eEnvironment } |
| Texture mapping types. More... |
|
| enum | EPlanarMappingNormal { ePlanarNormalX, ePlanarNormalY, ePlanarNormalZ } |
| Planar mapping normal orientations. More... |
|
| enum | ETextureUse
{ eStandard, eShadowMap, eLightMap, eSphericalReflectionMap, eSphereReflectionMap, eBumpNormalMap } |
| Texture uses. More... |
|
| FbxPropertyT< ETextureUse6 > | TextureTypeUse |
| This property handles the use of textures.
|
|
| FbxPropertyT< FbxDouble > | Alpha |
| This property handles the default alpha
value for textures. |
|
| FbxPropertyT< EUnifiedMappingType > | CurrentMappingType |
| This property handles the texture mapping
types. |
|
| FbxPropertyT< EWrapMode > | WrapModeU |
| This property handles the texture wrap modes
in U. |
|
| FbxPropertyT< EWrapMode > | WrapModeV |
| This property handles the texture wrap modes
in V. |
|
| FbxPropertyT< FbxBool > | UVSwap |
| This property handles the swap UV flag.
|
|
| FbxPropertyT< FbxBool > | PremultiplyAlpha |
| This property handles the PremultiplyAlpha
flag. |
|
| FbxPropertyT< FbxDouble3 > | Translation |
| This property handles the default
translation vector. |
|
| FbxPropertyT< FbxDouble3 > | Rotation |
| This property handles the default rotation
vector. |
|
| FbxPropertyT< FbxDouble3 > | Scaling |
| This property handles the default scale
vector. |
|
| FbxPropertyT< FbxDouble3 > | RotationPivot |
| This property handles the rotation pivot
vector. |
|
| FbxPropertyT< FbxDouble3 > | ScalingPivot |
| This property handles the scaling pivot
vector. |
|
| FbxPropertyT< EBlendMode > | CurrentTextureBlendMode |
| This property handles the texture blend
mode. |
|
| FbxPropertyT< FbxString > | UVSet |
| This property handles the use of UV sets.
|
|
| static const char * | sVectorSpace |
| This property only used by Vector
Displacement Texture so it is not added to
FbxTexture. |
|
| static const char * | sVectorSpaceWorld |
| static const char * | sVectorSpaceObject |
| static const char * | sVectorSpaceTangent |
| static const char * | sVectorEncoding |
| This property only used by Vector
Displacement Texture so it is not added to
FbxTexture. |
|
| static const char * | sVectorEncodingFP |
| static const char * | sVectorEncodingSE |
| virtual void | Reset () |
| Resets the default texture values. |
|
| void | SetSwapUV (bool pSwapUV) |
| Sets the swap UV flag. |
|
| bool | GetSwapUV () const |
| Returns the swap UV flag. |
|
| void | SetPremultiplyAlpha (bool pPremultiplyAlpha) |
| Sets the PremultiplyAlpha flag. |
|
| bool | GetPremultiplyAlpha () const |
| Returns the PremultiplyAlpha flag. |
|
| void | SetAlphaSource (EAlphaSource pAlphaSource) |
| Sets the alpha source. |
|
| EAlphaSource | GetAlphaSource () const |
| Returns the alpha source. |
|
| void | SetCropping (int pLeft, int pTop, int pRight, int pBottom) |
| Sets cropping. |
|
| int | GetCroppingLeft () const |
| Returns left cropping. |
|
| int | GetCroppingTop () const |
| Returns top cropping. |
|
| int | GetCroppingRight () const |
| Returns right cropping. |
|
| int | GetCroppingBottom () const |
| Returns bottom cropping. |
|
| void | SetMappingType (EMappingType pMappingType) |
| Sets the mapping type. |
|
| EMappingType | GetMappingType () const |
| Returns the mapping type. |
|
| void | SetPlanarMappingNormal (EPlanarMappingNormal pPlanarMappingNormal) |
| Sets the normal orientations for planar
mapping. |
|
| EPlanarMappingNormal | GetPlanarMappingNormal () const |
| Returns the normal orientations for planar
mapping. |
|
| void | SetTextureUse (ETextureUse pTextureUse) |
| Sets the texture use. |
|
| ETextureUse | GetTextureUse () const |
| Returns the texture use. |
|
| void | SetWrapMode (EWrapMode pWrapU, EWrapMode pWrapV) |
| Sets the U and V wrap mode. |
|
| EWrapMode | GetWrapModeU () const |
| Returns the U wrap mode. |
|
| EWrapMode | GetWrapModeV () const |
| Returns the V wrap mode. |
|
| void | SetBlendMode (EBlendMode pBlendMode) |
| Sets the blend mode. |
|
| EBlendMode | GetBlendMode () const |
| Returns the blend mode. |
|
Default Values Management By Vectors |
|
|
This set of functions provides direct access to the default values in vector base. |
|
| void | SetDefaultT (const FbxVector4 &pT) |
| Sets the default translation vector.
|
|
| FbxVector4 & | GetDefaultT (FbxVector4 &pT) const |
| Returns the default translation vector.
|
|
| void | SetDefaultR (const FbxVector4 &pR) |
| Sets the default rotation vector. |
|
| FbxVector4 & | GetDefaultR (FbxVector4 &pR) const |
| Returns the default rotation vector.
|
|
| void | SetDefaultS (const FbxVector4 &pS) |
| Sets the default scale vector. |
|
| FbxVector4 & | GetDefaultS (FbxVector4 &pS) const |
| Returns the default scale vector. |
|
Default Alpha Value |
|
| void | SetDefaultAlpha (double pAlpha) |
| Sets the default alpha. |
|
| double | GetDefaultAlpha () const |
| Returns the default alpha. |
|
Default Values Management By Numbers |
|
|
This set of functions provides direct access to the default values in number base. U, V and W coordinates are mapped to the X, Y and Z coordinates of the default vectors found in the "Default Values By Vector" section. |
|
| void | SetTranslation (double pU, double pV) |
| Sets translation. |
|
| double | GetTranslationU () const |
| Returns translation applied to the texture
width. |
|
| double | GetTranslationV () const |
| Returns translation applied to the texture
height. |
|
| void | SetRotation (double pU, double pV, double pW=0.0) |
| Sets rotation. |
|
| double | GetRotationU () const |
| Returns the texture rotation around the U
axis in degrees. |
|
| double | GetRotationV () const |
| Returns the texture rotation around the V
axis in degrees. |
|
| double | GetRotationW () const |
| Returns the texture rotation around the W
axis in degrees. |
|
| void | SetScale (double pU, double pV) |
| Sets scale. |
|
| double | GetScaleU () const |
| Returns scale applied to the texture width.
|
|
| double | GetScaleV () const |
| Returns scale applied to the texture height.
|
|
| enum EUnifiedMappingType |
Internal enum for texture mapping types.
Includes mapping types and planar mapping normal orientations. Use SetMappingType(), GetMappingType(), SetPlanarMappingNormal() and GetPlanarMappingNormal() to access these values.
Definition at line 40 of file fbxtexture.h.
| enum ETextureUse6 |
Internal enum for texture usage.
For example, the texture might be used as a standard texture, as a shadow map, as a bump map, etc. Use SetTextureUse() and GetTextureUse() to access these values.
Definition at line 59 of file fbxtexture.h.
| enum EWrapMode |
Wrap modes.
Use SetWrapMode(), GetWrapModeU() and GetWrapModeV() to access these values.
Definition at line 72 of file fbxtexture.h.
| enum EBlendMode |
Blend modes.
Reimplemented in FbxLayeredTexture.
Definition at line 80 of file fbxtexture.h.
{
eTranslucent,
eAdditive,
eModulate,
eModulate2,
eOver
};
| enum EAlignMode |
Align indices for cropping.
Definition at line 91 of file fbxtexture.h.
| enum ECoordinates |
Texture coordinates.
Definition at line 101 of file fbxtexture.h.
| enum EAlphaSource |
Controls if the Alpha computation of the current texture comes from the Alpha channel, RGB Intensity channel, or if there is No Alpha.
| eNone |
No flags. |
| eRGBIntensity |
No Alpha. |
| eBlack |
RGB Intensity (computed). Alpha channel. Black is 100% transparency, white is opaque. |
Definition at line 237 of file fbxtexture.h.
{
eNone,
eRGBIntensity,
eBlack
};
| enum EMappingType |
Texture mapping types.
Definition at line 287 of file fbxtexture.h.
{
eNull,
ePlanar,
eSpherical,
eCylindrical,
eBox,
eFace,
eUV,
eEnvironment
};
| enum EPlanarMappingNormal |
Planar mapping normal orientations.
Definition at line 311 of file fbxtexture.h.
| enum ETextureUse |
Texture uses.
Definition at line 330 of file fbxtexture.h.
| virtual void Reset | ( | ) | [virtual] |
Resets the default texture values.
Reimplemented in FbxFileTexture, and FbxProceduralTexture.
| void SetSwapUV | ( | bool | pSwapUV | ) |
Sets the swap UV flag.
| pSwapUV | Set to true if the swap UV flag is enabled. |
| bool GetSwapUV | ( | ) | const |
Returns the swap UV flag.
True if the swap UV flag is enabled.| void SetPremultiplyAlpha | ( | bool | pPremultiplyAlpha | ) |
Sets the PremultiplyAlpha flag.
| pPremultiplyAlpha | Set to true if the method of storing alpha is
PremultiplyAlpha. |
| bool GetPremultiplyAlpha | ( | ) | const |
Returns the PremultiplyAlpha flag.
True if the method of storing alpha is
PremultiplyAlpha.| void SetAlphaSource | ( | EAlphaSource | pAlphaSource | ) |
Sets the alpha source.
| pAlphaSource | The alpha source identifier. |
| EAlphaSource GetAlphaSource | ( | ) | const |
Returns the alpha source.
| void SetCropping | ( | int | pLeft, |
| int | pTop, | ||
| int | pRight, | ||
| int | pBottom | ||
| ) |
Sets cropping.
| pLeft | Left cropping value. |
| pTop | Top cropping value. |
| pRight | Right cropping value. |
| pBottom | Bottom cropping value. |
| int GetCroppingLeft | ( | ) | const |
Returns left cropping.
| int GetCroppingTop | ( | ) | const |
Returns top cropping.
| int GetCroppingRight | ( | ) | const |
Returns right cropping.
| int GetCroppingBottom | ( | ) | const |
Returns bottom cropping.
| void SetMappingType | ( | EMappingType | pMappingType | ) |
Sets the mapping type.
| pMappingType | The mapping type identifier. |
| EMappingType GetMappingType | ( | ) | const |
Returns the mapping type.
| void SetPlanarMappingNormal | ( | EPlanarMappingNormal | pPlanarMappingNormal | ) |
Sets the normal orientations for planar mapping.
| pPlanarMappingNormal | The identifier for planar mapping normal orientation. |
| EPlanarMappingNormal GetPlanarMappingNormal | ( | ) | const |
Returns the normal orientations for planar mapping.
| void SetTextureUse | ( | ETextureUse | pTextureUse | ) |
Sets the texture use.
| pTextureUse | The texture use identifier. |
| ETextureUse GetTextureUse | ( | ) | const |
Returns the texture use.
Sets the U and V wrap mode.
| pWrapU | Wrap mode identifier. |
| pWrapV | Wrap mode identifier. |
| EWrapMode GetWrapModeU | ( | ) | const |
| EWrapMode GetWrapModeV | ( | ) | const |
| void SetBlendMode | ( | EBlendMode | pBlendMode | ) |
| EBlendMode GetBlendMode | ( | ) | const |
| void SetDefaultT | ( | const FbxVector4 & | pT | ) | [inline] |
Sets the default translation vector.
| pT | The first element is the U translation applied to the texture. A displacement of one unit is equal to the texture width after the U scaling is applied. The second element is the V translation applied to the texture. A displacement of one unit is equal to the texture height after the V scaling is applied. The third and fourth elements have no effect on texture translation. |
Definition at line 395 of file fbxtexture.h.
{ Translation.Set( pT ); }
| FbxVector4& GetDefaultT | ( | FbxVector4 & | pT | ) | const |
Returns the default translation vector.
| pT | The first element is the U translation applied to the texture. A displacement of one unit is equal to the texture width after the U scaling is applied. The second element is the V translation applied to the texture. A displacement of one unit is equal to the texture height after the V scaling is applied. The third and fourth elements have no effect on texture translation. |
| void SetDefaultR | ( | const FbxVector4 & | pR | ) | [inline] |
Sets the default rotation vector.
| pR | The first element is the texture rotation around the U axis in degrees. The second element is the texture rotation around the V axis in degrees. The third element is the texture rotation around the W axis in degrees. |
Definition at line 417 of file fbxtexture.h.
{ Rotation.Set( FbxDouble3(pR[0],pR[1],pR[2]) ); }
| FbxVector4& GetDefaultR | ( | FbxVector4 & | pR | ) | const |
Returns the default rotation vector.
| pR | First element is the texture rotation around the U axis in degrees. Second element is the texture rotation around the V axis in degrees. Third element is the texture rotation around the W axis in degrees. |
| void SetDefaultS | ( | const FbxVector4 & | pS | ) | [inline] |
Sets the default scale vector.
| pS | The first element is scale applied to the texture width. The second element is scale applied to the texture height. The third and fourth elements have no effect on the texture. |
Definition at line 437 of file fbxtexture.h.
{ Scaling.Set( FbxDouble3(pS[0],pS[1],pS[2]) ); }
| FbxVector4& GetDefaultS | ( | FbxVector4 & | pS | ) | const |
Returns the default scale vector.
| pS | The first element is scale applied to the texture width. The second element is scale applied to the texture height. The third and fourth elements have no effect on the texture. |
| void SetDefaultAlpha | ( | double | pAlpha | ) |
Sets the default alpha.
| pAlpha | A value on a scale from 0 to 1, with 0 being transparent. |
| double GetDefaultAlpha | ( | ) | const |
Returns the default alpha.
| void SetTranslation | ( | double | pU, |
| double | pV | ||
| ) |
Sets translation.
| pU | Horizontal translation applied to a texture. A displacement of one unit is equal to the texture's width after applying U scaling. |
| pV | Vertical translation applied to a texture. A displacement of one unit is equal to the texture's height after applying V scaling. |
| double GetTranslationU | ( | ) | const |
Returns translation applied to the texture width.
| double GetTranslationV | ( | ) | const |
Returns translation applied to the texture height.
| void SetRotation | ( | double | pU, |
| double | pV, | ||
| double | pW = 0.0 |
||
| ) |
Sets rotation.
| pU | Texture rotation around the U axis in degrees. |
| pV | Texture rotation around the V axis in degrees. |
| pW | Texture rotation around the W axis in degrees. |
| double GetRotationU | ( | ) | const |
Returns the texture rotation around the U axis in degrees.
| double GetRotationV | ( | ) | const |
Returns the texture rotation around the V axis in degrees.
| double GetRotationW | ( | ) | const |
Returns the texture rotation around the W axis in degrees.
| void SetScale | ( | double | pU, |
| double | pV | ||
| ) |
Sets scale.
| pU | Scale applied to the texture width. |
| pV | Scale applied to the texture height. |
| double GetScaleU | ( | ) | const |
Returns scale applied to the texture width.
| double GetScaleV | ( | ) | const |
Returns scale applied to the texture height.
This property handles the use of textures.
Default value is eTEXTURE_USE_6_STANDARD.
Definition at line 113 of file fbxtexture.h.
This property handles the default alpha value for textures.
Default value is 1.0
Definition at line 118 of file fbxtexture.h.
This property handles the texture mapping types.
Default value is eUMT_UV.
Definition at line 126 of file fbxtexture.h.
This property handles the texture wrap modes in U.
Default value is eRepeat.
Definition at line 131 of file fbxtexture.h.
This property handles the texture wrap modes in V.
Default value is eRepeat.
Definition at line 136 of file fbxtexture.h.
This property handles the swap UV flag.
If swap UV flag is enabled, the texture's width and height are swapped. Default value is false.
Definition at line 142 of file fbxtexture.h.
This property handles the PremultiplyAlpha flag.
If PremultiplyAlpha flag is true, the R, G, and B components you store have already been multiplied in with the alpha. Default value is true.
Definition at line 148 of file fbxtexture.h.
This property handles the default translation vector.
Default value is FbxDouble3(0.0,0.0,0.0).
Definition at line 155 of file fbxtexture.h.
This property handles the default rotation vector.
Default value is FbxDouble3(0.0,0.0,0.0).
Definition at line 160 of file fbxtexture.h.
This property handles the default scale vector.
Default value is FbxDouble3(1.0,1.0,1.0).
Definition at line 165 of file fbxtexture.h.
This property handles the rotation pivot vector.
Default value is FbxDouble3(0.0,0.0,0.0).
Definition at line 170 of file fbxtexture.h.
This property handles the scaling pivot vector.
Default value is FbxDouble3(0.0,0.0,0.0).
Definition at line 175 of file fbxtexture.h.
This property handles the texture blend mode.
Default value is eAdditive.
Definition at line 181 of file fbxtexture.h.
This property handles the use of UV sets.
Default value is "default".
Definition at line 187 of file fbxtexture.h.
const char* sVectorSpace
[static] |
This property only used by Vector Displacement Texture so it is not added to FbxTexture.
It is a dynamic enum property which has values : "World", "Object" and "Tangent" Default value is "Object".
Definition at line 193 of file fbxtexture.h.
const char* sVectorSpaceWorld
[static] |
Definition at line 194 of file fbxtexture.h.
const char* sVectorSpaceObject
[static] |
Definition at line 195 of file fbxtexture.h.
const char* sVectorSpaceTangent
[static] |
Definition at line 196 of file fbxtexture.h.
const char* sVectorEncoding
[static] |
This property only used by Vector Displacement Texture so it is not added to FbxTexture.
It is a dynamic enum property which has values : "Floating-point Absolute" and "Signed Encoding" Default value is "Floating-point Absolute".
Definition at line 202 of file fbxtexture.h.
const char* sVectorEncodingFP
[static] |
Definition at line 203 of file fbxtexture.h.
const char* sVectorEncodingSE
[static] |
Definition at line 204 of file fbxtexture.h.