| { |
| "_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": "mirrored repeat"}, |
| {"value": 2, "name": "clamp to edge"}, |
| {"value": 3, "name": "clamp to border color"} |
| ] |
| }, |
| "attachment descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "format", "type": "texture format"} |
| ] |
| }, |
| "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": "uint32_t"}, |
| {"name": "size", "type": "uint32_t"}, |
| {"name": "sampler", "type": "sampler", "optional": true}, |
| {"name": "texture view", "type": "texture view", "optional": true} |
| ] |
| }, |
| "bind group descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "layout", "type": "bind group layout"}, |
| {"name": "num bindings", "type": "uint32_t"}, |
| {"name": "bindings", "type": "bind group binding", "annotation": "const*", "length": "num bindings"} |
| ] |
| }, |
| "bind group layout": { |
| "category": "object" |
| }, |
| "bind group layout binding": { |
| "category": "structure", |
| "extensible": false, |
| "members": [ |
| {"name": "binding", "type": "uint32_t"}, |
| {"name": "visibility", "type": "shader stage bit"}, |
| {"name": "type", "type": "binding type"} |
| ] |
| }, |
| "bind group layout descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "num bindings", "type": "uint32_t"}, |
| {"name": "bindings", "type": "bind group layout binding", "annotation": "const*", "length": "num bindings"} |
| ] |
| }, |
| "binding type": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "uniform buffer"}, |
| {"value": 1, "name": "sampler"}, |
| {"value": 2, "name": "sampled texture"}, |
| {"value": 3, "name": "storage buffer"} |
| ] |
| }, |
| "blend descriptor": { |
| "category": "structure", |
| "extensible": false, |
| "members": [ |
| {"name": "operation", "type": "blend operation"}, |
| {"name": "src factor", "type": "blend factor"}, |
| {"name": "dst factor", "type": "blend factor"} |
| ] |
| }, |
| "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"} |
| ] |
| }, |
| "blend state descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "blend enabled", "type": "bool"}, |
| {"name": "alpha blend", "type": "blend descriptor"}, |
| {"name": "color blend", "type": "blend descriptor"}, |
| {"name": "color write mask", "type": "color write mask"} |
| ] |
| }, |
| "bool": { |
| "category": "native" |
| }, |
| "border color": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "transparent black"}, |
| {"value": 1, "name": "opaque black"}, |
| {"value": 2, "name": "opaque white"} |
| ] |
| }, |
| "builder error status": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "success"}, |
| {"value": 1, "name": "error", "TODO": "cwallez@chromium.org: recoverable errors like GPU OOM"}, |
| {"value": 2, "name": "unknown"}, |
| {"value": 3, "name": "context lost"} |
| ] |
| }, |
| "builder error callback": { |
| "category": "natively defined" |
| }, |
| "buffer": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "set sub data", |
| "args": [ |
| {"name": "start", "type": "uint32_t"}, |
| {"name": "count", "type": "uint32_t"}, |
| {"name": "data", "type": "uint8_t", "annotation": "const*", "length": "count"} |
| ] |
| }, |
| { |
| "_comment": "Contrary to set sub data, this is in char size", |
| "name": "map read async", |
| "args": [ |
| {"name": "start", "type": "uint32_t"}, |
| {"name": "size", "type": "uint32_t"}, |
| {"name": "callback", "type": "buffer map read callback"}, |
| {"name": "userdata", "type": "callback userdata"} |
| ] |
| }, |
| { |
| "_comment": "Contrary to set sub data, this is in char size", |
| "name": "map write async", |
| "args": [ |
| {"name": "start", "type": "uint32_t"}, |
| {"name": "size", "type": "uint32_t"}, |
| {"name": "callback", "type": "buffer map write callback"}, |
| {"name": "userdata", "type": "callback userdata"} |
| ] |
| }, |
| { |
| "name": "unmap" |
| } |
| ] |
| }, |
| "buffer builder": { |
| "_comment": "This builder is kept for testing only", |
| "category": "object", |
| "methods": [ |
| { |
| "name": "get result", |
| "returns": "buffer" |
| }, |
| { |
| "name": "set size", |
| "args": [ |
| {"name": "size", "type": "uint32_t"} |
| ] |
| } |
| ] |
| }, |
| "buffer copy view": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "buffer", "type": "buffer"}, |
| {"name": "offset", "type": "uint32_t"}, |
| {"name": "row pitch", "type": "uint32_t"}, |
| {"name": "image height", "type": "uint32_t"} |
| ] |
| }, |
| "buffer descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "usage", "type": "buffer usage bit"}, |
| {"name": "size", "type": "uint32_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": "context lost"} |
| ] |
| }, |
| "buffer usage bit": { |
| "category": "bitmask", |
| "values": [ |
| {"value": 0, "name": "none"}, |
| {"value": 1, "name": "map read"}, |
| {"value": 2, "name": "map write"}, |
| {"value": 4, "name": "transfer src"}, |
| {"value": 8, "name": "transfer dst"}, |
| {"value": 16, "name": "index"}, |
| {"value": 32, "name": "vertex"}, |
| {"value": 64, "name": "uniform"}, |
| {"value": 128, "name": "storage"} |
| ] |
| }, |
| "callback userdata": { |
| "category": "natively defined" |
| }, |
| "char": { |
| "category": "native" |
| }, |
| "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 builder": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "get result", |
| "returns": "command buffer" |
| }, |
| { |
| "name": "begin compute pass", |
| "returns": "compute pass encoder" |
| }, |
| { |
| "name": "begin render pass", |
| "args": [ |
| {"name": "info", "type": "render pass descriptor"} |
| ], |
| "returns": "render pass encoder" |
| }, |
| { |
| "name": "copy buffer to buffer", |
| "args": [ |
| {"name": "source", "type": "buffer"}, |
| {"name": "source offset", "type": "uint32_t"}, |
| {"name": "destination", "type": "buffer"}, |
| {"name": "destination offset", "type": "uint32_t"}, |
| {"name": "size", "type": "uint32_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*"} |
| ] |
| } |
| ] |
| }, |
| "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 encoder": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "set pipeline", |
| "args": [ |
| {"name": "pipeline", "type": "compute pipeline"} |
| ] |
| }, |
| { |
| "name": "set push constants", |
| "TODO": [ |
| "data should be void*", |
| "TODO Vulkan has an additional stage mask" |
| ], |
| "args": [ |
| {"name": "stages", "type": "shader stage bit"}, |
| {"name": "offset", "type": "uint32_t"}, |
| {"name": "count", "type": "uint32_t"}, |
| {"name": "data", "type": "uint32_t", "annotation": "const*", "length": "count"} |
| ] |
| }, |
| { |
| "name": "set bind group", |
| "args": [ |
| {"name": "group index", "type": "uint32_t"}, |
| {"name": "group", "type": "bind group"} |
| ] |
| }, |
| { |
| "name": "dispatch", |
| "args": [ |
| {"name": "x", "type": "uint32_t"}, |
| {"name": "y", "type": "uint32_t"}, |
| {"name": "z", "type": "uint32_t"} |
| ] |
| }, |
| { |
| "name": "end pass", |
| "TODO": "This returns the top-level encoder in the WebGPU IDL" |
| } |
| ] |
| }, |
| "compute pipeline": { |
| "category": "object" |
| }, |
| "compute pipeline descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "layout", "type": "pipeline layout"}, |
| {"name": "module", "type": "shader module"}, |
| {"name": "entry point", "type": "char", "annotation": "const*", "length": "strlen"} |
| ] |
| }, |
| "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 builder for testing", |
| "returns": "buffer builder" |
| }, |
| { |
| "name": "create command buffer builder", |
| "returns": "command buffer builder" |
| }, |
| { |
| "name": "create fence", |
| "returns": "fence", |
| "args": [ |
| {"name": "descriptor", "type": "fence descriptor", "annotation": "const*"} |
| ] |
| }, |
| { |
| "name": "create render pass descriptor builder", |
| "returns": "render pass descriptor builder" |
| }, |
| { |
| "name": "create input state builder", |
| "returns": "input state builder" |
| }, |
| { |
| "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 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 builder", |
| "returns": "swap chain builder" |
| }, |
| { |
| "name": "create texture", |
| "returns": "texture", |
| "args": [ |
| {"name": "descriptor", "type": "texture descriptor", "annotation": "const*"} |
| ] |
| }, |
| { |
| "name": "tick" |
| }, |
| { |
| "name": "set error callback", |
| "args": [ |
| {"name": "callback", "type": "device error callback"}, |
| {"name": "userdata", "type": "callback userdata"} |
| ] |
| } |
| ] |
| }, |
| "depth stencil state descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "depth write enabled", "type": "bool"}, |
| {"name": "depth compare", "type": "compare function"}, |
| {"name": "front", "type": "stencil state face descriptor"}, |
| {"name": "back", "type": "stencil state face descriptor"}, |
| {"name": "stencil read mask", "type": "uint32_t"}, |
| {"name": "stencil write mask", "type": "uint32_t"} |
| ] |
| }, |
| "device error callback": { |
| "category": "natively defined" |
| }, |
| "extent 3D": { |
| "category": "structure", |
| "members": [ |
| {"name": "width", "type": "uint32_t"}, |
| {"name": "height", "type": "uint32_t"}, |
| {"name": "depth", "type": "uint32_t"} |
| ] |
| }, |
| "face": { |
| "category": "bitmask", |
| "values": [ |
| {"value": 0, "name": "none"}, |
| {"value": 1, "name": "back"}, |
| {"value": 2, "name": "front"}, |
| {"value": 3, "name": "both"} |
| ] |
| }, |
| "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": "callback userdata"} |
| ] |
| } |
| ] |
| }, |
| "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": "context lost"} |
| ] |
| }, |
| "fence descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "initial value", "type": "uint64_t"} |
| ] |
| }, |
| "filter mode": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name":"nearest"}, |
| {"value": 1, "name":"linear"} |
| ] |
| }, |
| "float": { |
| "category": "native" |
| }, |
| "index format": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "uint16"}, |
| {"value": 1, "name": "uint32"} |
| ] |
| }, |
| "input state": { |
| "category": "object" |
| }, |
| "input state builder": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "get result", |
| "returns": "input state" |
| }, |
| { |
| "name": "set attribute", |
| "args": [ |
| {"name": "shader location", "type": "uint32_t"}, |
| {"name": "binding slot", "type": "uint32_t"}, |
| {"name": "format", "type": "vertex format"}, |
| {"name": "offset", "type": "uint32_t"} |
| ] |
| }, |
| { |
| "name": "set input", |
| "args": [ |
| {"name": "binding slot", "type": "uint32_t"}, |
| {"name": "stride", "type": "uint32_t"}, |
| {"name": "step mode", "type": "input step mode"} |
| ] |
| } |
| ] |
| }, |
| "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"} |
| ] |
| }, |
| "origin 3D": { |
| "category": "structure", |
| "members": [ |
| {"name": "x", "type": "uint32_t"}, |
| {"name": "y", "type": "uint32_t"}, |
| {"name": "z", "type": "uint32_t"} |
| ] |
| }, |
| "attachments state descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "num color attachments", "type": "uint32_t"}, |
| {"name": "color attachments", "type": "attachment descriptor", "annotation": "const*", "length": "num color attachments"}, |
| {"name": "has depth stencil attachment", "type": "bool"}, |
| {"name": "depth stencil attachment", "type": "attachment descriptor", "annotation":"const*"} |
| ] |
| }, |
| "pipeline layout": { |
| "category": "object" |
| }, |
| "pipeline layout descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "num bind group layouts", "type": "uint32_t"}, |
| {"name": "bind group layouts", "type": "bind group layout", "annotation": "const*", "length": "num bind group layouts"} |
| ] |
| }, |
| "pipeline 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": "num commands", "type": "uint32_t"}, |
| {"name": "commands", "type": "command buffer", "annotation": "const*", "length": "num commands"} |
| ] |
| }, |
| { |
| "name": "signal", |
| "args": [ |
| {"name": "fence", "type": "fence"}, |
| {"name": "signal value", "type": "uint64_t"} |
| ] |
| } |
| ] |
| }, |
| |
| "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"} |
| ] |
| }, |
| |
| "render pass descriptor builder": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "get result", |
| "returns": "render pass descriptor" |
| }, |
| { |
| "name": "set color attachments", |
| "args": [ |
| {"name": "count", "type": "uint32_t"}, |
| {"name": "color attachments", "type": "render pass color attachment descriptor", "annotation": "const*", "length": "count"} |
| ] |
| }, |
| { |
| "name": "set depth stencil attachment", |
| "args": [ |
| {"name": "depth stencil attachment", "type": "render pass depth stencil attachment descriptor", "annotation": "const*"} |
| ] |
| } |
| ], |
| "TODO": "Remove this builder and use render pass descriptor directly" |
| }, |
| "render pass descriptor": { |
| "category": "object" |
| }, |
| "render pass encoder": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "set pipeline", |
| "args": [ |
| {"name": "pipeline", "type": "render pipeline"} |
| ] |
| }, |
| { |
| "name": "set push constants", |
| "TODO": [ |
| "data should be void*", |
| "TODO Vulkan has an additional stage mask" |
| ], |
| "args": [ |
| {"name": "stages", "type": "shader stage bit"}, |
| {"name": "offset", "type": "uint32_t"}, |
| {"name": "count", "type": "uint32_t"}, |
| {"name": "data", "type": "uint32_t", "annotation": "const*", "length": "count"} |
| ] |
| }, |
| { |
| "name": "set bind group", |
| "args": [ |
| {"name": "group index", "type": "uint32_t"}, |
| {"name": "group", "type": "bind group"} |
| ] |
| }, |
| { |
| "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": "uint32_t"}, |
| {"name": "first instance", "type": "uint32_t"} |
| ] |
| }, |
| { |
| "name": "set stencil reference", |
| "args": [ |
| {"name": "reference", "type": "uint32_t"} |
| ] |
| }, |
| { |
| "name": "set blend color", |
| "args": [ |
| {"name": "r", "type": "float"}, |
| {"name": "g", "type": "float"}, |
| {"name": "b", "type": "float"}, |
| {"name": "a", "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 buffers", |
| "args": [ |
| {"name": "start slot", "type": "uint32_t"}, |
| {"name": "count", "type": "uint32_t"}, |
| {"name": "buffers", "type": "buffer", "annotation": "const*", "length": "count"}, |
| {"name": "offsets", "type": "uint32_t", "annotation": "const*", "length": "count"} |
| ] |
| }, |
| { |
| "name": "set index buffer", |
| "args": [ |
| {"name": "buffer", "type": "buffer"}, |
| {"name": "offset", "type": "uint32_t"} |
| ] |
| }, |
| { |
| "name": "end pass", |
| "TODO": "This returns the top-level encoder in the WebGPU IDL" |
| } |
| ] |
| }, |
| "render pipeline": { |
| "category": "object" |
| }, |
| "render pipeline descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "layout", "type": "pipeline layout"}, |
| {"name": "vertex stage", "type": "pipeline stage descriptor", "annotation": "const*"}, |
| {"name": "fragment stage", "type": "pipeline stage descriptor", "annotation": "const*"}, |
| {"name": "input state", "type": "input state"}, |
| {"name": "index format", "type": "index format"}, |
| {"name": "primitive topology", "type": "primitive topology"}, |
| {"name": "attachments state", "type": "attachments state descriptor", "annotation": "const*"}, |
| {"name": "sample count", "type": "uint32_t"}, |
| {"name": "depth stencil state", "type": "depth stencil state descriptor", "annotation": "const*"}, |
| {"name": "num blend states", "type": "uint32_t"}, |
| {"name": "blend states", "type": "blend state descriptor", "annotation": "const*", "length": "num blend states"} |
| ] |
| }, |
| "sampler": { |
| "category": "object" |
| }, |
| "sampler descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "address mode u", "type": "address mode"}, |
| {"name": "address mode v", "type": "address mode"}, |
| {"name": "address mode w", "type": "address mode"}, |
| {"name": "mag filter", "type": "filter mode"}, |
| {"name": "min filter", "type": "filter mode"}, |
| {"name": "mipmap filter", "type": "filter mode"}, |
| {"name": "lod min clamp", "type": "float"}, |
| {"name": "lod max clamp", "type": "float"}, |
| {"name": "compare function", "type": "compare function"}, |
| {"name": "border color", "type": "border color"} |
| ] |
| }, |
| "shader module": { |
| "category": "object" |
| }, |
| "shader module descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "code size", "type": "uint32_t"}, |
| {"name": "code", "type": "uint32_t", "annotation": "const*", "length": "code size"} |
| ] |
| }, |
| "shader stage": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "vertex"}, |
| {"value": 1, "name": "fragment"}, |
| {"value": 2, "name": "compute"} |
| ] |
| }, |
| "shader stage bit": { |
| "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"}, |
| {"name": "stencil fail op", "type": "stencil operation"}, |
| {"name": "depth fail op", "type": "stencil operation"}, |
| {"name": "pass op", "type": "stencil operation"} |
| ] |
| }, |
| "swap chain": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "configure", |
| "args": [ |
| {"name": "format", "type": "texture format"}, |
| {"name": "allowed usage", "type": "texture usage bit"}, |
| {"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 builder": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "get result", |
| "returns": "swap chain" |
| }, |
| { |
| "name": "set implementation", |
| "args": [ |
| {"name": "implementation", "type": "uint64_t"} |
| ] |
| } |
| ] |
| }, |
| "texture": { |
| "category": "object", |
| "methods": [ |
| { |
| "name": "create default texture view", |
| "returns": "texture view" |
| }, |
| { |
| "name": "create texture view", |
| "returns": "texture view", |
| "args": [ |
| {"name": "descriptor", "type": "texture view descriptor", "annotation": "const*"} |
| ] |
| } |
| ] |
| }, |
| "texture aspect": { |
| "category": "bitmask", |
| "values": [ |
| {"value": 1, "name": "color"}, |
| {"value": 2, "name": "depth"}, |
| {"value": 4, "name": "stencil"} |
| ] |
| }, |
| "texture copy view": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "texture", "type": "texture"}, |
| {"name": "level", "type": "uint32_t"}, |
| {"name": "slice", "type": "uint32_t"}, |
| {"name": "origin", "type": "origin 3D"} |
| ] |
| }, |
| "texture descriptor": { |
| "category": "structure", |
| "extensible": true, |
| "members": [ |
| {"name": "usage", "type": "texture usage bit"}, |
| {"name": "dimension", "type": "texture dimension"}, |
| {"name": "size", "type": "extent 3D"}, |
| {"name": "array size", "type": "uint32_t"}, |
| {"name": "format", "type": "texture format"}, |
| {"name": "level count", "type": "uint32_t"}, |
| {"name": "sample count", "type": "uint32_t"} |
| ] |
| }, |
| "texture dimension": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "2D"} |
| ] |
| }, |
| "texture format": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "r8 g8 b8 a8 unorm"}, |
| {"value": 1, "name": "r8 g8 unorm"}, |
| {"value": 2, "name": "r8 unorm"}, |
| {"value": 3, "name": "r8 g8 b8 a8 uint"}, |
| {"value": 4, "name": "r8 g8 uint"}, |
| {"value": 5, "name": "r8 uint"}, |
| {"value": 6, "name": "b8 g8 r8 a8 unorm"}, |
| {"value": 7, "name": "d32 float s8 uint"} |
| ] |
| }, |
| "texture usage bit": { |
| "category": "bitmask", |
| "values": [ |
| {"value": 0, "name": "none"}, |
| {"value": 1, "name": "transfer src"}, |
| {"value": 2, "name": "transfer 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": "format", "type": "texture format"}, |
| {"name": "dimension", "type": "texture view dimension"}, |
| {"name": "base mip level", "type": "uint32_t"}, |
| {"name": "level count", "type": "uint32_t"}, |
| {"name": "base array layer", "type": "uint32_t"}, |
| {"name": "layer count", "type": "uint32_t"} |
| ], |
| "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": "2D"}, |
| {"value": 1, "name": "2D array"}, |
| {"value": 2, "name": "cube"}, |
| {"value": 3, "name": "cube array"} |
| ], |
| "TODO": [ |
| "jiawei.shao@intel.com: support 1D and 3D texture views" |
| ] |
| }, |
| "vertex format": { |
| "category": "enum", |
| "values": [ |
| {"value": 0, "name": "float r32 g32 b32 a32"}, |
| {"value": 1, "name": "float r32 g32 b32"}, |
| {"value": 2, "name": "float r32 g32"}, |
| {"value": 3, "name": "float r32"}, |
| {"value": 4, "name": "int r32 g32 b32 a32"}, |
| {"value": 5, "name": "int r32 g32 b32"}, |
| {"value": 6, "name": "int r32 g32"}, |
| {"value": 7, "name": "int r32"}, |
| {"value": 8, "name": "ushort r16 g16 b16 a16"}, |
| {"value": 9, "name": "ushort r16 g16"}, |
| {"value": 10, "name": "unorm r8 g8 b8 a8"}, |
| {"value": 11, "name": "unorm r8 g8"} |
| ] |
| }, |
| "void": { |
| "category": "native" |
| }, |
| "uint32_t": { |
| "category": "native" |
| }, |
| "uint64_t": { |
| "category": "native" |
| }, |
| "uint8_t": { |
| "category": "native" |
| } |
| } |
