OGRE  2.0
Object-Oriented Graphics Rendering Engine
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Ogre::Volume::CSGNoiseSource Class Reference

#include <OgreVolumeCSGSource.h>

+ Inheritance diagram for Ogre::Volume::CSGNoiseSource:
+ Collaboration diagram for Ogre::Volume::CSGNoiseSource:

Public Member Functions

 CSGNoiseSource (const Source *src, Real *frequencies, Real *amplitudes, size_t numOctaves, long seed)
 Constructor. More...
 
 CSGNoiseSource (const Source *src, Real *frequencies, Real *amplitudes, size_t numOctaves)
 Constructor with current time as seed. More...
 
bool getFirstRayIntersection (const Ray &ray, Vector3 &result, Real scale=(Real) 1.0, size_t maxIterations=5000, Real maxDistance=(Real) 10000.0) const
 Gets the first intersection of a ray with the volume. More...
 
long getSeed (void) const
 Gets the initial seed. More...
 
virtual const SourcegetSource (void) const
 Gets the source. More...
 
virtual Real getValue (const Vector3 &position) const
 Overridden from Source. More...
 
virtual Vector4 getValueAndGradient (const Vector3 &position) const
 Overridden from Source. More...
 
Real getVolumeSpaceToWorldSpaceFactor (void) const
 Gets a factor to come from volume coordinate to world coordinate. More...
 
void serialize (const Vector3 &from, const Vector3 &to, float voxelWidth, const String &file)
 Serializes a volume source to a discrete grid file with deflated compression. More...
 
void serialize (const Vector3 &from, const Vector3 &to, float voxelWidth, Real maxClampedAbsoluteDensity, const String &file)
 Same as the other serialize function but with a user definable maximum absolute density value. More...
 
virtual void setSource (Source *a)
 Sets the source. More...
 

Static Public Attributes

static const size_t SERIALIZATION_CHUNK_SIZE
 The amount of items being written as one chunk during serialization. More...
 
static const uint32 VOLUME_CHUNK_ID
 The id of volume files. More...
 
static const uint16 VOLUME_CHUNK_VERSION
 The version of volume files. More...
 

Protected Member Functions

Real getInternalValue (const Vector3 &position) const
 
virtual Vector3 getIntersectionEnd (const Ray &ray, Real maxDistance) const
 Gets the end vector of an intersection. More...
 
virtual Vector3 getIntersectionStart (const Ray &ray, Real maxDistance) const
 Gets the start vector of an intersection. More...
 
void setData (void)
 Prepares the node members. More...
 

Protected Attributes

RealmAmplitudes
 The amplitudes of the octaves. More...
 
RealmFrequencies
 The frequencies of the octaves. More...
 
Real mGradientOff
 To calculate the gradient. More...
 
SimplexNoise mNoise
 To make some noise. More...
 
size_t mNumOctaves
 The amount of octaves. More...
 
long mSeed
 The initial seed. More...
 
const SourcemSrc
 The first operant. More...
 

Detailed Description

Definition at line 386 of file OgreVolumeCSGSource.h.

Constructor & Destructor Documentation

Ogre::Volume::CSGNoiseSource::CSGNoiseSource ( const Source src,
Real frequencies,
Real amplitudes,
size_t  numOctaves,
long  seed 
)

Constructor.

Parameters
srcThe source to add the noise to.
frequenciesThe frequencies of the added noise octaves.
amplitudesThe amplitudes of the added noise octaves.
numOctavesThe amount of octaves.
seedThe seed to initialize the random number generator with.
Ogre::Volume::CSGNoiseSource::CSGNoiseSource ( const Source src,
Real frequencies,
Real amplitudes,
size_t  numOctaves 
)

Constructor with current time as seed.

Parameters
srcThe source to add the noise to.
frequenciesThe frequencies of the added noise octaves.
amplitudesThe amplitudes of the added noise octaves.
numOctavesThe amount of octaves.

Member Function Documentation

bool Ogre::Volume::Source::getFirstRayIntersection ( const Ray ray,
Vector3 result,
Real  scale = (Real) 1.0,
size_t  maxIterations = 5000,
Real  maxDistance = (Real) 10000.0 
) const
inherited

Gets the first intersection of a ray with the volume.

If you are using this together with the VolumeChunk: Beware of the possible scaling or other transformations you did on the Chunk! Do the inverse first on the ray origin. Example of a scaling with the factor 10: ray.setOrigin(ray.getOrigin() / (Real)10.0);

Parameters
rayThe ray.
resultWill hold the intersection point if there is an intersection.
scaleThe scaling of the volume compared to the world.
maxIterationsThe maximum amount of iterations on the ray before giving up.
maxDistanceThe maximum distance of the intersection point.
Real Ogre::Volume::CSGNoiseSource::getInternalValue ( const Vector3 position) const
inlineprotected

Definition at line 417 of file OgreVolumeCSGSource.h.

References Ogre::Vector3::x, Ogre::Vector3::y, and Ogre::Vector3::z.

