Instance Method

metadataOutputRectOfInterestForRect:

Converts a rectangle in the preview layer’s coordinate system to one in the coordinate system used for metadata outputs.

Declaration

- (CGRect)metadataOutputRectOfInterestForRect:(CGRect)rectInLayerCoordinates;

Parameters

rectInLayerCoordinates

A rectangle in the AVCaptureVideoPreviewLayer object’s coordinate system.

Return Value

A rectangle in the AVCaptureMetadataOutput coordinate system.

Discussion

The rectangle of interest for an AVCaptureMetadataOutput object is in a coordinate system extending from (0,0) in the top-left to (1,1) in the bottom-right, relative to the device’s natural orientation. A capture output object uses a pixel coordinate space which may be zoomed, rotated, or mirrored. Use this convenience method to quickly convert between coordinate spaces.

See Also

Converting Between Coordinate Systems

- captureDevicePointOfInterestForPoint:

Converts a point from layer coordinates to the coordinate space of the capture device.

- pointForCaptureDevicePointOfInterest:

Converts a point from the coordinate space of the capture device to the coordinate space of the layer.

- rectForMetadataOutputRectOfInterest:

Converts a rectangle in the coordinate system used for metadata outputs to one in the preview layer’s coordinate system.

- transformedMetadataObjectForMetadataObject:

Converts a metadata object’s visual properties to layer coordinates.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software