com.sun.prism

Class Image

java.lang.Object

com.sun.prism.Image

All Implemented Interfaces:

PlatformImage

public class Image
extends Object
implements PlatformImage

Method Summary

Modifier and Type	Method and Description
static Image	convertImageFrame(ImageFrame frame)
static Buffer	createPackedBuffer(Buffer pixels, PixelFormat format, int minX, int minY, int width, int height, int scanlineStride) Returns a new Buffer instance that contains a tightly packed copy of the given Buffer's pixel data.
Image	createPackedCopy() Returns a new Image instance with a newly allocated pixel buffer that contains a tightly packed copy of this image's pixels.
Image	createPackedCopyIfNeeded() Returns a Image instance with a newly allocated pixel buffer that contains a tightly packed copy of this image's pixels or if this image is already tightly packed, itself.
Image	createSubImage(int x, int y, int w, int h) Returns a new Image instance that shares the underlying pixel buffer of this Image.
static Image	fromByteAlphaData(byte[] pixels, int width, int height)
static Image	fromByteAlphaData(ByteBuffer pixels, int width, int height)
static Image	fromByteAlphaData(ByteBuffer pixels, int width, int height, int scanlineStride)
static Image	fromByteApple422Data(byte[] pixels, int width, int height)
static Image	fromByteApple422Data(ByteBuffer pixels, int width, int height)
static Image	fromByteApple422Data(ByteBuffer pixels, int width, int height, int scanlineStride)
static Image	fromByteBgraPreData(byte[] pixels, int width, int height)
static Image	fromByteBgraPreData(byte[] pixels, int width, int height, float pixelScale)
static Image	fromByteBgraPreData(ByteBuffer pixels, int width, int height)
static Image	fromByteBgraPreData(ByteBuffer pixels, int width, int height, int scanlineStride)
static Image	fromByteBgraPreData(ByteBuffer pixels, int width, int height, int scanlineStride, float pixelScale)
static Image	fromByteGrayData(byte[] pixels, int width, int height)
static Image	fromByteGrayData(ByteBuffer pixels, int width, int height)
static Image	fromByteGrayData(ByteBuffer pixels, int width, int height, int scanlineStride)
static Image	fromByteGrayData(ByteBuffer pixels, int width, int height, int scanlineStride, float pixelScale)
static Image	fromByteRgbData(byte[] pixels, int width, int height)
static Image	fromByteRgbData(ByteBuffer pixels, int width, int height)
static Image	fromByteRgbData(ByteBuffer pixels, int width, int height, int scanlineStride)
static Image	fromByteRgbData(ByteBuffer pixels, int width, int height, int scanlineStride, float pixelScale)
static Image	fromFloatMapData(FloatBuffer pixels, int width, int height)
static Image	fromIntArgbPreData(int[] pixels, int width, int height)
static Image	fromIntArgbPreData(IntBuffer pixels, int width, int height)
static Image	fromIntArgbPreData(IntBuffer pixels, int width, int height, int scanlineStride)
static Image	fromIntArgbPreData(IntBuffer pixels, int width, int height, int scanlineStride, float pixelScale)
int	getArgb(int x, int y)
int	getBytesPerPixelUnit()
PixelFormat.DataType	getDataType()
int	getHeight()
int	getMinX()
int	getMinY()
Buffer	getPixelBuffer()
PixelFormat	getPixelFormat()
void	getPixels(int x, int y, int w, int h, WritablePixelFormat<ByteBuffer> pixelformat, byte[] pixels, int offset, int scanlineBytes)
void	getPixels(int x, int y, int w, int h, WritablePixelFormat<IntBuffer> pixelformat, int[] pixels, int offset, int scanlineInts)
<T extends Buffer> void	getPixels(int x, int y, int w, int h, WritablePixelFormat<T> pixelformat, T pixels, int scanlineBytes)
float	getPixelScale() Gets the scale representing how large an area a 72DPI virtual pixel covers in terms of the pixels of this image.
PixelFormat<?>	getPlatformPixelFormat()
int	getRowLength()
int	getScanlineStride()
int	getSerial()
int	getWidth()
Image	iconify(ByteBuffer iconBuffer, int twidth, int theight)
boolean	isOpaque()
boolean	isTightlyPacked()
boolean	isWritable()
Image	promoteByteRgbToByteBgra()
PlatformImage	promoteToWritableImage()
void	setArgb(int x, int y, int argb)
void	setPixels(int x, int y, int w, int h, PixelFormat<ByteBuffer> pixelformat, byte[] pixels, int offset, int scanlineBytes)
void	setPixels(int x, int y, int w, int h, PixelFormat<IntBuffer> pixelformat, int[] pixels, int offset, int scanlineInts)
<T extends Buffer> void	setPixels(int x, int y, int w, int h, PixelFormat<T> pixelformat, T pixels, int scanlineBytes)
void	setPixels(int dstx, int dsty, int w, int h, PixelReader reader, int srcx, int srcy)
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

