C Specification

The XrSoundObstacleMaterialConfigBD structure is defined as:

// Provided by XR_BD_spatial_audio_rendering
typedef struct XrSoundObstacleMaterialConfigBD {
    XrStructureType                  type;
    const void*                      next;
    XrSoundObstacleMaterialTypeBD    materialType;
    uint32_t                         bandCount;
    float*                           bandFrequencies;
    float*                           bandAbsorptions;
    float*                           bandScatterings;
    float*                           bandTransmissions;
} XrSoundObstacleMaterialConfigBD;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain. No such structures are defined in core OpenXR or this extension.

  • materialType is the XrSoundObstacleMaterialTypeBD of sound obstacle.

  • bandCount is the number of bands for which frequencies, absorptions, scatterings, and transmissions are defined below. This field and its associated arrays in subsequent fields are ignored if materialType is not XR_SOUND_OBSTACLE_MATERIAL_TYPE_CUSTOM_BD.

  • bandFrequencies is an array of bandCount frequency centers of the frequency bands for custom materials.

  • bandAbsorptions is an array of bandCount absorption values: the ratio of absorbed sound energy of the sound obstacle when a reflection happens, in the range (0, 1) for custom materials.

  • bandScatterings is an array of bandCount scattering values: the ratio of scattered sound energy of the sound obstacle when a reflection happens, in the range (0, 1) for custom materials.

  • bandTransmissions is an array of bandCount transmission values: the ratio of transmitted sound energy of the sound obstacle when a reflection happens, in the range (0, 1) for custom materials.

Description

Applications use XrSoundObstacleMaterialConfigBD to configure the material properties of an XrSoundObstacleMaterialBD.

Valid Usage (Implicit)

  • The XR_BD_spatial_audio_rendering extension must be enabled prior to using XrSoundObstacleMaterialConfigBD

  • type must be XR_TYPE_SOUND_OBSTACLE_MATERIAL_CONFIG_BD

  • next must be NULL or a valid pointer to the next structure in a structure chain

  • materialType must be a valid XrSoundObstacleMaterialTypeBD value

  • bandFrequencies must be a pointer to an array of bandCount float values

  • bandAbsorptions must be a pointer to an array of bandCount float values

  • bandScatterings must be a pointer to an array of bandCount float values

  • bandTransmissions must be a pointer to an array of bandCount float values

  • The bandCount parameter must be greater than 0

See Also

XR_BD_spatial_audio_rendering, XrSoundObstacleMaterialTypeBD, XrStructureType, xrCreateSoundObstacleMaterialBD, xrUpdateSoundObstacleMaterialConfigBD

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2026 The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.