cropImage method
Crops image according to the document boundary and size. Applying this operation removes empty fields around a detected document the and corrects perspective distortion if needed.
export async function cropImage(settings)
Parameters
- settings
- Object specifying parameters of the image crop operation (see Options).
Return values
The method returns result depending on how the image crop finished (see Result).
Options
The table below describes parameters that you can pass as the settings argument to change image crop settings. Omitting a parameter means that a default setting will be used.
Parameter | Value type | Description |
---|---|---|
licenseFileName | string |
The name of the license file. This file must be located in the /assets/ directory in your project. Default: "MobileCapture.License". |
imageUri | string |
imageUri (string): Image source for the operation passed as URI. This parameter can be set to the following values:
Required parameter. |
result | object |
Result image description, represented by the following parameters:
|
documentSize | string |
Document size represented by its width and height in millimeters. The values of the width and height are set to the documentSize parameters:
I.e., {x: 210; y: 297} for A4 document size. To leave the document size undefined, set both width and height to 0. In this case document of any size will be detected. |
documentBoundary | object |
Quadrangle containing the whole document. It is represented by an array of its four vertices' coordinates: { x: int, y: int }. The vertices are indexed clockwise starting from the bottom left. Default: coordinates of a quadrangle, containing the whole image. |
Result
This section describes the object that represents image capture results. Returned parameters depend on the scenario.
Parameter | Value type | Description |
---|---|---|
imageUri | string | Cropped image returned as URI. This image corresponds to the description in the passed result parameter. |
resolution | object | The image resolution as calculated from image size and physical page size. |
imageSize | object | Cropped image size represented by its width and height in pixels. The values of the width and height are stored in the following parameters:
|
Example of a result JSON.
02.03.2022 12:59:15