Structured
GraphicsBuffer can be used as a structured buffer.
Read time 1 minuteLast updated 4 days ago
Definition
- Type: Field
- Namespace: UnityEngine
- Assembly: UnityEngine.CoreModule
Structured = 16
Remarks
In HLSL shaders, this maps to or .
StructuredBuffer<T>RWStructuredBuffer<T>When you construct a GraphicsBuffer of this type, the value of must match the stride of the corresponding struct type in your HLSL code.
strideStructuredBufferThe value of must also be a multiple of 4, and less than 2048.
strideTo meet requirements on some platforms and avoid performance issues, should be a multiple of 16. Use float4 and float4x4 variables to create a multiple of 16, and put smaller variables inside them. Avoid the use of 'padding' variables to create a multiple of 16, for example using a float3 variable to pad a struct containing a single float, because some data types may be different sizes on different platforms.
strideIf you use a mix of variable sizes, the data layout of a shader's structured buffer may be different depending on the graphics API. This means ComputeShader.SetBuffer or Material.SetBuffer might overwrite data or set variables to the wrong values. See Writing shaders for different graphics APIs for more information.
See Microsoft's HLSL documentation on StructuredBuffer and RWStructuredBuffer.
DirectX 11 does not allow GraphicsBuffer.Target.Index or ::Vertex buffers to also be . For compute shader mesh data access with DirectX 11 compatibility, it is best to use GraphicsBuffer.Target.Raw.
Structured