SceneResource

The SceneResource module provides basic resource types in 3D graphics.

NOTE

• The initial APIs of this module are supported since API version 12. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import { SceneResourceType, SceneResource, Shader, MaterialType, CullMode, Blend, RenderSort, Material,
  MaterialProperty, MetallicRoughnessMaterial, ShaderMaterial, SamplerFilter, SamplerAddressMode, Sampler,
  SubMesh, Morpher, Mesh, MeshResource, Animation, EnvironmentBackgroundType, Environment, Image } from '@kit.ArkGraphics3D';

SceneResourceType

Enumerates the scene resource types, which are used to classify resources in a scene.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
UNKNOWN	0	Unknown.
NODE	1	Node type.
ENVIRONMENT	2	Environment resource.
MATERIAL	3	Material type.
MESH	4	Mesh resource.
ANIMATION	5	Animation resource.
SHADER	6	Shader resource.
IMAGE	7	Image resource.
MESH_RESOURCE18+	8	Mesh resource.
EFFECT21+	9	Post-processing effect resource.

SceneResource

Describes a resource in a scene.

Properties

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
name	string	No	No	Name. There is no special format requirement.
resourceType	SceneResourceType	Yes	No	Scene resource type. The default value is undefined.
uri	ResourceStr	Yes	Yes	Resource to load. The default value is undefined.

destroy

destroy(): void

Destroys the scene resource and releases all associated resources or references. Once released, the resource can no longer be used or accessed.

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Shader, SceneResourceParameters, SceneResourceFactory, Scene } from '@kit.ArkGraphics3D';

function destroy(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result) {
      let sceneFactory: SceneResourceFactory = result.getResourceFactory();
      // Create shader resources. The path and file name can be customized based on the specific project resources.
      let sceneResourceParameter: SceneResourceParameters = { name: "shaderResource",
        uri: $rawfile("shaders/custom_shader/custom_material_sample.shader") };
      let shader: Promise<Shader> = sceneFactory.createShader(sceneResourceParameter);
      shader.then(async (shaderResult:Shader) => {
         // Release the resource.
         shaderResult.destroy();
      });
    }
  });
}

Shader

Shader resource, which inherits from SceneResource.

Properties

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
inputs	Record<string, number | Vec2 | Vec3 | Vec4 | Image>	Yes	No	Inputs of the shader.

setShaderInputs²³⁺

setShaderInputs(inputs: Record<string, number | Vec2 | Vec3 | Vec4 | Image>): void

Sets the inputs for the shader. This API delivers better performance than directly setting the inputs property.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.ArkUi.Graphics3D

Parameters

Name	Type	Mandatory	Description
inputs	Record<string, number | Vec2 | Vec3 | Vec4 | Image>	Yes	A mapping of strings to values for setting shader inputs.

Example

import { Image, MaterialType, Scene, SceneResourceFactory, Shader, ShaderMaterial } from '@kit.ArkGraphics3D';

function setinputs(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result) {
      let rf : SceneResourceFactory | null = await result.getResourceFactory();
      if (!rf) {
        return;
      }
      // Create the material and shader.
      let material: ShaderMaterial | null = await rf.createMaterial({name: "CustomMaterial"}, MaterialType.SHADER);
      let shader : Shader | null = await rf.createShader(
        {name: "CustomShader", uri: $rawfile("shaders/custom_shader/custom_material_sample.shader")});
      if (!material || !shader) {
        return;
      }
      // Load the texture resource.
      let image : Image | null = await rf.createImage({name: "envImg", uri: $rawfile("custom_image.jpg")});
      if (!image) {
        return;
      }
      // Bind the shader to the texture.
      material.colorShader = shader;
      // Set the shader inputs.
      material.colorShader.setShaderInputs({
        "uTime": 1.0,
        "uVelocity": {x: 1.0, y: 1.0, z:-1.0, w:-1.0},
        "uTexture": image
      })
    }
  });
}

MaterialType

Enumerates the material types in a scene. The material type defines how materials in a scene are rendered.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
SHADER	1	Shader-defined.
METALLIC_ROUGHNESS20+	2	Metallic-Roughness model based on Physically Based Rendering (PBR), simulating realistic material lighting effects through metallicity and roughness parameters.
UNLIT23+	3	Material that is not affected by lighting.
OCCLUSION23+	4	Occlusion material: occludes other objects in the scene but does not occlude the environment.

CullMode²⁰⁺

Enumerates the culling modes of PBR materials. You can improve rendering performance and visual quality by determining whether the front or back faces of objects are culled.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
NONE	0	Culling is disabled.
FRONT	1	Culls the front faces of geometric objects.
BACK	2	Culls the back faces of geometric objects.

Blend²⁰⁺

Controls the transparency of materials.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
enabled	boolean	No	No	Whether the transparency of the material is enabled. true if enabled, false otherwise.

