Esc

Gltf_Volume

structextensionsince 0.36.1Source
  • macOS: Gltf_Volume works on macOS
  • Linux: Gltf_Volume works on Linux
  • Windows: Gltf_Volume works on Windows
  • Wasm: Gltf_Volume works on Wasm

Declaration

Gltf_Volume :: struct @json(rename_all=camelCase) {
    thickness_factor: float32 = 0.0; @json(default)    thickness_texture: *Gltf_Texture_Info; @json(default,skip_serializing_if=null)    attenuation_distance: Json_Maybe(float32);    attenuation_color: [3] float32 = .[1, 1, 1]; @json(default)    extras: Json_Value; @json(default,skip_serializing_if=null)}

KHR_materials_volume: the thickness of a transmissive surface and how light fades inside it. Read it from material.extensions. attenuation_distance is unset when light does not fade (the glTF default is infinity, which JSON cannot write). The texture is allocated: release the value with free_json.

Example↗
#import "Extensions/Json";

asset, error := gltf_load("{\"asset\":{\"version\":\"2.0\"},\"extensionsUsed\":[\"KHR_materials_volume\"],\"materials\":[{\"extensions\":{\"KHR_materials_volume\":{\"thicknessFactor\":0.5,\"attenuationDistance\":2,\"attenuationColor\":[0.2,0.9,0.4]}}}]}");
assert(error.kind == .NONE);
defer gltf_free(*asset);
volume, found, _ := gltf_extension(*asset.document.materials[0].extensions, "KHR_materials_volume", Gltf_Volume);
assert(found && volume.thickness_factor == 0.5 && volume.attenuation_distance.state == .SET && volume.attenuation_distance.value == 2);
free_json(*volume);

See also