virtualx-engine/modules/noise/doc_classes/Noise.xml

<?xml version="1.0" encoding="UTF-8" ?>
<class name="Noise" inherits="Resource" 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 [method get_seamless_image] implementation is provided for libraries that do not provide seamless noise. This function requests a larger image from the [method get_image] method, 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="invert" type="bool" default="false" />
			<param index="3" name="in_3d_space" type="bool" default="false" />
			<param index="4" name="normalize" type="bool" default="true" />
			<description>
				Returns an [Image] containing 2D noise values.
				[b]Note:[/b] 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_image_3d" 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="normalize" type="bool" default="true" />
			<description>
				Returns an [Array] of [Image]s containing 3D noise values for use with [method ImageTexture3D.create].
				[b]Note:[/b] 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="invert" type="bool" default="false" />
			<param index="3" name="in_3d_space" type="bool" default="false" />
			<param index="4" name="skirt" type="float" default="0.1" />
			<param index="5" name="normalize" type="bool" default="true" />
			<description>
				Returns an [Image] containing seamless 2D noise values.
				[b]Note:[/b] 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_seamless_image_3d" 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="skirt" type="float" default="0.1" />
			<param index="5" name="normalize" type="bool" default="true" />
			<description>
				Returns an [Array] of [Image]s containing seamless 3D noise values for use with [method ImageTexture3D.create].
				[b]Note:[/b] 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>