3ds Max C++ API Reference
IHardwareRenderer Class Referenceabstract

#include <ihardwarerenderer.h>

+ Inheritance diagram for IHardwareRenderer:

Public Member Functions

virtual Interface_ID GetID ()
 
virtual LifetimeType LifetimeControl ()
 
virtual int GetMaxTexStages ()=0
 
virtual int GetNumActiveWindows ()=0
 
virtual bool UpdateScreen (GFX_ESCAPE_FN fn)=0
 
virtual bool CanDepthPeel ()=0
 
virtual void CreateLayer (int layerNum)=0
 
virtual void BlendLayers ()=0
 
virtual void StartNode ()=0
 
virtual void EndNode (GFX_ESCAPE_FN fn)=0
 
virtual void SetColor (ColorType t, D3DXCOLOR *pClr)=0
 
virtual void SetMaterial (HardwareMaterial *pMtl)=0
 
virtual D3DXCOLOR * GetDiffuseColor ()=0
 
virtual bool DisplayAllTriangleEdges ()=0
 
virtual void SetDisplayAllTriangleEdges (bool displayAllEdges)=0
 
virtual bool CanCacheMeshData ()=0
 
virtual void DrawMesh (DWORD type, DWORD nPrim, DWORD *pAttr, DWORD nComp, DWORD *pUse, DWORD **ppInd, DWORD fComp, DWORD *pLen, float **ppData, DWORD attr, GFX_ESCAPE_FN fn)=0
 
virtual DWORD_PTR BuildMesh (DWORD nFaces, DWORD *pAttr, DWORD nComp, DWORD *pUse, DWORD **ppInd, DWORD fComp, DWORD *pLen, float **ppData, GFX_ESCAPE_FN fn)=0
 
virtual DWORD_PTR BuildMesh (IHardwareMesh *pHWMesh, GFX_ESCAPE_FN fn)=0
 
virtual void DrawMesh (DWORD_PTR pMesh, DWORD attr, GFX_ESCAPE_FN fn)=0
 
virtual DWORD_PTR LoadMesh (LPCMSTR filename)=0
 
virtual void SaveMesh (LPCMSTR filename, DWORD_PTR pMesh)=0
 
virtual void FreeMesh (DWORD_PTR pMesh)=0
 
virtual DWORD_PTR BuildIndexedBuffer (DWORD type, DWORD nPrim, DWORD *pAttr, DWORD nComp, DWORD *pUse, DWORD **ppInd, DWORD fComp, DWORD *pLen, float **ppData, GFX_ESCAPE_FN fn)=0
 
virtual void DrawIndexedBuffer (DWORD_PTR pBuffer, DWORD attr, GFX_ESCAPE_FN fn)=0
 
virtual void FreeIndexedBuffer (DWORD_PTR pBuffer)=0
 
virtual DWORD_PTR BuildTexture (BITMAPINFO *bmi, UINT mipLevels, DWORD usage, DWORD format)=0
 
virtual DWORD_PTR LoadTexture (LPCMSTR filename)=0
 
virtual void SaveTexture (LPCMSTR filename, DWORD_PTR pTex)=0
 
virtual void FreeTexture (DWORD_PTR pTex)=0
 
virtual DWORD_PTR BuildCubeMap (UINT size, UINT mipLevels, DWORD usage, DWORD format, DWORD_PTR *pTex)=0
 
virtual void SetCubeMapFace (DWORD_PTR pCubeMap, DWORD face, UINT mipLevel, DWORD_PTR pTex)=0
 
virtual DWORD_PTR BuildVertexDecl (DWORD nComp, DWORD *pUse, DWORD fComp)=0
 
virtual void SetVertexDecl (DWORD_PTR pVertexDecl)=0
 
virtual void FreeVertexDecl (DWORD_PTR pVertexDecl)=0
 
virtual DWORD_PTR BuildVertexShader (LPCSTR code)=0
 
