81 lines
3.5 KiB
XML
81 lines
3.5 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="Noise" inherits="Resource" version="4.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
|
|
<brief_description>
|
|
Abstract base class for noise generators.
|
|
</brief_description>
|
|
<description>
|
|
This class defines the interface for noise generation libraries to inherit from.
|
|
A default get_seamless_noise() implementation is provided for libraries that do not provide seamless noise. This function requests a larger image from get_image(), reverses the quadrants of the image, then uses the strips of extra width to blend over the seams.
|
|
Inheriting noise classes can optionally override this function to provide a more optimal algorithm.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="get_image" qualifiers="const">
|
|
<return type="Image" />
|
|
<param index="0" name="width" type="int" />
|
|
<param index="1" name="height" type="int" />
|
|
<param index="2" name="depth" type="int" />
|
|
<param index="3" name="invert" type="bool" default="false" />
|
|
<param index="4" name="in_3d_space" type="bool" default="false" />
|
|
<param index="5" name="normalize" type="bool" default="true" />
|
|
<description>
|
|
Returns a 2D [Image] noise image.
|
|
Note: With [param normalize] set to [code]false[/code] the default implementation expects the noise generator to return values in the range [code]-1.0[/code] to [code]1.0[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_noise_1d" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="x" type="float" />
|
|
<description>
|
|
Returns the 1D noise value at the given (x) coordinate.
|
|
</description>
|
|
</method>
|
|
<method name="get_noise_2d" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="x" type="float" />
|
|
<param index="1" name="y" type="float" />
|
|
<description>
|
|
Returns the 2D noise value at the given position.
|
|
</description>
|
|
</method>
|
|
<method name="get_noise_2dv" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="v" type="Vector2" />
|
|
<description>
|
|
Returns the 2D noise value at the given position.
|
|
</description>
|
|
</method>
|
|
<method name="get_noise_3d" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="x" type="float" />
|
|
<param index="1" name="y" type="float" />
|
|
<param index="2" name="z" type="float" />
|
|
<description>
|
|
Returns the 3D noise value at the given position.
|
|
</description>
|
|
</method>
|
|
<method name="get_noise_3dv" qualifiers="const">
|
|
<return type="float" />
|
|
<param index="0" name="v" type="Vector3" />
|
|
<description>
|
|
Returns the 3D noise value at the given position.
|
|
</description>
|
|
</method>
|
|
<method name="get_seamless_image" qualifiers="const">
|
|
<return type="Image" />
|
|
<param index="0" name="width" type="int" />
|
|
<param index="1" name="height" type="int" />
|
|
<param index="2" name="depth" type="int" />
|
|
<param index="3" name="invert" type="bool" default="false" />
|
|
<param index="4" name="in_3d_space" type="bool" default="false" />
|
|
<param index="5" name="skirt" type="float" default="0.1" />
|
|
<param index="6" name="normalize" type="bool" default="true" />
|
|
<description>
|
|
Returns a seamless 2D [Image] noise image.
|
|
Note: With [param normalize] set to [code]false[/code] the default implementation expects the noise generator to return values in the range [code]-1.0[/code] to [code]1.0[/code].
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
</class>
|