< prev index next >
src/java.desktop/share/classes/java/awt/Image.java
Print this page
@@ -33,11 +33,11 @@
import sun.awt.image.SurfaceManager;
/**
- * The abstract class <code>Image</code> is the superclass of all
+ * The abstract class {@code Image} is the superclass of all
* classes that represent graphical images. The image must be
* obtained in a platform-specific manner.
*
* @author Sami Shaio
* @author Arthur van Hoff
@@ -55,33 +55,33 @@
/**
* Priority for accelerating this image. Subclasses are free to
* set different default priorities and applications are free to
* set the priority for specific images via the
- * <code>setAccelerationPriority(float)</code> method.
+ * {@code setAccelerationPriority(float)} method.
* @since 1.5
*/
protected float accelerationPriority = .5f;
/**
* Determines the width of the image. If the width is not yet known,
- * this method returns <code>-1</code> and the specified
- * <code>ImageObserver</code> object is notified later.
+ * this method returns {@code -1} and the specified
+ * {@code ImageObserver} object is notified later.
* @param observer an object waiting for the image to be loaded.
- * @return the width of this image, or <code>-1</code>
+ * @return the width of this image, or {@code -1}
* if the width is not yet known.
* @see java.awt.Image#getHeight
* @see java.awt.image.ImageObserver
*/
public abstract int getWidth(ImageObserver observer);
/**
* Determines the height of the image. If the height is not yet known,
- * this method returns <code>-1</code> and the specified
- * <code>ImageObserver</code> object is notified later.
+ * this method returns {@code -1} and the specified
+ * {@code ImageObserver} object is notified later.
* @param observer an object waiting for the image to be loaded.
- * @return the height of this image, or <code>-1</code>
+ * @return the height of this image, or {@code -1}
* if the height is not yet known.
* @see java.awt.Image#getWidth
* @see java.awt.image.ImageObserver
*/
public abstract int getHeight(ImageObserver observer);
@@ -110,17 +110,17 @@
/**
* Gets a property of this image by name.
* <p>
* Individual property names are defined by the various image
* formats. If a property is not defined for a particular image, this
- * method returns the <code>UndefinedProperty</code> object.
+ * method returns the {@code UndefinedProperty} object.
* <p>
* If the properties for this image are not yet known, this method
- * returns <code>null</code>, and the <code>ImageObserver</code>
+ * returns {@code null}, and the {@code ImageObserver}
* object is notified later.
* <p>
- * The property name <code>"comment"</code> should be used to store
+ * The property name {@code "comment"} should be used to store
* an optional comment which can be presented to the application as a
* description of the image, its source, or its author.
* @param name a property name.
* @param observer an object waiting for this image to be loaded.
* @return the value of the named property.
@@ -129,38 +129,38 @@
* @see java.awt.Image#UndefinedProperty
*/
public abstract Object getProperty(String name, ImageObserver observer);
/**
- * The <code>UndefinedProperty</code> object should be returned whenever a
+ * The {@code UndefinedProperty} object should be returned whenever a
* property which was not defined for a particular image is fetched.
*/
public static final Object UndefinedProperty = new Object();
/**
* Creates a scaled version of this image.
- * A new <code>Image</code> object is returned which will render
- * the image at the specified <code>width</code> and
- * <code>height</code> by default. The new <code>Image</code> object
+ * A new {@code Image} object is returned which will render
+ * the image at the specified {@code width} and
+ * {@code height} by default. The new {@code Image} object
* may be loaded asynchronously even if the original source image
* has already been loaded completely.
*
* <p>
*
- * If either <code>width</code>
- * or <code>height</code> is a negative number then a value is
+ * If either {@code width}
+ * or {@code height} is a negative number then a value is
* substituted to maintain the aspect ratio of the original image
- * dimensions. If both <code>width</code> and <code>height</code>
+ * dimensions. If both {@code width} and {@code height}
* are negative, then the original image dimensions are used.
*
* @param width the width to which to scale the image.
* @param height the height to which to scale the image.
* @param hints flags to indicate the type of algorithm to use
* for image resampling.
* @return a scaled version of the image.
- * @exception IllegalArgumentException if <code>width</code>
- * or <code>height</code> is zero.
+ * @exception IllegalArgumentException if {@code width}
+ * or {@code height} is zero.
* @see java.awt.Image#SCALE_DEFAULT
* @see java.awt.Image#SCALE_FAST
* @see java.awt.Image#SCALE_SMOOTH
* @see java.awt.Image#SCALE_REPLICATE
* @see java.awt.Image#SCALE_AREA_AVERAGING
@@ -198,12 +198,12 @@
*/
public static final int SCALE_SMOOTH = 4;
/**
* Use the image scaling algorithm embodied in the
- * <code>ReplicateScaleFilter</code> class.
- * The <code>Image</code> object is free to substitute a different filter
+ * {@code ReplicateScaleFilter} class.
+ * The {@code Image} object is free to substitute a different filter
* that performs the same algorithm yet integrates more efficiently
* into the imaging infrastructure supplied by the toolkit.
* @see java.awt.image.ReplicateScaleFilter
* @since 1.1
*/
@@ -272,15 +272,15 @@
* might create a BufferedImage but the system may have
* no video memory left for creating an image of that
* size on the given GraphicsConfiguration, so although the object
* may be acceleratable in general, it
* does not have that capability on this GraphicsConfiguration.
- * @param gc a <code>GraphicsConfiguration</code> object. A value of null
+ * @param gc a {@code GraphicsConfiguration} object. A value of null
* for this parameter will result in getting the image capabilities
- * for the default <code>GraphicsConfiguration</code>.
- * @return an <code>ImageCapabilities</code> object that contains
- * the capabilities of this <code>Image</code> on the specified
+ * for the default {@code GraphicsConfiguration}.
+ * @return an {@code ImageCapabilities} object that contains
+ * the capabilities of this {@code Image} on the specified
* GraphicsConfiguration.
* @see java.awt.image.VolatileImage#getCapabilities()
* VolatileImage.getCapabilities()
* @since 1.5
*/
@@ -311,11 +311,11 @@
* @param priority a value between 0 and 1, inclusive, where higher
* values indicate more importance for acceleration. A value of 0
* means that this Image should never be accelerated. Other values
* are used simply to determine acceleration priority relative to other
* Images.
- * @throws IllegalArgumentException if <code>priority</code> is less
+ * @throws IllegalArgumentException if {@code priority} is less
* than zero or greater than 1.
* @since 1.5
*/
public void setAccelerationPriority(float priority) {
if (priority < 0 || priority > 1) {
< prev index next >