IHardwareRenderer Class Reference

#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.
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.
Public Member Functions inherited from IHardwareShader
virtual Interface_ID	GetID ()
virtual Interface_ID	GetVSID ()=0
virtual Interface_ID	GetPSID ()=0
virtual LifetimeType	LifetimeControl ()
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 Material *	GetMaterial (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.
UtilExport BaseInterface *	GetInterface (Interface_ID id) override
virtual UtilExport Interface_ID	GetID ()
virtual LifetimeType	LifetimeControl ()
virtual bool	RegisterNotifyCallback (InterfaceNotifyCallback *incb)
virtual void	UnRegisterNotifyCallback (InterfaceNotifyCallback *incb)
virtual BaseInterface *	AcquireInterface ()
virtual void	ReleaseInterface ()
virtual void	DeleteInterface ()
virtual BaseInterface *	CloneInterface (void *remapDir=nullptr)
Public Member Functions inherited from InterfaceServer
virtual UtilExport	~InterfaceServer ()
	Destructor.
virtual UtilExport BaseInterface *	GetInterface (Interface_ID id)
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 void *	operator new (size_t size)
	Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator new[] (size_t size)
	New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator new[] (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate arrays of objects.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
static UtilExport void *	operator 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
static UtilExport void *	operator new (size_t size, void *placement_ptr)
	Placement new operator.
static UtilExport void	operator delete (void *ptr, void *placement_ptr)
	Placement delete operator.
static UtilExport void *	aligned_malloc (size_t size, size_t alignment)
	Allocates memory on a specified alignment boundary.
static UtilExport void *	aligned_realloc (void *ptr, size_t size, size_t alignment)
	Reallocates memory on a specified alignment boundary.
static UtilExport void	aligned_free (void *ptr)
	Frees a block of memory that was allocated with aligned_malloc/aligned_realloc.

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();
IHardwareRenderer * phr = (IHardwareRenderer
 )gw->GetInterface(HARDWARE_RENDERER_INTERFACE_ID);

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.

{ return HARDWARE_RENDERER_INTERFACE_ID; }

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.

{ return noRelease; }

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]	pMesh	this is the handle of the DirectX mesh
[in]	vertexList	this is a pointer to an array containing the new vertex positions
[in]	gfxNormalList	this is a pointer to an array containing the new vertex normals. This is the gfxnormals, ie the flattened list of the render normals
[in]	faceNormalList	this 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]	changedVerts	this 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]	count	this is the number of vertices in the vertexList