virtual DWORD_PTR LoadVertexShader (LPCMSTR filename)=0
 
virtual void SaveVertexShader (LPCMSTR filename, DWORD_PTR pVertexShader)=0
 
virtual void SetVertexShader (DWORD_PTR pVertexShader)=0
 
virtual void SetVertexShaderConstant (DWORD_PTR pVertexShader, DWORD nReg, DWORD type, void *pData, DWORD nData)=0
 
virtual void FreeVertexShader (DWORD_PTR pVertexShader)=0
 
virtual DWORD_PTR BuildPixelShader (LPCSTR code)=0
 
virtual DWORD_PTR LoadPixelShader (LPCMSTR filename)=0
 
virtual void SavePixelShader (LPCMSTR filename, DWORD_PTR pPixelShader)=0
 
virtual void SetPixelShader (DWORD_PTR pPixelShader)=0
 
virtual void SetPixelShaderConstant (DWORD_PTR pPixelShader, DWORD nReg, DWORD type, void *pData, DWORD nData)=0
 
virtual void FreePixelShader (DWORD_PTR pPixelShader)=0
 
virtual DWORD_PTR BuildEffect (LPCSTR code)=0
 
virtual DWORD_PTR LoadEffect (LPCMSTR filename)=0
 
virtual void SaveEffect (LPCMSTR filename, DWORD_PTR pEffect)=0
 
virtual void SetEffectParameter (DWORD_PTR pEffect, LPCMSTR name, DWORD type, void *pData)=0
 
virtual void SetEffectTechnique (DWORD_PTR pEffect, LPCMSTR name)=0
 
virtual void BeginEffect (DWORD_PTR pEffect)=0
 
virtual void SetEffectPass (DWORD_PTR pEffect, DWORD nPass)=0
 
virtual void EndEffect (DWORD_PTR pEffect)=0
 
virtual void FreeEffect (DWORD_PTR pEffect)=0
 
virtual DWORD_PTR BeginEffectAccess (DWORD_PTR pEffect, GFX_ESCAPE_FN fn)=0
 
virtual void EndEffectAccess (GFX_ESCAPE_FN fn)=0
 
virtual DWORD_PTR BeginDeviceAccess (GFX_ESCAPE_FN fn)=0
 
virtual void EndDeviceAccess (GFX_ESCAPE_FN fn)=0
 
virtual bool ObjectDrawnByShader ()=0
 This tells the mesh / mnmesh classes whether a shader has performed the drawing already so it can simply ignore the draw call. More...
 
virtual void DXCacheUpdateVertexBuffer (DWORD_PTR pMesh, Point3 *vertexList, Point3 *gfxNormalList, Point3 *faceNormalList, BitArray &changedVerts, int count)=0
 This method lets you update the vertex positions of the DirectX mesh cache. More...
 
- Public Member Functions inherited from IHardwareShader
virtual Interface_ID GetVSID ()=0
 
virtual Interface_ID GetPSID ()=0
 
virtual void StartObject (Mesh *mesh)=0
 
virtual void StartObject (MNMesh *mnmesh)=0
 
virtual void InitializeShaders (Mesh *mesh, BaseInterface *pbvs, Material *mtlArray, int numMtl, GFX_ESCAPE_FN fn)=0
 
virtual void InitializeShaders (MNMesh *mnmesh, BaseInterface *pbvs, Material *mtlArray, int numMtl, GFX_ESCAPE_FN fn)=0
 
virtual bool CanTryStrips ()=0
 
virtual DWORD GetRndMode ()=0
 
virtual MaterialGetMaterial (int numMat)=0
 
virtual void SetMaterial (const Material &m, int index=0)=0
 
virtual int GetNumMultiPass (int numMtl)=0
 
virtual void SetNumMultiPass (int numPass)=0
 
virtual void DrawMeshStrips (MeshData *data, GFX_ESCAPE_FN fn)=0
 
virtual void DrawWireMesh (WireMeshData *data, GFX_ESCAPE_FN fn)=0
 
