DngCreator

MAX_THUMBNAIL_DIMENSION

static val MAX_THUMBNAIL_DIMENSION: Int

Max width or height dimension for thumbnails.

Value: 256

DngCreator

DngCreator(
    characteristics: CameraCharacteristics, 
    metadata: CaptureResult)

Create a new DNG object.

It is not necessary to call any set methods to write a well-formatted DNG file.

DNG metadata tags will be generated from the corresponding parameters in the android.hardware.camera2.CaptureResult object.

For best quality DNG files, it is strongly recommended that lens shading map output is enabled if supported. See CaptureRequest.STATISTICS_LENS_SHADING_MAP_MODE.

close

fun close(): Unit

setDescription

fun setDescription(description: String): DngCreator

Set the user description string to write.

This is equivalent to setting the TIFF "ImageDescription" tag (0x010E).

setLocation

fun setLocation(location: Location): DngCreator

Set image location metadata.

The given location object must contain at least a valid time, latitude, and longitude (equivalent to the values returned by android.location.Location#getTime(), android.location.Location#getLatitude(), and android.location.Location#getLongitude() methods).

setOrientation

fun setOrientation(orientation: Int): DngCreator

Set the orientation value to write.

This will be written as the TIFF "Orientation" tag (0x0112). Calling this will override any prior settings for this tag.

setThumbnail

fun setThumbnail(pixels: Bitmap): DngCreator

Set the thumbnail image.

Pixel data will be converted to a Baseline TIFF RGB image, with 8 bits per color channel. The alpha channel will be discarded. Thumbnail images with a dimension larger than MAX_THUMBNAIL_DIMENSION will be rejected.

setThumbnail

fun setThumbnail(pixels: Image): DngCreator

Set the thumbnail image.

Pixel data is interpreted as a android.graphics.ImageFormat#YUV_420_888 image. Thumbnail images with a dimension larger than MAX_THUMBNAIL_DIMENSION will be rejected.

writeByteBuffer

fun writeByteBuffer(
    dngOutput: OutputStream, 
    size: Size, 
    pixels: ByteBuffer, 
    offset: Long
): Unit

Write the android.graphics.ImageFormat#RAW_SENSOR pixel data to a DNG file with the currently configured metadata.

Raw pixel data must have 16 bits per pixel, and the input must contain at least offset + 2 * width * height) bytes. The width and height of the input are taken from the width and height set in the DngCreator metadata tags, and will typically be equal to the width and height of CameraCharacteristics.SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE. Prior to API level 23, this was always the same as CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE. The pixel layout in the input is determined from the reported color filter arrangement (CFA) set in CameraCharacteristics.SENSOR_INFO_COLOR_FILTER_ARRANGEMENT. If insufficient metadata is available to write a well-formatted DNG file, an java.lang.IllegalStateException will be thrown.

Any mark or limit set on this ByteBuffer is ignored, and will be cleared by this method.

writeImage

fun writeImage(
    dngOutput: OutputStream, 
    pixels: Image
): Unit

Write the pixel data to a DNG file with the currently configured metadata.

For this method to succeed, the android.media.Image input must contain android.graphics.ImageFormat#RAW_SENSOR pixel data, otherwise an java.lang.IllegalArgumentException will be thrown.

writeInputStream

fun writeInputStream(
    dngOutput: OutputStream, 
    size: Size, 
    pixels: InputStream, 
    offset: Long
): Unit

Write the android.graphics.ImageFormat#RAW_SENSOR pixel data to a DNG file with the currently configured metadata.

Raw pixel data must have 16 bits per pixel, and the input must contain at least offset + 2 * width * height) bytes. The width and height of the input are taken from the width and height set in the DngCreator metadata tags, and will typically be equal to the width and height of CameraCharacteristics.SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE. Prior to API level 23, this was always the same as CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE. The pixel layout in the input is determined from the reported color filter arrangement (CFA) set in CameraCharacteristics.SENSOR_INFO_COLOR_FILTER_ARRANGEMENT. If insufficient metadata is available to write a well-formatted DNG file, an java.lang.IllegalStateException will be thrown.

finalize

protected fun finalize(): Unit