ContextQMD
Back to Exoplayer

Crop (ExoPlayer library)

docs/doc/reference/com/google/android/exoplayer2/effect/Crop.html

latest5.5 KB
Original Source

Package com.google.android.exoplayer2.effect

Class Crop

  • java.lang.Object

    • com.google.android.exoplayer2.effect.Crop

  • All Implemented Interfaces:GlEffect, GlMatrixTransformation, MatrixTransformation, Effect

[@Deprecated](https://developer.android.com/reference/java/lang/Deprecated.html "class or interface in java.lang")public final classCropextends[Object](https://developer.android.com/reference/java/lang/Object.html "class or interface in java.lang")implements[MatrixTransformation](MatrixTransformation.html "interface in com.google.android.exoplayer2.effect")

Deprecated. com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.

Specifies a crop to apply in the vertex shader.

The background color of the output frame will be black, with alpha = 0 if applicable.

Constructor Summary

Constructors | Constructor | Description | | --- | --- | | Crop​(float left, float right, float bottom, float top) | Deprecated.

Crops a smaller (or larger) frame, per normalized device coordinates (NDC), where the input frame corresponds to the square ranging from -1 to 1 on the x and y axes. |

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods | Modifier and Type | Method | Description | | --- | --- | --- | | Size | configure​(int inputWidth, int inputHeight) | Deprecated.

Configures the input and output dimensions. | | Matrix | getMatrix​(long presentationTimeUs) | Deprecated.

Returns the 3x3 transformation Matrix to apply to the frame with the given timestamp. | | boolean | isNoOp​(int inputWidth, int inputHeight) | Deprecated.

Returns whether a GlEffect applies no change at every timestamp. |

-

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

-

Methods inherited from interface com.google.android.exoplayer2.effect.GlMatrixTransformation

toGlShaderProgram

-

Methods inherited from interface com.google.android.exoplayer2.effect.MatrixTransformation

getGlMatrixArray

Constructor Detail

-

Crop

public Crop​(float left,
            float right,
            float bottom,
            float top)

Deprecated.

Crops a smaller (or larger) frame, per normalized device coordinates (NDC), where the input frame corresponds to the square ranging from -1 to 1 on the x and y axes.

left and bottom default to -1, and right and top default to 1, which corresponds to not applying any crop. To crop to a smaller subset of the input frame, use values between -1 and 1. To crop to a larger frame, use values below -1 and above 1.

Parameters:left - The left edge of the output frame, in NDC. Must be less than right.right - The right edge of the output frame, in NDC. Must be greater than left.bottom - The bottom edge of the output frame, in NDC. Must be less than top.top - The top edge of the output frame, in NDC. Must be greater than bottom.

Method Detail

-

configure

public[Size](../util/Size.html "class in com.google.android.exoplayer2.util")configure​(int inputWidth,
                      int inputHeight)

Deprecated.

Description copied from interface: GlMatrixTransformation

Configures the input and output dimensions.

Must be called before GlMatrixTransformation.getGlMatrixArray(long).

Specified by:configure in interface GlMatrixTransformationParameters:inputWidth - The input frame width, in pixels.inputHeight - The input frame height, in pixels.Returns:The output frame width and height, in pixels.

-

getMatrix

public[Matrix](https://developer.android.com/reference/android/graphics/Matrix.html "class or interface in android.graphics")getMatrix​(long presentationTimeUs)

Deprecated.

Description copied from interface: MatrixTransformation

Returns the 3x3 transformation Matrix to apply to the frame with the given timestamp. Specified by:getMatrix in interface MatrixTransformation

-

isNoOp

public boolean isNoOp​(int inputWidth,
                      int inputHeight)

Deprecated.

Description copied from interface: GlEffect

Returns whether a GlEffect applies no change at every timestamp.

This can be used as a hint to skip this instance.

Specified by:isNoOp in interface GlEffectParameters:inputWidth - The input frame width, in pixels.inputHeight - The input frame height, in pixels.