virtual void StartLines (WireMeshData *data)=0
 
virtual void AddLine (DWORD *vert, int vis)=0
 
virtual void DrawLines ()=0
 
virtual void EndLines (GFX_ESCAPE_FN fn)=0
 
virtual void StartTriangles (MeshFaceData *data)=0
 
virtual void AddTriangle (DWORD index, int *edgeVis)=0
 
virtual void DrawTriangles ()=0
 
virtual void EndTriangles (GFX_ESCAPE_FN fn)=0
 
virtual void EndObject (Mesh *mesh)=0
 
virtual void EndObject (MNMesh *mnmesh)=0
 
- Public Member Functions inherited from BaseInterface
virtual UtilExport ~BaseInterface ()
 Destructor. More...
 
UtilExport BaseInterfaceGetInterface (Interface_ID id)
 
virtual bool RegisterNotifyCallback (InterfaceNotifyCallback *incb)
 
virtual void UnRegisterNotifyCallback (InterfaceNotifyCallback *incb)
 
virtual BaseInterfaceAcquireInterface ()
 
virtual void ReleaseInterface ()
 
virtual void DeleteInterface ()
 
virtual BaseInterfaceCloneInterface (void *remapDir=NULL)
 
- Public Member Functions inherited from InterfaceServer
virtual UtilExport ~InterfaceServer ()
 Destructor. More...
 
template<class InterfaceType >
InterfaceType * GetTypedInterface ()
 

Additional Inherited Members

- Public Types inherited from BaseInterface
enum  LifetimeType { noRelease , immediateRelease , wantsRelease , serverControlled }
 
- Static Public Member Functions inherited from MaxHeapOperators
static UtilExport voidoperator new (size_t size)
 Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e)
 Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new (size_t size, const char *filename, int line)
 New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e, const char *filename, int line)
 New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new (size_t size, unsigned long flags)
 New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e, unsigned long flags)
 New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size, const char *filename, int line)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate arrays of objects. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size, unsigned long flags)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e, unsigned long flags)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport void operator delete (void *ptr)
 Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e)
 Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete (void *ptr, const char *filename, int line)
 Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, int block_type, const char *filename, int line)
 Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line)
 Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete (void *ptr, unsigned long flags)
 Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags)
 Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr)
 Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e)
 Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, int block_type, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr, unsigned long flags)
 Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags)
 Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, void *placement_ptr)
 Placement new operator. More...
 
static UtilExport void operator delete (void *ptr, void *placement_ptr)
 Placement delete operator. More...
 
static UtilExport voidaligned_malloc (size_t size, size_t alignment)
 Allocates memory on a specified alignment boundary. More...
 
static UtilExport voidaligned_realloc (void *ptr, size_t size, size_t alignment)
 Reallocates memory on a specified alignment boundary. More...
 
static UtilExport void aligned_free (void *ptr)
 Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. More...
 

Detailed Description

Description:
This class is only available in release 5 or later.

This interface provides access to the DirectX interfaces on the drawing thread of Max. This allows creation and loading of various DirectX objects such as Textures. This class has many interfaces not currently implemented, although they will compile and link correctly. This is due to support for DirectX 9, meaning that when a compatible driver is released these methods will be implemented. The documentation for this class only deals with methods that developers can and would normally use.

The basic idea of this class is to provide the developer with access to the DirectX device without actually giving the developer total control, and thus possibility to de-stable the 3ds Max Viewports.

A pointer to this class can be obtained with the following code snippet:
ViewExp *pview = GetCOREInterface()->GetActiveViewport();
GraphicsWindow *gw = pview->getGW();
Definition: GraphicsWindow.h:73
Definition: ihardwarerenderer.h:55
virtual UtilExport BaseInterface * GetInterface(Interface_ID id)
Definition: maxapi.h:768
virtual GraphicsWindow * getGW()=0
CoreExport Interface * GetCOREInterface()
#define HARDWARE_RENDERER_INTERFACE_ID
Definition: ihardwarerenderer.h:25
For an example usage of this class see MAXSDK/SAMPLES/HardwareShaders/LightMap/Lightmap.cpp

