java.awt.image

Class WritableRaster

java.lang.Object

java.awt.image.Raster

java.awt.image.WritableRaster

public class WritableRaster
extends Raster

这个类扩展了光栅提供像素写入功能。用于描述光栅对光栅存储像素的描述的类注释。

这个类的构造函数被保护。实例化一个writableraster，使用一个光栅中的类的createwritableraster工厂方法。

Field Summary

Fields inherited from class java.awt.image.Raster

dataBuffer, height, minX, minY, numBands, numDataElements, parent, sampleModel, sampleModelTranslateX, sampleModelTranslateY, width

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	WritableRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin) 构建一个与给定的samplemodel和DataBuffer writableraster。
protected	WritableRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point sampleModelTranslate, WritableRaster parent) 构建了一个writableraster与给定的samplemodel，DataBuffer，和父母。
protected	WritableRaster(SampleModel sampleModel, Point origin) 构建一个与给定的SampleModel writableraster。

方法摘要

Modifier and Type	Method and Description
WritableRaster	createWritableChild(int parentX, int parentY, int w, int h, int childMinX, int childMinY, int[] bandList) 返回一个新的writableraster股份全部或部分本writableraster DataBuffer。
WritableRaster	createWritableTranslatedChild(int childMinX, int childMinY) 创建一个具有相同的大小writableraster、SampleModel和DataBuffer的这一个，但不同的位置。
WritableRaster	getWritableParent() 返回父writableraster（如果有的话）这writableraster，否则无效。
void	setDataElements(int x, int y, int w, int h, Object inData) 设置从原始数组类型transfertype矩形像素数据。
void	setDataElements(int x, int y, Object inData) 设置从原始数组类型transfertype单个像素的数据。
void	setDataElements(int x, int y, Raster inRaster) 从输入光栅设置一个像素的矩形的数据。
void	setPixel(int x, int y, double[] dArray) 设置一个像素使用输入的双数组中的样本数据缓存。
void	setPixel(int x, int y, float[] fArray) 设置一个像素使用一个样本输入浮点数组的数据缓存。
void	setPixel(int x, int y, int[] iArray) 设置一个像素使用的样本输入一个int数组的数据缓存。
void	setPixels(int x, int y, int w, int h, double[] dArray) 将包含一个数组元素的双数组中的一个像素的矩形设置为一个矩形。
void	setPixels(int x, int y, int w, int h, float[] fArray) 将包含一个数组元素的浮动数组中的每个像素的矩形设置为一个矩形。
void	setPixels(int x, int y, int w, int h, int[] iArray) 设置从一个数组的数组元素包含每一个样本像素矩形样品。
void	setRect(int dx, int dy, Raster srcRaster) 份像素栅格srcraster这writableraster。
void	setRect(Raster srcRaster) 份像素栅格srcraster这writableraster。
void	setSample(int x, int y, int b, double s) 设置指定的带样的像素位于（x，y）使用一个双输入的数据缓存。
void	setSample(int x, int y, int b, float s) 设置指定的带样的像素位于（x，y）用于输入一个浮在数据缓存。
void	setSample(int x, int y, int b, int s) 设置指定的带样的像素位于（x，y）用于输入一个int的数据缓存。
void	setSamples(int x, int y, int w, int h, int b, double[] dArray) 将指定的带中的样本设置为指定的矩形，从每个数组元素的一个数组包含一个样本。
void	setSamples(int x, int y, int w, int h, int b, float[] fArray) 将包含一个数组元素的浮点数数组指定为指定的矩形区域中的样本设置为指定的矩形。
void	setSamples(int x, int y, int w, int h, int b, int[] iArray) 设置指定矩形的像素从一个int数组包含一个样品在每个数组元素指定带样品。

Methods inherited from class java.awt.image.Raster

createBandedRaster, createBandedRaster, createBandedRaster, createChild, createCompatibleWritableRaster, createCompatibleWritableRaster, createCompatibleWritableRaster, createCompatibleWritableRaster, createInterleavedRaster, createInterleavedRaster, createInterleavedRaster, createPackedRaster, createPackedRaster, createPackedRaster, createPackedRaster, createRaster, createTranslatedChild, createWritableRaster, createWritableRaster, getBounds, getDataBuffer, getDataElements, getDataElements, getHeight, getMinX, getMinY, getNumBands, getNumDataElements, getParent, getPixel, getPixel, getPixel, getPixels, getPixels, getPixels, getSample, getSampleDouble, getSampleFloat, getSampleModel, getSampleModelTranslateX, getSampleModelTranslateY, getSamples, getSamples, getSamples, getTransferType, getWidth

