55 < title > TIFF Metadata Format Specification and Usage Notes</ title >
66</ head >
77<!--
8- Copyright (c) 2015, 2019 , Oracle and/or its affiliates. All rights reserved.
8+ Copyright (c) 2015, 2020 , Oracle and/or its affiliates. All rights reserved.
99DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
1010
1111This code is free software; you can redistribute it and/or modify it
@@ -72,9 +72,9 @@ <h1>TIFF Metadata Format Specification and Usage Notes</h1>
7272
7373< h2 > < a id ="Reading "> Reading Images</ a > </ h2 >
7474
75- TIFF images are read by an < a href =" ../../ ImageReader.html " > ImageReader</ a >
75+ TIFF images are read by an {@link javax.imageio. ImageReader ImageReader}
7676which may be controlled by its public interface as well as via a supplied
77- < a href =" ../../ plugins/ tiff/TIFFImageReadParam.html " > TIFFImageReadParam</ a > .
77+ {@link javax.imageio. plugins. tiff. TIFFImageReadParam TIFFImageReadParam} .
7878
7979<!-- <h3>Supported Image Types</h3> -->
8080
@@ -90,7 +90,7 @@ <h3><a id="ColorConversionRead">Color Conversion</a></h3>
9090< h3 > < a id ="ColorSpacesRead "> Color Spaces</ a > </ h3 >
9191
9292The raw color space assigned by default, i.e., in the absence of a
93- user-supplied < a href =" ../../ ImageTypeSpecifier.html " > ImageTypeSpecifier</ a > ,
93+ user-supplied {@link javax.imageio. ImageTypeSpecifier ImageTypeSpecifier} ,
9494will be the first among the following which applies:
9595
9696< ul >
@@ -158,8 +158,8 @@ <h3><a id="ColorSpacesRead">Color Spaces</a></h3>
158158< h3 > < a id ="ICCProfilesRead "> ICC Profiles</ a > </ h3 >
159159
160160If an ICC profile is contained in the image metadata
161- (< a href =" ../../ plugins/ tiff/ BaselineTIFFTagSet.html " >
162- BaselineTIFFTagSet </ a > . TAG_ICC_PROFILE, tag number 34675),
161+ ({@link javax.imageio. plugins. tiff. BaselineTIFFTagSet BaselineTIFFTagSet}.
162+ TAG_ICC_PROFILE, tag number 34675),
163163an attempt will be made to use it to create the color space
164164of the loaded image. It will be used if the data layout is of component type
165165and the number of samples per pixel equals or is one greater than the number
@@ -174,15 +174,13 @@ <h3><a id="ICCProfilesRead">ICC Profiles</a></h3>
174174< li > Obtain the image metadata from
175175< code > ImageReader.getImageMetadata</ code > </ li >
176176< li > Extract the ICC profile field and its value.</ li >
177- < li > Create an < a href ="../../../../java/awt/color/ICC_ColorSpace.html ">
178- ICC_ColorSpace</ a > from an
179- < a href ="../../../../java/awt/color/ICC_Profile.html ">
180- ICC_Profile</ a > created from the ICC profile field data
177+ < li > Create an {@link java.awt.color.ICC_ColorSpace ICC_ColorSpace} from an
178+ {@link java.awt.color.ICC_Profile ICC_Profile} created from the ICC profile field data
181179using < code > ICC_Profile.getInstance(byte[])</ code > .</ li >
182180< li > Create an < code > ImageTypeSpecifier</ code > from the new color
183181space using one of its factory methods which accepts an
184182< code > ICC_ColorSpace</ code > .
185- < li > Create a compatible < a href =" ../../ ImageReadParam.html " > ImageReadParam</ a >
183+ < li > Create a compatible {@link javax.imageio. ImageReadParam ImageReadParam}
186184and set the < code > ImageTypeSpecifier</ code > using
187185< code > ImageReadParam.setDestinationType</ code > .</ li >
188186< li > Pass the parameter object to the appropriate < code > read</ code > method.</ li >
@@ -206,7 +204,7 @@ <h3><a id="MetadataIssuesRead">Metadata Issues</a></h3>
206204metadata. The reader is informed to disregard all metadata as usual via the
207205< code > ignoreMetadata</ code > parameter of
208206< code > ImageReader.setInput(Object,boolean,boolean)</ code > . It is
209- informed of which < a href =" ../../ plugins/ tiff/TIFFTag.html " > TIFFTag</ a > s to
207+ informed of which {@link javax.imageio. plugins. tiff. TIFFTag TIFFTag} s to
210208recognize or not to recognize via
211209< code > TIFFImageReadParam.addAllowedTagSet(TIFFTagSet)</ code > and
212210< code > TIFFImageReadParam.removeAllowedTagSet(TIFFTagSet)</ code > .
@@ -221,7 +219,7 @@ <h3><a id="MetadataIssuesRead">Metadata Issues</a></h3>
221219< code > TIFFImageReadParam.setReadUnknownTags(boolean)</ code > has been
222220invoked with parameter < code > true</ code > .
223221
224- < p > Use of a < a href =" ../../ plugins/ tiff/TIFFDirectory.html " > TIFFDirectory</ a >
222+ < p > Use of a {@link javax.imageio. plugins. tiff. TIFFDirectory TIFFDirectory}
225223object may simplify gaining access to metadata values. An instance of
226224< code > TIFFDirectory</ code > may be created from the < code > IIOMetadata</ code >
227225object returned by the TIFF reader using the
@@ -481,9 +479,9 @@ <h4><a id="ExifReadJPEG">Reading Compressed Exif Images</a></h4>
481479
482480< h2 > < a id ="Writing "> Writing Images</ a > </ h2 >
483481
484- TIFF images are written by a < a href =" ../../ ImageWriter.html " > ImageWriter</ a > which may be
482+ TIFF images are written by a {@link javax.imageio. ImageWriter ImageWriter} which may be
485483controlled by its public interface as well as via a supplied
486- < a href =" ../../ ImageWriteParam.html " > ImageWriteParam</ a > . For an < code > ImageWriteParam</ code > returned
484+ {@link javax.imageio. ImageWriteParam ImageWriteParam} . For an < code > ImageWriteParam</ code > returned
487485by the < code > getDefaultWriteParam()</ code > method of the TIFF < code > ImageWriter</ code > ,
488486the < code > canWriteTiles()</ code > and < code > canWriteCompressed()</ code > methods
489487will return < code > true</ code > ; the < code > canOffsetTiles()</ code > and
@@ -631,9 +629,9 @@ <h3><a id="ICCProfilesWrite">ICC Profiles</a></h3>
631629An < code > ICC Profile</ code > field will be written if either:
632630< ul >
633631< li > one is present in the native image metadata
634- < a href =" ../IIOMetadata.html " > IIOMetadata</ a > instance supplied to the writer,
632+ {@link javax.imageio.metadata. IIOMetadata IIOMetadata} instance supplied to the writer,
635633or</ li >
636- < li > the < a href =" ../../../../ java/ awt/ color/ColorSpace.html " > ColorSpace</ a >
634+ < li > the {@link java. awt. color. ColorSpace ColorSpace}
637635of the destination < code > ImageTypeSpecifier</ code > is an instance of
638636< code > ICC_ColorSpace</ code > which is not one of the standard
639637color spaces defined by the < code > CS_*</ code > constants in the
@@ -748,7 +746,7 @@ <h3><a id="MetadataIssuesWrite">Metadata Issues</a></h3>
748746< p > Setting up the image metadata to write to a TIFF stream may be simplified
749747by using the < code > TIFFDirectory</ code > class
750748which represents a TIFF IFD. A field in a TIFF IFD is represented by an
751- instance of < a href =" ../../ plugins/ tiff/TIFFField.html " > TIFFField</ a > . For each
749+ instance of {@link javax.imageio. plugins. tiff. TIFFField TIFFField} . For each
752750field to be written a < code > TIFFField</ code > may be added to the
753751< code > TIFFDirectory</ code > and the latter converted to an
754752< code > IIOMetadata</ code > object by invoking
0 commit comments