Member Function Documentation

◆ GetID()

virtual Interface_ID GetID ( )
inlinevirtual
Remarks
This method returns the unique interface ID.

Reimplemented from IHardwareShader.

Reimplemented in IHardwareRendererST.

◆ LifetimeControl()

virtual LifetimeType LifetimeControl ( )
inlinevirtual
Remarks
This method allows inquiries into the actual lifetime policy of a client and provide a server-controlled delete notify callback.
Returns
One of the following LifetimeTypes:

noRelease

Do not call release, use interface as long as you like. This is the default.

immediateRelease

The interface is only good for one call. The release is implied so a call to release is not required.

wantsRelease

The clients are controlling the lifetime, so the interface needs a Release() when the client has finished.

serverControlled

The server controls the lifetime and will use the InterfaceNotifyCallback to inform the code when it is gone.
Default Implementation:
{ return noRelease; }

Reimplemented from IHardwareShader.

60 { return noRelease; }
@ noRelease
Definition: baseinterface.h:104

◆ GetMaxTexStages()

virtual int GetMaxTexStages ( )
pure virtual

◆ GetNumActiveWindows()

virtual int GetNumActiveWindows ( )
pure virtual

◆ UpdateScreen()

virtual bool UpdateScreen ( GFX_ESCAPE_FN  fn)
pure virtual

◆ CanDepthPeel()

virtual bool CanDepthPeel ( )
pure virtual

◆ CreateLayer()

virtual void CreateLayer ( int  layerNum)
pure virtual

◆ BlendLayers()

virtual void BlendLayers ( )
pure virtual

◆ StartNode()

virtual void StartNode ( )
pure virtual

◆ EndNode()

virtual void EndNode ( GFX_ESCAPE_FN  fn)
pure virtual

◆ SetColor()

virtual void SetColor ( ColorType  t,
D3DXCOLOR *  pClr 
)
pure virtual

◆ SetMaterial()

virtual void SetMaterial ( HardwareMaterial *  pMtl)
pure virtual

◆ GetDiffuseColor()

virtual D3DXCOLOR* GetDiffuseColor ( )
pure virtual

◆ DisplayAllTriangleEdges()

virtual bool DisplayAllTriangleEdges ( )
pure virtual

◆ SetDisplayAllTriangleEdges()

virtual void SetDisplayAllTriangleEdges ( bool  displayAllEdges)
pure virtual

◆ CanCacheMeshData()

virtual bool CanCacheMeshData ( )
pure virtual

◆ DrawMesh() [1/2]

