1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/im.convert.R
\name{im.convert}
\alias{im.convert}
\alias{gm.convert}
\title{A wrapper for the `convert' utility of ImageMagick or GraphicsMagick}
\usage{
im.convert(
files,
output = "animation.gif",
convert = c("magick", "convert", "gm convert"),
cmd.fun = if (.Platform$OS.type == "windows") shell else system,
extra.opts = "",
clean = FALSE
)
gm.convert(..., convert = "gm convert")
}
\arguments{
\item{files}{either a character vector of file names, or a single string
containing wildcards (e.g. \file{Rplot*.png})}
\item{output}{the file name of the output (with proper extensions, e.g.
\code{gif})}
\item{convert}{the \command{convert} command; it must be \code{'magick'},
\code{'convert'} or \code{'gm convert'}; and it can be pre-specified as an
option in \code{\link{ani.options}('convert')}, e.g. (Windows users)
\code{ani.options(convert = 'c:/program
files/imagemagick/convert.exe')}, or (Mac users) \code{ani.options(convert
= '/opt/local/bin/convert')}; see the Note section for more details}
\item{cmd.fun}{a function to invoke the OS command; by default
\code{\link{system}}}
\item{extra.opts}{additional options to be passed to \command{convert} (or
\command{gm convert})}
\item{clean}{logical: delete the input \code{files} or not}
\item{...}{arguments to be passed to \code{\link{im.convert}}}
}
\value{
The command for the conversion.
If \code{ani.options('autobrowse') == TRUE}, this function will also try to
open the output automatically.
}
\description{
The main purpose of these two functions is to create GIF animations.
}
\details{
The function \code{im.convert} simply wraps the arguments of the
\command{convert} utility of ImageMagick to make it easier to call
ImageMagick in R;
The function \code{gm.convert} is a wrapper for the command
\command{gm convert} of GraphicsMagick.
}
\note{
If \code{files} is a character vector, please make sure the order of
filenames is correct! The first animation frame will be \code{files[1]},
the second frame will be \code{files[2]}, ...
Both ImageMagick and GraphicsMagick may have a limit on the number of
images to be converted. It is a known issue that this function can fail
with more than (approximately) 9000 images. The function
\code{\link{saveVideo}} is a better alternative in such a case.
Most Windows users do not have read the boring notes below after they have
installed ImageMagick or GraphicsMagick. For the rest of Windows users:
\describe{
\item{\strong{ImageMagick users}}{Please install ImageMagick from
\url{http://www.imagemagick.org}, and make sure the the path to
\command{convert.exe} is in your \code{'PATH'} variable, in which case the
command \command{convert} can be called without the full path. Windows
users are often very confused about the ImageMagick and \code{'PATH'}
setting, so I'll try to search for ImageMagick in the Registry Hive by
\code{readRegistry('SOFTWARE\ImageMagick\Current')$BinPath}, thus you might
not really need to modify your \code{'PATH'} variable.
For Windows users who have installed LyX, I will also try to find the
\command{convert} utility in the LyX installation directory, so they do not
really have to install ImageMagick if LyX exists in their system (of
course, the LyX should be installed with ImageMagick).
Once the \command{convert} utility is found, the animation option
\code{'convert'} will be set (\code{ani.options(convert =
'path/to/convert.exe')}); this can save time for searching for
\command{convert} in the operating system next time. }
\item{\strong{GraphicsMagick users}}{During the installation of
GraphicsMagick, you will be asked if you allow it to change the PATH
variable; please do check the option. }
}
A reported problem is \code{cmd.fun = shell} might not work under Windows
but \code{cmd.fun = system} works fine. Try this option in case of
failures.
}
\references{
Examples at \url{https://yihui.org/animation/example/im-convert/}
ImageMagick: \url{http://www.imagemagick.org/script/convert.php}
GraphicsMagick: \url{http://www.graphicsmagick.org}
}
\seealso{
Other utilities:
\code{\link{saveGIF}()},
\code{\link{saveHTML}()},
\code{\link{saveLatex}()},
\code{\link{saveSWF}()},
\code{\link{saveVideo}()}
}
\author{
Yihui Xie
}
\concept{utilities}
|
