TransformerUtil

Artifact: androidx.media3:media3-transformer

Kotlin |Java

@UnstableApi
public final class TransformerUtil

Utility methods for Transformer.

Summary

Public methods
`static ColorInfo`	`getDecoderOutputColor( ColorInfo decoderInputColor, boolean isMediaCodecToneMappingRequested )` Returns the decoder output color taking tone mapping into account.
`static @Nullable String`	`getImageMimeType(Context context, MediaItem mediaItem)` Returns the image MIME type corresponding to a `MediaItem`.
`static int`	`getMediaCodecFlags(@C.BufferFlags int flags)` Returns `MediaCodec` flags corresponding to `C.BufferFlags`.
`static Pair<String, Integer>`	`getOutputMimeTypeAndHdrModeAfterFallback( @Composition.HdrMode int hdrMode, String requestedOutputMimeType, @Nullable ColorInfo colorInfo )` Calculate what the MIME type and `HdrMode` to use, applying fallback measure if necessary.
`static int`	`@C.TrackType getProcessedTrackType(@Nullable String mimeType)` Returns the `track type` constant corresponding to how a specified MIME type should be processed, which may be `TRACK_TYPE_UNKNOWN` if it could not be determined.
`static ColorInfo`	`getValidColor(@Nullable ColorInfo colorInfo)` Adjust for invalid `ColorInfo` values, by defaulting to `SDR_BT709_LIMITED`.
`static boolean`	`isImage(Context context, MediaItem mediaItem)` Returns whether the provided `MediaItem` corresponds to an image.
`static void`	`maybeSetMuxerWrapperAdditionalRotationDegrees( MuxerWrapper muxerWrapper, ImmutableList<Effect> videoEffects, Format inputFormat )` Sets `the additionalRotationDegrees` on the given `MuxerWrapper` if the given `videoEffects` only contains a mix of regular rotations and no-ops.
`static boolean`	`shouldTranscodeAudio( Format inputFormat, Composition composition, int sequenceIndex, TransformationRequest transformationRequest, Codec.EncoderFactory encoderFactory, MuxerWrapper muxerWrapper )` Returns whether the audio track should be transcoded.
`static boolean`	`shouldTranscodeVideo( Format inputFormat, Composition composition, int sequenceIndex, TransformationRequest transformationRequest, Codec.EncoderFactory encoderFactory, MuxerWrapper muxerWrapper )` Returns whether the video track should be transcoded.

Public methods

getDecoderOutputColor

public static ColorInfo getDecoderOutputColor(
    ColorInfo decoderInputColor,
    boolean isMediaCodecToneMappingRequested
)

Returns the decoder output color taking tone mapping into account.

getImageMimeType

public static @Nullable String getImageMimeType(Context context, MediaItem mediaItem)

Returns the image MIME type corresponding to a MediaItem.

This method only supports some common image MIME types.

Parameters
`Context context`	The `Context`.
`MediaItem mediaItem`	The `MediaItem` to inspect.

Returns
`@Nullable String`	The MIME type.

getMediaCodecFlags

public static int getMediaCodecFlags(@C.BufferFlags int flags)

Returns MediaCodec flags corresponding to C.BufferFlags.

getOutputMimeTypeAndHdrModeAfterFallback

public static Pair<String, Integer> getOutputMimeTypeAndHdrModeAfterFallback(
    @Composition.HdrMode int hdrMode,
    String requestedOutputMimeType,
    @Nullable ColorInfo colorInfo
)

Calculate what the MIME type and HdrMode to use, applying fallback measure if necessary.

Parameters
`@Composition.HdrMode int hdrMode`	The `HdrMode`.
`String requestedOutputMimeType`	The desired output MIME type.
`@Nullable ColorInfo colorInfo`	The `ColorInfo`.

Returns
`Pair<String, Integer>`	a `Pair` of the output MIME type and `HdrMode`.

getProcessedTrackType

@C.TrackType
public static int getProcessedTrackType(@Nullable String mimeType)

Returns the track type constant corresponding to how a specified MIME type should be processed, which may be TRACK_TYPE_UNKNOWN if it could not be determined.

Image MIME types are processed as TRACK_TYPE_VIDEO.

See getTrackType for more details.

getValidColor

public static ColorInfo getValidColor(@Nullable ColorInfo colorInfo)

Adjust for invalid ColorInfo values, by defaulting to SDR_BT709_LIMITED.

isImage

public static boolean isImage(Context context, MediaItem mediaItem)

Returns whether the provided MediaItem corresponds to an image.

maybeSetMuxerWrapperAdditionalRotationDegrees

public static void maybeSetMuxerWrapperAdditionalRotationDegrees(
    MuxerWrapper muxerWrapper,
    ImmutableList<Effect> videoEffects,
    Format inputFormat
)

Sets the additionalRotationDegrees on the given MuxerWrapper if the given videoEffects only contains a mix of regular rotations and no-ops. A regular rotation is a rotation divisible by 90 degrees.

shouldTranscodeAudio

public static boolean shouldTranscodeAudio(
    Format inputFormat,
    Composition composition,
    int sequenceIndex,
    TransformationRequest transformationRequest,
    Codec.EncoderFactory encoderFactory,
    MuxerWrapper muxerWrapper
)

Returns whether the audio track should be transcoded.

shouldTranscodeVideo

public static boolean shouldTranscodeVideo(
    Format inputFormat,
    Composition composition,
    int sequenceIndex,
    TransformationRequest transformationRequest,
    Codec.EncoderFactory encoderFactory,
    MuxerWrapper muxerWrapper
)

Returns whether the video track should be transcoded.