dawn.json

{
    "_comment": [
        "Copyright 2017 The Dawn Authors",
        "",
        "Licensed under the Apache License, Version 2.0 (the \"License\");",
        "you may not use this file except in compliance with the License.",
        "You may obtain a copy of the License at",
        "",
        "    http://www.apache.org/licenses/LICENSE-2.0",
        "",
        "Unless required by applicable law or agreed to in writing, software",
        "distributed under the License is distributed on an \"AS IS\" BASIS,",
        "WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.",
        "See the License for the specific language governing permissions and",
        "limitations under the License."
    ],
    "address mode": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "repeat"},
            {"value": 1, "name": "mirror repeat"},
            {"value": 2, "name": "clamp to edge"}
        ]
    },
    "bind group": {
        "category": "object"
    },
    "bind group binding": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "binding", "type": "uint32_t"},
            {"name": "buffer", "type": "buffer", "optional": true},
            {"name": "offset", "type": "uint64_t", "default": "0"},
            {"name": "size", "type": "uint64_t"},
            {"name": "sampler", "type": "sampler", "optional": true},
            {"name": "texture view", "type": "texture view", "optional": true}
        ]
    },
    "bind group descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "layout", "type": "bind group layout"},
            {"name": "binding count", "type": "uint32_t"},
            {"name": "bindings", "type": "bind group binding", "annotation": "const*", "length": "binding count"}
        ]
    },
    "bind group layout": {
        "category": "object"
    },
    "bind group layout binding": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "binding", "type": "uint32_t"},
            {"name": "visibility", "type": "shader stage"},
            {"name": "type", "type": "binding type"},
            {"name": "has dynamic offset", "type": "bool", "default": "false"},
            {"name": "multisampled", "type": "bool", "default": "false"},
            {"name": "texture dimension", "type": "texture view dimension", "default": "undefined"},
            {"name": "texture component type", "type": "texture component type", "default": "float"}
        ]
    },
    "bind group layout descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "binding count", "type": "uint32_t"},
            {"name": "bindings", "type": "bind group layout binding", "annotation": "const*", "length": "binding count"}
        ]
    },
    "binding type": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "uniform buffer"},
            {"value": 1, "name": "storage buffer"},
            {"value": 2, "name": "readonly storage buffer"},
            {"value": 3, "name": "sampler"},
            {"value": 4, "name": "sampled texture"},
            {"value": 5, "name": "storage texture"}
        ]
    },
    "blend descriptor": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "operation", "type": "blend operation", "default": "add"},
            {"name": "src factor", "type": "blend factor", "default": "one"},
            {"name": "dst factor", "type": "blend factor", "default": "zero"}
        ]
    },
    "blend factor": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "zero"},
            {"value": 1, "name": "one"},
            {"value": 2, "name": "src color"},
            {"value": 3, "name": "one minus src color"},
            {"value": 4, "name": "src alpha"},
            {"value": 5, "name": "one minus src alpha"},
            {"value": 6, "name": "dst color"},
            {"value": 7, "name": "one minus dst color"},
            {"value": 8, "name": "dst alpha"},
            {"value": 9, "name": "one minus dst alpha"},
            {"value": 10, "name": "src alpha saturated"},
            {"value": 11, "name": "blend color"},
            {"value": 12, "name": "one minus blend color"}
        ]
    },
    "blend operation": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "add"},
            {"value": 1, "name": "subtract"},
            {"value": 2, "name": "reverse subtract"},
            {"value": 3, "name": "min"},
            {"value": 4, "name": "max"}
        ]
    },
    "color state descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "format", "type": "texture format"},
            {"name": "alpha blend", "type": "blend descriptor"},
            {"name": "color blend", "type": "blend descriptor"},
            {"name": "write mask", "type": "color write mask", "default": "all"}
        ]
    },
    "bool": {
        "category": "native"
    },
    "buffer": {
        "category": "object",
        "methods": [
            {
                "name": "set sub data",
                "args": [
                    {"name": "start", "type": "uint64_t"},
                    {"name": "count", "type": "uint64_t"},
                    {"name": "data", "type": "void", "annotation": "const*", "length": "count"}
                ]
            },
            {
                "name": "map read async",
                "args": [
                    {"name": "callback", "type": "buffer map read callback"},
                    {"name": "userdata", "type": "void", "annotation": "*"}
                ]
            },
            {
                "name": "map write async",
                "args": [
                    {"name": "callback", "type": "buffer map write callback"},
                    {"name": "userdata", "type": "void", "annotation": "*"}
                ]
            },
            {
                "name": "unmap"
            },
            {
                "name": "destroy"
            }
        ]
    },
    "buffer create mapped callback": {
        "category": "natively defined"
    },
    "buffer copy view": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "buffer", "type": "buffer"},
            {"name": "offset", "type": "uint64_t", "default": 0},
            {"name": "row pitch", "type": "uint32_t"},
            {"name": "image height", "type": "uint32_t"}
        ]
    },
    "buffer descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "usage", "type": "buffer usage"},
            {"name": "size", "type": "uint64_t"}
        ]
    },
    "buffer map read callback": {
        "category": "natively defined"
    },
    "buffer map write callback": {
        "category": "natively defined"
    },
    "buffer map async status": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "success"},
            {"value": 1, "name": "error"},
            {"value": 2, "name": "unknown"},
            {"value": 3, "name": "device lost"}
        ]
    },
    "buffer usage": {
        "category": "bitmask",
        "values": [
            {"value": 0, "name": "none"},
            {"value": 1, "name": "map read"},
            {"value": 2, "name": "map write"},
            {"value": 4, "name": "copy src"},
            {"value": 8, "name": "copy dst"},
            {"value": 16, "name": "index"},
            {"value": 32, "name": "vertex"},
            {"value": 64, "name": "uniform"},
            {"value": 128, "name": "storage"},
            {"value": 256, "name": "indirect"}
        ]
    },
    "char": {
        "category": "native"
    },
    "create buffer mapped result": {
        "category": "structure",
        "members": [
            {"name": "buffer", "type": "buffer"},
            {"name": "data length", "type": "uint64_t"},
            {"name": "data", "type": "void", "annotation": "*", "length": "data length"}
        ]
    },
    "color": {
        "category": "structure",
        "members": [
            {"name": "r", "type": "float"},
            {"name": "g", "type": "float"},
            {"name": "b", "type": "float"},
            {"name": "a", "type": "float"}
        ]
    },
    "color write mask": {
        "category": "bitmask",
        "values": [
            {"value": 0, "name": "none"},
            {"value": 1, "name": "red"},
            {"value": 2, "name": "green"},
            {"value": 4, "name": "blue"},
            {"value": 8, "name": "alpha"},
            {"value": 15, "name": "all"}
        ]
    },
    "command buffer": {
        "category": "object"
    },
    "command buffer descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true}
        ]
    },
    "command encoder": {
        "category": "object",
        "methods": [
            {
                "name": "finish",
                "returns": "command buffer",
                "args": [
                    {"name": "descriptor", "type": "command buffer descriptor", "annotation": "const*", "optional": true}
                ]
            },
            {
                "name": "begin compute pass",
                "returns": "compute pass encoder",
                "args": [
                    {"name": "descriptor", "type": "compute pass descriptor", "annotation": "const*", "optional": true}
                ]
            },
            {
                "name": "begin render pass",
                "returns": "render pass encoder",
                "args": [
                    {"name": "descriptor", "type": "render pass descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "copy buffer to buffer",
                "args": [
                    {"name": "source", "type": "buffer"},
                    {"name": "source offset", "type": "uint64_t"},
                    {"name": "destination", "type": "buffer"},
                    {"name": "destination offset", "type": "uint64_t"},
                    {"name": "size", "type": "uint64_t"}
                ],
                "TODO": [
                    "Restrictions on the alignment of the copy? Cf Metal on OSX"
                ]
            },
            {
                "name": "copy buffer to texture",
                "args": [
                    {"name": "source", "type": "buffer copy view", "annotation": "const*"},
                    {"name": "destination", "type": "texture copy view", "annotation": "const*"},
                    {"name": "copy size", "type": "extent 3D", "annotation": "const*"}
                ]
            },
            {
                "name": "copy texture to buffer",
                "args": [
                    {"name": "source", "type": "texture copy view", "annotation": "const*"},
                    {"name": "destination", "type": "buffer copy view", "annotation": "const*"},
                    {"name": "copy size", "type": "extent 3D", "annotation": "const*"}
                ]
            },
            {
                "name": "copy texture to texture",
                "args": [
                    {"name": "source", "type": "texture copy view", "annotation": "const*"},
                    {"name": "destination", "type": "texture copy view", "annotation": "const*"},
                    {"name": "copy size", "type": "extent 3D", "annotation": "const*"}
                ]
            },
            {
                "name": "insert debug marker",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "pop debug group",
                "args": []
            },
            {
                "name": "push debug group",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            }
        ]
    },
    "command encoder descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true}
        ]
    },
    "compare function": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "never"},
            {"value": 1, "name": "less"},
            {"value": 2, "name": "less equal"},
            {"value": 3, "name": "greater"},
            {"value": 4, "name": "greater equal"},
            {"value": 5, "name": "equal"},
            {"value": 6, "name": "not equal"},
            {"value": 7, "name": "always"}
        ]
    },
    "compute pass descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true}
        ]
    },
    "compute pass encoder": {
        "category": "object",
        "methods": [
            {
                "name": "insert debug marker",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "pop debug group",
                "args": []
            },
            {
                "name": "push debug group",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "set pipeline",
                "args": [
                    {"name": "pipeline", "type": "compute pipeline"}
                ]
            },
            {
                "name": "set bind group",
                "args": [
                    {"name": "group index", "type": "uint32_t"},
                    {"name": "group", "type": "bind group"},
                    {"name": "dynamic offset count", "type": "uint32_t", "default": "0"},
                    {"name": "dynamic offsets", "type": "uint32_t", "annotation": "const*", "length": "dynamic offset count", "optional": true}
                ]
            },
            {
                "name": "dispatch",
                "args": [
                    {"name": "x", "type": "uint32_t"},
                    {"name": "y", "type": "uint32_t", "default": "1"},
                    {"name": "z", "type": "uint32_t", "default": "1"}
                ]
            },
            {
                "name": "dispatch indirect",
                "args": [
                  {"name": "indirect buffer", "type": "buffer"},
                  {"name": "indirect offset", "type": "uint64_t"}
                ]
            },
            {
                "name": "end pass"
            }
        ]
    },
    "compute pipeline": {
        "category": "object"
    },
    "compute pipeline descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "layout", "type": "pipeline layout"},
            {"name": "compute stage", "type": "programmable stage descriptor"}
        ]
    },
    "cull mode": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "none"},
            {"value": 1, "name": "front"},
            {"value": 2, "name": "back"}
        ]
    },
    "device": {
        "category": "object",
        "methods": [
            {
                "name": "create bind group",
                "returns": "bind group",
                "args": [
                    {"name": "descriptor", "type": "bind group descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create bind group layout",
                "returns": "bind group layout",
                "args": [
                    {"name": "descriptor", "type": "bind group layout descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create buffer",
                "returns": "buffer",
                "args": [
                    {"name": "descriptor", "type": "buffer descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create buffer mapped",
                "returns": "create buffer mapped result",
                "args": [
                    {"name": "descriptor", "type": "buffer descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create buffer mapped async",
                "args": [
                    {"name": "descriptor", "type": "buffer descriptor", "annotation": "const*"},
                    {"name": "callback", "type": "buffer create mapped callback"},
                    {"name": "userdata", "type": "void", "annotation": "*"}
                ]
            },
            {
                "name": "create command encoder",
                "returns": "command encoder",
                "args": [
                    {"name": "descriptor", "type": "command encoder descriptor", "annotation": "const*", "optional": true}
                ]
            },
            {
                "name": "create compute pipeline",
                "returns": "compute pipeline",
                "args": [
                    {"name": "descriptor", "type": "compute pipeline descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create render pipeline",
                "returns": "render pipeline",
                "args": [
                    {"name": "descriptor", "type": "render pipeline descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create pipeline layout",
                "returns": "pipeline layout",
                "args": [
                    {"name": "descriptor", "type": "pipeline layout descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create queue",
                "returns": "queue"
            },
            {
                "name": "create render bundle encoder",
                "returns": "render bundle encoder",
                "args": [
                    {"name": "descriptor", "type": "render bundle encoder descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create sampler",
                "returns": "sampler",
                "args": [
                    {"name": "descriptor", "type": "sampler descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create shader module",
                "returns": "shader module",
                "args": [
                    {"name": "descriptor", "type": "shader module descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create swap chain",
                "returns": "swap chain",
                "args": [
                    {"name": "descriptor", "type": "swap chain descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "create texture",
                "returns": "texture",
                "args": [
                    {"name": "descriptor", "type": "texture descriptor", "annotation": "const*"}
                ]
            },
            {
                "name": "inject error",
                "args": [
                    {"name": "type", "type": "error type"},
                    {"name": "message", "type": "char", "annotation": "const*", "length": "strlen"}
                ],
                "TODO": "enga@: Make this a Dawn extension"
            },
            {
                "name": "tick"
            },
            {
                "name": "set uncaptured error callback",
                "args": [
                    {"name": "callback", "type": "error callback"},
                    {"name": "userdata", "type": "void", "annotation": "*"}
                ]
            },
            {
                "name": "push error scope",
                "args": [
                    {"name": "filter", "type": "error filter"}
                ]
            },
            {
                "name": "pop error scope",
                "returns": "bool",
                "args": [
                    {"name": "callback", "type": "error callback"},
                    {"name": "userdata", "type": "void", "annotation": "*"}
                ]
            }
        ]
    },
    "device properties": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "texture compression BC", "type": "bool", "default": "false"}
        ]
    },
    "depth stencil state descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "format", "type": "texture format"},
            {"name": "depth write enabled", "type": "bool", "default": "false"},
            {"name": "depth compare", "type": "compare function", "default": "always"},
            {"name": "stencil front", "type": "stencil state face descriptor"},
            {"name": "stencil back", "type": "stencil state face descriptor"},
            {"name": "stencil read mask", "type": "uint32_t", "default": "0xFFFFFFFF"},
            {"name": "stencil write mask", "type": "uint32_t", "default": "0xFFFFFFFF"}
        ]
    },
    "error callback": {
        "category": "natively defined"
    },
    "error filter": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "none"},
            {"value": 1, "name": "validation"},
            {"value": 2, "name": "out of memory"}
        ]
    },
    "error type": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "no error"},
            {"value": 1, "name": "validation"},
            {"value": 2, "name": "out of memory"},
            {"value": 3, "name": "unknown"},
            {"value": 4, "name": "device lost"}
        ]
    },
    "extent 3D": {
        "category": "structure",
        "members": [
            {"name": "width", "type": "uint32_t"},
            {"name": "height", "type": "uint32_t"},
            {"name": "depth", "type": "uint32_t"}
        ]
    },
    "fence": {
        "category": "object",
        "methods": [
            {
                "name": "get completed value",
                "returns": "uint64_t"
            },
            {
                "name": "on completion",
                "args": [
                    {"name": "value", "type": "uint64_t"},
                    {"name": "callback", "type": "fence on completion callback"},
                    {"name": "userdata", "type": "void", "annotation": "*"}
                ]
            }
        ]
    },
    "fence on completion callback": {
        "category": "natively defined"
    },
    "fence completion status": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "success"},
            {"value": 1, "name": "error"},
            {"value": 2, "name": "unknown"},
            {"value": 3, "name": "device lost"}
        ]
    },
    "fence descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "initial value", "type": "uint64_t", "default": "0"}
        ]
    },
    "filter mode": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "nearest"},
            {"value": 1, "name": "linear"}
        ]
    },
    "float": {
        "category": "native"
    },
    "front face": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "CCW"},
            {"value": 1, "name": "CW"}
        ]
    },
    "index format": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "uint16"},
            {"value": 1, "name": "uint32"}
        ]
    },
    "vertex attribute descriptor": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "shader location", "type": "uint32_t"},
            {"name": "offset", "type": "uint64_t", "default": "0"},
            {"name": "format", "type": "vertex format"}
        ]
    },
    "vertex buffer descriptor": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "stride", "type": "uint64_t"},
            {"name": "step mode", "type": "input step mode", "default": "vertex"},
            {"name": "attribute count", "type": "uint32_t"},
            {"name": "attributes", "type": "vertex attribute descriptor", "annotation": "const*", "length": "attribute count"}
        ]
    },
    "vertex input descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "index format", "type": "index format", "default": "uint32"},
            {"name": "buffer count", "type": "uint32_t", "default": 0},
            {"name": "buffers", "type": "vertex buffer descriptor", "annotation": "const*", "length": "buffer count"}
        ]
    },
    "input step mode": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "vertex"},
            {"value": 1, "name": "instance"}
        ]
    },
    "load op": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "clear"},
            {"value": 1, "name": "load"}
        ]
    },
    "store op": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "store"},
            {"value": 1, "name": "clear"}
        ]
    },
    "origin 3D": {
        "category": "structure",
        "members": [
            {"name": "x", "type": "uint32_t", "default": "0"},
            {"name": "y", "type": "uint32_t", "default": "0"},
            {"name": "z", "type": "uint32_t", "default": "0"}
        ]
    },
    "pipeline layout": {
        "category": "object"
    },
    "pipeline layout descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "bind group layout count", "type": "uint32_t"},
            {"name": "bind group layouts", "type": "bind group layout", "annotation": "const*", "length": "bind group layout count"}
        ]
    },
    "programmable stage descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "module", "type": "shader module"},
            {"name": "entry point", "type": "char", "annotation": "const*", "length": "strlen"}
        ]
    },
    "primitive topology": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "point list"},
            {"value": 1, "name": "line list"},
            {"value": 2, "name": "line strip"},
            {"value": 3, "name": "triangle list"},
            {"value": 4, "name": "triangle strip"}
        ]
    },
    "queue": {
        "category": "object",
        "methods": [
            {
                "name": "submit",
                "args": [
                    {"name": "command count", "type": "uint32_t"},
                    {"name": "commands", "type": "command buffer", "annotation": "const*", "length": "command count"}
                ]
            },
            {
                "name": "signal",
                "args": [
                    {"name": "fence", "type": "fence"},
                    {"name": "signal value", "type": "uint64_t"}
                ]
            },
            {
                "name": "create fence",
                "returns": "fence",
                "args": [
                    {"name": "descriptor", "type": "fence descriptor", "annotation": "const*"}
                ]
            }
        ]
    },

    "rasterization state descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "front face", "type": "front face", "default": "CCW"},
            {"name": "cull mode", "type": "cull mode", "default": "none"},
            {"name": "depth bias", "type": "int32_t", "default": "0"},
            {"name": "depth bias slope scale", "type": "float", "default": "0.0f"},
            {"name": "depth bias clamp", "type": "float", "default": "0.0f"}
        ]
    },

    "render bundle": {
        "category": "object"
    },

    "render bundle encoder": {
        "category": "object",
        "methods": [
            {
                "name": "set pipeline",
                "args": [
                    {"name": "pipeline", "type": "render pipeline"}
                ]
            },
            {
                "name": "set bind group",
                "args": [
                    {"name": "group index", "type": "uint32_t"},
                    {"name": "group", "type": "bind group"},
                    {"name": "dynamic offset count", "type": "uint32_t", "default": "0"},
                    {"name": "dynamic offsets", "type": "uint32_t", "annotation": "const*", "length": "dynamic offset count", "optional": true}
                ]
            },
            {
                "name": "draw",
                "args": [
                    {"name": "vertex count", "type": "uint32_t"},
                    {"name": "instance count", "type": "uint32_t"},
                    {"name": "first vertex", "type": "uint32_t"},
                    {"name": "first instance", "type": "uint32_t"}
                ]
            },
            {
                "name": "draw indexed",
                "args": [
                    {"name": "index count", "type": "uint32_t"},
                    {"name": "instance count", "type": "uint32_t"},
                    {"name": "first index", "type": "uint32_t"},
                    {"name": "base vertex", "type": "int32_t"},
                    {"name": "first instance", "type": "uint32_t"}
                ]
            },
            {
              "name": "draw indirect",
              "args": [
                    {"name": "indirect buffer", "type": "buffer"},
                    {"name": "indirect offset", "type": "uint64_t"}
              ]
            },
            {
              "name": "draw indexed indirect",
              "args": [
                    {"name": "indirect buffer", "type": "buffer"},
                    {"name": "indirect offset", "type": "uint64_t"}
              ]
            },
            {
                "name": "insert debug marker",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "pop debug group",
                "args": []
            },
            {
                "name": "push debug group",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "set vertex buffer",
                "args": [
                    {"name": "slot", "type": "uint32_t"},
                    {"name": "buffer", "type": "buffer"},
                    {"name": "offset", "type": "uint64_t", "default": "0"}
                ]
            },
            {
                "name": "set index buffer",
                "args": [
                    {"name": "buffer", "type": "buffer"},
                    {"name": "offset", "type": "uint64_t", "default": "0"}
                ]
            },
            {
                "name": "finish",
                "returns": "render bundle",
                "args": [
                    {"name": "descriptor", "type": "render bundle descriptor", "annotation": "const*", "optional": true}
                ]
            }
        ]
    },

    "render bundle descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true}
        ]
    },

    "render bundle encoder descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "color formats count", "type": "uint32_t"},
            {"name": "color formats", "type": "texture format", "annotation": "const*", "length": "color formats count"},
            {"name": "depth stencil format", "type": "texture format", "default": "undefined"},
            {"name": "sample count", "type": "uint32_t", "default": "1"}
        ]
    },

    "render pass color attachment descriptor": {
        "category": "structure",
        "members": [
            {"name": "attachment", "type": "texture view"},
            {"name": "resolve target", "type": "texture view", "optional": true},
            {"name": "load op", "type": "load op"},
            {"name": "store op", "type": "store op"},
            {"name": "clear color", "type": "color"}
        ]
    },

    "render pass depth stencil attachment descriptor": {
        "category": "structure",
        "members": [
            {"name": "attachment", "type": "texture view"},
            {"name": "depth load op", "type": "load op"},
            {"name": "depth store op", "type": "store op"},
            {"name": "clear depth", "type": "float"},
            {"name": "stencil load op", "type": "load op"},
            {"name": "stencil store op", "type": "store op"},
            {"name": "clear stencil", "type": "uint32_t", "default": "0"}
        ]
    },

    "render pass descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "color attachment count", "type": "uint32_t"},
            {"name": "color attachments", "type": "render pass color attachment descriptor", "annotation": "const*", "length": "color attachment count"},
            {"name": "depth stencil attachment", "type": "render pass depth stencil attachment descriptor", "annotation": "const*", "optional": true}
        ]
    },
    "render pass encoder": {
        "category": "object",
        "methods": [
            {
                "name": "set pipeline",
                "args": [
                    {"name": "pipeline", "type": "render pipeline"}
                ]
            },
            {
                "name": "set bind group",
                "args": [
                    {"name": "group index", "type": "uint32_t"},
                    {"name": "group", "type": "bind group"},
                    {"name": "dynamic offset count", "type": "uint32_t", "default": "0"},
                    {"name": "dynamic offsets", "type": "uint32_t", "annotation": "const*", "length": "dynamic offset count", "optional": true}
                ]
            },
            {
                "name": "draw",
                "args": [
                    {"name": "vertex count", "type": "uint32_t"},
                    {"name": "instance count", "type": "uint32_t"},
                    {"name": "first vertex", "type": "uint32_t"},
                    {"name": "first instance", "type": "uint32_t"}
                ]
            },
            {
                "name": "draw indexed",
                "args": [
                    {"name": "index count", "type": "uint32_t"},
                    {"name": "instance count", "type": "uint32_t"},
                    {"name": "first index", "type": "uint32_t"},
                    {"name": "base vertex", "type": "int32_t"},
                    {"name": "first instance", "type": "uint32_t"}
                ]
            },
            {
              "name": "draw indirect",
              "args": [
                    {"name": "indirect buffer", "type": "buffer"},
                    {"name": "indirect offset", "type": "uint64_t"}
              ]
            },
            {
              "name": "draw indexed indirect",
              "args": [
                    {"name": "indirect buffer", "type": "buffer"},
                    {"name": "indirect offset", "type": "uint64_t"}
              ]
            },
            {
              "name": "execute bundles",
              "args": [
                  {"name": "bundles count", "type": "uint32_t"},
                  {"name": "bundles", "type": "render bundle", "annotation": "const*", "length": "bundles count"}
              ]
            },
            {
                "name": "insert debug marker",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "pop debug group",
                "args": []
            },
            {
                "name": "push debug group",
                "args": [
                    {"name": "group label", "type": "char", "annotation": "const*", "length": "strlen"}
                ]
            },
            {
                "name": "set stencil reference",
                "args": [
                    {"name": "reference", "type": "uint32_t"}
                ]
            },
            {
                "name": "set blend color",
                "args": [
                    {"name": "color", "type": "color", "annotation": "const*"}
                ]
            },
            {
                "name": "set viewport",
                "args": [
                    {"name": "x", "type": "float"},
                    {"name": "y", "type": "float"},
                    {"name": "width", "type": "float"},
                    {"name": "height", "type": "float"},
                    {"name": "min depth", "type": "float"},
                    {"name": "max depth", "type": "float"}
                ]
            },
            {
                "name": "set scissor rect",
                "args": [
                    {"name": "x", "type": "uint32_t"},
                    {"name": "y", "type": "uint32_t"},
                    {"name": "width", "type": "uint32_t"},
                    {"name": "height", "type": "uint32_t"}
                ]
            },
            {
                "name": "set vertex buffer",
                "args": [
                    {"name": "slot", "type": "uint32_t"},
                    {"name": "buffer", "type": "buffer"},
                    {"name": "offset", "type": "uint64_t", "default": "0"}
                ]
            },
            {
                "name": "set index buffer",
                "args": [
                    {"name": "buffer", "type": "buffer"},
                    {"name": "offset", "type": "uint64_t", "default": "0"}
                ]
            },
            {
                "name": "end pass"
            }
        ]
    },
    "render pipeline": {
        "category": "object"
    },
    "render pipeline descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "layout", "type": "pipeline layout"},
            {"name": "vertex stage", "type": "programmable stage descriptor"},
            {"name": "fragment stage", "type": "programmable stage descriptor", "annotation": "const*", "optional": true},
            {"name": "vertex input", "type": "vertex input descriptor", "annotation": "const*", "optional": true},
            {"name": "primitive topology", "type": "primitive topology"},
            {"name": "rasterization state", "type": "rasterization state descriptor", "annotation": "const*", "optional": true},
            {"name": "sample count", "type": "uint32_t", "default": "1"},
            {"name": "depth stencil state", "type": "depth stencil state descriptor", "annotation": "const*", "optional": true},
            {"name": "color state count", "type": "uint32_t"},
            {"name": "color states", "type": "color state descriptor", "annotation": "const*", "length": "color state count"},
            {"name": "sample mask", "type": "uint32_t", "default": "0xFFFFFFFF"},
            {"name": "alpha to coverage enabled", "type": "bool", "default": "false"}
        ]
    },
    "sampler": {
        "category": "object"
    },
    "sampler descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "address mode u", "type": "address mode", "default": "clamp to edge"},
            {"name": "address mode v", "type": "address mode", "default": "clamp to edge"},
            {"name": "address mode w", "type": "address mode", "default": "clamp to edge"},
            {"name": "mag filter", "type": "filter mode", "default": "nearest"},
            {"name": "min filter", "type": "filter mode", "default": "nearest"},
            {"name": "mipmap filter", "type": "filter mode", "default": "nearest"},
            {"name": "lod min clamp", "type": "float", "default": "0.0f"},
            {"name": "lod max clamp", "type": "float", "default": "1000.0f"},
            {"name": "compare", "type": "compare function", "default": "never"}
        ]
    },
    "shader module": {
        "category": "object"
    },
    "shader module descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "code size", "type": "uint32_t"},
            {"name": "code", "type": "uint32_t", "annotation": "const*", "length": "code size"}
        ]
    },
    "shader stage": {
        "category": "bitmask",
        "values": [
            {"value": 0, "name": "none"},
            {"value": 1, "name": "vertex"},
            {"value": 2, "name": "fragment"},
            {"value": 4, "name": "compute"}
        ]
    },
    "stencil operation": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "keep"},
            {"value": 1, "name": "zero"},
            {"value": 2, "name": "replace"},
            {"value": 3, "name": "invert"},
            {"value": 4, "name": "increment clamp"},
            {"value": 5, "name": "decrement clamp"},
            {"value": 6, "name": "increment wrap"},
            {"value": 7, "name": "decrement wrap"}
        ]
    },
    "stencil state face descriptor": {
        "category": "structure",
        "extensible": false,
        "members": [
            {"name": "compare", "type": "compare function", "default": "always"},
            {"name": "fail op", "type": "stencil operation", "default": "keep"},
            {"name": "depth fail op", "type": "stencil operation", "default": "keep"},
            {"name": "pass op", "type": "stencil operation", "default": "keep"}
        ]
    },
    "swap chain": {
        "category": "object",
        "methods": [
            {
                "name": "configure",
                "args": [
                    {"name": "format", "type": "texture format"},
                    {"name": "allowed usage", "type": "texture usage"},
                    {"name": "width", "type": "uint32_t"},
                    {"name": "height", "type": "uint32_t"}
                ]
            },
            {
                "name": "get next texture",
                "returns": "texture"
            },
            {
                "name": "present",
                "args": [
                    {"name": "texture", "type": "texture"}
                ]
            }
        ]
    },
    "swap chain descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "implementation", "type": "uint64_t"}
        ]
    },
    "texture": {
        "category": "object",
        "methods": [
            {
                "name": "create view",
                "returns": "texture view",
                "args": [
                    {"name": "descriptor", "type": "texture view descriptor", "annotation": "const*", "optional": true}
                ]
            },
            {
                "name": "destroy"
            }
        ]
    },
    "texture aspect": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "all"},
            {"value": 1, "name": "stencil only"},
            {"value": 2, "name": "depth only"}
        ]
    },
    "texture component type": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "float"},
            {"value": 1, "name": "sint"},
            {"value": 2, "name": "uint"}
        ]
    },
    "texture copy view": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "texture", "type": "texture"},
            {"name": "mip level", "type": "uint32_t", "default": "0"},
            {"name": "array layer", "type": "uint32_t", "default": "0"},
            {"name": "origin", "type": "origin 3D"}
        ]
    },
    "texture descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "usage", "type": "texture usage"},
            {"name": "dimension", "type": "texture dimension", "default": "2D"},
            {"name": "size", "type": "extent 3D"},
            {"name": "array layer count", "type": "uint32_t", "default": "1"},
            {"name": "format", "type": "texture format"},
            {"name": "mip level count", "type": "uint32_t", "default": 1},
            {"name": "sample count", "type": "uint32_t", "default": 1}
        ]
    },
    "texture dimension": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "1D"},
            {"value": 1, "name": "2D"},
            {"value": 2, "name": "3D"}
        ]
    },
    "texture format": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "undefined", "valid": false},
            {"value": 1, "name": "R8 unorm"},
            {"value": 2, "name": "R8 snorm"},
            {"value": 3, "name": "R8 uint"},
            {"value": 4, "name": "R8 sint"},

            {"value": 5, "name": "R16 uint"},
            {"value": 6, "name": "R16 sint"},
            {"value": 7, "name": "R16 float"},
            {"value": 8, "name": "RG8 unorm"},
            {"value": 9, "name": "RG8 snorm"},
            {"value": 10, "name": "RG8 uint"},
            {"value": 11, "name": "RG8 sint"},

            {"value": 12, "name": "R32 float"},
            {"value": 13, "name": "R32 uint"},
            {"value": 14, "name": "R32 sint"},
            {"value": 15, "name": "RG16 uint"},
            {"value": 16, "name": "RG16 sint"},
            {"value": 17, "name": "RG16 float"},
            {"value": 18, "name": "RGBA8 unorm"},
            {"value": 19, "name": "RGBA8 unorm srgb"},
            {"value": 20, "name": "RGBA8 snorm"},
            {"value": 21, "name": "RGBA8 uint"},
            {"value": 22, "name": "RGBA8 sint"},
            {"value": 23, "name": "BGRA8 unorm"},
            {"value": 24, "name": "BGRA8 unorm srgb"},
            {"value": 25, "name": "RGB10 A2 unorm"},
            {"value": 26, "name": "RG11 B10 float"},

            {"value": 27, "name": "RG32 float"},
            {"value": 28, "name": "RG32 uint"},
            {"value": 29, "name": "RG32 sint"},
            {"value": 30, "name": "RGBA16 uint"},
            {"value": 31, "name": "RGBA16 sint"},
            {"value": 32, "name": "RGBA16 float"},

            {"value": 33, "name": "RGBA32 float"},
            {"value": 34, "name": "RGBA32 uint"},
            {"value": 35, "name": "RGBA32 sint"},

            {"value": 36, "name": "depth32 float"},
            {"value": 37, "name": "depth24 plus"},
            {"value": 38, "name": "depth24 plus stencil8"},

            {"value": 39, "name": "BC1 RGBA unorm"},
            {"value": 40, "name": "BC1 RGBA unorm srgb"},
            {"value": 41, "name": "BC2 RGBA unorm"},
            {"value": 42, "name": "BC2 RGBA unorm srgb"},
            {"value": 43, "name": "BC3 RGBA unorm"},
            {"value": 44, "name": "BC3 RGBA unorm srgb"},
            {"value": 45, "name": "BC4 R unorm"},
            {"value": 46, "name": "BC4 R snorm"},
            {"value": 47, "name": "BC5 RG unorm"},
            {"value": 48, "name": "BC5 RG snorm"},
            {"value": 49, "name": "BC6H RGB ufloat"},
            {"value": 50, "name": "BC6H RGB sfloat"},
            {"value": 51, "name": "BC7 RGBA unorm"},
            {"value": 52, "name": "BC7 RGBA unorm srgb"}
        ]
    },
    "texture usage": {
        "category": "bitmask",
        "values": [
            {"value": 0, "name": "none"},
            {"value": 1, "name": "copy src"},
            {"value": 2, "name": "copy dst"},
            {"value": 4, "name": "sampled"},
            {"value": 8, "name": "storage"},
            {"value": 16, "name": "output attachment"},
            {"value": 32, "name": "present"}
        ]
    },
    "texture view descriptor": {
        "category": "structure",
        "extensible": true,
        "members": [
            {"name": "label", "type": "char", "annotation": "const*", "length": "strlen", "optional": true},
            {"name": "format", "type": "texture format", "default": "undefined"},
            {"name": "dimension", "type": "texture view dimension", "default": "undefined"},
            {"name": "base mip level", "type": "uint32_t", "default": "0"},
            {"name": "mip level count", "type": "uint32_t", "default": "0"},
            {"name": "base array layer", "type": "uint32_t", "default": "0"},
            {"name": "array layer count", "type": "uint32_t", "default": "0"},
            {"name": "aspect", "type": "texture aspect", "default": "all"}
        ],
        "TODO": [
            "jiawei.shao@intel.com: Allow choosing the aspect (depth vs. stencil)"
        ]
    },
    "texture view": {
        "category": "object"
    },
    "texture view dimension": {
        "category": "enum",
        "values": [
            {"value": 0, "name": "undefined", "valid": false},
            {"value": 1, "name": "1D"},
            {"value": 2, "name": "2D"},
            {"value": 3, "name": "2D array"},
            {"value": 4, "name": "cube"},
            {"value": 5, "name": "cube array"},
            {"value": 6, "name": "3D"}
        ],
        "TODO": [
            "jiawei.shao@intel.com: support 1D and 3D texture views"
        ]
    },
    "vertex format": {
        "category": "enum",
        "values": [
            {"value": 0,  "name": "uChar2"},
            {"value": 1,  "name": "uChar4"},
            {"value": 2,  "name": "char2"},
            {"value": 3,  "name": "char4"},
            {"value": 4,  "name": "uChar2 norm"},
            {"value": 5, "name": "uChar4 norm"},
            {"value": 6, "name": "char2 norm"},
            {"value": 7, "name": "char4 norm"},
            {"value": 8, "name": "uShort2"},
            {"value": 9, "name": "uShort4"},
            {"value": 10, "name": "short2"},
            {"value": 11, "name": "short4"},
            {"value": 12, "name": "uShort2 norm"},
            {"value": 13, "name": "uShort4 norm"},
            {"value": 14, "name": "short2 norm"},
            {"value": 15, "name": "short4 norm"},
            {"value": 16, "name": "half2"},
            {"value": 17, "name": "half4"},
            {"value": 18, "name": "float"},
            {"value": 19, "name": "float2"},
            {"value": 20, "name": "float3"},
            {"value": 21, "name": "float4"},
            {"value": 22, "name": "uInt"},
            {"value": 23, "name": "uInt2"},
            {"value": 24, "name": "uInt3"},
            {"value": 25, "name": "uInt4"},
            {"value": 26, "name": "int"},
            {"value": 27, "name": "int2"},
            {"value": 28, "name": "int3"},
            {"value": 29, "name": "int4"}
        ]
    },
    "ObjectType": {
      "_comment": "Only used for the wire",
      "category": "native"
    },
    "ObjectId": {
      "_comment": "Only used for the wire",
      "category": "native"
    },
    "ObjectHandle": {
      "_comment": "Only used for the wire",
      "category": "native"
    },
    "void": {
        "category": "native"
    },
    "uint32_t": {
        "category": "native"
    },
    "int32_t": {
        "category": "native"
    },
    "uint64_t": {
        "category": "native"
    },
    "uint8_t": {
        "category": "native"
    }
}