com.sun.prism.impl

Class BaseResourceFactory

java.lang.Object

com.sun.prism.impl.BaseResourceFactory

All Implemented Interfaces:

GraphicsResource, ResourceFactory

Direct Known Subclasses:

BaseShaderFactory, J2DResourceFactory, SWResourceFactory

public abstract class BaseResourceFactory
extends java.lang.Object
implements ResourceFactory

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<Image,Texture>	clampTexCache
private Texture	glyphTexture
private java.util.WeakHashMap<ResourceFactoryListener,java.lang.Boolean>	listenerMap
private java.util.Map<Image,Texture>	mipmapTexCache
private Texture	regionTexture
private java.util.Map<Image,Texture>	repeatTexCache
private boolean	superShaderAllowed

Constructor Summary

Constructors

Constructor and Description
BaseResourceFactory()
BaseResourceFactory(java.util.Map<Image,Texture> clampTexCache, java.util.Map<Image,Texture> repeatTexCache, java.util.Map<Image,Texture> mipmapTexCache)

Method Summary

Modifier and Type	Method and Description
void	addFactoryListener(ResourceFactoryListener l)
protected boolean	canClampToEdge()
protected boolean	canClampToZero()
protected boolean	canRepeat()
protected void	clearTextureCache()
protected void	clearTextureCache(java.util.Map<Image,Texture> texCache)
Texture	createFloatTexture(int width, int height)
Texture	createMaskTexture(int width, int height, Texture.WrapMode wrapMode)
Texture	createTexture(Image image, Texture.Usage usageHint, Texture.WrapMode wrapMode) Returns a new Texture containing the pixels from the given image with the indicated texture edge wrap mode.
Texture	createTexture(Image image, Texture.Usage usageHint, Texture.WrapMode wrapMode, boolean useMipmap) Returns a new Texture containing the pixels from the given image with the indicated texture edge wrap mode.
Texture	getCachedTexture(Image image, Texture.WrapMode wrapMode) Returns a Texture for the given image set up to use or simulate the indicated wrap mode.
Texture	getCachedTexture(Image image, Texture.WrapMode wrapMode, boolean useMipmap) Returns a Texture for the given image set up to use or simulate the indicated wrap mode.
protected ResourceFactoryListener[]	getFactoryListeners()
Texture	getGlyphTexture()
Texture	getRegionTexture()
boolean	isDeviceReady() Returns status of this graphics device.
boolean	isSuperShaderAllowed()
boolean	isWrapModeSupported(Texture.WrapMode mode) Returns true iff the indicated wrap mode is directly supported (i.e.
protected void	notifyReleased() Called when the factory's data is released
protected void	notifyReset() Called when the factory is reset.
void	removeFactoryListener(ResourceFactoryListener l)
void	setGlyphTexture(Texture texture)
void	setRegionTexture(Texture texture)
(package private) static long	sizeWithMipMap(int w, int h, PixelFormat format)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.sun.prism.ResourceFactory

createArcRep, createEllipseRep, createMesh, createMeshView, createPathRep, createPhongMaterial, createPresentable, createRoundRectRep, createRTTexture, createRTTexture, createTexture, createTexture, createTexture, dispose, getMaximumTextureSize, getRTTHeight, getRTTWidth, getTextureResourcePool, isCompatibleTexture, isFormatSupported

Field Detail

clampTexCache

private final java.util.Map<Image,Texture> clampTexCache

repeatTexCache

private final java.util.Map<Image,Texture> repeatTexCache

mipmapTexCache

private final java.util.Map<Image,Texture> mipmapTexCache

listenerMap

private final java.util.WeakHashMap<ResourceFactoryListener,java.lang.Boolean> listenerMap

regionTexture

private Texture regionTexture

glyphTexture

private Texture glyphTexture

superShaderAllowed

private boolean superShaderAllowed

Constructor Detail

BaseResourceFactory

public BaseResourceFactory()

BaseResourceFactory

public BaseResourceFactory(java.util.Map<Image,Texture> clampTexCache,
                           java.util.Map<Image,Texture> repeatTexCache,
                           java.util.Map<Image,Texture> mipmapTexCache)

Method Detail

addFactoryListener

public void addFactoryListener(ResourceFactoryListener l)

Specified by:

addFactoryListener in interface ResourceFactory

removeFactoryListener

public void removeFactoryListener(ResourceFactoryListener l)

Specified by:

removeFactoryListener in interface ResourceFactory

isDeviceReady

public boolean isDeviceReady()

Description copied from interface: ResourceFactory

Returns status of this graphics device. If the device is not ready the createRTTexture and present operations will fail. Creation of shaders and regular textures will succeed and return valid resources. All hardware resources (RenderTargets and SwapChains) have to be recreated after a device-lost event notification.

Specified by:

isDeviceReady in interface ResourceFactory

clearTextureCache

protected void clearTextureCache()

clearTextureCache

protected void clearTextureCache(java.util.Map<Image,Texture> texCache)

getFactoryListeners

protected ResourceFactoryListener[] getFactoryListeners()

notifyReset

protected void notifyReset()

Called when the factory is reset. Some resources (based in vram) could be lost.

notifyReleased

protected void notifyReleased()

Called when the factory's data is released

sizeWithMipMap

static long sizeWithMipMap(int w,
                           int h,
                           PixelFormat format)

getCachedTexture

public Texture getCachedTexture(Image image,
                                Texture.WrapMode wrapMode)

Description copied from interface: ResourceFactory

Returns a Texture for the given image set up to use or simulate the indicated wrap mode. If no texture could be found in the cache, this method will create a new texture and put it in the cache before returning it. NOTE: the caller of this method should not hold a reference to the cached texture beyond its immediate needs since the cache may be cleared at any time.

Specified by:

getCachedTexture in interface ResourceFactory

Parameters:

image - the pixel data to be uploaded if the texture is new or needs new fringe pixels to simulate a new wrap mode

wrapMode - the mode that describes the behavior for samples outside the content area

Returns:

a cached texture

getCachedTexture

public Texture getCachedTexture(Image image,
                                Texture.WrapMode wrapMode,
                                boolean useMipmap)

Description copied from interface: ResourceFactory

Returns a Texture for the given image set up to use or simulate the indicated wrap mode. If no texture could be found in the cache, this method will create a new texture and put it in the cache before returning it. NOTE: the caller of this method should not hold a reference to the cached texture beyond its immediate needs since the cache may be cleared at any time.

Specified by:

getCachedTexture in interface ResourceFactory

Parameters:

image - the pixel data to be uploaded if the texture is new or needs new fringe pixels to simulate a new wrap mode

wrapMode - the mode that describes the behavior for samples outside the content

useMipmap - the flag indicates should mipmapping be used for this texture

Returns:

a cached texture

createTexture

public Texture createTexture(Image image,
                             Texture.Usage usageHint,
                             Texture.WrapMode wrapMode)

Description copied from interface: ResourceFactory

Returns a new Texture containing the pixels from the given image with the indicated texture edge wrap mode. Note that the dimensions of the returned texture may be larger than those of the given image.

Equivalent to (but perhaps more efficient than):

     PixelFormat format = image.getPixelFormat();
     int w = image.getWidth();
     int h = image.getHeight();
     Texture tex = createTexture(format, usageHint, wrapMode, w, h);
     tex.update(image, 0, 0, w, h);
 

Specified by:

createTexture in interface ResourceFactory

Parameters:

image - the pixel data to be uploaded to the new texture

usageHint - the Dynamic vs. Static nature of the texture data

wrapMode - the desired edge behavior (clamping vs. wrapping)

Returns:

a new texture

createTexture

public Texture createTexture(Image image,
                             Texture.Usage usageHint,
                             Texture.WrapMode wrapMode,
                             boolean useMipmap)

Description copied from interface: ResourceFactory

Returns a new Texture containing the pixels from the given image with the indicated texture edge wrap mode. Note that the dimensions of the returned texture may be larger than those of the given image.

Equivalent to (but perhaps more efficient than):

     PixelFormat format = image.getPixelFormat();
     int w = image.getWidth();
     int h = image.getHeight();
     Texture tex = createTexture(format, usageHint, wrapMode, w, h, useMipmap);
     tex.update(image, 0, 0, w, h);
 

Specified by:

createTexture in interface ResourceFactory

Parameters:

image - the pixel data to be uploaded to the new texture

usageHint - the Dynamic vs. Static nature of the texture data

wrapMode - the desired edge behavior (clamping vs. wrapping)

useMipmap - the flag indicates should texture be created with mipmap

Returns:

a new texture

createMaskTexture

public Texture createMaskTexture(int width,
                                 int height,
                                 Texture.WrapMode wrapMode)

Specified by:

createMaskTexture in interface ResourceFactory

createFloatTexture

public Texture createFloatTexture(int width,
                                  int height)

Specified by:

createFloatTexture in interface ResourceFactory

setRegionTexture

public void setRegionTexture(Texture texture)

Specified by:

setRegionTexture in interface ResourceFactory

getRegionTexture

public Texture getRegionTexture()

Specified by:

getRegionTexture in interface ResourceFactory

setGlyphTexture

public void setGlyphTexture(Texture texture)

Specified by:

setGlyphTexture in interface ResourceFactory

getGlyphTexture

public Texture getGlyphTexture()

Specified by:

getGlyphTexture in interface ResourceFactory

isSuperShaderAllowed

public boolean isSuperShaderAllowed()

Specified by:

isSuperShaderAllowed in interface ResourceFactory

canClampToZero

protected boolean canClampToZero()

canClampToEdge

protected boolean canClampToEdge()

canRepeat

protected boolean canRepeat()

isWrapModeSupported

public boolean isWrapModeSupported(Texture.WrapMode mode)

Description copied from interface: ResourceFactory

Returns true iff the indicated wrap mode is directly supported (i.e. not simulated) by the underlying pipeline and platform.

Specified by:

isWrapModeSupported in interface ResourceFactory

Parameters:

mode - the desired WrapMode

Returns:

true iff the wrap mode is supported and not simulated