fromIntArgbPreData

public static Image fromIntArgbPreData(int[] pixels,
                                       int width,
                                       int height)

fromIntArgbPreData

public static Image fromIntArgbPreData(IntBuffer pixels,
                                       int width,
                                       int height)

fromIntArgbPreData

public static Image fromIntArgbPreData(IntBuffer pixels,
                                       int width,
                                       int height,
                                       int scanlineStride)

fromIntArgbPreData

public static Image fromIntArgbPreData(IntBuffer pixels,
                                       int width,
                                       int height,
                                       int scanlineStride,
                                       float pixelScale)

fromByteBgraPreData

public static Image fromByteBgraPreData(byte[] pixels,
                                        int width,
                                        int height)

fromByteBgraPreData

public static Image fromByteBgraPreData(byte[] pixels,
                                        int width,
                                        int height,
                                        float pixelScale)

fromByteBgraPreData

public static Image fromByteBgraPreData(ByteBuffer pixels,
                                        int width,
                                        int height)

fromByteBgraPreData

public static Image fromByteBgraPreData(ByteBuffer pixels,
                                        int width,
                                        int height,
                                        int scanlineStride)

fromByteBgraPreData

public static Image fromByteBgraPreData(ByteBuffer pixels,
                                        int width,
                                        int height,
                                        int scanlineStride,
                                        float pixelScale)

fromByteRgbData

public static Image fromByteRgbData(byte[] pixels,
                                    int width,
                                    int height)

fromByteRgbData

public static Image fromByteRgbData(ByteBuffer pixels,
                                    int width,
                                    int height)

fromByteRgbData

public static Image fromByteRgbData(ByteBuffer pixels,
                                    int width,
                                    int height,
                                    int scanlineStride)

fromByteRgbData

public static Image fromByteRgbData(ByteBuffer pixels,
                                    int width,
                                    int height,
                                    int scanlineStride,
                                    float pixelScale)

fromByteGrayData

public static Image fromByteGrayData(byte[] pixels,
                                     int width,
                                     int height)

fromByteGrayData

public static Image fromByteGrayData(ByteBuffer pixels,
                                     int width,
                                     int height)

fromByteGrayData

public static Image fromByteGrayData(ByteBuffer pixels,
                                     int width,
                                     int height,
                                     int scanlineStride)

fromByteGrayData

public static Image fromByteGrayData(ByteBuffer pixels,
                                     int width,
                                     int height,
                                     int scanlineStride,
                                     float pixelScale)

fromByteAlphaData

public static Image fromByteAlphaData(byte[] pixels,
                                      int width,
                                      int height)

fromByteAlphaData

public static Image fromByteAlphaData(ByteBuffer pixels,
                                      int width,
                                      int height)

fromByteAlphaData

public static Image fromByteAlphaData(ByteBuffer pixels,
                                      int width,
                                      int height,
                                      int scanlineStride)

fromByteApple422Data

public static Image fromByteApple422Data(byte[] pixels,
                                         int width,
                                         int height)

fromByteApple422Data

public static Image fromByteApple422Data(ByteBuffer pixels,
                                         int width,
                                         int height)

fromByteApple422Data

public static Image fromByteApple422Data(ByteBuffer pixels,
                                         int width,
                                         int height,
                                         int scanlineStride)

fromFloatMapData

public static Image fromFloatMapData(FloatBuffer pixels,
                                     int width,
                                     int height)

convertImageFrame

public static Image convertImageFrame(ImageFrame frame)

getPixelFormat

public PixelFormat getPixelFormat()

getDataType

public PixelFormat.DataType getDataType()

getBytesPerPixelUnit

public int getBytesPerPixelUnit()

getPixelBuffer

public Buffer getPixelBuffer()

getMinX

public int getMinX()

getMinY

public int getMinY()

getWidth

public int getWidth()

getHeight

public int getHeight()

getScanlineStride

public int getScanlineStride()

getPixelScale

public float getPixelScale()

Description copied from interface: PlatformImage

Gets the scale representing how large an area a 72DPI virtual pixel covers in terms of the pixels of this image. A 72DPI platform image would return 1.0f. A 144DPI platform image would return 2.0f.

Specified by:

getPixelScale in interface PlatformImage

Returns:

the number of actual image pixels per 72DPI virtual pixel

getRowLength

public int getRowLength()

isTightlyPacked

public boolean isTightlyPacked()

createSubImage

public Image createSubImage(int x,
                            int y,
                            int w,
                            int h)

Returns a new Image instance that shares the underlying pixel buffer of this Image. The new image will have the same scanline stride, pixel format, etc of the original image, except with the provided minX/minY and dimensions.

