![]() |
Public API Reference |
![]() |
Noise module that outputs concentric cylinders. More...
#include <cstool/noise/module/cylinders.h>
Public Member Functions | |
Cylinders () | |
Constructor. | |
double | GetFrequency () const |
Returns the frequency of the concentric cylinders. | |
virtual int | GetSourceModuleCount () const |
Returns the number of source modules required by this noise module. | |
virtual double | GetValue (double x, double y, double z) const |
Generates an output value given the coordinates of the specified input value. | |
void | SetFrequency (double frequency) |
Sets the frequenct of the concentric cylinders. | |
Protected Attributes | |
double | m_frequency |
Frequency of the concentric cylinders. |
Noise module that outputs concentric cylinders.
This noise module outputs concentric cylinders centered on the origin. These cylinders are oriented along the y axis similar to the concentric rings of a tree. Each cylinder extends infinitely along the y axis.
The first cylinder has a radius of 1.0. Each subsequent cylinder has a radius that is 1.0 unit larger than the previous cylinder.
The output value from this noise module is determined by the distance between the input value and the the nearest cylinder surface. The input values that are located on a cylinder surface are given the output value 1.0 and the input values that are equidistant from two cylinder surfaces are given the output value -1.0.
An application can change the frequency of the concentric cylinders. Increasing the frequency reduces the distances between cylinders. To specify the frequency, call the SetFrequency() method.
This noise module, modified with some low-frequency, low-power turbulence, is useful for generating wood-like textures.
This noise module does not require any source modules.
Definition at line 71 of file cylinders.h.
Constructor.
The default frequency is set to CS::Math::Noise::Module::DEFAULT_CYLINDERS_FREQUENCY.
double CS::Math::Noise::Module::Cylinders::GetFrequency | ( | ) | const [inline] |
Returns the frequency of the concentric cylinders.
Increasing the frequency increases the density of the concentric cylinders, reducing the distances between them.
Definition at line 88 of file cylinders.h.
virtual int CS::Math::Noise::Module::Cylinders::GetSourceModuleCount | ( | ) | const [inline, virtual] |
Returns the number of source modules required by this noise module.
Implements CS::Math::Noise::Module::Module.
Definition at line 93 of file cylinders.h.
virtual double CS::Math::Noise::Module::Cylinders::GetValue | ( | double | x, |
double | y, | ||
double | z | ||
) | const [virtual] |
Generates an output value given the coordinates of the specified input value.
x | The x coordinate of the input value. |
y | The y coordinate of the input value. |
z | The z coordinate of the input value. |
Before an application can call this method, it must first connect all required source modules via the SetSourceModule() method. If these source modules are not connected to this noise module, this method raises a debug assertion.
To determine the number of source modules required by this noise module, call the GetSourceModuleCount() method.
Implements CS::Math::Noise::Module::Module.
void CS::Math::Noise::Module::Cylinders::SetFrequency | ( | double | frequency | ) | [inline] |
Sets the frequenct of the concentric cylinders.
frequency | The frequency of the concentric cylinders. |
Increasing the frequency increases the density of the concentric cylinders, reducing the distances between them.
Definition at line 106 of file cylinders.h.
double CS::Math::Noise::Module::Cylinders::m_frequency [protected] |
Frequency of the concentric cylinders.
Definition at line 114 of file cylinders.h.