CanvasDrawingSession.CreateLayer Method (Single, CanvasGeometry)

Creates a layer that will clip its contents to an arbitrarily complex region defined by a geometry, and blend using the specified opacity.

Namespace: Microsoft.Graphics.Canvas
Assembly: Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version: 0.0.0.0

Syntax

Copy

public CanvasActiveLayer CreateLayer(
	float opacity,
	CanvasGeometry clipGeometry
)

Parameters

opacity: Type: System.Single
clipGeometry: Type: Microsoft.Graphics.Canvas.Geometry.CanvasGeometry

Return Value

Type: CanvasActiveLayer

Remarks

The layer affects all drawing until the returned CanvasActiveLayer object is closed. In C# this is typically done with a 'using' statement, or in C++/CX the 'delete' keyword.

Antialising mode of the clip geometry is determined by the value of the Antialiasing property when CreateLayer is called.

For more information about layers, see CanvasActiveLayer.

Reference

CanvasDrawingSession Class

CreateLayer Overload

Microsoft.Graphics.Canvas Namespace

Microsoft.Graphics.Canvas.CanvasActiveLayer