encounter
/
dawn-cmake
mirror of https://github.com/encounter/dawn-cmake.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
dawn-cmake/next.json

1244 lines
40 KiB
JSON
Raw Normal View History

fix formatting
2017-05-31 00:03:44 +00:00
{
"_comment": [
"Copyright 2017 The NXT 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."
],
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
"bool": {
"category": "native"
},
fix formatting
2017-05-31 00:03:44 +00:00
"bind group": {
"category": "object"
},
"bind group builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "bind group"
},
{
"name": "set layout",
"args": [
{"name": "layout", "type": "bind group layout"}
]
},
{
"name": "set usage",
"args": [
{"name": "usage", "type": "bind group usage"}
]
},
{
"name": "set buffer views",
"args": [
{"name": "start", "type": "uint32_t"},
{"name": "count", "type": "uint32_t"},
{"name": "buffer views", "type": "buffer view", "annotation": "const*", "length": "count"}
]
},
{
"name": "set samplers",
"args": [
{"name": "start", "type": "uint32_t"},
{"name": "count", "type": "uint32_t"},
{"name": "samplers", "type": "sampler", "annotation": "const*", "length": "count"}
]
},
{
"name": "set texture views",
"args": [
{"name": "start", "type": "uint32_t"},
{"name": "count", "type": "uint32_t"},
{"name": "texture views", "type": "texture view", "annotation": "const*", "length": "count"}
]
}
],
"TODO": [
"When resource are added, add methods for setting the content of the bind group"
]
},
"bind group usage": {
"category": "enum",
"values": [
{"value": 0, "name": "frozen"},
{"value": 1, "name": "dynamic"}
]
},
"bind group layout": {
"category": "object"
},
"bind group layout builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "bind group layout"
},
{
"name": "set bindings type",
"args": [
{"name": "visibility", "type": "shader stage bit"},
{"name": "binding type", "type": "binding type"},
{"name": "start", "type": "uint32_t"},
{"name": "count", "type": "uint32_t"}
]
}
]
},
"binding type": {
"category": "enum",
"values": [
{"value": 0, "name": "uniform buffer"},
{"value": 1, "name": "sampler"},
{"value": 2, "name": "sampled texture"},
{"value": 3, "name": "storage buffer"}
]
},
Add BlendState to NXT API
2017-07-26 20:59:53 +00:00
"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"},
Remove dual source blending It is not supported on many mobile GPUS on Vulkan http://vulkan.gpuinfo.org/listreports.php?feature=dualSrcBlend&option=not and is optional on Metal
2017-08-03 20:24:49 +00:00
{"value": 12, "name": "one minus blend color"}
Add BlendState to NXT API
2017-07-26 20:59:53 +00:00
]
},
"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": {
"category": "object"
},
"blend state builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "blend state"
},
{
"name": "set blend enabled",
"args": [
{"name": "blend enabled", "type": "bool"}
]
},
{
"name": "set alpha blend",
"args": [
{"name": "blend operation", "type": "blend operation"},
{"name": "src factor", "type": "blend factor"},
{"name": "dst factor", "type": "blend factor"}
]
},
{
"name": "set color blend",
"args": [
{"name": "blend operation", "type": "blend operation"},
{"name": "src factor", "type": "blend factor"},
{"name": "dst factor", "type": "blend factor"}
]
},
{
"name": "set color write mask",
"args": [
{"name": "color write mask", "type": "color write mask"}
]
}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"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": "create buffer view builder",
"returns": "buffer view builder"
},
{
"name": "set sub data",
"args": [
{"name": "start", "type": "uint32_t"},
{"name": "count", "type": "uint32_t"},
{"name": "data", "type": "uint32_t", "annotation": "const*", "length": "count"}
]
},
Add Buffer::MapReadAsync state-tracking
2017-06-09 14:51:29 +00:00
{
"_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"}
]
},
Implement MapWrite except in the wire. Also this MapWrite doesn't zero out memory yet.
2018-03-21 00:56:39 +00:00
{
"_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"}
]
},
Add Buffer::MapReadAsync state-tracking
2017-06-09 14:51:29 +00:00
{
"name": "unmap"
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "transition usage",
"args": [
{"name": "usage", "type": "buffer usage bit"}
]
},
{
"name": "freeze usage",
"args": [
{"name": "usage", "type": "buffer usage bit"}
]
}
]
},
"buffer builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "buffer"
},
{
"name": "set allowed usage",
"args": [
{"name": "usage", "type": "buffer usage bit"}
]
},
{
"name": "set initial usage",
"args": [
{"name": "usage", "type": "buffer usage bit"}
]
},
{
"name": "set size",
"args": [
{"name": "size", "type": "uint32_t"}
]
}
]
},
Add Buffer::MapReadAsync state-tracking
2017-06-09 14:51:29 +00:00
"buffer map read callback": {
"category": "natively defined"
},
Implement MapWrite except in the wire. Also this MapWrite doesn't zero out memory yet.
2018-03-21 00:56:39 +00:00
"buffer map write callback": {
"category": "natively defined"
},
Rename "buffer map read status" to "buffer map async status" This is in preparation of MapWriteAsync that will use the same status enum.
2018-03-20 23:48:54 +00:00
"buffer map async status": {
Add Buffer::MapReadAsync state-tracking
2017-06-09 14:51:29 +00:00
"category": "enum",
"values": [
{"value": 0, "name": "success"},
{"value": 1, "name": "error"},
{"value": 2, "name": "unknown"},
{"value": 3, "name": "context lost"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"buffer usage bit": {
"category": "bitmask",
"values": [
{"value": 0, "name": "none"},
Split Mapped usage in MapWrite and MapRead Also make use of CreateFrozenBufferFromData where possible in the example to make the renaming easier.
2017-06-05 19:42:14 +00:00
{"value": 1, "name": "map read"},
Fix MapRead and MapWrite being the same bit
2017-06-16 19:35:12 +00:00
{"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"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
"buffer view": {
"category": "object"
},
"buffer view builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "buffer view"
},
{
"name": "set extent",
"args": [
{"name": "offset", "type": "uint32_t"},
{"name": "size", "type": "uint32_t"}
]
}
]
},
"callback userdata": {
"category": "natively defined"
},
"char": {
"category": "native"
},
Add BlendState to NXT API
2017-07-26 20:59:53 +00:00
"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"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"command buffer": {
"category": "object"
},
"command buffer builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "command buffer"
},
Introduce Begin/EndComputePass (#70)
2017-07-10 21:07:24 +00:00
{
"name": "begin compute pass"
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "begin render pass",
"args": [
{"name": "render pass", "type": "render pass"},
{"name": "framebuffer", "type": "framebuffer"}
]
},
{
replace AdvanceSubpass with Begin/EndRenderSubpass and replace subpassActive with VALIDATION_ASPECT_RENDER_SUBPASS
2017-06-30 06:53:08 +00:00
"name": "begin render subpass"
fix formatting
2017-05-31 00:03:44 +00:00
},
Add buffer to buffer copies
2017-06-12 22:12:29 +00:00
{
"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"
]
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "copy buffer to texture",
"args": [
{"name": "buffer", "type": "buffer"},
{"name": "buffer offset", "type": "uint32_t"},
Add row pitch to Texture->Buffer and Buffer->Texture copy commands
2017-07-13 14:04:23 +00:00
{"name": "row pitch", "type": "uint32_t"},
fix formatting
2017-05-31 00:03:44 +00:00
{"name": "texture", "type": "texture"},
{"name": "x", "type": "uint32_t"},
{"name": "y", "type": "uint32_t"},
{"name": "z", "type": "uint32_t"},
{"name": "width", "type": "uint32_t"},
{"name": "height", "type": "uint32_t"},
{"name": "depth", "type": "uint32_t"},
{"name": "level", "type": "uint32_t"}
],
"TODO": [
"Make pretty with Offset and Extents structures",
"Allow choosing the aspect (depth vs. stencil)?",
Add T->B copies. This implements T->B copies on the Metal backend only and while it adds validation tests, end2end tests will be done in a follow-up commit.
2017-06-26 20:23:03 +00:00
"Add these arguments too",
{"name": "image height", "type": "uint32_t"}
]
},
{
"name": "copy texture to buffer",
"args": [
{"name": "texture", "type": "texture"},
{"name": "x", "type": "uint32_t"},
{"name": "y", "type": "uint32_t"},
{"name": "z", "type": "uint32_t"},
{"name": "width", "type": "uint32_t"},
{"name": "height", "type": "uint32_t"},
{"name": "depth", "type": "uint32_t"},
{"name": "level", "type": "uint32_t"},
{"name": "buffer", "type": "buffer"},
Add row pitch to Texture->Buffer and Buffer->Texture copy commands
2017-07-13 14:04:23 +00:00
{"name": "buffer offset", "type": "uint32_t"},
{"name": "row pitch", "type": "uint32_t"}
Add T->B copies. This implements T->B copies on the Metal backend only and while it adds validation tests, end2end tests will be done in a follow-up commit.
2017-06-26 20:23:03 +00:00
],
"TODO": [
"Make pretty with Offset and Extents structures",
"Allow choosing the aspect (depth vs. stencil)?",
fix formatting
2017-05-31 00:03:44 +00:00
"Add these arguments too",
{"name": "image height", "type": "uint32_t"}
]
},
{
"name": "dispatch",
"args": [
{"name": "x", "type": "uint32_t"},
{"name": "y", "type": "uint32_t"},
{"name": "z", "type": "uint32_t"}
]
},
{
"name": "draw arrays",
"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 elements",
"args": [
{"name": "index count", "type": "uint32_t"},
{"name": "instance count", "type": "uint32_t"},
{"name": "first index", "type": "uint32_t"},
{"name": "first instance", "type": "uint32_t"}
]
},
Introduce Begin/EndComputePass (#70)
2017-07-10 21:07:24 +00:00
{
"name": "end compute pass"
},
replace AdvanceSubpass with Begin/EndRenderSubpass and replace subpassActive with VALIDATION_ASPECT_RENDER_SUBPASS
2017-06-30 06:53:08 +00:00
{
"name": "end render pass"
},
{
"name": "end render subpass"
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "set stencil reference",
"args": [
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
{"name": "reference", "type": "uint32_t"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
Add SetBlendColor command
2017-08-01 18:22:52 +00:00
{
"name": "set blend color",
"args": [
{"name": "r", "type": "float"},
{"name": "g", "type": "float"},
{"name": "b", "type": "float"},
{"name": "a", "type": "float"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "set bind group",
"args": [
{"name": "group index", "type": "uint32_t"},
{"name": "group", "type": "bind group"}
]
},
{
"name": "set index buffer",
"args": [
{"name": "buffer", "type": "buffer"},
Make the index format part of the pipeline state.
2017-09-19 17:38:05 +00:00
{"name": "offset", "type": "uint32_t"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
{
"name": "set push constants",
"TODO": [
"data should be void*",
"TODO Vulkan has an additional stage mask"
],
"args": [
Validate SetPushConstants is done inside subpass and compute passes
2017-07-20 15:01:37 +00:00
{"name": "stages", "type": "shader stage bit"},
fix formatting
2017-05-31 00:03:44 +00:00
{"name": "offset", "type": "uint32_t"},
{"name": "count", "type": "uint32_t"},
{"name": "data", "type": "uint32_t", "annotation": "const*", "length": "count"}
]
},
{
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
"name": "set compute pipeline",
fix formatting
2017-05-31 00:03:44 +00:00
"args": [
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
{"name": "pipeline", "type": "compute pipeline"}
]
},
{
"name": "set render pipeline",
"args": [
{"name": "pipeline", "type": "render pipeline"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
Add and Implement CommandBuffer::SetScissorRect
2018-02-13 19:57:13 +00:00
{
"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"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"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": "transition buffer usage",
"args": [
{"name": "buffer", "type": "buffer"},
{"name": "usage", "type": "buffer usage bit"}
]
},
{
"name": "transition texture usage",
"args": [
{"name": "texture", "type": "texture"},
{"name": "usage", "type": "texture usage bit"}
]
}
]
},
"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"}
]
},
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
"compute pipeline": {
"category": "object"
},
"compute pipeline builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "compute pipeline"
},
{
"name": "set layout",
"args": [
{"name": "layout", "type": "pipeline layout"}
]
},
{
"name": "set stage",
"args": [
{"name": "stage", "type": "shader stage"},
{"name": "module", "type": "shader module"},
{"name": "entry point", "type": "char", "annotation": "const*", "length": "strlen"}
]
}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"device": {
"category": "object",
"methods": [
{
"name": "create bind group builder",
"returns": "bind group builder"
},
{
"name": "create bind group layout builder",
"returns": "bind group layout builder"
},
Add BlendState to NXT API
2017-07-26 20:59:53 +00:00
{
"name": "create blend state builder",
"returns": "blend state builder"
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "create buffer builder",
"returns": "buffer builder"
},
{
"name": "create command buffer builder",
"returns": "command buffer builder"
},
{
"name": "create depth stencil state builder",
"returns": "depth stencil state builder"
},
{
"name": "create framebuffer builder",
"returns": "framebuffer builder"
},
{
"name": "create input state builder",
"returns": "input state builder"
},
{
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
"name": "create compute pipeline builder",
"returns": "compute pipeline builder"
},
{
"name": "create render pipeline builder",
"returns": "render pipeline builder"
fix formatting
2017-05-31 00:03:44 +00:00
},
{
"name": "create pipeline layout builder",
"returns": "pipeline layout builder"
},
{
"name": "create queue builder",
"returns": "queue builder"
},
{
"name": "create render pass builder",
"returns": "render pass builder"
},
{
"name": "create sampler builder",
"returns": "sampler builder"
},
{
"name": "create shader module builder",
"returns": "shader module builder"
},
Swap chains, part 2 (#94)
2017-07-28 01:30:57 +00:00
{
"name": "create swap chain builder",
"returns": "swap chain builder"
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "create texture builder",
"returns": "texture builder"
},
Add Device::Tick for periodic work
2017-06-14 17:33:45 +00:00
{
"name": "tick"
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "set error callback",
"args": [
{"name": "callback", "type": "device error callback"},
{"name": "userdata", "type": "callback userdata"}
]
}
]
},
"depth stencil state": {
"category": "object"
},
"depth stencil state builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "depth stencil state"
},
{
"name": "set depth compare function",
"args": [
{"name": "depth compare function", "type": "compare function"}
]
},
{
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
"name": "set depth write enabled",
fix formatting
2017-05-31 00:03:44 +00:00
"args" : [
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
{"name": "enabled", "type": "bool"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
{
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
"name": "set stencil function",
fix formatting
2017-05-31 00:03:44 +00:00
"args": [
{"name": "face", "type": "face"},
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
{"name": "stencil compare function", "type": "compare function"},
fix formatting
2017-05-31 00:03:44 +00:00
{"name": "stencil failure operation", "type": "stencil operation"},
{"name": "depth failure operation", "type": "stencil operation"},
{"name": "stencil pass operation", "type": "stencil operation"}
]
},
{
"name": "set stencil mask",
"args": [
Simplify PersistentPipelineState and application of stencil states. Fix stencil mask usage. D3D12 does not support separate front/back masks. All APIs support separate read/write masks.
2017-06-02 18:31:53 +00:00
{"name": "readMask", "type": "uint32_t"},
{"name": "writeMask", "type": "uint32_t"}
fix formatting
2017-05-31 00:03:44 +00:00
]
}
]
},
"device error callback": {
"category": "natively defined"
},
"face": {
"category": "bitmask",
"values": [
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
{"value": 0, "name": "none"},
fix formatting
2017-05-31 00:03:44 +00:00
{"value": 1, "name": "back"},
{"value": 2, "name": "front"},
{"value": 3, "name": "both"}
]
},
"filter mode": {
"category": "enum",
"values": [
{"value": 0, "name":"nearest"},
{"value": 1, "name":"linear"}
]
},
Add SetBlendColor command
2017-08-01 18:22:52 +00:00
"float": {
"category": "native"
},
fix formatting
2017-05-31 00:03:44 +00:00
"framebuffer": {
Load operations (#105) * load ops: design + implementation (all backends) * Animometer/glTFViewer: use just one subpass per frame
2017-08-11 21:36:20 +00:00
"category": "object",
"methods": [
{
"name": "attachment set clear color",
"TODO": "determine where to put these methods (probably BeginRenderPass?)",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
{"name": "clear r", "type": "float"},
{"name": "clear g", "type": "float"},
{"name": "clear b", "type": "float"},
{"name": "clear a", "type": "float"}
]
},
{
"name": "attachment set clear depth stencil",
"TODO": "determine where to put these methods (probably BeginRenderPass?)",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
{"name": "clear depth", "type": "float"},
{"name": "clear stencil", "type": "uint32_t"}
]
}
]
fix formatting
2017-05-31 00:03:44 +00:00
},
"framebuffer builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "framebuffer"
},
{
"name": "set render pass",
"args": [
{"name": "render pass", "type": "render pass"}
]
},
{
"name": "set dimensions",
"args": [
{"name": "width", "type": "uint32_t"},
{"name": "height", "type": "uint32_t"}
]
},
{
"name": "set attachment",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
Add depth-stencil textures and attachments (#77) Related: #29
2017-07-17 16:03:16 +00:00
{"name": "texture view", "type": "texture view"}
fix formatting
2017-05-31 00:03:44 +00:00
]
}
]
},
"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 operations (#105) * load ops: design + implementation (all backends) * Animometer/glTFViewer: use just one subpass per frame
2017-08-11 21:36:20 +00:00
"load op": {
"category": "enum",
"values": [
{"value": 0, "name": "clear"},
{"value": 1, "name": "load"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"pipeline layout": {
"category": "object"
},
"pipeline layout builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "pipeline layout"
},
{
"name": "set bind group layout",
"args": [
{"name": "group index", "type": "uint32_t"},
{"name": "layout", "type": "bind group layout"}
]
}
]
},
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
"primitive topology": {
"category": "enum",
"values": [
Point,Line,Triangle -> PointList,LineList,TriangleList
2017-07-26 22:10:44 +00:00
{"value": 0, "name": "point list"},
{"value": 1, "name": "line list"},
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
{"value": 2, "name": "line strip"},
Point,Line,Triangle -> PointList,LineList,TriangleList
2017-07-26 22:10:44 +00:00
{"value": 3, "name": "triangle list"},
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
{"value": 4, "name": "triangle strip"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"queue": {
"category": "object",
"methods": [
{
"name": "submit",
"args": [
{"name": "num commands", "type": "uint32_t"},
{"name": "commands", "type": "command buffer", "annotation": "const*", "length": "num commands"}
]
}
]
},
"queue builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "queue"
}
]
},
"render pass builder": {
"category": "object",
"TODO": {
"attachments": "Also need load op, store op, depth/stencil attachments and depth/stencil ops, and maybe usages for the implicit attachment transitions",
"subpasses": "Also need input attachments, resolve attachments, and preserve attachments"
},
"methods": [
{
"name": "get result",
"returns": "render pass"
},
{
"name": "set attachment count",
"args": [
{"name": "attachment count", "type": "uint32_t"}
]
},
{
"name": "attachment set format",
"TODO": "Also need sample count",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
{"name": "format", "type": "texture format"}
]
},
Load operations (#105) * load ops: design + implementation (all backends) * Animometer/glTFViewer: use just one subpass per frame
2017-08-11 21:36:20 +00:00
{
"name": "attachment set color load op",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
{"name": "op", "type": "load op"}
]
},
{
"name": "attachment set depth stencil load ops",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
{"name": "depth op", "type": "load op"},
{"name": "stencil op", "type": "load op"}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
{
"name": "set subpass count",
"args": [
{"name": "subpass count", "type": "uint32_t"}
]
},
{
"name": "subpass set color attachment",
"args": [
{"name": "subpass index", "type": "uint32_t"},
{"name": "output attachment location", "type": "uint32_t"},
{"name": "attachment slot", "type": "uint32_t"}
]
Add depth-stencil textures and attachments (#77) Related: #29
2017-07-17 16:03:16 +00:00
},
{
"name": "subpass set depth stencil attachment",
"args": [
{"name": "subpass index", "type": "uint32_t"},
{"name": "attachment slot", "type": "uint32_t"}
]
fix formatting
2017-05-31 00:03:44 +00:00
}
]
},
"render pass": {
"category": "object"
},
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
"render pipeline": {
"category": "object"
},
"render pipeline builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "render pipeline"
},
Add BlendState to NXT API
2017-07-26 20:59:53 +00:00
{
"name": "set color attachment blend state",
"args": [
{"name": "attachment slot", "type": "uint32_t"},
{"name": "blend state", "type": "blend state"}
]
},
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
{
"name": "set depth stencil state",
"args": [
{"name": "depth stencil state", "type": "depth stencil state"}
]
},
Make the index format part of the pipeline state.
2017-09-19 17:38:05 +00:00
{
"name": "set index format",
"args": [
{"name": "format", "type": "index format"}
]
},
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
{
"name": "set input state",
"args": [
{"name": "input", "type": "input state"}
]
},
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
{
"name": "set layout",
"args": [
{"name": "layout", "type": "pipeline layout"}
]
},
{
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
"name": "set primitive topology",
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
"args": [
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
{"name": "primitive topology", "type": "primitive topology"}
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
]
},
{
"name": "set stage",
"args": [
{"name": "stage", "type": "shader stage"},
{"name": "module", "type": "shader module"},
{"name": "entry point", "type": "char", "annotation": "const*", "length": "strlen"}
]
},
{
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
"name": "set subpass",
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
"args": [
Add primitive topology to NXT API
2017-07-24 17:54:19 +00:00
{"name": "render pass", "type": "render pass"},
{"name": "subpass", "type": "uint32_t"}
Split Pipeline in Render and Compute, common part
2017-07-14 14:58:07 +00:00
]
}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"sampler": {
"category": "object"
},
"sampler builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "sampler"
},
{
"name": "set filter mode",
"args": [
{"name": "mag filter", "type": "filter mode"},
{"name": "min filter", "type": "filter mode"},
{"name": "mipmap filter", "type": "filter mode"}
]
}
]
},
"shader module": {
"category": "object"
},
"shader module builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "shader module"
},
{
"name": "set source",
"args": [
{"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": [
Add nxt::ShaderStageBit::None
2017-07-20 15:00:39 +00:00
{"value": 0, "name": "none"},
fix formatting
2017-05-31 00:03:44 +00:00
{"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"}
Refactor DepthStencilState. TODO: add validation tests - defaults to depth and stencil tests off - whether or not depth and stencil tests are enabled is inferred from the comparison functions and stencil operations - only one stencil reference. D3D12 does not support separate references - change SetDepthWriteMode to SetDepthWriteEnabled and use a bool instead of enum - Create PersistentPipelineState class for OpenGL backend with simple state tracking - Add validation so DepthStencilState properties are only set once - Update API usage in HelloDepthStencil - refactor tracking of the DepthStencilState in the Metal backend - validate that compute pipeline does not have a depth stencil state
2017-06-01 15:30:03 +00:00
]
fix formatting
2017-05-31 00:03:44 +00:00
},
Swap chains, part 1 (#87) Adds the swap chain interfaces to the API without changing the behavior of anything else. This includes the C APIs for applications to provide swap chain implementations. Also adds stub implementations on every backend.
2017-07-19 22:41:17 +00:00
"swap chain": {
"category": "object",
"methods": [
{
"name": "configure",
"args": [
{"name": "format", "type": "texture format"},
Update SwapChain to configure texture usage Explicitly configure swap chain usage in bindings and examples Fix missing case in switch Make swap chain Present usage implicit Author: Austin Eng <enga@google.com>
2017-08-29 20:35:05 +00:00
{"name": "allowedUsage", "type": "texture usage bit"},
Swap chains, part 1 (#87) Adds the swap chain interfaces to the API without changing the behavior of anything else. This includes the C APIs for applications to provide swap chain implementations. Also adds stub implementations on every backend.
2017-07-19 22:41:17 +00:00
{"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"}
]
}
]
},
fix formatting
2017-05-31 00:03:44 +00:00
"texture": {
"category": "object",
"methods": [
{
"name": "create texture view builder",
"returns": "texture view builder"
},
{
"name": "transition usage",
"args": [
{"name": "usage", "type": "texture usage bit"}
]
},
{
"name": "freeze usage",
"args": [
{"name": "usage", "type": "texture usage bit"}
]
}
]
},
"texture builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "texture"
},
{
"name": "set dimension",
"args": [
{"name": "dimension", "type": "texture dimension"}
]
},
{
"name": "set extent",
"args": [
{"name": "width", "type": "uint32_t"},
{"name": "height", "type": "uint32_t"},
{"name": "depth", "type": "uint32_t"}
]
},
{
"name": "set format",
"args": [
{"name": "format", "type": "texture format"}
]
},
{
"name": "set mip levels",
"args": [
{"name": "num mip levels", "type": "uint32_t"}
]
},
{
"name": "set allowed usage",
"args": [
{"name": "usage", "type": "texture usage bit"}
]
},
{
"name": "set initial usage",
"args": [
{"name": "usage", "type": "texture usage bit"}
]
}
]
},
"texture dimension": {
"category": "enum",
"values": [
{"value": 0, "name": "2D"}
]
},
"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"},
Swap chains, part 1 (#87) Adds the swap chain interfaces to the API without changing the behavior of anything else. This includes the C APIs for applications to provide swap chain implementations. Also adds stub implementations on every backend.
2017-07-19 22:41:17 +00:00
{"value": 16, "name": "output attachment"},
{"value": 32, "name": "present"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
"texture view": {
"category": "object"
},
"texture view builder": {
"category": "object",
"methods": [
{
"name": "get result",
"returns": "texture view"
}
]
},
"texture format": {
"category": "enum",
"values": [
Add depth-stencil textures and attachments (#77) Related: #29
2017-07-17 16:03:16 +00:00
{"value": 0, "name": "r8 g8 b8 a8 unorm"},
Add 1- and 2-component texture formats. Implemented {uint8, unorm8} x {r, rg} texture formats. Backend support added for Metal, D3D12 and OpenGL.
2018-01-22 19:09:08 +00:00
{"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"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
"vertex format": {
"category": "enum",
"values": [
{"value": 0, "name": "float r32 g32 b32 a32"},
{"value": 1, "name": "float r32 g32 b32"},
Add nxt::VertexFormat::FloatR32
2017-07-03 18:01:30 +00:00
{"value": 2, "name": "float r32 g32"},
Implement unorm_rgba8 and unorm_rg8 vertex formats. Backend support implemented in GL, Metal and D3D12. Support for unorm values in the GL backend requires a utility function to indicate if the format's components are normalized. Note that unorm_r8 is only supported on more recent MacOS SDKs (10.13), so it's omitted for now.
2018-02-04 13:49:43 +00:00
{"value": 3, "name": "float r32"},
{"value": 4, "name": "unorm r8 g8 b8 a8"},
{"value": 5, "name": "unorm r8 g8"}
fix formatting
2017-05-31 00:03:44 +00:00
]
},
"void": {
"category": "native"
},
"uint32_t": {
"category": "native"
Swap chains, part 1 (#87) Adds the swap chain interfaces to the API without changing the behavior of anything else. This includes the C APIs for applications to provide swap chain implementations. Also adds stub implementations on every backend.
2017-07-19 22:41:17 +00:00
},
"uint64_t": {
"category": "native"
fix formatting
2017-05-31 00:03:44 +00:00
}
}