G3D::Texture::Settings Class Reference

All parameters of a texture that are independent of the underlying image data. More...

Public Member Functions
	Settings ()
	Settings (const Any &any)
bool	equalsIgnoringMipMap (const Settings &other) const
	True if both Settings are identical, ignoring mipmap settings.
size_t	hashCode () const
bool	operator== (const Settings &other) const
Any	toAny () const

Static Public Member Functions
static const Settings &	buffer ()
	Useful defaults for general purpose computing.
static const Settings &	cubeMap ()
	Useful defaults for cube maps TRILINEAR_MIPMAP / CLAMP, DEPTH_NORMAL / 1.0 / true.
static const Settings &	defaults ()
static const Settings &	shadow ()
	Useful defaults for shadow maps.
static const Settings &	video ()
	Useful defaults for video/image processing.

Public Attributes
bool	autoMipMap
	Default is true.
DepthReadMode	depthReadMode
	Default is DEPTH_NORMAL.
InterpolateMode	interpolateMode
	Default is TRILINEAR_MIPMAP.
float	maxAnisotropy
	Default is 2.0.
int	maxMipMap
	Highest MIP-map level that will be used during rendering.
int	minMipMap
	Lowest MIP-map level that will be used during rendering.
WrapMode	wrapMode
	Default is TILE.

Detailed Description

All parameters of a texture that are independent of the underlying image data.

Constructor & Destructor Documentation

G3D::Texture::Settings::Settings

(

)

G3D::Texture::Settings::Settings

(

const Any &

any

)

Parameters

any	Must be in the form of a table of the fields or appear as a call to a static factory method, e.g.,:

• Texture::Settings{ interpolateMode = "TRILINEAR_MIPMAP", wrapMode = "TILE", ... }
• Texture::Settings::video()

Member Function Documentation

static const Settings& G3D::Texture::Settings::buffer ( )

static

Useful defaults for general purpose computing.

NEAREST_NO_MIPMAP / CLAMP / DEPTH_NORMAL / 1.0 / false

static const Settings& G3D::Texture::Settings::cubeMap ( )

static

Useful defaults for cube maps TRILINEAR_MIPMAP / CLAMP, DEPTH_NORMAL / 1.0 / true.

Referenced by G3D::Lighting::Specification::Specification().

static const Settings& G3D::Texture::Settings::defaults ( )

static

bool G3D::Texture::Settings::equalsIgnoringMipMap

(

const Settings &

other

)

const

True if both Settings are identical, ignoring mipmap settings.

size_t G3D::Texture::Settings::hashCode

(

)

const

Referenced by HashTrait< G3D::Texture::Settings >::hashCode().

bool G3D::Texture::Settings::operator==

(

const Settings &

other

)

const

static const Settings& G3D::Texture::Settings::shadow ( )

static

Useful defaults for shadow maps.

BILINEAR_NO_MIPMAP / CLAMP / DEPTH_LEQUAL / 1.0 / false

Any G3D::Texture::Settings::toAny

(

)

const

static const Settings& G3D::Texture::Settings::video ( )

static

Useful defaults for video/image processing.

BILINEAR_NO_MIPMAP / CLAMP / DEPTH_NORMAL / 1.0 / automipmap =false

Member Data Documentation

bool G3D::Texture::Settings::autoMipMap

Default is true.

DepthReadMode G3D::Texture::Settings::depthReadMode

Default is DEPTH_NORMAL.

InterpolateMode G3D::Texture::Settings::interpolateMode

Default is TRILINEAR_MIPMAP.

float G3D::Texture::Settings::maxAnisotropy

Default is 2.0.

int G3D::Texture::Settings::maxMipMap

Highest MIP-map level that will be used during rendering.

The highest level that actually exists will be L = log(max(m_width, m_height), 2)), although it is fine to set maxMipMap higher than this. Must be larger than minMipMap. Default is 1000.

Setting the max mipmap level is useful for preventing adjacent areas of a texture from being blurred together when viewed at a distance. It may decrease performance, however, by forcing a larger texture into cache than would otherwise be required.

int G3D::Texture::Settings::minMipMap

Lowest MIP-map level that will be used during rendering.

Level 0 is the full-size image. Default is -1000, matching the OpenGL spec.

Referenced Code:

http://oss.sgi.com/projects/ogl-sample/registry/SGIS/texture_lod.txt

WrapMode G3D::Texture::Settings::wrapMode

Default is TILE.