This reference page is linked to from the following overview topics:

#include <fbxlayer.h>

Class Description

Layer element for mapping Textures to a geometry.

This class is deprecated.

Deprecated since FBX SDK 2011. Textures (FbxTexture derived classes) should be connected to material properties.

For example:

FbxFileTexture*  file;
FbxSurfacePhong* phong;
phong->Diffuse.ConnectSrcObject(file);

See Also: FbxSurfaceMaterial

Remarks: To be correctly saved in FBX file, this type of Layer element should have its reference mode set to eIndexToDirect.

Definition at line 2172 of file fbxlayer.h.

Inheritance diagram for FbxLayerElementTexture:

Public Types
enum	EBlendMode { eTranslucent, eAdd, eModulate, eModulate2, eOver, eNormal, eDissolve, eDarken, eColorBurn, eLinearBurn, eDarkerColor, eLighten, eScreen, eColorDodge, eLinearDodge, eLighterColor, eSoftLight, eHardLight, eVividLight, eLinearLight, ePinLight, eHardMix, eDifference, eExclusion, eSubtract, eDivide, eHue, eSaturation, eColor, eLuminosity, eOverlay, eBlendModeCount }
	Lets you control how textures are combined when you apply multiple layers of texture to a surface. More...

Public Types inherited from FbxLayerElement
enum	EType { eUnknown, eNormal, eBiNormal, eTangent, eMaterial, ePolygonGroup, eUV, eVertexColor, eSmoothing, eVertexCrease, eEdgeCrease, eHole, eUserData, eVisibility, eTextureDiffuse, eTextureDiffuseFactor, eTextureEmissive, eTextureEmissiveFactor, eTextureAmbient, eTextureAmbientFactor, eTextureSpecular, eTextureSpecularFactor, eTextureShininess, eTextureNormalMap, eTextureBump, eTextureTransparency, eTextureTransparencyFactor, eTextureReflection, eTextureReflectionFactor, eTextureDisplacement, eTextureDisplacementVector, eTypeCount }
	Layer Element type identifier. More...

enum	EMappingMode { eNone, eByControlPoint, eByPolygonVertex, eByPolygon, eByEdge, eAllSame }
	Determines how the element is mapped to a surface. More...

enum	EReferenceMode { eDirect, eIndex, eIndexToDirect }
	Determines how the mapping information is stored in the array of coordinates. More...

Public Member Functions
	FBXSDK_LAYER_ELEMENT_CREATE_DECLARE (LayerElementTexture)
	Allocation method. More...

void	SetBlendMode (EBlendMode pBlendMode)
	Sets the way Textures blend between layers. More...

void	SetAlpha (double pAlpha)
	Sets the transparency level between multiple texture levels. More...

EBlendMode	GetBlendMode () const
	Returns the way Textures blend between layers. More...

double	GetAlpha () const
	Returns the transparency level between multiple levels of textures. More...

Public Member Functions inherited from FbxLayerElementTemplate< FbxTexture * >
FbxLayerElementArrayTemplate < FbxTexture * > &	GetDirectArray () const
	Returns the direct array of Layer Elements. More...

FbxLayerElementArrayTemplate < FbxTexture * > &	GetDirectArray ()
	Returns the direct array of Layer Elements. More...

FbxLayerElementArrayTemplate < int > &	GetIndexArray () const
	Returns the index array of Layer Elements. More...

FbxLayerElementArrayTemplate < int > &	GetIndexArray ()
	Returns the index array of Layer Elements. More...

bool	Clear ()
	Removes all elements from the direct and the index arrays. More...

bool	operator== (const FbxLayerElementTemplate &pOther) const
	Equivalence operator. More...

FbxLayerElementTemplate &	operator= (FbxLayerElementTemplate const &pOther)
	Assignment operator. More...

int	RemapIndexTo (FbxLayerElement::EMappingMode pNewMapping)
	Changes the Mapping mode to the new one and re-computes the index array. More...

Public Member Functions inherited from FbxLayerElement
void	SetMappingMode (EMappingMode pMappingMode)
	Sets the Mapping Mode. More...