RenderSort²⁰⁺

Describes the order in which materials are rendered, controlling the sequence of drawing in the rendering pipeline.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
renderSortLayer	number	No	Yes	Rendering layer ID. A smaller value indicates an earlier rendering order. The value range is [0, 63]. The default layer ID is 32.
renderSortLayerOrder	number	No	Yes	Rendering order of different objects within the same rendering layer. A smaller value indicates an earlier rendering order. The value range is [0, 255]. The default value is 0.

PolygonMode²³⁺

Enumerates the polygon drawing mode.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
FILL	0	Draws each face of the polygon.
LINE	1	Draws only the wireframe of the polygon.
POINT	2	Draws only the vertices of the polygon.

Material

Material resource, which inherits from SceneResource.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
materialType	MaterialType	Yes	No	Material type.
shadowReceiver20+	boolean	No	Yes	Whether the material receives shadows. true if the material receives shadows, false otherwise. The default is false.
cullMode20+	CullMode	No	Yes	Culling mode of the material, which can be used to determine whether to cull front or back faces. The default value is BACK.
blend20+	Blend	No	Yes	Whether the material is transparent. The default value is false.
alphaCutoff20+	number	No	Yes	Threshold of the alpha channel. If the alpha of a pixel is greater than or equal to this threshold, the pixel is rendered; otherwise, the pixel is not rendered. Setting a value less than 1 enables this mode. The value range is [0, 1]. The default value is 1.
renderSort20+	RenderSort	No	Yes	Rendering order, which determines the rendering sequence of materials in the rendering pipeline. The default layer ID is 32, and the default order within the layer is 0.
polygonMode23+	PolygonMode	No	Yes	Polygon drawing mode of the model. The default value is FILL.

MaterialProperty²⁰⁺

Defines the textures, property factors, and texture samplers used by a material.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
image	Image | null	No	No	Texture map based on PBR properties to convey the texture information of the material.
factor	Vec4	No	No	PBR property factor, with different meanings for different properties.
sampler	Sampler	No	Yes	Texture sampler, with the default value set to LINEAR for magnification, minification, and mipmaps, and to REPEAT for U, V, and W directions.

MetallicRoughnessMaterial²⁰⁺

Material resource for creating realistic appearances, using the Metallic-Roughness model based on PBR. It simulates the surface lighting and reflection effects of different materials like metal and plastic by adjusting metallicity and roughness parameters. It inherits from Material.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
baseColor	MaterialProperty	No	No	Base color map, which is used to represent the material's color in the absence of lighting.
normal	MaterialProperty	No	No	Normal map, which is used to represent the surface structure details of an object to enhance lighting realism without altering the geometric structure.
material	MaterialProperty	No	No	Metal material parameters. Roughness: strength of reflection caused by the fine surface structure details of the material. Metallic: metallic properties of the material. Reflectance: reflectivity of the material.
ambientOcclusion	MaterialProperty	No	No	Ambient occlusion map, which is used to simulate the occlusion of ambient light in recesses or detailed parts of an object to enhance local shadows and improve detail realism.
emissive	MaterialProperty	No	No	Emissive color, which is the color of the material as a light source.
clearCoat	MaterialProperty	No	No	Clear coat, similar to car paint, carbon fiber, or a wet surface, which requires an additional transparent layer with reflective properties.
clearCoatRoughness	MaterialProperty	No	No	Roughness of the clear coat.
clearCoatNormal	MaterialProperty	No	No	Normal map of the clear coat.
sheen	MaterialProperty	No	No	Gentle, widespread shine of microfiber materials, ideal for representing fabrics and textiles.
specular	MaterialProperty	No	No	Specular reflection of non-metallic materials, showing the intensity of traditional mirror-like reflections.

ShaderMaterial

Shader material, which inherits from Material.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
colorShader	Shader	No	Yes	Shader. The default value is undefined.

UnlitMaterial²³⁺

Material that is not affected by lighting. The shading value of the material is related only to the base color and is irrelevant to lighting conditions. It inherits from Material.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
baseColor	MaterialProperty	No	No	Base color property, which defines the base color information of the material.

OcclusionMaterial²³⁺

Occlusion material: occludes other objects in the scene but does not occlude the environment. It is inherited from Material.

System capability: SystemCapability.ArkUi.Graphics3D

SamplerFilter²⁰⁺

Enumerates the filtering modes of a sampler. The filtering mode determines the interpolation method used when sampling textures, controlling how final pixel colors are calculated during texture scaling or deformation.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
NEAREST	0	Uses nearest-neighbor interpolation, which is fast but can result in jagged edges.
LINEAR	1	Uses linear interpolation, providing a smoother appearance but with a slight performance cost.

SamplerAddressMode²⁰⁺

