@3dverse/api 0.8.20 → 0.8.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1476,7 +1476,7 @@ export type GetAssetDescription_Aabb = {
1476
1476
  };
1477
1477
  export type GetAssetDescription_RenderGraph = {
1478
1478
  /** All blend states */
1479
- blendStateDescriptions?: Array<GetAssetDescription_Object>;
1479
+ blendStateDescriptions?: Array<GetAssetDescription_BlendState>;
1480
1480
  /** Descriptions of all buffers */
1481
1481
  bufferDescriptions?: Array<GetAssetDescription_Object>;
1482
1482
  /** Conditions referenced by conditionIndex */
@@ -1490,7 +1490,7 @@ export type GetAssetDescription_RenderGraph = {
1490
1490
  /** Name of the asset */
1491
1491
  name: string;
1492
1492
  /** Descriptions of all nodes */
1493
- nodeDataDescriptions: Array<StrictUnion<GetAssetDescription_Viewport | GetAssetDescription_DrawBatch | GetAssetDescription_DrawBatchWithMaterials | GetAssetDescription_DispatchCompute | GetAssetDescription_BlitImage | GetAssetDescription_DispatchPointClouds | GetAssetDescription_CopyImage | GetAssetDescription_ResolveImage | GetAssetDescription_DrawFullscreen | GetAssetDescription_GenerateMipChain | GetAssetDescription_CopyToCubemapFace | GetAssetDescription_ClearImages | GetAssetDescription_FillBuffer | GetAssetDescription_DrawDebugLines | GetAssetDescription_DispatchDecals | GetAssetDescription_SetDepthBias | GetAssetDescription_DispatchRayTracing> & GetAssetDescription_Object>;
1493
+ nodeDataDescriptions: Array<StrictUnion<GetAssetDescription_Viewport | GetAssetDescription_DrawBatch | GetAssetDescription_DrawBatchWithMaterials | GetAssetDescription_DispatchCompute | GetAssetDescription_BlitImage | GetAssetDescription_DispatchPointClouds | GetAssetDescription_CopyImage | GetAssetDescription_ResolveImage | GetAssetDescription_DrawFullscreen | GetAssetDescription_BlitMipChain | GetAssetDescription_CopyToCubemapFace | GetAssetDescription_DispatchMipChain | GetAssetDescription_ClearImages | GetAssetDescription_FillBuffer | GetAssetDescription_DrawDebugLines | GetAssetDescription_DispatchDecals | GetAssetDescription_SetDepthBias | GetAssetDescription_DispatchRayTracing> & GetAssetDescription_Object>;
1494
1494
  /** The index of the render target used for occlusion */
1495
1495
  occlusionInputDepthRenderTargetIndex?: number;
1496
1496
  /** Descriptions of all render passes */
@@ -1504,6 +1504,24 @@ export type GetAssetDescription_RenderGraph = {
1504
1504
  /** Unique identifier for the asset */
1505
1505
  uuid: string;
1506
1506
  };
1507
+ export type GetAssetDescription_BlendState = {
1508
+ /** Selects which blend operation is used to calculate the alpha values to write to the color attachment. */
1509
+ alphaBlendOp?: number;
1510
+ /** Controls whether blending is enabled for the corresponding color attachment. If blending is not enabled, the source fragment’s color for that attachment is passed through unmodified. */
1511
+ blendEnable?: boolean;
1512
+ /** Selects which blend operation is used to calculate the RGB values to write to the color attachment. */
1513
+ colorBlendOp?: number;
1514
+ /** Bitmask of VkColorComponentFlagBits specifying which of the R, G, B, and/or A components are enabled for writing, as described for the Color Write Mask. */
1515
+ colorWriteMask?: number;
1516
+ /** Selects which blend factor is used to determine the destination factor Da. */
1517
+ dstAlphaBlendFactor?: number;
1518
+ /** Selects which blend factor is used to determine the destination factors (Dr,Dg,Db). */
1519
+ dstColorBlendFactor?: number;
1520
+ /** Selects which blend factor is used to determine the source factor Sa. */
1521
+ srcAlphaBlendFactor?: number;
1522
+ /** Selects which blend factor is used to determine the source factors (Sr,Sg,Sb). */
1523
+ srcColorBlendFactor?: number;
1524
+ };
1507
1525
  export type GetAssetDescription_Viewport = {
1508
1526
  type?: 0;
1509
1527
  };
@@ -1543,6 +1561,7 @@ export type GetAssetDescription_DispatchCompute = {
1543
1561
  type?: 3;
1544
1562
  };
1545
1563
  export type GetAssetDescription_BlitImage = {
1564
+ filter?: number;
1546
1565
  /** Source render target */
1547
1566
  inputRenderTargetIndices?: Array<number>;
1548
1567
  /** Destination render target */
@@ -1583,9 +1602,12 @@ export type GetAssetDescription_DrawFullscreen = {
1583
1602
  shaderRef?: string;
1584
1603
  type?: 8;
1585
1604
  };
1586
- export type GetAssetDescription_GenerateMipChain = {
1605
+ export type GetAssetDescription_BlitMipChain = {
1606
+ filter?: number;
1587
1607
  /** Source render target */
1588
1608
  inputRenderTargetIndices?: Array<number>;
1609
+ /** Mip generation mode */
1610
+ mode?: StrictUnion<0 | 1> & number;
1589
1611
  type?: 9;
1590
1612
  };
1591
1613
  export type GetAssetDescription_CopyToCubemapFace = {
@@ -1593,6 +1615,19 @@ export type GetAssetDescription_CopyToCubemapFace = {
1593
1615
  inputRenderTargetIndices?: Array<number>;
1594
1616
  type?: 10;
1595
1617
  };
1618
+ export type GetAssetDescription_DispatchMipChain = {
1619
+ /** Specialization constants values for the specified shader */
1620
+ constantsJson?: object;
1621
+ /** Data provided to the shader through the node data buffer */
1622
+ dataJson?: object;
1623
+ /** Source render target */
1624
+ inputRenderTargetIndices?: Array<number>;
1625
+ /** Mip generation mode */
1626
+ mode?: StrictUnion<0 | 1> & number;
1627
+ /** Unique identifier for the asset */
1628
+ shaderRef?: string;
1629
+ type?: 11;
1630
+ };
1596
1631
  export type GetAssetDescription_ClearImages = {
1597
1632
  /** Clear colors */
1598
1633
  clearColors?: Array<Array<number>>;
@@ -1653,7 +1688,7 @@ export type GetAssetDescription_ParameterDescriptor = {
1653
1688
  /** Categories */
1654
1689
  categories?: Array<string>;
1655
1690
  /** Parameter default value */
1656
- default?: StrictUnion<number | boolean | Array<number>>;
1691
+ default?: number | boolean | Array<number>;
1657
1692
  /** Whether this parameter (a render target or buffer) is the resource used to compute the number of dispatched workgroups for a compute shader, i.e. DispatchedGroups = referenceResource.size / workgroupSize (see compute_shader_size_reference's reference_resource) */
1658
1693
  isReferenceResource?: boolean;
1659
1694
  /** Parameter name */
@@ -1662,8 +1697,10 @@ export type GetAssetDescription_ParameterDescriptor = {
1662
1697
  nativeType: 'vec4' | 'vec3' | 'vec2' | 'float' | 'int32_t' | 'texture2d_ref' | 'render_target_index' | 'buffer_reference';
1663
1698
  /** Parameter offset in bytes */
1664
1699
  offset: number;
1700
+ /** Additional properties gating this parameter's relevance and/or driving how it's interpreted by tooling (e.g. the material editor) */
1701
+ properties?: GetAssetDescription_ParameterProperties;
1665
1702
  /** Parameter type */
1666
- type: 'vec4' | 'ivec4' | 'quat' | 'vec3' | 'ivec3' | 'color' | 'vec2' | 'ivec2' | 'float' | 'int' | 'uint' | 'bool' | 'texture' | 'render_target_index' | 'buffer';
1703
+ type: 'vec4' | 'ivec4' | 'quat' | 'color_alpha' | 'vec3' | 'ivec3' | 'color' | 'vec2' | 'ivec2' | 'float' | 'int' | 'uint' | 'bool' | 'texture' | 'render_target_index' | 'buffer';
1667
1704
  };
1668
1705
  export type GetAssetDescription_BufferProperties = {
1669
1706
  /** Number of elements in the buffer, or a [x, y] pair of factors applied to the viewport width and height (each rounded up and clamped to a minimum of 1, then multiplied) to compute the element count */
@@ -1673,6 +1710,14 @@ export type GetAssetDescription_BufferProperties = {
1673
1710
  /** How this buffer is going to be used */
1674
1711
  usage: number;
1675
1712
  };
1713
+ export type GetAssetDescription_ParameterProperties = {
1714
+ /** For a parameter of type "texture" or "render_target_index": the underlying pixel type's exact format */
1715
+ format?: 'int32' | 'uint32' | 'int64' | 'uint64' | 'float32' | 'float64' | 'vec2' | 'ivec2' | 'vec3' | 'ivec3' | 'vec4' | 'ivec4' | 'color3' | 'color4';
1716
+ /** For a parameter of type "buffer" or "render_target_index": how the underlying resource is accessed */
1717
+ openMode?: 'read' | 'write' | 'readwrite';
1718
+ /** Specialization constants gating this parameter's relevance: the key is a constant name, the value is what it must hold for the parameter to be relevant (e.g. shown in the material editor) */
1719
+ spec?: GetAssetDescription_Object;
1720
+ };
1676
1721
  export type GetAssetDescription_Scene = {
1677
1722
  /** Bounding box in local space */
1678
1723
  aabb: GetAssetDescription_Aabb;
@@ -1706,6 +1751,8 @@ export type GetAssetDescription_Shader = {
1706
1751
  computeSettings?: GetAssetDescription_ComputeShaderSettings;
1707
1752
  /** Data descriptor for specialization constants */
1708
1753
  constantDescriptor?: Array<GetAssetDescription_SpecializationConstantDescriptor>;
1754
+ /** GLSL extensions required by this shader, detected from the SPIR-V capabilities declared by its compiled modules */
1755
+ glslExtensions?: Array<GetAssetDescription_GlslExtension>;
1709
1756
  /** Data descriptor for material shaders */
1710
1757
  materialDescriptor?: Array<GetAssetDescription_ParameterDescriptor>;
1711
1758
  /** Descriptions of all modules that compose this shader */
@@ -1718,6 +1765,8 @@ export type GetAssetDescription_Shader = {
1718
1765
  nodeDataDescriptorHash?: number;
1719
1766
  /** The size in byte of the compiled shader code (accumulated size of all modules) */
1720
1767
  payloadSize?: number;
1768
+ /** Reference to the shader context associated with this shader. Only present for shaders that use one. */
1769
+ shaderContextRef?: string;
1721
1770
  /** Vulkan bit mask of all shader stages present in this shader */
1722
1771
  shaderStages?: number;
1723
1772
  /** Unique identifier for the asset */
@@ -1735,7 +1784,7 @@ export type GetAssetDescription_ComputeShaderSettings = {
1735
1784
  };
1736
1785
  export type GetAssetDescription_SpecializationConstantDescriptor = {
1737
1786
  /** Constant default value */
1738
- default: StrictUnion<number | boolean>;
1787
+ default: number | boolean;
1739
1788
  /** Description */
1740
1789
  description?: string;
1741
1790
  /** Display name */
@@ -1745,6 +1794,12 @@ export type GetAssetDescription_SpecializationConstantDescriptor = {
1745
1794
  /** Constant type */
1746
1795
  type: 'bool' | 'int' | 'uint' | 'float';
1747
1796
  };
1797
+ export type GetAssetDescription_GlslExtension = {
1798
+ /** SPIR-V capability id that requires this extension (e.g. 5347 for PhysicalStorageBufferAddresses) */
1799
+ capabilityId: number;
1800
+ /** GLSL extension name, e.g. "GL_EXT_buffer_reference" */
1801
+ name: string;
1802
+ };
1748
1803
  export type GetAssetDescription_ShaderModuleDescription = {
1749
1804
  /** Names of the bindings used by this module */
1750
1805
  bindings?: Array<string>;
@@ -1796,13 +1851,25 @@ export type GetAssetDescription_VertexAttributeDescriptor = {
1796
1851
  stride: number;
1797
1852
  };
1798
1853
  export type GetAssetDescription_ShaderContext = {
1799
- /** Data descriptor for this shader context */
1854
+ /** The fields every shader in this family reads as input */
1800
1855
  dataDescriptor?: Array<GetAssetDescription_ParameterDescriptor>;
1801
1856
  /** Name of the asset */
1802
1857
  name: string;
1858
+ /** The fields a material shader must produce. */
1859
+ outputDescriptor?: Array<GetAssetDescription_OutputFieldDescriptor>;
1803
1860
  /** Unique identifier for the asset */
1804
1861
  uuid: string;
1805
1862
  };
1863
+ export type GetAssetDescription_OutputFieldDescriptor = {
1864
+ /** Blend state of the attachment, no blending if absent */
1865
+ blendState?: GetAssetDescription_BlendState;
1866
+ /** What this field represents */
1867
+ description: string;
1868
+ /** Field name */
1869
+ name: string;
1870
+ /** Field data type */
1871
+ type: 'int8' | 'int16' | 'int32' | 'int64' | 'uint8' | 'uint16' | 'uint32' | 'uint64' | 'float16' | 'float32' | 'vec2' | 'ivec2' | 'vec3' | 'ivec3' | 'vec4' | 'ivec4';
1872
+ };
1806
1873
  export type GetAssetDescription_Skeleton = {
1807
1874
  /** Descriptions of all bones forming the skeleton */
1808
1875
  bones: Array<GetAssetDescription_Object>;
@@ -1912,7 +1979,7 @@ export type UpdateAssetDescription_Material = {
1912
1979
  };
1913
1980
  export type UpdateAssetDescription_RenderGraph = {
1914
1981
  /** All blend states */
1915
- blendStateDescriptions?: Array<UpdateAssetDescription_Object>;
1982
+ blendStateDescriptions?: Array<UpdateAssetDescription_BlendState>;
1916
1983
  /** Descriptions of all buffers */
1917
1984
  bufferDescriptions?: Array<UpdateAssetDescription_Object>;
1918
1985
  /** Conditions referenced by conditionIndex */
@@ -1926,7 +1993,7 @@ export type UpdateAssetDescription_RenderGraph = {
1926
1993
  /** Name of the asset */
1927
1994
  name: string;
1928
1995
  /** Descriptions of all nodes */
1929
- nodeDataDescriptions: Array<StrictUnion<UpdateAssetDescription_Viewport | UpdateAssetDescription_DrawBatch | UpdateAssetDescription_DrawBatchWithMaterials | UpdateAssetDescription_DispatchCompute | UpdateAssetDescription_BlitImage | UpdateAssetDescription_DispatchPointClouds | UpdateAssetDescription_CopyImage | UpdateAssetDescription_ResolveImage | UpdateAssetDescription_DrawFullscreen | UpdateAssetDescription_GenerateMipChain | UpdateAssetDescription_CopyToCubemapFace | UpdateAssetDescription_ClearImages | UpdateAssetDescription_FillBuffer | UpdateAssetDescription_DrawDebugLines | UpdateAssetDescription_DispatchDecals | UpdateAssetDescription_SetDepthBias | UpdateAssetDescription_DispatchRayTracing> & UpdateAssetDescription_Object>;
1996
+ nodeDataDescriptions: Array<StrictUnion<UpdateAssetDescription_Viewport | UpdateAssetDescription_DrawBatch | UpdateAssetDescription_DrawBatchWithMaterials | UpdateAssetDescription_DispatchCompute | UpdateAssetDescription_BlitImage | UpdateAssetDescription_DispatchPointClouds | UpdateAssetDescription_CopyImage | UpdateAssetDescription_ResolveImage | UpdateAssetDescription_DrawFullscreen | UpdateAssetDescription_BlitMipChain | UpdateAssetDescription_CopyToCubemapFace | UpdateAssetDescription_DispatchMipChain | UpdateAssetDescription_ClearImages | UpdateAssetDescription_FillBuffer | UpdateAssetDescription_DrawDebugLines | UpdateAssetDescription_DispatchDecals | UpdateAssetDescription_SetDepthBias | UpdateAssetDescription_DispatchRayTracing> & UpdateAssetDescription_Object>;
1930
1997
  /** The index of the render target used for occlusion */
1931
1998
  occlusionInputDepthRenderTargetIndex?: number;
1932
1999
  /** Descriptions of all render passes */
@@ -1938,24 +2005,34 @@ export type UpdateAssetDescription_RenderGraph = {
1938
2005
  /** All stencil states */
1939
2006
  stencilOpStateDescriptions?: Array<UpdateAssetDescription_Object>;
1940
2007
  };
1941
- export type UpdateAssetDescription_Object = {
1942
- /** Alpha blend operator */
2008
+ export type UpdateAssetDescription_BlendState = {
2009
+ /** Selects which blend operation is used to calculate the alpha values to write to the color attachment. */
1943
2010
  alphaBlendOp?: number;
1944
- /** Enable blending */
2011
+ /** Controls whether blending is enabled for the corresponding color attachment. If blending is not enabled, the source fragment’s color for that attachment is passed through unmodified. */
1945
2012
  blendEnable?: boolean;
1946
- /** Color blend operator */
2013
+ /** Selects which blend operation is used to calculate the RGB values to write to the color attachment. */
1947
2014
  colorBlendOp?: number;
1948
- /** Color write mask */
2015
+ /** Bitmask of VkColorComponentFlagBits specifying which of the R, G, B, and/or A components are enabled for writing, as described for the Color Write Mask. */
1949
2016
  colorWriteMask?: number;
1950
- /** Destination alpha blend factor */
2017
+ /** Selects which blend factor is used to determine the destination factor Da. */
1951
2018
  dstAlphaBlendFactor?: number;
1952
- /** Destination color blend factor */
2019
+ /** Selects which blend factor is used to determine the destination factors (Dr,Dg,Db). */
1953
2020
  dstColorBlendFactor?: number;
1954
- /** Source alpha blend factor */
2021
+ /** Selects which blend factor is used to determine the source factor Sa. */
1955
2022
  srcAlphaBlendFactor?: number;
1956
- /** Source color blend factor */
2023
+ /** Selects which blend factor is used to determine the source factors (Sr,Sg,Sb). */
1957
2024
  srcColorBlendFactor?: number;
1958
2025
  };
2026
+ export type UpdateAssetDescription_Object = {
2027
+ /** Number of elements in the buffer, or a [x, y] pair of factors applied to the viewport width and height (each rounded up and clamped to a minimum of 1, then multiplied) to compute the element count */
2028
+ elementCount?: StrictUnion<number | Array<number>>;
2029
+ /** Size in bytes of a single element in the buffer */
2030
+ elementSize?: number;
2031
+ /** Buffer name */
2032
+ name?: string;
2033
+ /** How this buffer is going to be used */
2034
+ usage?: number;
2035
+ };
1959
2036
  export type UpdateAssetDescription_Viewport = {
1960
2037
  type?: 0;
1961
2038
  };
@@ -1991,6 +2068,7 @@ export type UpdateAssetDescription_DispatchCompute = {
1991
2068
  type?: 3;
1992
2069
  };
1993
2070
  export type UpdateAssetDescription_BlitImage = {
2071
+ filter?: number;
1994
2072
  /** Source render target */
1995
2073
  inputRenderTargetIndices?: Array<number>;
1996
2074
  /** Destination render target */
@@ -2027,9 +2105,12 @@ export type UpdateAssetDescription_DrawFullscreen = {
2027
2105
  pipelineDescription?: UpdateAssetDescription_Object;
2028
2106
  type?: 8;
2029
2107
  };
2030
- export type UpdateAssetDescription_GenerateMipChain = {
2108
+ export type UpdateAssetDescription_BlitMipChain = {
2109
+ filter?: number;
2031
2110
  /** Source render target */
2032
2111
  inputRenderTargetIndices?: Array<number>;
2112
+ /** Mip generation mode */
2113
+ mode?: StrictUnion<0 | 1> & number;
2033
2114
  type?: 9;
2034
2115
  };
2035
2116
  export type UpdateAssetDescription_CopyToCubemapFace = {
@@ -2037,6 +2118,17 @@ export type UpdateAssetDescription_CopyToCubemapFace = {
2037
2118
  inputRenderTargetIndices?: Array<number>;
2038
2119
  type?: 10;
2039
2120
  };
2121
+ export type UpdateAssetDescription_DispatchMipChain = {
2122
+ /** Specialization constants values for the specified shader */
2123
+ constantsJson?: object;
2124
+ /** Data provided to the shader through the node data buffer */
2125
+ dataJson?: object;
2126
+ /** Source render target */
2127
+ inputRenderTargetIndices?: Array<number>;
2128
+ /** Mip generation mode */
2129
+ mode?: StrictUnion<0 | 1> & number;
2130
+ type?: 11;
2131
+ };
2040
2132
  export type UpdateAssetDescription_ClearImages = {
2041
2133
  /** Clear colors */
2042
2134
  clearColors?: Array<Array<number>>;
@@ -2093,7 +2185,7 @@ export type UpdateAssetDescription_ParameterDescriptor = {
2093
2185
  /** Categories */
2094
2186
  categories?: Array<string>;
2095
2187
  /** Parameter default value */
2096
- default?: StrictUnion<number | boolean | Array<number>>;
2188
+ default?: number | boolean | Array<number>;
2097
2189
  /** Whether this parameter (a render target or buffer) is the resource used to compute the number of dispatched workgroups for a compute shader, i.e. DispatchedGroups = referenceResource.size / workgroupSize (see compute_shader_size_reference's reference_resource) */
2098
2190
  isReferenceResource?: boolean;
2099
2191
  /** Parameter name */
@@ -2102,8 +2194,10 @@ export type UpdateAssetDescription_ParameterDescriptor = {
2102
2194
  nativeType: 'vec4' | 'vec3' | 'vec2' | 'float' | 'int32_t' | 'texture2d_ref' | 'render_target_index' | 'buffer_reference';
2103
2195
  /** Parameter offset in bytes */
2104
2196
  offset: number;
2197
+ /** Additional properties gating this parameter's relevance and/or driving how it's interpreted by tooling (e.g. the material editor) */
2198
+ properties?: UpdateAssetDescription_ParameterProperties;
2105
2199
  /** Parameter type */
2106
- type: 'vec4' | 'ivec4' | 'quat' | 'vec3' | 'ivec3' | 'color' | 'vec2' | 'ivec2' | 'float' | 'int' | 'uint' | 'bool' | 'texture' | 'render_target_index' | 'buffer';
2200
+ type: 'vec4' | 'ivec4' | 'quat' | 'color_alpha' | 'vec3' | 'ivec3' | 'color' | 'vec2' | 'ivec2' | 'float' | 'int' | 'uint' | 'bool' | 'texture' | 'render_target_index' | 'buffer';
2107
2201
  };
2108
2202
  export type UpdateAssetDescription_BufferProperties = {
2109
2203
  /** Number of elements in the buffer, or a [x, y] pair of factors applied to the viewport width and height (each rounded up and clamped to a minimum of 1, then multiplied) to compute the element count */
@@ -2113,6 +2207,14 @@ export type UpdateAssetDescription_BufferProperties = {
2113
2207
  /** How this buffer is going to be used */
2114
2208
  usage: number;
2115
2209
  };
2210
+ export type UpdateAssetDescription_ParameterProperties = {
2211
+ /** For a parameter of type "texture" or "render_target_index": the underlying pixel type's exact format */
2212
+ format?: 'int32' | 'uint32' | 'int64' | 'uint64' | 'float32' | 'float64' | 'vec2' | 'ivec2' | 'vec3' | 'ivec3' | 'vec4' | 'ivec4' | 'color3' | 'color4';
2213
+ /** For a parameter of type "buffer" or "render_target_index": how the underlying resource is accessed */
2214
+ openMode?: 'read' | 'write' | 'readwrite';
2215
+ /** Specialization constants gating this parameter's relevance: the key is a constant name, the value is what it must hold for the parameter to be relevant (e.g. shown in the material editor) */
2216
+ spec?: UpdateAssetDescription_Object;
2217
+ };
2116
2218
  /**
2117
2219
  * Updates the description of the specified asset.
2118
2220
  */