xymp
/
exiv2
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update EXAMPLES in manpage

Browse Source 
Changes:
+ Fix :basename: and GPS examples
+ Add new examples and update text
+ Format closer to manpage standard
main
postscript-dev 4 years ago
parent fbdb38b959
commit 166b0c3809
No known key found for this signature in database
GPG Key ID: F3EC02A099292862
1 changed files with 99 additions and 70 deletions
Show Stats Download Patch File Download Diff File

169
man/man1/exiv2.1
Unescape Escape View File

@ -865,90 +865,119 @@ The text will now appear when the translated print option is used:
.sp 1 .sp 1
.ne 40 .ne 40
.SH EXAMPLES .SH EXAMPLES
.nf .TP
\fB$ exiv2 *.jpg\fP \fBexiv2\fP \fI*.jpg\fP
.fi Prints a summary of the Exif information for all the JPEG files in the current
Prints a summary of the Exif information for all JPEG files in the directory. The summary is brief and does not use the Family.Group.Tag format. directory (the same as \fBexiv2\fP \fBprint\fP \fI*.jpg\fP). The summary
is brief and does not use the Family.Group.Tagname format.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 -g Date https://clanmills.com/Stonehenge.jpg\fP \fBexiv2\fP \fB--grep\fP \fIdate/i\fP \fIhttps://clanmills.com/Stonehenge.jpg\fP
.fi Prints tags in \fIhttps://clanmills.com/Stonehenge.jpg\fP, where the key
If you use \fB--grep\fP \fIkey\fP, the default output becomes \fB--print\fP \fIa\fP (i.e., Family.Group.Tagname) contains the string \fIdate\fP (\fI/i\fP searches case
insensitive). When not including \fB--print\fP \fImode\fP or
\fB--Print\fP \fIflgs\fP, the default output becomes \fB--print\fP \fIa\fP
(i.e., print all).
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-pi image.jpg\fP \fBexiv2\fP \fB--print\fP \fIi\fP \fIimage.jpg\fP
.fi Prints the IPTC datasets in \fIimage.jpg\fP.
Prints the IPTC metadata of the image.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 rename img_1234.jpg\fP \fBexiv2\fP \fB--Print\fP \fIkytEX\fP \fIimage.jpg\fP
.fi Prints (with finer grained control) the Exif tags and XMP properties in
Renames img_1234.jpg (taken on 13\-Nov\-05 at 22:58:31) to 20051113_225831.jpg \fIimage.jpg\fP. The tag's key (i.e., Family.Group.Tagname), type and
translated value are displayed.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-r'\:basename\:_%Y%m' rename img_1234.jpg\fP \fBexiv2\fP \fBrename\fP \fIimage.jpg\fP
.fi Renames \fIimage.jpg\fP (taken on 13\-Nov\-05 at 22:58:31) to 20051113_225831.jpg.
Renames img_1234.jpg to img_1234_200511.jpg
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-et img1.jpg img2.jpg\fP \fBexiv2\fP \fB--rename\fP \fI":basename:_%Y-%m"\fP \fIimage.jpg\fP
.fi Renames \fIimage.jpg\fP using the basename (i.e., '\fIimage\fP') and values
Extracts the Exif thumbnails from the two files into img1\-thumb.jpg defined in \fBiconv_open\fP(3). e.g., image_2005-11.jpg. The values for time
and img2\-thumb.jpg. and date are taken from the Exif metadata.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-it img1.jpg img2.jpg\fP \fBexiv2\fP \fB--extract\fP \fIt\fP \fIimage1.jpg\fP \fIimage2.jpg\fP
.fi Extracts (copies) the Exif thumbnails from \fIimage1.jpg\fP into
Inserts (copies) metadata from img1.exv to img1.jpg and from img2.exv image1-thumb.jpg and from \fIimage2.jpg\fP into image2-thumb.jpg.
to img2.jpg. .TP
.sp 1 .sp 1
.nf \fBexiv2\fP \fB--insert\fP \fIt\fP \fIimage1.jpg\fP \fIimage2.jpg\fP
\fB$ exiv2 \-ep1,2 image.jpg\fP Inserts (copies) thumbnails image1-thumb.jpg into \fIimage1.jpg\fP and
.fi image2-thumb.jpg into \fIimage2.jpg\fP.
Extracts previews 1 and 2 from image.jpg to the files image\-preview1.jpg
and image\-preview2.jpg.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-eiX image.jpg\fP \fBexiv2\fP \fB--extract\fP \fIp1,2\fP \fIimage.jpg\fP
.fi Extracts (copies) previews 1 and 2 from \fIimage.jpg\fP, into image-preview1.jpg
Extracts IPTC datasets into an XMP sidecar file image.xmp and in the and image-preview2.jpg. Use \fBexiv2\fP \fB--print\fP \fIp\fP \fIimage.jpg\fP
process converts them to "IPTC Core" XMP schema. to display a list of available previews for \fIimage.jpg\fP.
.TP
\fBexiv2\fP \fB--extract\fP \fIX\fP \fIimage.jpg\fP
Extracts (copies) metadata tags from \fIimage.jpg\fP, into an XMP sidecar file,
image.xmp. In the process, this converts selected Exif tags and IPTC datasets to
XMP properties.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-iixX image.jpg\fP \fBexiv2\fP \fB--insert\fP \fIX\fP \fIimage.jpg\fP
.fi Inserts (copies) metadata from an XMP sidecar file, image.xmp, into \fIimage.jpg\fP.
Inserts IPTC and XMP metadata from an XMP sidecar file image.xmp into The resulting Exif tags and IPTC datasets are converted from the equivalent XMP
image.jpg. The resulting IPTC datasets are converted from the "IPTC properties in the sidecar file.
Core" XMP schema properties in the sidecar file to the older IPTC IIM4
format. The inserted XMP properties include those in the "IPTC Core"
XMP schema.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-M"set Exif.Photo.UserComment charset=Ascii New Exif comment" image.jpg\fP \fBexiv2\fP \fB--extract\fP \fIX\fP \fB--Modify\fP "\fIadd Xmp.dc.subject Sunset\fP" \fIimage.jpg\fP
.fi Extracts (copies) metadata tags from \fIimage.jpg\fP, applies \fB--Modify\fP
Sets the Exif comment to an ASCII string. \fIcmd\fP to those tags and then saves in an XMP sidecar file, image.xmp.
While saving, selected Exif tags and IPTC datasets are converted to XMP properties.
Multiple \fB--Modify\fP \fIcmd\fP and \fB--modify\fP \fIcmdfile\fP can be used.
.sp 1 .sp 1
.nf .TP
\fB$ exiv2 \-M"set Exif.GPSInfo.GPSLatitude 4/1 15/1 33/1" \\ \-M"set Exif.GPSInfo.GPSLatitudeRef N" image.jpg\fP \fBexiv2\fP \fB--extract\fP \fIX-\fP \fIimage1.jpg\fP | \fBexiv2\fP \fB--insert\fP \fIX-\fP \fIimage2.jpg\fP
.fi Extracts (copies) the \fIimage1.jpg\fP metadata as XMP sidecar data and
Sets the latitude to 4 degrees, 15 minutes and 33 seconds north. The inserts it directly into \fIimage2.jpg\fP. \fB--Modify\fP \fIcmd\fP and \fB--modify\fP
Exif standard stipulates that the GPSLatitude tag consists of three \fIcmdfile\fP can also be added when extracting from \fIimage1.jpg\fP.
Rational numbers for the degrees, minutes and seconds of the latitude .sp 1
and GPSLatitudeRef contains either 'N' or 'S' for north or south .TP
latitude respectively. \fBexiv2\fP \fBdelete\fP \fIimage.jpg\fP
Deletes all the metadata in \fIimage.jpg\fP
.sp 1
.TP
\fBexiv2\fP \fB--delete\fP \fItC\fP \fIimage.jpg\fP
Deletes the thumbnail and ICC profile in \fIimage.jpg\fP
.sp 1
.TP
\fBexiv2\fP \fB--adjust\fP \fI1:00:00\fP \fIimage.jpg\fP
Adjusts Exif timestamps in \fIimage.jpg\fP, adding 1 hour
.sp 1
.TP
\fBexiv2\fP \fB--Modify\fP \fI"set Exif.Photo.UserComment charset=Ascii New Exif comment"\fP \fIimage.jpg\fP
Sets the Exif comment in \fIimage.jpg\fP, to an ASCII string with the value '\fINew Exif comment\fP'.
.sp 1
.TP
\fBexiv2\fP \fB--Modify\fP \fI"set Exif.GPSInfo.GPSLatitude 4/1 15/1 33/1"\fP \fB--Modify\fP \fI"set Exif.GPSInfo.GPSLatitudeRef N"\fP \fIimage.jpg\fP
Sets the latitude to 4 degrees, 15 minutes and 33 seconds north in
\fIimage.jpg\fP. The Exif standard stipulates that the GPSLatitude
tag consists of three Rational numbers for the degrees, minutes and
seconds of the latitude and GPSLatitudeRef contains either 'N' or 'S'
for north or south latitude respectively.
.TP
\fBexiv2\fP \fB--location\fP \fI/tmp\fP \fB--suffix\fP \fI.CRW\fP \fI/data/*.JPG\fP
Copy all metadata from CRW files in the \fI/tmp\fP directory to JPG files
with corresponding basenames in the \fI/data\fP directory. Note that this
copies metadata as is, without any modifications to adapt it to the
requirements of the target format. Some tags copied like this may not make
sense in the target image.
.sp 1
.TP
\fBexiv2\fP \fBfixiso\fP \fIimage.jpg\fP
Adds the Exif ISO metadata (if missing) to \fIimage.jpg\fP. This is for
Nikon and Canon cameras only and copies the camera maker's value into the Exif
metadata.
.sp 1 .sp 1
.nf
\fB$ exiv2 \-l/tmp -S.CRW insert /data/*.JPG\fP
.fi
Copy all metadata from CRW files in the /tmp directory to JPG files
with corresponding basenames in the /data directory. Note that this
copies metadata as is, without any modifications to adapt it to the
requirements of the target format. Some tags copied like this may not
make sense in the target image.
.SH BUGS .SH BUGS
Report bugs to: \fIhttps://github.com/Exiv2/exiv2/issues\fP Report bugs to: \fIhttps://github.com/Exiv2/exiv2/issues\fP
.SH COPYRIGHT .SH COPYRIGHT
The Exiv2 project is released under the GNU GPLv2 license: \fIhttps://github.com/Exiv2/exiv2/blob/main/COPYING\fP The Exiv2 project is released under the GNU GPLv2 license: \fIhttps://github.com/Exiv2/exiv2/blob/main/COPYING\fP

Write Preview
Loading…
Cancel
Save