mirror of
https://github.com/godotengine/godot-docs.git
synced 2025-12-31 17:49:03 +03:00
204 lines
9.1 KiB
ReStructuredText
204 lines
9.1 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
|
|
.. DO NOT EDIT THIS FILE, but the OpenSimplexNoise.xml source instead.
|
|
.. The source is found in doc/classes or modules/<name>/doc_classes.
|
|
|
|
.. _class_OpenSimplexNoise:
|
|
|
|
OpenSimplexNoise
|
|
================
|
|
|
|
**Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
|
|
|
|
**Category:** Core
|
|
|
|
Brief Description
|
|
-----------------
|
|
|
|
Noise generator based on Open Simplex.
|
|
|
|
Properties
|
|
----------
|
|
|
|
+---------------------------+-----------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`lacunarity<class_OpenSimplexNoise_property_lacunarity>` |
|
|
+---------------------------+-----------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`octaves<class_OpenSimplexNoise_property_octaves>` |
|
|
+---------------------------+-----------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`period<class_OpenSimplexNoise_property_period>` |
|
|
+---------------------------+-----------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`persistence<class_OpenSimplexNoise_property_persistence>` |
|
|
+---------------------------+-----------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`seed<class_OpenSimplexNoise_property_seed>` |
|
|
+---------------------------+-----------------------------------------------------------------+
|
|
|
|
Methods
|
|
-------
|
|
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Image<class_Image>` | :ref:`get_image<class_OpenSimplexNoise_method_get_image>` **(** :ref:`int<class_int>` width, :ref:`int<class_int>` height **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_noise_2d<class_OpenSimplexNoise_method_get_noise_2d>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_noise_2dv<class_OpenSimplexNoise_method_get_noise_2dv>` **(** :ref:`Vector2<class_Vector2>` pos **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_noise_3d<class_OpenSimplexNoise_method_get_noise_3d>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y, :ref:`float<class_float>` z **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_noise_3dv<class_OpenSimplexNoise_method_get_noise_3dv>` **(** :ref:`Vector3<class_Vector3>` pos **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_noise_4d<class_OpenSimplexNoise_method_get_noise_4d>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y, :ref:`float<class_float>` z, :ref:`float<class_float>` w **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Image<class_Image>` | :ref:`get_seamless_image<class_OpenSimplexNoise_method_get_seamless_image>` **(** :ref:`int<class_int>` size **)** |
|
|
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Description
|
|
-----------
|
|
|
|
This resource allows you to configure and sample a fractal noise space. Here is a brief usage example that configures an OpenSimplexNoise and gets samples at various positions and dimensions:
|
|
|
|
::
|
|
|
|
var noise = OpenSimplexNoise.new()
|
|
|
|
# Configure
|
|
noise.seed = randi()
|
|
noise.octaves = 4
|
|
noise.period = 20.0
|
|
noise.persistence = 0.8
|
|
|
|
# Sample
|
|
print("Values:")
|
|
print(noise.get_noise_2d(1.0, 1.0))
|
|
print(noise.get_noise_3d(0.5, 3.0, 15.0))
|
|
print(noise.get_noise_4d(0.5, 1.9, 4.7, 0.0))
|
|
|
|
Property Descriptions
|
|
---------------------
|
|
|
|
.. _class_OpenSimplexNoise_property_lacunarity:
|
|
|
|
- :ref:`float<class_float>` **lacunarity**
|
|
|
|
+----------+-----------------------+
|
|
| *Setter* | set_lacunarity(value) |
|
|
+----------+-----------------------+
|
|
| *Getter* | get_lacunarity() |
|
|
+----------+-----------------------+
|
|
|
|
Difference in period between :ref:`octaves<class_OpenSimplexNoise_property_octaves>`.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_property_octaves:
|
|
|
|
- :ref:`int<class_int>` **octaves**
|
|
|
|
+----------+--------------------+
|
|
| *Setter* | set_octaves(value) |
|
|
+----------+--------------------+
|
|
| *Getter* | get_octaves() |
|
|
+----------+--------------------+
|
|
|
|
Number of OpenSimplex noise layers that are sampled to get the fractal noise.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_property_period:
|
|
|
|
- :ref:`float<class_float>` **period**
|
|
|
|
+----------+-------------------+
|
|
| *Setter* | set_period(value) |
|
|
+----------+-------------------+
|
|
| *Getter* | get_period() |
|
|
+----------+-------------------+
|
|
|
|
Period of the base octave. A lower period results in a higher-frequency noise (more value changes across the same distance).
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_property_persistence:
|
|
|
|
- :ref:`float<class_float>` **persistence**
|
|
|
|
+----------+------------------------+
|
|
| *Setter* | set_persistence(value) |
|
|
+----------+------------------------+
|
|
| *Getter* | get_persistence() |
|
|
+----------+------------------------+
|
|
|
|
Contribution factor of the different octaves. A ``persistence`` value of 1 means all the octaves have the same contribution, a value of 0.5 means each octave contributes half as much as the previous one.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_property_seed:
|
|
|
|
- :ref:`int<class_int>` **seed**
|
|
|
|
+----------+-----------------+
|
|
| *Setter* | set_seed(value) |
|
|
+----------+-----------------+
|
|
| *Getter* | get_seed() |
|
|
+----------+-----------------+
|
|
|
|
Seed used to generate random values, different seeds will generate different noise maps.
|
|
|
|
Method Descriptions
|
|
-------------------
|
|
|
|
.. _class_OpenSimplexNoise_method_get_image:
|
|
|
|
- :ref:`Image<class_Image>` **get_image** **(** :ref:`int<class_int>` width, :ref:`int<class_int>` height **)**
|
|
|
|
Generate a noise image with the requested ``width`` and ``height``, based on the current noise parameters.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_method_get_noise_2d:
|
|
|
|
- :ref:`float<class_float>` **get_noise_2d** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
|
|
|
|
Returns the 2D noise value ``[-1,1]`` at the given position.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_method_get_noise_2dv:
|
|
|
|
- :ref:`float<class_float>` **get_noise_2dv** **(** :ref:`Vector2<class_Vector2>` pos **)**
|
|
|
|
Returns the 2D noise value ``[-1,1]`` at the given position.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_method_get_noise_3d:
|
|
|
|
- :ref:`float<class_float>` **get_noise_3d** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y, :ref:`float<class_float>` z **)**
|
|
|
|
Returns the 3D noise value ``[-1,1]`` at the given position.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_method_get_noise_3dv:
|
|
|
|
- :ref:`float<class_float>` **get_noise_3dv** **(** :ref:`Vector3<class_Vector3>` pos **)**
|
|
|
|
Returns the 3D noise value ``[-1,1]`` at the given position.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_method_get_noise_4d:
|
|
|
|
- :ref:`float<class_float>` **get_noise_4d** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y, :ref:`float<class_float>` z, :ref:`float<class_float>` w **)**
|
|
|
|
Returns the 4D noise value ``[-1,1]`` at the given position.
|
|
|
|
----
|
|
|
|
.. _class_OpenSimplexNoise_method_get_seamless_image:
|
|
|
|
- :ref:`Image<class_Image>` **get_seamless_image** **(** :ref:`int<class_int>` size **)**
|
|
|
|
Generate a tileable noise image, based on the current noise parameters. Generated seamless images are always square (``size`` x ``size``).
|
|
|