// Copyright (C) 2002-2012 Nikolaus Gebhardt // This file is part of the "Irrlicht Engine". // For conditions of distribution and use, see copyright notice in irrlicht.h #ifndef __S_MATERIAL_H_INCLUDED__ #define __S_MATERIAL_H_INCLUDED__ #include "SColor.h" #include "matrix4.h" #include "irrArray.h" #include "irrMath.h" #include "EMaterialTypes.h" #include "EMaterialFlags.h" #include "SMaterialLayer.h" namespace irr { namespace video { class ITexture; //! Flag for EMT_ONETEXTURE_BLEND, ( BlendFactor ) BlendFunc = source * sourceFactor + dest * destFactor enum E_BLEND_FACTOR { EBF_ZERO = 0, //!< src & dest (0, 0, 0, 0) EBF_ONE, //!< src & dest (1, 1, 1, 1) EBF_DST_COLOR, //!< src (destR, destG, destB, destA) EBF_ONE_MINUS_DST_COLOR, //!< src (1-destR, 1-destG, 1-destB, 1-destA) EBF_SRC_COLOR, //!< dest (srcR, srcG, srcB, srcA) EBF_ONE_MINUS_SRC_COLOR, //!< dest (1-srcR, 1-srcG, 1-srcB, 1-srcA) EBF_SRC_ALPHA, //!< src & dest (srcA, srcA, srcA, srcA) EBF_ONE_MINUS_SRC_ALPHA, //!< src & dest (1-srcA, 1-srcA, 1-srcA, 1-srcA) EBF_DST_ALPHA, //!< src & dest (destA, destA, destA, destA) EBF_ONE_MINUS_DST_ALPHA, //!< src & dest (1-destA, 1-destA, 1-destA, 1-destA) EBF_SRC_ALPHA_SATURATE //!< src (min(srcA, 1-destA), idem, ...) }; //! Values defining the blend operation used when blend is enabled enum E_BLEND_OPERATION { EBO_NONE = 0, //!< No blending happens EBO_ADD, //!< Default blending adds the color values EBO_SUBTRACT, //!< This mode subtracts the color values EBO_REVSUBTRACT,//!< This modes subtracts destination from source EBO_MIN, //!< Choose minimum value of each color channel EBO_MAX, //!< Choose maximum value of each color channel EBO_MIN_FACTOR, //!< Choose minimum value of each color channel after applying blend factors, not widely supported EBO_MAX_FACTOR, //!< Choose maximum value of each color channel after applying blend factors, not widely supported EBO_MIN_ALPHA, //!< Choose minimum value of each color channel based on alpha value, not widely supported EBO_MAX_ALPHA //!< Choose maximum value of each color channel based on alpha value, not widely supported }; //! MaterialTypeParam: e.g. DirectX: D3DTOP_MODULATE, D3DTOP_MODULATE2X, D3DTOP_MODULATE4X enum E_MODULATE_FUNC { EMFN_MODULATE_1X = 1, EMFN_MODULATE_2X = 2, EMFN_MODULATE_4X = 4 }; //! Comparison function, e.g. for depth buffer test enum E_COMPARISON_FUNC { //! Test never succeeds, this equals disable ECFN_NEVER=0, //! <= test, default for e.g. depth test ECFN_LESSEQUAL=1, //! Exact equality ECFN_EQUAL=2, //! exclusive less comparison, i.e. < ECFN_LESS, //! Succeeds almost always, except for exact equality ECFN_NOTEQUAL, //! >= test ECFN_GREATEREQUAL, //! inverse of <= ECFN_GREATER, //! test succeeds always ECFN_ALWAYS }; //! Enum values for enabling/disabling color planes for rendering enum E_COLOR_PLANE { //! No color enabled ECP_NONE=0, //! Alpha enabled ECP_ALPHA=1, //! Red enabled ECP_RED=2, //! Green enabled ECP_GREEN=4, //! Blue enabled ECP_BLUE=8, //! All colors, no alpha ECP_RGB=14, //! All planes enabled ECP_ALL=15 }; //! Source of the alpha value to take /** This is currently only supported in EMT_ONETEXTURE_BLEND. You can use an or'ed combination of values. Alpha values are modulated (multiplicated). */ enum E_ALPHA_SOURCE { //! Use no alpha, somewhat redundant with other settings EAS_NONE=0, //! Use vertex color alpha EAS_VERTEX_COLOR, //! Use texture alpha channel EAS_TEXTURE }; //! EMT_ONETEXTURE_BLEND: pack srcFact, dstFact, Modulate and alpha source to MaterialTypeParam /** alpha source can be an OR'ed combination of E_ALPHA_SOURCE values. */ inline f32 pack_textureBlendFunc ( const E_BLEND_FACTOR srcFact, const E_BLEND_FACTOR dstFact, const E_MODULATE_FUNC modulate=EMFN_MODULATE_1X, const u32 alphaSource=EAS_TEXTURE ) { const u32 tmp = (alphaSource << 12) | (modulate << 8) | (srcFact << 4) | dstFact; return FR(tmp); } //! EMT_ONETEXTURE_BLEND: unpack srcFact & dstFact and Modulo to MaterialTypeParam /** The fields don't use the full byte range, so we could pack even more... */ inline void unpack_textureBlendFunc ( E_BLEND_FACTOR &srcFact, E_BLEND_FACTOR &dstFact, E_MODULATE_FUNC &modulo, u32& alphaSource, const f32 param ) { const u32 state = IR(param); alphaSource = (state & 0x0000F000) >> 12; modulo = E_MODULATE_FUNC( ( state & 0x00000F00 ) >> 8 ); srcFact = E_BLEND_FACTOR ( ( state & 0x000000F0 ) >> 4 ); dstFact = E_BLEND_FACTOR ( ( state & 0x0000000F ) ); } //! EMT_ONETEXTURE_BLEND: has BlendFactor Alphablending inline bool textureBlendFunc_hasAlpha ( const E_BLEND_FACTOR factor ) { switch ( factor ) { case EBF_SRC_ALPHA: case EBF_ONE_MINUS_SRC_ALPHA: case EBF_DST_ALPHA: case EBF_ONE_MINUS_DST_ALPHA: case EBF_SRC_ALPHA_SATURATE: return true; default: return false; } } //! These flags are used to specify the anti-aliasing and smoothing modes /** Techniques supported are multisampling, geometry smoothing, and alpha to coverage. Some drivers don't support a per-material setting of the anti-aliasing modes. In those cases, FSAA/multisampling is defined by the device mode chosen upon creation via irr::SIrrCreationParameters. */ enum E_ANTI_ALIASING_MODE { //! Use to turn off anti-aliasing for this material EAAM_OFF=0, //! Default anti-aliasing mode EAAM_SIMPLE=1, //! High-quality anti-aliasing, not always supported, automatically enables SIMPLE mode EAAM_QUALITY=3, //! Line smoothing EAAM_LINE_SMOOTH=4, //! point smoothing, often in software and slow, only with OpenGL EAAM_POINT_SMOOTH=8, //! All typical anti-alias and smooth modes EAAM_FULL_BASIC=15, //! Enhanced anti-aliasing for transparent materials /** Usually used with EMT_TRANSPARENT_ALPHA_REF and multisampling. */ EAAM_ALPHA_TO_COVERAGE=16 }; //! These flags allow to define the interpretation of vertex color when lighting is enabled /** Without lighting being enabled the vertex color is the only value defining the fragment color. Once lighting is enabled, the four values for diffuse, ambient, emissive, and specular take over. With these flags it is possible to define which lighting factor shall be defined by the vertex color instead of the lighting factor which is the same for all faces of that material. The default is to use vertex color for the diffuse value, another pretty common value is to use vertex color for both diffuse and ambient factor. */ enum E_COLOR_MATERIAL { //! Don't use vertex color for lighting ECM_NONE=0, //! Use vertex color for diffuse light, this is default ECM_DIFFUSE, //! Use vertex color for ambient light ECM_AMBIENT, //! Use vertex color for emissive light ECM_EMISSIVE, //! Use vertex color for specular light ECM_SPECULAR, //! Use vertex color for both diffuse and ambient light ECM_DIFFUSE_AND_AMBIENT }; //! Flags for the definition of the polygon offset feature /** These flags define whether the offset should be into the screen, or towards the eye. */ enum E_POLYGON_OFFSET { //! Push pixel towards the far plane, away from the eye /** This is typically used for rendering inner areas. */ EPO_BACK=0, //! Pull pixels towards the camera. /** This is typically used for polygons which should appear on top of other elements, such as decals. */ EPO_FRONT=1 }; //! Names for polygon offset direction const c8* const PolygonOffsetDirectionNames[] = { "Back", "Front", 0 }; //! Maximum number of texture an SMaterial can have. const u32 MATERIAL_MAX_TEXTURES = _IRR_MATERIAL_MAX_TEXTURES_; //! Struct for holding parameters for a material renderer class SMaterial { public: //! Default constructor. Creates a solid, lit material with white colors SMaterial() : MaterialType(EMT_SOLID), AmbientColor(255,255,255,255), DiffuseColor(255,255,255,255), EmissiveColor(0,0,0,0), SpecularColor(255,255,255,255), Shininess(0.0f), MaterialTypeParam(0.0f), MaterialTypeParam2(0.0f), Thickness(1.0f), ZBuffer(ECFN_LESSEQUAL), AntiAliasing(EAAM_SIMPLE), ColorMask(ECP_ALL), ColorMaterial(ECM_DIFFUSE), BlendOperation(EBO_NONE), PolygonOffsetFactor(0), PolygonOffsetDirection(EPO_FRONT), Wireframe(false), PointCloud(false), GouraudShading(true), Lighting(true), ZWriteEnable(true), BackfaceCulling(true), FrontfaceCulling(false), FogEnable(false), NormalizeNormals(false), UseMipMaps(true) { } //! Copy constructor /** \param other Material to copy from. */ SMaterial(const SMaterial& other) { // These pointers are checked during assignment for (u32 i=0; igetMaterial(0).Shininess = 20.0f; \endcode You can change the color of the highlights using \code sceneNode->getMaterial(0).SpecularColor.set(255,255,255,255); \endcode The specular color of the dynamic lights (SLight::SpecularColor) will influence the the highlight color too, but they are set to a useful value by default when creating the light scene node. Here is a simple example on how to use specular highlights: \code // load and display mesh scene::IAnimatedMeshSceneNode* node = smgr->addAnimatedMeshSceneNode( smgr->getMesh("data/faerie.md2")); node->setMaterialTexture(0, driver->getTexture("data/Faerie2.pcx")); // set diffuse texture node->setMaterialFlag(video::EMF_LIGHTING, true); // enable dynamic lighting node->getMaterial(0).Shininess = 20.0f; // set size of specular highlights // add white light scene::ILightSceneNode* light = smgr->addLightSceneNode(0, core::vector3df(5,5,5), video::SColorf(1.0f, 1.0f, 1.0f)); \endcode */ f32 Shininess; //! Free parameter, dependent on the material type. /** Mostly ignored, used for example in EMT_PARALLAX_MAP_SOLID and EMT_TRANSPARENT_ALPHA_CHANNEL. */ f32 MaterialTypeParam; //! Second free parameter, dependent on the material type. /** Mostly ignored. */ f32 MaterialTypeParam2; //! Thickness of non-3dimensional elements such as lines and points. f32 Thickness; //! Is the ZBuffer enabled? Default: ECFN_LESSEQUAL /** Values are from E_COMPARISON_FUNC. */ u8 ZBuffer; //! Sets the antialiasing mode /** Values are chosen from E_ANTI_ALIASING_MODE. Default is EAAM_SIMPLE|EAAM_LINE_SMOOTH, i.e. simple multi-sample anti-aliasing and lime smoothing is enabled. */ u8 AntiAliasing; //! Defines the enabled color planes /** Values are defined as or'ed values of the E_COLOR_PLANE enum. Only enabled color planes will be rendered to the current render target. Typical use is to disable all colors when rendering only to depth or stencil buffer, or using Red and Green for Stereo rendering. */ u8 ColorMask:4; //! Defines the interpretation of vertex color in the lighting equation /** Values should be chosen from E_COLOR_MATERIAL. When lighting is enabled, vertex color can be used instead of the material values for light modulation. This allows to easily change e.g. the diffuse light behavior of each face. The default, ECM_DIFFUSE, will result in a very similar rendering as with lighting turned off, just with light shading. */ u8 ColorMaterial:3; //! Store the blend operation of choice /** Values to be chosen from E_BLEND_OPERATION. The actual way to use this value is not yet determined, so ignore it for now. */ E_BLEND_OPERATION BlendOperation:4; //! Factor specifying how far the polygon offset should be made /** Specifying 0 disables the polygon offset. The direction is specified spearately. The factor can be from 0 to 7.*/ u8 PolygonOffsetFactor:3; //! Flag defining the direction the polygon offset is applied to. /** Can be to front or to back, specififed by values from E_POLYGON_OFFSET. */ E_POLYGON_OFFSET PolygonOffsetDirection:1; //! Draw as wireframe or filled triangles? Default: false /** The user can access a material flag using \code material.Wireframe=true \endcode or \code material.setFlag(EMF_WIREFRAME, true); \endcode */ bool Wireframe:1; //! Draw as point cloud or filled triangles? Default: false bool PointCloud:1; //! Flat or Gouraud shading? Default: true bool GouraudShading:1; //! Will this material be lighted? Default: true bool Lighting:1; //! Is the zbuffer writeable or is it read-only. Default: true. /** This flag is forced to false if the MaterialType is a transparent type and the scene parameter ALLOW_ZWRITE_ON_TRANSPARENT is not set. */ bool ZWriteEnable:1; //! Is backface culling enabled? Default: true bool BackfaceCulling:1; //! Is frontface culling enabled? Default: false bool FrontfaceCulling:1; //! Is fog enabled? Default: false bool FogEnable:1; //! Should normals be normalized? /** Always use this if the mesh lit and scaled. Default: false */ bool NormalizeNormals:1; //! Shall mipmaps be used if available /** Sometimes, disabling mipmap usage can be useful. Default: true */ bool UseMipMaps:1; //! Gets the texture transformation matrix for level i /** \param i The desired level. Must not be larger than MATERIAL_MAX_TEXTURES. \return Texture matrix for texture level i. */ core::matrix4& getTextureMatrix(u32 i) { return TextureLayer[i].getTextureMatrix(); } //! Gets the immutable texture transformation matrix for level i /** \param i The desired level. \return Texture matrix for texture level i, or identity matrix for levels larger than MATERIAL_MAX_TEXTURES. */ const core::matrix4& getTextureMatrix(u32 i) const { if (i=MATERIAL_MAX_TEXTURES) return; TextureLayer[i].setTextureMatrix(mat); } //! Gets the i-th texture /** \param i The desired level. \return Texture for texture level i, if defined, else 0. */ ITexture* getTexture(u32 i) const { return i < MATERIAL_MAX_TEXTURES ? TextureLayer[i].Texture : 0; } //! Sets the i-th texture /** If i>=MATERIAL_MAX_TEXTURES this setting will be ignored. \param i The desired level. \param tex Texture for texture level i. */ void setTexture(u32 i, ITexture* tex) { if (i>=MATERIAL_MAX_TEXTURES) return; TextureLayer[i].Texture = tex; } //! Sets the Material flag to the given value /** \param flag The flag to be set. \param value The new value for the flag. */ void setFlag(E_MATERIAL_FLAG flag, bool value) { switch (flag) { case EMF_WIREFRAME: Wireframe = value; break; case EMF_POINTCLOUD: PointCloud = value; break; case EMF_GOURAUD_SHADING: GouraudShading = value; break; case EMF_LIGHTING: Lighting = value; break; case EMF_ZBUFFER: ZBuffer = value; break; case EMF_ZWRITE_ENABLE: ZWriteEnable = value; break; case EMF_BACK_FACE_CULLING: BackfaceCulling = value; break; case EMF_FRONT_FACE_CULLING: FrontfaceCulling = value; break; case EMF_BILINEAR_FILTER: { for (u32 i=0; i