From: Thomas Fitzsimmons Date: Wed, 4 May 2005 18:25:37 +0000 (+0000) Subject: ImageCapabilities.java: Document. X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=d1ca2cfe44542bf78b9386903cd6d86fe5cf5f4a;p=platform%2Fupstream%2Fgcc.git ImageCapabilities.java: Document. 2005-05-04 Thomas Fitzsimmons * java/awt/ImageCapabilities.java: Document. * java/awt/image/VolatileImage.java: Unindent copyright header. From-SVN: r99224 --- diff --git a/libjava/ChangeLog b/libjava/ChangeLog index 5433712..8d9b5a8 100644 --- a/libjava/ChangeLog +++ b/libjava/ChangeLog @@ -1,3 +1,9 @@ +2005-05-04 Thomas Fitzsimmons + + * java/awt/ImageCapabilities.java: Document. + + * java/awt/image/VolatileImage.java: Unindent copyright header. + 2005-05-03 Thomas Fitzsimmons * java/awt/image/VolatileImage.java: Document. diff --git a/libjava/java/awt/ImageCapabilities.java b/libjava/java/awt/ImageCapabilities.java index 4d274e2..df802c6 100644 --- a/libjava/java/awt/ImageCapabilities.java +++ b/libjava/java/awt/ImageCapabilities.java @@ -1,5 +1,5 @@ -/* ImageCapabilities.java -- - Copyright (C) 2002 Free Software Foundation, Inc. +/* ImageCapabilities.java -- the capabilities of an image buffer + Copyright (C) 2002, 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. @@ -39,23 +39,60 @@ exception statement from your version. */ package java.awt; /** - * STUBS ONLY + * This class represents the capabilities of an image buffer. An + * image buffer may be backed by accelerated graphics resources. + * Those resources may or may not be volatile. This class is used to + * describe these image buffer characteristics. */ public class ImageCapabilities implements Cloneable { + /** + * Whether or not this the image buffer uses accelerated graphics + * resources. + */ private final boolean accelerated; + + /** + * Create a new image capability descriptor. + * + * @param accelerated true if the image buffer uses accelerated + * graphics resources + */ public ImageCapabilities(boolean accelerated) { this.accelerated = accelerated; } + + /** + * Returns whether or not the image buffer uses accelerated graphics + * resources. + * + * @return true if the image buffer uses accelerated graphics + * resources; false otherwise + */ public boolean isAccelerated() { return accelerated; } + + /** + * Returns whether or not the image buffer's resources are volatile, + * meaning that they can be reclaimed by the graphics system at any + * time. + * + * @return true if the image buffer's resources are volatile; false + * otherwise + */ public boolean isTrueVolatile() { return true; } + + /** + * Clone this image capability descriptor. + * + * @return a clone of this image capability descriptor + */ public Object clone() { try @@ -64,7 +101,7 @@ public class ImageCapabilities implements Cloneable } catch (CloneNotSupportedException e) { - throw (Error) new InternalError().initCause(e); // Impossible + throw (Error) new InternalError().initCause(e); } } -} // class ImageCapabilities +} diff --git a/libjava/java/awt/image/VolatileImage.java b/libjava/java/awt/image/VolatileImage.java index 63d1952..952f9f6 100644 --- a/libjava/java/awt/image/VolatileImage.java +++ b/libjava/java/awt/image/VolatileImage.java @@ -1,39 +1,39 @@ /* VolatileImage.java -- a hardware-accelerated image buffer Copyright (C) 2002, 2005 Free Software Foundation, Inc. - This file is part of GNU Classpath. - - GNU Classpath is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2, or (at your option) - any later version. - - GNU Classpath is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. - - You should have received a copy of the GNU General Public License - along with GNU Classpath; see the file COPYING. If not, write to the - Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA - 02111-1307 USA. - - Linking this library statically or dynamically with other modules is - making a combined work based on this library. Thus, the terms and - conditions of the GNU General Public License cover the whole - combination. - - As a special exception, the copyright holders of this library give you - permission to link this library with independent modules to produce an - executable, regardless of the license terms of these independent - modules, and to copy and distribute the resulting executable under - terms of your choice, provided that you also meet, for each linked - independent module, the terms and conditions of the license of that - module. An independent module is a module which is not derived from - or based on this library. If you modify this library, you may extend - this exception to your version of the library, but you are not - obligated to do so. If you do not wish to do so, delete this - exception statement from your version. */ +This file is part of GNU Classpath. + +GNU Classpath is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +GNU Classpath is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with GNU Classpath; see the file COPYING. If not, write to the +Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +02111-1307 USA. + +Linking this library statically or dynamically with other modules is +making a combined work based on this library. Thus, the terms and +conditions of the GNU General Public License cover the whole +combination. + +As a special exception, the copyright holders of this library give you +permission to link this library with independent modules to produce an +executable, regardless of the license terms of these independent +modules, and to copy and distribute the resulting executable under +terms of your choice, provided that you also meet, for each linked +independent module, the terms and conditions of the license of that +module. An independent module is a module which is not derived from +or based on this library. If you modify this library, you may extend +this exception to your version of the library, but you are not +obligated to do so. If you do not wish to do so, delete this +exception statement from your version. */ package java.awt.image; @@ -152,7 +152,7 @@ public abstract class VolatileImage extends Image * VolatileImages are typically optimized for writing. * * @return an ImageProducer for a static BufferedImage snapshot of - * this image buffer. + * this image buffer */ public ImageProducer getSource() { @@ -245,7 +245,7 @@ public abstract class VolatileImage extends Image * Returns the transparency type of this image. * * @return Transparency.OPAQUE, Transparency.BITMASK or - * Transparency.TRANSLUCENT. + * Transparency.TRANSLUCENT */ public int getTransparency() {