IStoredImageHandle.RequestTileAsync Method

Definition

Namespace: P1.CameraSdk

Request a tile : a (scaled) crop of the full image

public void RequestTileAsync(TileRequest tileArguments);

Tiles are a cropped and scaled jpeg encoded previews of the full image. The camera takes the requested crop of the image, scales it and, optionally, converts it to jpeg.

The crop is defined in full image coordinates, meaning the pixel range of the full (visible) image dimensions. Origo is upper left corner. Any scaling is applied after cropping, meaning that if the crop dimension is 100 px, scaling by 0.5 results in an output image that is ~50 px.

This method is asynchronous and will return immediately. The requested tile object is returned by a notification. To retrieve the object, you must listen for the EventType.CameraTileReady notification, before calling this method. Note that this notification EventType is shared with incoming previews.

Note that the camera might not (and will likely not), give the exact crop you requested. The resulting might differ a few pixels in offset or size. This is due performance optimizations in the image conversion pipeline. Speed is favoured over precision.

Parameters:

tileArguments

Specification of requested tile.