src/java.desktop/share/classes/java/awt/image/WritableRenderedImage.java

Print this page




  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 /* ****************************************************************
  27  ******************************************************************
  28  ******************************************************************
  29  *** COPYRIGHT (c) Eastman Kodak Company, 1997
  30  *** As  an unpublished  work pursuant to Title 17 of the United
  31  *** States Code.  All rights reserved.
  32  ******************************************************************
  33  ******************************************************************
  34  ******************************************************************/
  35 
  36 package java.awt.image;
  37 import java.awt.Point;
  38 
  39 /**
  40  * WriteableRenderedImage is a common interface for objects which
  41  * contain or can produce image data in the form of Rasters and
  42  * which can be modified and/or written over.  The image
  43  * data may be stored/produced as a single tile or a regular array
  44  * of tiles.
  45  * <p>
  46  * WritableRenderedImage provides notification to other interested
  47  * objects when a tile is checked out for writing (via the
  48  * getWritableTile method) and when the last writer of a particular
  49  * tile relinquishes its access (via a call to releaseWritableTile).
  50  * Additionally, it allows any caller to determine whether any tiles
  51  * are currently checked out (via hasTileWriters), and to obtain a
  52  * list of such tiles (via getWritableTileIndices, in the form of a Vector
  53  * of Point objects).
  54  * <p>
  55  * Objects wishing to be notified of changes in tile writability must
  56  * implement the TileObserver interface, and are added by a
  57  * call to addTileObserver.  Multiple calls to
  58  * addTileObserver for the same object will result in multiple
  59  * notifications.  An existing observer may reduce its notifications
  60  * by calling removeTileObserver; if the observer had no




  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 /* ****************************************************************
  27  ******************************************************************
  28  ******************************************************************
  29  *** COPYRIGHT (c) Eastman Kodak Company, 1997
  30  *** As  an unpublished  work pursuant to Title 17 of the United
  31  *** States Code.  All rights reserved.
  32  ******************************************************************
  33  ******************************************************************
  34  ******************************************************************/
  35 
  36 package java.awt.image;
  37 import java.awt.Point;
  38 
  39 /**
  40  * WritableRenderedImage is a common interface for objects which
  41  * contain or can produce image data in the form of Rasters and
  42  * which can be modified and/or written over.  The image
  43  * data may be stored/produced as a single tile or a regular array
  44  * of tiles.
  45  * <p>
  46  * WritableRenderedImage provides notification to other interested
  47  * objects when a tile is checked out for writing (via the
  48  * getWritableTile method) and when the last writer of a particular
  49  * tile relinquishes its access (via a call to releaseWritableTile).
  50  * Additionally, it allows any caller to determine whether any tiles
  51  * are currently checked out (via hasTileWriters), and to obtain a
  52  * list of such tiles (via getWritableTileIndices, in the form of a Vector
  53  * of Point objects).
  54  * <p>
  55  * Objects wishing to be notified of changes in tile writability must
  56  * implement the TileObserver interface, and are added by a
  57  * call to addTileObserver.  Multiple calls to
  58  * addTileObserver for the same object will result in multiple
  59  * notifications.  An existing observer may reduce its notifications
  60  * by calling removeTileObserver; if the observer had no