class csPolygonSet : public csObject, public csPolygonParentInt

A PolygonSet class is a set of polygons (amazing, isn't it :-) A PolygonSet describes a set of polygons that form a convex and (probably) closed hull

Inheritance:

Public Fields

static long	current_light_frame_number Current light frame number
csVector2*	curve_texels Texture coords of curve vertices
csVector3*	curve_vertices Curve vertices
csVector3	curves_center Tesselation parameter: Center of thing to determine distance from
float	curves_scale scale param (the larger this param it, the more the curves are tesselated).
int	draw_busy How many times are we busy drawing this polyset (recursive)
int	max_curve_vertices Maximum number of vertices.
int	num_curve_vertices Number of vertices.

Public Methods

void	AddCurve (csCurve* curve) Add a curve to this polygonset
void	AddCurveVertex (csVector3& v, csVector2& t) Add a curve vertex
void	AddPolygon (csPolygonInt* spoly) Add a polygon to this polygonset
int	AddVertex (float x, float y, float z) Just add a new vertex to the polygonset
int	AddVertex (const csVector3& v) Just add a new vertex to the polygonset
int	AddVertexSmart (float x, float y, float z) Add a vertex but first check if there is already a vertex close to the wanted position
int	AddVertexSmart (const csVector3& v) Add a vertex but first check if there is already a vertex close to the wanted position
void	CamUpdate () Make sure the camera vertices are up-to-date to the current camera frame
void	CreateBoundingBox () Create an oriented bounding box (currently not oriented yet@@@) for this polygon set
	csPolygonSet () Construct a csPolygonSet
csVector2&	CurveTexel (int i) Get the specified curve texture coordinate (texel)
csVector3&	CurveVertex (int i) Get the specified curve vertex
csPolygonSetBBox*	GetBoundingBox () Get the oriented bounding box created by CreateBoundingBox()
void	GetCameraMinMaxZ (float& minz, float& mazx) Find the minimum and maximum Z values of all vertices in this polygon set (in camera space)
csCurve*	GetCurve (int idx) Get the specified curve from this set
csCurve*	GetCurve (char* name) Get the named curve from this set
csFog&	GetFog () Return fog structure
csPolygonSet*	GetNext () Get the next polygonset in its linked list
int	GetNumCurves () Get the number of curves in this polygonset
int	GetNumCurveVertices () Get the number of curve vertices
int	GetNumPolygons () Get the number of polygons in this polygonset
int	GetNumVertices () Return the number of vertices
csPolygon3D*	GetPolygon (char* name) Get the named polygon from this set
csPolygonInt*	GetPolygon (int idx) Get the specified polygon from this set
csSector*	GetSector () Return the sector that this polygonset belongs to
csFrustrumList*	GetShadows (csVector3& origin) Return a list of shadow frustrums which extend from this polygon set
bool	HasFog () Return true if this has fog
csVector2*	IntersectCameraZPlane (float z, csVector2* clipper, int num_clip, int& num_pts) Intersect this polygon set in camera space with a polygon which coincides with plane Zc = (a plane parallel to the view plane) and return a new polygon which is the intersection (as a 2D polygon with z not given)
virtual csPolygon3D*	IntersectSegment (const csVector3& start, const csVector3& end, csVector3& isect, float* pr = NULL) Intersect world-space segment with polygons of this set
bool	IsBSP () Return true if there is a BSP tree used in this sector
csPolygon3D*	NewPolygon (csTextureHandle* texture) Create a new polygon in this polygonset and add it
virtual void	Prepare () Prepare all polygons for use
void	SetNext (csPolygonSet* next) Set the next polygonset in its linked list
void	SetSector (csSector* sector) Set the sector that this polygonset belongs to
void	UpdateTransformation (const csVector3& trans) Translate with the given vector if needed
void	UpdateTransformation (const csCamera& c) Transform to the given camera if needed
void	UseBSP () Enable the optional BSP tree
csVector3&	Vcam (int idx) Return the camera space vector for the vertex
csVector3&	Vobj (int idx) Return the object space vector for the vertex
csVector3&	Vwor (int idx) Return the world space vector for the vertex
virtual	~csPolygonSet () Delete all contents of this polygonset (vertices, polygons, curves, and BSP tree)

Protected Fields

csPolygonSetBBox*	bbox Optional oriented bounding box.
csBspTree*	bsp Optional bsp tree.
csVector3*	cam_verts Vertices in camera space.
csTransformedSet	cam_verts_set Camera space vertices.
csCurve**	curves Table of ptr to curves forming the outside of the set
long	light_frame_number Light frame number
int	max_curves Maximum number of curves in 'curves' array.
int	max_polygon Maximum number of polygons in 'polygon' array.
csPolygonSet*	next PolygonSets are linked either in a csWorld object or in another PolygonSet (Thing in csSector for example)
int	num_curves Number of curves used.
int	num_polygon Number of polygons used.
csVector3*	obj_verts Vertices in object space.
csPolygonInt**	polygons Table of ptr to polygons forming the outside of the set
csSector*	sector csSector where this polyset belongs (pointer to 'this' if it is a sector).
csVector3*	wor_verts Vertices in world space.

Protected Methods

void	DrawOnePolygon (csPolygon3D* p, csPolygon2D* poly, csRenderView* d, bool use_z_buf) Draw one 3D/2D polygon combination
void	DrawPolygonArray (csPolygonInt** polygon, int num, csRenderView* rview, bool use_z_buf) Draw the given array of polygons in the current csPolygonSet
void*	TestQueuePolygonArray (csPolygonInt** polygon, int num, csRenderView* d, csPolygon2DQueue* poly_queue) Test a number of polygons against the c-buffer and insert them to the c-buffer if visible and also add them to a queue

Private Fields

csFog

fog Fog information

Inherited from csObject:

Public Methods

CS_ID GetID()

csObject* GetObj(const csIdType& objtype)

virtual csObject* GetObjectParent()

void ObjAdd(csObject* obj)

csObjIterator ObjGet(const csIdType& objtype)

void ObjRelease(csObject* obj)

void ObjRemove(csObject* obj)

Private Fields

CS_ID csid_value

csObjTree* objtree

Private Methods

virtual void SetObjectParent(csObject* parent)

Inherited from csPolygonParentInt:

csPolygonSet* next

PolygonSets are linked either in a csWorld object or in another PolygonSet (Thing in csSector for example)

csVector3* wor_verts

Vertices in world space.

csVector3* obj_verts

Vertices in object space.

csVector3* cam_verts

Vertices in camera space.

csTransformedSet cam_verts_set

Camera space vertices.

csPolygonInt** polygons

Table of ptr to polygons forming the outside of the set

int num_polygon

Number of polygons used.

int max_polygon

Maximum number of polygons in 'polygon' array.

csCurve** curves

Table of ptr to curves forming the outside of the set

int num_curves

Number of curves used.

int max_curves

Maximum number of curves in 'curves' array.

csSector* sector

csSector where this polyset belongs (pointer to 'this' if it is a sector).

csBspTree* bsp

Optional bsp tree.

csPolygonSetBBox* bbox

Optional oriented bounding box.

long light_frame_number

Light frame number. Using this number one can see if gouraud shaded vertices have been initialized already.

void DrawOnePolygon(csPolygon3D* p, csPolygon2D* poly, csRenderView* d, bool use_z_buf)

Draw one 3D/2D polygon combination. The 2D polygon is the transformed and clipped version of the 3D polygon.

void DrawPolygonArray(csPolygonInt** polygon, int num, csRenderView* rview, bool use_z_buf)

Draw the given array of polygons in the current csPolygonSet. This function is called by subclasses of csPolygonSet (csSector and csThing currently).

void* TestQueuePolygonArray(csPolygonInt** polygon, int num, csRenderView* d, csPolygon2DQueue* poly_queue)

Test a number of polygons against the c-buffer and insert them to the c-buffer if visible and also add them to a queue

csFog fog

Fog information

static long current_light_frame_number

Current light frame number. This is used for seeing if gouraud shading should be recalculated for this polygonset. If there is a mismatch between the frame number of this set and the global number then the gouraud shading is not up-to-date.

int draw_busy

How many times are we busy drawing this polyset (recursive). This is an important variable as it indicates to 'new_transformation' which set of camera vertices it should use.

csVector3 curves_center

Tesselation parameter: Center of thing to determine distance from

float curves_scale

scale param (the larger this param it, the more the curves are tesselated).

csVector3* curve_vertices

Curve vertices

csVector2* curve_texels

Texture coords of curve vertices

int num_curve_vertices

Number of vertices.

int max_curve_vertices

Maximum number of vertices.

csPolygonSet()

Construct a csPolygonSet

virtual ~csPolygonSet()

Delete all contents of this polygonset (vertices, polygons, curves, and BSP tree)

virtual void Prepare()

Prepare all polygons for use. This function MUST be called AFTER the texture manager has been prepared. This function is normally called by csWorld::Prepare() so you only need to worry about this function when you add sectors or things later.

int AddVertex(const csVector3& v)

Just add a new vertex to the polygonset

int AddVertex(float x, float y, float z)

Just add a new vertex to the polygonset

int AddVertexSmart(const csVector3& v)

Add a vertex but first check if there is already a vertex close to the wanted position. In that case don't add a new vertex but return the index of the old one.

int AddVertexSmart(float x, float y, float z)

Add a vertex but first check if there is already a vertex close to the wanted position. In that case don't add a new vertex but return the index of the old one.

csVector3& Vwor(int idx)

Return the world space vector for the vertex

csVector3& Vobj(int idx)

Return the object space vector for the vertex

csVector3& Vcam(int idx)

Return the camera space vector for the vertex. Make sure you recently called CamUpdate(). Otherwise it is possible that this coordinate will not be valid.

void CamUpdate()

Make sure the camera vertices are up-to-date to the current camera frame

int GetNumVertices()

Return the number of vertices

void AddPolygon(csPolygonInt* spoly)

Add a polygon to this polygonset

csPolygon3D* NewPolygon(csTextureHandle* texture)

Create a new polygon in this polygonset and add it

int GetNumPolygons()

Get the number of polygons in this polygonset

csPolygonInt* GetPolygon(int idx)

Get the specified polygon from this set

csPolygon3D* GetPolygon(char* name)

Get the named polygon from this set

void AddCurve(csCurve* curve)

Add a curve to this polygonset

int GetNumCurves()

Get the number of curves in this polygonset

csCurve* GetCurve(int idx)

Get the specified curve from this set

csCurve* GetCurve(char* name)

Get the named curve from this set

int GetNumCurveVertices()

Get the number of curve vertices

csVector3& CurveVertex(int i)

Get the specified curve vertex

csVector2& CurveTexel(int i)

Get the specified curve texture coordinate (texel)

void AddCurveVertex(csVector3& v, csVector2& t)

Add a curve vertex

void UseBSP()

Enable the optional BSP tree. This should be done AFTER all polygons and vertices have been added and all polygons are correctly initialized (textures and planes).

bool IsBSP()

Return true if there is a BSP tree used in this sector

virtual csPolygon3D* IntersectSegment(const csVector3& start, const csVector3& end, csVector3& isect, float* pr = NULL)

Intersect world-space segment with polygons of this set. Return polygon it intersects with (or NULL) and the intersection point in world coordinates.

If 'pr' != NULL it will also return a value between 0 and 1 indicating where on the 'start'-'end' vector the intersection happened.

void UpdateTransformation(const csCamera& c)

Transform to the given camera if needed. This function works via the transformation manager and will only transform if needed.

void UpdateTransformation(const csVector3& trans)

Translate with the given vector if needed. This function works via the transformation manager and will only translate if needed.

csPolygonSet* GetNext()

Get the next polygonset in its linked list

void SetNext(csPolygonSet* next)

Set the next polygonset in its linked list

void SetSector(csSector* sector)

Set the sector that this polygonset belongs to. This is either the polygonset itself if it is a sector or else the sector that this thing is in.

csSector* GetSector()

Return the sector that this polygonset belongs to

csFrustrumList* GetShadows(csVector3& origin)

Return a list of shadow frustrums which extend from this polygon set. The origin is the position of the light. Note that this function uses camera space coordinates and thus assumes that this polygon set is transformed to the origin of the light.

void CreateBoundingBox()

Create an oriented bounding box (currently not oriented yet@@@) for this polygon set. This function will add the vertices for the bounding box to the set itself so that they will get translated together with the other vertices. The indices of the vertices are added to the csPolygonSetBBox structure which is returned here. Note that this creation is done in object space. The newly added vertices will not have been translated to world/camera space yet.

csPolygonSetBBox* GetBoundingBox()

Get the oriented bounding box created by CreateBoundingBox()

bool HasFog()

Return true if this has fog

csFog& GetFog()

Return fog structure

void GetCameraMinMaxZ(float& minz, float& mazx)

Find the minimum and maximum Z values of all vertices in this polygon set (in camera space). This is used for planed fog.

csVector2* IntersectCameraZPlane(float z, csVector2* clipper, int num_clip, int& num_pts)

Intersect this polygon set in camera space with a polygon which coincides with plane Zc = (a plane parallel to the view plane) and return a new polygon which is the intersection (as a 2D polygon with z not given). This function assumes that the polygon set is convex (so it can in general not be used for polygon sets which use a BSP tree) and gives unexpected results otherwise. Delete the returned polygon with 'delete []' when ready.

Direct child classes:

csThing
csSector

alphabetic index hierarchy of classes

this page has been generated automatically by doc++

(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de