ImageInfo

fun getFlashState(): Int

Returns the androidx.camera.core.FlashState value corresponding to the image capture.

fun getRotationDegrees(): Int

Returns the rotation needed to transform the image to the correct orientation.

This is a clockwise rotation in degrees that needs to be applied to the image buffer. Note that for images that are in JPEG this value will match the rotation defined in the EXIF.

The target rotation is set at the time the image capture was requested.

The correct orientation of the image is dependent upon the producer of the image. For example, if the ImageProxy that contains this instance of ImageInfo is produced by an ImageCapture, then the rotation will be determined by setTargetRotation or setTargetRotation.

fun getSensorToBufferTransformMatrix(): Matrix

Returns the sensor to image buffer transform matrix.

The returned matrix is a mapping from sensor coordinates to buffer coordinates, which is, from the value of SENSOR_INFO_ACTIVE_ARRAY_SIZE to (0, 0, image.getWidth, image.getHeight). The matrix can be used to map the coordinates from one UseCase to another. For example, mapping coordinates of the face detected with ImageAnalysis to ImageCapture. If setOutputImageRotationEnabled is set to false, getRotationDegrees will return the rotation degree that needs to be applied to the image buffer to user. In this case, the transform matrix can be calculated using rotation degrees. If setOutputImageRotationEnabled is set to true, the ImageAnalysis pipeline will apply the rotation to the image buffer and getRotationDegrees will always return 0. In this case, the transform matrix cannot be calculated. This API provides the transform matrix which could handle both cases.

        // Calculate the matrix
        Matrix analysisToSensor = new Matrix();
        analysisToSensor.invert(
            imageAnalysisImageProxy.getImageInfo()
                                   .getSensorToBufferTransformMatrix());
        Matrix sensorToCapture = captureImageProxy.getImageInfo()
                                                  .getSensorToBufferTransformMatrix();
        Matrix analysisToCapture = new Matrix();
        analysisToCapture.setConcat(analysisToSensor, sensorToCapture);

        // Transforming the coordinates
        Rect faceBoundingBoxInAnalysis;
        Rect faceBoundingBoxInCapture;
        analysisToCapture.mapRect(faceBoundingBoxInAnalysis, faceBoundingBoxInCapture);

        // faceBoundingBoxInCapture is the desired value
    

fun getTimestamp(): Long

Returns the timestamp of the metadata. Details on the timestamp depend on the source providing the image, and the method providing the image contains more documentation.