Unigine.BakeLighting Class

BakeLighting Class

Enums

LIGHTMAP_QUALITY#

Light baking quality preset.

Name	Description
DRAFT = 0	Ultra baking quality. Provides the highest iterativity with the lowest sampling quality and number of rays.
LOW = 1	Ultra baking quality. Provides low sampling quality and number of light rays.
MEDIUM = 2	Ultra baking quality. Corresponds to stable quality level which is good for most cases.
HIGH = 3	Ultra baking quality. Corresponds to high sampling quality and number of light rays simulated intended for release production.
ULTRA = 4	Ultra baking quality. Might be useful to get rid of even small inconsistencies. Intended for the release production.

Properties

int Progress#

int ProgressBounce#

int ProgressLight#

int CurrentBounce#

Light CurrentLight#

float Timer#

float VoxelSizeMultiplier#

int Bounces#

bool IsBaking#

int CurrentSurface#

Object CurrentObject#

string CacheDir#

float LightmapZFar#

int LightmapViewportMask#

BakeLighting.LIGHTMAP_QUALITY LightmapQuality#

int SamplesPerFrame#

Members

---

void Bake ( LightVoxelProbe[] voxel_lights, LightEnvironmentProbe[] env_lights, Light[] shadow_lights, ObjectMeshStatic[] objects, int[] surfaces ) #

Starts the process of light baking for all voxel and environment probes, shadow baking for light sources in static light mode and lightmaps baking for surfaces of Mesh Static objects in the given list.

Arguments

• LightVoxelProbe[] voxel_lights - List of voxel probes for which the process of light baking is to be performed. The order of nodes added for baking is not important.
• LightEnvironmentProbe[] env_lights - List of environment probes for which the process of light baking is to be performed. The order of nodes added for baking is not important.
• Light[] shadow_lights - List of light sources in static light mode for which the process of shadow baking is to be performed. The order of lights added for baking is not important.
• ObjectMeshStatic[] objects - List of Mesh Static objects for which the process of lightmaps baking is to be performed.
• int[] surfaces - List of surfaces of Mesh Static objects for which the process of lightmaps baking is to be performed.
  Notice

  The number of objects and surfaces added for baking must be equal.

void BakeAll ( bool voxel_probes = true, bool env_probes = true, bool shadow = true, bool lightmap = true ) #

Starts the process of light baking for all enabled voxel and environment probes, shadow baking for eanbled light sources in static light mode and lightmaps baking for enabled surfaces of Mesh Static objects in the scene.

Arguments

• bool voxel_probes - 1 to enable light baking for voxel probes; otherwise, 0.
• bool env_probes - 1 to enable light baking for environment probes; otherwise, 0.
• bool shadow - 1 to enable shadow baking for light sources in static light mode; otherwise, 0.
• bool lightmap - 1 to enable lightmaps baking for surfaces of Mesh Static objects; otherwise, 0.

void Stop ( bool save_results = false ) #

Interrupts the process of light baking, if it is in performing state.

Arguments

• bool save_results - 1 to save the obtained result; 0 to restore the previous content.

void AddReadOnlyTexture ( UGUID guid ) #

Adds a read-only texture with the specified GUID.

Arguments

• UGUID guid - GUID of the read-only texture to be added.

void RemoveReadOnlyTexture ( UGUID guid ) #

Removes the read-only texture with the specified GUID.

Arguments

• UGUID guid - GUID of the read-only texture to be removed.

void SetSamplesPerFrame ( int frame ) #

Sets number of voxels for voxel probes and samples for environment probes, light sources and surfaces computed and visualized per single frame.

Arguments

• int frame - Number of samples per frame within the [1, 500] range. The default value is 1.
  Notice

  High values cause longer user interface response.

int GetSamplesPerFrame ( ) #

Returns number of voxels for voxel probes and samples for environment probes, light sources and surfaces computed and visualized per single frame.

Return value

Number of samples.

void SetLightmapQuality ( BakeLighting.LIGHTMAP_QUALITY quality ) #

Sets the global baking quality for lightmaps.

Arguments

• BakeLighting.LIGHTMAP_QUALITY quality - One of LIGHTMAP_QUALITY values.

BakeLighting.LIGHTMAP_QUALITY GetLightmapQuality ( ) #

Returns the current global baking quality for lightmaps.

Return value

LIGHTMAP_QUALITY preset.

void SetLightmapViewportMask ( int mask ) #

Sets the viewport mask for the lightmapper. For a light or surface to contribute to static GI, their viewport masks should match the baking viewport mask.

Arguments

• int mask - Viewport mask (integer, each bit of which is used to represent a mask).

int GetLightmapViewportMask ( ) #

Returns the current viewport mask set for lightmapper.

Return value

Viewport mask (integer, each bit of which is used to represent a mask).

void SetLightmapZFar ( float zfar ) #

Sets the far clipping distance for light rays used when baking lightmaps.

Arguments

• float zfar - Far clipping distance.

float GetLightmapZFar ( ) #

Returns the far clipping distance for light rays.

Return value

Far clipping distance.

void SetCacheDir ( string dir ) #

Sets the path to the directory that stores temporary cache textures during lightmaps baking process. By default, the bin/unigine_bake_lighting_cache project's folder is set.

Arguments

• string dir - An absolute path or a relative path to the bin folder.

string GetCacheDir ( ) #

Returns the current path set for the directory that stores temporary cache textures during lightmaps baking process. By default, the bin/unigine_bake_lighting_cache project's folder is set.

Return value

Path to the cache folder.

Object GetCurrentObject ( ) #

Returns the object currently being processed when baking lightmaps.

Return value

Object pointer during lightmaps baking; otherwise, nullptr.

int GetCurrentSurface ( ) #

Returns the index of the surface currently being processed when baking lightmaps.

Return value

Index of the surface during lightmaps baking; otherwise, -1.