This reference page is linked to from the following overview topics: FBX SDK 2012, Supported Scene Elements, FBX Scenes, Textures, Layered Textures, List of Python FBX classes.
This class is the base class for textures, ie classes KFbxFileTexture, KFbxLayeredTexture and KFbxProceduralTexture.
It describes image mapping on top of a geometry.
ExportDocument/main.cxx, ImportScene/DisplayMaterial.cxx, ImportScene/DisplayMesh.cxx, ImportScene/DisplayTexture.cxx, ImportScene/DisplayTexture.h, and Layers/main.cxx.
Definition at line 59 of file kfbxtexture.h.
#include <kfbxtexture.h>
Public Member Functions |
|
virtual KFbxObject & | Copy (const KFbxObject &pObject) |
Copy an object content into this object.
|
|
virtual bool | operator== (KFbxTexture const &pTexture) const |
void | SetUVTranslation (KFbxVector2 &pT) |
KFbxVector2 & | GetUVTranslation () |
void | SetUVScaling (KFbxVector2 &pS) |
KFbxVector2 & | GetUVScaling () |
KString | GetTextureType () |
Protected Member Functions |
|
KFbxTexture (KFbxSdkManager &pManager, char const *pName) | |
virtual void | Construct (const KFbxTexture *pFrom) |
virtual bool | ConstructProperties (bool pForceSet) |
virtual bool | PropertyNotify (eFbxPropertyNotify pType, KFbxProperty *pProperty) |
void | Init () |
Protected Attributes |
|
int | mCropping [4] |
EAlphaSource | mAlphaSource |
EMappingType | mMappingType |
EPlanarMappingNormal | mPlanarMappingNormal |
KFbxVector2 | mUVScaling |
KFbxVector2 | mUVTranslation |
Static Protected Attributes |
|
static KError | smError |
Friends |
|
class | KFbxLayerContainer |
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 = 0, eRIGHT, eTOP, eBOTTOM } |
Align indices for cropping. More... |
|
enum | ECoordinates { eU = 0, eV, eW } |
Texture coordinates. More... |
|
enum | EAlphaSource { eNONE, eRGB_INTENSITY, 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 { ePLANAR_NORMAL_X, ePLANAR_NORMAL_Y, ePLANAR_NORMAL_Z } |
Planar mapping normal orientations. More... |
|
enum | ETextureUse
{ eSTANDARD, eSHADOW_MAP, eLIGHT_MAP, eSPHERICAL_REFLEXION_MAP, eSPHERE_REFLEXION_MAP, eBUMP_NORMAL_MAP } |
Texture uses. More... |
|
KFbxTypedProperty< ETextureUse6 > | TextureTypeUse |
This property handles the use of textures.
|
|
KFbxTypedProperty< fbxDouble1 > | Alpha |
This property handles the default alpha
value for textures. |
|
KFbxTypedProperty < EUnifiedMappingType > |
CurrentMappingType |
This property handles the texture mapping
types. |
|
KFbxTypedProperty< EWrapMode > | WrapModeU |
This property handles the texture wrap modes
in U. |
|
KFbxTypedProperty< EWrapMode > | WrapModeV |
This property handles the texture wrap modes
in V. |
|
KFbxTypedProperty< fbxBool1 > | UVSwap |
This property handles the swap UV flag.
|
|
KFbxTypedProperty< fbxBool1 > | PremultiplyAlpha |
This property handles the PremultiplyAlpha
flag. |
|
KFbxTypedProperty< fbxDouble3 > | Translation |
This property handles the default
translation vector. |
|
KFbxTypedProperty< fbxDouble3 > | Rotation |
This property handles the default rotation
vector. |
|
KFbxTypedProperty< fbxDouble3 > | Scaling |
This property handles the default scale
vector. |
|
KFbxTypedProperty< fbxDouble3 > | RotationPivot |
This property handles the rotation pivot
vector. |
|
KFbxTypedProperty< fbxDouble3 > | ScalingPivot |
This property handles the scaling pivot
vector. |
|
KFbxTypedProperty< EBlendMode > | CurrentTextureBlendMode |
This property handles the texture blend
mode. |
|
KFbxTypedProperty< 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
KFbxTexture. |
|
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
KFbxTexture. |
|
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 KFbxVector4 &pT) |
Sets the default translation vector.
|
|
KFbxVector4 & | GetDefaultT (KFbxVector4 &pT) const |
Returns the default translation vector.
|
|
void | SetDefaultR (const KFbxVector4 &pR) |
Sets the default rotation vector. |
|
KFbxVector4 & | GetDefaultR (KFbxVector4 &pR) const |
Returns the default rotation vector.
|
|
void | SetDefaultS (const KFbxVector4 &pS) |
Sets the default scale vector. |
|
KFbxVector4 & | GetDefaultS (KFbxVector4 &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 74 of file kfbxtexture.h.
{ eUMT_UV, eUMT_XY, eUMT_YZ, eUMT_XZ, eUMT_SPHERICAL, eUMT_CYLINDRICAL, eUMT_ENVIRONMENT, eUMT_PROJECTION, eUMT_BOX, // deprecated eUMT_FACE, // deprecated eUMT_NO_MAPPING, } EUnifiedMappingType;
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 105 of file kfbxtexture.h.
enum EWrapMode |
Wrap modes.
Use SetWrapMode(), GetWrapModeU() and GetWrapModeV() to access these values.
Definition at line 124 of file kfbxtexture.h.
enum EBlendMode |
Blend modes.
Reimplemented in KFbxLayeredTexture.
Definition at line 134 of file kfbxtexture.h.
{ eTRANSLUCENT, eADDITIVE, eMODULATE, eMODULATE2, eOVER } EBlendMode;
enum EAlignMode |
Align indices for cropping.
Definition at line 150 of file kfbxtexture.h.
{ eLEFT = 0, eRIGHT, eTOP, eBOTTOM } EAlignMode;
enum ECoordinates |
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 Alpha. |
eRGB_INTENSITY |
RGB Intensity (computed). |
eBLACK |
Alpha channel. Black is 100% transparency, white is opaque. |
Definition at line 303 of file kfbxtexture.h.
{ eNONE, eRGB_INTENSITY, eBLACK } EAlphaSource;
enum EMappingType |
Texture mapping types.
Definition at line 356 of file kfbxtexture.h.
{ eNULL, ePLANAR, eSPHERICAL, eCYLINDRICAL, eBOX, eFACE, eUV, eENVIRONMENT } EMappingType;
enum EPlanarMappingNormal |
Planar mapping normal orientations.
Definition at line 388 of file kfbxtexture.h.
enum ETextureUse |
Texture uses.
Definition at line 410 of file kfbxtexture.h.
KFbxTexture | ( | KFbxSdkManager & | pManager, |
char const * | pName | ||
) | [protected] |
virtual void Reset | ( | ) | [virtual] |
Resets the default texture values.
Reimplemented in KFbxFileTexture, and KFbxProceduralTexture.
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 KFbxVector4 & | 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 481 of file kfbxtexture.h.
{ Translation.Set( pT ); }
KFbxVector4& GetDefaultT | ( | KFbxVector4 & | 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 KFbxVector4 & | 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 503 of file kfbxtexture.h.
{ Rotation.Set( fbxDouble3(pR[0],pR[1],pR[2]) ); }
KFbxVector4& GetDefaultR | ( | KFbxVector4 & | 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 KFbxVector4 & | 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 523 of file kfbxtexture.h.
{ Scaling.Set( fbxDouble3(pS[0],pS[1],pS[2]) ); }
KFbxVector4& GetDefaultS | ( | KFbxVector4 & | 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.
virtual KFbxObject& Copy | ( | const KFbxObject & | pObject | ) | [virtual] |
Copy an object content into this object.
pObject | The source object to copy data from. |
Reimplemented from KFbxObject.
Reimplemented in KFbxFileTexture, and KFbxProceduralTexture.
virtual bool operator== | ( | KFbxTexture const & | pTexture | ) | const [virtual] |
void SetUVTranslation | ( | KFbxVector2 & | pT | ) |
KFbxVector2& GetUVTranslation | ( | ) |
void SetUVScaling | ( | KFbxVector2 & | pS | ) |
KFbxVector2& GetUVScaling | ( | ) |
KString GetTextureType | ( | ) |
virtual void Construct | ( | const KFbxTexture * | pFrom | ) | [protected, virtual] |
virtual bool ConstructProperties | ( | bool | pForceSet | ) | [protected, virtual] |
Reimplemented from KFbxObject.
Reimplemented in KFbxFileTexture, and KFbxProceduralTexture.
virtual bool PropertyNotify | ( | eFbxPropertyNotify | pType, |
KFbxProperty * | pProperty | ||
) | [protected, virtual] |
Reimplemented from KFbxObject.
void Init | ( | ) | [protected] |
Reimplemented in KFbxFileTexture, and KFbxProceduralTexture.
friend class KFbxLayerContainer
[friend] |
Reimplemented in KFbxFileTexture.
Definition at line 663 of file kfbxtexture.h.
This property handles the use of textures.
Default value is eTEXTURE_USE_6_STANDARD.
Definition at line 179 of file kfbxtexture.h.
This property handles the default alpha value for textures.
Default value is 1.0
Definition at line 184 of file kfbxtexture.h.
This property handles the texture mapping types.
Default value is eUMT_UV.
Definition at line 192 of file kfbxtexture.h.
This property handles the texture wrap modes in U.
Default value is eREPEAT.
Definition at line 197 of file kfbxtexture.h.
This property handles the texture wrap modes in V.
Default value is eREPEAT.
Definition at line 202 of file kfbxtexture.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 208 of file kfbxtexture.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 214 of file kfbxtexture.h.
This property handles the default translation vector.
Default value is fbxDouble3(0.0,0.0,0.0).
Definition at line 221 of file kfbxtexture.h.
This property handles the default rotation vector.
Default value is fbxDouble3(0.0,0.0,0.0).
Definition at line 226 of file kfbxtexture.h.
This property handles the default scale vector.
Default value is fbxDouble3(1.0,1.0,1.0).
Definition at line 231 of file kfbxtexture.h.
This property handles the rotation pivot vector.
Default value is fbxDouble3(0.0,0.0,0.0).
Definition at line 236 of file kfbxtexture.h.
This property handles the scaling pivot vector.
Default value is fbxDouble3(0.0,0.0,0.0).
Definition at line 241 of file kfbxtexture.h.
This property handles the texture blend mode.
Default value is eADDITIVE.
Definition at line 247 of file kfbxtexture.h.
This property handles the use of UV sets.
Default value is default.
Definition at line 253 of file kfbxtexture.h.
const char* sVectorSpace
[static] |
This property only used by Vector Displacement Texture so it is not added to KFbxTexture.
It is a dynamic enum property which has values : "World", "Object" and "Tangent" Default value is "Object".
Definition at line 259 of file kfbxtexture.h.
const char* sVectorSpaceWorld
[static] |
Definition at line 260 of file kfbxtexture.h.
const char* sVectorSpaceObject
[static] |
Definition at line 261 of file kfbxtexture.h.
const char* sVectorSpaceTangent
[static] |
Definition at line 262 of file kfbxtexture.h.
const char* sVectorEncoding
[static] |
This property only used by Vector Displacement Texture so it is not added to KFbxTexture.
It is a dynamic enum property which has values : "Floating-point Absolute" and "Signed Encoding" Default value is "Floating-point Absolute".
Definition at line 268 of file kfbxtexture.h.
const char* sVectorEncodingFP
[static] |
Definition at line 269 of file kfbxtexture.h.
const char* sVectorEncodingSE
[static] |
Definition at line 270 of file kfbxtexture.h.
int mCropping[4]
[protected] |
Definition at line 650 of file kfbxtexture.h.
EAlphaSource
mAlphaSource
[protected] |
Definition at line 652 of file kfbxtexture.h.
EMappingType
mMappingType
[protected] |
Definition at line 653 of file kfbxtexture.h.
EPlanarMappingNormal
mPlanarMappingNormal
[protected] |
Definition at line 654 of file kfbxtexture.h.
Definition at line 655 of file kfbxtexture.h.
KFbxVector2 mUVScaling
[protected] |
Definition at line 660 of file kfbxtexture.h.
KFbxVector2 mUVTranslation
[protected] |
Definition at line 661 of file kfbxtexture.h.