public abstract Class BaseTexture<T extends ManagedResource>

Implements com.sun.prism.Texture.assertLocked.

Annotations

@Override

Implements com.sun.prism.Texture.contentsNotUseful.

Annotations

@Override

Implements com.sun.prism.Texture.contentsUseful.

Annotations

@Override

Implements com.sun.prism.GraphicsResource.dispose.

Annotations

@Override

Implements com.sun.prism.Texture.getContentHeight.

Doc from com.sun.prism.Texture.getContentHeight.

Returns the content height of this texture, in pixels. Note that the content size of a texture may be smaller than the requested size due to hardware restrictions (e.g. lack of non-power-of-two texture support). The content height will be less than or equal to the content height.

For example, if the hardware does not support non-power-of-two textures, and you call ResourceFactory.createTexture(400, 200), the returned Texture will have physical dimensions of 512x256, but the content dimensions will be 400x200.

Returns:int

the content height of this texture, in pixels

Annotations

@Override

Implements com.sun.prism.Texture.getContentWidth.

Doc from com.sun.prism.Texture.getContentWidth.

Returns the content width of this texture, in pixels. Note that the content size of a texture may be smaller than the requested size due to hardware restrictions (e.g. lack of non-power-of-two texture support). The content width will be less than or equal to the content width.

For example, if the hardware does not support non-power-of-two textures, and you call ResourceFactory.createTexture(400, 200), the returned Texture will have physical dimensions of 512x256, but the content dimensions will be 400x200.

Returns:int

the content width of this texture, in pixels

Annotations

@Override

Implements com.sun.prism.Texture.getContentX.

Doc from com.sun.prism.Texture.getContentX.

Returns the content x-origin of this texture relative to the upper-left corner, in pixels. This value will be greater than equal to zero.

Returns:int

the content x-origin of this texture

Annotations

@Override

Implements com.sun.prism.Texture.getContentY.

Doc from com.sun.prism.Texture.getContentY.

Returns the content y-origin of this texture relative to the upper-left corner, in pixels. This value will be greater than equal to zero.

Returns:int

the content y-origin of this texture

Annotations

@Override

Implements com.sun.prism.Texture.getLastImageSerial.

Annotations

@Override

Implements com.sun.prism.Texture.getLinearFiltering.

Doc from com.sun.prism.Texture.getLinearFiltering.

Returns whether linear (smooth) filtering will be used when rendering this texture. If false, a simple nearest neighbor algorithm will be used.

Returns:boolean

whether linear filtering will be used for this texture

Annotations

@Override

Implements com.sun.prism.Texture.getLockCount.

Annotations

@Override

Implements com.sun.prism.Texture.getMaxContentHeight.

Doc from com.sun.prism.Texture.getMaxContentHeight.

Returns the max content height of this texture, in pixels. Note that the content size of a texture may be smaller than the requested size due to hardware restrictions (e.g. lack of non-power-of-two texture support). The content height will be less than or equal to the max content height.

For example, if the hardware does not support non-power-of-two textures, and you call ResourceFactory.createTexture(400, 200), the returned Texture will have physical dimensions of 512x256 and the max content dimensions will be 512x256 minus any padding needed by the implementation to simulate edge conditions., but the content dimensions will be 400x200.

Returns:int

the max content height of this texture, in pixels

Annotations

@Override

Implements com.sun.prism.Texture.getMaxContentWidth.

Doc from com.sun.prism.Texture.getMaxContentWidth.

Returns the max content width of this texture, in pixels. Note that the content size of a texture may be smaller than the requested size due to hardware restrictions (e.g. lack of non-power-of-two texture support). The content width will be less than or equal to the max content width.

For example, if the hardware does not support non-power-of-two textures, and you call ResourceFactory.createTexture(400, 200), the returned Texture will have physical dimensions of 512x256 and the max content dimensions will be 512x256 minus any padding needed by the implementation to simulate edge conditions., but the content dimensions will be 400x200.

Returns:int

the max content width of this texture, in pixels

Annotations

@Override

Implements com.sun.prism.Texture.getPhysicalHeight.

Doc from com.sun.prism.Texture.getPhysicalHeight.

Returns the physical height of this texture, in pixels. Note that the physical size of a texture may be larger than the requested size due to hardware restrictions (e.g. lack of non-power-of-two texture support). The physical height will be greater than or equal to the content height.

Returns:int

the physical height of this texture, in pixels

Annotations

@Override

Implements com.sun.prism.Texture.getPhysicalWidth.

Doc from com.sun.prism.Texture.getPhysicalWidth.

Returns the physical width of this texture, in pixels. Note that the physical size of a texture may be larger than the requested size due to hardware restrictions (e.g. lack of non-power-of-two texture support). The physical width will be greater than or equal to the content width.

Returns:int

the physical width of this texture, in pixels

Annotations

@Override

Implements com.sun.prism.Texture.getPixelFormat.

Doc from com.sun.prism.Texture.getPixelFormat.

Returns the PixelFormat of this texture.

Returns:PixelFormat

the PixelFormat of this texture

Annotations

@Override

Implements com.sun.prism.Texture.getSharedTexture.

Doc from com.sun.prism.Texture.getSharedTexture.

Constructs an alternate version of this Texture with an alternate WrapMode if the two modes allow the underlying texture to be shared, otherwise a null value is returned. This method can only be used to create a shared texture for REPEAT or CLAMP_TO_EDGE textures, which must necessarily have content that spans their entire physical dimensions (if their content was smaller then they would have a _SIMULATED type of wrap mode). This method expects the texture to be already locked (and checked for a valid surface) and if it returns a non-null value then that return value will have an outstanding lock in addition to retaining the lock on the original texture. Note that if the requested WrapMode is the same as the wrap mode of this texture, then this same object will be returned after having its lock count increased by 1. Thus, in all cases, the caller is responsible for locking this texture before the call, and eventually unlocking this texture after the call, and also for eventually unlocking the return value if it is non-null.

