Detailed Description

This class is available in release 2.0 and later only.

This class provides information about a single node being rendered. This includes information such as the mesh of the object, its material, unique node ID, object space bounding extents, number of lights affecting it, material requirements, and normals and vertex coordinates in various spaces (object and camera).

Data Members:: ULONG flags;

The flags that describe the properties of this instance. See Render Instance Flags .

Mtl *mtl;

This is the material from the node.

float wireSize;

The wireframe size.

Mesh *mesh;

The mesh to be rendered. This is the result of GeomObject::GetRenderMesh().

float vis;

Object visibility (between 0.0 and 1.0). This is the value the visibility track evaluates to at a particular time.

int nodeID;

A unique ID associated with the node. It's unique within the scene during a render.

int objMotBlurFrame;

This will be equal to NO_MOTBLUR for all non-blurred objects. For blurred objects, it takes on the values (0..nBlurFrames-1) for the successive blur-instances.

int objBlurID;

The purpose of this is to differentiate blur-instances generated from different nodes. All the blur-instances for an object-motion-blurred object will have the same objBlurID. This is as distinct from nodeID, which is different for every instance. This makes it possible to easily avoid intersecting a ray with all blur-instances for an object. If RenderGlobalContext::IntersectWorld() is being used, then passing in the objBlurID for the parameter skipID will have this effect.

The basic technique is this: When reflecting or refracting rays, and object motion blur is enabled, choose sub-frame times randomly for the different rays (effectively giving a coarse stochastic sampling of time).

Matrix3 objToWorld;

This matrix can be used to transform object coordinates to world coordinates.

Matrix3 objToCam;

This matrix can be used to transform object coordinates to camera coordinates.

Matrix3 normalObjToCam;

This matrix can be used for transforming surface normals from object space to camera space.

Matrix3 camToObj;

This matrix can be used to transform camera coordinates to object coordinates.

Box3 obBox;

The object space extents of the object being rendered.

Point3 center;

The object bounding sphere center (in camera coordinates)

float radsq;

The square of the bounding sphere's radius.

See also:: Class Mtl, Class LightDesc, Class INode, Class Object, Class Mesh, Class Matrix3, Class Box3, Class Point3, Class Interval.

#include <render.h>

Inheritance diagram for RenderInstance:

[legend]

List of all members.

Public Member Functions
virtual	~RenderInstance ()
	Destructor.
void	SetFlag (ULONG f, BOOL b)
	Sets the specified flag(s) to the state passed.
void	SetFlag (ULONG f)
	Sets the specified flag(s) to on.
void	ClearFlag (ULONG f)
	Clears the specified flag(s).
BOOL	TestFlag (ULONG f)
	Returns TRUE if the specified flag(s) are set; otherwise FALSE.
BOOL	Hidden ()
BOOL	IsClip ()
virtual RenderInstance *	Next ()=0
	Returns a pointer to the next in RenderInstance in the list.
virtual Interval	MeshValidity ()=0
	Returns the validity interval of the mesh of this render instance.
virtual int	NumLights ()=0
	Returns the number of lights affecting the node.
virtual LightDesc *	Light (int n)=0
	Returns a pointer to the LightDesc for the 'i-th' light affecting the node.
virtual BOOL	CastsShadowsFrom (const ObjLightDesc &lt)=0
virtual INode *	GetINode ()=0
	Returns the INode pointer for the instance.
virtual Object *	GetEvalObject ()=0
	Returns a pointer to the evaluated object for the instance.
virtual ULONG	MtlRequirements (int mtlNum, int faceNum)=0
	Returns the material requirements of the material assigned to the node.
virtual Point3	GetFaceNormal (int faceNum)=0
	Returns the geometric normal of the specified face in object space.
virtual Point3	GetFaceVertNormal (int faceNum, int vertNum)=0
	Returns the vertex normal of the specified face in camera coordinates.
virtual void	GetFaceVertNormals (int faceNum, Point3 n[3])=0
	Returns the three vertex normals of the specified face in camera coordinates.
virtual Point3	GetCamVert (int vertnum)=0
	Returns the coordinate for the specified vertex in camera coordinates.
virtual void	GetObjVerts (int fnum, Point3 obp[3])=0
	Returns the vertices of the specified face in object coordinates.
virtual void	GetCamVerts (int fnum, Point3 cp[3])=0
	Returns the vertices of the specified face in camera (view) coordinates.
virtual INT_PTR	Execute (int cmd, ULONG_PTR arg1=0, ULONG_PTR arg2=0, ULONG_PTR arg3=0)
virtual Mtl *	GetMtl (int faceNum)=0
Public Attributes
ULONG	flags
Mtl *	mtl
float	wireSize
Mesh *	mesh
float	vis
int	nodeID
int	objMotBlurFrame
int	objBlurID
Matrix3	objToWorld
Matrix3	objToCam
Matrix3	normalObjToCam
Matrix3	camToObj
Box3	obBox
Point3	center
float	radsq

Constructor & Destructor Documentation

virtual ~RenderInstance ( ) [inline, virtual]

Destructor.

{}

Member Function Documentation

void SetFlag	(	ULONG	f,
		BOOL	b
	)		`[inline]`

virtual ULONG MtlRequirements	(	int	mtlNum,
		int	faceNum
	)		`[pure virtual]`

virtual Point3 GetFaceVertNormal	(	int	faceNum,
		int	vertNum
	)		`[pure virtual]`

virtual void GetFaceVertNormals	(	int	faceNum,
		Point3	n[3]
	)		`[pure virtual]`

virtual void GetObjVerts	(	int	fnum,
		Point3	obp[3]
	)		`[pure virtual]`

virtual void GetCamVerts	(	int	fnum,
		Point3	cp[3]
	)		`[pure virtual]`

virtual INT_PTR Execute	(	int	cmd,
		ULONG_PTR	arg1 = `0`,
		ULONG_PTR	arg2 = `0`,
		ULONG_PTR	arg3 = `0`
	)		`[inline, virtual]`

RenderInstance Class Reference

Detailed Description

Public Member Functions

Public Attributes

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation