ObjectWaterMesh Class
The scope of applications for UnigineScript is limited to implementing materials-related logic (material expressions, scriptable materials, brush materials). Do not use UnigineScript as a language for application logic, please consider C#/C++ instead, as these APIs are the preferred ones. Availability of new Engine features in UnigineScript (beyond its scope of applications) is not guaranteed, as the current level of support assumes only fixing critical issues.
Inherits from: | Object |
Interface for object water mesh handling. The water mesh can have four sine waves. The object is used to create small water basins such as ponds, lakes and so on. ObjectWaterMesh has physics support, so it can have a body assigned, therefore, it can interact with other scene objects.
See Also#
A UnigineScript API sample <UnigineSDK>/data/samples/objects/water_01
ObjectWaterMesh Class
Members
static ObjectWaterMesh ( ) #
Constructor. Creates a new water mesh object.static ObjectWaterMesh ( string path ) #
Constructor. Creates a new water mesh object from a specified file.Arguments
- string path - Path to the water mesh.
void setFieldMask ( int mask ) #
Sets a field mask specifying the area of the Field node to be applied.Arguments
- int mask - An integer value, each bit of which is used to set a mask.
int getFieldMask ( ) #
Returns the mask specifying the area of the applied Field node.Return value
The integer value, each bit of which sets a mask.float getHeight ( Vec3 position ) #
Returns a height offset of a given point relatively to the water mesh surface.Arguments
- Vec3 position - The point position coordinates.
Return value
Height offset of the point.int setMesh ( Mesh mesh ) #
Allows for reinitialization of the water mesh object: copies a given mesh into the current water mesh.ObjectWaterMesh waterMesh = new ObjectWaterMesh();
// create a mesh
Mesh mesh = new Mesh("lake.mesh");
// copy the mesh into the water mesh
waterMesh.setMesh(mesh);
Arguments
- Mesh mesh - Mesh.
Return value
1 if the mesh is copied successfully; otherwise, 0.int getMesh ( Mesh mesh ) #
Copies the current water mesh into the received mesh.// a water mesh from which geometry will be obtained
ObjectWaterMesh waterMesh = new ObjectWaterMesh("lake.mesh");
// create a new mesh
Mesh mesh = new Mesh();
// copy geometry to the created mesh
if (waterMesh.getMesh(mesh)) {
// do something with the obtained mesh
}
else {
log.error("Failed to copy a mesh\n");
}
Arguments
- Mesh mesh - Received mesh.
Return value
1 if the mesh is copied successfully; otherwise, 0.void setMeshName ( string name ) #
Sets a name for the water mesh.Arguments
- string name - The water mesh name.
int setMeshName ( string path, int force_load = 0 ) #
Sets a new name for the water mesh and forces loading of the mesh with the new name for the current water mesh.Arguments
- string path - A new name to be set for the water mesh.
- int force_load - Force flag.
- If 1 is specified, the mesh with the new name will be loaded immediately from the file specified as the first argument for this function.
- If 0 is specified, only the mesh name will be updated.
Return value
1 if :- The current mesh name coincides the new name.
- The mesh with the new name has been loaded successfully.
- The force flag is set to 0.
string getMeshName ( ) #
Returns the name of the current water mesh.Return value
The mesh name.vec3 getNormal ( Vec3 position ) #
Returns the normal vector of a given point (used to orient objects along the waves normals).Arguments
- Vec3 position - The point position coordinates.
Return value
Normal vector.void setWave ( int num, vec4 wave ) #
Sets parameters for one of four simulated water waves.Arguments
- int num - Wave number in range [0;3].
- vec4 wave - Wave parameters:
- The X and Y components containing the velocity of the wave.
- The Z component containing the frequency.
- The W component containing the amplitude.
vec4 getWave ( int num ) #
Returns parameters of one of four simulated water waves.Arguments
- int num - Wave number in range [0;3].
Return value
Wave parameters:- The X and Y components containing the velocity of the wave.
- The Z component containing the frequency.
- The W component containing the amplitude.
void setWaveAngle ( int num, float angle ) #
Sets direction (angle of spreading) for a given wave:- If 0 is specified, the wave spreads along the Y axis and is parallel to the X axis.
- If a positive value is specified, the wave direction is slanted counterclockwise relative to its initial spread.
- If a negative value is specified, the wave is rotated clockwise.
Arguments
- int num - Wave number in range [0;3].
- float angle - Angle, in degrees. Both positive and negative values are acceptable.
float getWaveAngle ( int num ) #
Returns direction (angle of spreading) of a given wave.Arguments
- int num - Wave number in range [0;3].
Return value
Angle, in degrees.void setWaveHeight ( int num, float height ) #
Sets the distance between the highest and the lowest peaks for the given wave. It sets the wave form along with the setWaveLength() function. The higher the value is, the higher the waves are.Arguments
- int num - Wave number in range [0;3].
- float height - Height, in units.
float getWaveHeight ( int num ) #
Returns the distance between the highest and the lowest peaks for the given wave.Arguments
- int num - Wave number in range [0;3].
Return value
Height, in units.void setWaveLength ( int num, float length ) #
Sets the distance between successive crests for the given wave. The higher the length value is, the broader the waves are.Arguments
- int num - Wave number in range [0;3].
- float length - Length, in units.
float getWaveLength ( int num ) #
Returns the distance between successive crests of the given wave.Arguments
- int num - Wave number in range [0;3].
Return value
Length, in units.void setWaveSpeed ( int num, float speed ) #
Sets a speed for a given wave. The higher the value, the faster waves follow each other.Arguments
- int num - Wave number in range [0;3].
- float speed - Speed, in units per second.
float getWaveSpeed ( int num ) #
Returns the speed of a given wave.Arguments
- int num - Wave number in range [0;3].
Return value
Speed, in units per second.int loadMesh ( string path ) #
Loads a mesh for the current water mesh from the file. This function doesn't change the mesh name.Arguments
- string path - The name of the mesh file.
Return value
1 if the mesh is loaded successfully; otherwise, 0.int saveMesh ( string path ) #
Saves the object water mesh into a file.Arguments
- string path - A name of the file.
Return value
1 if the mesh is saved successfully; otherwise, 0.static int type ( ) #
Returns the type of the node.Return value
Object type identifier.Last update:
2021-12-13
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)