sun.java2d.pipe.hw

Interface AccelSurface [ source ]

All Superinterfaces:

BufferedContextProvider, Surface

All Known Implementing Classes:

D3DSurfaceData, D3DSurfaceData.D3DWindowSurfaceData, GLXSurfaceData, GLXSurfaceData.GLXOffScreenSurfaceData, GLXSurfaceData.GLXVSyncOffScreenSurfaceData, GLXSurfaceData.GLXWindowSurfaceData, OGLSurfaceData, WGLSurfaceData, WGLSurfaceData.WGLOffScreenSurfaceData, WGLSurfaceData.WGLVSyncOffScreenSurfaceData, WGLSurfaceData.WGLWindowSurfaceData

public interface AccelSurface
extends BufferedContextProvider, Surface

Abstraction for a hardware accelerated surface.

Field Summary

Fields

Modifier and Type	Field and Description
static int	FLIP_BACKBUFFER A back-buffer surface (SwapChain surface for Direct3D, backbuffer for OpenGL)
static int	RT_PLAIN Render-To Plain surface (pbuffer for OpenGL, Render Target surface for Direct3D)
static int	RT_TEXTURE Render-To Texture surface (fbobject for OpenGL, texture with render-to attribute for Direct3D)
static int	TEXTURE Texture surface
static int	UNDEFINED Undefined
static int	WINDOW Window (or window substitute) surface

Method Summary

Methods

Modifier and Type	Method and Description
Rectangle	getBounds() Returns the requested bounds of the destination surface.
Rectangle	getNativeBounds() Returns real bounds of the native surface, which may differ from those returned by getBounds().
long	getNativeOps() Returns a pointer to the native surface data associated with this surface.
long	getNativeResource(int resType) Returns a pointer to the real native resource of the specified type associated with this AccelSurface.
int	getType() Returns int representing surface's type as defined by constants in this interface.
boolean	isSurfaceLost() Returns whether this surface is lost.
boolean	isValid() Returns whether the pipeline considers this surface valid.
void	markDirty() Marks this surface dirty.

Methods inherited from interface sun.java2d.pipe.hw.BufferedContextProvider

getContext

Field Detail

UNDEFINED

static final int UNDEFINED

Undefined

See Also:

Constant Field Values

WINDOW

static final int WINDOW

Window (or window substitute) surface

See Also:

Constant Field Values

RT_PLAIN

static final int RT_PLAIN

Render-To Plain surface (pbuffer for OpenGL, Render Target surface for Direct3D)

See Also:

Constant Field Values

TEXTURE

static final int TEXTURE

Texture surface

See Also:

Constant Field Values

FLIP_BACKBUFFER

static final int FLIP_BACKBUFFER

A back-buffer surface (SwapChain surface for Direct3D, backbuffer for OpenGL)

See Also:

Constant Field Values

RT_TEXTURE

static final int RT_TEXTURE

Render-To Texture surface (fbobject for OpenGL, texture with render-to attribute for Direct3D)

See Also:

Constant Field Values

Method Detail

getType

int getType()

Returns int representing surface's type as defined by constants in this interface.

Returns:

an integer representing this surface's type

See Also:

UNDEFINED, WINDOW, RT_PLAIN, TEXTURE, FLIP_BACKBUFFER, RT_TEXTURE

getNativeOps

long getNativeOps()

Returns a pointer to the native surface data associated with this surface. Note: this pointer is only valid on the rendering thread.

Returns:

pointer to the native surface's data

getNativeResource

long getNativeResource(int resType)

Returns a pointer to the real native resource of the specified type associated with this AccelSurface. Note: this pointer is only valid on the rendering thread.

Parameters:

resType - the type of the requested resource

Returns:

a long containing a pointer to the native resource of the specified type or 0L if such resource doesn't exist for this surface

markDirty

void markDirty()

Marks this surface dirty.

isValid

boolean isValid()

Returns whether the pipeline considers this surface valid. A surface may become invalid if it is disposed of, or resized.

Returns:

true if valid, false otherwise

isSurfaceLost

boolean isSurfaceLost()

Returns whether this surface is lost. The return value is only valid on the render thread, meaning that even if this method returns true it could be lost in the next moment unless it is called on the rendering thread.

Returns:

true if the surface is known to be lost, false otherwise

getBounds

Rectangle getBounds()

Returns the requested bounds of the destination surface. The real bounds of the native accelerated surface may differ. Use getNativeBounds() to get the bounds of the native surface.

Returns:

Rectangle representing java surface's bounds

getNativeBounds

Rectangle getNativeBounds()

Returns real bounds of the native surface, which may differ from those returned by getBounds().

Returns:

Rectangle representing native surface's bounds