This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-imaging.git
commit cecdcc8dd05235d96a0c4cc6caf31584def64498 Author: Gary Gregory <[email protected]> AuthorDate: Mon Jan 5 14:42:48 2026 -0500 Javadoc --- .../imaging/common/XmpImagingParameters.java | 7 ++++ .../imaging/formats/bmp/BmpImageParser.java | 2 +- .../imaging/formats/dcx/DcxImageParser.java | 2 +- .../imaging/formats/icns/IcnsImageParser.java | 2 +- .../imaging/formats/ico/IcoImageParser.java | 2 +- .../imaging/formats/jpeg/iptc/IptcParser.java | 2 +- .../imaging/formats/jpeg/xmp/JpegRewriter.java | 8 ++++ .../imaging/formats/pnm/PnmImageParser.java | 2 +- .../formats/psd/dataparsers/DataParserBitmap.java | 2 +- .../formats/psd/dataparsers/DataParserCmyk.java | 2 +- .../psd/dataparsers/DataParserGrayscale.java | 2 +- .../formats/psd/dataparsers/DataParserIndexed.java | 2 +- .../formats/psd/dataparsers/DataParserLab.java | 2 +- .../formats/psd/dataparsers/DataParserRgb.java | 2 +- .../imaging/formats/rgbe/RgbeImageParser.java | 2 +- .../formats/tiff/TiffImagingParameters.java | 7 ++++ .../tiff/constants/TiffDirectoryConstants.java | 34 ++++++++++++++++ .../formats/tiff/constants/TiffDirectoryType.java | 43 ++++++++++++++++++++ .../formats/tiff/constants/TiffEpTagConstants.java | 46 ++++++++++++++++++++++ .../imaging/formats/wbmp/WbmpImageParser.java | 2 +- .../formats/wbmp/WbmpImagingParameters.java | 8 +++- .../formats/webp/WebPImagingParameters.java | 7 ++++ .../imaging/formats/xbm/XbmImageParser.java | 2 +- .../imaging/formats/xbm/XbmImagingParameters.java | 8 +++- .../imaging/formats/xpm/XpmImageParser.java | 2 +- .../imaging/formats/xpm/XpmImagingParameters.java | 8 +++- 26 files changed, 189 insertions(+), 19 deletions(-) diff --git a/src/main/java/org/apache/commons/imaging/common/XmpImagingParameters.java b/src/main/java/org/apache/commons/imaging/common/XmpImagingParameters.java index a8b393c4..cbd1805f 100644 --- a/src/main/java/org/apache/commons/imaging/common/XmpImagingParameters.java +++ b/src/main/java/org/apache/commons/imaging/common/XmpImagingParameters.java @@ -27,6 +27,13 @@ import org.apache.commons.imaging.ImagingParameters; */ public class XmpImagingParameters<E extends XmpImagingParameters<E>> extends ImagingParameters<E> { + /** + * Constructs a new instance. + */ + public XmpImagingParameters() { + // Default constructor + } + private String xmpXml; /** diff --git a/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java b/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java index 0d8e0127..f951dbe2 100644 --- a/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/bmp/BmpImageParser.java @@ -49,7 +49,7 @@ import org.apache.commons.imaging.palette.PaletteFactory; import org.apache.commons.imaging.palette.SimplePalette; /** - * Parser for BMP (Windows Bitmap) image format. + * Parses the BMP (Windows Bitmap) image format. */ public class BmpImageParser extends AbstractImageParser<BmpImagingParameters> { diff --git a/src/main/java/org/apache/commons/imaging/formats/dcx/DcxImageParser.java b/src/main/java/org/apache/commons/imaging/formats/dcx/DcxImageParser.java index 5070c4f6..40e6ef11 100644 --- a/src/main/java/org/apache/commons/imaging/formats/dcx/DcxImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/dcx/DcxImageParser.java @@ -41,7 +41,7 @@ import org.apache.commons.imaging.formats.pcx.PcxImageParser; import org.apache.commons.imaging.formats.pcx.PcxImagingParameters; /** - * Parser for DCX (multi-page PCX) image format. + * Parses the DCX (multi-page PCX) image format. */ public class DcxImageParser extends AbstractImageParser<PcxImagingParameters> { private static final class DcxHeader { diff --git a/src/main/java/org/apache/commons/imaging/formats/icns/IcnsImageParser.java b/src/main/java/org/apache/commons/imaging/formats/icns/IcnsImageParser.java index 252f362f..cf726d3d 100644 --- a/src/main/java/org/apache/commons/imaging/formats/icns/IcnsImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/icns/IcnsImageParser.java @@ -38,7 +38,7 @@ import org.apache.commons.imaging.common.AbstractBinaryOutputStream; import org.apache.commons.imaging.common.ImageMetadata; /** - * Parser for Apple Icon Image (.icns) format. + * Parses the Apple Icon Image (.icns) format. */ public class IcnsImageParser extends AbstractImageParser<IcnsImagingParameters> { private static final class IcnsContents { diff --git a/src/main/java/org/apache/commons/imaging/formats/ico/IcoImageParser.java b/src/main/java/org/apache/commons/imaging/formats/ico/IcoImageParser.java index 1d5b5a70..78935dbb 100644 --- a/src/main/java/org/apache/commons/imaging/formats/ico/IcoImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/ico/IcoImageParser.java @@ -48,7 +48,7 @@ import org.apache.commons.imaging.palette.PaletteFactory; import org.apache.commons.imaging.palette.SimplePalette; /** - * Parser for Windows Icon (.ico) format. + * Parses the Windows Icon (.ico) format. */ public class IcoImageParser extends AbstractImageParser<IcoImagingParameters> { private static final class BitmapHeader { diff --git a/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java b/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java index 855e06ff..e874f203 100644 --- a/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/jpeg/iptc/IptcParser.java @@ -44,7 +44,7 @@ import org.apache.commons.imaging.formats.jpeg.JpegImagingParameters; import org.apache.commons.imaging.internal.Debug; /** - * Parser for IPTC (International Press Telecommunications Council) metadata in JPEG images. + * Parses IPTC (International Press Telecommunications Council) metadata in JPEG images. */ public class IptcParser extends BinaryFileParser { diff --git a/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java b/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java index 790c0bd7..8af44ff2 100644 --- a/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java +++ b/src/main/java/org/apache/commons/imaging/formats/jpeg/xmp/JpegRewriter.java @@ -40,6 +40,14 @@ public class JpegRewriter extends BinaryFileParser { * Abstracts JFIF pieces. */ protected abstract static class JFIFPiece { + + /** + * Constructs a new instance. + */ + protected JFIFPiece() { + // Default constructor + } + @Override public String toString() { return "[" + this.getClass().getName() + "]"; diff --git a/src/main/java/org/apache/commons/imaging/formats/pnm/PnmImageParser.java b/src/main/java/org/apache/commons/imaging/formats/pnm/PnmImageParser.java index f23cc12d..255512b9 100644 --- a/src/main/java/org/apache/commons/imaging/formats/pnm/PnmImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/pnm/PnmImageParser.java @@ -41,7 +41,7 @@ import org.apache.commons.imaging.common.ImageMetadata; import org.apache.commons.imaging.palette.PaletteFactory; /** - * Parser for PNM (Portable aNyMap) image format. + * Parses the PNM (Portable aNyMap) image format. */ public class PnmImageParser extends AbstractImageParser<PnmImagingParameters> { diff --git a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserBitmap.java b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserBitmap.java index d52431c1..f90f8fb0 100644 --- a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserBitmap.java +++ b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserBitmap.java @@ -19,7 +19,7 @@ package org.apache.commons.imaging.formats.psd.dataparsers; import org.apache.commons.imaging.formats.psd.PsdImageContents; /** - * Parser for bitmap mode PSD image data. + * Parses bitmap mode PSD image data. */ public class DataParserBitmap extends AbstractDataParser { diff --git a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserCmyk.java b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserCmyk.java index 5a30a269..0bf86038 100644 --- a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserCmyk.java +++ b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserCmyk.java @@ -20,7 +20,7 @@ import org.apache.commons.imaging.color.ColorConversions; import org.apache.commons.imaging.formats.psd.PsdImageContents; /** - * Parser for CMYK mode PSD image data. + * Parses CMYK mode PSD image data. */ public class DataParserCmyk extends AbstractDataParser { diff --git a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserGrayscale.java b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserGrayscale.java index 15b8b973..b4a80410 100644 --- a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserGrayscale.java +++ b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserGrayscale.java @@ -19,7 +19,7 @@ package org.apache.commons.imaging.formats.psd.dataparsers; import org.apache.commons.imaging.formats.psd.PsdImageContents; /** - * Parser for grayscale mode PSD image data. + * Parses grayscale mode PSD image data. */ public class DataParserGrayscale extends AbstractDataParser { diff --git a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserIndexed.java b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserIndexed.java index 5037ae40..30059601 100644 --- a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserIndexed.java +++ b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserIndexed.java @@ -21,7 +21,7 @@ import java.util.Arrays; import org.apache.commons.imaging.formats.psd.PsdImageContents; /** - * Parser for indexed color mode PSD image data. + * Parses indexed color mode PSD image data. */ public class DataParserIndexed extends AbstractDataParser { private final int[] colorTable; diff --git a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserLab.java b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserLab.java index eed9b6d6..73a9ed14 100644 --- a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserLab.java +++ b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserLab.java @@ -20,7 +20,7 @@ import org.apache.commons.imaging.color.ColorConversions; import org.apache.commons.imaging.formats.psd.PsdImageContents; /** - * Parser for Lab color mode PSD image data. + * Parses Lab color mode PSD image data. */ public class DataParserLab extends AbstractDataParser { diff --git a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserRgb.java b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserRgb.java index 7788d5c9..4b82ef4c 100644 --- a/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserRgb.java +++ b/src/main/java/org/apache/commons/imaging/formats/psd/dataparsers/DataParserRgb.java @@ -19,7 +19,7 @@ package org.apache.commons.imaging.formats.psd.dataparsers; import org.apache.commons.imaging.formats.psd.PsdImageContents; /** - * Parser for RGB color mode PSD image data. + * Parses RGB color mode PSD image data. */ public class DataParserRgb extends AbstractDataParser { diff --git a/src/main/java/org/apache/commons/imaging/formats/rgbe/RgbeImageParser.java b/src/main/java/org/apache/commons/imaging/formats/rgbe/RgbeImageParser.java index d09ea40c..f5bdf5c9 100644 --- a/src/main/java/org/apache/commons/imaging/formats/rgbe/RgbeImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/rgbe/RgbeImageParser.java @@ -38,7 +38,7 @@ import org.apache.commons.imaging.bytesource.ByteSource; import org.apache.commons.imaging.common.ImageMetadata; /** - * Parser for Radiance HDR images + * Parses Radiance HDR images. */ public class RgbeImageParser extends AbstractImageParser<RgbeImagingParameters> { diff --git a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImagingParameters.java b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImagingParameters.java index 052e02e3..d532a0fe 100644 --- a/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImagingParameters.java +++ b/src/main/java/org/apache/commons/imaging/formats/tiff/TiffImagingParameters.java @@ -26,6 +26,13 @@ import org.apache.commons.imaging.formats.tiff.write.TiffOutputSet; */ public class TiffImagingParameters extends XmpImagingParameters<TiffImagingParameters> { + /** + * Constructs a new instance. + */ + public TiffImagingParameters() { + // Default constructor + } + /** * Indicates whether to read embedded thumbnails or not. Only applies to read EXIF metadata from JPEG/JFIF files. * diff --git a/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryConstants.java b/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryConstants.java index 2358938d..31ca4e2d 100644 --- a/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryConstants.java +++ b/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryConstants.java @@ -16,23 +16,57 @@ */ package org.apache.commons.imaging.formats.tiff.constants; +/** + * Constants for TIFF directory types. + */ public final class TiffDirectoryConstants { + /** Directory type: Unknown. */ public static final int DIRECTORY_TYPE_UNKNOWN = -1; + + /** Directory type: Root. */ public static final int DIRECTORY_TYPE_ROOT = 0; + + /** Directory type: Sub. */ public static final int DIRECTORY_TYPE_SUB = 1; + + /** Directory type: Sub0. */ public static final int DIRECTORY_TYPE_SUB0 = 1; + + /** Directory type: Sub1. */ public static final int DIRECTORY_TYPE_SUB1 = 2; + + /** Directory type: Sub2. */ public static final int DIRECTORY_TYPE_SUB2 = 3; + + /** Directory type: Thumbnail. */ public static final int DIRECTORY_TYPE_THUMBNAIL = 2; + + /** Directory type: EXIF. */ public static final int DIRECTORY_TYPE_EXIF = -2; + + /** Directory type: GPS. */ public static final int DIRECTORY_TYPE_GPS = -3; + + /** Directory type: Interoperability. */ public static final int DIRECTORY_TYPE_INTEROPERABILITY = -4; + + /** Directory type: Maker Notes. */ public static final int DIRECTORY_TYPE_MAKER_NOTES = -5; + + /** Directory type: Directory 0. */ public static final int DIRECTORY_TYPE_DIR_0 = 0; + + /** Directory type: Directory 1. */ public static final int DIRECTORY_TYPE_DIR_1 = 1; + + /** Directory type: Directory 2. */ public static final int DIRECTORY_TYPE_DIR_2 = 2; + + /** Directory type: Directory 3. */ public static final int DIRECTORY_TYPE_DIR_3 = 3; + + /** Directory type: Directory 4. */ public static final int DIRECTORY_TYPE_DIR_4 = 4; // TODO: this should really be an enum diff --git a/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryType.java b/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryType.java index eda61ba4..5c2e179a 100644 --- a/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryType.java +++ b/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffDirectoryType.java @@ -16,34 +16,68 @@ */ package org.apache.commons.imaging.formats.tiff.constants; +/** + * TIFF directory types. + */ public enum TiffDirectoryType { + + /** TIFF directory: IFD0. */ TIFF_DIRECTORY_IFD0(true, TiffDirectoryConstants.DIRECTORY_TYPE_DIR_0, "IFD0"), + /** TIFF directory: IFD1. */ TIFF_DIRECTORY_IFD1(true, TiffDirectoryConstants.DIRECTORY_TYPE_DIR_1, "IFD1"), + /** TIFF directory: IFD2. */ TIFF_DIRECTORY_IFD2(true, TiffDirectoryConstants.DIRECTORY_TYPE_DIR_2, "IFD2"), + /** TIFF directory: IFD3. */ TIFF_DIRECTORY_IFD3(true, TiffDirectoryConstants.DIRECTORY_TYPE_DIR_3, "IFD3"), + /** EXIF directory: Interoperability IFD. */ EXIF_DIRECTORY_INTEROP_IFD(false, TiffDirectoryConstants.DIRECTORY_TYPE_INTEROPERABILITY, "Interop IFD"), + + /** EXIF directory: Maker Notes. */ EXIF_DIRECTORY_MAKER_NOTES(false, TiffDirectoryConstants.DIRECTORY_TYPE_MAKER_NOTES, "Maker Notes"), + + /** EXIF directory: EXIF IFD. */ EXIF_DIRECTORY_EXIF_IFD(false, TiffDirectoryConstants.DIRECTORY_TYPE_EXIF, "Exif IFD"), + + /** EXIF directory: GPS IFD. */ EXIF_DIRECTORY_GPS(false, TiffDirectoryConstants.DIRECTORY_TYPE_GPS, "GPS IFD"); + /** EXIF directory: IFD0 (alias). */ public static final TiffDirectoryType EXIF_DIRECTORY_IFD0 = TIFF_DIRECTORY_IFD0; + + /** TIFF directory: Root (alias for IFD0). */ public static final TiffDirectoryType TIFF_DIRECTORY_ROOT = TIFF_DIRECTORY_IFD0; + + /** EXIF directory: IFD1 (alias). */ public static final TiffDirectoryType EXIF_DIRECTORY_IFD1 = TIFF_DIRECTORY_IFD1; + /** EXIF directory: IFD2 (alias). */ public static final TiffDirectoryType EXIF_DIRECTORY_IFD2 = TIFF_DIRECTORY_IFD2; + /** EXIF directory: IFD3 (alias). */ public static final TiffDirectoryType EXIF_DIRECTORY_IFD3 = TIFF_DIRECTORY_IFD3; + /** EXIF directory: Sub IFD (alias for IFD1). */ public static final TiffDirectoryType EXIF_DIRECTORY_SUB_IFD = TIFF_DIRECTORY_IFD1; + /** EXIF directory: Sub IFD1 (alias for IFD2). */ public static final TiffDirectoryType EXIF_DIRECTORY_SUB_IFD1 = TIFF_DIRECTORY_IFD2; + + /** EXIF directory: Sub IFD2 (alias for IFD3). */ public static final TiffDirectoryType EXIF_DIRECTORY_SUB_IFD2 = TIFF_DIRECTORY_IFD3; + + /** EXIF directory: Unknown. */ public static final TiffDirectoryType EXIF_DIRECTORY_UNKNOWN = null; + /** + * Gets the EXIF directory type for the given type code. + * + * @param type the directory type code. + * @return the directory type, or {@link #EXIF_DIRECTORY_UNKNOWN} if not found. + */ public static TiffDirectoryType getExifDirectoryType(final int type) { for (final TiffDirectoryType tiffDirectoryType : values()) { @@ -55,7 +89,11 @@ public enum TiffDirectoryType { } private final boolean isImageDirectory; + + /** The directory type code. */ public final int directoryType; + + /** The directory name. */ public final String name; TiffDirectoryType(final boolean isImageDirectory, final int directoryType, final String name) { @@ -64,6 +102,11 @@ public enum TiffDirectoryType { this.name = name; } + /** + * Checks if this is an image directory. + * + * @return {@code true} if this is an image directory. + */ public boolean isImageDirectory() { return isImageDirectory; } diff --git a/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffEpTagConstants.java b/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffEpTagConstants.java index af4c8c51..de379645 100644 --- a/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffEpTagConstants.java +++ b/src/main/java/org/apache/commons/imaging/formats/tiff/constants/TiffEpTagConstants.java @@ -37,65 +37,111 @@ import org.apache.commons.imaging.formats.tiff.taginfos.TagInfoUndefineds; */ public final class TiffEpTagConstants { + /** EXIF tag: CFA Repeat Pattern Dimension. */ public static final TagInfoShorts EXIF_TAG_CFAREPEAT_PATTERN_DIM = new TagInfoShorts("CFARepeatPatternDim", 0x828d, 2, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: CFA Pattern 2. */ public static final TagInfoBytes EXIF_TAG_CFAPATTERN_2 = new TagInfoBytes("CFAPattern2", 0x828e, -1, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Battery Level. */ public static final TagInfoAsciiOrRational EXIF_TAG_BATTERY_LEVEL = new TagInfoAsciiOrRational("BatteryLevel", 0x828f, -1, TiffDirectoryType.TIFF_DIRECTORY_ROOT); + /** EXIF tag: Inter Color Profile. */ public static final TagInfoUndefineds EXIF_TAG_INTER_COLOR_PROFILE = new TagInfoUndefineds("InterColorProfile", 0x8773, -1, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Interlace. */ public static final TagInfoShort EXIF_TAG_INTERLACE = new TagInfoShort("Interlace", 0x8829, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Time Zone Offset. */ public static final TagInfoSShorts EXIF_TAG_TIME_ZONE_OFFSET = new TagInfoSShorts("TimeZoneOffset", 0x882a, -1, TiffDirectoryType.EXIF_DIRECTORY_EXIF_IFD); + /** EXIF tag: Self Timer Mode. */ public static final TagInfoShort EXIF_TAG_SELF_TIMER_MODE = new TagInfoShort("SelfTimerMode", 0x882b, TiffDirectoryType.EXIF_DIRECTORY_EXIF_IFD); + /** EXIF tag: Flash Energy. */ public static final TagInfoRationals EXIF_TAG_FLASH_ENERGY = new TagInfoRationals("FlashEnergy", 0x920b, -1, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Spatial Frequency Response. */ public static final TagInfoUndefineds EXIF_TAG_SPATIAL_FREQUENCY_RESPONSE_1 = new TagInfoUndefineds("SpatialFrequencyResponse", 0x920c, -1, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Noise. */ public static final TagInfoUndefineds EXIF_TAG_NOISE_1 = new TagInfoUndefineds("Noise", 0x920d, -1, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Focal Plane X Resolution. */ public static final TagInfoRational EXIF_TAG_FOCAL_PLANE_XRESOLUTION = new TagInfoRational("FocalPlaneXResolution", 0x920e, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Focal Plane Y Resolution. */ public static final TagInfoRational EXIF_TAG_FOCAL_PLANE_YRESOLUTION = new TagInfoRational("FocalPlaneYResolution", 0x920f, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Focal Plane Resolution Unit. */ public static final TagInfoShort EXIF_TAG_FOCAL_PLANE_RESOLUTION_UNIT = new TagInfoShort("FocalPlaneResolutionUnit", 0x9210, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + + /** Focal plane resolution unit: None. */ public static final int FOCAL_PLANE_RESOLUTION_UNIT_VALUE_NONE = 1; + + /** Focal plane resolution unit: Inches. */ public static final int FOCAL_PLANE_RESOLUTION_UNIT_VALUE_INCHES = 2; + + /** Focal plane resolution unit: Centimeters. */ public static final int FOCAL_PLANE_RESOLUTION_UNIT_VALUE_CM = 3; + + /** Focal plane resolution unit: Millimeters. */ public static final int FOCAL_PLANE_RESOLUTION_UNIT_VALUE_MM = 4; + + /** Focal plane resolution unit: Micrometers. */ public static final int FOCAL_PLANE_RESOLUTION_UNIT_VALUE_UM = 5; + /** EXIF tag: Image Number. */ public static final TagInfoLong EXIF_TAG_IMAGE_NUMBER_EXIF_IFD = new TagInfoLong("ImageNumber", 0x9211, TiffDirectoryType.EXIF_DIRECTORY_EXIF_IFD); + /** EXIF tag: Security Classification. */ public static final TagInfoAscii EXIF_TAG_SECURITY_CLASSIFICATION_EXIF_IFD = new TagInfoAscii("SecurityClassification", 0x9212, -1, TiffDirectoryType.EXIF_DIRECTORY_EXIF_IFD); + /** EXIF tag: Image History. */ public static final TagInfoAscii EXIF_TAG_IMAGE_HISTORY_EXIF_IFD = new TagInfoAscii("ImageHistory", 0x9213, -1, TiffDirectoryType.EXIF_DIRECTORY_EXIF_IFD); + /** EXIF tag: Exposure Index. */ public static final TagInfoRationals EXIF_TAG_EXPOSURE_INDEX = new TagInfoRationals("ExposureIndex", 0x9215, -1, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: TIFF/EP Standard ID. */ public static final TagInfoBytes EXIF_TAG_TIFF_EPSTANDARD_ID_1 = new TagInfoBytes("TIFF/EPStandardID", 0x9216, 4, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + /** EXIF tag: Sensing Method. */ public static final TagInfoShort EXIF_TAG_SENSING_METHOD = new TagInfoShort("SensingMethod", 0x9217, TiffDirectoryType.EXIF_DIRECTORY_UNKNOWN); + + /** Sensing method: Monochrome area. */ public static final int SENSING_METHOD_VALUE_MONOCHROME_AREA = 1; + + /** Sensing method: One-chip color area. */ public static final int SENSING_METHOD_VALUE_ONE_CHIP_COLOR_AREA = 2; + + /** Sensing method: Two-chip color area. */ public static final int SENSING_METHOD_VALUE_TWO_CHIP_COLOR_AREA = 3; + + /** Sensing method: Three-chip color area. */ public static final int SENSING_METHOD_VALUE_THREE_CHIP_COLOR_AREA = 4; + + /** Sensing method: Color sequential area. */ public static final int SENSING_METHOD_VALUE_COLOR_SEQUENTIAL_AREA = 5; + + /** Sensing method: Monochrome linear. */ public static final int SENSING_METHOD_VALUE_MONOCHROME_LINEAR = 6; + + /** Sensing method: Trilinear. */ public static final int SENSING_METHOD_VALUE_TRILINEAR = 7; + + /** Sensing method: Color sequential linear. */ public static final int SENSING_METHOD_VALUE_COLOR_SEQUENTIAL_LINEAR = 8; + /** List of all TIFF/EP tags. */ public static final List<TagInfo> ALL_TIFF_EP_TAGS = Collections.unmodifiableList(Arrays.asList(EXIF_TAG_CFAREPEAT_PATTERN_DIM, EXIF_TAG_CFAPATTERN_2, EXIF_TAG_BATTERY_LEVEL, EXIF_TAG_INTER_COLOR_PROFILE, EXIF_TAG_INTERLACE, EXIF_TAG_TIME_ZONE_OFFSET, EXIF_TAG_SELF_TIMER_MODE, EXIF_TAG_FLASH_ENERGY, EXIF_TAG_SPATIAL_FREQUENCY_RESPONSE_1, EXIF_TAG_NOISE_1, EXIF_TAG_FOCAL_PLANE_XRESOLUTION, EXIF_TAG_FOCAL_PLANE_YRESOLUTION, diff --git a/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImageParser.java b/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImageParser.java index 7ff77f16..501dca2a 100644 --- a/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImageParser.java @@ -40,7 +40,7 @@ import org.apache.commons.imaging.bytesource.ByteSource; import org.apache.commons.imaging.common.ImageMetadata; /** - * Parser for Wireless Bitmap (WBMP) images. + * Parses Wireless Bitmap (WBMP) images. */ public class WbmpImageParser extends AbstractImageParser<WbmpImagingParameters> { diff --git a/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImagingParameters.java b/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImagingParameters.java index 41695db5..e99a9d46 100644 --- a/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImagingParameters.java +++ b/src/main/java/org/apache/commons/imaging/formats/wbmp/WbmpImagingParameters.java @@ -23,5 +23,11 @@ import org.apache.commons.imaging.ImagingParameters; * @since 1.0-alpha3 */ public class WbmpImagingParameters extends ImagingParameters<WbmpImagingParameters> { - // empty + + /** + * Constructs a new instance. + */ + public WbmpImagingParameters() { + // Default constructor + } } diff --git a/src/main/java/org/apache/commons/imaging/formats/webp/WebPImagingParameters.java b/src/main/java/org/apache/commons/imaging/formats/webp/WebPImagingParameters.java index dc1c7dfd..5c00f485 100644 --- a/src/main/java/org/apache/commons/imaging/formats/webp/WebPImagingParameters.java +++ b/src/main/java/org/apache/commons/imaging/formats/webp/WebPImagingParameters.java @@ -24,4 +24,11 @@ import org.apache.commons.imaging.common.XmpImagingParameters; * @since 1.0.0-alpha4 */ public class WebPImagingParameters extends XmpImagingParameters<WebPImagingParameters> { + + /** + * Constructs a new instance. + */ + public WebPImagingParameters() { + // Default constructor + } } diff --git a/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImageParser.java b/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImageParser.java index 5ca76c33..083dc0e5 100644 --- a/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImageParser.java @@ -47,7 +47,7 @@ import org.apache.commons.imaging.common.BasicCParser; import org.apache.commons.imaging.common.ImageMetadata; /** - * Parser for X BitMap (XBM) image format. + * Parses the X BitMap (XBM) image format. */ public class XbmImageParser extends AbstractImageParser<XbmImagingParameters> { diff --git a/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImagingParameters.java b/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImagingParameters.java index 192d8376..50c56a6a 100644 --- a/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImagingParameters.java +++ b/src/main/java/org/apache/commons/imaging/formats/xbm/XbmImagingParameters.java @@ -23,5 +23,11 @@ import org.apache.commons.imaging.ImagingParameters; * @since 1.0-alpha3 */ public class XbmImagingParameters extends ImagingParameters<XbmImagingParameters> { - // empty + + /** + * Constructs a new instance. + */ + public XbmImagingParameters() { + // Default constructor + } } diff --git a/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImageParser.java b/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImageParser.java index 5bcd7721..24546daf 100644 --- a/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImageParser.java +++ b/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImageParser.java @@ -52,7 +52,7 @@ import org.apache.commons.imaging.palette.SimplePalette; import org.apache.commons.lang3.StringUtils; /** - * Parser for X PixMap (XPM) image format. + * Parses the X PixMap (XPM) image format. */ public class XpmImageParser extends AbstractImageParser<XpmImagingParameters> { diff --git a/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImagingParameters.java b/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImagingParameters.java index 67a9ea33..f6716c9b 100644 --- a/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImagingParameters.java +++ b/src/main/java/org/apache/commons/imaging/formats/xpm/XpmImagingParameters.java @@ -22,5 +22,11 @@ import org.apache.commons.imaging.ImagingParameters; * @since 1.0-alpha3 */ public class XpmImagingParameters extends ImagingParameters<XpmImagingParameters> { - // empty + + /** + * Constructs a new instance. + */ + public XpmImagingParameters() { + // Default constructor + } }
