CustomSampler
Custom CPU Profiler label used for profiling arbitrary code blocks.
Read time 1 minuteLast updated 6 days ago
Definition
- Type: Class
- Namespace: UnityEngine.Profiling
- Assembly: UnityEngine.CoreModule
- Inherits from: Sampler
public sealed class CustomSampler : Sampler
Remarks
Use CustomSampler to measure execution time of script code blocks. Produced information is displayed in the CPU Profiler and can be captured with Recorder.
Using CustomSampler is more efficient than using Profiler.BeginSample to profile your code. This is because CustomSamplers that have been created in advance have very low CustomSampler.Begin call overhead compared to Profiler.BeginSample.
using UnityEngine;using UnityEngine.Profiling;public class ExampleClass : MonoBehaviour{ CustomSampler sampler; void Start() { sampler = CustomSampler.Create("MyCustomSampler"); } void Update() { sampler.Begin(); // do something that takes a lot of time sampler.End(); }}
CustomSampler.Begin is conditionally compiled away using ConditionalAttribute. Thus it will have zero overhead, when it is deployed in non-Development Build.
Methods
Method | Description |
|---|---|
| Begin | Begin profiling a piece of code with a custom label defined by this instance of CustomSampler. |
| End | End profiling a piece of code with a custom label. |
Static Methods
Method | Description |
|---|---|
| Create | Creates a new CustomSampler for profiling parts of your code. |