Enumerates the sampler addressing modes, which are used to control how texture coordinates are handled when they go beyond the [0, 1] range.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
REPEAT	0	The texture repeats when the coordinates exceed the range.
MIRRORED_REPEAT	1	The texture mirrors and repeats when the coordinates exceed the range.
CLAMP_TO_EDGE	2	The edge pixels of the texture are stretched when the coordinates exceed the range.

Sampler²⁰⁺

Describes the sampling modes used during texture sampling.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
magFilter	SamplerFilter	No	Yes	Sampling mode when the texture is enlarged. The default value is LINEAR.
minFilter	SamplerFilter	No	Yes	Sampling mode when the texture is reduced. The default value is LINEAR.
mipMapMode	SamplerFilter	No	Yes	Sampling modes between different texture resolutions. The default value is LINEAR.
addressModeU	SamplerAddressMode	No	Yes	Sampling mode of the texture in the U (horizontal) direction. The default value is REPEAT.
addressModeV	SamplerAddressMode	No	Yes	Sampling mode of the texture in the V (vertical) direction. The default value is REPEAT.

SubMesh

Sub-mesh resource.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
name	string	No	No	Name. There is no special format requirement.
material	Material	No	No	Material.
aabb	Aabb	Yes	No	Axis aligned bounding box.

Morpher²⁰⁺

Defines the deformation of 3D models by adjusting the weights of different deformation targets to create dynamic effects.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
targets	Record<string, number>	Yes	No	Used to store the names and weights of deformation targets. The weight value is usually within the range of [0.0, 1.0].

Mesh

Mesh resource, which inherits from SceneResource.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
subMeshes	SubMesh[]	Yes	No	Array of sub-meshes.
aabb	Aabb	Yes	No	Axis aligned bounding box.
materialOverride	Material	No	Yes	Material. The default value is undefined.

MeshResource¹⁸⁺

Mesh resource, which inherits from SceneResource.

System capability: SystemCapability.ArkUi.Graphics3D

Animation

Animation resource, which inherits from SceneResource.

Properties

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
enabled	boolean	No	No	Whether the animation is enabled. true if enabled, false otherwise.
speed20+	number	No	Yes	Playback speed factor of the animation. The default value is 1.0, indicating that the animation is played at normal speed. If the value is negative, the animation plays in reverse.
duration	number	Yes	No	Animation duration, in seconds. The value must be greater than or equal to 0.
running	boolean	Yes	No	Whether the animation is running. true if running, false otherwise.
progress	number	Yes	No	Playing progress of the animation. The value range is [0, 1].

onFinished

onFinished(callback: Callback<void>): void

Called when the animation playback is complete or the finish API is called.

System capability: SystemCapability.ArkUi.Graphics3D

Parameters

Name	Type	Mandatory	Description
callback	Callback<void>	Yes	Callback function. The return value is null.

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function onFinished(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Register a callback.
      anim.onFinished(()=>{
        console.info("onFinished");  
      });
    }
  });
}

onStarted

onStarted(callback: Callback<void>): void

Called when the animation starts to play. The start operation is triggered by calling start or restart.

Parameters

Name	Type	Mandatory	Description
callback	Callback<void>	Yes	Callback function. The return value is null.

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function onStarted(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Register a callback.
      anim.onStarted(()=>{
        console.info("onStarted");  
      });
    }
  });
}

pause

pause(): void

Pauses the animation. The animation remains in the current playing progress.

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function pause(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Pause the animation.
      anim.pause();
    }
  });
}

restart

restart(): void

Plays the animation from the beginning.

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function restart(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Restart the animation.
      anim.restart();
    }
  });
}

seek

seek(position: number): void

Plays the animation from the specified position.

System capability: SystemCapability.ArkUi.Graphics3D

Parameters

Name	Type	Mandatory	Description
position	number	Yes	Position from which the animation playback starts. The value range is [0, 1].

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function seek(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Set the animation playback progress to 10%.
      anim.seek(0.1);
    }
  });
}

start

start(): void

Plays the animation based on the current progress.

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function start(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Start the animation.
      anim.start();
    }
  });
}

stop

stop(): void

Stops playing the animation and sets its progress to 0 (not started).

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function stop(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Stop playing the animation and set its progress to 0 (not started).
      anim.stop();
    }
  });
}

finish

finish(): void

Finishes the playing of the animation and sets its progress of 1 (finished).

System capability: SystemCapability.ArkUi.Graphics3D

Example

import { Animation, Scene } from '@kit.ArkGraphics3D';

function finish(): void {
  // Load scene resources, which supports .gltf and .glb formats. The path and file name can be customized based on the specific project resources.
  let scene: Promise<Scene> = Scene.load($rawfile("gltf/CubeWithFloor/glTF/AnimatedCube.glb"));
  scene.then(async (result: Scene) => {
    if (result && result.animations && result.animations[0]) {
      let anim: Animation = result.animations[0];
      // Finish the playing of the animation and set its progress of **1** (finished).
      anim.finish();
    }
  });
}

