iridia-dxil 0.5.0

Translate Direct3D Shader Model 6 bytecode (DXIL, dxc output) to naga modules, for WGSL or SPIR-V output
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

//! How many arguments each `dx.op` the lifter carries is called with, the opcode among them. The call's callee fixes the
//! count (`dx.op.unary.f32` takes the opcode and one value), and the opcode picks the operation: a program whose opcode
//! and callee disagree is not a DXIL program, and the lifter reads an operation's arguments by position, so the count is
//! checked once, before the operation is dispatched.
//!
//! The counts are DXC's own: `utils/hct/hctdb.py` of DirectXShaderCompiler (revision 55a61aa, 2026-09-29) defines each
//! operation's parameter list, the return value first and the opcode second, so an operation's arguments are its
//! parameters less the return value. The table below is those counts for the operations the lifter dispatches; every one
//! also equals the count the 69,826 modules of the real-data shader corpora (see `tests/inputs/README.md`) and the committed fixtures call it with (those that call
//! it: 150 of the 177), and the operations none of them calls (41 to 45, `Fma`, `LoadOutputControlPoint`, some of the mesh
//! and ray query operations, `IsNormal` and the hyperbolic functions) are only DXC's word.
#![deny(
    clippy::arithmetic_side_effects,
    clippy::indexing_slicing,
    clippy::cast_possible_truncation
)]

/// The number of arguments (the opcode included) of the `dx.op` with this opcode, if the lifter carries it.
pub(crate) fn arguments(code: u64) -> Option<usize> {
    Some(match code {
        90 | 96 | 100 | 107..=108 | 110..=112 | 141..=144 | 153..=156 | 161 | 170 | 213 => 1,
        6..=34
        | 80
        | 82..=86
        | 93..=95
        | 97..=99
        | 105
        | 113..=116
        | 118
        | 130..=131
        | 135..=136
        | 145..=150
        | 160
        | 178
        | 180..=182
        | 184..=185
        | 190..=192
        | 195
        | 198..=204
        | 207..=210
        | 214..=215 => 2,
        35..=45
        | 59
        | 70
        | 72
        | 75
        | 117
        | 120
        | 122..=123
        | 151..=152
        | 159
        | 168
        | 183
        | 193..=194
        | 196..=197
        | 205..=206
        | 211..=212
        | 216 => 3,
        46..=49 | 68 | 104 | 119 | 121 | 158 | 186..=189 | 217..=218 => 4,
        4..=5 | 54 | 57 | 103 | 106 | 169 | 173 => 5,
        139 | 171..=172 => 6,
        55 | 78..=79 => 7,
        56 | 66 | 69 => 9,
        67 | 73 | 140 => 10,
        60 | 62 | 65 | 74 => 11,
        61 | 64 => 12,
        179 => 13,
        157 => 16,
        63 => 17,
        _ => return None,
    })
}