virtual Vector3 Ogre::Volume::Source::getIntersectionEnd ( const Ray ray,
Real  maxDistance 
) const
protectedvirtualinherited

Gets the end vector of an intersection.

This is needed for restricted volumes like discreet grids.

Parameters
rayThe ray of the intersection.
maxDistanceThe maximum distance to query the ray for intersections.
Returns
The end point of the intersection ray.

Reimplemented in Ogre::Volume::GridSource.

virtual Vector3 Ogre::Volume::Source::getIntersectionStart ( const Ray ray,
Real  maxDistance 
) const
protectedvirtualinherited

Gets the start vector of an intersection.

This is needed for restricted volumes like discreet grids.

Parameters
rayThe ray of the intersection.
maxDistanceThe maximum distance to query the ray for intersections.
Returns
The start point of the intersection ray.

Reimplemented in Ogre::Volume::GridSource.

long Ogre::Volume::CSGNoiseSource::getSeed ( void  ) const

Gets the initial seed.

Returns
The initial seed.
virtual const Source* Ogre::Volume::CSGUnarySource::getSource ( void  ) const
virtualinherited

Gets the source.

Returns
The source.
virtual Real Ogre::Volume::CSGNoiseSource::getValue ( const Vector3 position) const
virtual

Overridden from Source.

Implements Ogre::Volume::Source.

virtual Vector4 Ogre::Volume::CSGNoiseSource::getValueAndGradient ( const Vector3 position) const
virtual

Overridden from Source.

Implements Ogre::Volume::Source.

Real Ogre::Volume::Source::getVolumeSpaceToWorldSpaceFactor ( void  ) const
inherited

Gets a factor to come from volume coordinate to world coordinate.

Returns
The factor, 1.0 in the default implementation.
void Ogre::Volume::Source::serialize ( const Vector3 from,
const Vector3 to,
float  voxelWidth,
const String file 
)
inherited

Serializes a volume source to a discrete grid file with deflated compression.

To achieve better compression, all density values are clamped within a maximum absolute value of (to - from).length() / 16.0. The values are scanned in this inner-loop-order: z, x, y. y last because there is usually the least isosurface intersection to be expected in the use case of terrain and so more often the maximum density value hit. The values are written as 16 Bit floats to save space. Note that this process is not lossless, the tradeoff is between accuracy of the source-reproduction (smaller voxelWidth) and smaller filesize (bigger voxelWidth).

Parameters
fromThe start point to scan the volume.
toThe end point to scan the volume.
voxelWidthThe width of a single cube in the density grid.
fileThe file to write the grid to.
void Ogre::Volume::Source::serialize ( const Vector3 from,
const Vector3 to,
float  voxelWidth,
Real  maxClampedAbsoluteDensity,
const String file 
)
inherited

Same as the other serialize function but with a user definable maximum absolute density value.

Parameters
fromThe start point to scan the volume.
toThe end point to scan the volume.
voxelWidthThe width of a single cube in the density grid.
maxClampedAbsoluteDensityThe maximum absolute density value to be written into the file, influencing the compression rate.
fileThe file to write the grid to.
void Ogre::Volume::CSGNoiseSource::setData ( void  )
protected

Prepares the node members.

virtual void Ogre::Volume::CSGUnarySource::setSource ( Source a)
virtualinherited

Sets the source.

Parameters
aThe source.

Member Data Documentation

Real* Ogre::Volume::CSGNoiseSource::mAmplitudes
protected

The amplitudes of the octaves.

Definition at line 394 of file OgreVolumeCSGSource.h.

Real* Ogre::Volume::CSGNoiseSource::mFrequencies
protected

The frequencies of the octaves.

Definition at line 391 of file OgreVolumeCSGSource.h.

Real Ogre::Volume::CSGNoiseSource::mGradientOff
protected

To calculate the gradient.

Definition at line 403 of file OgreVolumeCSGSource.h.

SimplexNoise Ogre::Volume::CSGNoiseSource::mNoise
protected

To make some noise.

Definition at line 400 of file OgreVolumeCSGSource.h.

size_t Ogre::Volume::CSGNoiseSource::mNumOctaves
protected

The amount of octaves.

Definition at line 397 of file OgreVolumeCSGSource.h.

long Ogre::Volume::CSGNoiseSource::mSeed
protected

The initial seed.

Definition at line 406 of file OgreVolumeCSGSource.h.

const Source* Ogre::Volume::CSGUnarySource::mSrc
protectedinherited

The first operant.

Definition at line 306 of file OgreVolumeCSGSource.h.

const size_t Ogre::Volume::Source::SERIALIZATION_CHUNK_SIZE
staticinherited

The amount of items being written as one chunk during serialization.

Definition at line 74 of file OgreVolumeSource.h.

const uint32 Ogre::Volume::Source::VOLUME_CHUNK_ID
staticinherited

The id of volume files.

Definition at line 68 of file OgreVolumeSource.h.

const uint16 Ogre::Volume::Source::VOLUME_CHUNK_VERSION
staticinherited

The version of volume files.

Definition at line 71 of file OgreVolumeSource.h.


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