io.flutter.embedding.engine.renderer.SurfaceTextureWrapper Class Reference

Public Member Functions
	SurfaceTextureWrapper (@NonNull SurfaceTexture surfaceTexture)
	SurfaceTextureWrapper ( @NonNull SurfaceTexture surfaceTexture, @Nullable Runnable onFrameConsumed)
SurfaceTexture	surfaceTexture ()
void	markDirty ()
boolean	shouldUpdate ()
void	updateTexImage ()
void	release ()
void	attachToGLContext (int texName)
void	detachFromGLContext ()
void	getTransformMatrix (@NonNull float[] mtx)

Detailed Description

A wrapper for a SurfaceTexture that tracks whether the texture has been released.

The engine calls SurfaceTexture.release on the platform thread, but
updateTexImage is called on the raster thread. This wrapper will prevent updateTexImage calls on an abandoned texture.

Definition at line 20 of file SurfaceTextureWrapper.java.

Constructor & Destructor Documentation

SurfaceTextureWrapper() [1/2]

io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.SurfaceTextureWrapper ( @NonNull SurfaceTexture  surfaceTexture )

inline

Definition at line 27 of file SurfaceTextureWrapper.java.

                                                                       {
    this(surfaceTexture, null);
  }

SurfaceTextureWrapper() [2/2]

io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.SurfaceTextureWrapper ( @NonNull SurfaceTexture  surfaceTexture, @Nullable Runnable  onFrameConsumed  )

inline

A wrapper for a SurfaceTexture.

The provided onFrameConsumed callback must be invoked when the most recent image was consumed.

Parameters

onFrameConsumed

The callback after the updateTexImage is called.

Definition at line 39 of file SurfaceTextureWrapper.java.

                                                                                  {
    this.surfaceTexture = surfaceTexture;
    this.released = false;
    this.onFrameConsumed = onFrameConsumed;
  }

Member Function Documentation

attachToGLContext()

void io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.attachToGLContext ( int  texName )

inline

Definition at line 89 of file SurfaceTextureWrapper.java.

                                             {
    synchronized (this) {
      if (released) {
        return;
      }
      // When the rasterizer tasks run on a different thread, the GrContext is re-created.
      // This causes the texture to be in an uninitialized state.
      // This should *not* be an issue once platform views are always rendered as TextureLayers
      // since thread merging will be always disabled on Android.
      // For more see: SurfaceTextureExternalTextureGL::OnGrContextCreated in
      // surface_texture_external_texture_gl.cc, and
      // https://github.com/flutter/flutter/issues/98155
      if (attached) {
        surfaceTexture.detachFromGLContext();
      }
      surfaceTexture.attachToGLContext(texName);
      attached = true;
    }
  }

detachFromGLContext()

void io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.detachFromGLContext ( )

inline

Definition at line 111 of file SurfaceTextureWrapper.java.

                                    {
    synchronized (this) {
      if (attached && !released) {
        surfaceTexture.detachFromGLContext();
        attached = false;
      }
    }
  }

getTransformMatrix()

void io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.getTransformMatrix ( @NonNull float[]  mtx )

inline

Definition at line 122 of file SurfaceTextureWrapper.java.

                                                       {
    surfaceTexture.getTransformMatrix(mtx);
  }

markDirty()

void io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.markDirty ( )

inline

Definition at line 51 of file SurfaceTextureWrapper.java.

                          {
    synchronized (this) {
      newFrameAvailable = true;
    }
  }

release()

void io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.release ( )

inline

Definition at line 77 of file SurfaceTextureWrapper.java.

                        {
    synchronized (this) {
      if (!released) {
        surfaceTexture.release();
        released = true;
        attached = false;
      }
    }
  }

shouldUpdate()

boolean io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.shouldUpdate ( )

inline

Definition at line 57 of file SurfaceTextureWrapper.java.

                                {
    synchronized (this) {
      return newFrameAvailable;
    }
  }

surfaceTexture()

SurfaceTexture io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.surfaceTexture ( )

inline

Definition at line 47 of file SurfaceTextureWrapper.java.

                                         {
    return surfaceTexture;
  }

updateTexImage()

void io.flutter.embedding.engine.renderer.SurfaceTextureWrapper.updateTexImage ( )

inline

Definition at line 65 of file SurfaceTextureWrapper.java.

                               {
    synchronized (this) {
      newFrameAvailable = false;
      if (!released) {
        surfaceTexture.updateTexImage();
        if (onFrameConsumed != null) {
          onFrameConsumed.run();
        }
      }
    }
  }

---

The documentation for this class was generated from the following file:

• shell/platform/android/io/flutter/embedding/engine/renderer/SurfaceTextureWrapper.java