Package‘exiftoolr’
October18,2023
Type Package
Title ExifTool Functionality from R
Version0.2.3
Date2023-10-17
Maintainer Joshua O'Brien<*********************>
Description Reads,writes,and edits EXIF and otherfile metadata using ExifTool</>,returning read results as
a data frame.ExifTool supports many different metadata formats
including EXIF,GPS,IPTC,XMP,JFIF,GeoTIFF,ICC Profile,
Photoshop IRB,FlashPix,AFCP and ID3,Lyrics3,as well as the
maker notes of many digital cameras by Canon,Casio,DJI,FLIR,
FujiFilm,GE,GoPro,HP,JVC/Victor,Kodak,Leaf,
Minolta/Konica-Minolta,Motorola,Nikon,Nintendo,Olympus/Epson, Panasonic/Leica,Pentax/Asahi,Phase One,Reconyx,Ricoh,Samsung, Sanyo,Sigma/Foveon and Sony.
License GPL-2
URL github/JoshOBrien/exiftoolr#readme, joshobrien.github.io/exiftoolr/
BugReports github/JoshOBrien/exiftoolr/issues SystemRequirements Perl
Depends R(>=3.0.0)
Imports backports,curl,jsonlite,zip,data.table
Encoding UTF-8
Language en-US
RoxygenNote7.2.3
NeedsCompilation no
Author Joshua O'Brien[aut,cre]
Repository CRAN
Date/Publication2023-10-1723:30:02UTC
1
2configure_exiftoolr R topics documented:
configure_exiftoolr (2)
exif_call (3)
exif_read (4)
install_exiftool (6)
Index8 configure_exiftoolr Configure package to point to ExifTool and/or Perl
Description
Configure package to point to ExifTool and/or Perl
Usage
configure_exiftoolr(
command=NULL,
perl_path=NULL,
allow_win_exe=TRUE,
quiet=FALSE
)
Arguments
command Character string giving the exiftool command.
perl_path Path to a Perl executable.
allow_win_exe Logical.If running on a Windows machine,and if a standalone exiftool exe-cutable is available,should it be used?
quiet Logical.Should function should be chatty?
Value
A character string giving the exiftool command,returned invisibly.
exif_call3 exif_call Call ExifTool from R
Description
Uses system2()to run a basic call to exiftool.
Usage
exif_call(
args=NULL,
path=NULL,
stdout=TRUE,
quiet=FALSE,
truncated zip file怎么解决...,
config_file=NULL,
common_args=NULL
)
exif_version(quiet=TRUE)
Arguments
args Character vector of arguments,each written in same form as you would if writ-ing them on the command "-n"or"-csv")
path A character vector giving one or morefile paths.
stdout Where output to stdout should be sent.If TRUE(the default),the output is cap-tured in a character vector.For other options,see the helpfile for system2,the
function to which this argument’s value gets passed along.
quiet Use FALSE to display diagnostic information.Default value is FALSE.
...Additional arguments to be passed to system2().
config_file Path to a configfile of the format expected by Exiftool’s command line-config option.(See Details for an explanation of why this one option cannot be passed
directly to args via the-config argument.)
common_args A character vector of arguments to be applied to all executed commands when the Exiftool-execute option is being used.(See Details for an explanation of
why this option cannot be passed directly to args via-common_args argument.) Details
For examples of the command-line calls to ExifTool(all of which can be reproduced by calls to exif_call),see /examples.html.
Under the hood,exif_call()writes the options in args to a textfile and then calls Exiftool, passing that textfile’s contents to Exiftool via its-@ARGFILE option.-config and-common_args are the two options that may not be used in such a-@ARGFILE,so we handle that option separately using exif_call()’s config_file argument.
Value
The standard output as a character vector.
Examples
##Not run:
##Find local ExifTool version using exif_version()or exif_call()
exif_version()
exif_call(args="-ver")
##Make temporary copies of a couple jpeg files
tmpdir<-tempdir()
src_files<-dir(system.file(package="exiftoolr","images"),
full.names=TRUE)
files<-file.path(tmpdir,basename(src_files))
##Both of the following extract the same tags:
exif_read(files,tags=c("filename","imagesize"))
exif_call(args=c("-n","-j","-q","-filename","-imagesize"),
path=files)
##Set value of a new"Artist"field in photo s metadata
file1<-files[1]
exif_read(file1,tags="artist")
exif_call(path=file1,args="-Artist=me")
exif_read(file1,tags="artist")
##Remove all but a few essential fields
length(exif_read(file1))
exif_call(path=file1,args="-all=")
length(exif_read(file1))
exif_read(file1)
##Clean up
unlink(files)
##End(Not run)
exif_read Read EXIF and other metadata fromfiles
Description
Reads EXIF and other metadata into a data.frame by calling Phil Harvey’s ExifTool command-line application.
Usage
exif_read(
path,
tags=NULL,
recursive=FALSE,
args=NULL,
quiet=TRUE,
pipeline=c("json","csv")
)
Arguments
path A vector offilenames.
tags A vector of tags to output.It is a good idea to specify this when reading large numbers offiles,as it decreases the output overhead significantly.Spaces will
be stripped in the output data frame.This parameter is not case-sensitive.
recursive TRUE to pass the"-r"option to ExifTool.
args Additional arguments.
quiet Use FALSE to display diagnostic information.Default value is TRUE
pipeline One of"json"(the default)or"csv".Controls whether the exiftool executable, behind the scenes,extracts metadata into a JSON data structure or a tabular csv.
The JSON pipeline works well in most cases,but(as documented at https:
///exiftool_pod.html)does not properly handle non-UTF-8
character sets.If the metadatafields include characters that are not encoded
using UTF-8and that need to be handled by setting the"-charset"option,use
the"csv"pipeline as demonstrated in the second example below.
Details
From the ExifTool website:"ExifTool is a platform-independent Perl library plus a command-line application for reading,writing and editing meta information in a wide variety offiles.ExifTool sup-ports many different metadata formats including EXIF,GPS,IPTC,XMP,JFIF,GeoTIFF,ICC Pro-file,Photoshop IRB,FlashPix,AFCP and ID3,as well as the maker notes of many digital cameras by Canon,Casio,DJI,FLIR,FujiFilm,GE,GoPro,HP,JVC/Victor,Kodak,Leaf,Minolta/Konica-Minolta,Motorola,Nikon,Nintendo,Olympus/Epson,Panasonic/Leica,Pentax/Asahi,Phase One, Reconyx,Ricoh,Samsung,Sanyo,Sigma/Foveon and Sony."
For more information,see the ExifTool website.
Value
A data frame of class"exiftoolr"with one row perfile processed.Thefirst column,named
"SourceFile"gives the name(s)of the processedfiles.Subsequent columns contain info from the tags read from thosefiles.
Note that binary tags such as thumbnails are loaded as base64-encoded strings that start with "base64:".Although these are truncated in the printed representation of the data.frame returned by the function,they are left unaltered in the data.frame itself.

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。