virtual void DrawMesh ( DWORD  type,
DWORD  nPrim,
DWORD *  pAttr,
DWORD  nComp,
DWORD *  pUse,
DWORD **  ppInd,
DWORD  fComp,
DWORD *  pLen,
float **  ppData,
DWORD  attr,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ BuildMesh() [1/2]

virtual DWORD_PTR BuildMesh ( DWORD  nFaces,
DWORD *  pAttr,
DWORD  nComp,
DWORD *  pUse,
DWORD **  ppInd,
DWORD  fComp,
DWORD *  pLen,
float **  ppData,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ BuildMesh() [2/2]

virtual DWORD_PTR BuildMesh ( IHardwareMesh pHWMesh,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ DrawMesh() [2/2]

virtual void DrawMesh ( DWORD_PTR  pMesh,
DWORD  attr,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ LoadMesh()

virtual DWORD_PTR LoadMesh ( LPCMSTR  filename)
pure virtual

◆ SaveMesh()

virtual void SaveMesh ( LPCMSTR  filename,
DWORD_PTR  pMesh 
)
pure virtual

◆ FreeMesh()

virtual void FreeMesh ( DWORD_PTR  pMesh)
pure virtual

◆ BuildIndexedBuffer()

virtual DWORD_PTR BuildIndexedBuffer ( DWORD  type,
DWORD  nPrim,
DWORD *  pAttr,
DWORD  nComp,
DWORD *  pUse,
DWORD **  ppInd,
DWORD  fComp,
DWORD *  pLen,
float **  ppData,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ DrawIndexedBuffer()

virtual void DrawIndexedBuffer ( DWORD_PTR  pBuffer,
DWORD  attr,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ FreeIndexedBuffer()

virtual void FreeIndexedBuffer ( DWORD_PTR  pBuffer)
pure virtual

◆ BuildTexture()

virtual DWORD_PTR BuildTexture ( BITMAPINFO *  bmi,
UINT  mipLevels,
DWORD  usage,
DWORD  format 
)
pure virtual
Remarks
This will create a DX texture stored in local storage. The pointer returned can be used in IHardwareMaterial::SetTexture method. An example of using this method can be seen in the Lightmap sample.

Parameters:
BITMAPINFO *bmi

A pointer to the bitmap from which the texture will be created

UINT miplevels

The number of miplevels to create

DWORD usage

The usage falg is the same as for D3DXCreateTexture - see the DirectX documentation for more information

DWORD format

The pixel format for the texture

◆ LoadTexture()

virtual DWORD_PTR LoadTexture ( LPCMSTR  filename)
pure virtual
Remarks
This simple loads a texture from the supplied filename using the default options for D3DXCreateTextureFromFile. Please refer to the DirectX documentation for further information.

◆ SaveTexture()

virtual void SaveTexture ( LPCMSTR  filename,
DWORD_PTR  pTex 
)
pure virtual

◆ FreeTexture()

virtual void FreeTexture ( DWORD_PTR  pTex)
pure virtual

◆ BuildCubeMap()

virtual DWORD_PTR BuildCubeMap ( UINT  size,
UINT  mipLevels,
DWORD  usage,
DWORD  format,
DWORD_PTR *  pTex 
)
pure virtual

◆ SetCubeMapFace()

virtual void SetCubeMapFace ( DWORD_PTR  pCubeMap,
DWORD  face,
UINT  mipLevel,
DWORD_PTR  pTex 
)
pure virtual

◆ BuildVertexDecl()

virtual DWORD_PTR BuildVertexDecl ( DWORD  nComp,
DWORD *  pUse,
DWORD  fComp 
)
pure virtual

◆ SetVertexDecl()

virtual void SetVertexDecl ( DWORD_PTR  pVertexDecl)
pure virtual

◆ FreeVertexDecl()

virtual void FreeVertexDecl ( DWORD_PTR  pVertexDecl)
pure virtual

◆ BuildVertexShader()

virtual DWORD_PTR BuildVertexShader ( LPCSTR  code)
pure virtual

◆ LoadVertexShader()

virtual DWORD_PTR LoadVertexShader ( LPCMSTR  filename)
pure virtual

◆ SaveVertexShader()

virtual void SaveVertexShader ( LPCMSTR  filename,
DWORD_PTR  pVertexShader 
)
pure virtual

◆ SetVertexShader()

virtual void SetVertexShader ( DWORD_PTR  pVertexShader)
pure virtual

◆ SetVertexShaderConstant()

virtual void SetVertexShaderConstant ( DWORD_PTR  pVertexShader,
DWORD  nReg,
DWORD  type,
void pData,
DWORD  nData 
)
pure virtual

◆ FreeVertexShader()

virtual void FreeVertexShader ( DWORD_PTR  pVertexShader)
pure virtual

◆ BuildPixelShader()

virtual DWORD_PTR BuildPixelShader ( LPCSTR  code)
pure virtual

◆ LoadPixelShader()

virtual DWORD_PTR LoadPixelShader ( LPCMSTR  filename)
pure virtual

◆ SavePixelShader()

virtual void SavePixelShader ( LPCMSTR  filename,
DWORD_PTR  pPixelShader 
)
pure virtual

◆ SetPixelShader()

virtual void SetPixelShader ( DWORD_PTR  pPixelShader)
pure virtual

◆ SetPixelShaderConstant()

virtual void SetPixelShaderConstant ( DWORD_PTR  pPixelShader,
DWORD  nReg,
DWORD  type,
void pData,
DWORD  nData 
)
pure virtual

◆ FreePixelShader()

virtual void FreePixelShader ( DWORD_PTR  pPixelShader)
pure virtual

◆ BuildEffect()

virtual DWORD_PTR BuildEffect ( LPCSTR  code)
pure virtual

◆ LoadEffect()

virtual DWORD_PTR LoadEffect ( LPCMSTR  filename)
pure virtual

◆ SaveEffect()

virtual void SaveEffect ( LPCMSTR  filename,
DWORD_PTR  pEffect 
)
pure virtual

◆ SetEffectParameter()

virtual void SetEffectParameter ( DWORD_PTR  pEffect,
LPCMSTR  name,
DWORD  type,
void pData 
)
pure virtual

◆ SetEffectTechnique()

virtual void SetEffectTechnique ( DWORD_PTR  pEffect,
LPCMSTR  name 
)
pure virtual

◆ BeginEffect()

virtual void BeginEffect ( DWORD_PTR  pEffect)
pure virtual

◆ SetEffectPass()

virtual void SetEffectPass ( DWORD_PTR  pEffect,
DWORD  nPass 
)
pure virtual

◆ EndEffect()

virtual void EndEffect ( DWORD_PTR  pEffect)
pure virtual

◆ FreeEffect()

virtual void FreeEffect ( DWORD_PTR  pEffect)
pure virtual

◆ BeginEffectAccess()

virtual DWORD_PTR BeginEffectAccess ( DWORD_PTR  pEffect,
GFX_ESCAPE_FN  fn 
)
pure virtual

◆ EndEffectAccess()

virtual void EndEffectAccess ( GFX_ESCAPE_FN  fn)
pure virtual

◆ BeginDeviceAccess()

virtual DWORD_PTR BeginDeviceAccess ( GFX_ESCAPE_FN  fn)
pure virtual

◆ EndDeviceAccess()

virtual void EndDeviceAccess ( GFX_ESCAPE_FN  fn)
pure virtual

◆ ObjectDrawnByShader()

virtual bool ObjectDrawnByShader ( )
pure virtual

This tells the mesh / mnmesh classes whether a shader has performed the drawing already so it can simply ignore the draw call.

When a shader draws an object, in certain situations 3ds Max will also try to draw the object. This can produce a "double draw" situation. This method used to query if the object has been drawn by the shader already. If it has you can simply ignore your drawing code. However if you draw any support objects or subobject data, these can still be drawn, you simply want to avoid drawing the actual triangles of the object.

Returns
true if the object has already been drawn, false if not.

◆ DXCacheUpdateVertexBuffer()

virtual void DXCacheUpdateVertexBuffer ( DWORD_PTR  pMesh,
Point3 vertexList,
Point3 gfxNormalList,
Point3 faceNormalList,
BitArray changedVerts,
int  count 
)
pure virtual

This method lets you update the vertex positions of the DirectX mesh cache.

This allow you to keep the DirectX mesh cache around without having to delete it on geometric changes.

Parameters
[in]pMeshthis is the handle of the DirectX mesh
[in]vertexListthis is a pointer to an array containing the new vertex positions
[in]gfxNormalListthis is a pointer to an array containing the new vertex normals. This is the gfxnormals, ie the flattened list of the render normals
[in]faceNormalListthis is a pointer to an array containing the new face normals. This is to handle face with no smoothing group which default to the face normal instead of the render normals
[in]changedVertsthis is a bitarray that marks all the vertices that have changed. This lets us know which sectors of the mesh we don;t have to change thus making the operation faster
[in]countthis is the number of vertices in the vertexList