EnvironmentBackgroundType

Enumerates the environment background types, which are used to define how the background of a scene is presented.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Value	Description
BACKGROUND_NONE	0	No background.
BACKGROUND_IMAGE	1	Image background.
BACKGROUND_CUBEMAP	2	Cubemap background.
BACKGROUND_EQUIRECTANGULAR	3	Equirectangular projection background.

Environment

Environment resource, which inherits from SceneResource.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
backgroundType	EnvironmentBackgroundType	No	No	Environment background type.
indirectDiffuseFactor	Vec4	No	No	Indirect diffuse factor.
indirectSpecularFactor	Vec4	No	No	Indirect specular factor.
environmentMapFactor	Vec4	No	No	Environment map factor.
environmentImage	Image | null	No	Yes	Environment image. The default value is undefined.
radianceImage	Image | null	No	Yes	Radiance image. The default value is undefined.
irradianceCoefficients	Vec3[]	No	Yes	Irradiance coefficients. The default value is undefined.
environmentRotation23+	Quaternion	No	Yes	Rotation of the ambient light. The default value is undefined. The parameter must be a normalized quaternion.

Image

Image resource, which inherits from SceneResource.

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
width	number	Yes	No	Image width, in px. The value must be greater than 0.
height	number	Yes	No	Image height, in px. The value must be greater than 0.

Effect²¹⁺

Effect resource, which inherits from SceneResource. It is obtained from the createEffect API.

Properties

System capability: SystemCapability.ArkUi.Graphics3D

Name	Type	Read Only	Optional	Description
enabled	boolean	No	No	Enabled status of the effect. true if enabled, false otherwise.
effectId	string	Yes	No	Effect ID, which is in the format of 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', for example, 'e68a7f45-2d21-4a0d-9aef-7d9c825d3f12'. It is used to create an effect.

getPropertyValue²³⁺

getPropertyValue(propertyName: string): Object | null | undefined

Obtains the value of the specified effect property.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.ArkUi.Graphics3D

Parameters

Name	Type	Mandatory	Description
propertyName	string	Yes	Name of a specified effect property. Currently, the following strings are supported: -'exposure': exposure level of an image. -'vibrance': natural saturation of an image.

Return value

Type	Description
Object | null | undefined	Effect property value. If the value fails to be obtained, null is returned.

Example

import { SceneResourceFactory, Scene, Effect, EffectParameters } from '@kit.ArkGraphics3D';

function getEffectProperty() {
  let scene: Promise<Scene> = Scene.load();
  scene.then(async (result: Scene | undefined) => {
    if (!result) {
      return;
    }
    let sceneFactory: SceneResourceFactory = result.getResourceFactory();
    // Effect ID, which is in the format of 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', for example, 'e68a7f45-2d21-4a0d-9aef-7d9c825d3f12'.
    let params: EffectParameters = {effectId: "e68a7f45-2d21-4a0d-9aef-7d9c825d3f12"};
    let effect: Effect = await sceneFactory.createEffect(params);
    effect.getPropertyValue('exposure');
  });
}

setPropertyValue²³⁺

setPropertyValue(propertyName: string, value: Object | undefined): boolean

Sets the value of a specified effect property.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.ArkUi.Graphics3D

Parameters

Name	Type	Mandatory	Description
propertyName	string	Yes	Name of a specified effect property. Currently, the following strings are supported: -'exposure': exposure level of an image. -'vibrance': natural saturation of an image.
value	Object | undefined	Yes	Value of the effect property to set. -'exposure': The value is of the number type. The recommended value range is [-5, 5]. A larger value indicates a brighter image. -'vibrance': The value is of the number type. The recommended value range is [-1, 1]. A larger value indicates more vivid image colors.

Return value

Type	Description
boolean	Whether the operation of setting the effect property value is successful. true indicates that the setting is successful, and false indicates that the setting fails.

Example

import { SceneResourceFactory, Scene, Effect, EffectParameters } from '@kit.ArkGraphics3D';

function setEffectProperty() {
  let scene: Promise<Scene> = Scene.load();
  scene.then(async (result: Scene | undefined) => {
    if (!result) {
      return;
    }
    let sceneFactory: SceneResourceFactory = result.getResourceFactory();
    // Effect ID, which is in the format of 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', for example, 'e68a7f45-2d21-4a0d-9aef-7d9c825d3f12'.
    let params: EffectParameters = {effectId: "e68a7f45-2d21-4a0d-9aef-7d9c825d3f12"};
    let effect: Effect = await sceneFactory.createEffect(params);
    effect.setPropertyValue('exposure', 1);
  });
}