Methods inherited from class java.lang.Object

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

Constructor Detail

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         Point origin)

构建一个与给定的SampleModel writableraster。的writableraster左上角的起源和它的大小像SampleModel一样。一个数据缓冲区足够大的描述writableraster自动创建。

参数

sampleModel - samplemodel指定布局。

origin -点指定的起源。

异常

RasterFormatException -如果在整数溢出计算 origin.x + sampleModel.getWidth()或 origin.y + sampleModel.getHeight()结果

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         DataBuffer dataBuffer,
                         Point origin)

构建一个与给定的samplemodel和DataBuffer writableraster。的writableraster左上角的起源和它的大小像SampleModel一样。DataBuffer没有初始化，必须兼容SampleModel。

参数

sampleModel - samplemodel指定布局。

dataBuffer -包含图像数据的数据缓冲区。

origin -点指定的起源。

异常

RasterFormatException -如果在整数溢出计算 origin.x + sampleModel.getWidth()或 origin.y + sampleModel.getHeight()结果

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         DataBuffer dataBuffer,
                         Rectangle aRegion,
                         Point sampleModelTranslate,
                         WritableRaster parent)

构建了一个writableraster与给定的samplemodel，DataBuffer，和父母。地区指定新的边界矩形栅格。当转化为基础栅格的坐标系统，区域必须由基础栅格包含。（基准光栅的光栅的祖先没有父。）samplemodeltranslate指定samplemodeltranslatex和新栅格samplemodeltranslatey值。请注意，这个构造函数通常应该由其他构造函数调用或创建方法，它不应该直接使用。

参数

sampleModel - samplemodel指定布局。

dataBuffer -包含图像数据的数据缓冲区。

aRegion -矩形指定图像区域。

sampleModelTranslate -点指定的翻译从SampleModel到栅格坐标。

parent -母（如果有）这个栅格。

异常

如果有 RasterFormatException aRegion宽度或高度小于或等于零，或整数溢出计算 aRegion.x + aRegion.width或 aRegion.y + aRegion.height结果

方法详细信息

getWritableParent

public WritableRaster getWritableParent()

返回父writableraster（如果有的话）这writableraster，否则无效。

结果

这 WritableRaster母，或 null。

createWritableTranslatedChild

public WritableRaster createWritableTranslatedChild(int childMinX,
                                                    int childMinY)

创建一个具有相同的大小writableraster、SampleModel和DataBuffer的这一个，但不同的位置。新writableraster具有参考当前writableraster，可通过其getparent()和getwritableparent()方法。

参数

childMinX -新的栅格的左上角的x坐标。

childMinY Y坐标的新栅格的左上角。

结果

一个 WritableRaster相同这一除指定位置。

异常

RasterFormatException -如果在整数溢出计算 childMinX + this.getWidth()或 childMinY + this.getHeight()结果

createWritableChild

public WritableRaster createWritableChild(int parentX,
                                          int parentY,
                                          int w,
                                          int h,
                                          int childMinX,
                                          int childMinY,
                                          int[] bandList)

返回一个新的writableraster股份全部或部分本writableraster DataBuffer。新writableraster具有参考当前writableraster，可通过其getparent()和getwritableparent()方法。

parentx保的，宽度和高度参数的形式在这个writableraster坐标空间的一个矩形，表示要共享像素面积。一个错误将这个矩形不包含与当前writableraster界抛出。

此外，新的writableraster可以转化为不同的坐标系统的飞机比目前使用的writableraster。的childminx和childminy参数给新（x，y）的writableraster返回左上像素点的坐标；坐标（childminx，childminy）在新的writableraster将映射到相同的像素的坐标（parentx，保）在当前writableraster。

新writableraster可以定义为只包含一个子集的当前writableraster，乐队可能重组，通过对bandlist参数。如果bandlist是空的，它被包括在目前的订单所有的电流writableraster乐队。

