CanvasBitmap.LoadAsync Method (ICanvasResourceCreator, String, Single, CanvasAlphaMode)

Loads a bitmap from an image file (jpeg, png, etc.), and assigns it the specified DPI and alpha behavior.

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

Syntax

Copy

public static IAsyncOperation<CanvasBitmap> LoadAsync(
	ICanvasResourceCreator resourceCreator,
	string fileName,
	float dpi,
	CanvasAlphaMode alpha
)

Parameters

resourceCreator: Type: Microsoft.Graphics.Canvas.ICanvasResourceCreator
fileName: Type: System.String
dpi: Type: System.Single
alpha: Type: Microsoft.Graphics.Canvas.CanvasAlphaMode

Return Value

Type: IAsyncOperation<CanvasBitmap>

Remarks

When loading a JpegXR format bitmap that contains high dynamic range (HDR) pixel data, the loaded bitmap may use one of the pixel formats:

DirectXPixelFormat.R16G16B16A16Float
DirectXPixelFormat.R32G32B32A32Float
DirectXPixelFormat.R16G16B16A16UIntNormalized

For all other file formats, or when the current device does not support high dynamic range pixel formats (as reported by IsPixelFormatSupported(DirectXPixelFormat)), the loaded bitmap will use DirectXPixelFormat.B8G8R8A8UIntNormalized.

Reference

CanvasBitmap Class

LoadAsync Overload

Microsoft.Graphics.Canvas Namespace