SKCanvas.Discard Method

Definition

Makes the canvas contents undefined.

public void Discard ();

Remarks

Subsequent calls that read the canvas pixels, such as drawing with SKBlendMode, return undefined results. Calling this method does not change clip or matrix and may do nothing, depending on the implementation of the underlying SKSurface.

Discard() allows optimized performance on subsequent draws by removing cached data associated with the underlying SKSurface. It is not necessary to call Discard() once done with SKCanvas; any cached data is deleted when the owning SKSurface is deleted.

Applies to