Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


BeginSample

Adds a command to begin profile sampling.
Read time 3 minutesLast updated 6 days ago

Definition

BeginSample(string)

Adds a command to begin profile sampling.
public void BeginSample(string name)

Parameters

name

Name of the profile information used for sampling.

Remarks

Schedules a performance profiling sample to begin when the Command Buffer reaches this point. This is useful for measuring CPU and GPU time spent by one or more commands in the Command Buffer.
A profiling sample that starts with BeginSample must always end with a call to CommandBuffer.EndSample with the same argument.
When passing a
contextObject
, the Profiler associates the provided Unity Object (for example, a Texture or a Mesh) with the profiling sample. This is similar to the way that ProfilerMarker.Begin(Object) handles the
contextObject
parameter.

BeginSample(CustomSampler)

Adds a command to begin profile sampling.
public void BeginSample(CustomSampler sampler)

Parameters

The CustomSampler that the CommandBuffer uses for sampling.

Remarks

Schedules a performance profiling sample to begin when the Command Buffer reaches this point. This is useful for measuring CPU and GPU time spent by one or more commands in the Command Buffer.
A profiling sample that starts with BeginSample must always end with a call to CommandBuffer.EndSample with the same argument.
When passing a
contextObject
, the Profiler associates the provided Unity Object (for example, a Texture or a Mesh) with the profiling sample. This is similar to the way that ProfilerMarker.Begin(Object) handles the
contextObject
parameter.

BeginSample(ProfilerMarker)

Adds a command to begin profile sampling.
[Conditional("ENABLE_PROFILER")]public void BeginSample(ProfilerMarker marker)

Parameters

The ProfilerMarker that the CommandBuffer uses for sampling.

Remarks

Schedules a performance profiling sample to begin when the Command Buffer reaches this point. This is useful for measuring CPU and GPU time spent by one or more commands in the Command Buffer.
A profiling sample that starts with BeginSample must always end with a call to CommandBuffer.EndSample with the same argument.
When passing a
contextObject
, the Profiler associates the provided Unity Object (for example, a Texture or a Mesh) with the profiling sample. This is similar to the way that ProfilerMarker.Begin(Object) handles the
contextObject
parameter.

BeginSample(ProfilerMarker, Object)

Adds a command to begin profile sampling.
[Conditional("ENABLE_PROFILER")]public void BeginSample(ProfilerMarker marker, Object contextObject)

Parameters

The ProfilerMarker that the CommandBuffer uses for sampling.

contextObject

Object associated with the operation. The Profiler displays this object in the sample hierarchy, allowing you to identify which specific resource the sample was recorded for.

Remarks

Schedules a performance profiling sample to begin when the Command Buffer reaches this point. This is useful for measuring CPU and GPU time spent by one or more commands in the Command Buffer.
A profiling sample that starts with BeginSample must always end with a call to CommandBuffer.EndSample with the same argument.
When passing a
contextObject
, the Profiler associates the provided Unity Object (for example, a Texture or a Mesh) with the profiling sample. This is similar to the way that ProfilerMarker.Begin(Object) handles the
contextObject
parameter.