Struct screen_13::driver::accel_struct::AccelerationStructure
source · [−]pub struct AccelerationStructure {
pub buffer: Buffer,
pub info: AccelerationStructureInfo,
/* private fields */
}Expand description
Smart pointer handle to an acceleration structure object.
Also contains the backing buffer and information about the object.
Deref behavior
AccelerationStructure automatically dereferences to vk::AccelerationStructureKHR (via the
Deref trait), so you can call vk::AccelerationStructureKHR’s methods on a value of
type AccelerationStructure. To avoid name clashes with vk::AccelerationStructureKHR’s
methods, the methods of AccelerationStructure itself are associated functions, called using
fully qualified syntax:
let addr = AccelerationStructure::device_address(&my_accel_struct);Fields
buffer: BufferBacking storage buffer for this object.
info: AccelerationStructureInfoInformation used to create this object.
Implementations
sourceimpl AccelerationStructure
impl AccelerationStructure
sourcepub fn create(
device: &Arc<Device>,
info: impl Into<AccelerationStructureInfo>
) -> Result<Self, DriverError>
pub fn create(
device: &Arc<Device>,
info: impl Into<AccelerationStructureInfo>
) -> Result<Self, DriverError>
Creates a new acceleration structure on the given device.
Examples
Basic usage:
const SIZE: vk::DeviceSize = 1024;
let info = AccelerationStructureInfo::new_blas(SIZE);
let accel_struct = AccelerationStructure::create(&device, info)?;
assert_ne!(*accel_struct, vk::AccelerationStructureKHR::null());
assert_eq!(accel_struct.info.size, SIZE);sourcepub fn access(this: &Self, next_access: AccessType) -> AccessType
pub fn access(this: &Self, next_access: AccessType) -> AccessType
Keeps track of some next_access which affects this object.
Returns the previous access for which a pipeline barrier should be used to prevent data corruption.
Note
Used to maintain object state when passing a Screen 13-created
vk::AccelerationStructureKHR handle to external code such as Ash or Erupt
bindings.
Examples
Basic usage:
// Initially we want to "Build Write"
let next = AccessType::AccelerationStructureBuildWrite;
let prev = AccelerationStructure::access(&my_accel_struct, next);
assert_eq!(prev, AccessType::Nothing);
// External code may now "Build Write"; no barrier required
// Subsequently we want to "Build Read"
let next = AccessType::AccelerationStructureBuildRead;
let prev = AccelerationStructure::access(&my_accel_struct, next);
assert_eq!(prev, AccessType::AccelerationStructureBuildWrite);
// A barrier on "Build Write" before "Build Read" is required!sourcepub fn device_address(this: &Self) -> DeviceAddress
pub fn device_address(this: &Self) -> DeviceAddress
Returns the device address of this object.
Examples
Basic usage:
let addr = AccelerationStructure::device_address(&my_accel_struct);
assert_ne!(addr, 0);sourcepub fn instance_slice<'a>(
instance: AccelerationStructureInstanceKHR
) -> &'a [u8]ⓘNotable traits for &[u8]impl Read for &[u8]impl Write for &mut [u8]
pub fn instance_slice<'a>(
instance: AccelerationStructureInstanceKHR
) -> &'a [u8]ⓘNotable traits for &[u8]impl Read for &[u8]impl Write for &mut [u8]
Helper function which is used to prepare instance buffers.
sourcepub fn size_of(
device: &Arc<Device>,
info: &AccelerationStructureGeometryInfo
) -> AccelerationStructureSize
pub fn size_of(
device: &Arc<Device>,
info: &AccelerationStructureGeometryInfo
) -> AccelerationStructureSize
Returns the size of some geometry info which is then used to create a new AccelerationStructure instance or update an existing instance.
Examples
Basic usage:
let my_info = AccelerationStructureGeometryInfo {
ty: vk::AccelerationStructureTypeKHR::BOTTOM_LEVEL,
flags: vk::BuildAccelerationStructureFlagsKHR::empty(),
geometries: vec![AccelerationStructureGeometry {
max_primitive_count: 1,
flags: vk::GeometryFlagsKHR::OPAQUE,
geometry: my_geom,
}],
};
let res = AccelerationStructure::size_of(&device, &my_info);
assert_eq!(res.create_size, 2432);
assert_eq!(res.build_size, 640);
assert_eq!(res.update_size, 0);