exiftool-vendored
    Preparing search index...

    Interface CompositeTags

    These are tags are derived from the values of one or more other tags. Only a few are writable directly.

    interface CompositeTags {
        AdvancedSceneMode?: string;
        Aperture?: number;
        AutoFocus?: string;
        AvgBitrate?: string | number;
        BlueBalance?: number;
        CFAPattern?: string;
        CircleOfConfusion?: string;
        ConditionalFEC?: number;
        ContrastDetectAF?: string;
        Copyright?: string;
        Country?: string;
        CreateDate?: string | number | ExifDateTime | ExifDate;
        Creator?: string;
        DateCreated?: string | ExifDateTime;
        DateTimeCreated?: string | ExifDateTime;
        DateTimeOriginal?: string | ExifDateTime;
        Description?: string;
        DigitalCreationDateTime?: string | ExifDateTime;
        DigitalZoom?: string;
        DOF?: string;
        DriveMode?: string;
        Duration?: number;
        ExtenderStatus?: string;
        FileNumber?: string;
        Flash?: string;
        FlashType?: string;
        FocalLength35efl?: string;
        FocusDistance?: string;
        FOV?: string;
        GPSAltitude?: number;
        GPSAltitudeRef?: number;
        GPSDateTime?: string | ExifDateTime;
        GPSDestLatitude?: string;
        GPSDestLongitude?: string;
        GPSLatitude?: string | number;
        GPSLatitudeRef?: string;
        GPSLongitude?: string | number;
        GPSLongitudeRef?: string;
        GPSPosition?: string;
        HyperfocalDistance?: string;
        ImageHeight?: number;
        ImageSize?: string | number;
        ImageWidth?: number;
        ISO?: number;
        Keywords?: string | string[];
        Lens?: string;
        Lens35efl?: string;
        LensID?: string;
        LensSpec?: string;
        LensType?: string;
        LightValue?: number;
        Megapixels?: number;
        ModifyDate?: string | ExifDateTime;
        Orientation?: number;
        OriginalDecisionData?: string | BinaryField;
        PeakSpectralSensitivity?: string;
        PhaseDetectAF?: string;
        PreviewImage?: BinaryField;
        PreviewImageSize?: string;
        Rating?: number;
        RedBalance?: number;
        RedEyeReduction?: string;
        RicohPitch?: number;
        RicohRoll?: number;
        Rotation?: number;
        RunTimeSincePowerUp?: string;
        ScaleFactor35efl?: number;
        ShootingMode?: string;
        ShutterCurtainHack?: string;
        ShutterSpeed?: string;
        State?: string;
        SubSecCreateDate?: string | ExifDateTime;
        SubSecDateTimeOriginal?: string | ExifDateTime;
        SubSecModifyDate?: string | ExifDateTime;
    }

    Hierarchy (View Summary)

    Index

    Properties

    AdvancedSceneMode?: string

    🔥 ☆☆☆☆ (2%)

    Composite

    "Unknown (49 5)"
    
    Aperture?: number

    🔥 ★★★★ (90%)

    APP, Composite, MakerNotes

    90
    

    Calculated aperture value derived from FNumber or ApertureValue. Read-only composite tag. To write, modify FNumber or ApertureValue instead.

    AutoFocus?: string

    🔥 ★☆☆☆ (6%)

    Composite

    "On"
    
    AvgBitrate?: string | number

    🔥 ☆☆☆☆ (0%)

    Composite

    "8.82 Mbps"
    

    Average bitrate for video/audio files, calculated from media data size divided by duration. Read-only composite tag for QuickTime-based formats (MOV, MP4, etc.).

    BlueBalance?: number

    🔥 ★★☆☆ (10%)

    Composite, MakerNotes

    46
    
    CFAPattern?: string

    🔥 ☆☆☆☆ (3%)

    Composite, EXIF

    "[Red,Green][Green,Blue]"
    
    CircleOfConfusion?: string

    🔥 ★★★★ (50%)

    Composite

    "1.030 mm"
    
    ConditionalFEC?: number

    🔥 ☆☆☆☆ (2%)

    Composite

    0
    
    ContrastDetectAF?: string

    🔥 ☆☆☆☆ (2%)

    Composite

    "On"
    
    Copyright?: string

    🔥 ★★★☆ (20%)

    Composite, EXIF, MakerNotes

    "© Chuckles McSnortypants, Inc."
    

    Copyright notice for the image. MWG composite tag that reconciles EXIF:Copyright, IPTC:CopyrightNotice, and XMP-dc:Rights. Writing updates all three locations to maintain MWG synchronization.

    Country?: string

    🔥 ☆☆☆☆ (1%)

    Composite, MakerNotes, XMP

    "United States"
    
    CreateDate?: string | number | ExifDateTime | ExifDate

    🔥 ★★★★ (90%)

    Composite, EXIF, MakerNotes, QuickTime, XMP

    "2218:09:22 02:32:14"
    

    When an image was digitized (captured by camera sensor). MWG composite tag that reconciles EXIF:CreateDate, IPTC digital creation fields, and XMP-xmp:CreateDate. Distinct from DateTimeOriginal (when photo was taken) - useful for scanned images. For MOV/MP4 videos, use CreateDate instead of DateTimeOriginal.

    Creator?: string

    🔥 ☆☆☆☆ (1%)

    Composite, XMP

    "www.jaro.ch"
    
    DateCreated?: string | ExifDateTime

    🔥 ☆☆☆☆ (4%)

    Composite, IPTC, XMP

    "2025:08:23"
    
    DateTimeCreated?: string | ExifDateTime

    🔥 ☆☆☆☆ (3%)

    Composite

    "2025:08:23 19:41:40-04:00"
    

    Composite tag combining IPTC:DateCreated (YYYYMMDD) and IPTC:TimeCreated (with timezone offset). Read-only composite - to write, set IPTC:DateCreated and IPTC:TimeCreated individually.

    DateTimeOriginal?: string | ExifDateTime

    🔥 ★★★★ (100%)

    APP, Composite, EXIF, MakerNotes, RIFF, XMP

    "2218:09:22 02:32:14"
    

    When a photo was taken (shutter actuation time). MWG composite tag that reconciles EXIF:DateTimeOriginal, IPTC date/time created, and XMP-photoshop DateTimeOriginal. This is the most commonly used timestamp for photos. Different from CreateDate (digitization) and ModifyDate (file modification).

    Description?: string

    🔥 ★★★☆ (20%)

    Composite, XMP

    "Философский дворик, рельефы ТЅv, 1970"
    

    Image caption or description. MWG composite tag that reconciles EXIF:ImageDescription, IPTC:Caption-Abstract, and XMP-dc:Description. Writing updates all three locations for MWG compliance. Supports language variants via RFC 3066 codes (e.g., 'Description-fr').

    DigitalCreationDateTime?: string | ExifDateTime

    🔥 ☆☆☆☆ (0%)

    Composite

    "2025:02:19 17:21:26+00:00"
    
    DigitalZoom?: string

    🔥 ★★★☆ (30%)

    APP, Composite, MakerNotes

    "undef.0"
    
    DOF?: string

    🔥 ★★☆☆ (20%)

    Composite

    "inf (9.66 m - inf)"
    

    Calculated depth of field based on focal length, aperture, and focus distance. WARNING: This value may be incorrect if the image has been resized. Read-only composite tag.

    DriveMode?: string

    🔥 ★★☆☆ (20%)

    Composite, MakerNotes

    "Video; n/a; Shutter Button; Video"
    
    Duration?: number

    🔥 ☆☆☆☆ (0%)

    Composite, QuickTime, XMP

    9.5095
    
    ExtenderStatus?: string

    🔥 ☆☆☆☆ (2%)

    Composite, MakerNotes

    "Not attached"
    
    FileNumber?: string

    🔥 ★★☆☆ (10%)

    Composite, MakerNotes

    "986-8698"
    
    Flash?: string

    🔥 ★★★★ (90%)

    APP, Composite, EXIF, MakerNotes, XMP

    "Unknown (0xffff)"
    
    FlashType?: string

    🔥 ★☆☆☆ (6%)

    Composite, MakerNotes

    "Optional,TTL"
    
    FocalLength35efl?: string

    🔥 ★★★★ (80%)

    Composite

    "99.7 mm (35 mm equivalent: 554.0 mm)"
    
    FocusDistance?: string

    🔥 ★☆☆☆ (5%)

    APP, Composite, MakerNotes, XMP

    "inf"
    
    FOV?: string

    🔥 ★★★★ (50%)

    Composite

    "97.7 deg"
    
    GPSAltitude?: number

    🔥 ☆☆☆☆ (3%)

    APP, Composite, EXIF, XMP

    99.8
    
    GPSAltitudeRef?: number

    🔥 ☆☆☆☆ (4%)

    Composite, EXIF, XMP

    "Unknown (Sea level reference)"
    

    GPS altitude reference. Valid values: 0 (above sea level), 1 (below sea level)

    GPSDateTime?: string | ExifDateTime

    🔥 ☆☆☆☆ (3%)

    Composite, XMP

    "2025:09:20 15:27:20Z"
    

    GPS timestamp combining GPSDateStamp and GPSTimeStamp fields. Read-only composite from multiple GPS sources including manufacturer-specific implementations.

    GPSDestLatitude?: string

    🔥 ☆☆☆☆ (0%)

    Composite, EXIF

    "43 deg 37' 59.61" N"
    
    GPSDestLongitude?: string

    🔥 ☆☆☆☆ (0%)

    Composite, EXIF

    "80 deg 23' 16.31" W"
    
    GPSLatitude?: string | number

    🔥 ☆☆☆☆ (4%)

    APP, Composite, EXIF, XMP

    48.857748
    
    GPSLatitudeRef?: string

    🔥 ☆☆☆☆ (4%)

    APP, Composite, EXIF

    "Unknown ()"
    

    GPS latitude hemisphere. Valid values: 'N' (North), 'S' (South)

    GPSLongitude?: string | number

    🔥 ☆☆☆☆ (4%)

    APP, Composite, EXIF, XMP

    2.2918888
    
    GPSLongitudeRef?: string

    🔥 ☆☆☆☆ (4%)

    APP, Composite, EXIF, XMP

    "West"
    

    GPS longitude hemisphere. Valid values: 'E' (East), 'W' (West)

    GPSPosition?: string

    🔥 ☆☆☆☆ (4%)

    Composite, EXIF

    "7.196465 134.376806666667"
    
    HyperfocalDistance?: string

    🔥 ★★★★ (50%)

    Composite

    "Inf m"
    
    ImageHeight?: number

    🔥 ★★★★ (100%)

    APP, Composite, EXIF, File, MakerNotes, QuickTime, RIFF, XMP

    960
    

    Image height in pixels. Not stored metadata - intrinsic file property. Read-only composite derived from file analysis.

    ImageSize?: string | number

    🔥 ★★★★ (100%)

    APP, Composite

    "9728x6656"
    

    Image dimensions combining width and height from various metadata fields. Read-only composite derived from ImageWidth, ImageHeight, ExifImageWidth, ExifImageHeight, or RawImageCroppedSize.

    ImageWidth?: number

    🔥 ★★★★ (100%)

    APP, Composite, EXIF, File, MakerNotes, QuickTime, RIFF, XMP

    9728
    

    Image width in pixels. Not stored metadata - intrinsic file property. Read-only composite derived from file analysis.

    ISO?: number

    🔥 ★★★★ (70%)

    Composite, EXIF, MakerNotes, XMP

    993
    

    Camera ISO sensitivity rating. In EXIF, this is an array (int16u[n]) that can contain multiple values. Historically called ISOSpeedRatings in EXIF 2.2, renamed to PhotographicSensitivity in EXIF 2.3.

    Keywords?: string | string[]

    🔥 ☆☆☆☆ (0%)

    Composite, IPTC

    ["点像F11"]
    

    Searchable subject terms for image content. MWG composite tag that reconciles IPTC:Keywords and XMP-dc:Subject. Multi-value fields use semicolon-space ('; ') separators when represented as string. IPTC constraint: max 64 characters per keyword. Character encoding depends on IPTC:CodedCharacterSet; UTF8 recommended.

    Lens?: string

    🔥 ★★☆☆ (20%)

    Composite, MakerNotes, XMP

    "smc PENTAX-FA 43mm F1.9 Limited"
    

    Lens identification from focal length range, primarily for Canon cameras. Read-only composite. For more detailed lens identification, see LensID.

    Lens35efl?: string

    🔥 ★★☆☆ (10%)

    Composite

    "9.2 - 92.0 mm (35 mm equivalent: 24.9 - 248.8 mm)"
    
    LensID?: string

    🔥 ★★★☆ (20%)

    Composite, MakerNotes, XMP

    "smc PENTAX-FA 43mm F1.9 Limited"
    

    Identifies actual lens model using manufacturer-specific lookup tables from partial type information. Configurable: may be extended with user-defined lenses via ExifTool configuration. Different derivation logic for Canon (focal lengths), Nikon (LensIDNumber), Ricoh (LensFirmware), and others (XMP-aux:LensID). Read-only composite.

    LensSpec?: string

    🔥 ☆☆☆☆ (5%)

    Composite, MakerNotes

    "Unknown (00 0 0 0 0 00)"
    
    LensType?: string

    🔥 ★★☆☆ (20%)

    Composite, MakerNotes

    "smc PENTAX-FA 43mm F1.9 Limited"
    
    LightValue?: number

    🔥 ★★★★ (70%)

    Composite

    9.9
    
    Megapixels?: number

    🔥 ★★★★ (100%)

    Composite

    9.5
    

    Total megapixels calculated from ImageSize composite field. Read-only composite.

    ModifyDate?: string | ExifDateTime

    🔥 ★★★★ (90%)

    Composite, EXIF, QuickTime, XMP

    "2216:02:28 03:49:50"
    

    When the file was last modified by a user (not automatic processes). MWG composite tag that reconciles EXIF:ModifyDate and XMP-xmp:ModifyDate. Should reflect intentional user edits, not automatic metadata updates. Different from file system modification time.

    Orientation?: number

    🔥 ★★★★ (90%)

    Composite, EXIF, PanasonicRaw, XMP

    8
    

    Image orientation. MWG composite tag from EXIF:Orientation. Valid values: 1 (Horizontal/normal), 2 (Mirror horizontal), 3 (Rotate 180°), 4 (Mirror vertical), 5 (Mirror horizontal + rotate 270° CW), 6 (Rotate 90° CW), 7 (Mirror horizontal + rotate 90° CW), 8 (Rotate 270° CW) Note: Most images use values 1, 3, 6, and 8.

    OriginalDecisionData?: string | BinaryField

    🔥 ☆☆☆☆ (0%)

    Composite

    "(Binary data 512 bytes, use -b option to extract)"
    
    PeakSpectralSensitivity?: string

    🧊 ☆☆☆☆ (1%)

    Composite

    "9.9 um"
    
    PhaseDetectAF?: string

    🔥 ☆☆☆☆ (1%)

    Composite, MakerNotes

    "On (73-point)"
    
    PreviewImage?: BinaryField

    🔥 ★★★☆ (30%)

    Composite, EXIF, File, FlashPix, MPF, MakerNotes, QuickTime

    "(Binary data 37244 bytes, use -b option to extract)"
    

    Embedded preview image data extracted from the file. CRITICAL: Writable for updating existing embedded images, but cannot create or delete previews. Can only modify previews that already exist in the file.

    PreviewImageSize?: string

    🔥 ★☆☆☆ (9%)

    Composite, MakerNotes

    "816x459"
    
    Rating?: number

    🔥 ★★☆☆ (10%)

    Composite, EXIF, MakerNotes, XMP

    5
    

    Star rating for the image. MWG composite tag from XMP-xmp:Rating. Valid values: -1 (rejected), 0 (unrated), 1-5 (star rating) Note: Rating may appear in EXIF but that's non-standard per MWG. Only XMP writes are supported.

    RedBalance?: number

    🔥 ★★☆☆ (10%)

    Composite, MakerNotes

    38.625
    
    RedEyeReduction?: string

    🔥 ☆☆☆☆ (3%)

    Composite, MakerNotes

    "On"
    
    RicohPitch?: number

    🧊 ☆☆☆☆ (0%)

    Composite

    11.2
    
    RicohRoll?: number

    🧊 ☆☆☆☆ (0%)

    Composite

    1.59
    
    Rotation?: number

    🔥 ★☆☆☆ (6%)

    Composite, MakerNotes

    "Unknown (0)"
    

    Degrees of clockwise camera rotation for QuickTime/MP4 video files. Special writable: Writing this tag updates QuickTime MatrixStructure for all tracks with a non-zero image size simultaneously. Different from EXIF Orientation tag.

    RunTimeSincePowerUp?: string

    🔥 ☆☆☆☆ (1%)

    Composite

    "9:30:01"
    
    ScaleFactor35efl?: number

    🔥 ★★★★ (50%)

    Composite

    9.9
    
    ShootingMode?: string

    🔥 ★★☆☆ (20%)

    Composite, MakerNotes

    "Unknown (83)"
    
    ShutterCurtainHack?: string

    🔥 ☆☆☆☆ (3%)

    Composite

    "1st-curtain sync"
    
    ShutterSpeed?: string

    🔥 ★★★★ (90%)

    Composite, MakerNotes

    "inf"
    

    Shutter speed combining ExposureTime, ShutterSpeedValue, and BulbDuration. Read-only composite tag. Format typically fractional (e.g., '1/250').

    State?: string

    🔥 ☆☆☆☆ (1%)

    Composite, MakerNotes, XMP

    "Washington"
    
    SubSecCreateDate?: string | ExifDateTime

    🔥 ★★☆☆ (10%)

    Composite

    "2025:09:20 15:00:47+02:00"
    

    Creation date with subsecond precision, merging EXIF:CreateDate, SubSecTimeDigitized, and OffsetTimeDigitized. Writable composite: writing updates all three fields simultaneously for high-precision timestamps with timezone information.

    SubSecDateTimeOriginal?: string | ExifDateTime

    🔥 ★★☆☆ (10%)

    Composite

    "2025:09:20 15:00:47+02:00"
    

    Original datetime with subsecond precision, combining EXIF:DateTimeOriginal, SubSecTimeOriginal, and OffsetTimeOriginal. Writable composite: writing updates all three fields simultaneously. Represents when the photo was originally taken with high precision.

    SubSecModifyDate?: string | ExifDateTime

    🔥 ★★☆☆ (10%)

    Composite

    "2025:09:20 15:00:47+02:00"
    

    Modification timestamp with subsecond precision, combining EXIF:ModifyDate, SubSecTime, and OffsetTime. Writable composite: writing updates all three fields simultaneously. Represents when the file was last modified with high precision.