Version: 2022.1
LanguageEnglish
  • C#

GraphicsBuffer.CopyCount

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public static void CopyCount(ComputeBuffer src, ComputeBuffer dst, int dstOffsetBytes);

Declaration

public static void CopyCount(GraphicsBuffer src, ComputeBuffer dst, int dstOffsetBytes);

Declaration

public static void CopyCount(ComputeBuffer src, GraphicsBuffer dst, int dstOffsetBytes);

Declaration

public static void CopyCount(GraphicsBuffer src, GraphicsBuffer dst, int dstOffsetBytes);

Parameters

src The source GraphicsBuffer.
dst The destination GraphicsBuffer.
dstOffsetBytes The destination buffer offset in bytes.

Description

Copy the counter value of a GraphicsBuffer into another buffer.

Append/consume buffers (see GraphicsBuffer.Target.Append and counter buffers GraphicsBuffer.Target.Counter) keep track of the number of elements in them with a special counter variable. CopyCount takes such a buffer as src, and copies its counter value into dst buffer at given byte offset.

This is most commonly used in conjunction with Graphics.RenderPrimitivesIndirect, to render an arbitrary number of primitives without reading their count back to the CPU.

The src buffer must have been created with a usage target of GraphicsBuffer.Target.Append or GraphicsBuffer.Target.Counter.

On DirectX 11 and 12, the dst buffer must have been created with a usage target of GraphicsBuffer.Target.Raw or GraphicsBuffer.Target.IndirectArguments. For other graphics APIs, there is no such restriction.

See Also: SetCounterValue.