pfTexLOD(3pf) OpenGL Performer 3.2.2 libpr C++ Reference Pages pfTexLOD(3pf)NAME
pfTexLOD, pfGetCurTLOD - A texture level of detail control structure.
FUNCTION SPECIFICATION
#include <Performer/pr/pfTexture.h>
pfTexLOD::pfTexLOD();
pfType * pfTexLOD::getClassType(void);
void pfTexLOD::setRange(float min, float max);
void pfTexLOD::getRange(float *min, float *max);
void pfTexLOD::setBias(float biasS, float biasT, float biasR);
void pfTexLOD::getBias(float *biasS, float *biasT, float *biasR);
void pfTexLOD::apply(void);
pfTexLOD * pfGetCurTLOD(void);
PARENT CLASS FUNCTIONS
The OpenGL Performer class pfTexLOD is derived from the parent class
pfObject, so each of these member functions of class pfObject are also
directly usable with objects of class pfTexLOD. This is also true for
ancestor classes of class pfObject.
void* pfObject::operator new(size_t);
void* pfObject::operator new(size_t, void *arena);
void* pfObject::operator new(size_t, pfFluxMemory *fmem);
void pfObject::setUserData(void *data);
void pfObject::setUserData(int slot, void *data);
void* pfObject::getUserData(pfObject *obj);
void* pfObject::getUserData(pfObject *obj, int slot);
int pfObject::getNumUserData();
Since the class pfObject is itself derived from the parent class
pfMemory, objects of class pfTexLOD can also be used with these functions
designed for objects of class pfMemory.
void* pfMemory::getData(const void *ptr);
pfType * pfMemory::getType();
int pfMemory::isOfType(pfType *type);
int pfMemory::isExactType(pfType *type);
const char * pfMemory::getTypeName();
int pfMemory::copy(pfMemory *src);
int pfMemory::compare(const pfMemory *mem);
void pfMemory::print(uint which, uint verbose, char *prefix,
FILE *file);
Page 1
pfTexLOD(3pf) OpenGL Performer 3.2.2 libpr C++ Reference Pages pfTexLOD(3pf)
int pfMemory::getArena(void *ptr);
void* pfMemory::getArena();
int pfMemory::ref();
int pfMemory::unref();
int pfMemory::unrefDelete();
int pfMemory::unrefGetRef();
int pfMemory::getRef();
int pfMemory::checkDelete();
int pfMemory::isFluxed();
void * pfMemory::getArena();
int pfMemory::getSize();
DESCRIPTIONnew(arena) allocates a pfTexLOD from the specified memory arena, or from
the heap if arena is NULL. new allocates a pfTexLOD from the default
memory arena (see pfGetSharedArena). Like other pfObjects, pfTexLODs
cannot be created statically, automatically on the stack or in arrays.
pfTexLODs should be deleted with pfDelete rather than the delete
operator. Texture LOD control is only supported under OpenGL operation
that the texture_lod extensions. See the or OpenGL glIntro(3g) for a
list of supported extensions and their descriptions.
pfTexLOD::getClassType returns the pfType* for the class pfTexLOD. The
pfType* returned by pfTexLOD::getClassType is the same as the pfType*
returned by invoking the virtual function getType on any instance of
class pfTexLOD. Because OpenGL Performer allows subclassing of built-in
types, when decisions are made based on the type of an object, it is
usually better to use the member function isOfType to test if an object
is of a type derived from a Performer type rather than to test for strict
equality of the pfType*'s.
pfTexLOD::apply makes the pfTexLOD the texture LOD control parameters.
When texturing is enabled, the texture LOD parameters set tlod will be
applied to the current texture. Texture LOD parameters set directly on a
pfTexture will take priority over those set in any pfTexLOD. Only one
pfTexLOD may be active at a time although many may be defined.
Modifications to the pfTexLOD, such as changing the range, will not have
effect until pfTexLOD::apply is called.
The texture LOD state element is identified by the PFSTATE_TEXLOD token.
Use this token with pfGeoState::setAttr to set a texture LOD
configuration on a pfGeoState and with pfOverride to override subsequent
texture LOD.
A pfTexLOD will only take affect if texture LOD control is currently
enabled. Texture LOD control can be enabled directly via pfEnable using
the PFEN_TEXLOD token and enable on a pfGeoState with the
PFSTATE_ENTEXLOD token and the boolean value to pfGeoState::setMode.
pfTexLOD::setRange will set the current texture lod range to use only
levels min through max where min is the highest resolution level and max
Page 2
pfTexLOD(3pf) OpenGL Performer 3.2.2 libpr C++ Reference Pages pfTexLOD(3pf)
is the lowest resolution MIPmap. This can be used in conjunction with
texture paging to limit access of level of a texture that have currently
been loaded. Because the min/max limits can be floating point values,
new levels can be smoothly blended in when they become available to avoid
a popping. LOD range can also be used for more efficient use of texture
memory where allow different geometry textured with different images to
share a texture where a near object references the high resolution levels
and a object use the low resolution levels. pfTexLOD::getRange will
return the LOD range. Either of the arguments min,max may be NULL in
which case it will be ignored.
pfTexLOD::setBias will set s, t, and r bias values for the texture level
of detail computation to be biasS, biasT, and biasR, respectively.
These bias values can be used to compensate for asymmetric minification
of a MIPmapped texture; to force blurring of a texture to simulate motion
blur and depth of field, or to force a texture to be sharper. This
functionality uses the texture_lod_bias extension of OpenGL and the exact
use of these bias values is explained in the glIntro man page.
pfTexLOD::getBias will return the LOD bias. Any of the arguments
biasS,biasT,biasR may be NULL in which case it will be ignored.
pfGetCurTLOD will return the most recently applied pfTexLOD as applied
through a pfGeoState, or pfApplyTLOD.
SEE ALSO
pfDelete, pfDispList, pfEnable, pfGeoState, pfObject, pfState, pfTexture,
glIntro, glTexImage2D.
Page 3
