8149593: Change <code>foo</code> to {@code foo} in TIFF plugin classes
Summary: Change <code>foo</code> to {@code foo} in TIFF plugin classes and 2015 to 2016 where needed.
Reviewed-by: prr, darcy
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFBaseJPEGCompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFBaseJPEGCompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -86,16 +86,16 @@
/**
* Whether to write abbreviated JPEG streams (default == false).
- * A subclass which sets this to <code>true</code> should also
+ * A subclass which sets this to {@code true} should also
* initialized {@link #JPEGStreamMetadata}.
*/
protected boolean writeAbbreviatedStream = false;
/**
* Stream metadata equivalent to a tables-only stream such as in
- * the <code>JPEGTables</code>. Default value is <code>null</code>.
+ * the {@code JPEGTables}. Default value is {@code null}.
* This should be set by any subclass which sets
- * {@link writeAbbreviatedStream} to <code>true</code>.
+ * {@link writeAbbreviatedStream} to {@code true}.
*/
protected IIOMetadata JPEGStreamMetadata = null;
@@ -108,15 +108,15 @@
/**
* Removes nonessential nodes from a JPEG native image metadata tree.
* All nodes derived from JPEG marker segments other than DHT, DQT,
- * SOF, SOS segments are removed unless <code>pruneTables</code> is
- * <code>true</code> in which case the nodes derived from the DHT and
+ * SOF, SOS segments are removed unless {@code pruneTables} is
+ * {@code true} in which case the nodes derived from the DHT and
* DQT marker segments are also removed.
*
* @param tree A <tt>javax_imageio_jpeg_image_1.0</tt> tree.
* @param pruneTables Whether to prune Huffman and quantization tables.
- * @throws NullPointerException if <code>tree</code> is
- * <code>null</code>.
- * @throws IllegalArgumentException if <code>tree</code> is not the root
+ * @throws NullPointerException if {@code tree} is
+ * {@code null}.
+ * @throws IllegalArgumentException if {@code tree} is not the root
* of a JPEG native image metadata tree.
*/
private static void pruneNodes(Node tree, boolean pruneTables) {
@@ -182,8 +182,8 @@
}
/**
- * A <code>ByteArrayOutputStream</code> which allows writing to an
- * <code>ImageOutputStream</code>.
+ * A {@code ByteArrayOutputStream} which allows writing to an
+ * {@code ImageOutputStream}.
*/
private static class IIOByteArrayOutputStream extends ByteArrayOutputStream {
IIOByteArrayOutputStream() {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFColorConverter.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFColorConverter.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -31,39 +31,39 @@
public abstract class TIFFColorConverter {
/**
- * Constructs an instance of a <code>TIFFColorConverter</code>.
+ * Constructs an instance of a {@code TIFFColorConverter}.
*/
public TIFFColorConverter() {}
/**
* Converts an RGB triple into the native color space of this
* TIFFColorConverter, and stores the result in the first three
- * entries of the <code>result</code> array.
+ * entries of the {@code result} array.
*
* @param r the red value.
* @param g the green value.
* @param b the blue value.
- * @param result an array of <code>float</code>s containing three elements.
- * @throws NullPointerException if <code>result</code> is
- * <code>null</code>.
+ * @param result an array of {@code float}s containing three elements.
+ * @throws NullPointerException if {@code result} is
+ * {@code null}.
* @throws ArrayIndexOutOfBoundsException if
- * <code>result.length < 3</code>.
+ * {@code result.length < 3}.
*/
public abstract void fromRGB(float r, float g, float b, float[] result);
/**
* Converts a triple in the native color space of this
* TIFFColorConverter into an RGB triple, and stores the result in
- * the first three entries of the <code>rgb</code> array.
+ * the first three entries of the {@code rgb} array.
*
* @param x0 the value of channel 0.
* @param x1 the value of channel 1.
* @param x2 the value of channel 2.
- * @param rgb an array of <code>float</code>s containing three elements.
- * @throws NullPointerException if <code>rgb</code> is
- * <code>null</code>.
+ * @param rgb an array of {@code float}s containing three elements.
+ * @throws NullPointerException if {@code rgb} is
+ * {@code null}.
* @throws ArrayIndexOutOfBoundsException if
- * <code>rgb.length < 3</code>.
+ * {@code rgb.length < 3}.
*/
public abstract void toRGB(float x0, float x1, float x2, float[] rgb);
}
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFCompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFCompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -35,13 +35,13 @@
public abstract class TIFFCompressor {
/**
- * The <code>ImageWriter</code> calling this
- * <code>TIFFCompressor</code>.
+ * The {@code ImageWriter} calling this
+ * {@code TIFFCompressor}.
*/
protected ImageWriter writer;
/**
- * The <code>IIOMetadata</code> object containing metadata for the
+ * The {@code IIOMetadata} object containing metadata for the
* current image.
*/
protected IIOMetadata metadata;
@@ -63,7 +63,7 @@
protected boolean isCompressionLossless;
/**
- * The <code>ImageOutputStream</code> to be written.
+ * The {@code ImageOutputStream} to be written.
*/
protected ImageOutputStream stream;
@@ -75,26 +75,26 @@
* to provide the implementation of the compression algorithm of an
* unsupported compression type.
*
- * <p>The parameters <code>compressionTagValue</code> and
- * <code>isCompressionLossless</code> are provided to accomodate
+ * <p>The parameters {@code compressionTagValue} and
+ * {@code isCompressionLossless} are provided to accomodate
* compression types which are unknown. A compression type is
* "known" if it is either among those already supported by the
* TIFF writer (see {@link TIFFImageWriteParam}), or is listed in
* the TIFF 6.0 specification but not supported. If the compression
- * type is unknown, the <code>compressionTagValue</code> and
- * <code>isCompressionLossless</code> parameters are ignored.</p>
+ * type is unknown, the {@code compressionTagValue} and
+ * {@code isCompressionLossless} parameters are ignored.</p>
*
* @param compressionType The name of the compression type.
* @param compressionTagValue The value to be assigned to the TIFF
* <i>Compression</i> tag in the TIFF image metadata; ignored if
- * <code>compressionType</code> is a known type.
+ * {@code compressionType} is a known type.
* @param isCompressionLossless Whether the compression is lossless;
- * ignored if <code>compressionType</code> is a known type.
+ * ignored if {@code compressionType} is a known type.
*
- * @throws NullPointerException if <code>compressionType</code> is
- * <code>null</code>.
- * @throws IllegalArgumentException if <code>compressionTagValue</code> is
- * less <code>1</code>.
+ * @throws NullPointerException if {@code compressionType} is
+ * {@code null}.
+ * @throws IllegalArgumentException if {@code compressionTagValue} is
+ * less {@code 1}.
*/
public TIFFCompressor(String compressionType,
int compressionTagValue,
@@ -163,9 +163,9 @@
}
/**
- * Sets the <code>ImageOutputStream</code> to be written.
+ * Sets the {@code ImageOutputStream} to be written.
*
- * @param stream an <code>ImageOutputStream</code> to be written.
+ * @param stream an {@code ImageOutputStream} to be written.
*
* @see #getStream
*/
@@ -174,9 +174,9 @@
}
/**
- * Returns the <code>ImageOutputStream</code> that will be written.
+ * Returns the {@code ImageOutputStream} that will be written.
*
- * @return an <code>ImageOutputStream</code>.
+ * @return an {@code ImageOutputStream}.
*
* @see #setStream(ImageOutputStream)
*/
@@ -185,9 +185,9 @@
}
/**
- * Sets the value of the <code>writer</code> field.
+ * Sets the value of the {@code writer} field.
*
- * @param writer the current <code>ImageWriter</code>.
+ * @param writer the current {@code ImageWriter}.
*
* @see #getWriter()
*/
@@ -196,9 +196,9 @@
}
/**
- * Returns the current <code>ImageWriter</code>.
+ * Returns the current {@code ImageWriter}.
*
- * @return an <code>ImageWriter</code>.
+ * @return an {@code ImageWriter}.
*
* @see #setWriter(ImageWriter)
*/
@@ -207,9 +207,9 @@
}
/**
- * Sets the value of the <code>metadata</code> field.
+ * Sets the value of the {@code metadata} field.
*
- * @param metadata the <code>IIOMetadata</code> object for the
+ * @param metadata the {@code IIOMetadata} object for the
* image being written.
*
* @see #getMetadata()
@@ -219,9 +219,9 @@
}
/**
- * Returns the current <code>IIOMetadata</code> object.
+ * Returns the current {@code IIOMetadata} object.
*
- * @return the <code>IIOMetadata</code> object for the image being
+ * @return the {@code IIOMetadata} object for the image being
* written.
*
* @see #setMetadata(IIOMetadata)
@@ -232,15 +232,15 @@
/**
* Encodes the supplied image data, writing to the currently set
- * <code>ImageOutputStream</code>.
+ * {@code ImageOutputStream}.
*
- * @param b an array of <code>byte</code>s containing the packed
+ * @param b an array of {@code byte}s containing the packed
* but uncompressed image data.
* @param off the starting offset of the data to be written in the
- * array <code>b</code>.
+ * array {@code b}.
* @param width the width of the rectangle of pixels to be written.
* @param height the height of the rectangle of pixels to be written.
- * @param bitsPerSample an array of <code>int</code>s indicting
+ * @param bitsPerSample an array of {@code int}s indicting
* the number of bits used to represent each image sample within
* a pixel.
* @param scanlineStride the number of bytes separating each
@@ -249,7 +249,7 @@
* @return the number of bytes written.
*
* @throws IOException if the supplied data cannot be encoded by
- * this <code>TIFFCompressor</code>, or if any I/O error occurs
+ * this {@code TIFFCompressor}, or if any I/O error occurs
* during writing.
*/
public abstract int encode(byte[] b, int off,
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFDecompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFDecompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -81,7 +81,7 @@
*
* <p> Decompressors may be written with various levels of complexity.
* The most complex decompressors will override the
- * <code>decode</code> method, and will perform all the work of
+ * {@code decode} method, and will perform all the work of
* decoding, subsampling, offsetting, clipping, and format conversion.
* This approach may be the most efficient, since it is possible to
* avoid the use of extra image buffers, and it may be possible to
@@ -89,35 +89,35 @@
* the destination.
*
* <p> Less ambitious decompressors may override the
- * <code>decodeRaw</code> method, which is responsible for
+ * {@code decodeRaw} method, which is responsible for
* decompressing the entire tile or strip into a byte array (or other
* appropriate datatype). The default implementation of
- * <code>decode</code> will perform all necessary setup of buffers,
- * call <code>decodeRaw</code> to perform the actual decoding, perform
+ * {@code decode} will perform all necessary setup of buffers,
+ * call {@code decodeRaw} to perform the actual decoding, perform
* subsampling, and copy the results into the final destination image.
* Where possible, it will pass the real image buffer to
- * <code>decodeRaw</code> in order to avoid making an extra copy.
+ * {@code decodeRaw} in order to avoid making an extra copy.
*
* <p> Slightly more ambitious decompressors may override
- * <code>decodeRaw</code>, but avoid writing pixels that will be
+ * {@code decodeRaw}, but avoid writing pixels that will be
* discarded in the subsampling phase.
*/
public abstract class TIFFDecompressor {
/**
- * The <code>ImageReader</code> calling this
- * <code>TIFFDecompressor</code>.
+ * The {@code ImageReader} calling this
+ * {@code TIFFDecompressor}.
*/
protected ImageReader reader;
/**
- * The <code>IIOMetadata</code> object containing metadata for the
+ * The {@code IIOMetadata} object containing metadata for the
* current image.
*/
protected IIOMetadata metadata;
/**
- * The value of the <code>PhotometricInterpretation</code> tag.
+ * The value of the {@code PhotometricInterpretation} tag.
* Legal values are {@link
* BaselineTIFFTagSet#PHOTOMETRIC_INTERPRETATION_WHITE_IS_ZERO },
* {@link
@@ -135,7 +135,7 @@
protected int photometricInterpretation;
/**
- * The value of the <code>Compression</code> tag. Legal values are
+ * The value of the {@code Compression} tag. Legal values are
* {@link BaselineTIFFTagSet#COMPRESSION_NONE}, {@link
* BaselineTIFFTagSet#COMPRESSION_CCITT_RLE}, {@link
* BaselineTIFFTagSet#COMPRESSION_CCITT_T_4}, {@link
@@ -151,23 +151,23 @@
protected int compression;
/**
- * <code>true</code> if the image is encoded using separate planes.
+ * {@code true} if the image is encoded using separate planes.
*/
protected boolean planar;
/**
- * The value of the <code>SamplesPerPixel</code> tag.
+ * The value of the {@code SamplesPerPixel} tag.
*/
protected int samplesPerPixel;
/**
- * The value of the <code>BitsPerSample</code> tag.
+ * The value of the {@code BitsPerSample} tag.
*
*/
protected int[] bitsPerSample;
/**
- * The value of the <code>SampleFormat</code> tag. Legal values
+ * The value of the {@code SampleFormat} tag. Legal values
* are {@link BaselineTIFFTagSet#SAMPLE_FORMAT_UNSIGNED_INTEGER},
* {@link BaselineTIFFTagSet#SAMPLE_FORMAT_SIGNED_INTEGER}, {@link
* BaselineTIFFTagSet#SAMPLE_FORMAT_FLOATING_POINT}, {@link
@@ -178,7 +178,7 @@
new int[] {BaselineTIFFTagSet.SAMPLE_FORMAT_UNSIGNED_INTEGER};
/**
- * The value of the <code>ExtraSamples</code> tag. Legal values
+ * The value of the {@code ExtraSamples} tag. Legal values
* are {@link BaselineTIFFTagSet#EXTRA_SAMPLES_UNSPECIFIED},
* {@link BaselineTIFFTagSet#EXTRA_SAMPLES_ASSOCIATED_ALPHA},
* {@link BaselineTIFFTagSet#EXTRA_SAMPLES_UNASSOCIATED_ALPHA},
@@ -187,7 +187,7 @@
protected int[] extraSamples;
/**
- * The value of the <code>ColorMap</code> tag.
+ * The value of the {@code ColorMap} tag.
*
*/
protected char[] colorMap;
@@ -195,20 +195,20 @@
// Region of input stream containing the data
/**
- * The <code>ImageInputStream</code> containing the TIFF source
+ * The {@code ImageInputStream} containing the TIFF source
* data.
*/
protected ImageInputStream stream;
/**
- * The offset in the source <code>ImageInputStream</code> of the
+ * The offset in the source {@code ImageInputStream} of the
* start of the data to be decompressed.
*/
protected long offset;
/**
* The number of bytes of data from the source
- * <code>ImageInputStream</code> to be decompressed.
+ * {@code ImageInputStream} to be decompressed.
*/
protected int byteCount;
@@ -244,15 +244,15 @@
// Subsampling to be performed
/**
- * The source X offset used, along with <code>dstXOffset</code>
- * and <code>subsampleX</code>, to map between horizontal source
+ * The source X offset used, along with {@code dstXOffset}
+ * and {@code subsampleX}, to map between horizontal source
* and destination pixel coordinates.
*/
protected int sourceXOffset;
/**
* The horizontal destination offset used, along with
- * <code>sourceXOffset</code> and <code>subsampleX</code>, to map
+ * {@code sourceXOffset} and {@code subsampleX}, to map
* between horizontal source and destination pixel coordinates.
* See the comment for {@link #sourceXOffset sourceXOffset} for
* the mapping equations.
@@ -260,15 +260,15 @@
protected int dstXOffset;
/**
- * The source Y offset used, along with <code>dstYOffset</code>
- * and <code>subsampleY</code>, to map between vertical source and
+ * The source Y offset used, along with {@code dstYOffset}
+ * and {@code subsampleY}, to map between vertical source and
* destination pixel coordinates.
*/
protected int sourceYOffset;
/**
* The vertical destination offset used, along with
- * <code>sourceYOffset</code> and <code>subsampleY</code>, to map
+ * {@code sourceYOffset} and {@code subsampleY}, to map
* between horizontal source and destination pixel coordinates.
* See the comment for {@link #sourceYOffset sourceYOffset} for
* the mapping equations.
@@ -305,7 +305,7 @@
// Destination for decodeRaw
/**
- * A <code>BufferedImage</code> for the <code>decodeRaw</code>
+ * A {@code BufferedImage} for the {@code decodeRaw}
* method to write into.
*/
protected BufferedImage rawImage;
@@ -345,15 +345,15 @@
* The X coordinate of the upper-left source pixel that will
* actually be copied into the destination image, taking into
* account all subsampling, offsetting, and clipping. That is,
- * the pixel at (<code>activeSrcMinX</code>,
- * <code>activeSrcMinY</code>) is to be copied into the
- * destination pixel at (<code>dstMinX</code>,
- * <code>dstMinY</code>).
+ * the pixel at ({@code activeSrcMinX},
+ * {@code activeSrcMinY}) is to be copied into the
+ * destination pixel at ({@code dstMinX},
+ * {@code dstMinY}).
*
* <p> The pixels in the source region to be copied are
- * those with X coordinates of the form <code>activeSrcMinX +
- * k*subsampleX</code>, where <code>k</code> is an integer such
- * that <code>0 ≤ k < dstWidth</code>.
+ * those with X coordinates of the form {@code activeSrcMinX +
+ * k*subsampleX}, where {@code k} is an integer such
+ * that {@code 0 ≤ k < dstWidth}.
*/
protected int activeSrcMinX;
@@ -363,9 +363,9 @@
* all subsampling, offsetting, and clipping.
*
* <p> The pixels in the source region to be copied are
- * those with Y coordinates of the form <code>activeSrcMinY +
- * k*subsampleY</code>, where <code>k</code> is an integer such
- * that <code>0 ≤ k < dstHeight</code>.
+ * those with Y coordinates of the form {@code activeSrcMinY +
+ * k*subsampleY}, where {@code k} is an integer such
+ * that {@code 0 ≤ k < dstHeight}.
*/
protected int activeSrcMinY;
@@ -375,7 +375,7 @@
* susbampling, offsetting, and clipping.
*
* <p> The active source width will always be equal to
- * <code>(dstWidth - 1)*subsampleX + 1</code>.
+ * {@code (dstWidth - 1)*subsampleX + 1}.
*/
protected int activeSrcWidth;
@@ -385,13 +385,13 @@
* susbampling, offsetting, and clipping.
*
* <p> The active source height will always be equal to
- * <code>(dstHeight - 1)*subsampleY + 1</code>.
+ * {@code (dstHeight - 1)*subsampleY + 1}.
*/
protected int activeSrcHeight;
/**
- * A <code>TIFFColorConverter</code> object describing the color space of
- * the encoded pixel data, or <code>null</code>.
+ * A {@code TIFFColorConverter} object describing the color space of
+ * the encoded pixel data, or {@code null}.
*/
protected TIFFColorConverter colorConverter;
@@ -420,13 +420,13 @@
// to exactly those dest pixels that are present in the source region.
/**
- * Create a <code>PixelInterleavedSampleModel</code> for use in creating
- * an <code>ImageTypeSpecifier</code>. Its dimensions will be 1x1 and
+ * Create a {@code PixelInterleavedSampleModel} for use in creating
+ * an {@code ImageTypeSpecifier}. Its dimensions will be 1x1 and
* it will have ascending band offsets as {0, 1, 2, ..., numBands}.
*
* @param dataType The data type (DataBuffer.TYPE_*).
* @param numBands The number of bands.
- * @return A <code>PixelInterleavedSampleModel</code>.
+ * @return A {@code PixelInterleavedSampleModel}.
*/
static SampleModel createInterleavedSM(int dataType,
int numBands) {
@@ -443,8 +443,8 @@
}
/**
- * Create a <code>ComponentColorModel</code> for use in creating
- * an <code>ImageTypeSpecifier</code>.
+ * Create a {@code ComponentColorModel} for use in creating
+ * an {@code ImageTypeSpecifier}.
*/
// This code was copied from javax.imageio.ImageTypeSpecifier.
static ColorModel createComponentCM(ColorSpace colorSpace,
@@ -518,8 +518,8 @@
}
/**
- * Return the number of bits occupied by <code>dataType</code>
- * which must be one of the <code>DataBuffer</code> <code>TYPE</code>s.
+ * Return the number of bits occupied by {@code dataType}
+ * which must be one of the {@code DataBuffer} {@code TYPE}s.
*/
private static int getDataTypeSize(int dataType) throws IIOException {
int dataTypeSize = 0;
@@ -578,7 +578,7 @@
}
/**
- * Determines whether the <code>DataBuffer</code> is filled without
+ * Determines whether the {@code DataBuffer} is filled without
* any interspersed padding bits.
*/
private static boolean isDataBufferBitContiguous(SampleModel sm)
@@ -678,8 +678,8 @@
}
/**
- * Reformats bit-discontiguous data into the <code>DataBuffer</code>
- * of the supplied <code>WritableRaster</code>.
+ * Reformats bit-discontiguous data into the {@code DataBuffer}
+ * of the supplied {@code WritableRaster}.
*/
private static void reformatDiscontiguousData(byte[] buf,
int stride,
@@ -715,21 +715,21 @@
/**
* A utility method that returns an
- * <code>ImageTypeSpecifier</code> suitable for decoding an image
+ * {@code ImageTypeSpecifier} suitable for decoding an image
* with the given parameters.
*
* @param photometricInterpretation the value of the
- * <code>PhotometricInterpretation</code> field.
- * @param compression the value of the <code>Compression</code> field.
+ * {@code PhotometricInterpretation} field.
+ * @param compression the value of the {@code Compression} field.
* @param samplesPerPixel the value of the
- * <code>SamplesPerPixel</code> field.
- * @param bitsPerSample the value of the <code>BitsPerSample</code> field.
- * @param sampleFormat the value of the <code>SampleFormat</code> field.
- * @param extraSamples the value of the <code>ExtraSamples</code> field.
- * @param colorMap the value of the <code>ColorMap</code> field.
+ * {@code SamplesPerPixel} field.
+ * @param bitsPerSample the value of the {@code BitsPerSample} field.
+ * @param sampleFormat the value of the {@code SampleFormat} field.
+ * @param extraSamples the value of the {@code ExtraSamples} field.
+ * @param colorMap the value of the {@code ColorMap} field.
*
- * @return a suitable <code>ImageTypeSpecifier</code>, or
- * <code>null</code> if it is not possible to create one.
+ * @return a suitable {@code ImageTypeSpecifier}, or
+ * {@code null} if it is not possible to create one.
*/
public static ImageTypeSpecifier
getRawImageTypeSpecifier(int photometricInterpretation,
@@ -1216,26 +1216,26 @@
}
/**
- * Sets the value of the <code>reader</code> field.
+ * Sets the value of the {@code reader} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param reader the current <code>ImageReader</code>.
+ * @param reader the current {@code ImageReader}.
*/
public void setReader(ImageReader reader) {
this.reader = reader;
}
/**
- * Sets the value of the <code>metadata</code> field.
+ * Sets the value of the {@code metadata} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param metadata the <code>IIOMetadata</code> object for the
+ * @param metadata the {@code IIOMetadata} object for the
* image being read.
*/
public void setMetadata(IIOMetadata metadata) {
@@ -1243,10 +1243,10 @@
}
/**
- * Sets the value of the <code>photometricInterpretation</code>
+ * Sets the value of the {@code photometricInterpretation}
* field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1258,9 +1258,9 @@
}
/**
- * Sets the value of the <code>compression</code> field.
+ * Sets the value of the {@code compression} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1271,13 +1271,13 @@
}
/**
- * Sets the value of the <code>planar</code> field.
+ * Sets the value of the {@code planar} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param planar <code>true</code> if the image to be decoded is
+ * @param planar {@code true} if the image to be decoded is
* stored in planar format.
*/
public void setPlanar(boolean planar) {
@@ -1285,9 +1285,9 @@
}
/**
- * Sets the value of the <code>samplesPerPixel</code> field.
+ * Sets the value of the {@code samplesPerPixel} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1299,9 +1299,9 @@
}
/**
- * Sets the value of the <code>bitsPerSample</code> field.
+ * Sets the value of the {@code bitsPerSample} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1314,9 +1314,9 @@
}
/**
- * Sets the value of the <code>sampleFormat</code> field.
+ * Sets the value of the {@code sampleFormat} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1330,9 +1330,9 @@
}
/**
- * Sets the value of the <code>extraSamples</code> field.
+ * Sets the value of the {@code extraSamples} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1346,14 +1346,14 @@
}
/**
- * Sets the value of the <code>colorMap</code> field.
+ * Sets the value of the {@code colorMap} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
* @param colorMap the color map to apply to the source data,
- * as an array of <code>char</code>s.
+ * as an array of {@code char}s.
*/
public void setColorMap(char[] colorMap) {
this.colorMap = colorMap == null ?
@@ -1361,22 +1361,22 @@
}
/**
- * Sets the value of the <code>stream</code> field.
+ * Sets the value of the {@code stream} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param stream the <code>ImageInputStream</code> to be read.
+ * @param stream the {@code ImageInputStream} to be read.
*/
public void setStream(ImageInputStream stream) {
this.stream = stream;
}
/**
- * Sets the value of the <code>offset</code> field.
+ * Sets the value of the {@code offset} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1388,9 +1388,9 @@
}
/**
- * Sets the value of the <code>byteCount</code> field.
+ * Sets the value of the {@code byteCount} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1403,9 +1403,9 @@
// Region of the file image represented in the stream
/**
- * Sets the value of the <code>srcMinX</code> field.
+ * Sets the value of the {@code srcMinX} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1418,9 +1418,9 @@
}
/**
- * Sets the value of the <code>srcMinY</code> field.
+ * Sets the value of the {@code srcMinY} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1433,9 +1433,9 @@
}
/**
- * Sets the value of the <code>srcWidth</code> field.
+ * Sets the value of the {@code srcWidth} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1447,9 +1447,9 @@
}
/**
- * Sets the value of the <code>srcHeight</code> field.
+ * Sets the value of the {@code srcHeight} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1463,9 +1463,9 @@
// First source pixel to be read
/**
- * Sets the value of the <code>sourceXOffset</code> field.
+ * Sets the value of the {@code sourceXOffset} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1477,9 +1477,9 @@
}
/**
- * Sets the value of the <code>dstXOffset</code> field.
+ * Sets the value of the {@code dstXOffset} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1491,9 +1491,9 @@
}
/**
- * Sets the value of the <code>sourceYOffset</code>.
+ * Sets the value of the {@code sourceYOffset}.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1505,9 +1505,9 @@
}
/**
- * Sets the value of the <code>dstYOffset</code> field.
+ * Sets the value of the {@code dstYOffset} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1521,15 +1521,15 @@
// Subsampling to be performed
/**
- * Sets the value of the <code>subsampleX</code> field.
+ * Sets the value of the {@code subsampleX} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
* @param subsampleX the horizontal subsampling factor.
*
- * @throws IllegalArgumentException if <code>subsampleX</code> is
+ * @throws IllegalArgumentException if {@code subsampleX} is
* less than or equal to 0.
*/
public void setSubsampleX(int subsampleX) {
@@ -1540,15 +1540,15 @@
}
/**
- * Sets the value of the <code>subsampleY</code> field.
+ * Sets the value of the {@code subsampleY} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
* @param subsampleY the vertical subsampling factor.
*
- * @throws IllegalArgumentException if <code>subsampleY</code> is
+ * @throws IllegalArgumentException if {@code subsampleY} is
* less than or equal to 0.
*/
public void setSubsampleY(int subsampleY) {
@@ -1561,13 +1561,13 @@
// Band subsetting/rearrangement
/**
- * Sets the value of the <code>sourceBands</code> field.
+ * Sets the value of the {@code sourceBands} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param sourceBands an array of <code>int</code>s
+ * @param sourceBands an array of {@code int}s
* specifying the source bands to be read.
*/
public void setSourceBands(int[] sourceBands) {
@@ -1576,13 +1576,13 @@
}
/**
- * Sets the value of the <code>destinationBands</code> field.
+ * Sets the value of the {@code destinationBands} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param destinationBands an array of <code>int</code>s
+ * @param destinationBands an array of {@code int}s
* specifying the destination bands to be written.
*/
public void setDestinationBands(int[] destinationBands) {
@@ -1593,22 +1593,22 @@
// Destination image and region
/**
- * Sets the value of the <code>image</code> field.
+ * Sets the value of the {@code image} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
- * @param image the destination <code>BufferedImage</code>.
+ * @param image the destination {@code BufferedImage}.
*/
public void setImage(BufferedImage image) {
this.image = image;
}
/**
- * Sets the value of the <code>dstMinX</code> field.
+ * Sets the value of the {@code dstMinX} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1620,9 +1620,9 @@
}
/**
- * Sets the value of the <code>dstMinY</code> field.
+ * Sets the value of the {@code dstMinY} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1634,9 +1634,9 @@
}
/**
- * Sets the value of the <code>dstWidth</code> field.
+ * Sets the value of the {@code dstWidth} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1647,9 +1647,9 @@
}
/**
- * Sets the value of the <code>dstHeight</code> field.
+ * Sets the value of the {@code dstHeight} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1662,9 +1662,9 @@
// Active source region
/**
- * Sets the value of the <code>activeSrcMinX</code> field.
+ * Sets the value of the {@code activeSrcMinX} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1676,9 +1676,9 @@
}
/**
- * Sets the value of the <code>activeSrcMinY</code> field.
+ * Sets the value of the {@code activeSrcMinY} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1690,9 +1690,9 @@
}
/**
- * Sets the value of the <code>activeSrcWidth</code> field.
+ * Sets the value of the {@code activeSrcWidth} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1703,9 +1703,9 @@
}
/**
- * Sets the value of the <code>activeSrcHeight</code> field.
+ * Sets the value of the {@code activeSrcHeight} field.
*
- * <p> If this method is called, the <code>beginDecoding</code>
+ * <p> If this method is called, the {@code beginDecoding}
* method must be called prior to calling any of the decode
* methods.
*
@@ -1716,23 +1716,23 @@
}
/**
- * Sets the <code>TIFFColorConverter</code> object describing the color
+ * Sets the {@code TIFFColorConverter} object describing the color
* space of the encoded data in the input stream. If no
- * <code>TIFFColorConverter</code> is set, no conversion will be performed.
+ * {@code TIFFColorConverter} is set, no conversion will be performed.
*
- * @param colorConverter a <code>TIFFColorConverter</code> object, or
- * <code>null</code>.
+ * @param colorConverter a {@code TIFFColorConverter} object, or
+ * {@code null}.
*/
public void setColorConverter(TIFFColorConverter colorConverter) {
this.colorConverter = colorConverter;
}
/**
- * Returns an <code>ImageTypeSpecifier</code> describing an image
+ * Returns an {@code ImageTypeSpecifier} describing an image
* whose underlying data array has the same format as the raw
* source pixel data.
*
- * @return an <code>ImageTypeSpecifier</code>.
+ * @return an {@code ImageTypeSpecifier}.
*/
public ImageTypeSpecifier getRawImageType() {
ImageTypeSpecifier its =
@@ -1747,18 +1747,18 @@
}
/**
- * Creates a <code>BufferedImage</code> whose underlying data
+ * Creates a {@code BufferedImage} whose underlying data
* array will be suitable for holding the raw decoded output of
- * the <code>decodeRaw</code> method.
+ * the {@code decodeRaw} method.
*
* <p> The default implementation calls
- * <code>getRawImageType</code>, and calls the resulting
- * <code>ImageTypeSpecifier</code>'s
- * <code>createBufferedImage</code> method.
+ * {@code getRawImageType}, and calls the resulting
+ * {@code ImageTypeSpecifier}'s
+ * {@code createBufferedImage} method.
*
- * @return a <code>BufferedImage</code> whose underlying data
+ * @return a {@code BufferedImage} whose underlying data
* array has the same format as the raw source pixel data, or
- * <code>null</code> if it is not possible to create such an
+ * {@code null} if it is not possible to create such an
* image.
*/
public BufferedImage createRawImage() {
@@ -1811,22 +1811,22 @@
}
/**
- * Decodes the source data into the provided <code>byte</code>
- * array <code>b</code>, starting at the offset given by
- * <code>dstOffset</code>. Each pixel occupies
- * <code>bitsPerPixel</code> bits, with no padding between pixels.
- * Scanlines are separated by <code>scanlineStride</code>
- * <code>byte</code>s.
+ * Decodes the source data into the provided {@code byte}
+ * array {@code b}, starting at the offset given by
+ * {@code dstOffset}. Each pixel occupies
+ * {@code bitsPerPixel} bits, with no padding between pixels.
+ * Scanlines are separated by {@code scanlineStride}
+ * {@code byte}s.
*
- * @param b a <code>byte</code> array to be written.
- * @param dstOffset the starting offset in <code>b</code> to be
+ * @param b a {@code byte} array to be written.
+ * @param dstOffset the starting offset in {@code b} to be
* written.
* @param bitsPerPixel the number of bits for each pixel.
- * @param scanlineStride the number of <code>byte</code>s to
+ * @param scanlineStride the number of {@code byte}s to
* advance between that starting pixels of each scanline.
*
* @throws IOException if an error occurs reading from the source
- * <code>ImageInputStream</code>.
+ * {@code ImageInputStream}.
*/
public abstract void decodeRaw(byte[] b,
int dstOffset,
@@ -1834,25 +1834,25 @@
int scanlineStride) throws IOException;
/**
- * Decodes the source data into the provided <code>short</code>
- * array <code>s</code>, starting at the offset given by
- * <code>dstOffset</code>. Each pixel occupies
- * <code>bitsPerPixel</code> bits, with no padding between pixels.
- * Scanlines are separated by <code>scanlineStride</code>
- * <code>short</code>s
+ * Decodes the source data into the provided {@code short}
+ * array {@code s}, starting at the offset given by
+ * {@code dstOffset}. Each pixel occupies
+ * {@code bitsPerPixel} bits, with no padding between pixels.
+ * Scanlines are separated by {@code scanlineStride}
+ * {@code short}s
*
- * <p> The default implementation calls <code>decodeRaw(byte[] b,
- * ...)</code> and copies the resulting data into <code>s</code>.
+ * <p> The default implementation calls {@code decodeRaw(byte[] b,
+ * ...)} and copies the resulting data into {@code s}.
*
- * @param s a <code>short</code> array to be written.
- * @param dstOffset the starting offset in <code>s</code> to be
+ * @param s a {@code short} array to be written.
+ * @param dstOffset the starting offset in {@code s} to be
* written.
* @param bitsPerPixel the number of bits for each pixel.
- * @param scanlineStride the number of <code>short</code>s to
+ * @param scanlineStride the number of {@code short}s to
* advance between that starting pixels of each scanline.
*
* @throws IOException if an error occurs reading from the source
- * <code>ImageInputStream</code>.
+ * {@code ImageInputStream}.
*/
public void decodeRaw(short[] s,
int dstOffset,
@@ -1891,25 +1891,25 @@
}
/**
- * Decodes the source data into the provided <code>int</code>
- * array <code>i</code>, starting at the offset given by
- * <code>dstOffset</code>. Each pixel occupies
- * <code>bitsPerPixel</code> bits, with no padding between pixels.
- * Scanlines are separated by <code>scanlineStride</code>
- * <code>int</code>s.
+ * Decodes the source data into the provided {@code int}
+ * array {@code i}, starting at the offset given by
+ * {@code dstOffset}. Each pixel occupies
+ * {@code bitsPerPixel} bits, with no padding between pixels.
+ * Scanlines are separated by {@code scanlineStride}
+ * {@code int}s.
*
- * <p> The default implementation calls <code>decodeRaw(byte[] b,
- * ...)</code> and copies the resulting data into <code>i</code>.
+ * <p> The default implementation calls {@code decodeRaw(byte[] b,
+ * ...)} and copies the resulting data into {@code i}.
*
- * @param i an <code>int</code> array to be written.
- * @param dstOffset the starting offset in <code>i</code> to be
+ * @param i an {@code int} array to be written.
+ * @param dstOffset the starting offset in {@code i} to be
* written.
* @param bitsPerPixel the number of bits for each pixel.
- * @param scanlineStride the number of <code>int</code>s to
+ * @param scanlineStride the number of {@code int}s to
* advance between that starting pixels of each scanline.
*
* @throws IOException if an error occurs reading from the source
- * <code>ImageInputStream</code>.
+ * {@code ImageInputStream}.
*/
public void decodeRaw(int[] i,
int dstOffset,
@@ -1953,25 +1953,25 @@
}
/**
- * Decodes the source data into the provided <code>float</code>
- * array <code>f</code>, starting at the offset given by
- * <code>dstOffset</code>. Each pixel occupies
- * <code>bitsPerPixel</code> bits, with no padding between pixels.
- * Scanlines are separated by <code>scanlineStride</code>
- * <code>float</code>s.
+ * Decodes the source data into the provided {@code float}
+ * array {@code f}, starting at the offset given by
+ * {@code dstOffset}. Each pixel occupies
+ * {@code bitsPerPixel} bits, with no padding between pixels.
+ * Scanlines are separated by {@code scanlineStride}
+ * {@code float}s.
*
- * <p> The default implementation calls <code>decodeRaw(byte[] b,
- * ...)</code> and copies the resulting data into <code>f</code>.
+ * <p> The default implementation calls {@code decodeRaw(byte[] b,
+ * ...)} and copies the resulting data into {@code f}.
*
- * @param f a <code>float</code> array to be written.
- * @param dstOffset the starting offset in <code>f</code> to be
+ * @param f a {@code float} array to be written.
+ * @param dstOffset the starting offset in {@code f} to be
* written.
* @param bitsPerPixel the number of bits for each pixel.
- * @param scanlineStride the number of <code>float</code>s to
+ * @param scanlineStride the number of {@code float}s to
* advance between that starting pixels of each scanline.
*
* @throws IOException if an error occurs reading from the source
- * <code>ImageInputStream</code>.
+ * {@code ImageInputStream}.
*/
public void decodeRaw(float[] f,
int dstOffset,
@@ -2017,25 +2017,25 @@
}
/**
- * Decodes the source data into the provided <code>double</code>
- * array <code>f</code>, starting at the offset given by
- * <code>dstOffset</code>. Each pixel occupies
- * <code>bitsPerPixel</code> bits, with no padding between pixels.
- * Scanlines are separated by <code>scanlineStride</code>
- * <code>double</code>s.
+ * Decodes the source data into the provided {@code double}
+ * array {@code f}, starting at the offset given by
+ * {@code dstOffset}. Each pixel occupies
+ * {@code bitsPerPixel} bits, with no padding between pixels.
+ * Scanlines are separated by {@code scanlineStride}
+ * {@code double}s.
*
- * <p> The default implementation calls <code>decodeRaw(byte[] b,
- * ...)</code> and copies the resulting data into <code>f</code>.
+ * <p> The default implementation calls {@code decodeRaw(byte[] b,
+ * ...)} and copies the resulting data into {@code f}.
*
- * @param f a <code>double</code> array to be written.
- * @param dstOffset the starting offset in <code>f</code> to be
+ * @param f a {@code double} array to be written.
+ * @param dstOffset the starting offset in {@code f} to be
* written.
* @param bitsPerPixel the number of bits for each pixel.
- * @param scanlineStride the number of <code>double</code>s to
+ * @param scanlineStride the number of {@code double}s to
* advance between that starting pixels of each scanline.
*
* @throws IOException if an error occurs reading from the source
- * <code>ImageInputStream</code>.
+ * {@code ImageInputStream}.
*/
public void decodeRaw(double[] d,
int dstOffset,
@@ -2104,16 +2104,16 @@
/**
* This routine is called prior to a sequence of calls to the
- * <code>decode</code> method, in order to allow any necessary
+ * {@code decode} method, in order to allow any necessary
* tables or other structures to be initialized based on metadata
* values. This routine is guaranteed to be called any time the
* metadata values have changed.
*
* <p> The default implementation computes tables used by the
- * <code>decode</code> method to rescale components to different
+ * {@code decode} method to rescale components to different
* bit depths. Thus, if this method is overridden, it is
- * important for the subclass method to call <code>super()</code>,
- * unless it overrides <code>decode</code> as well.
+ * important for the subclass method to call {@code super()},
+ * unless it overrides {@code decode} as well.
*/
public void beginDecoding() {
// Note: This method assumes that sourceBands, destinationBands,
@@ -2242,35 +2242,35 @@
/**
* Decodes the input bit stream (located in the
- * <code>ImageInputStream</code> <code>stream</code>, at offset
- * <code>offset</code>, and continuing for <code>byteCount</code>
- * bytes) into the output <code>BufferedImage</code>
- * <code>image</code>.
+ * {@code ImageInputStream} {@code stream}, at offset
+ * {@code offset}, and continuing for {@code byteCount}
+ * bytes) into the output {@code BufferedImage}
+ * {@code image}.
*
* <p> The default implementation analyzes the destination image
* to determine if it is suitable as the destination for the
- * <code>decodeRaw</code> method. If not, a suitable image is
- * created. Next, <code>decodeRaw</code> is called to perform the
+ * {@code decodeRaw} method. If not, a suitable image is
+ * created. Next, {@code decodeRaw} is called to perform the
* actual decoding, and the results are copied into the
* destination image if necessary. Subsampling and offsetting are
* performed automatically.
*
* <p> The precise responsibilities of this routine are as
* follows. The input bit stream is defined by the instance
- * variables <code>stream</code>, <code>offset</code>, and
- * <code>byteCount</code>. These bits contain the data for the
- * region of the source image defined by <code>srcMinX</code>,
- * <code>srcMinY</code>, <code>srcWidth</code>, and
- * <code>srcHeight</code>.
+ * variables {@code stream}, {@code offset}, and
+ * {@code byteCount}. These bits contain the data for the
+ * region of the source image defined by {@code srcMinX},
+ * {@code srcMinY}, {@code srcWidth}, and
+ * {@code srcHeight}.
*
* <p> The source data is required to be subsampling, starting at
- * the <code>sourceXOffset</code>th column and including
- * every <code>subsampleX</code>th pixel thereafter (and similarly
- * for <code>sourceYOffset</code> and
- * <code>subsampleY</code>).
+ * the {@code sourceXOffset}th column and including
+ * every {@code subsampleX}th pixel thereafter (and similarly
+ * for {@code sourceYOffset} and
+ * {@code subsampleY}).
*
* <p> Pixels are copied into the destination with an addition shift of
- * (<code>dstXOffset</code>, <code>dstYOffset</code>). The complete
+ * ({@code dstXOffset}, {@code dstYOffset}). The complete
* set of formulas relating the source and destination coordinate spaces
* are:
*
@@ -2279,9 +2279,9 @@
* dy = (sy - sourceYOffset)/subsampleY + dstYOffset;
* </pre>
*
- * Only source pixels such that <code>(sx - sourceXOffset) %
- * subsampleX == 0</code> and <code>(sy - sourceYOffset) %
- * subsampleY == 0</code> are copied.
+ * Only source pixels such that {@code (sx - sourceXOffset) %
+ * subsampleX == 0} and {@code (sy - sourceYOffset) %
+ * subsampleY == 0} are copied.
*
* <p> The inverse mapping, from destination to source coordinates,
* is one-to-one:
@@ -2292,9 +2292,9 @@
* </pre>
*
* <p> The region of the destination image to be updated is given
- * by the instance variables <code>dstMinX</code>,
- * <code>dstMinY</code>, <code>dstWidth</code>, and
- * <code>dstHeight</code>.
+ * by the instance variables {@code dstMinX},
+ * {@code dstMinY}, {@code dstWidth}, and
+ * {@code dstHeight}.
*
* <p> It is possible that not all of the source data being read
* will contribute to the destination image. For example, the
@@ -2303,32 +2303,32 @@
* convenience, the bounds of the active source region (that is,
* the region of the strip or tile being read that actually
* contributes to the destination image, taking clipping into
- * account) are available as <code>activeSrcMinX</code>,
- * <code>activeSrcMinY</code>, <code>activeSrcWidth</code> and
- * <code>activeSrcHeight</code>. Thus, the source pixel at
- * (<code>activeSrcMinX</code>, <code>activeSrcMinY</code>) will
- * map to the destination pixel (<code>dstMinX</code>,
- * <code>dstMinY</code>).
+ * account) are available as {@code activeSrcMinX},
+ * {@code activeSrcMinY}, {@code activeSrcWidth} and
+ * {@code activeSrcHeight}. Thus, the source pixel at
+ * ({@code activeSrcMinX}, {@code activeSrcMinY}) will
+ * map to the destination pixel ({@code dstMinX},
+ * {@code dstMinY}).
*
* <p> The sequence of source bands given by
- * <code>sourceBands</code> are to be copied into the sequence of
+ * {@code sourceBands} are to be copied into the sequence of
* bands in the destination given by
- * <code>destinationBands</code>.
+ * {@code destinationBands}.
*
* <p> Some standard tag information is provided the instance
- * variables <code>photometricInterpretation</code>,
- * <code>compression</code>, <code>samplesPerPixel</code>,
- * <code>bitsPerSample</code>, <code>sampleFormat</code>,
- * <code>extraSamples</code>, and <code>colorMap</code>.
+ * variables {@code photometricInterpretation},
+ * {@code compression}, {@code samplesPerPixel},
+ * {@code bitsPerSample}, {@code sampleFormat},
+ * {@code extraSamples}, and {@code colorMap}.
*
* <p> In practice, unless there is a significant performance
* advantage to be gained by overriding this routine, most users
* will prefer to use the default implementation of this routine,
- * and instead override the <code>decodeRaw</code> and/or
- * <code>getRawImageType</code> methods.
+ * and instead override the {@code decodeRaw} and/or
+ * {@code getRawImageType} methods.
*
* @exception IOException if an error occurs in
- * <code>decodeRaw</code>.
+ * {@code decodeRaw}.
*/
public void decode() throws IOException {
byte[] byteData = null;
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFExifJPEGCompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFExifJPEGCompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -29,7 +29,7 @@
import javax.imageio.plugins.tiff.BaselineTIFFTagSet;
/**
- * A <code>TIFFCompressor</code> for the JPEG variant of Exif.
+ * A {@code TIFFCompressor} for the JPEG variant of Exif.
*/
public class TIFFExifJPEGCompressor extends TIFFBaseJPEGCompressor {
public TIFFExifJPEGCompressor(ImageWriteParam param) {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFFaxCompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFFaxCompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -232,12 +232,12 @@
}
/**
- * Sets the value of the <code>metadata</code> field.
+ * Sets the value of the {@code metadata} field.
*
* <p> The implementation in this class also sets local options
* from the FILL_ORDER field if it exists.</p>
*
- * @param metadata the <code>IIOMetadata</code> object for the
+ * @param metadata the {@code IIOMetadata} object for the
* image being written.
*
* @see #getMetadata()
@@ -253,8 +253,8 @@
}
/**
- * Return min of <code>maxOffset</code> or offset of first pixel
- * different from pixel at <code>bitOffset</code>.
+ * Return min of {@code maxOffset} or offset of first pixel
+ * different from pixel at {@code bitOffset}.
*/
public int nextState(byte[] data,
int base,
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFFieldNode.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFFieldNode.java Thu Feb 11 13:42:53 2016 -0800
@@ -34,7 +34,7 @@
import javax.imageio.plugins.tiff.TIFFTagSet;
/**
- * The <code>Node</code> representation of a <code>TIFFField</code>
+ * The {@code Node} representation of a {@code TIFFField}
* wherein the child node is procedural rather than buffered.
*/
public class TIFFFieldNode extends IIOMetadataNode {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFIFD.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFIFD.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -153,7 +153,7 @@
}
/**
- * Returns an <code>Iterator</code> over the TIFF fields. The
+ * Returns an {@code Iterator} over the TIFF fields. The
* traversal is in the order of increasing tag number.
*/
// Note: the sort is guaranteed for low fields by the use of an
@@ -164,7 +164,7 @@
}
/**
- * Read the value of a field. The <code>data</code> parameter should be
+ * Read the value of a field. The {@code data} parameter should be
* an array of length 1 of Object.
*
* @param stream the input stream
@@ -762,8 +762,8 @@
}
/**
- * Returns a <code>TIFFIFD</code> wherein all fields from the
- * <code>BaselineTIFFTagSet</code> are copied by value and all other
+ * Returns a {@code TIFFIFD} wherein all fields from the
+ * {@code BaselineTIFFTagSet} are copied by value and all other
* fields copied by reference.
*/
public TIFFIFD getShallowClone() {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageMetadata.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageMetadata.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -1620,8 +1620,8 @@
}
/**
- * Returns a <code>TIFFImageMetadata</code> wherein all fields in the
- * root IFD from the <code>BaselineTIFFTagSet</code> are copied by value
+ * Returns a {@code TIFFImageMetadata} wherein all fields in the
+ * root IFD from the {@code BaselineTIFFTagSet} are copied by value
* and all other fields copied by reference.
*/
public TIFFImageMetadata getShallowClone() {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageReader.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageReader.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -83,7 +83,7 @@
// Metadata for image at 'currIndex', or null.
private TIFFImageMetadata imageMetadata = null;
- // A <code>List</code> of <code>Long</code>s indicating the stream
+ // A {@code List} of {@code Long}s indicating the stream
// positions of the start of the IFD for each image. Entries
// are added as needed.
private List<Long> imageStartPosition = new ArrayList<Long>();
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageWriteParam.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageWriteParam.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -122,11 +122,11 @@
* quality value is passed directly to the JPEG writer plug-in which
* interprets it in the usual way.</p>
*
- * <p> The <code>canWriteTiles</code> and
- * <code>canWriteCompressed</code> methods will return
- * <code>true</code>; the <code>canOffsetTiles</code> and
- * <code>canWriteProgressive</code> methods will return
- * <code>false</code>.</p>
+ * <p> The {@code canWriteTiles} and
+ * {@code canWriteCompressed} methods will return
+ * {@code true}; the {@code canOffsetTiles} and
+ * {@code canWriteProgressive} methods will return
+ * {@code false}.</p>
*
* <p> If tiles are being written, then each of their dimensions will be
* rounded to the nearest multiple of 16 per the TIFF specification. If
@@ -140,10 +140,10 @@
public class TIFFImageWriteParam extends ImageWriteParam {
/**
- * Constructs a <code>TIFFImageWriteParam</code> instance
- * for a given <code>Locale</code>.
+ * Constructs a {@code TIFFImageWriteParam} instance
+ * for a given {@code Locale}.
*
- * @param locale the <code>Locale</code> for which messages
+ * @param locale the {@code Locale} for which messages
* should be localized.
*/
public TIFFImageWriteParam(Locale locale) {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageWriter.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFImageWriter.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -221,11 +221,11 @@
* relative to a given tile grid layout specified by its X offset
* and tile width.
*
- * <p> If <code>tileWidth < 0</code>, the results of this method
- * are undefined. If <code>tileWidth == 0</code>, an
- * <code>ArithmeticException</code> will be thrown.
+ * <p> If {@code tileWidth < 0}, the results of this method
+ * are undefined. If {@code tileWidth == 0}, an
+ * {@code ArithmeticException} will be thrown.
*
- * @throws ArithmeticException If <code>tileWidth == 0</code>.
+ * @throws ArithmeticException If {@code tileWidth == 0}.
*/
public static int XToTileX(int x, int tileGridXOffset, int tileWidth) {
x -= tileGridXOffset;
@@ -240,11 +240,11 @@
* relative to a given tile grid layout specified by its Y offset
* and tile height.
*
- * <p> If <code>tileHeight < 0</code>, the results of this method
- * are undefined. If <code>tileHeight == 0</code>, an
- * <code>ArithmeticException</code> will be thrown.
+ * <p> If {@code tileHeight < 0}, the results of this method
+ * are undefined. If {@code tileHeight == 0}, an
+ * {@code ArithmeticException} will be thrown.
*
- * @throws ArithmeticException If <code>tileHeight == 0</code>.
+ * @throws ArithmeticException If {@code tileHeight == 0}.
*/
public static int YToTileY(int y, int tileGridYOffset, int tileHeight) {
y -= tileGridYOffset;
@@ -424,17 +424,17 @@
}
/**
- * Converts a standard <code>javax_imageio_1.0</code> tree to a
- * <code>TIFFImageMetadata</code> object.
+ * Converts a standard {@code javax_imageio_1.0} tree to a
+ * {@code TIFFImageMetadata} object.
*
* @param inData The metadata object.
- * @return a <code>TIFFImageMetadata</code> or <code>null</code> if
- * the standard tree derived from the input object is <code>null</code>.
- * @throws IllegalArgumentException if <code>inData</code> is
- * <code>null</code>.
- * @throws IllegalArgumentException if <code>inData</code> does not support
+ * @return a {@code TIFFImageMetadata} or {@code null} if
+ * the standard tree derived from the input object is {@code null}.
+ * @throws IllegalArgumentException if {@code inData} is
+ * {@code null}.
+ * @throws IllegalArgumentException if {@code inData} does not support
* the standard metadata format.
- * @throws IIOInvalidTreeException if <code>inData</code> generates an
+ * @throws IIOInvalidTreeException if {@code inData} generates an
* invalid standard metadata tree.
*/
private TIFFImageMetadata convertStandardImageMetadata(IIOMetadata inData)
@@ -463,15 +463,15 @@
/**
* Converts a native
- * <code>javax_imageio_tiff_image_1.0</code> tree to a
- * <code>TIFFImageMetadata</code> object.
+ * {@code javax_imageio_tiff_image_1.0} tree to a
+ * {@code TIFFImageMetadata} object.
*
* @param inData The metadata object.
- * @return a <code>TIFFImageMetadata</code> or <code>null</code> if
- * the native tree derived from the input object is <code>null</code>.
- * @throws IllegalArgumentException if <code>inData</code> is
- * <code>null</code> or does not support the native metadata format.
- * @throws IIOInvalidTreeException if <code>inData</code> generates an
+ * @return a {@code TIFFImageMetadata} or {@code null} if
+ * the native tree derived from the input object is {@code null}.
+ * @throws IllegalArgumentException if {@code inData} is
+ * {@code null} or does not support the native metadata format.
+ * @throws IIOInvalidTreeException if {@code inData} generates an
* invalid native metadata tree.
*/
private TIFFImageMetadata convertNativeImageMetadata(IIOMetadata inData)
@@ -504,8 +504,8 @@
* as needed. The destination image dimensions are provided as parameters
* because these might differ from those of the source due to subsampling.
*
- * @param cm The <code>ColorModel</code> of the image being written.
- * @param sm The <code>SampleModel</code> of the image being written.
+ * @param cm The {@code ColorModel} of the image being written.
+ * @param sm The {@code SampleModel} of the image being written.
* @param destWidth The width of the written image after subsampling.
* @param destHeight The height of the written image after subsampling.
*/
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFJPEGCompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFJPEGCompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -102,14 +102,14 @@
}
/**
- * Sets the value of the <code>metadata</code> field.
+ * Sets the value of the {@code metadata} field.
*
* <p>The implementation in this class also adds the TIFF fields
* JPEGTables, YCbCrSubSampling, YCbCrPositioning, and
* ReferenceBlackWhite superseding any prior settings of those
* fields.</p>
*
- * @param metadata the <code>IIOMetadata</code> object for the
+ * @param metadata the {@code IIOMetadata} object for the
* image being written.
*
* @see #getMetadata()
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFLZWDecompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFLZWDecompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -245,7 +245,7 @@
}
/**
- * Append <code>newString</code> to the end of <code>oldString</code>.
+ * Append {@code newString} to the end of {@code oldString}.
*/
public byte[] composeString(byte oldString[], byte newString) {
int length = oldString.length;
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFLZWUtil.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFLZWUtil.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -188,7 +188,7 @@
}
/**
- * Append <code>newString</code> to the end of <code>oldString</code>.
+ * Append {@code newString} to the end of {@code oldString}.
*/
public byte[] composeString(byte oldString[], byte newString) {
int length = oldString.length;
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFNullDecompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFNullDecompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -34,16 +34,16 @@
*/
private boolean isReadActiveOnly = false;
- /** The original value of <code>srcMinX</code>. */
+ /** The original value of {@code srcMinX}. */
private int originalSrcMinX;
- /** The original value of <code>srcMinY</code>. */
+ /** The original value of {@code srcMinY}. */
private int originalSrcMinY;
- /** The original value of <code>srcWidth</code>. */
+ /** The original value of {@code srcWidth}. */
private int originalSrcWidth;
- /** The original value of <code>srcHeight</code>. */
+ /** The original value of {@code srcHeight}. */
private int originalSrcHeight;
public TIFFNullDecompressor() {}
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFOldJPEGDecompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFOldJPEGDecompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -34,7 +34,7 @@
import javax.imageio.plugins.tiff.TIFFField;
/**
- * <code>TIFFDecompressor</code> for "Old JPEG" compression.
+ * {@code TIFFDecompressor} for "Old JPEG" compression.
*/
public class TIFFOldJPEGDecompressor extends TIFFJPEGDecompressor {
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFRLECompressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFRLECompressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -42,8 +42,8 @@
* CCITT RLE (Run Lenth Encoding).
*
* @param data The row of data to compress.
- * @param rowOffset Starting index in <code>data</code>.
- * @param colOffset Bit offset within first <code>data[rowOffset]</code>.
+ * @param rowOffset Starting index in {@code data}.
+ * @param colOffset Bit offset within first {@code data[rowOffset]}.
* @param rowLength Number of bits in the row.
* @param compData The compressed data.
*
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFRenderedImage.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFRenderedImage.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -85,15 +85,15 @@
}
/**
- * Creates a copy of <code>param</code>. The source subsampling and
+ * Creates a copy of {@code param}. The source subsampling and
* and bands settings and the destination bands and offset settings
- * are copied. If <code>param</code> is a <code>TIFFImageReadParam</code>
- * then the <code>TIFFDecompressor</code> and
- * <code>TIFFColorConverter</code> settings are also copied; otherwise
- * they are explicitly set to <code>null</code>.
+ * are copied. If {@code param} is a {@code TIFFImageReadParam}
+ * then the {@code TIFFDecompressor} and
+ * {@code TIFFColorConverter} settings are also copied; otherwise
+ * they are explicitly set to {@code null}.
*
* @param param the parameters to be copied.
- * @param copyTagSets whether the <code>TIFFTagSet</code> settings
+ * @param copyTagSets whether the {@code TIFFTagSet} settings
* should be copied if set.
* @return copied parameters.
*/
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFT4Compressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFT4Compressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -41,13 +41,13 @@
}
/**
- * Sets the value of the <code>metadata</code> field.
+ * Sets the value of the {@code metadata} field.
*
* <p> The implementation in this class also sets local options
* from the T4_OPTIONS field if it exists, and if it doesn't, adds
* it with default values.</p>
*
- * @param metadata the <code>IIOMetadata</code> object for the
+ * @param metadata the {@code IIOMetadata} object for the
* image being written.
*
* @see #getMetadata()
@@ -86,7 +86,7 @@
* @param isEOLAligned Whether EOL bit sequences should be padded.
* @param data The row of data to compress.
* @param lineStride Byte step between the same sample in different rows.
- * @param colOffset Bit offset within first <code>data[rowOffset]</code>.
+ * @param colOffset Bit offset within first {@code data[rowOffset]}.
* @param width Number of bits in the row.
* @param height Number of rows in the buffer.
* @param compData The compressed data.
--- a/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFT6Compressor.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/com/sun/imageio/plugins/tiff/TIFFT6Compressor.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -42,7 +42,7 @@
*
* @param data The row of data to compress.
* @param lineStride Byte step between the same sample in different rows.
- * @param colOffset Bit offset within first <code>data[rowOffset]</code>.
+ * @param colOffset Bit offset within first {@code data[rowOffset]}.
* @param width Number of bits in the row.
* @param height Number of rows in the buffer.
* @param compData The compressed data.
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/BaselineTIFFTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -2175,9 +2175,9 @@
}
/**
- * Returns a shared instance of a <code>BaselineTIFFTagSet</code>.
+ * Returns a shared instance of a {@code BaselineTIFFTagSet}.
*
- * @return a <code>BaselineTIFFTagSet</code> instance.
+ * @return a {@code BaselineTIFFTagSet} instance.
*/
public synchronized static BaselineTIFFTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifGPSTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifGPSTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -51,7 +51,7 @@
/**
* A value to be used with the "GPSVersionID" tag to indicate GPS version
* 2.2. The value equals the US-ASCII encoding of the byte array
- * <code>{'2', '2', '0', '0'}</code>.
+ * {@code {'2', '2', '0', '0'}}.
*
* @see #TAG_GPS_VERSION_ID
*/
@@ -711,9 +711,9 @@
}
/**
- * Returns a shared instance of an <code>ExifGPSTagSet</code>.
+ * Returns a shared instance of an {@code ExifGPSTagSet}.
*
- * @return an <code>ExifGPSTagSet</code> instance.
+ * @return an {@code ExifGPSTagSet} instance.
*/
public synchronized static ExifGPSTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifInteroperabilityTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifInteroperabilityTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -88,9 +88,9 @@
/**
* Returns the shared instance of
- * <code>ExifInteroperabilityTagSet</code>.
+ * {@code ExifInteroperabilityTagSet}.
*
- * @return the <code>ExifInteroperabilityTagSet</code> instance.
+ * @return the {@code ExifInteroperabilityTagSet} instance.
*/
public synchronized static ExifInteroperabilityTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifParentTIFFTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifParentTIFFTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -80,9 +80,9 @@
}
/**
- * Returns a shared instance of an <code>ExifParentTIFFTagSet</code>.
+ * Returns a shared instance of an {@code ExifParentTIFFTagSet}.
*
- * @return an <code>ExifParentTIFFTagSet</code> instance.
+ * @return an {@code ExifParentTIFFTagSet} instance.
*/
public synchronized static ExifParentTIFFTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifTIFFTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/ExifTIFFTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -33,7 +33,7 @@
* standard for annotating images used by most digital camera
* manufacturers. The Exif specification may be found at
* <a href="http://www.exif.org/Exif2-2.PDF">
- * <code>http://www.exif.org/Exif2-2.PDF</code>
+ * {@code http://www.exif.org/Exif2-2.PDF}
* </a>.
*
* <p> The definitions of the data types referenced by the field
@@ -67,7 +67,7 @@
/**
* A value to be used with the "ExifVersion" tag to indicate Exif version
* 2.1. The value equals the US-ASCII encoding of the byte array
- * <code>{'0', '2', '1', '0'}</code>.
+ * {@code {'0', '2', '1', '0'}}.
*
* @see #TAG_EXIF_VERSION
*/
@@ -78,7 +78,7 @@
/**
* A value to be used with the "ExifVersion" tag to indicate Exif version
* 2.2. The value equals the US-ASCII encoding of the byte array
- * <code>{'0', '2', '2', '0'}</code>.
+ * {@code {'0', '2', '2', '0'}}.
*
* @see #TAG_EXIF_VERSION
*/
@@ -94,7 +94,7 @@
/**
* A tag indicating the color space information (type SHORT). The
- * legal values are given by the <code>COLOR_SPACE_*</code>
+ * legal values are given by the {@code COLOR_SPACE_*}
* constants.
*
* @see #COLOR_SPACE_SRGB
@@ -1992,9 +1992,9 @@
}
/**
- * Returns a shared instance of an <code>ExifTIFFTagSet</code>.
+ * Returns a shared instance of an {@code ExifTIFFTagSet}.
*
- * @return an <code>ExifTIFFTagSet</code> instance.
+ * @return an {@code ExifTIFFTagSet} instance.
*/
public synchronized static ExifTIFFTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/FaxTIFFTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/FaxTIFFTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -131,9 +131,9 @@
}
/**
- * Returns a shared instance of a <code>FaxTIFFTagSet</code>.
+ * Returns a shared instance of a {@code FaxTIFFTagSet}.
*
- * @return a <code>FaxTIFFTagSet</code> instance.
+ * @return a {@code FaxTIFFTagSet} instance.
*/
public synchronized static FaxTIFFTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/GeoTIFFTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/GeoTIFFTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -32,7 +32,7 @@
* standard for annotating georeferenced or geocoded raster imagery.
* The GeoTIFF specification may be found at <a
* href="http://www.remotesensing.org/geotiff/spec/geotiffhome.html">
- * <code>http://www.remotesensing.org/geotiff/spec/geotiffhome.html</code>
+ * {@code http://www.remotesensing.org/geotiff/spec/geotiffhome.html}
* </a>. This class does <i>not</i> handle the <i>GeoKey</i>s referenced
* from a <i>GeoKeyDirectoryTag</i> as those are not TIFF tags per se.
*
@@ -63,7 +63,7 @@
/** A tag used to store the <i>GeoKey</i> directory. */
public static final int TAG_GEO_KEY_DIRECTORY = 34735;
- /** A tag used to store all <code>double</code>-values <i>GeoKey</i>s. */
+ /** A tag used to store all {@code double}-values <i>GeoKey</i>s. */
public static final int TAG_GEO_DOUBLE_PARAMS = 34736;
/** A tag used to store all ASCII-values <i>GeoKey</i>s. */
@@ -137,9 +137,9 @@
}
/**
- * Returns a shared instance of a <code>GeoTIFFTagSet</code>.
+ * Returns a shared instance of a {@code GeoTIFFTagSet}.
*
- * @return a <code>GeoTIFFTagSet</code> instance.
+ * @return a {@code GeoTIFFTagSet} instance.
*/
public synchronized static GeoTIFFTagSet getInstance() {
if (theInstance == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFDirectory.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFDirectory.java Thu Feb 11 13:42:53 2016 -0800
@@ -41,58 +41,58 @@
* image metadata. A TIFF image metadata tree represents an Image File
* Directory (IFD) from a TIFF 6.0 stream. An IFD consists of a number of
* IFD Entries each of which associates an identifying tag number with
- * a compatible value. A <code>TIFFDirectory</code> instance corresponds
+ * a compatible value. A {@code TIFFDirectory} instance corresponds
* to an IFD and contains a set of {@link TIFFField}s each of which
* corresponds to an IFD Entry in the IFD.
*
- * <p>When reading, a <code>TIFFDirectory</code> may be created by passing
+ * <p>When reading, a {@code TIFFDirectory} may be created by passing
* the value returned by {@link javax.imageio.ImageReader#getImageMetadata
* ImageReader.getImageMetadata()} to {@link #createFromMetadata
* createFromMetadata()}. The {@link TIFFField}s in the directory may then
* be obtained using the accessor methods provided in this class.</p>
*
* <p>When writing, an {@link IIOMetadata} object for use by one of the
- * <code>write()</code> methods of {@link javax.imageio.ImageWriter} may be
- * created from a <code>TIFFDirectory</code> by {@link #getAsMetadata()}.
- * The <code>TIFFDirectory</code> itself may be created by construction or
- * from the <code>IIOMetadata</code> object returned by
+ * {@code write()} methods of {@link javax.imageio.ImageWriter} may be
+ * created from a {@code TIFFDirectory} by {@link #getAsMetadata()}.
+ * The {@code TIFFDirectory} itself may be created by construction or
+ * from the {@code IIOMetadata} object returned by
* {@link javax.imageio.ImageWriter#getDefaultImageMetadata
- * ImageWriter.getDefaultImageMetadata()}. The <code>TIFFField</code>s in the
+ * ImageWriter.getDefaultImageMetadata()}. The {@code TIFFField}s in the
* directory may be set using the mutator methods provided in this class.</p>
*
- * <p>A <code>TIFFDirectory</code> is aware of the tag numbers in the
+ * <p>A {@code TIFFDirectory} is aware of the tag numbers in the
* group of {@link TIFFTagSet}s associated with it. When
- * a <code>TIFFDirectory</code> is created from a native image metadata
+ * a {@code TIFFDirectory} is created from a native image metadata
* object, these tag sets are derived from the <tt>tagSets</tt> attribute
* of the <tt>TIFFIFD</tt> node.</p>
*
- * <p>A <code>TIFFDirectory</code> might also have a parent {@link TIFFTag}.
+ * <p>A {@code TIFFDirectory} might also have a parent {@link TIFFTag}.
* This will occur if the directory represents an IFD other than the root
* IFD of the image. The parent tag is the tag of the IFD Entry which is a
- * pointer to the IFD represented by this <code>TIFFDirectory</code>. The
- * {@link TIFFTag#isIFDPointer} method of this parent <code>TIFFTag</code>
- * must return <code>true</code>. When a <code>TIFFDirectory</code> is
+ * pointer to the IFD represented by this {@code TIFFDirectory}. The
+ * {@link TIFFTag#isIFDPointer} method of this parent {@code TIFFTag}
+ * must return {@code true}. When a {@code TIFFDirectory} is
* created from a native image metadata object, the parent tag set is set
* from the <tt>parentTagName</tt> attribute of the corresponding
- * <tt>TIFFIFD</tt> node. Note that a <code>TIFFDirectory</code> instance
- * which has a non-<code>null</code> parent tag will be contained in the
- * data field of a <code>TIFFField</code> instance which has a tag field
+ * <tt>TIFFIFD</tt> node. Note that a {@code TIFFDirectory} instance
+ * which has a non-{@code null} parent tag will be contained in the
+ * data field of a {@code TIFFField} instance which has a tag field
* equal to the contained directory's parent tag.</p>
*
- * <p>As an example consider an Exif image. The <code>TIFFDirectory</code>
+ * <p>As an example consider an Exif image. The {@code TIFFDirectory}
* instance corresponding to the Exif IFD in the Exif stream would have parent
* tag {@link ExifParentTIFFTagSet#TAG_EXIF_IFD_POINTER TAG_EXIF_IFD_POINTER}
* and would include {@link ExifTIFFTagSet} in its group of known tag sets.
- * The <code>TIFFDirectory</code> corresponding to this Exif IFD will be
- * contained in the data field of a <code>TIFFField</code> which will in turn
- * be contained in the <code>TIFFDirectory</code> corresponding to the primary
- * IFD of the Exif image which will itself have a <code>null</code>-valued
+ * The {@code TIFFDirectory} corresponding to this Exif IFD will be
+ * contained in the data field of a {@code TIFFField} which will in turn
+ * be contained in the {@code TIFFDirectory} corresponding to the primary
+ * IFD of the Exif image which will itself have a {@code null}-valued
* parent tag.</p>
*
* <p><b>Note that this implementation is not synchronized. </b>If multiple
- * threads use a <code>TIFFDirectory</code> instance concurrently, and at
+ * threads use a {@code TIFFDirectory} instance concurrently, and at
* least one of the threads modifies the directory, for example, by adding
- * or removing <code>TIFFField</code>s or <code>TIFFTagSet</code>s, it
+ * or removing {@code TIFFField}s or {@code TIFFTagSet}s, it
* <i>must</i> be synchronized externally.</p>
*
* @since 9
@@ -107,10 +107,10 @@
private static final int MAX_LOW_FIELD_TAG_NUM =
BaselineTIFFTagSet.TAG_REFERENCE_BLACK_WHITE;
- /** The <code>TIFFTagSets</code> associated with this directory. */
+ /** The {@code TIFFTagSets} associated with this directory. */
private List<TIFFTagSet> tagSets;
- /** The parent <code>TIFFTag</code> of this directory. */
+ /** The parent {@code TIFFTag} of this directory. */
private TIFFTag parentTag;
/**
@@ -123,13 +123,13 @@
private int numLowFields = 0;
/**
- * A mapping of <code>Integer</code> tag numbers to <code>TIFFField</code>s
+ * A mapping of {@code Integer} tag numbers to {@code TIFFField}s
* for fields which are not low tag numbered.
*/
private Map<Integer,TIFFField> highFields = new TreeMap<Integer,TIFFField>();
/**
- * Creates a <code>TIFFDirectory</code> instance from the contents of
+ * Creates a {@code TIFFDirectory} instance from the contents of
* an image metadata object. The supplied object must support an image
* metadata format supported by the TIFF {@link javax.imageio.ImageWriter}
* plug-in. This will usually be either the TIFF native image metadata
@@ -139,12 +139,12 @@
* @param tiffImageMetadata A metadata object which supports a compatible
* image metadata format.
*
- * @return A <code>TIFFDirectory</code> populated from the contents of
+ * @return A {@code TIFFDirectory} populated from the contents of
* the supplied metadata object.
*
- * @throws NullPointerException if <code>tiffImageMetadata</code>
- * is <code>null</code>.
- * @throws IllegalArgumentException if <code>tiffImageMetadata</code>
+ * @throws NullPointerException if {@code tiffImageMetadata}
+ * is {@code null}.
+ * @throws IllegalArgumentException if {@code tiffImageMetadata}
* does not support a compatible image metadata format.
* @throws IIOInvalidTreeException if the supplied metadata object
* cannot be parsed.
@@ -204,7 +204,7 @@
}
/**
- * Converts a <code>TIFFDirectory</code> to a <code>TIFFIFD</code>.
+ * Converts a {@code TIFFDirectory} to a {@code TIFFIFD}.
*/
private static TIFFIFD getDirectoryAsIFD(TIFFDirectory dir) {
if(dir instanceof TIFFIFD) {
@@ -242,16 +242,16 @@
}
/**
- * Constructs a <code>TIFFDirectory</code> which is aware of a given
+ * Constructs a {@code TIFFDirectory} which is aware of a given
* group of {@link TIFFTagSet}s. An optional parent {@link TIFFTag}
* may also be specified.
*
- * @param tagSets The <code>TIFFTagSets</code> associated with this
+ * @param tagSets The {@code TIFFTagSets} associated with this
* directory.
- * @param parentTag The parent <code>TIFFTag</code> of this directory;
- * may be <code>null</code>.
- * @throws NullPointerException if <code>tagSets</code> is
- * <code>null</code>.
+ * @param parentTag The parent {@code TIFFTag} of this directory;
+ * may be {@code null}.
+ * @throws NullPointerException if {@code tagSets} is
+ * {@code null}.
*/
public TIFFDirectory(TIFFTagSet[] tagSets, TIFFTag parentTag) {
if(tagSets == null) {
@@ -268,8 +268,8 @@
/**
* Returns the {@link TIFFTagSet}s of which this directory is aware.
*
- * @return The <code>TIFFTagSet</code>s associated with this
- * <code>TIFFDirectory</code>.
+ * @return The {@code TIFFTagSet}s associated with this
+ * {@code TIFFDirectory}.
*/
public TIFFTagSet[] getTagSets() {
return tagSets.toArray(new TIFFTagSet[tagSets.size()]);
@@ -279,9 +279,9 @@
* Adds an element to the group of {@link TIFFTagSet}s of which this
* directory is aware.
*
- * @param tagSet The <code>TIFFTagSet</code> to add.
- * @throws NullPointerException if <code>tagSet</code> is
- * <code>null</code>.
+ * @param tagSet The {@code TIFFTagSet} to add.
+ * @throws NullPointerException if {@code tagSet} is
+ * {@code null}.
*/
public void addTagSet(TIFFTagSet tagSet) {
if(tagSet == null) {
@@ -297,9 +297,9 @@
* Removes an element from the group of {@link TIFFTagSet}s of which this
* directory is aware.
*
- * @param tagSet The <code>TIFFTagSet</code> to remove.
- * @throws NullPointerException if <code>tagSet</code> is
- * <code>null</code>.
+ * @param tagSet The {@code TIFFTagSet} to remove.
+ * @throws NullPointerException if {@code tagSet} is
+ * {@code null}.
*/
public void removeTagSet(TIFFTagSet tagSet) {
if(tagSet == null) {
@@ -313,10 +313,10 @@
/**
* Returns the parent {@link TIFFTag} of this directory if one
- * has been defined or <code>null</code> otherwise.
+ * has been defined or {@code null} otherwise.
*
- * @return The parent <code>TIFFTag</code> of this
- * <code>TIFFDiectory</code> or <code>null</code>.
+ * @return The parent {@code TIFFTag} of this
+ * {@code TIFFDiectory} or {@code null}.
*/
public TIFFTag getParentTag() {
return parentTag;
@@ -324,12 +324,12 @@
/**
* Returns the {@link TIFFTag} which has tag number equal to
- * <code>tagNumber</code> or <code>null</code> if no such tag
+ * {@code tagNumber} or {@code null} if no such tag
* exists in the {@link TIFFTagSet}s associated with this
* directory.
*
* @param tagNumber The tag number of interest.
- * @return The corresponding <code>TIFFTag</code> or <code>null</code>.
+ * @return The corresponding {@code TIFFTag} or {@code null}.
*/
public TIFFTag getTag(int tagNumber) {
return TIFFIFD.getTag(tagNumber, tagSets);
@@ -338,8 +338,8 @@
/**
* Returns the number of {@link TIFFField}s in this directory.
*
- * @return The number of <code>TIFFField</code>s in this
- * <code>TIFFDirectory</code>.
+ * @return The number of {@code TIFFField}s in this
+ * {@code TIFFDirectory}.
*/
public int getNumTIFFFields() {
return numLowFields + highFields.size();
@@ -351,7 +351,7 @@
*
* @param tagNumber The tag number.
* @return Whether a {@link TIFFTag} with tag number equal to
- * <code>tagNumber</code> is present in this <code>TIFFDirectory</code>.
+ * {@code tagNumber} is present in this {@code TIFFDirectory}.
*/
public boolean containsTIFFField(int tagNumber) {
return (tagNumber >= 0 && tagNumber <= MAX_LOW_FIELD_TAG_NUM &&
@@ -363,7 +363,7 @@
* Adds a TIFF field to the directory.
*
* @param f The field to add.
- * @throws NullPointerException if <code>f</code> is <code>null</code>.
+ * @throws NullPointerException if {@code f} is {@code null}.
*/
public void addTIFFField(TIFFField f) {
if(f == null) {
@@ -384,8 +384,8 @@
* Retrieves a TIFF field from the directory.
*
* @param tagNumber The tag number of the tag associated with the field.
- * @return A <code>TIFFField</code> with the requested tag number of
- * <code>null</code> if no such field is present.
+ * @return A {@code TIFFField} with the requested tag number of
+ * {@code null} if no such field is present.
*/
public TIFFField getTIFFField(int tagNumber) {
TIFFField f;
@@ -456,7 +456,7 @@
* Converts the directory to a metadata object.
*
* @return A metadata instance initialized from the contents of this
- * <code>TIFFDirectory</code>.
+ * {@code TIFFDirectory}.
*/
public IIOMetadata getAsMetadata() {
return new TIFFImageMetadata(getDirectoryAsIFD(this));
@@ -465,7 +465,7 @@
/**
* Clones the directory and all the fields contained therein.
*
- * @return A clone of this <code>TIFFDirectory</code>.
+ * @return A clone of this {@code TIFFDirectory}.
* @throws CloneNotSupportedException if the instance cannot be cloned.
*/
@Override
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFField.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFField.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -35,7 +35,7 @@
*
* <p> A field in a TIFF Image File Directory (IFD) is defined as a
* tag number accompanied by a sequence of values of identical data type.
- * TIFF 6.0 defines 12 data types; a 13th type <code>IFD</code> is
+ * TIFF 6.0 defines 12 data types; a 13th type {@code IFD} is
* defined in TIFF Tech Note 1 of TIFF Specification Supplement 1. These
* TIFF data types are referred to by Java constants and mapped internally
* onto Java language data types and type names as follows:
@@ -68,10 +68,10 @@
* {@link TIFFTag#TIFF_BYTE}
* </td>
* <td>
- * <code>byte</code>
+ * {@code byte}
* </td>
* <td>
- * <code>"Byte"</code>
+ * {@code "Byte"}
* </td>
* </tr>
*
@@ -83,10 +83,10 @@
* {@link TIFFTag#TIFF_ASCII}
* </td>
* <td>
- * <code>String</code>
+ * {@code String}
* </td>
* <td>
- * <code>"Ascii"</code>
+ * {@code "Ascii"}
* </td>
* </tr>
*
@@ -98,10 +98,10 @@
* {@link TIFFTag#TIFF_SHORT}
* </td>
* <td>
- * <code>char</code>
+ * {@code char}
* </td>
* <td>
- * <code>"Short"</code>
+ * {@code "Short"}
* </td>
* </tr>
*
@@ -113,10 +113,10 @@
* {@link TIFFTag#TIFF_LONG}
* </td>
* <td>
- * <code>long</code>
+ * {@code long}
* </td>
* <td>
- * <code>"Long"</code>
+ * {@code "Long"}
* </td>
* </tr>
*
@@ -128,10 +128,10 @@
* {@link TIFFTag#TIFF_RATIONAL}
* </td>
* <td>
- * <code>long[2]</code> {numerator, denominator}
+ * {@code long[2]} {numerator, denominator}
* </td>
* <td>
- * <code>"Rational"</code>
+ * {@code "Rational"}
* </td>
* </tr>
*
@@ -143,10 +143,10 @@
* {@link TIFFTag#TIFF_SBYTE}
* </td>
* <td>
- * <code>byte</code>
+ * {@code byte}
* </td>
* <td>
- * <code>"SByte"</code>
+ * {@code "SByte"}
* </td>
* </tr>
*
@@ -158,10 +158,10 @@
* {@link TIFFTag#TIFF_UNDEFINED}
* </td>
* <td>
- * <code>byte</code>
+ * {@code byte}
* </td>
* <td>
- * <code>"Undefined"</code>
+ * {@code "Undefined"}
* </td>
* </tr>
*
@@ -173,10 +173,10 @@
* {@link TIFFTag#TIFF_SSHORT}
* </td>
* <td>
- * <code>short</code>
+ * {@code short}
* </td>
* <td>
- * <code>"SShort"</code>
+ * {@code "SShort"}
* </td>
* </tr>
*
@@ -188,10 +188,10 @@
* {@link TIFFTag#TIFF_SLONG}
* </td>
* <td>
- * <code>int</code>
+ * {@code int}
* </td>
* <td>
- * <code>"SLong"</code>
+ * {@code "SLong"}
* </td>
* </tr>
*
@@ -203,10 +203,10 @@
* {@link TIFFTag#TIFF_SRATIONAL}
* </td>
* <td>
- * <code>int[2]</code> {numerator, denominator}
+ * {@code int[2]} {numerator, denominator}
* </td>
* <td>
- * <code>"SRational"</code>
+ * {@code "SRational"}
* </td>
* </tr>
*
@@ -218,10 +218,10 @@
* {@link TIFFTag#TIFF_FLOAT}
* </td>
* <td>
- * <code>float</code>
+ * {@code float}
* </td>
* <td>
- * <code>"Float"</code>
+ * {@code "Float"}
* </td>
* </tr>
*
@@ -233,10 +233,10 @@
* {@link TIFFTag#TIFF_DOUBLE}
* </td>
* <td>
- * <code>double</code>
+ * {@code double}
* </td>
* <td>
- * <code>"Double"</code>
+ * {@code "Double"}
* </td>
* </tr>
*
@@ -248,10 +248,10 @@
* {@link TIFFTag#TIFF_IFD_POINTER}
* </td>
* <td>
- * <code>long</code>
+ * {@code long}
* </td>
* <td>
- * <code>"IFDPointer"</code>
+ * {@code "IFDPointer"}
* </td>
* </tr>
*
@@ -411,19 +411,19 @@
}
/**
- * Creates a <code>TIFFField</code> from a TIFF native image
+ * Creates a {@code TIFFField} from a TIFF native image
* metadata node. If the value of the <tt>"tagNumber"</tt> attribute
- * of the node is not found in <code>tagSet</code> then a new
- * <code>TIFFTag</code> with name <code>TIFFTag.UNKNOWN_TAG_NAME</code>
+ * of the node is not found in {@code tagSet} then a new
+ * {@code TIFFTag} with name {@code TIFFTag.UNKNOWN_TAG_NAME}
* will be created and assigned to the field.
*
- * @param tagSet The <code>TIFFTagSet</code> to which the
- * <code>TIFFTag</code> of the field belongs.
- * @param node A native TIFF image metadata <code>TIFFField</code> node.
- * @throws NullPointerException if <code>node</code> is
- * <code>null</code>.
+ * @param tagSet The {@code TIFFTagSet} to which the
+ * {@code TIFFTag} of the field belongs.
+ * @param node A native TIFF image metadata {@code TIFFField} node.
+ * @throws NullPointerException if {@code node} is
+ * {@code null}.
* @throws IllegalArgumentException if the name of the node is not
- * <code>"TIFFField"</code>.
+ * {@code "TIFFField"}.
* @return A new {@code TIFFField}.
*/
public static TIFFField createFromMetadataNode(TIFFTagSet tagSet,
@@ -487,14 +487,14 @@
}
/**
- * Constructs a <code>TIFFField</code> with arbitrary data. The
- * <code>type</code> parameter must be a value for which
+ * Constructs a {@code TIFFField} with arbitrary data. The
+ * {@code type} parameter must be a value for which
* {@link TIFFTag#isDataTypeOK tag.isDataTypeOK()}
- * returns <code>true</code>. The <code>data</code> parameter must
+ * returns {@code true}. The {@code data} parameter must
* be an array of a Java type appropriate for the type of the TIFF
* field.
*
- * <p>Note that the value (data) of the <code>TIFFField</code>
+ * <p>Note that the value (data) of the {@code TIFFField}
* will always be the actual field value regardless of the number of
* bytes required for that value. This is the case despite the fact
* that the TIFF <i>IFD Entry</i> corresponding to the field may
@@ -503,29 +503,29 @@
* value fits into 4 bytes). In other words, the value of the
* field will already have been read from the TIFF stream. (An exception
* to this case may occur when the field represents the contents of a
- * non-baseline IFD. In that case the data will be a <code>long[]</code>
- * containing the offset to the IFD and the <code>TIFFDirectory</code>
+ * non-baseline IFD. In that case the data will be a {@code long[]}
+ * containing the offset to the IFD and the {@code TIFFDirectory}
* returned by {@link #getDirectory()} will be its contents.)
*
* @param tag The tag to associated with this field.
- * @param type One of the <code>TIFFTag.TIFF_*</code> constants
+ * @param type One of the {@code TIFFTag.TIFF_*} constants
* indicating the data type of the field as written to the TIFF stream.
* @param count The number of data values.
* @param data The actual data content of the field.
*
- * @throws NullPointerException if <code>tag == null</code>.
- * @throws IllegalArgumentException if <code>type</code> is not
- * one of the <code>TIFFTag.TIFF_*</code> data type constants.
- * @throws IllegalArgumentException if <code>type</code> is an unacceptable
- * data type for the supplied <code>TIFFTag</code>.
- * @throws IllegalArgumentException if <code>count < 0</code>.
- * @throws IllegalArgumentException if <code>count < 1</code>
- * and <code>type</code> is <code>TIFF_RATIONAL</code> or
- * <code>TIFF_SRATIONAL</code>.
- * @throws IllegalArgumentException if <code>count ≠ 1</code>
- * and <code>type</code> is <code>TIFF_IFD_POINTER</code>.
- * @throws NullPointerException if <code>data == null</code>.
- * @throws IllegalArgumentException if <code>data</code> is an instance of
+ * @throws NullPointerException if {@code tag == null}.
+ * @throws IllegalArgumentException if {@code type} is not
+ * one of the {@code TIFFTag.TIFF_*} data type constants.
+ * @throws IllegalArgumentException if {@code type} is an unacceptable
+ * data type for the supplied {@code TIFFTag}.
+ * @throws IllegalArgumentException if {@code count < 0}.
+ * @throws IllegalArgumentException if {@code count < 1}
+ * and {@code type} is {@code TIFF_RATIONAL} or
+ * {@code TIFF_SRATIONAL}.
+ * @throws IllegalArgumentException if {@code count ≠ 1}
+ * and {@code type} is {@code TIFF_IFD_POINTER}.
+ * @throws NullPointerException if {@code data == null}.
+ * @throws IllegalArgumentException if {@code data} is an instance of
* a class incompatible with the specified type.
* @throws IllegalArgumentException if the size of the data array is wrong.
*/
@@ -625,15 +625,15 @@
* parameters and the created array.
*
* @param tag The tag to associated with this field.
- * @param type One of the <code>TIFFTag.TIFF_*</code> constants
+ * @param type One of the {@code TIFFTag.TIFF_*} constants
* indicating the data type of the field as written to the TIFF stream.
* @param count The number of data values.
- * @throws NullPointerException if <code>tag == null</code>.
- * @throws IllegalArgumentException if <code>type</code> is not
- * one of the <code>TIFFTag.TIFF_*</code> data type constants.
- * @throws IllegalArgumentException if <code>type</code> is an unacceptable
- * data type for the supplied <code>TIFFTag</code>.
- * @throws IllegalArgumentException if <code>count < 0</code>.
+ * @throws NullPointerException if {@code tag == null}.
+ * @throws IllegalArgumentException if {@code type} is not
+ * one of the {@code TIFFTag.TIFF_*} data type constants.
+ * @throws IllegalArgumentException if {@code type} is an unacceptable
+ * data type for the supplied {@code TIFFTag}.
+ * @throws IllegalArgumentException if {@code count < 0}.
* @see #TIFFField(TIFFTag,int,int,Object)
*/
public TIFFField(TIFFTag tag, int type, int count) {
@@ -641,20 +641,20 @@
}
/**
- * Constructs a <code>TIFFField</code> with a single non-negative integral
+ * Constructs a {@code TIFFField} with a single non-negative integral
* value.
* The field will have type
* {@link TIFFTag#TIFF_SHORT TIFF_SHORT} if
- * <code>val < 65536</code> and type
+ * {@code val < 65536} and type
* {@link TIFFTag#TIFF_LONG TIFF_LONG} otherwise. The count
* of the field will be unity.
*
* @param tag The tag to associate with this field.
* @param value The value to associate with this field.
- * @throws NullPointerException if <code>tag == null</code>.
+ * @throws NullPointerException if {@code tag == null}.
* @throws IllegalArgumentException if the derived type is unacceptable
- * for the supplied <code>TIFFTag</code>.
- * @throws IllegalArgumentException if <code>value < 0</code>.
+ * for the supplied {@code TIFFTag}.
+ * @throws IllegalArgumentException if {@code value < 0}.
*/
public TIFFField(TIFFTag tag, int value) {
if(tag == null) {
@@ -690,24 +690,24 @@
}
/**
- * Constructs a <code>TIFFField</code> with an IFD offset and contents.
+ * Constructs a {@code TIFFField} with an IFD offset and contents.
* The offset will be stored as the data of this field as
- * <code>long[] {offset}</code>. The directory will not be cloned. The count
+ * {@code long[] {offset}}. The directory will not be cloned. The count
* of the field will be unity.
*
* @param tag The tag to associated with this field.
- * @param type One of the constants <code>TIFFTag.TIFF_LONG</code> or
- * <code>TIFFTag.TIFF_IFD_POINTER</code>.
+ * @param type One of the constants {@code TIFFTag.TIFF_LONG} or
+ * {@code TIFFTag.TIFF_IFD_POINTER}.
* @param offset The IFD offset.
* @param dir The directory.
*
- * @throws NullPointerException if <code>tag == null</code>.
- * @throws IllegalArgumentException if <code>type</code> is neither
- * <code>TIFFTag.TIFF_LONG</code> nor <code>TIFFTag.TIFF_IFD_POINTER</code>.
- * @throws IllegalArgumentException if <code>type</code> is an unacceptable
- * data type for the supplied <code>TIFFTag</code>.
- * @throws IllegalArgumentException if <code>offset</code> is non-positive.
- * @throws NullPointerException if <code>dir == null</code>.
+ * @throws NullPointerException if {@code tag == null}.
+ * @throws IllegalArgumentException if {@code type} is neither
+ * {@code TIFFTag.TIFF_LONG} nor {@code TIFFTag.TIFF_IFD_POINTER}.
+ * @throws IllegalArgumentException if {@code type} is an unacceptable
+ * data type for the supplied {@code TIFFTag}.
+ * @throws IllegalArgumentException if {@code offset} is non-positive.
+ * @throws NullPointerException if {@code dir == null}.
*
* @see #TIFFField(TIFFTag,int,int,Object)
*/
@@ -728,14 +728,14 @@
/**
* Retrieves the tag associated with this field.
*
- * @return The associated <code>TIFFTag</code>.
+ * @return The associated {@code TIFFTag}.
*/
public TIFFTag getTag() {
return tag;
}
/**
- * Retrieves the tag number in the range <code>[0, 65535]</code>.
+ * Retrieves the tag number in the range {@code [0, 65535]}.
*
* @return The tag number.
*/
@@ -745,7 +745,7 @@
/**
* Returns the type of the data stored in the field. For a TIFF 6.0
- * stream, the value will equal one of the <code>TIFFTag.TIFF_*</code>
+ * stream, the value will equal one of the {@code TIFFTag.TIFF_*}
* constants. For future revisions of TIFF, higher values are possible.
*
* @return The data type of the field value.
@@ -757,11 +757,11 @@
/**
* Returns the name of the supplied data type constant.
*
- * @param dataType One of the <code>TIFFTag.TIFF_*</code> constants
+ * @param dataType One of the {@code TIFFTag.TIFF_*} constants
* indicating the data type of the field as written to the TIFF stream.
* @return The type name corresponding to the supplied type constant.
- * @throws IllegalArgumentException if <code>dataType</code> is not
- * one of the <code>TIFFTag.TIFF_*</code> data type constants.
+ * @throws IllegalArgumentException if {@code dataType} is not
+ * one of the {@code TIFFTag.TIFF_*} data type constants.
*/
public static String getTypeName(int dataType) {
if (dataType < TIFFTag.MIN_DATATYPE ||
@@ -774,11 +774,11 @@
/**
* Returns the data type constant corresponding to the supplied data
- * type name. If the name is unknown <code>-1</code> will be returned.
+ * type name. If the name is unknown {@code -1} will be returned.
*
* @param typeName The type name.
- * @return One of the <code>TIFFTag.TIFF_*</code> constants or
- * <code>-1</code> if the name is not recognized.
+ * @return One of the {@code TIFFTag.TIFF_*} constants or
+ * {@code -1} if the name is not recognized.
*/
public static int getTypeByName(String typeName) {
for (int i = TIFFTag.MIN_DATATYPE; i <= TIFFTag.MAX_DATATYPE; i++) {
@@ -793,14 +793,14 @@
/**
* Creates an array appropriate for the indicated data type.
*
- * @param dataType One of the <code>TIFFTag.TIFF_*</code> data type
+ * @param dataType One of the {@code TIFFTag.TIFF_*} data type
* constants.
* @param count The number of values in the array.
* @return An array appropriate for the specified data type.
*
- * @throws IllegalArgumentException if <code>dataType</code> is not
- * one of the <code>TIFFTag.TIFF_*</code> data type constants.
- * @throws IllegalArgumentException if <code>count < 0</code>.
+ * @throws IllegalArgumentException if {@code dataType} is not
+ * one of the {@code TIFFTag.TIFF_*} data type constants.
+ * @throws IllegalArgumentException if {@code count < 0}.
*/
public static Object createArrayForType(int dataType, int count) {
if(count < 0) {
@@ -836,15 +836,15 @@
}
/**
- * Returns the <code>TIFFField</code> as a node named either
+ * Returns the {@code TIFFField} as a node named either
* <tt>"TIFFField"</tt> or <tt>"TIFFIFD"</tt> as described in the
* TIFF native image metadata specification. The node will be named
* <tt>"TIFFIFD"</tt> if and only if the field's data object is an
* instance of {@link TIFFDirectory} or equivalently
* {@link TIFFTag#isIFDPointer getTag.isIFDPointer()} returns
- * <code>true</code>.
+ * {@code true}.
*
- * @return a <code>Node</code> named <tt>"TIFFField"</tt> or
+ * @return a {@code Node} named <tt>"TIFFField"</tt> or
* <tt>"TIFFIFD"</tt>.
*/
public Node getAsNativeNode() {
@@ -863,8 +863,8 @@
/**
* Returns the number of data items present in the field. For
- * <code>TIFFTag.TIFF_ASCII</code> fields, the value returned is the
- * number of <code>String</code>s, not the total length of the
+ * {@code TIFFTag.TIFF_ASCII} fields, the value returned is the
+ * number of {@code String}s, not the total length of the
* data as in the file representation.
*
* @return The number of data items present in the field.
@@ -884,17 +884,17 @@
/**
* Returns the data as an uninterpreted array of
- * <code>byte</code>s. The type of the field must be one of
- * <code>TIFFTag.TIFF_BYTE</code>, <code>TIFF_SBYTE</code>, or
- * <code>TIFF_UNDEFINED</code>.
+ * {@code byte}s. The type of the field must be one of
+ * {@code TIFFTag.TIFF_BYTE}, {@code TIFF_SBYTE}, or
+ * {@code TIFF_UNDEFINED}.
*
- * <p> For data in <code>TIFFTag.TIFF_BYTE</code> format, the application
+ * <p> For data in {@code TIFFTag.TIFF_BYTE} format, the application
* must take care when promoting the data to longer integral types
* to avoid sign extension.
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_BYTE</code>, <code>TIFF_SBYTE</code>, or
- * <code>TIFF_UNDEFINED</code>.
+ * {@code TIFF_BYTE}, {@code TIFF_SBYTE}, or
+ * {@code TIFF_UNDEFINED}.
* @return The data as an uninterpreted array of bytes.
*/
public byte[] getAsBytes() {
@@ -902,11 +902,11 @@
}
/**
- * Returns <code>TIFFTag.TIFF_SHORT</code> data as an array of
- * <code>char</code>s (unsigned 16-bit integers).
+ * Returns {@code TIFFTag.TIFF_SHORT} data as an array of
+ * {@code char}s (unsigned 16-bit integers).
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_SHORT</code>.
+ * {@code TIFF_SHORT}.
* @return The data as an array of {@code char}s.
*/
public char[] getAsChars() {
@@ -914,11 +914,11 @@
}
/**
- * Returns <code>TIFFTag.TIFF_SSHORT</code> data as an array of
- * <code>short</code>s (signed 16-bit integers).
+ * Returns {@code TIFFTag.TIFF_SSHORT} data as an array of
+ * {@code short}s (signed 16-bit integers).
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_SSHORT</code>.
+ * {@code TIFF_SSHORT}.
* @return The data as an array of {@code short}s.
*/
public short[] getAsShorts() {
@@ -926,12 +926,12 @@
}
/**
- * Returns <code>TIFFTag.TIFF_SLONG</code> data as an array of
- * <code>int</code>s (signed 32-bit integers).
+ * Returns {@code TIFFTag.TIFF_SLONG} data as an array of
+ * {@code int}s (signed 32-bit integers).
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_SHORT</code>, <code>TIFF_SSHORT</code>, or
- * <code>TIFF_SLONG</code>.
+ * {@code TIFF_SHORT}, {@code TIFF_SSHORT}, or
+ * {@code TIFF_SLONG}.
* @return The data as an array of {@code int}s.
*/
public int[] getAsInts() {
@@ -957,12 +957,12 @@
}
/**
- * Returns <code>TIFFTag.TIFF_LONG</code> or
- * <code>TIFF_IFD_POINTER</code> data as an array of
- * <code>long</code>s (signed 64-bit integers).
+ * Returns {@code TIFFTag.TIFF_LONG} or
+ * {@code TIFF_IFD_POINTER} data as an array of
+ * {@code long}s (signed 64-bit integers).
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_LONG</code> or <code>TIFF_IFD_POINTER</code>.
+ * {@code TIFF_LONG} or {@code TIFF_IFD_POINTER}.
* @return The data as an array of {@code long}s.
*/
public long[] getAsLongs() {
@@ -970,11 +970,11 @@
}
/**
- * Returns <code>TIFFTag.TIFF_FLOAT</code> data as an array of
- * <code>float</code>s (32-bit floating-point values).
+ * Returns {@code TIFFTag.TIFF_FLOAT} data as an array of
+ * {@code float}s (32-bit floating-point values).
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_FLOAT</code>.
+ * {@code TIFF_FLOAT}.
* @return The data as an array of {@code float}s.
*/
public float[] getAsFloats() {
@@ -982,11 +982,11 @@
}
/**
- * Returns <code>TIFFTag.TIFF_DOUBLE</code> data as an array of
- * <code>double</code>s (64-bit floating-point values).
+ * Returns {@code TIFFTag.TIFF_DOUBLE} data as an array of
+ * {@code double}s (64-bit floating-point values).
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_DOUBLE</code>.
+ * {@code TIFF_DOUBLE}.
* @return The data as an array of {@code double}s.
*/
public double[] getAsDoubles() {
@@ -994,11 +994,11 @@
}
/**
- * Returns <code>TIFFTag.TIFF_SRATIONAL</code> data as an array of
- * 2-element arrays of <code>int</code>s.
+ * Returns {@code TIFFTag.TIFF_SRATIONAL} data as an array of
+ * 2-element arrays of {@code int}s.
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_SRATIONAL</code>.
+ * {@code TIFF_SRATIONAL}.
* @return The data as an array of signed rationals.
*/
public int[][] getAsSRationals() {
@@ -1006,11 +1006,11 @@
}
/**
- * Returns <code>TIFFTag.TIFF_RATIONAL</code> data as an array of
- * 2-element arrays of <code>long</code>s.
+ * Returns {@code TIFFTag.TIFF_RATIONAL} data as an array of
+ * 2-element arrays of {@code long}s.
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_RATIONAL</code>.
+ * {@code TIFF_RATIONAL}.
* @return The data as an array of unsigned rationals.
*/
public long[][] getAsRationals() {
@@ -1018,30 +1018,30 @@
}
/**
- * Returns data in any format as an <code>int</code>.
+ * Returns data in any format as an {@code int}.
*
- * <p> <code>TIFFTag.TIFF_BYTE</code> values are treated as unsigned; that
+ * <p> {@code TIFFTag.TIFF_BYTE} values are treated as unsigned; that
* is, no sign extension will take place and the returned value
- * will be in the range [0, 255]. <code>TIFF_SBYTE</code> data
+ * will be in the range [0, 255]. {@code TIFF_SBYTE} data
* will be returned in the range [-128, 127].
*
- * <p> A <code>TIFF_UNDEFINED</code> value is treated as though
- * it were a <code>TIFF_BYTE</code>.
+ * <p> A {@code TIFF_UNDEFINED} value is treated as though
+ * it were a {@code TIFF_BYTE}.
*
- * <p> Data in <code>TIFF_SLONG</code>, <code>TIFF_LONG</code>,
- * <code>TIFF_FLOAT</code>, <code>TIFF_DOUBLE</code> or
- * <code>TIFF_IFD_POINTER</code> format are simply cast to
- * <code>int</code> and may suffer from truncation.
+ * <p> Data in {@code TIFF_SLONG}, {@code TIFF_LONG},
+ * {@code TIFF_FLOAT}, {@code TIFF_DOUBLE} or
+ * {@code TIFF_IFD_POINTER} format are simply cast to
+ * {@code int} and may suffer from truncation.
*
- * <p> Data in <code>TIFF_SRATIONAL</code> or
- * <code>TIFF_RATIONAL</code> format are evaluated by dividing the
+ * <p> Data in {@code TIFF_SRATIONAL} or
+ * {@code TIFF_RATIONAL} format are evaluated by dividing the
* numerator into the denominator using double-precision
- * arithmetic and then casting to <code>int</code>. Loss of
+ * arithmetic and then casting to {@code int}. Loss of
* precision and truncation may occur.
*
- * <p> Data in <code>TIFF_ASCII</code> format will be parsed as by
- * the <code>Double.parseDouble</code> method, with the result
- * case to <code>int</code>.
+ * <p> Data in {@code TIFF_ASCII} format will be parsed as by
+ * the {@code Double.parseDouble} method, with the result
+ * case to {@code int}.
*
* @param index The index of the data.
* @return The data at the given index as an {@code int}.
@@ -1081,17 +1081,17 @@
}
/**
- * Returns data in any format as a <code>long</code>.
+ * Returns data in any format as a {@code long}.
*
- * <p> <code>TIFFTag.TIFF_BYTE</code> and <code>TIFF_UNDEFINED</code> data
+ * <p> {@code TIFFTag.TIFF_BYTE} and {@code TIFF_UNDEFINED} data
* are treated as unsigned; that is, no sign extension will take
* place and the returned value will be in the range [0, 255].
- * <code>TIFF_SBYTE</code> data will be returned in the range
+ * {@code TIFF_SBYTE} data will be returned in the range
* [-128, 127].
*
- * <p> Data in <code>TIFF_ASCII</code> format will be parsed as by
- * the <code>Double.parseDouble</code> method, with the result
- * cast to <code>long</code>.
+ * <p> Data in {@code TIFF_ASCII} format will be parsed as by
+ * the {@code Double.parseDouble} method, with the result
+ * cast to {@code long}.
*
* @param index The index of the data.
* @return The data at the given index as a {@code long}.
@@ -1127,27 +1127,27 @@
}
/**
- * Returns data in any format as a <code>float</code>.
+ * Returns data in any format as a {@code float}.
*
- * <p> <code>TIFFTag.TIFF_BYTE</code> and <code>TIFF_UNDEFINED</code> data
+ * <p> {@code TIFFTag.TIFF_BYTE} and {@code TIFF_UNDEFINED} data
* are treated as unsigned; that is, no sign extension will take
* place and the returned value will be in the range [0, 255].
- * <code>TIFF_SBYTE</code> data will be returned in the range
+ * {@code TIFF_SBYTE} data will be returned in the range
* [-128, 127].
*
- * <p> Data in <code>TIFF_SLONG</code>, <code>TIFF_LONG</code>,
- * <code>TIFF_DOUBLE</code>, or <code>TIFF_IFD_POINTER</code> format are
- * simply cast to <code>float</code> and may suffer from
+ * <p> Data in {@code TIFF_SLONG}, {@code TIFF_LONG},
+ * {@code TIFF_DOUBLE}, or {@code TIFF_IFD_POINTER} format are
+ * simply cast to {@code float} and may suffer from
* truncation.
*
- * <p> Data in <code>TIFF_SRATIONAL</code> or
- * <code>TIFF_RATIONAL</code> format are evaluated by dividing the
+ * <p> Data in {@code TIFF_SRATIONAL} or
+ * {@code TIFF_RATIONAL} format are evaluated by dividing the
* numerator into the denominator using double-precision
- * arithmetic and then casting to <code>float</code>.
+ * arithmetic and then casting to {@code float}.
*
- * <p> Data in <code>TIFF_ASCII</code> format will be parsed as by
- * the <code>Double.parseDouble</code> method, with the result
- * cast to <code>float</code>.
+ * <p> Data in {@code TIFF_ASCII} format will be parsed as by
+ * the {@code Double.parseDouble} method, with the result
+ * cast to {@code float}.
*
* @param index The index of the data.
* @return The data at the given index as a {@code float}.
@@ -1187,21 +1187,21 @@
}
/**
- * Returns data in any format as a <code>double</code>.
+ * Returns data in any format as a {@code double}.
*
- * <p> <code>TIFFTag.TIFF_BYTE</code> and <code>TIFF_UNDEFINED</code> data
+ * <p> {@code TIFFTag.TIFF_BYTE} and {@code TIFF_UNDEFINED} data
* are treated as unsigned; that is, no sign extension will take
* place and the returned value will be in the range [0, 255].
- * <code>TIFF_SBYTE</code> data will be returned in the range
+ * {@code TIFF_SBYTE} data will be returned in the range
* [-128, 127].
*
- * <p> Data in <code>TIFF_SRATIONAL</code> or
- * <code>TIFF_RATIONAL</code> format are evaluated by dividing the
+ * <p> Data in {@code TIFF_SRATIONAL} or
+ * {@code TIFF_RATIONAL} format are evaluated by dividing the
* numerator into the denominator using double-precision
* arithmetic.
*
- * <p> Data in <code>TIFF_ASCII</code> format will be parsed as by
- * the <code>Double.parseDouble</code> method.
+ * <p> Data in {@code TIFF_ASCII} format will be parsed as by
+ * the {@code Double.parseDouble} method.
*
* @param index The index of the data.
* @return The data at the given index as a {@code double}.
@@ -1241,11 +1241,11 @@
}
/**
- * Returns a <code>TIFFTag.TIFF_ASCII</code> value as a
- * <code>String</code>.
+ * Returns a {@code TIFFTag.TIFF_ASCII} value as a
+ * {@code String}.
*
* @throws ClassCastException if the field is not of type
- * <code>TIFF_ASCII</code>.
+ * {@code TIFF_ASCII}.
*
* @param index The index of the data.
* @return The data at the given index as a {@code String}.
@@ -1255,13 +1255,13 @@
}
/**
- * Returns a <code>TIFFTag.TIFF_SRATIONAL</code> data item as a
- * two-element array of <code>int</code>s.
+ * Returns a {@code TIFFTag.TIFF_SRATIONAL} data item as a
+ * two-element array of {@code int}s.
*
* @param index The index of the data.
* @return The data at the given index as a signed rational.
* @throws ClassCastException if the field is not of type
- * <code>TIFF_SRATIONAL</code>.
+ * {@code TIFF_SRATIONAL}.
*/
public int[] getAsSRational(int index) {
return ((int[][])data)[index];
@@ -1274,7 +1274,7 @@
* @param index The index of the data.
* @return The data at the given index as an unsigned rational.
* @throws ClassCastException if the field is not of type
- * <code>TIFF_RATIONAL</code>.
+ * {@code TIFF_RATIONAL}.
*/
public long[] getAsRational(int index) {
return ((long[][])data)[index];
@@ -1282,11 +1282,11 @@
/**
- * Returns a <code>String</code> containing a human-readable
+ * Returns a {@code String} containing a human-readable
* version of the data item. Data of type
- * <code>TIFFTag.TIFF_RATIONAL</code> or <code>TIFF_SRATIONAL</code> are
+ * {@code TIFFTag.TIFF_RATIONAL} or {@code TIFF_SRATIONAL} are
* represented as a pair of integers separated by a
- * <code>'/'</code> character.
+ * {@code '/'} character.
*
* @param index The index of the data.
* @return The data at the given index as a {@code String}.
@@ -1355,7 +1355,7 @@
}
/**
- * Returns whether the field has a <code>TIFFDirectory</code>.
+ * Returns whether the field has a {@code TIFFDirectory}.
*
* @return true if and only if getDirectory() returns non-null.
*/
@@ -1364,8 +1364,8 @@
}
/**
- * Returns the associated <code>TIFFDirectory</code>, if available. If no
- * directory is set, then <code>null</code> will be returned.
+ * Returns the associated {@code TIFFDirectory}, if available. If no
+ * directory is set, then {@code null} will be returned.
*
* @return the TIFFDirectory instance or null.
*/
@@ -1376,7 +1376,7 @@
/**
* Clones the field and all the information contained therein.
*
- * @return A clone of this <code>TIFFField</code>.
+ * @return A clone of this {@code TIFFField}.
* @throws CloneNotSupportedException if the instance cannot be cloned.
*/
@Override
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFImageReadParam.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFImageReadParam.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -39,11 +39,11 @@
* be provided by this interface.
*
* <p> Additional TIFF tags must be organized into
- * <code>TIFFTagSet</code>s. A <code>TIFFTagSet</code> may be
+ * {@code TIFFTagSet}s. A {@code TIFFTagSet} may be
* provided to the reader by means of the
- * <code>addAllowedTagSet</code> method. By default, the tag sets
- * <code>BaselineTIFFTagSet</code>, <code>FaxTIFFTagSet</code>,
- * <code>ExifParentTIFFTagSet</code>, and <code>GeoTIFFTagSet</code>
+ * {@code addAllowedTagSet} method. By default, the tag sets
+ * {@code BaselineTIFFTagSet}, {@code FaxTIFFTagSet},
+ * {@code ExifParentTIFFTagSet}, and {@code GeoTIFFTagSet}
* are included.
*
* @since 9
@@ -53,10 +53,10 @@
private List<TIFFTagSet> allowedTagSets = new ArrayList<TIFFTagSet>(4);
/**
- * Constructs a <code>TIFFImageReadParam</code>. Tags defined by
- * the <code>TIFFTagSet</code>s <code>BaselineTIFFTagSet</code>,
- * <code>FaxTIFFTagSet</code>, <code>ExifParentTIFFTagSet</code>, and
- * <code>GeoTIFFTagSet</code> will be supported.
+ * Constructs a {@code TIFFImageReadParam}. Tags defined by
+ * the {@code TIFFTagSet}s {@code BaselineTIFFTagSet},
+ * {@code FaxTIFFTagSet}, {@code ExifParentTIFFTagSet}, and
+ * {@code GeoTIFFTagSet} will be supported.
*
* @see BaselineTIFFTagSet
* @see FaxTIFFTagSet
@@ -71,13 +71,13 @@
}
/**
- * Adds a <code>TIFFTagSet</code> object to the list of allowed
+ * Adds a {@code TIFFTagSet} object to the list of allowed
* tag sets.
*
- * @param tagSet a <code>TIFFTagSet</code>.
+ * @param tagSet a {@code TIFFTagSet}.
*
- * @throws IllegalArgumentException if <code>tagSet</code> is
- * <code>null</code>.
+ * @throws IllegalArgumentException if {@code tagSet} is
+ * {@code null}.
*/
public void addAllowedTagSet(TIFFTagSet tagSet) {
if (tagSet == null) {
@@ -87,15 +87,15 @@
}
/**
- * Removes a <code>TIFFTagSet</code> object from the list of
- * allowed tag sets. Removal is based on the <code>equals</code>
- * method of the <code>TIFFTagSet</code>, which is normally
+ * Removes a {@code TIFFTagSet} object from the list of
+ * allowed tag sets. Removal is based on the {@code equals}
+ * method of the {@code TIFFTagSet}, which is normally
* defined as reference equality.
*
- * @param tagSet a <code>TIFFTagSet</code>.
+ * @param tagSet a {@code TIFFTagSet}.
*
- * @throws IllegalArgumentException if <code>tagSet</code> is
- * <code>null</code>.
+ * @throws IllegalArgumentException if {@code tagSet} is
+ * {@code null}.
*/
public void removeAllowedTagSet(TIFFTagSet tagSet) {
if (tagSet == null) {
@@ -105,10 +105,10 @@
}
/**
- * Returns a <code>List</code> containing the allowed
- * <code>TIFFTagSet</code> objects.
+ * Returns a {@code List} containing the allowed
+ * {@code TIFFTagSet} objects.
*
- * @return a <code>List</code> of <code>TIFFTagSet</code>s.
+ * @return a {@code List} of {@code TIFFTagSet}s.
*/
public List<TIFFTagSet> getAllowedTagSets() {
return allowedTagSets;
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFTag.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFTag.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -105,7 +105,7 @@
* The name assigned to a tag with an unknown tag number. Such
* a tag may be created for example when reading an IFD and a
* tag number is encountered which is not in any of the
- * <code>TIFFTagSet</code>s known to the reader.
+ * {@code TIFFTagSet}s known to the reader.
*/
public static final String UNKNOWN_TAG_NAME = "UnknownTag";
@@ -141,12 +141,12 @@
private SortedMap<Integer,String> valueNames = null;
/**
- * Constructs a <code>TIFFTag</code> with a given name, tag number, set
+ * Constructs a {@code TIFFTag} with a given name, tag number, set
* of legal data types, and value count. A negative value count signifies
* that either an arbitrary number of values is legal or the required count
* is determined by the values of other fields in the IFD. A non-negative
* count specifies the number of values which an associated field must
- * contain. The tag will have no associated <code>TIFFTagSet</code>.
+ * contain. The tag will have no associated {@code TIFFTagSet}.
*
* <p> If there are mnemonic names to be associated with the legal
* data values for the tag, {@link #addValueName(int, String)
@@ -183,18 +183,18 @@
}
/**
- * Constructs a <code>TIFFTag</code> with a given name, tag number and
- * <code>TIFFTagSet</code> to which it refers. The legal data types are
+ * Constructs a {@code TIFFTag} with a given name, tag number and
+ * {@code TIFFTagSet} to which it refers. The legal data types are
* set to include {@link #TIFF_LONG} and {@link #TIFF_IFD_POINTER} and the
- * value count is unity. The <code>TIFFTagSet</code> will
- * represent the set of <code>TIFFTag</code>s which appear in the IFD
- * pointed to. A <code>TIFFTag</code> represents an IFD pointer if and
- * only if <code>tagSet</code> is non-<code>null</code> or the data
- * type <code>TIFF_IFD_POINTER</code> is legal.
+ * value count is unity. The {@code TIFFTagSet} will
+ * represent the set of {@code TIFFTag}s which appear in the IFD
+ * pointed to. A {@code TIFFTag} represents an IFD pointer if and
+ * only if {@code tagSet} is non-{@code null} or the data
+ * type {@code TIFF_IFD_POINTER} is legal.
*
* @param name the name of the tag.
* @param number the number used to represent the tag.
- * @param tagSet the <code>TIFFTagSet</code> to which this tag belongs.
+ * @param tagSet the {@code TIFFTagSet} to which this tag belongs.
* @throws NullPointerException if name or tagSet is null.
* @throws IllegalArgumentException if number is negative.
*
@@ -210,9 +210,9 @@
}
/**
- * Constructs a <code>TIFFTag</code> with a given name, tag number,
+ * Constructs a {@code TIFFTag} with a given name, tag number,
* and set of legal data types. The value count of the tag will be
- * undefined and it will have no associated <code>TIFFTagSet</code>.
+ * undefined and it will have no associated {@code TIFFTagSet}.
*
* @param name the name of the tag.
* @param number the number used to represent the tag.
@@ -236,9 +236,9 @@
*
* @return the number of bytes used to store the given data type.
*
- * @throws IllegalArgumentException if <code>datatype</code> is
- * less than <code>MIN_DATATYPE</code> or greater than
- * <code>MAX_DATATYPE</code>.
+ * @throws IllegalArgumentException if {@code datatype} is
+ * less than {@code MIN_DATATYPE} or greater than
+ * {@code MAX_DATATYPE}.
*/
public static int getSizeOfType(int dataType) {
if (dataType < MIN_DATATYPE ||dataType > MAX_DATATYPE) {
@@ -251,7 +251,7 @@
/**
* Returns the name of the tag, as it will appear in image metadata.
*
- * @return the tag name, as a <code>String</code>.
+ * @return the tag name, as a {@code String}.
*/
public String getName() {
return name;
@@ -260,7 +260,7 @@
/**
* Returns the integer used to represent the tag.
*
- * @return the tag number, as an <code>int</code>.
+ * @return the tag number, as an {@code int}.
*/
public int getNumber() {
return number;
@@ -276,7 +276,7 @@
* (1 << TIFFTag.TIFF_SHORT) | (1 << TIFFTag.TIFF_LONG)
* </pre>
*
- * @return an <code>int</code> containing a bitmask encoding the
+ * @return an {@code int} containing a bitmask encoding the
* set of valid data types.
*/
public int getDataTypes() {
@@ -285,11 +285,11 @@
/**
* Returns the value count of this tag. If this value is positive, it
- * represents the required number of values for a <code>TIFFField</code>
+ * represents the required number of values for a {@code TIFFField}
* which has this tag. If the value is negative, the count is undefined.
* In the latter case the count may be derived, e.g., the number of values
- * of the <code>BitsPerSample</code> field is <code>SamplesPerPixel</code>,
- * or it may be variable as in the case of most <code>US-ASCII</code>
+ * of the {@code BitsPerSample} field is {@code SamplesPerPixel},
+ * or it may be variable as in the case of most {@code US-ASCII}
* fields.
*
* @return the value count of this tag.
@@ -299,18 +299,18 @@
}
/**
- * Returns <code>true</code> if the given data type
+ * Returns {@code true} if the given data type
* may be used for the data associated with this tag.
*
* @param dataType the data type to be queried, one of
- * <code>TIFF_BYTE</code>, <code>TIFF_SHORT</code>, etc.
+ * {@code TIFF_BYTE}, {@code TIFF_SHORT}, etc.
*
- * @return a <code>boolean</code> indicating whether the given
+ * @return a {@code boolean} indicating whether the given
* data type may be used with this tag.
*
- * @throws IllegalArgumentException if <code>datatype</code> is
- * less than <code>MIN_DATATYPE</code> or greater than
- * <code>MAX_DATATYPE</code>.
+ * @throws IllegalArgumentException if {@code datatype} is
+ * less than {@code MIN_DATATYPE} or greater than
+ * {@code MAX_DATATYPE}.
*/
public boolean isDataTypeOK(int dataType) {
if (dataType < MIN_DATATYPE || dataType > MAX_DATATYPE) {
@@ -320,38 +320,38 @@
}
/**
- * Returns the <code>TIFFTagSet</code> of which this tag is a part.
+ * Returns the {@code TIFFTagSet} of which this tag is a part.
*
- * @return the containing <code>TIFFTagSet</code>.
+ * @return the containing {@code TIFFTagSet}.
*/
public TIFFTagSet getTagSet() {
return tagSet;
}
/**
- * Returns <code>true</code> if this tag is used to point to an IFD
- * structure containing additional tags. A <code>TIFFTag</code> represents
- * an IFD pointer if and only if its <code>TIFFTagSet</code> is
- * non-<code>null</code> or the data type <code>TIFF_IFD_POINTER</code> is
+ * Returns {@code true} if this tag is used to point to an IFD
+ * structure containing additional tags. A {@code TIFFTag} represents
+ * an IFD pointer if and only if its {@code TIFFTagSet} is
+ * non-{@code null} or the data type {@code TIFF_IFD_POINTER} is
* legal. This condition will be satisfied if and only if either
- * <code>getTagSet() != null</code> or
- * <code>isDataTypeOK(TIFF_IFD_POINTER) == true</code>.
+ * {@code getTagSet() != null} or
+ * {@code isDataTypeOK(TIFF_IFD_POINTER) == true}.
*
* <p>Many TIFF extensions use the IFD mechanism in order to limit the
* number of new tags that may appear in the root IFD.</p>
*
- * @return <code>true</code> if this tag points to an IFD.
+ * @return {@code true} if this tag points to an IFD.
*/
public boolean isIFDPointer() {
return tagSet != null || isDataTypeOK(TIFF_IFD_POINTER);
}
/**
- * Returns <code>true</code> if there are mnemonic names associated with
+ * Returns {@code true} if there are mnemonic names associated with
* the set of legal values for the data associated with this tag. Mnemonic
* names apply only to tags which have integral data type.
*
- * @return <code>true</code> if mnemonic value names are available.
+ * @return {@code true} if mnemonic value names are available.
*/
public boolean hasValueNames() {
return valueNames != null;
@@ -373,14 +373,14 @@
/**
* Returns the mnemonic name associated with a particular value
- * that this tag's data may take on, or <code>null</code> if
+ * that this tag's data may take on, or {@code null} if
* no name is present. Mnemonic names apply only to tags which have
* integral data type.
*
* @param value the data value.
*
* @return the mnemonic name associated with the value, as a
- * <code>String</code>.
+ * {@code String}.
*/
public String getValueName(int value) {
if (valueNames == null) {
--- a/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFTagSet.java Thu Feb 11 12:24:28 2016 +0300
+++ b/jdk/src/java.desktop/share/classes/javax/imageio/plugins/tiff/TIFFTagSet.java Thu Feb 11 13:42:53 2016 -0800
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -39,7 +39,7 @@
* specification itself).
*
* <p> This class and its subclasses are responsible for mapping
- * between raw tag numbers and <code>TIFFTag</code> objects, which
+ * between raw tag numbers and {@code TIFFTag} objects, which
* contain additional information about each tag, such as the tag's
* name, legal data types, and mnemonic names for some or all of ts
* data values.
@@ -59,15 +59,15 @@
private TIFFTagSet() {}
/**
- * Constructs a <code>TIFFTagSet</code>, given a <code>List</code>
- * of <code>TIFFTag</code> objects.
+ * Constructs a {@code TIFFTagSet}, given a {@code List}
+ * of {@code TIFFTag} objects.
*
- * @param tags a <code>List</code> object containing
- * <code>TIFFTag</code> objects to be added to this tag set.
+ * @param tags a {@code List} object containing
+ * {@code TIFFTag} objects to be added to this tag set.
*
- * @throws IllegalArgumentException if <code>tags</code> is
- * <code>null</code>, or contains objects that are not instances
- * of the <code>TIFFTag</code> class.
+ * @throws IllegalArgumentException if {@code tags} is
+ * {@code null}, or contains objects that are not instances
+ * of the {@code TIFFTag} class.
*/
public TIFFTagSet(List<TIFFTag> tags) {
if (tags == null) {
@@ -88,29 +88,29 @@
}
/**
- * Returns the <code>TIFFTag</code> from this set that is
- * associated with the given tag number, or <code>null</code> if
+ * Returns the {@code TIFFTag} from this set that is
+ * associated with the given tag number, or {@code null} if
* no tag exists for that number.
*
* @param tagNumber the number of the tag to be retrieved.
*
- * @return the numbered <code>TIFFTag</code>, or <code>null</code>.
+ * @return the numbered {@code TIFFTag}, or {@code null}.
*/
public TIFFTag getTag(int tagNumber) {
return allowedTagsByNumber.get(Integer.valueOf(tagNumber));
}
/**
- * Returns the <code>TIFFTag</code> having the given tag name, or
- * <code>null</code> if the named tag does not belong to this tag set.
+ * Returns the {@code TIFFTag} having the given tag name, or
+ * {@code null} if the named tag does not belong to this tag set.
*
* @param tagName the name of the tag to be retrieved, as a
- * <code>String</code>.
+ * {@code String}.
*
- * @return the named <code>TIFFTag</code>, or <code>null</code>.
+ * @return the named {@code TIFFTag}, or {@code null}.
*
- * @throws IllegalArgumentException if <code>tagName</code> is
- * <code>null</code>.
+ * @throws IllegalArgumentException if {@code tagName} is
+ * {@code null}.
*/
public TIFFTag getTag(String tagName) {
if (tagName == null) {
@@ -123,7 +123,7 @@
* Retrieves an unmodifiable numerically increasing set of tag numbers.
*
* <p>The returned object is unmodifiable and contains the tag
- * numbers of all <code>TIFFTag</code>s in this <code>TIFFTagSet</code>
+ * numbers of all {@code TIFFTag}s in this {@code TIFFTagSet}
* sorted into ascending order according to
* {@link Integer#compareTo(Object)}.</p>
*
@@ -145,7 +145,7 @@
* Retrieves an unmodifiable lexicographically increasing set of tag names.
*
* <p>The returned object is unmodifiable and contains the tag
- * names of all <code>TIFFTag</code>s in this <code>TIFFTagSet</code>
+ * names of all {@code TIFFTag}s in this {@code TIFFTagSet}
* sorted into ascending order according to
* {@link String#compareTo(Object)}.</p>
*