Visualization Library configuration file. More...

#include <vlCore/platform.hpp>

Namespaces
namespace	vl
	Visualization Library namespace.
Defines
#define	VL_DEBUG_LIVING_OBJECTS 0
	Enable/disable memory leaks debugging.
#define	VL_FORCE_CHECKS 0
	Forces checks to be done also in non debug modes.
#define	VL_MESSAGEBOX_CHECK 0
	Show a message box upon check failure.
#define	VL_PIPELINE_PRECISION 1
	This define is used to set Visualization Library's pipeline precision.
#define	VL_FAST_SQUARE_ROOTS 0
	Enables fast square root computation when using single precision mode.
#define	VL_OBJECT_USER_DATA 0
	Set this to 1 to be able to attach user data to any vl::Object using the "setUserData(void)" and "void userData()" methods.
#define	VL_ACTOR_USER_DATA 0
	Set this to 1 to be able to attach user data to any vl::Actor using the "setActorUserData(void)" and "void actorUserData()" methods.
#define	VL_TRANSFORM_USER_DATA 0
	Set this to 1 to be able to attach user data to any vl::Transform using the "void setTransformUserData(void)" and "void transformUserData()" methods.
#define	VL_SHADER_USER_DATA 0
	Set this to 1 to be able to attach user data to any vl::Shader using the "void setShaderUserData(void)" and "void shaderUserData()" methods.
#define	VL_MAX_ACTOR_LOD 4
	Defines the maximum number of LOD levels available to the Actor class.
#define	VL_MAX_EFFECT_LOD 4
	Defines the maximum number of LOD levels available to the Effect class.
#define	VL_MAX_TEXTURE_UNITS 8
	Maximum number of texture units used.
#define	VL_MAX_GENERIC_VERTEX_ATTRIB 8
	Maximum number of generic vertex attributes used by a single Geometry.
#define	VL_MAX_TIMERS 16
	Maximum timer index that can be passed to vl::Time::start(int index), vl::Time::stop(int index) etc.
#define	VL_STRING_COPY_ON_WRITE 1
	Enable String copy-on-write mode.
#define	VL_DEFAULT_BUFFER_BYTE_ALIGNMENT 16
	Default byte alignment for the vl::Buffer class.
#define	VL_DEBUG_SET_OBJECT_NAME() this->mObjectName = className();
#define	VL_glLoadMatrix glLoadMatrixf
	Defined as `glLoadMatrixf`, used internally.
#define	VL_glMultMatrix glMultMatrixf
	Defined as `glMultMatrixf`, used internally.
Typedefs
typedef float	vl::real
	Defined as `'typedef` `float` `real'`.

Detailed Description

Visualization Library configuration file.

Definition in file config.hpp.

Define Documentation

#define VL_DEBUG_LIVING_OBJECTS 0

Enable/disable memory leaks debugging.

0 = disable memory leaks debugging
1 = Objects::mDebug_LivingObjects will contain the set of currently living Object-s.

This is useful when you want to track memory leaks and object construction/destruction.

Definition at line 54 of file config.hpp.

#define VL_FORCE_CHECKS 0

Forces checks to be done also in non debug modes.

if set to 1 the VL_CHECK() and VL_CHECK_OGL() macros will be active also in release mode builds if set to 0 the VL_CHECK() and VL_CHECK_OGL() macros will be active only in debug mode builds

Definition at line 63 of file config.hpp.

#define VL_MESSAGEBOX_CHECK 0

Show a message box upon check failure.

Only for Win32 platforms. 1 = opens a MessageBox on failed check
0 = opens a MessageBox on failed check

Definition at line 71 of file config.hpp.

#define VL_PIPELINE_PRECISION 1

This define is used to set Visualization Library's pipeline precision.

1 = use floating point single precision pipeline
2 = use floating point double precision pipeline

In single precision mode the classes vec4, vec3, vec2, mat4, mat3, mat2 will be defined as typedefs to their fvec4, fmat4 etc. counter parts.

In double precision mode the classes vec4, vec3, vec2, mat4, mat3, mat2 will be defined as typedefs to their dvec4, dmat4 etc. counter parts.

In single precision mode vl::real is defined as float, in double precision mode vl::real is defined as double.

Other classes are affected as well, in particular vl::Transform, vl::quat, vl::AABB and vl::Sphere.

Definition at line 88 of file config.hpp.

#define VL_FAST_SQUARE_ROOTS 0

Enables fast square root computation when using single precision mode.

0 = disable fast square roots when in single precision floating point pipeline
1 = enable fast square roots when in single precision floating point pipeline

Potential performance improvements:

float sqrt will be up to 1.4x quicker
float 1.0/sqrt will be up to 3x quicker
vec3 normalization will be up to 2x quicker

Please note that the precision of such operations is seriously affected. Use with care! Under some platforms / compiler configurations this might produce wrong results, like objects disappearing, transforms, matrices and vectors filled with garbage data etc.

Definition at line 106 of file config.hpp.

#define VL_OBJECT_USER_DATA 0

Set this to 1 to be able to attach user data to any vl::Object using the "setUserData(void*)" and "void* userData()" methods.

Useful to glue VL classes to the user's application logic.

Note:: This will add 4 or 8 bytes to each vl::Object instance.

Definition at line 115 of file config.hpp.

#define VL_ACTOR_USER_DATA 0

Set this to 1 to be able to attach user data to any vl::Actor using the "setActorUserData(void*)" and "void* actorUserData()" methods.

Useful to glue VL classes to the user's application logic.

Note:: This will add 4 or 8 bytes to each vl::Actor instance.

Definition at line 124 of file config.hpp.

#define VL_TRANSFORM_USER_DATA 0

Set this to 1 to be able to attach user data to any vl::Transform using the "void setTransformUserData(void*)" and "void* transformUserData()" methods.

Useful to glue Transform objects to the user's application animation engine.