Once the material has been setup with a specific effect the attributes should be initialized with the following functions:-
|
|
RpMatFXMaterialFlags, this type represents the different types of material effects that can be used on a material. The effects are initialized with RpMatFXMaterialSetEffects:
|
|
|
RpMatFXAtomicEnableEffects is used to enable the material effects object pipeline on an atomic. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXAtomicQueryEffects is used to query whether material effects have been enabled on the given atomic. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialDataSetFreeListCreateParams allows the developer to specify how many rpMatFXMaterialData s to preallocate space for. Call before RwEngineInit.
|
|
|
RpMatFXMaterialGetBumpMapBumpedTexture is used to retrieve the texture used for the bump mapping material effect. If a texture was set with RpMatFXMaterialSetBumpMapTexture then the resulting constructed texture is returned. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetBumpMapCoefficient is used to retrieve the bump mapping coefficient. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetBumpMapFrame is used to retrieve the frame used for the bump map material effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetBumpMapTexture is used to retrieve the texture set with RpMatFXMaterialSetBumpMapTexture. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||||||
|
RpMatFXMaterialGetDualBlendModes is used to retrieve the source and destination blend modes used in the dual pass material effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetDualTexture is used to retrieve the texture used in the dual pass material effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetEffects is used to get type of material effect of the material set with RpMatFXMaterialSetEffects. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetEnvMapCoefficient is used to retrieve the environment coefficient. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetEnvMapFrame is used to retrieve the RwFrame used for projecting the environment map. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetEnvMapFrameBufferAlpha is used to retreive the useFrameBufferAlpha flag. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXMaterialGetEnvMapTexture is used to retrieve the texture used for the environment map effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||||||
|
RpMatFXMaterialGetUVTransformMatrices is used to retrieve the base pass and dual pass texture coordinate transform matrices. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetBumpMapCoefficient controls the amount of the bump effect applied to the material (the bumpiness). Useful values typically lie in the range -10 to 10, depending on the scale of the bumps, and the depth of the effect required. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetBumpMapFrame sets the frame associated with the bump mapping material effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetBumpMapTexture sets the bump map required for the material effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||||||
|
RpMatFXMaterialSetDualBlendModes is used to set the source and destination blend modes used in the dual pass material effect. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetDualTexture sets the texture used in the second pass The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetEffects is used to enable a particular effect on a material. When an effect is selected, the material is cleaned of any old effect. The material effect should then be setup using: Which will setup the individual components of the effect type.The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetEnvMapCoefficient affects the reflectivity of the material, i.e. the intensity of the environment map (which is rendered additively on top of the material). The value should normally be in the range 0 to 1, but note that values outside this range may be used on PlayStation 2 (see the MatFX Platform Specific section for details). The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetEnvMapFrame sets the frame associated with the environment mapping material effect. This will affect the position of the environment map on the object. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetEnvMapFrameBufferAlpha determines whether the environment map will be multiplied by frame buffer alpha before being added to the rendered object. This allows for effects (for example bump mapping) to attenuate the environment map on a per-pixel basis, lending the rendered surface a detailed variation in appearance. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||
|
RpMatFXMaterialSetEnvMapTexture sets the texture for the environment mapping material effect. The texture is rendered with dynamically generated UVs using a spherical environment mapping. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
||||||||||||||||||||
|
RpMatFXMaterialSetupBumpMap is used to setup the various attributes needed for the bump map material effect.
|
|
||||||||||||||||||||
|
RpMatFXMaterialSetupDualTexture is used to setup the various attributes needed for the dual pass material effect.
|
|
||||||||||||||||||||||||
|
RpMatFXMaterialSetupEnvMap is used to setup the various attributes needed for the environment map material effect.
|
|
||||||||||||||||
|
RpMatFXMaterialSetUVTransformMatrices is used to set the base pass and dual pass texture coordinate transform matrices. If the base effect is set to rpMATFXEFFECTUVTRANSFORM then the dualTransform should be set to NULL. The transform matrices allow 2D rotation, scaling, and translation of the texture coordines. For this purpose, only a 6-component subset of the RwMatrix values are used when calculating the transformed texture coordinates, as follows:
(matrix) | rx ry - | (right)
| ux uy - | (up)
| - - - | (at)
| px py - | (pos)
The transformed UV texture coordinates will be: u' = rx * u + ux * v + px v' = ry * u + uy * v + py Such matrices may be constructed directly, or by using the RwMatrixRotate (about z-axis), RwMatrixTranslate, and RwMatrixScale functions. UV animation can be achieved by modifying the matrix values each frame. If either of the transform matrix pointers are set to NULL, then an identity transform will be assumed. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXPluginAttach is called by the application to indicate that the material effects plugin should be used. The call to this function should be placed between RwEngineInit and RwEngineOpen and the world plugin must already be attached.
|
|
|
RpMatFXWorldSectorEnableEffects is used to enable the material effects object pipeline on a world sector. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
|
|
RpMatFXWorldSectorQueryEffects is used to query whether material effects have been enabled in the given world sector. The world and material effect plugins must be attached before using this function. The header file rpmatfx.h is required.
|
© 1993-2003 Criterion Software Limited. All
rights reserved. Built Tue Apr 22 12:46:26 2003. Send Feedback
| Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |