Interface UpstreamSurfaceHook

All Known Subinterfaces:
UpstreamSurfaceHook.MutableSize
All Known Implementing Classes:
DelegatedUpstreamSurfaceHookMutableSize, DelegatedUpstreamSurfaceHookWithSurfaceSize, GenericUpstreamSurfacelessHook, UpstreamSurfaceHookMutableSize, UpstreamWindowHookMutableSizePos

public interface UpstreamSurfaceHook
Interface allowing upstream caller to pass lifecycle actions and size info to a ProxySurface instance.
  • Method Details

    • create

      void create(ProxySurface s)
      called within ProxySurface.createNotify() within lock, before using surface.
    • destroy

      void destroy(ProxySurface s)
      called within ProxySurface.destroyNotify() within lock, before clearing fields.
    • getUpstreamSurface

      NativeSurface getUpstreamSurface()
      Returns the optional upstream NativeSurface if used by implementation, otherwise null.

      One example is the JOGL EGLWrappedSurface, which might be backed up by a native platform NativeSurface (X11, WGL, CGL, ..).

    • getSurfaceWidth

      int getSurfaceWidth(ProxySurface s)
      Returns the width of the upstream surface in pixels, used if ProxySurface#UPSTREAM_PROVIDES_SIZE is set.
    • getSurfaceHeight

      int getSurfaceHeight(ProxySurface s)
      Returns the height of the upstream surface in pixels, used if ProxySurface#UPSTREAM_PROVIDES_SIZE is set.