Image::ExifTool::TagInfoXML(3pm)

1Image::ExifTool::TagInfUosXeMrL(C3o)ntributed Perl DocumIemnatgaet:i:oEnxifTool::TagInfoXML(3)
2
3
4

NAME

6       Image::ExifTool::TagInfoXML - Read/write tag information XML database
7

DESCRIPTION

9       This module is used to generate an XML database from all ExifTool tag
10       information.  The XML database may then be edited and used to re-
11       generate the language modules (Image::ExifTool::Lang::*).
12

METHODS

14   Write
15       Print complete tag information database in XML format.
16
17         # save list of all tags
18         $success = Image::ExifTool::TagInfoXML::Write('dst.xml');
19
20         # list all IPTC tags to console, including Flags
21         Image::ExifTool::TagInfoXML::Write(undef, 'IPTC', Flags => 1);
22
23         # write all EXIF Camera tags to file
24         Image::ExifTool::TagInfoXML::Write($outfile, 'exif:camera');
25
26       Inputs:
27           0) [optional] Output file name, or undef for console output.
28           Output file will be overwritten if it already exists.
29
30           1) [optional] String of group names separated by colons to specify
31           the group to print.  A specific IFD may not be given as a group,
32           since EXIF tags may be written to any IFD.  Saves all groups if not
33           specified.
34
35           2) [optional] Hash of options values:
36
37               Flags   - Set to output 'flags' attribute
38               NoDesc  - Set to suppress output of descriptions
39               Lang    - Select a single language for output
40
41       Return Value:
42           True on success.
43
44       Sample XML Output:
45
46         <?xml version='1.0' encoding='UTF-8'?>
47         <taginfo>
48
49         <table name='XMP::dc' g0='XMP' g1='XMP-dc' g2='Other'>
50          <desc lang='en'>XMP Dublin Core</desc>
51          <tag id='title' name='Title' type='lang-alt' writable='true' g2='Image'>
52           <desc lang='en'>Title</desc>
53           <desc lang='de'>Titel</desc>
54           <desc lang='fr'>Titre</desc>
55          </tag>
56          ...
57         </table>
58
59         </taginfo>
60
61       Flags (if selected and available) are formatted as a comma-separated
62       list of the following possible values:  Avoid, Binary, List, Mandatory,
63       Permanent, Protected, Unknown and Unsafe.  See the tag name
64       documentation and lib/Image/ExifTool/README for a description of these
65       flags.  For XMP List tags, the list type (Alt, Bag or Seq) is also
66       output as a flag if applicable.
67
68   BuildLangModules
69       Build all Image::ExifTool::Lang modules from an XML database file.
70
71           Image::ExifTool::TagInfoXML::BuildLangModules('src.xml');
72
73       Inputs:
74           0) XML file name
75
76           1) Update flags:
77
78               0x01 = preserve version numbers
79               0x02 = update all modules, even if they didn't change
80               0x04 = update from scratch, ignoring existing definitions
81               0x08 = override existing different descriptions and values
82
83       Return Value:
84           Number of modules updated, or negative on error.
85

AUTHOR

87       Copyright 2003-2023, Phil Harvey (philharvey66 at gmail.com)
88
89       This library is free software; you can redistribute it and/or modify it
90       under the same terms as Perl itself.
91

NAME

DESCRIPTION

METHODS

AUTHOR

SEE ALSO