Transformer: Split javadoc summary fragment and descriptive text.
PiperOrigin-RevId: 435368283
This commit is contained in:
huangdarwin
Ian Baker
parent
3848595377
commit
481b9bd63d
@ -119,7 +119,8 @@ public final class GlUtil {
|
||||
|
||||
/**
|
||||
* Returns whether creating a GL context with {@value #EXTENSION_PROTECTED_CONTENT} is possible.
|
||||
* If {@code true}, the device supports a protected output path for DRM content when using GL.
|
||||
*
|
||||
* <p>If {@code true}, the device supports a protected output path for DRM content when using GL.
|
||||
*/
|
||||
public static boolean isProtectedContentExtensionSupported(Context context) {
|
||||
if (Util.SDK_INT < 24) {
|
||||
|
||||
@ -43,8 +43,9 @@ import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
|
||||
private static final String FRAGMENT_SHADER_PATH = "shaders/fragment_shader_copy_es2.glsl";
|
||||
|
||||
/**
|
||||
* Returns a 4x4, column-major Matrix float array, from an input {@link Matrix}. This is useful
|
||||
* for converting to the 4x4 column-major format commonly used in OpenGL.
|
||||
* Returns a 4x4, column-major Matrix float array, from an input {@link Matrix}.
|
||||
*
|
||||
* <p>This is useful for converting to the 4x4 column-major format commonly used in OpenGL.
|
||||
*/
|
||||
private static float[] getGlMatrixArray(Matrix matrix) {
|
||||
float[] matrix3x3Array = new float[9];
|
||||
|
||||
@ -194,9 +194,10 @@ public final class DefaultEncoderFactory implements Codec.EncoderFactory {
|
||||
}
|
||||
|
||||
/**
|
||||
* Finds a {@link MediaCodecInfo encoder} that supports the requested format most closely. Returns
|
||||
* the {@link MediaCodecInfo encoder} and the supported {@link Format} in a {@link Pair}, or
|
||||
* {@code null} if none is found.
|
||||
* Finds a {@link MediaCodecInfo encoder} that supports the requested format most closely.
|
||||
*
|
||||
* <p>Returns the {@link MediaCodecInfo encoder} and the supported {@link Format} in a {@link
|
||||
* Pair}, or {@code null} if none is found.
|
||||
*/
|
||||
@RequiresNonNull("#1.sampleMimeType")
|
||||
@Nullable
|
||||
|
||||
@ -62,7 +62,9 @@ public final class TransformationRequest {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the transformation matrix. The default value is to apply no change.
|
||||
* Sets the transformation matrix.
|
||||
*
|
||||
* <p>The default value is to apply no change.
|
||||
*
|
||||
* <p>This can be used to perform operations supported by {@link Matrix}, like scaling and
|
||||
* rotating the video.
|
||||
@ -84,10 +86,11 @@ public final class TransformationRequest {
|
||||
}
|
||||
|
||||
/**
|
||||
* 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 for
|
||||
* {@code flattenForSlowMotion} is {@code false}.
|
||||
* Sets whether the input should be flattened for media containing slow motion markers.
|
||||
*
|
||||
* <p>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 for {@code flattenForSlowMotion} is {@code false}.
|
||||
*
|
||||
* <p>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.
|
||||
@ -114,9 +117,11 @@ public final class TransformationRequest {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the output resolution using the output height. The default value {@link C#LENGTH_UNSET}
|
||||
* corresponds to using the same height as the input. Output width of the displayed video will
|
||||
* scale to preserve the video's aspect ratio after other transformations.
|
||||
* Sets the output resolution using the output height.
|
||||
*
|
||||
* <p>The default value {@link C#LENGTH_UNSET} corresponds to using the same height as the
|
||||
* input. Output width of the displayed video will scale to preserve the video's aspect ratio
|
||||
* after other transformations.
|
||||
*
|
||||
* <p>For example, a 1920x1440 video can be scaled to 640x480 by calling setResolution(480).
|
||||
*
|
||||
@ -130,8 +135,10 @@ public final class TransformationRequest {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the video MIME type of the output. The default value is {@code null} which corresponds
|
||||
* to using the same MIME type as the input. Supported MIME types are:
|
||||
* Sets the video MIME type of the output.
|
||||
*
|
||||
* <p>The default value is {@code null} which corresponds to using the same MIME type as the
|
||||
* input. Supported MIME types are:
|
||||
*
|
||||
* <ul>
|
||||
* <li>{@link MimeTypes#VIDEO_H263}
|
||||
@ -154,8 +161,10 @@ public final class TransformationRequest {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the audio MIME type of the output. The default value is {@code null} which corresponds
|
||||
* to using the same MIME type as the input. Supported MIME types are:
|
||||
* Sets the audio MIME type of the output.
|
||||
*
|
||||
* <p>The default value is {@code null} which corresponds to using the same MIME type as the
|
||||
* input. Supported MIME types are:
|
||||
*
|
||||
* <ul>
|
||||
* <li>{@link MimeTypes#AUDIO_AAC}
|
||||
|
||||
@ -177,9 +177,10 @@ public final class Transformer {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the {@link MediaSource.Factory} to be used to retrieve the inputs to transform. The
|
||||
* default value is a {@link DefaultMediaSourceFactory} built with the context provided in
|
||||
* {@link #Builder(Context) the constructor}.
|
||||
* Sets the {@link MediaSource.Factory} to be used to retrieve the inputs to transform.
|
||||
*
|
||||
* <p>The default value is a {@link DefaultMediaSourceFactory} built with the context provided
|
||||
* in {@link #Builder(Context) the constructor}.
|
||||
*
|
||||
* @param mediaSourceFactory A {@link MediaSource.Factory}.
|
||||
* @return This builder.
|
||||
@ -190,7 +191,9 @@ public final class Transformer {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets whether to remove the audio from the output. The default value is {@code false}.
|
||||
* Sets whether to remove the audio from the output.
|
||||
*
|
||||
* <p>The default value is {@code false}.
|
||||
*
|
||||
* <p>The audio and video cannot both be removed because the output would not contain any
|
||||
* samples.
|
||||
@ -204,7 +207,9 @@ public final class Transformer {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets whether to remove the video from the output. The default value is {@code false}.
|
||||
* Sets whether to remove the video from the output.
|
||||
*
|
||||
* <p>The default value is {@code false}.
|
||||
*
|
||||
* <p>The audio and video cannot both be removed because the output would not contain any
|
||||
* samples.
|
||||
@ -289,9 +294,10 @@ public final class Transformer {
|
||||
|
||||
/**
|
||||
* Sets the {@link Looper} that must be used for all calls to the transformer and that is used
|
||||
* to call listeners on. The default value is the Looper of the thread that this builder was
|
||||
* created on, or if that thread does not have a Looper, the Looper of the application's main
|
||||
* thread.
|
||||
* to call listeners on.
|
||||
*
|
||||
* <p>The default value is the Looper of the thread that this builder was created on, or if that
|
||||
* thread does not have a Looper, the Looper of the application's main thread.
|
||||
*
|
||||
* @param looper A {@link Looper}.
|
||||
* @return This builder.
|
||||
@ -303,8 +309,9 @@ public final class Transformer {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the {@link Codec.EncoderFactory} that will be used by the transformer. The default value
|
||||
* is {@link Codec.EncoderFactory#DEFAULT}.
|
||||
* Sets the {@link Codec.EncoderFactory} that will be used by the transformer.
|
||||
*
|
||||
* <p>The default value is {@link Codec.EncoderFactory#DEFAULT}.
|
||||
*
|
||||
* @param encoderFactory The {@link Codec.EncoderFactory} instance.
|
||||
* @return This builder.
|
||||
@ -316,8 +323,10 @@ public final class Transformer {
|
||||
|
||||
/**
|
||||
* Sets a provider for views to show diagnostic information (if available) during
|
||||
* transformation. This is intended for debugging. The default value is {@link
|
||||
* DebugViewProvider#NONE}, which doesn't show any debug info.
|
||||
* transformation.
|
||||
*
|
||||
* <p>This is intended for debugging. The default value is {@link DebugViewProvider#NONE}, which
|
||||
* doesn't show any debug info.
|
||||
*
|
||||
* <p>Not all transformations will result in debug views being populated.
|
||||
*
|
||||
@ -330,8 +339,9 @@ public final class Transformer {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the {@link Clock} that will be used by the transformer. The default value is {@link
|
||||
* Clock#DEFAULT}.
|
||||
* Sets the {@link Clock} that will be used by the transformer.
|
||||
*
|
||||
* <p>The default value is {@link Clock#DEFAULT}.
|
||||
*
|
||||
* @param clock The {@link Clock} instance.
|
||||
* @return This builder.
|
||||
@ -344,8 +354,9 @@ public final class Transformer {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the factory for muxers that write the media container. The default value is a {@link
|
||||
* FrameworkMuxer.Factory}.
|
||||
* Sets the factory for muxers that write the media container.
|
||||
*
|
||||
* <p>The default value is a {@link FrameworkMuxer.Factory}.
|
||||
*
|
||||
* @param muxerFactory A {@link Muxer.Factory}.
|
||||
* @return This builder.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user