PxHeightField Class Reference
[Geomutils]

A height field class. More...

#include <PxHeightField.h>

Inheritance diagram for PxHeightField:

[legend]

Collaboration diagram for PxHeightField:

[legend]

List of all members.


Public Member Functions
virtual PX_PHYSX_COMMON_API void	release ()=0
	Releases the height field.
virtual PX_PHYSX_COMMON_API PxU32	saveCells (void *destBuffer, PxU32 destBufferSize) const =0
	Writes out the sample data array.
virtual PX_PHYSX_COMMON_API bool	modifySamples (PxI32 startCol, PxI32 startRow, const PxHeightFieldDesc &subfieldDesc)=0
	Replaces a rectangular subfield in the sample data array.
virtual PX_PHYSX_COMMON_API PxU32	getNbRows () const =0
	Retrieves the number of sample rows in the samples array.
virtual PX_PHYSX_COMMON_API PxU32	getNbColumns () const =0
	Retrieves the number of sample columns in the samples array.
virtual PX_PHYSX_COMMON_API PxHeightFieldFormat::Enum	getFormat () const =0
	Retrieves the format of the sample data.
virtual PX_PHYSX_COMMON_API PxU32	getSampleStride () const =0
	Retrieves the offset in bytes between consecutive samples in the array.
virtual PX_PHYSX_COMMON_API PxReal	getThickness () const =0
	Retrieves the thickness of the height volume in the vertical direction.
virtual PX_PHYSX_COMMON_API PxReal	getConvexEdgeThreshold () const =0
	Retrieves the convex edge threshold.
virtual PX_PHYSX_COMMON_API PxHeightFieldFlags	getFlags () const =0
	Retrieves the flags bits, combined from values of the enum PxHeightFieldFlag.
virtual PX_PHYSX_COMMON_API PxReal	getHeight (PxReal x, PxReal z) const =0
	Retrieves the height at the given coordinates in grid space.
virtual PX_PHYSX_COMMON_API PxU32	getReferenceCount () const =0
	Returns the reference count for shared heightfields.
virtual PX_PHYSX_COMMON_API PxMaterialTableIndex	getTriangleMaterialIndex (PxTriangleID triangleIndex) const =0
	Returns material table index of given triangle.
virtual PX_PHYSX_COMMON_API PxVec3	getTriangleNormal (PxTriangleID triangleIndex) const =0
	Returns a triangle face normal for a given triangle index.
virtual PX_INLINE const char *	getConcreteTypeName () const
	returns string name of dynamic type.
Protected Member Functions
	PxHeightField ()
	PxHeightField (PxRefResolver &v)
virtual	~PxHeightField ()
virtual bool	isKindOf (const char *name) const

Detailed Description

A height field class.

Height fields work in a similar way as triangle meshes specified to act as height fields, with some important differences:

Triangle meshes can be made of nonuniform geometry, while height fields are regular, rectangular grids. This means that with PxHeightField, you sacrifice flexibility in return for improved performance and decreased memory consumption.

Like Convexes and TriangleMeshes, HeightFields are referenced by shape instances (see PxHeightFieldGeometry, PxShape).

To avoid duplicating data when you have several instances of a particular height field differently, you do not use this class to represent a height field object directly. Instead, you create an instance of this height field via the PxHeightFieldGeometry and PxShape classes.

Creation

To create an instance of this class call PxPhysics::createHeightField(), and release() to delete it. This is only possible once you have released all of its PxHeightFiedShape instances.

Visualizations:

See also:: PxHeightFieldDesc PxHeightFieldGeometry PxShape PxPhysics.createHeightField()

Constructor & Destructor Documentation

PxHeightField::PxHeightField ( ) [inline, protected]

PxHeightField::PxHeightField ( PxRefResolver & v ) [inline, protected]

virtual PxHeightField::~PxHeightField ( ) [inline, protected, virtual]

Member Function Documentation

virtual PX_INLINE const char* PxHeightField::getConcreteTypeName ( ) const [inline, virtual]

returns string name of dynamic type.

Returns:: class name of most derived type of this object.

Reimplemented from PxSerializable.

virtual PX_PHYSX_COMMON_API PxReal PxHeightField::getConvexEdgeThreshold ( ) const [pure virtual]

Retrieves the convex edge threshold.

Returns:: The convex edge threshold.

See also:: PxHeightFieldDesc.convexEdgeThreshold

virtual PX_PHYSX_COMMON_API PxHeightFieldFlags PxHeightField::getFlags ( ) const [pure virtual]

Retrieves the flags bits, combined from values of the enum PxHeightFieldFlag.

Returns:: The flags bits, combined from values of the enum PxHeightFieldFlag.

See also:: PxHeightFieldDesc.flags PxHeightFieldFlag

virtual PX_PHYSX_COMMON_API PxHeightFieldFormat::Enum PxHeightField::getFormat ( ) const [pure virtual]

Retrieves the format of the sample data.

Returns:: The format of the sample data.

See also:: PxHeightFieldDesc.format PxHeightFieldFormat

virtual PX_PHYSX_COMMON_API PxReal PxHeightField::getHeight	(	PxReal	x,
		PxReal	z
	)			const `[pure virtual]`