创建一个包含一个分区当前writableraster新writableraster，但股价的坐标系统和带，这种方法应该被称为childminx等于parentx，childminy等于保和bandlist等于零。

参数

parentX -在这writableraster的坐标，左上角的x坐标。

parentY -在这writableraster的坐标，左上角的y坐标。

w开始在区域的宽度（parentx，保）。

h高度的区域开始（parentx，保）。

childMinX的writableraster返回左上角的x坐标。

childMinY - y的writableraster返回左上角坐标。

bandList -带指数阵列，或使用带空。

结果

一个 WritableRaster共享全部或部分本 WritableRaster的 DataBuffer。

异常

RasterFormatException如果分区是栅格界限之外。

RasterFormatException -如果 w或 h小于或等于零，或计算任何 parentX + w， parentY + h， childMinX + w，或 childMinY + h结果整数溢出

setDataElements

public void setDataElements(int x,
                            int y,
                            Object inData)

设置从原始数组类型transfertype单个像素的数据。图像数据的二维支持java（TM）的API，这将是一个databuffer.type_byte，databuffer.type_ushort，databuffer.type_int，databuffer.type_short，databuffer.type_float，或databuffer.type_double。数组中的数据可能是一个封装的格式，从而提高了数据传输的效率。一个对象的大小时抛出可能如果坐标不界泛起，或者如果数据不足以容纳像素数据。然而，明确的界限检查是没有保证。如果将一个对象的输入对象不为空引用的任何其他比transfertype数组抛出。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

inData -一个对象的引用数组的类型定义的gettransfertype()和长度，在包含像素数据getnumdataelements() X，Y.

异常

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果数据太小装的输入。

另请参见：

SampleModel.setDataElements(int, int, Object, DataBuffer)

setDataElements

public void setDataElements(int x,
                            int y,
                            Raster inRaster)

从输入光栅设置一个像素的矩形的数据。输入栅格必须与这writableraster兼容，它们必须有相同数量的频带，对应波段必须每个样本的位数相同的号码，该transfertypes和numdataelements必须相同，并由getdataelements / setdataelements用包装必须相同。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

inRaster含数据放置在X光栅，Y.

异常

NullPointerException -如果inraster是空的。

ArrayIndexOutOfBoundsException -如果坐标没有界限。

setDataElements

public void setDataElements(int x,
                            int y,
                            int w,
                            int h,
                            Object inData)

设置从原始数组类型transfertype矩形像素数据。图像数据的java 2D API的支持，这将是一个databuffer.type_byte，databuffer.type_ushort，databuffer.type_int，databuffer.type_short，databuffer.type_float，或databuffer.type_double。数组中的数据可能是一个封装的格式，从而提高了数据传输的效率。一个对象的大小时抛出可能如果坐标不界泛起，或者如果数据不足以容纳像素数据。然而，明确的界限检查是没有保证。如果将一个对象的输入对象不为空引用的任何其他比transfertype数组抛出。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

inData -一个对象的引用数组的类型定义的gettransfertype()和长宽*高* getnumdataelements()所含像素数据之间的X，Y和X + Y + W-1，H-1。

异常

NullPointerException如果数据是无效的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果数据太小装的输入。

另请参见：

SampleModel.setDataElements(int, int, int, int, Object, DataBuffer)

setRect

public void setRect(Raster srcRaster)

份像素栅格srcraster这writableraster。在srcraster每个像素复制到相同的X，这个栅格Y地址，如果地址超出了该光栅的界限。srcraster必须有相同数量的频带为这writableraster。该副本是一个简单的源样本的副本到相应的目标样本。

如果源和目标的光栅样品的积分型和小于或等于32号位，然后调用此方法等效于所有x,y地址有效Rasters执行下面的代码。

       Raster srcRaster;
       WritableRaster dstRaster;
       for (int b = 0; b < srcRaster.getNumBands(); b++) {
           dstRaster.setSample(x, y, b, srcRaster.getSample(x, y, b));
       }
 

因此，当复制一个整体式源一体式的目的地，如果源样本大小大于某一波段的目标样本，源样品的高阶位截断。如果源样本大小是小于一个特定的波段目标大小、目标的高阶位零扩展或符号扩展取决于srcraster的SampleModel把样品作为一个符号或无符号数。

