Class TransformationRequest.Builder
- java.lang.Object
-
- com.google.android.exoplayer2.transformer.TransformationRequest.Builder
-
- Enclosing class:
- TransformationRequest
public static final class TransformationRequest.Builder extends Object
A builder forTransformationRequestinstances.
-
-
Constructor Summary
Constructors Constructor Description Builder()Creates a new instance with default values.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description TransformationRequestbuild()Builds aTransformationRequestinstance.TransformationRequest.Builderexperimental_setEnableHdrEditing(boolean enableHdrEditing)Sets whether to attempt to process any input video stream as a high dynamic range (HDR) signal.TransformationRequest.BuildersetAudioMimeType(String audioMimeType)Sets the audio MIME type of the output.TransformationRequest.BuildersetFlattenForSlowMotion(boolean flattenForSlowMotion)Sets whether the input should be flattened for media containing slow motion markers.TransformationRequest.BuildersetResolution(int outputHeight)Sets the output resolution using the output height.TransformationRequest.BuildersetTransformationMatrix(Matrix transformationMatrix)Sets the transformation matrix.TransformationRequest.BuildersetVideoMimeType(String videoMimeType)Sets the video MIME type of the output.
-
-
-
Constructor Detail
-
Builder
public Builder()
Creates a new instance with default values.Use
TransformationRequest.buildUpon()to obtain a builder representing an existingTransformationRequest.
-
-
Method Detail
-
setTransformationMatrix
public TransformationRequest.Builder setTransformationMatrix(Matrix transformationMatrix)
Sets the transformation matrix. The default value is to apply no change.This can be used to perform operations supported by
Matrix, like scaling and rotating the video.The video dimensions will be on the x axis, from -aspectRatio to aspectRatio, and on the y axis, from -1 to 1.
For now, resolution will not be affected by this method.
- Parameters:
transformationMatrix- The transformation to apply to video frames.- Returns:
- This builder.
-
setFlattenForSlowMotion
public TransformationRequest.Builder setFlattenForSlowMotion(boolean flattenForSlowMotion)
Sets whether the input should be flattened for media containing slow motion markers. The transformed output is obtained by removing the slow motion metadata and by actually slowing down the parts of the video and audio streams defined in this metadata. The default value forflattenForSlowMotionisfalse.Only Samsung Extension Format (SEF) slow motion metadata type is supported. The transformation has no effect if the input does not contain this metadata type.
For SEF slow motion media, the following assumptions are made on the input:
- The input container format is (unfragmented) MP4.
- The input contains an AVC video elementary stream with temporal SVC.
- The recording frame rate of the video is 120 or 240 fps.
If specifying a
MediaSource.FactoryusingTransformer.Builder.setMediaSourceFactory(MediaSource.Factory), make sure thatMp4Extractor.FLAG_READ_SEF_DATAis set on theMp4Extractorused. Otherwise, the slow motion metadata will be ignored and the input won't be flattened.- Parameters:
flattenForSlowMotion- Whether to flatten for slow motion.- Returns:
- This builder.
-
setResolution
public TransformationRequest.Builder setResolution(int outputHeight)
Sets the output resolution using the output height. The default valueC.LENGTH_UNSETcorresponds to using the same height as the input. Output width will scale to preserve the input video's aspect ratio.For now, only "popular" heights like 144, 240, 360, 480, 720, 1080, 1440, or 2160 are supported, to ensure compatibility on different devices.
For example, a 1920x1440 video can be scaled to 640x480 by calling setResolution(480).
- Parameters:
outputHeight- The output height in pixels.- Returns:
- This builder.
- Throws:
IllegalArgumentException- If theoutputHeightis not supported.
-
setVideoMimeType
public TransformationRequest.Builder setVideoMimeType(@Nullable String videoMimeType)
Sets the video MIME type of the output. The default value isnullwhich corresponds to using the same MIME type as the input. Supported MIME types are:MimeTypes.VIDEO_H263MimeTypes.VIDEO_H264MimeTypes.VIDEO_H265from API level 24MimeTypes.VIDEO_MP4V
- Parameters:
videoMimeType- The MIME type of the video samples in the output.- Returns:
- This builder.
- Throws:
IllegalArgumentException- If thevideoMimeTypeis non-null but not a videoMIME type.
-
setAudioMimeType
public TransformationRequest.Builder setAudioMimeType(@Nullable String audioMimeType)
Sets the audio MIME type of the output. The default value isnullwhich corresponds to using the same MIME type as the input. Supported MIME types are:- Parameters:
audioMimeType- The MIME type of the audio samples in the output.- Returns:
- This builder.
- Throws:
IllegalArgumentException- If theaudioMimeTypeis non-null but not an audioMIME type.
-
experimental_setEnableHdrEditing
public TransformationRequest.Builder experimental_setEnableHdrEditing(boolean enableHdrEditing)
Sets whether to attempt to process any input video stream as a high dynamic range (HDR) signal.This method is experimental, and will be renamed or removed in a future release. The HDR editing feature is under development and is intended for developing/testing HDR processing and encoding support.
- Parameters:
enableHdrEditing- Whether to attempt to process any input video stream as a high dynamic range (HDR) signal.- Returns:
- This builder.
-
build
public TransformationRequest build()
Builds aTransformationRequestinstance.
-
-