Retrieves the height at the given coordinates in grid space.

Returns:: The height at the given coordinates or 0 if the coordinates are out of range.

virtual PX_PHYSX_COMMON_API PxU32 PxHeightField::getNbColumns ( ) const [pure virtual]

Retrieves the number of sample columns in the samples array.

Returns:: The number of sample columns in the samples array.

See also:: PxHeightFieldDesc.nbColumns

virtual PX_PHYSX_COMMON_API PxU32 PxHeightField::getNbRows ( ) const [pure virtual]

Retrieves the number of sample rows in the samples array.

Returns:: The number of sample rows in the samples array.

See also:: PxHeightFieldDesc.nbRows

virtual PX_PHYSX_COMMON_API PxU32 PxHeightField::getReferenceCount ( ) const [pure virtual]

Returns the reference count for shared heightfields.

At creation, the reference count of the heightfield is 1. Every shape referencing this heightfield increments the count by 1. When the reference count reaches 0, and only then, the heightfield gets destroyed automatically.

Returns:: the current reference count.

virtual PX_PHYSX_COMMON_API PxU32 PxHeightField::getSampleStride ( ) const [pure virtual]

Retrieves the offset in bytes between consecutive samples in the array.

Returns:: The offset in bytes between consecutive samples in the array.

See also:: PxHeightFieldDesc.sampleStride

virtual PX_PHYSX_COMMON_API PxReal PxHeightField::getThickness ( ) const [pure virtual]

Retrieves the thickness of the height volume in the vertical direction.

Returns:: The thickness of the height volume in the vertical direction.

See also:: PxHeightFieldDesc.thickness

virtual PX_PHYSX_COMMON_API PxMaterialTableIndex PxHeightField::getTriangleMaterialIndex ( PxTriangleID triangleIndex ) const [pure virtual]

Returns material table index of given triangle.

Note:: This function takes a post cooking triangle index.

Parameters:

[in] triangleIndex (internal) index of desired triangle

Returns:: Material table index, or 0xffff if no per-triangle materials are used

virtual PX_PHYSX_COMMON_API PxVec3 PxHeightField::getTriangleNormal ( PxTriangleID triangleIndex ) const [pure virtual]

Returns a triangle face normal for a given triangle index.

Note:: This function takes a post cooking triangle index.

Parameters:

[in] triangleIndex (internal) index of desired triangle

Returns:: Triangle normal for a given triangle index

virtual bool PxHeightField::isKindOf ( const char * name ) const [inline, protected, virtual]

Reimplemented from PxSerializable.

References PxSerializable::isKindOf().

virtual PX_PHYSX_COMMON_API bool PxHeightField::modifySamples	(	PxI32	startCol,
		PxI32	startRow,
		const PxHeightFieldDesc &	subfieldDesc
	)			`[pure virtual]`

Replaces a rectangular subfield in the sample data array.

The user provides the description of a rectangular subfield in subfieldDesc. The data is formatted and arranged as PxHeightFieldDesc.samples.

Parameters:

`[in]`	startCol	First cell in the destination heightfield to be modified. Can be negative.
`[in]`	startRow	First row in the destination heightfield to be modified. Can be negative.
`[in]`	subfieldDesc	Description of the source subfield to read the samples from.

Returns:: True on success, false on failure. Failure can be due to format mismatch.

Note:: Modified samples are constrained to the same height quantization range as the original heightfield. Source samples that are out of range of target heightfield will be clipped with no error.

See also:: PxHeightFieldDesc.samples

virtual PX_PHYSX_COMMON_API void PxHeightField::release ( ) [pure virtual]

Releases the height field.

Note:: This will decrease the reference count by one.

Releases the application's reference to the height field. The height field is destroyed when the application's reference is released and all shapes referencing the height field are destroyed.

See also:: PxPhysics.createHeightField() PxHeightFieldDesc PxHeightFieldGeometry PxShape

virtual PX_PHYSX_COMMON_API PxU32 PxHeightField::saveCells	(	void *	destBuffer,
		PxU32	destBufferSize
	)			const `[pure virtual]`

Writes out the sample data array.

The user provides destBufferSize bytes storage at destBuffer. The data is formatted and arranged as PxHeightFieldDesc.samples.

Parameters:

`[out]`	destBuffer	The destination buffer for the sample data.
`[in]`	destBufferSize	The size of the destination buffer.

Returns:: The number of bytes written.

See also:: PxHeightFieldDesc.samples

The documentation for this class was generated from the following file:

PxHeightField.h

PhysX SDK 3.2 API Reference: PxHeightField Class Reference

PhysX SDK 3.2 API

PxHeightField Class Reference
[Geomutils]

Public Member Functions

Protected Member Functions

Detailed Description

Creation

Visualizations:

Constructor & Destructor Documentation

Member Function Documentation

Get in touch

PhysX SDK 3.2 API Reference: PxHeightField Class Reference

PhysX SDK 3.2 API

PxHeightField Class Reference [Geomutils]

Public Member Functions

Protected Member Functions

Detailed Description

Creation

Visualizations:

Constructor & Destructor Documentation

Member Function Documentation

PxHeightField Class Reference
[Geomutils]