Annotations

@Override

Implements com.sun.prism.Texture.getUseMipmap.

Doc from com.sun.prism.Texture.getUseMipmap.

Returns the true if mipmapping is used for this texture.

Returns:boolean

the useMipmap flag for this texture

Annotations

@Override

Implements com.sun.prism.Texture.getWrapMode.

Doc from com.sun.prism.Texture.getWrapMode.

Returns the WrapMode for this texture.

Returns:Texture.WrapMode

the WrapMode for this texture

Annotations

@Override

Implements com.sun.prism.Texture.isLocked.

Annotations

@Override

Implements com.sun.prism.Texture.isSurfaceLost.

Doc from com.sun.prism.Texture.isSurfaceLost.

Called by code wanting to know if the RTTexture's surface is lost. This happens in some cases (mostly on Windows) when, for example, the user presses Ctrl+Alt+Delete, or the system goes to sleep.

Returns:boolean

True if the backing surface of this RTTexture is gone and the image is therefore no longer usable. False if it is still OK.

Annotations

@Override

Implements com.sun.prism.Texture.lock.

Annotations

@Override

Implements com.sun.prism.Texture.makePermanent.

Annotations

@Override

Implements com.sun.prism.Texture.setContentHeight.

Doc from com.sun.prism.Texture.setContentHeight.

Allows the content height, which is the current height of the actual content in pixels, to be adjusted. The height must be between 0 and maxContentHeight . *

Parameters

contentH:int

The actual new height of user pixels.

Annotations

@Override

Implements com.sun.prism.Texture.setContentWidth.

Doc from com.sun.prism.Texture.setContentWidth.

Allows the content width, which is the current width of the actual content in pixels, to be adjusted. The height must be between 0 and maxContentHeight

Parameters

contentW:int

The actual new width of user pixels.

Annotations

@Override

Implements com.sun.prism.Texture.setLastImageSerial.

Annotations

@Override

Implements com.sun.prism.Texture.setLinearFiltering.

Doc from com.sun.prism.Texture.setLinearFiltering.

Sets whether linear filtering will be used when rendering this texture.

Parameters

linear:boolean

if true, enables linear filtering; if false, enables nearest neighbor filtering

Annotations

@Override

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@Override

Implements com.sun.prism.Texture.unlock.

Annotations

@Override

Implements com.sun.prism.Texture.update.

Doc from com.sun.prism.Texture.update.

Updates this texture using the contents of the given Image. The upper-left corner of the image data will be positioned at (contentX, contentY) of the texture, and the full width and height of the image will be uploaded. This method will cause the vertex buffer to be flushed prior to uploading the pixels.

This is equivalent to calling:

    update(img, 0, 0);

Parameters

img:Image

the image data to be uploaded to this texture

Annotations

@Override

Implements com.sun.prism.Texture.update.

Doc from com.sun.prism.Texture.update.

Updates this texture using the contents of the given Image. The upper-left corner of the image data will be positioned at (contentX+dstx, contentY+dsty) of the texture, and the full width and height of the image will be uploaded. This method will cause the vertex buffer to be flushed prior to uploading the pixels.

This is equivalent to calling:

    update(img, dstx, dsty, img.getWidth(), img.getHeight());

Parameters

img:Image

the image data to be uploaded to this texture

dstx:int

the x-offset of the image data, in pixels, relative to the contentX of this texture

dsty:int

the y-offset of the image data, in pixels, relative to the contentY of this texture

Annotations

@Override

Implements com.sun.prism.Texture.update.

Doc from com.sun.prism.Texture.update.

Updates this texture using the contents of the given Image. The upper-left corner of the image data will be positioned at (contentX+dstx, contentY+dsty) of the texture, and the source region to be uploaded will be srcw by srch pixels. This method will cause the vertex buffer to be flushed prior to uploading the pixels.

This is equivalent to calling:

    update(img, dstx, dsty, srcw, srch, false);

Parameters

img:Image

the image data to be uploaded to this texture

dstx:int

the x-offset of the image data, in pixels, relative to the contentX of this texture

dsty:int

the y-offset of the image data, in pixels, relative to the contentY of this texture

w:int

the width of the pixel region from the source image

h:int

the height of the pixel region from the source image

Annotations

@Override

Implements com.sun.prism.Texture.update.

Doc from com.sun.prism.Texture.update.

Updates this texture using the contents of the given Image. The upper-left corner of the image data will be positioned at (contentX+dstx, contentY+dsty) of the texture, and the source region to be uploaded will be srcw by srch pixels. This method will cause the vertex buffer to be flushed unless skipFlush is true.

This is equivalent to calling:

    update(img.getPixelBuffer(), img.getPixelFormat(),
           dstx, dsty, img.getMinX(), img.getMinY(),
           srcw, srch, img.getScanlineStride(), skipFlush);

Parameters

img:Image

the image data to be uploaded to this texture

dstx:int

the x-offset of the image data, in pixels, relative to the contentX of this texture

dsty:int

the y-offset of the image data, in pixels, relative to the contentY of this texture

srcw:int

the width of the pixel region from the source image

srch:int

the height of the pixel region from the source image

skipFlush:boolean

if true, the vertex buffer will not be flushed

Annotations

@Override