void	SetReferenceMode (EReferenceMode pReferenceMode)
	Sets the Reference Mode. More...

EMappingMode	GetMappingMode () const
	Returns the Mapping Mode. More...

EReferenceMode	GetReferenceMode () const
	Returns the Reference Mode. More...

void	SetName (const char *pName)
	Sets the name of this object. More...

const char *	GetName () const
	Returns the name of this object. More...

bool	operator== (const FbxLayerElement &pOther) const
	Equivalence operator. More...

FbxLayerElement &	operator= (FbxLayerElement const &pOther)
	Assignment operator. More...

void	Destroy ()
	Removes this layer element from its owner and delete it. More...

Additional Inherited Members
Static Public Attributes inherited from FbxLayerElement
static const int	sTypeTextureStartIndex = int(eTextureDiffuse)
	The start index of texture type layer elements. More...

static const int	sTypeTextureEndIndex = int(eTypeCount) - 1
	The end index of texture type layer elements. More...

static const int	sTypeTextureCount = sTypeTextureEndIndex - sTypeTextureStartIndex + 1
	The count of texture type layer elements. More...

static const int	sTypeNonTextureStartIndex = int(eNormal)
	The start index of non-texture type layer elements. More...

static const int	sTypeNonTextureEndIndex = int(eVisibility)
	The end index of non-texture type layer elements. More...

static const int	sTypeNonTextureCount = sTypeNonTextureEndIndex - sTypeNonTextureStartIndex + 1
	The count of non-texture type layer elements. More...

static const char *const	sTextureNames []
	Array of names of texture type layer elements. More...

static const char *const	sTextureUVNames []
	Array of names of UV layer elements. More...

static const char *const	sNonTextureNames []
	Array of names of non-texture type layer elements. More...

static const FbxDataType	sTextureDataTypes []
	Array of texture types. More...

static const char *const	sTextureChannelNames []
	Array of texture channels. More...

Member Enumeration Documentation

enum EBlendMode

Lets you control how textures are combined when you apply multiple layers of texture to a surface.

eTranslucent The new texture layer is transparent (depending on the Alpha value).
eAdd Add the color of the new texture to the previous texture.
eModulate Multiples the color value of the new texture by the color values of all previous layers of texture.
eModulate2 Multiples the color value of the new texture by two and then by the color values of all previous layers of texture.
eOver Equivalent to eTranslucent. Blends the new texture over top of the old texture, according to the new texture's alpha channel.
eNormal, The colors of the two layers will not interact in any way, and it will display the full value of the colors in layer 1.
eDissolve, Dissolve makes the lower layer take on the colors of the top layer, and how much depends on the opacity of the upper layer.
eDarken, Darken compares each pixel value of the upper layer to its counterpart's pixel value of the lower layer and chooses the darker of the two to display.
eColorBurn, Color Burn burns in the color of the upper layer with the lower layer. No part of the image will get lighter.
eLinearBurn, Linear Burn works like multiply but the results are more intense.
eDarkerColor, This blend mode simply divides pixel values of one layer with the other.
eLighten, Lighten compares the two layers pixel for pixel and uses the lightest pixel value. No part of the image gets darker.
eScreen, Screen brightens by lightning the lower layer based on the lightness of the upper layer
eColorDodge, Color Dodge dodges the lower layer with the upper layer, resulting in a lighter image. No part of the image will be darkened.
eLinearDodge, Linear Dodge works like screen but with more intense results.
eLighterColor, This blend mode has the opposite effect of the Darker Color mode. It compares all the values in both layers, then displays the lightest values.
eSoftLight, Soft Light will multiply the dark tones and screen the light tones.
eHardLight, Hard Light multiplies the dark colors and screens the light colors.
eVividLight, Vivid Light will dodges or burn the lower layer pixels depending on whether the upper layer pixels are brighter or darker than neutral gray. It works on the contrast of the lower layer.
eLinearLight, Linear Light is the same as Vivid light but it works on the brightness of the lower layer.
ePinLight, Pin Light changes the lower layer pixels depending on how bright the pixels are in the upper layer.
eHardMix, Produces either white or black, depending on similarities between A and B.
eDifference, Difference reacts to the differences between the upper and lower layer pixels.
eExclusion, Exclusion uses the darkness of the lower layer to mask the difference between upper and lower layers.
eSubtract, The result color is the foreground color subtracted from the background color. The result color is then applied over the background color using the foreground alpha to define the opacity of the result.
eDivide, This blend mode simply divides pixel values of one layer with the other.
eHue, Hue changes the hue of the lower layer to the hue of the upper layer but leaves brightness and saturation alone.
eSaturation, Saturation changes the saturation of the lower layer to the hue of the upper layer but leaves brightness and hue alone.
eColor, Color changes the hue and saturation of the lower layer to the hue and saturation of the upper layer but leaves luminosity alone.
eLuminosity, Luminosity changes the luminosity of the lower layer to the luminosity of the upper layer while leaving hue and saturation the same.
eOverlay, Multiplies (darkens) when the layer on which the mode is set is dark and screens (brightens) when the layer on which the mode is applied is lighter.
eBlendModeCount Marks the end of the blend mode enum.