Parameters:

x - the x offset of the upper-left corner of the new subimage, relative to the minX of this image

y - the y offset of the upper-left corner of the new subimage, relative to the minY of this image

w - the width of the new subimage

h - the height of the new subimage

Returns:

a new Image representing a sub-region of this image

createPackedCopy

public Image createPackedCopy()

Returns a new Image instance with a newly allocated pixel buffer that contains a tightly packed copy of this image's pixels. This method is useful in cases where having extra pixels at the end of a scanline is not desirable. The new image will have the same pixel format, width, and height of the original image, except with a new scanline stride and with minX == minY == 0.

Returns:

a new Image this is a tightly packed copy of this image

createPackedCopyIfNeeded

public Image createPackedCopyIfNeeded()

Returns a Image instance with a newly allocated pixel buffer that contains a tightly packed copy of this image's pixels or if this image is already tightly packed, itself.

Returns:

a new Image this is a tightly packed copy of this image or itself if this image is packed already.

See Also:

createPackedCopy()

createPackedBuffer

public static Buffer createPackedBuffer(Buffer pixels,
                                        PixelFormat format,
                                        int minX,
                                        int minY,
                                        int width,
                                        int height,
                                        int scanlineStride)

Returns a new Buffer instance that contains a tightly packed copy of the given Buffer's pixel data. This method is useful in cases where having extra pixels at the end of a scanline is not desirable.

Parameters:

pixels - the buffer containing the pixels to copy

format - the format of the given buffer

minX - the x offset of the upper-left corner of the pixel region

minY - the y offset of the upper-left corner of the pixel region

width - the width of the pixel region to be copied, in pixels

height - the height of the pixel region to be copied, in pixels

scanlineStride - the scanline stride of the given buffer, in bytes

Returns:

a new, tightly packed copy of the given Buffer

iconify

public Image iconify(ByteBuffer iconBuffer,
                     int twidth,
                     int theight)

toString

public String toString()

Overrides:

toString in class Object

getSerial

public int getSerial()

promoteByteRgbToByteBgra

public Image promoteByteRgbToByteBgra()

getPlatformPixelFormat

public PixelFormat<?> getPlatformPixelFormat()

Specified by:

getPlatformPixelFormat in interface PlatformImage

Returns:

the PixelFormat to use for the pixel data transfer methods getPixels() and setPixels().

isWritable

public boolean isWritable()

Specified by:

isWritable in interface PlatformImage

promoteToWritableImage

public PlatformImage promoteToWritableImage()

Specified by:

promoteToWritableImage in interface PlatformImage

getArgb

public int getArgb(int x,
                   int y)

Specified by:

getArgb in interface PlatformImage

Parameters:

x - X coordinate of pixel

y - Y coordinate of pixel

Returns:

the non-premultiplied pixel in integer ARGB component ordering.

setArgb

public void setArgb(int x,
                    int y,
                    int argb)

Specified by:

setArgb in interface PlatformImage

Parameters:

x - X coordinate of pixel

y - Y coordinate of pixel

getPixels

public <T extends Buffer> void getPixels(int x,
                                         int y,
                                         int w,
                                         int h,
                                         WritablePixelFormat<T> pixelformat,
                                         T pixels,
                                         int scanlineBytes)

Specified by:

getPixels in interface PlatformImage

getPixels

public void getPixels(int x,
                      int y,
                      int w,
                      int h,
                      WritablePixelFormat<ByteBuffer> pixelformat,
                      byte[] pixels,
                      int offset,
                      int scanlineBytes)

Specified by:

getPixels in interface PlatformImage

getPixels

public void getPixels(int x,
                      int y,
                      int w,
                      int h,
                      WritablePixelFormat<IntBuffer> pixelformat,
                      int[] pixels,
                      int offset,
                      int scanlineInts)

Specified by:

getPixels in interface PlatformImage

setPixels

public <T extends Buffer> void setPixels(int x,
                                         int y,
                                         int w,
                                         int h,
                                         PixelFormat<T> pixelformat,
                                         T pixels,
                                         int scanlineBytes)

Specified by:

setPixels in interface PlatformImage

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      PixelFormat<ByteBuffer> pixelformat,
                      byte[] pixels,
                      int offset,
                      int scanlineBytes)

Specified by:

setPixels in interface PlatformImage

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      PixelFormat<IntBuffer> pixelformat,
                      int[] pixels,
                      int offset,
                      int scanlineInts)

Specified by:

setPixels in interface PlatformImage

setPixels

public void setPixels(int dstx,
                      int dsty,
                      int w,
                      int h,
                      PixelReader reader,
                      int srcx,
                      int srcy)

Specified by:

setPixels in interface PlatformImage

isOpaque

public boolean isOpaque()