LDKGrassPatch
Opaque identity of one patch. Individual blades are intentionally hidden.
typedef struct LDKGrassPatch{
u32 index;
u32 version;
}LDKGrassPatch;Patches
LDKGrassPatchDesc
Per-region state. Visual configuration comes from LDKGrassSystem.
typedef struct LDKGrassPatchDesc{
LDKGrassPlane plane;
float density_scale;
u32 seed;
}LDKGrassPatchDesc;LDKGrassPlane
Flat target geometry. The complete parallelogram, including its edges, is a valid generation area. origin + axis_u + axis_v is the opposite corner.
typedef struct LDKGrassPlane{
Vec3 origin;
Vec3 axis_u;
Vec3 axis_v;
}LDKGrassPlane;ldk_grass_add
Generate and retain one patch using a configured grass type.
LDK_API LDKGrassPatch ldk_grass_add(
LDKGrassTypeId type_id,
const LDKGrassPatchDesc *desc
);Parameters
LDKGrassTypeId type_id- Identifier of the type.
const LDKGrassPatchDesc *desc- Description or configuration for this operation.
Returns
The requested value.
ldk_grass_clear
Remove every live patch. Renderer-side style resources remain cached.
LDK_API void ldk_grass_clear(void);ldk_grass_patch_desc_defaults
Initialize an empty one-square-unit patch with density scale 1.
LDK_API void ldk_grass_patch_desc_defaults(LDKGrassPatchDesc *out_desc);Parameters
LDKGrassPatchDesc *out_desc- Receives the descriptor.
ldk_grass_patch_is_valid
True while patch identifies a live entry in the active GrassSystem.
LDK_API bool ldk_grass_patch_is_valid(LDKGrassPatch patch);Parameters
LDKGrassPatch patch- Patch used by this operation.
Returns
True when the queried condition holds; false otherwise.
ldk_grass_patch_null
Return an invalid grass patch handle.
LDK_API LDKGrassPatch ldk_grass_patch_null(void);Returns
An invalid or empty handle.
ldk_grass_remove
Remove a patch and every opaque blade belonging to it.
LDK_API bool ldk_grass_remove(LDKGrassPatch patch);Parameters
LDKGrassPatch patch- Patch used by this operation.
Returns
True if the operation succeeds; false otherwise.
ldk_grass_update
Replace a patch recipe and regenerate its persistent blade transforms.
LDK_API bool ldk_grass_update(
LDKGrassPatch patch,
LDKGrassTypeId type_id,
const LDKGrassPatchDesc *desc
);Parameters
LDKGrassPatch patch- Patch used by this operation.
LDKGrassTypeId type_id- Identifier of the type.
const LDKGrassPatchDesc *desc- Description or configuration for this operation.
Returns
True if the operation succeeds; false otherwise.