molgfx-render 0.3.4

The render graph, passes and the engine that drives a frame.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

//! Validation and fixed-buffer construction for paged structure residency.

use super::{
    ChunkPlacementError, ChunkResidencyError, InstanceChunkPlacement, PointChunkPlacement,
    RelationChunkPlacement, StructureChunkPlacement,
};
use hashbrown::HashSet;
use molgfx_gpu::{BufferDesc, BufferUsage, Device};

pub(super) fn create_coordinate_buffer<D: Device>(
    device: &D,
    size: u64,
    label: &'static str,
) -> Result<D::Buffer, ChunkResidencyError> {
    Ok(device.create_buffer(&BufferDesc {
        label,
        size,
        usage: BufferUsage::STORAGE.union(BufferUsage::COPY_DST),
    })?)
}

pub(super) fn validate_instance_placements(
    placements: &[InstanceChunkPlacement],
    capacity: usize,
) -> Result<(), ChunkPlacementError> {
    if placements.len() > capacity {
        return Err(ChunkPlacementError::Capacity { capacity });
    }
    let mut identities = HashSet::with_capacity(placements.len());
    for placement in placements {
        if !identities.insert(placement.id()) {
            return Err(ChunkPlacementError::DuplicateIdentity {
                id: placement.id().get(),
            });
        }
    }
    Ok(())
}

pub(super) fn validate_relation_placements(
    placements: &[RelationChunkPlacement],
    capacity: usize,
) -> Result<(), ChunkPlacementError> {
    if placements.len() > capacity {
        return Err(ChunkPlacementError::Capacity { capacity });
    }
    let mut identities = HashSet::with_capacity(placements.len());
    for placement in placements {
        if !identities.insert(placement.id()) {
            return Err(ChunkPlacementError::DuplicateIdentity {
                id: placement.id().get(),
            });
        }
    }
    Ok(())
}

pub(super) fn create_cluster_buffer<D: Device>(
    device: &D,
    size: u64,
) -> Result<D::Buffer, ChunkResidencyError> {
    Ok(device.create_buffer(&BufferDesc {
        label: "resident structure chunk clusters",
        size,
        usage: BufferUsage::STORAGE.union(BufferUsage::COPY_DST),
    })?)
}

pub(super) fn cluster_capacity(
    bytes: u64,
    machine_capacity: usize,
) -> Result<u32, ChunkResidencyError> {
    let rows = bytes / 16;
    let clusters = rows.div_ceil(64).saturating_add(
        u64::try_from(machine_capacity).map_err(|_| ChunkResidencyError::SizeOverflow)?,
    );
    u32::try_from(clusters).map_err(|_| ChunkResidencyError::LocalAddressOverflow)
}

pub(super) fn local_offset<T>(bytes: u64) -> Result<u32, ChunkResidencyError> {
    let stride = std::mem::size_of::<T>() as u64;
    if !bytes.is_multiple_of(stride) {
        return Err(ChunkResidencyError::LocalAddressOverflow);
    }
    u32::try_from(bytes / stride).map_err(|_| ChunkResidencyError::LocalAddressOverflow)
}

pub(super) fn validate_placements(
    placements: &[StructureChunkPlacement],
    capacity: usize,
) -> Result<(), ChunkPlacementError> {
    if placements.len() > capacity {
        return Err(ChunkPlacementError::Capacity { capacity });
    }
    let mut identities = HashSet::with_capacity(placements.len());
    for placement in placements {
        if !placement.model_to_world.is_finite() {
            return Err(ChunkPlacementError::NonFiniteTransform);
        }
        if !identities.insert(placement.id) {
            return Err(ChunkPlacementError::DuplicateIdentity {
                id: placement.id.get(),
            });
        }
    }
    Ok(())
}

pub(super) fn validate_point_placements(
    placements: &[PointChunkPlacement],
    capacity: usize,
) -> Result<(), ChunkPlacementError> {
    if placements.len() > capacity {
        return Err(ChunkPlacementError::Capacity { capacity });
    }
    let mut identities = HashSet::with_capacity(placements.len());
    for placement in placements {
        if !placement.model_to_world().is_finite() {
            return Err(ChunkPlacementError::NonFiniteTransform);
        }
        if !identities.insert(placement.id()) {
            return Err(ChunkPlacementError::DuplicateIdentity {
                id: placement.id().get(),
            });
        }
    }
    Ok(())
}