CustomSampler.Begin

Description

Begin profiling a piece of code with a custom label defined by this instance of CustomSampler.

This will show up in the Profiler hierarchy.

#pragma strict
var sampler: CustomSampler;
function Start() {
	sampler = CustomSampler.Create("MyCustomSampler");
}
function Update() {
	sampler.Begin();
	// do something that takes a lot of time
	sampler.End();
}

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();
    }
}

Profiler.BeginSample is conditionally compiled away using ConditionalAttribute. Thus it will have zero overhead, when it is deployed in non-Development Build.

See Also: CustomSampler.End, CustomSampler.Create, ProfilerCPU.