SingleInputVideoGraph

public SingleInputVideoGraph(
    Context context,
    VideoFrameProcessor.Factory videoFrameProcessorFactory,
    ColorInfo outputColorInfo,
    VideoGraph.Listener listener,
    DebugViewProvider debugViewProvider,
    Executor listenerExecutor,
    boolean renderFramesAutomatically
)

Creates an instance.

videoCompositorSettings must be DEFAULT.

public void flush()

Flushes the inputs of the VideoGraph.

public Surface getInputSurface(int inputIndex)

Returns the input Surface at inputIndex.

public int getPendingInputFrameCount(int inputIndex)

Returns the number of pending input frames at inputIndex that has not been processed yet.

public boolean hasProducedFrameWithTimestampZero()

Returns whether the VideoGraph has produced a frame with zero presentation timestamp.

public void initialize()

Initialize the VideoGraph}.

This method must be called before calling other methods.

If the method throws, the caller must call #release.

This method must be called at most once.

public boolean queueInputBitmap(
    int inputIndex,
    Bitmap inputBitmap,
    TimestampIterator timestampIterator
)

Queues the input Bitmap at inputIndex.

public boolean queueInputTexture(
    int inputIndex,
    int textureId,
    long presentationTimeUs
)

Queues the input texture at inputIndex.

public void redraw()

Updates an available frame with the modified effects.

public void registerInput(int inputIndex)

Registers a new input to the VideoGraph.

All inputs must be registered before rendering frames by calling registerInputFrame, queueInputBitmap or queueInputTexture.

If the method throws, the caller must call release.

public boolean registerInputFrame(int inputIndex)

Registers a new input frame at inputIndex.

public void registerInputStream(
    int inputIndex,
    @VideoFrameProcessor.InputType int inputType,
    Format format,
    List<Effect> effects,
    long offsetToAddUs
)

Informs the graph that a new input stream will be queued to the graph input corresponding to inputIndex.

After registering the first input stream, this method must only be called for the same index after the last frame of the already-registered input stream has been registered, last bitmap queued or last texture id queued.

This method blocks the calling thread until the previous input stream corresponding to the same inputIndex has been fully registered internally.

public void release()

Releases the associated resources.

This VideoGraph instance must not be used after this method is called.

public void renderOutputFrame(long renderTimeNs)

Renders the output frame from the VideoGraph.

This method must be called only for frames that have become available, calling the method renders the frame that becomes available the earliest but not yet rendered.

public void setCompositionEffects(List<Effect> compositionEffects)

Sets the Composition-level video effects that are applied after the effects on single input stream.

This method should be called before registerInputStream to set the desired composition level effects.

public void setCompositorSettings(VideoCompositorSettings videoCompositorSettings)

Sets the VideoCompositorSettings.

This method should be called before registerInputStream to set the desired composition level VideoCompositorSettings.

Setting a custom VideoCompositorSettings where supportsMultipleInputs returns false throws an IllegalArgumentException.

public void setOnInputFrameProcessedListener(
    int inputIndex,
    OnInputFrameProcessedListener listener
)

Sets the OnInputFrameProcessedListener at inputIndex.

public void setOnInputSurfaceReadyListener(int inputIndex, Runnable listener)

Sets a listener that's called when the input surface is ready to use at inputIndex.

public void setOutputSurfaceInfo(@Nullable SurfaceInfo outputSurfaceInfo)

Sets the output surface and supporting information.

The new output SurfaceInfo is applied from the next output frame rendered onwards. If the output SurfaceInfo is null, the VideoGraph will stop rendering pending frames and resume rendering once a non-null SurfaceInfo is set.

If the dimensions given in SurfaceInfo do not match the output size after applying the final effect the frames are resized before rendering to the surface and letter/pillar-boxing is applied.

The caller is responsible for tracking the lifecycle of the surface including calling this method with a new surface if it is destroyed. When this method returns, the previous output surface is no longer being used and can safely be released by the caller.

public void signalEndOfInput(int inputIndex)

Informs that no further inputs should be accepted at inputIndex.