Enumerator
eTranslucent
eAdd
eModulate
eModulate2
eOver
eNormal
eDissolve
eDarken
eColorBurn
eLinearBurn
eDarkerColor
eLighten
eScreen
eColorDodge
eLinearDodge
eLighterColor
eSoftLight
eHardLight
eVividLight
eLinearLight
ePinLight
eHardMix
eDifference
eExclusion
eSubtract
eDivide
eHue
eSaturation
eColor
eLuminosity
eOverlay
eBlendModeCount

Definition at line 2214 of file fbxlayer.h.

     {
         eTranslucent,
         eAdd,
         eModulate,
         eModulate2,
         eOver,
         eNormal,        
         eDissolve,
         eDarken,            
         eColorBurn,
         eLinearBurn,    
         eDarkerColor,
         eLighten,           
         eScreen,        
         eColorDodge,
         eLinearDodge,
         eLighterColor,
         eSoftLight,     
         eHardLight,     
         eVividLight,
         eLinearLight,
         ePinLight,      
         eHardMix,       
         eDifference,        
         eExclusion,         
         eSubtract,
         eDivide,
         eHue,           
         eSaturation,        
         eColor,     
         eLuminosity,
         eOverlay,
         eBlendModeCount
     };

Member Function Documentation

FBXSDK_LAYER_ELEMENT_CREATE_DECLARE ( LayerElementTexture )

Allocation method.

Returns: A pointer to the layer element or NULL if creation fails.

void SetBlendMode ( EBlendMode pBlendMode )

inline

Sets the way Textures blend between layers.

Parameters

pBlendMode A valid blend mode.

Definition at line 2253 of file fbxlayer.h.

2253 { mBlendMode = pBlendMode; }

void SetAlpha ( double pAlpha )

inline

Sets the transparency level between multiple texture levels.

Parameters

pAlpha Set to a value between 0.0 and 1.0, where 0.0 is totally transparent and 1.0 is totally opaque.

Remarks: Values smaller than 0.0 are clipped to 0.0, while values greater than 1.0 are clipped to 1.0.

Definition at line 2259 of file fbxlayer.h.

     {
         if (pAlpha > 1.0)
             mAlpha = 1.0;
         else if (pAlpha < 0.0)
             mAlpha = 0.0;
         else
             mAlpha = pAlpha;
     }

EBlendMode GetBlendMode ( ) const

inline

Returns the way Textures blend between layers.

Returns: The current Blend Mode.

Definition at line 2272 of file fbxlayer.h.

2272 { return mBlendMode; }

double GetAlpha ( ) const

inline

Returns the transparency level between multiple levels of textures.

Returns: An alpha value between 0.0 and 1.0, where 0.0 is totally transparent and 1.0 is totally opaque.

Definition at line 2277 of file fbxlayer.h.

2277 { return mAlpha; }

The documentation for this class was generated from the following file:

fbxsdk/scene/geometry/fbxlayer.h

FbxLayerElementTexture Class Reference

Class Description

Public Types

Public Member Functions

Additional Inherited Members

Member Enumeration Documentation

Member Function Documentation