当将浮点或双源复制到一个整型目的地时，每个源样本都被转换为目标类型。当复制一个整体式源float或double目标源是先转换为32位整数（如果需要），使用整数类型上述规则，然后投到float或者double，int。

参数

srcRaster -从复制像素栅格。

异常

NullPointerException -如果srcraster是空的。

setRect

public void setRect(int dx,
                    int dy,
                    Raster srcRaster)

份像素栅格srcraster这writableraster。每个（x，y）地址在srcraster，对应的像素复制到地址（X + Y + dx，dy）在这writableraster，除非（X + Y + dx，dy）超出了该光栅的界限。srcraster必须有相同数量的频带为这writableraster。该副本是一个简单的源样本的副本到相应的目标样本。详情见 setRect(Raster)。

参数

dx - X翻译因子SRC空间到复制DST空间。

dy - Y平移因子SRC空间到复制DST空间。

srcRaster -从复制像素栅格。

异常

NullPointerException -如果srcraster是空的。

setPixel

public void setPixel(int x,
                     int y,
                     int[] iArray)

设置一个像素使用的样本输入一个int数组的数据缓存。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

iArray -在一个int数组的输入样本。

异常

NullPointerException -如果iarray是空的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果iarray太小装的输入。

setPixel

public void setPixel(int x,
                     int y,
                     float[] fArray)

设置一个像素使用一个样本输入浮点数组的数据缓存。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

fArray -在一个浮点数组输入样本。

异常

NullPointerException -如果farray是空的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输入。

setPixel

public void setPixel(int x,
                     int y,
                     double[] dArray)

设置一个像素使用输入的双数组中的样本数据缓存。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

dArray -双阵列的输入样本。

异常

NullPointerException -如果darray是空的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果darray太小装的输入。

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      int[] iArray)

设置从一个数组的数组元素包含每一个样本像素矩形样品。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

iArray -输入整数像素阵列。

异常

NullPointerException -如果iarray是空的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果iarray太小装的输入。

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      float[] fArray)

将包含一个数组元素的浮动数组中的每个像素的矩形设置为一个矩形。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

fArray -输入浮点像素阵列。

异常

NullPointerException -如果farray是空的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输入。

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      double[] dArray)

将包含一个数组元素的双数组中的一个像素的矩形设置为一个矩形。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

dArray -输入双像素阵列。

异常

NullPointerException -如果darray是空的。

ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果darray太小装的输入。

setSample

public void setSample(int x,
                      int y,
                      int b,
                      int s)

设置指定的带样的像素位于（x，y）用于输入一个int的数据缓存。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

b -带套。

s -输入样本。

异常

ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。

setSample

public void setSample(int x,
                      int y,
                      int b,
                      float s)

设置指定的带样的像素位于（x，y）用于输入一个浮在数据缓存。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

b -带套。

s -输入样本为一个浮动。

异常

ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。

setSample

public void setSample(int x,
                      int y,
                      int b,
                      double s)

设置指定的带样的像素位于（x，y）使用一个双输入的数据缓存。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x的像素位置的x坐标。

y的像素位置的y坐标。

b -带套。

s -输入样本为双。

异常

ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       int[] iArray)

设置指定矩形的像素从一个int数组包含一个样品在每个数组元素指定带样品。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

b -带套。

iArray -输入int样本阵列。

异常

NullPointerException -如果iarray是空的。

ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果iarray太小装的输入。

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       float[] fArray)

将包含一个数组元素的浮点数数组指定为指定的矩形区域中的样本设置为指定的矩形。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

b -带套。

fArray -输入浮样品阵列。

异常

NullPointerException -如果farray是空的。

ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果farray太小装的输入。

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       double[] dArray)

将指定的带中的样本设置为指定的矩形，从每个数组元素的一个数组包含一个样本。一个对象的大小时抛出可能如果坐标不界抛出。然而，明确的界限检查是没有保证。

参数

x -左上角像素位置的x坐标。

y -左上角像素位置的y坐标。

w -像素矩形的宽度。

h -像素矩形的高度。

b -带套。

dArray -输入双样本阵列。

异常

NullPointerException -如果darray是空的。

ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果darray太小装的输入。