Composition.Builder

public Builder(List<EditedMediaItemSequence> sequences)

Creates an instance.

public Builder(
    EditedMediaItemSequence sequence,
    EditedMediaItemSequence[] sequences
)

Creates an instance.

public Composition build()

Builds a Composition instance.

@CanIgnoreReturnValue
public Composition.Builder experimentalSetRetainHdrFromUltraHdrImage(
    boolean retainHdrFromUltraHdrImage
)

Sets whether to use produce an HDR output video from Ultra HDR image input.

If the HdrMode is HDR_MODE_KEEP_HDR, then setting this to true applies the recovery map (i.e. the gainmap) to the base image to produce HDR video frames. This is automatically overridden to true, if the first asset is a HDR video.

The output video will have the same color encoding as the first EditedMediaItem the sequence. If the Ultra HDR image is first in the sequence, output video will default to BT2020 HLG full range colors.

Ignored if HdrMode is not HDR_MODE_KEEP_HDR.

Supported on API 34+, by some device and HDR format combinations. Ignored if unsupported by device or API level.

The default value is false.

@CanIgnoreReturnValue
public Composition.Builder setEffects(Effects effects)

Sets the Effects to apply to the Composition.

The default value is EMPTY.

@CanIgnoreReturnValue
public Composition.Builder setHdrMode(@Composition.HdrMode int hdrMode)

Sets the HdrMode for HDR video input.

The default value is HDR_MODE_KEEP_HDR. Apps that need to tone-map HDR to SDR should generally prefer HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL over HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC, because its behavior is likely to be more consistent across devices.

@CanIgnoreReturnValue
public Composition.Builder setTransmuxAudio(boolean transmuxAudio)

Sets whether to transmux the media items' audio tracks.

The default value is false.

If the Composition contains one MediaItem, the value set is ignored. The audio track will only be transcoded if necessary.

If the input Composition contains multiple media items, all the audio tracks are transcoded by default. They are all transmuxed if transmuxAudio is true. Transmuxed tracks must be compatible (typically, all the MediaItem instances containing the track to transmux are concatenated in a single EditedMediaItemSequence and have the same sample format for that track). Any transcoding effects requested will be ignored.

Requesting audio transmuxing while also requiring silence generation is not allowed, as generating silence requires transcoding. Silence generation is needed when a sequence has TRACK_TYPE_AUDIO and contains gaps or an audio-less EditedMediaItem.

@CanIgnoreReturnValue
public Composition.Builder setTransmuxVideo(boolean transmuxVideo)

Sets whether to transmux the media items' video tracks.

The default value is false.

If the Composition contains one MediaItem, the value set is ignored. The video track will only be transcoded if necessary.

If the input Composition contains multiple media items, all the video tracks are transcoded by default. They are all transmuxed if transmuxVideo is true. Transmuxed tracks must be compatible (typically, all the MediaItem instances containing the track to transmux are concatenated in a single EditedMediaItemSequence and have the same sample format for that track). Any transcoding effects requested will be ignored.

@CanIgnoreReturnValue
public Composition.Builder setVideoCompositorSettings(
    VideoCompositorSettings videoCompositorSettings
)

Sets the VideoCompositorSettings to apply to the Composition.

The default value is DEFAULT.