AvifWriter.Builder

Artifact: androidx.heifwriter:heifwriter

Kotlin |Java

class AvifWriter.Builder

Builder class for constructing a AvifWriter object from specified parameters.

Summary

Public constructors
`Builder( fd: FileDescriptor, width: @IntRange(from = 1) Int, height: @IntRange(from = 1) Int, inputMode: Int )` Construct a Builder with output specified by its file descriptor.
`Builder( path: String, width: @IntRange(from = 1) Int, height: @IntRange(from = 1) Int, inputMode: Int )` Construct a Builder with output specified by its path.

Public functions
`AvifWriter`	`build()` Build a AvifWriter object.
`AvifWriter.Builder`	`setGridEnabled(gridEnabled: Boolean)` Set whether to enable grid option.
`AvifWriter.Builder`	`setHandler(handler: Handler?)` Provide a handler for the AvifWriter to use.
`AvifWriter.Builder`	`setHighBitDepthEnabled(highBitDepthEnabled: Boolean)` Provide a setting for the AvifWriter to use high bit-depth or not.
`AvifWriter.Builder`	`setMaxImages(maxImages: @IntRange(from = 1) Int)` Set the maximum number of images to write.
`AvifWriter.Builder`	`setPrimaryIndex(primaryIndex: @IntRange(from = 0) Int)` Set the primary image index.
`AvifWriter.Builder`	`setQuality(quality: @IntRange(from = 0, to = 100) Int)` Set the quality for encoding images.
`AvifWriter.Builder`	`setRotation(rotation: @IntRange(from = 0) Int)` Set the image rotation in degrees.

Public constructors

Builder

Added in 1.1.0-alpha03

Builder(
    fd: FileDescriptor,
    width: @IntRange(from = 1) Int,
    height: @IntRange(from = 1) Int,
    inputMode: Int
)

Construct a Builder with output specified by its file descriptor.

Parameters
`fd: FileDescriptor`	File descriptor of the file to be written.
`width: @IntRange(from = 1) Int`	Width of the image in number of pixels.
`height: @IntRange(from = 1) Int`	Height of the image in number of pixels.
`inputMode: Int`	Input mode for this writer, must be one of `INPUT_MODE_BUFFER`, `INPUT_MODE_SURFACE`, or `INPUT_MODE_BITMAP`.

Builder

Added in 1.1.0-alpha03

Builder(
    path: String,
    width: @IntRange(from = 1) Int,
    height: @IntRange(from = 1) Int,
    inputMode: Int
)

Construct a Builder with output specified by its path.

Parameters
`path: String`	Path of the file to be written.
`width: @IntRange(from = 1) Int`	Width of the image in number of pixels.
`height: @IntRange(from = 1) Int`	Height of the image in number of pixels.
`inputMode: Int`	Input mode for this writer, must be one of `INPUT_MODE_BUFFER`, `INPUT_MODE_SURFACE`, or `INPUT_MODE_BITMAP`.

Public functions

build

Added in 1.1.0-alpha03

fun build(): AvifWriter

Build a AvifWriter object.

Returns
`AvifWriter`	a AvifWriter object built according to the specifications.

Throws
`java.io.IOException`	if failed to create the writer, possibly due to failure to create `android.media.MediaMuxer` or `android.media.MediaCodec`.

setGridEnabled

Added in 1.1.0-alpha03

fun setGridEnabled(gridEnabled: Boolean): AvifWriter.Builder

Set whether to enable grid option.

Parameters
`gridEnabled: Boolean`	Whether to enable grid option. If enabled, the tile size will be automatically chosen. Default is to enable.

Returns
`AvifWriter.Builder`	this Builder object.

setHandler

Added in 1.1.0-alpha03

fun setHandler(handler: Handler?): AvifWriter.Builder

Provide a handler for the AvifWriter to use.

Parameters
`handler: Handler?`	If not null, client will receive all callbacks on the handler's looper. Otherwise, client will receive callbacks on a looper created by the writer. Default is null.

Returns
`AvifWriter.Builder`	this Builder object.

setHighBitDepthEnabled

Added in 1.1.0-alpha03

fun setHighBitDepthEnabled(highBitDepthEnabled: Boolean): AvifWriter.Builder

Provide a setting for the AvifWriter to use high bit-depth or not.

Parameters
`highBitDepthEnabled: Boolean`	Whether to enable high bit-depth mode. Default is false, if true, AvifWriter will encode with high bit-depth.

Returns
`AvifWriter.Builder`	this Builder object.

setMaxImages

Added in 1.1.0-alpha03

fun setMaxImages(maxImages: @IntRange(from = 1) Int): AvifWriter.Builder

Set the maximum number of images to write.

Parameters
`maxImages: @IntRange(from = 1) Int`	Max number of images to write. Frames exceeding this number will not be written to file. The writing can be stopped earlier before this number of images are written by `stop`, except for the input mode of `INPUT_MODE_SURFACE`, where the EOS timestamp must be specified (via `setInputEndOfStreamTimestamp` and reached. Default is 1.

Returns
`AvifWriter.Builder`	this Builder object.

setPrimaryIndex

Added in 1.1.0-alpha03

fun setPrimaryIndex(primaryIndex: @IntRange(from = 0) Int): AvifWriter.Builder

Set the primary image index.

Parameters
`primaryIndex: @IntRange(from = 0) Int`	Index of the image that should be marked as primary, must be within range [0, maxImages - 1] inclusive. Default is 0.

Returns
`AvifWriter.Builder`	this Builder object.

setQuality

Added in 1.1.0-alpha03

fun setQuality(quality: @IntRange(from = 0, to = 100) Int): AvifWriter.Builder

Set the quality for encoding images.

Parameters
`quality: @IntRange(from = 0, to = 100) Int`	A number between 0 and 100 (inclusive), with 100 indicating the best quality supported by this implementation. Default is 100.

Returns
`AvifWriter.Builder`	this Builder object.

setRotation

Added in 1.1.0-alpha03

fun setRotation(rotation: @IntRange(from = 0) Int): AvifWriter.Builder

Set the image rotation in degrees.

Parameters
`rotation: @IntRange(from = 0) Int`	Rotation angle in degrees (clockwise) of the image, must be 0, 90, 180 or 270. Default is 0.

Returns
`AvifWriter.Builder`	this Builder object.