~ubuntu-branches/ubuntu/intrepid/graphicsmagick/intrepid : revision 1

1

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"

2

"http://www.w3.org/TR/html4/loose.dtd">

3

<html>

4

<head>

5

6

<title>GraphicsMagick GM Utility</title>

7

<style>

8

<!--

9

@page { size: 8.5in 11in }

10

TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 14pt }

11

P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 14pt }

12

A:link { color: #0085c0 }

13

A:visited { color: #800080 }

14

-->

15

</style>

16

17

</head>

18

19

20

21

22

23

24

25

26

<tr>

27

28

<p ALIGN=LEFT>[<a HREF="../">Home</a>] [<a HREF="mission.html">Mission

29

Statement</a>] [<a HREF="development.html">Development

30

Process</a>] [<a HREF="contribute.html">Contribute</a>]

31

[<a HREF="download.html">Download</a>] [<a HREF="install.html">Installation</a>]

32

[<a HREF="cvs.html">CVS</a>] [<a HREF="http://sourceforge.net/mail/?group_id=73485">Mailing

33

Lists</a>] [<a HREF="FAQ.html">FAQ</a>] [<a HREF="formats.html">Formats</a>]

34

[<a HREF="NEWS.html">News</a> ] [<a HREF="Changelog.html">ChangeLog</a>]

35

[<a HREF="http://sourceforge.net/projects/graphicsmagick/">Report

36

Bugs</a>] [<a HREF="www/utilities.html">Utilities</a>]

37

[<a HREF="programming.html">Programming</a>] [<a HREF="books.html">Books</a>]

38

[<a HREF="links.html">Links</a>]</p>

39

40

</td>

41

42

43

</td>

44

</tr>

45

<tr>

46

47

48

<p><font SIZE=4><i>Search GraphicsMagick site <input TYPE=TEXT NAME="q" SIZE=25 MAXLENGTH=255>

49

50

51

</p>

52

</div>

53

</td>

54

</tr>

55

</table>

56

</form>

57

58

59

60

61

<tr>

62

<td ALIGN=LEFT bgcolor="#52799E"><img

63

SRC="../images/right_triangle.png" ALT=">" BORDER=0

64

height=14 width=15><b><font face="Helvetica, Arial"><font

65

color="#FFFFFF"><font size="+1">

66

<a NAME="top"></a>NAME

67

</font></font></font></b></td></tr></table>

68

69

70

<p>

71

gm - GraphicsMagick command-line utilities to create, edit, or convert images

72

73

</td></tr></table>

74

75

<tr>

76

<td ALIGN=LEFT bgcolor="#52799E"><img

77

SRC="../images/right_triangle.png" ALT=">" BORDER=0

78

height=14 width=15><b><font face="Helvetica, Arial"><font

79

color="#FFFFFF"><font size="+1">

80

<a NAME="syno"></a>Synopsis

81

</font></font></font></b></td></tr></table>

82

83

84

<p>

85

<strong>gm animate</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> <strong>[ [</strong>

86

<em>options ...</em> <strong>]</strong> <em>file ...</em> <strong>]</strong>

87

<p>

88

<strong>gm composite</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>change-image base-image</em>

89

<strong>[</strong> <em>mask-image</em> <strong>]</strong> <em>output-image</em>

90

<p>

91

<strong>gm conjure</strong> <strong>[</strong> <em>options</em> <strong>]</strong> <em>script.msl</em>

92

<strong>[ [</strong> <em>options</em> <strong>]</strong> <em>script.msl</em> <strong>]</strong>

93

<p>

94

<strong>gm convert</strong> <strong>[ [</strong> <em>options ...</em> <strong>] [</strong> <em>input-file ...</em>

95

<strong>]</strong> <em>...</em> <strong>[</strong> <em>output-file</em> <strong>] ]</strong>

96

<p>

97

<strong>gm display</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file ...</em>

98

<strong>[ [</strong><em>options ...</em> <strong>]</strong><em>file ...</em> <strong>]</strong>

99

<p>

100

<strong>gm identify</strong> <em>file</em> <strong>[</strong> <em>file ...</em> <strong>]</strong>

101

<p>

102

<strong>gm import</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em>

103

<p>

104

<strong>gm mogrify</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file ...</em>

105

<p>

106

<strong>gm montage</strong> <strong>[</strong> <em>options ...</em> <strong>]</strong> <em>file</em> <strong>[ [</strong>

107

<em>options ...</em> <strong>]</strong> <em>file ...</em> <strong>]</strong> <em>output-file</em>

108

</td></tr></table>

109

110

<tr>

111

<td ALIGN=LEFT bgcolor="#52799E"><img

112

SRC="../images/right_triangle.png" ALT=">" BORDER=0

113

height=14 width=15><b><font face="Helvetica, Arial"><font

114

color="#FFFFFF"><font size="+1">

115

<a NAME="desc"></a>Description

116

</font></font></font></b></td></tr></table>

117

118

119

<p> GraphicsMagick's <strong>gm</strong> provides a suite of command-line

120

utilities for creating, converting, editing, and displaying

121

images:

122

<p>

123

<strong>Gm display</strong>

124

is a machine architecture independent

125

image processing and display facility. It can display an image on any workstation

126

display running an <em>X</em> server.

127

<p>

128

<strong>Gm import</strong>

129

reads an image from any visible window

130

on an <em>X</em> server and outputs it as an image file. You can capture

131

a single window, the entire screen, or any rectangular portion of the screen.

132

<p>

133

<strong>Gm montage</strong>

134

creates a composite by combining several

135

separate images. The images are tiled on the composite image with the name

136

of the image optionally appearing just below the individual tile.

137

<p>

138

<strong>Gm convert</strong>

139

converts an input file using one image

140

format to an output file with the same or differing image format while applying

141

an arbitrary number of image transformations.

142

<p>

143

<strong>Gm mogrify</strong>

144

transforms an image or a sequence of

145

images. These transforms include <strong>image scaling</strong>, <strong>image rotation</strong>,

146

<strong>color

147

reduction</strong>, and others. The transmogrified image

148

<strong>overwrites</strong> the

149

original image.

150

<p>

151

<strong>Gm identify</strong>

152

describes the format and characteristics

153

of one or more image files. It will also report if an image is incomplete

154

or corrupt.

155

<p>

156

<strong>Gm composite</strong>

157

composites images (blends or merges images together) to create new images.

158

<p>

159

<strong>Gm conjure</strong>

160

interprets and executes scripts in

161

the Magick Scripting Language (MSL).

162

<p>

163

The <strong>GraphicsMagick</strong> utilities recognize the following image formats:

164

165

166

<p>

167

<tr><td><strong>Name</strong> </td><td><strong>Mode</strong></td><td><strong>Description</strong></td></tr>

168

<tr><td><dd><img SRC="../images/ball.png" ALT="*">8BIM </td><td>*rw-</td><td>Photoshop resource format</td></tr>

169

<tr><td><dd><img SRC="../images/ball.png" ALT="*">AFM </td><td>*r--</td><td>TrueType font</td></tr>

170

<tr><td><dd><img SRC="../images/ball.png" ALT="*">APP1 </td><td>*rw-</td><td>Photoshop resource format</td></tr>

171

<tr><td><dd><img SRC="../images/ball.png" ALT="*">ART </td><td>*r--</td><td>PF1: 1st Publisher</td></tr>

172

<tr><td><dd><img SRC="../images/ball.png" ALT="*">AVI </td><td>*r--</td><td>Audio/Visual Interleaved</td></tr>

173

<tr><td><dd><img SRC="../images/ball.png" ALT="*">AVS </td><td>*rw+</td><td>AVS X image</td></tr>

174

<tr><td><dd><img SRC="../images/ball.png" ALT="*">BIE </td><td>*rw-</td><td>Joint Bi-level Image experts Group</td></tr>

175

<tr><td> </td><td> </td><td>interchange format</td></tr>

176

<tr><td><dd><img SRC="../images/ball.png" ALT="*">BMP </td><td>*rw+</td><td>Microsoft Windows bitmap image</td></tr>

177

<tr><td><dd><img SRC="../images/ball.png" ALT="*">CAPTION </td><td>*r+ </td><td>Caption (requires separate size info)</td></tr>

178

<tr><td><dd><img SRC="../images/ball.png" ALT="*">CMYK </td><td>*rw-</td><td>Raw cyan, magenta, yellow, and black</td></tr>

179

<tr><td> </td><td> </td><td>samples (8 or 16 bits, depending on</td></tr>

180

<tr><td> </td><td> </td><td>the image depth)</td></tr>

181

<tr><td><dd><img SRC="../images/ball.png" ALT="*">CMYKA </td><td>*rw-</td><td>Raw cyan, magenta, yellow, black, and</td></tr>

182

<tr><td> </td><td> </td><td>matte samples (8 or 16 bits, depending</td></tr>

183

<tr><td> </td><td> </td><td>on the image depth)</td></tr>

184

185

<tr><td><dd><img SRC="../images/ball.png" ALT="*">DCM </td><td>*r--</td><td>Digital Imaging and Communications in</td></tr>

186

<tr><td> </td><td> </td><td> Medicine image</td></tr>

187

<tr><td><dd><img SRC="../images/ball.png" ALT="*">DCX </td><td>*rw+</td><td>ZSoft IBM PC multi-page Paintbrush</td></tr>

188

<tr><td><dd><img SRC="../images/ball.png" ALT="*">DIB </td><td>*rw+</td><td>Microsoft Windows bitmap image</td></tr>

189

<tr><td><dd><img SRC="../images/ball.png" ALT="*">DPS </td><td>*r--</td><td>Display PostScript</td></tr>

190

<tr><td><dd><img SRC="../images/ball.png" ALT="*">DPX </td><td>*r--</td><td>Digital Moving Picture Exchange</td></tr>

191

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPDF </td><td>*rw-</td><td>Encapsulated Portable Document Format</td></tr>

192

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPI </td><td>*rw-</td><td>Adobe Encapsulated PostScript</td></tr>

193

<tr><td> </td><td> </td><td>Interchange format</td></tr>

194

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPS </td><td>*rw-</td><td>Adobe Encapsulated PostScript</td></tr>

195

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPS2 </td><td>*-w-</td><td>Adobe Level II Encapsulated PostScript</td></tr>

196

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPS3 </td><td>*-w-</td><td>Adobe Level III Encapsulated PostScript</td></tr>

197

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPSF </td><td>*rw-</td><td>Adobe Encapsulated PostScript</td></tr>

198

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPSI </td><td>*rw-</td><td>Adobe Encapsulated PostScript</td></tr>

199

<tr><td> </td><td> </td><td>Interchange format</td></tr>

200

<tr><td><dd><img SRC="../images/ball.png" ALT="*">EPT </td><td>*rw-</td><td>Adobe Encapsulated PostScript with TIFF</td></tr>

201

<tr><td> </td><td> </td><td>preview</td></tr>

202

<tr><td><dd><img SRC="../images/ball.png" ALT="*">FAX </td><td>*rw+</td><td>Group 3 FAX</td></tr>

203

<tr><td><dd><img SRC="../images/ball.png" ALT="*">FILE </td><td>*r--</td><td>Uniform Resource Locator</td></tr>

204

<tr><td><dd><img SRC="../images/ball.png" ALT="*">FITS </td><td>*rw-</td><td>Flexible Image Transport System</td></tr>

205

<tr><td><dd><img SRC="../images/ball.png" ALT="*">FPX </td><td>*rw-</td><td>FlashPix Format</td></tr>

206

<tr><td><dd><img SRC="../images/ball.png" ALT="*">FTP </td><td>*r--</td><td>Uniform Resource Locator</td></tr>

207

<tr><td><dd><img SRC="../images/ball.png" ALT="*">G3 </td><td>*rw-</td><td>Group 3 FAX</td></tr>

208

<tr><td><dd><img SRC="../images/ball.png" ALT="*">GIF </td><td>*rw+</td><td>CompuServe graphics interchange format</td></tr>

209

<tr><td><dd><img SRC="../images/ball.png" ALT="*">GIF87 </td><td>*rw-</td><td>CompuServe graphics interchange format</td></tr>

210

<tr><td> </td><td> </td><td>(version 87a)</td></tr>

211

<tr><td><dd><img SRC="../images/ball.png" ALT="*">GRADIENT </td><td>*r--</td><td>Gradual passing from one shade to</td></tr>

212

<tr><td> </td><td> </td><td>another</td></tr>

213

<tr><td><dd><img SRC="../images/ball.png" ALT="*">GRANITE </td><td>*r--</td><td>Granite texture</td></tr>

214

<tr><td><dd><img SRC="../images/ball.png" ALT="*">GRAY </td><td>*rw+</td><td>Raw gray samples (8 or 16 bits,</td></tr>

215

<tr><td> </td><td> </td><td>depending on the image depth)</td></tr>

216

<tr><td><dd><img SRC="../images/ball.png" ALT="*">H </td><td>*rw-</td><td>Internal format</td></tr>

217

<tr><td><dd><img SRC="../images/ball.png" ALT="*">HDF </td><td>-rw+</td><td>Hierarchical Data Format</td></tr>

218

<tr><td><dd><img SRC="../images/ball.png" ALT="*">HISTOGRAM</td><td>*-w-</td><td>Histogram of the image</td></tr>

219

<tr><td><dd><img SRC="../images/ball.png" ALT="*">HTM </td><td>*-w-</td><td>Hypertext Markup Language and a</td></tr>

220

<tr><td> </td><td> </td><td>client-side image map</td></tr>

221

<tr><td><dd><img SRC="../images/ball.png" ALT="*">HTML </td><td>*-w-</td><td>Hypertext Markup Language and a</td></tr>

222

<tr><td> </td><td> </td><td>client-side image map</td></tr>

223

<tr><td><dd><img SRC="../images/ball.png" ALT="*">HTTP </td><td>*r--</td><td>Uniform Resource Locator</td></tr>

224

<tr><td><dd><img SRC="../images/ball.png" ALT="*">ICB </td><td>*rw+</td><td>Truevision Targa image</td></tr>

225

<tr><td><dd><img SRC="../images/ball.png" ALT="*">ICM </td><td>*rw-</td><td>ICC Color Profile</td></tr>

226

<tr><td><dd><img SRC="../images/ball.png" ALT="*">ICO </td><td>*r--</td><td>Microsoft icon</td></tr>

227

<tr><td><dd><img SRC="../images/ball.png" ALT="*">ICON </td><td>*r--</td><td>Microsoft icon</td></tr>

228

<tr><td><dd><img SRC="../images/ball.png" ALT="*">IPTC </td><td>*rw-</td><td>IPTC Newsphoto</td></tr>

229

<tr><td><dd><img SRC="../images/ball.png" ALT="*">JBG </td><td>*rw+</td><td>Joint Bi-level Image experts Group</td></tr>

230

<tr><td> </td><td> </td><td>interchange format</td></tr>

231

<tr><td><dd><img SRC="../images/ball.png" ALT="*">JBIG </td><td>*rw+</td><td>Joint Bi-level Image experts Group</td></tr>

232

<tr><td> </td><td> </td><td>interchange format</td></tr>

233

<tr><td><dd><img SRC="../images/ball.png" ALT="*">JP2 </td><td>*rw-</td><td>JPEG-2000 JP2 File Format Syntax</td></tr>

234

<tr><td><dd><img SRC="../images/ball.png" ALT="*">JPC </td><td>*rw-</td><td>JPEG-2000 Code Stream Syntax</td></tr>

235

<tr><td><dd><img SRC="../images/ball.png" ALT="*">JPEG </td><td>*rw-</td><td>Joint Photographic Experts Group</td></tr>

236

<tr><td> </td><td> </td><td>JFIF format</td></tr>

237

<tr><td><dd><img SRC="../images/ball.png" ALT="*">JPG </td><td>*rw-</td><td>Joint Photographic Experts Group</td></tr>

238

<tr><td> </td><td> </td><td>JFIF format</td></tr>

239

<tr><td><dd><img SRC="../images/ball.png" ALT="*">LABEL </td><td>*r--</td><td>Text image format</td></tr>

240

<tr><td><dd><img SRC="../images/ball.png" ALT="*">LOGO </td><td>*rw-</td><td>GraphicsMagick Logo</td></tr>

241

<tr><td><dd><img SRC="../images/ball.png" ALT="*">M2V </td><td>*rw+</td><td>MPEG-2 Video Stream</td></tr>

242

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MAP </td><td>*rw-</td><td>Colormap intensities (8 or 16 bits,</td></tr>

243

<tr><td> </td><td> </td><td>depending on the image depth) and</td></tr>

244

<tr><td> </td><td> </td><td>indices (8 or 16 bits, depending</td></tr>

245

<tr><td> </td><td> </td><td>on whether colors exceeds 256).</td></tr>

246

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MAT </td><td>*-w+</td><td>MATLAB image format</td></tr>

247

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MATTE </td><td>*-w+</td><td>MATTE format</td></tr>

248

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MIFF </td><td>*rw+</td><td>Magick image format</td></tr>

249

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MNG </td><td>*rw+</td><td>Multiple-image Network Graphics</td></tr>

250

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MONO </td><td>*rw-</td><td>Bi-level bitmap in least-significant-</td></tr>

251

<tr><td> </td><td> </td><td>-byte-first order</td></tr>

252

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MPC </td><td>-rw-</td><td>Magick Persistent Cache image format</td></tr>

253

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MPEG </td><td>*rw+</td><td>MPEG-1 Video Stream</td></tr>

254

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MPG </td><td>*rw+</td><td>MPEG-1 Video Stream</td></tr>

255

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MPR </td><td>*r--</td><td>Magick Persistent Registry</td></tr>

256

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MSL </td><td>*r--</td><td>Magick Scripting Language</td></tr>

257

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MTV </td><td>*rw+</td><td>MTV Raytracing image format</td></tr>

258

<tr><td><dd><img SRC="../images/ball.png" ALT="*">MVG </td><td>*rw-</td><td>Magick Vector Graphics</td></tr>

259

<tr><td><dd><img SRC="../images/ball.png" ALT="*">NETSCAPE </td><td>*r--</td><td>Netscape 216 color cube</td></tr>

260

<tr><td><dd><img SRC="../images/ball.png" ALT="*">NULL </td><td>*r--</td><td>Constant image of uniform color</td></tr>

261

<tr><td><dd><img SRC="../images/ball.png" ALT="*">OTB </td><td>*rw-</td><td>On-the-air bitmap</td></tr>

262

<tr><td><dd><img SRC="../images/ball.png" ALT="*">P7 </td><td>*rw+</td><td>Xv thumbnail format</td></tr>

263

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PAL </td><td>*rw-</td><td>16bit/pixel interleaved YUV</td></tr>

264

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PALM </td><td>*rw-</td><td>Palm Pixmap format</td></tr>

265

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PBM </td><td>*rw+</td><td>Portable bitmap format (black and white)</td></tr>

266

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PCD </td><td>*rw-</td><td>Photo CD</td></tr>

267

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PCDS </td><td>*rw-</td><td>Photo CD</td></tr>

268

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PCL </td><td>*-w-</td><td>Page Control Language</td></tr>

269

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PCT </td><td>*rw-</td><td>Apple Macintosh QuickDraw/PICT</td></tr>

270

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PCX </td><td>*rw-</td><td>ZSoft IBM PC Paintbrush</td></tr>

271

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PDB </td><td>*r--</td><td>Pilot Image Format</td></tr>

272

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PDF </td><td>*rw+</td><td>Portable Document Format</td></tr>

273

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PFA </td><td>*r--</td><td>TrueType font</td></tr>

274

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PFB </td><td>*r--</td><td>TrueType font</td></tr>

275

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PFM </td><td>*r--</td><td>TrueType font</td></tr>

276

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PGM </td><td>*rw+</td><td>Portable graymap format (gray scale)</td></tr>

277

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PICON </td><td>*rw-</td><td>Personal Icon</td></tr>

278

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PICT </td><td>*rw-</td><td>Apple Macintosh QuickDraw/PICT</td></tr>

279

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PIX </td><td>*r--</td><td>Alias/Wavefront RLE image format</td></tr>

280

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PLASMA </td><td>*r--</td><td>Plasma fractal image</td></tr>

281

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PM </td><td>*rw-</td><td>X Windows system pixmap (color)</td></tr>

282

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PNG </td><td>*rw-</td><td>Portable Network Graphics</td></tr>

283

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PNM </td><td>*rw+</td><td>Portable anymap</td></tr>

284

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PPM </td><td>*rw+</td><td>Portable pixmap format (color)</td></tr>

285

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PREVIEW </td><td>*-w-</td><td>Show a preview an image enhancement,</td></tr>

286

<tr><td> </td><td> </td><td>effect, or f/x</td></tr>

287

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PS </td><td>*rw+</td><td>Adobe PostScript</td></tr>

288

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PS2 </td><td>*-w+</td><td>Adobe Level II PostScript</td></tr>

289

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PS3 </td><td>*-w+</td><td>Adobe Level III PostScript</td></tr>

290

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PSD </td><td>*rw-</td><td>Adobe Photoshop bitmap</td></tr>

291

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PTIF </td><td>*rw-</td><td>Pyramid encoded TIFF</td></tr>

292

<tr><td><dd><img SRC="../images/ball.png" ALT="*">PWP </td><td>*r--</td><td>Seattle Film Works</td></tr>

293

<tr><td><dd><img SRC="../images/ball.png" ALT="*">RAS </td><td>*rw+</td><td>SUN Rasterfile</td></tr>

294

<tr><td><dd><img SRC="../images/ball.png" ALT="*">RGB </td><td>*rw+</td><td>Raw red, green, and blue samples (8 or</td></tr>

295

<tr><td> </td><td> </td><td>16 bits, depending on the image depth)</td></tr>

296

<tr><td><dd><img SRC="../images/ball.png" ALT="*">RGBA </td><td>*rw+</td><td>Raw red, green, blue, and matte samples</td></tr>

297

<tr><td> </td><td> </td><td>(8 or 16 bits, depending on the image</td></tr>

298

<tr><td> </td><td> </td><td>depth)</td></tr>

299

<tr><td><dd><img SRC="../images/ball.png" ALT="*">RLA </td><td>*r--</td><td>Alias/Wavefront image</td></tr>

300

<tr><td><dd><img SRC="../images/ball.png" ALT="*">RLE </td><td>*r--</td><td>Utah Run length encoded image</td></tr>

301

<tr><td><dd><img SRC="../images/ball.png" ALT="*">ROSE </td><td>*rw-</td><td>70x46 Truecolor test image</td></tr>

302

<tr><td><dd><img SRC="../images/ball.png" ALT="*">SCT </td><td>*r--</td><td>Scitex HandShake</td></tr>

303

<tr><td><dd><img SRC="../images/ball.png" ALT="*">SFW </td><td>*r--</td><td>Seattle Film Works</td></tr>

304

<tr><td><dd><img SRC="../images/ball.png" ALT="*">SGI </td><td>*rw+</td><td>Irix RGB image</td></tr>

305

<tr><td><dd><img SRC="../images/ball.png" ALT="*">SHTML </td><td>*-w-</td><td>Hypertext Markup Language and a</td></tr>

306

<tr><td> </td><td> </td><td>client-side image map</td></tr>

307

<tr><td><dd><img SRC="../images/ball.png" ALT="*">STEGANO </td><td>*r--</td><td>Steganographic image</td></tr>

308

<tr><td><dd><img SRC="../images/ball.png" ALT="*">SUN </td><td>*rw+</td><td>SUN Rasterfile</td></tr>

309

<tr><td><dd><img SRC="../images/ball.png" ALT="*">SVG </td><td>*rw+</td><td>Scalable Vector Gaphics</td></tr>

310

311

<tr><td><dd><img SRC="../images/ball.png" ALT="*">TGA </td><td>*rw+</td><td>Truevision Targa image</td></tr>

312

<tr><td><dd><img SRC="../images/ball.png" ALT="*">TIF </td><td>*rw+</td><td>Tagged Image File Format</td></tr>

313

<tr><td><dd><img SRC="../images/ball.png" ALT="*">TIFF </td><td>*rw+</td><td>Tagged Image File Format</td></tr>

314

<tr><td><dd><img SRC="../images/ball.png" ALT="*">TILE </td><td>*r--</td><td>Tile image with a texture</td></tr>

315

316

<tr><td><dd><img SRC="../images/ball.png" ALT="*">TTF </td><td>*r--</td><td>TrueType font</td></tr>

317

318

<tr><td><dd><img SRC="../images/ball.png" ALT="*">UIL </td><td>*-w-</td><td>X-Motif UIL table</td></tr>

319

<tr><td><dd><img SRC="../images/ball.png" ALT="*">UYVY </td><td>*rw-</td><td>16bit/pixel interleaved YUV</td></tr>

320

<tr><td><dd><img SRC="../images/ball.png" ALT="*">VDA </td><td>*rw+</td><td>Truevision Targa image</td></tr>

321

<tr><td><dd><img SRC="../images/ball.png" ALT="*">VICAR </td><td>*rw-</td><td>VICAR rasterfile format</td></tr>

322

<tr><td><dd><img SRC="../images/ball.png" ALT="*">VID </td><td>*rw+</td><td>Visual Image Directory</td></tr>

323

<tr><td><dd><img SRC="../images/ball.png" ALT="*">VIFF </td><td>*rw+</td><td>Khoros Visualization image</td></tr>

324

<tr><td><dd><img SRC="../images/ball.png" ALT="*">VST </td><td>*rw+</td><td>Truevision Targa image</td></tr>

325

<tr><td><dd><img SRC="../images/ball.png" ALT="*">WBMP </td><td>*rw-</td><td>Wireless Bitmap (level 0) image</td></tr>

326

<tr><td><dd><img SRC="../images/ball.png" ALT="*">WMF </td><td>*r--</td><td>Windows Metafile</td></tr>

327

<tr><td><dd><img SRC="../images/ball.png" ALT="*">WPG </td><td>*r--</td><td>Word Perfect Graphics</td></tr>

328

<tr><td><dd><img SRC="../images/ball.png" ALT="*">X </td><td>*rw-</td><td>X Image</td></tr>

329

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XBM </td><td>*rw-</td><td>X Windows system bitmap (black</td></tr>

330

<tr><td> </td><td> </td><td>and white)</td></tr>

331

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XC </td><td>*r--</td><td>Constant image uniform color</td></tr>

332

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XCF </td><td>*r--</td><td>GIMP image</td></tr>

333

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XML </td><td>*r--</td><td>Scalable Vector Gaphics</td></tr>

334

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XPM </td><td>*rw-</td><td>X Windows system pixmap (color)</td></tr>

335

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XV </td><td>*rw+</td><td>Khoros Visualization image</td></tr>

336

<tr><td><dd><img SRC="../images/ball.png" ALT="*">XWD </td><td>*rw-</td><td>X Windows system window dump (color)</td></tr>

337

338

339

<tr><td> Modes: </td><td> </td><td></td></tr>

340

<tr><td> </td><td>* </td><td>Native blob support</td></tr>

341

342

<tr><td> </td><td>w </td><td>Write</td></tr>

343

<tr><td> </td><td>+ </td><td>Multi-image</td></tr>

344

345

</table>

346

<p>

347

<em>Support for some of these formats require additional programs or libraries.

348

<a href="install.html">README</a>

349

tells where to find this software</em>.

350

<p>

351

Note, a format delineated with <tt>+</tt> means that if more than one

352

image is specified, it is composited into a single multi-image file. Use

353

<strong>+adjoin</strong>

354

if you want a single image produced for each frame.

355

<p>

356

Your installation might not support all of the formats in the list. To get

357

an up-to-date listing of the formats supported by your particular

358

configuration, run <tt>"convert -list format"</tt>.

359

<p>

360

Raw images are expected to have one byte per pixel unless <strong>gm</strong>

361

is compiled in 16-bit mode or in 32-bit mode. Here, the raw data

362

is expected to be stored two or four

363

bytes per pixel, respectively, in most-significant-byte-first order.

364

You can tell if <strong>gm</strong> was compiled in 16-bit mode by typing

365

"gm version" without any options, and looking for "Q:16" in the first line of

366

output.

367

</td></tr></table>

368

<p>

369

<i><a href="#top">Back to Contents</a></i>

370

 </p>

371

372

<tr>

373

<td ALIGN=LEFT bgcolor="#52799E"><img

374

SRC="../images/right_triangle.png" ALT=">" BORDER=0

375

height=14 width=15><b><font face="Helvetica, Arial"><font

376

color="#FFFFFF"><font size="+1">

377

<a NAME="files"></a>Files and Formats

378

</font></font></font></b></td></tr></table>

379

380

381

<p>

382

By default, the image format is determined by its magic number, i.e., the

383

first few bytes of the file. To specify

384

a particular image format, precede the filename with an image format name

385

and a colon (<em>i.e.</em><strong>ps:image</strong>) or specify the image type as the

386

filename suffix.

387

The magic number takes precedence over the filename suffix

388

and the prefix takes precedence over the magic number and the suffix

389

in input files.

390

The prefix takes precedence over the filename

391

suffix in output files. To read the "built-in" formats (GRANITE, H, LOGO,

392

NETSCAPE, PLASMA, and ROSE) use a prefix (including the colon) without a

393

filename or suffix. To read the XC format, follow the colon with a color

394

specification. To read the CAPTION format, follow the colon with a text

395

string or with a filename prefixed with the at symbol (<strong>@</strong>).

396

397

<p>

398

When you specify <strong>X</strong> as your image type, the filename has special

399

meaning. It specifies an X window by <strong>id, name</strong>, or

400

<strong>root</strong>. If

401

no filename is specified, the window is selected by clicking the mouse

402

in the desired window.

403

<p>

404

Specify <em>input_file</em> as <strong>-</strong> for standard input,

405

<em>output_file</em> as <strong>-</strong> for standard output.

406

If <em>input_file</em> has the extension <strong>.Z</strong> or <strong>.gz</strong>, the

407

file is uncompressed with <strong>uncompress</strong> or <strong>gunzip</strong>

408

respectively.

409

If <em>output_file</em> has the extension <strong>.Z</strong> or <strong>.gz</strong>,

410

the file is compressed using with <em>compress</em> or <em>gzip</em> respectively.

411

<p>

412

Finally, when running on platforms that allow it, precede the image file name

413

with <strong>|</strong> to pipe to or from a system command (this feature is not

414

available on VMS, Win32 and Macintosh platforms). Use a backslash or

415

quotation marks to prevent your shell from interpreting the <strong>|</strong>.

416

<p>

417

Use an optional index enclosed in brackets after an input file name to specify

418

a desired subimage of a multi-resolution image format like Photo CD

419

(e.g. <tt>"img0001.pcd[4]"</tt>) or a range for MPEG images

420

(e.g. <tt>"video.mpg[50-75]"</tt>). A subimage

421

specification can be disjoint (e.g. <tt>"image.tiff[2,7,4]"</tt>). For

422

raw images, specify a subimage with a geometry

423

(e.g. <tt>-size 640x512</tt> <tt>"image.rgb[320x256+50+50]"</tt>).

424

Surround the image name with quotation marks to prevent your shell

425

from interpreting the square brackets.

426

<p>Single images are written with the filename you specify. However, multi-part

427

images (e.g., a multi-page PostScript document with <strong>+adjoin</strong> specified)

428

are written

429

with the filename followed by a period (<strong>.</strong>) and the scene number. You

430

can change this behavior by embedding a <tt>%d, %0Nd, %o, %0No, %x,</tt>

431

or <tt>%0Nx</tt> <em>printf</em>

432

format specification in the file name. For example,

433

<pre>

434

image%02d.miff

435

</pre>

436

<p>

437

writes files <em>image00.miff, image01.miff,</em> etc.

438

<p>

439

When running a commandline utility, you can

440

prepend an at sign <tt>@</tt> to a filename to read a list of image

441

filenames from that file. This is convenient in the event you have too

442

many image filenames to fit on the command line.

443

</td></tr></table>

444

<p>

445

<i><a href="#top">Back to Contents</a></i>

446

 </p>

447

448

<tr>

449

<td ALIGN=LEFT bgcolor="#52799E"><img

450

SRC="../images/right_triangle.png" ALT=">" BORDER=0

451

height=14 width=15><b><font face="Helvetica, Arial"><font

452

color="#FFFFFF"><font size="+1">

453

<a NAME="opti"></a>Options

454

</font></font></font></b></td></tr></table>

455

456

457

<p>

458

Options are processed in command line order. Any option you specify on

459

the command line remains in effect for the set of images that follows,

460

until the set is terminated by the appearance of any option or <strong>-noop</strong>.

461

Some options only affect the decoding of images and others only the encoding.

462

The latter can appear after the final group of input images.

463

<p>

464

This is a combined list of the commandline options used by the GraphicsMagick

465

utilities (<em>animate, composite, convert, display, identify,

466

import, mogrify</em> and <em>montage</em>).

467

468

<p>

469

In this document, angle brackets ("<>") enclose variables and curly

470

brackets ("{}") enclose optional parameters. For example,

471

"<strong>-fuzz <distance>{%}</strong>" means you can use the

472

option <tt>"-fuzz 10"</tt>

473

or <tt>"-fuzz 2%"</tt>.

474

475

476

<tr>

477

478

479

<img SRC="../images/right_triangle_option.png"

480

ALT=">" BORDER=0 height=14

481

width=15><b><font face="Helvetica, Arial"

482

><font color="#FFFFFF"><font size="+1">

483

<a name="details-adjoin"></a>-adjoin

484

</font></font></font></b></td></tr></table>

485

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>join images into a single multi-image file</td></tr></table>

486

487

By default, all images of an image sequence are stored in the same

488

file. However, some formats (e.g. JPEG) do not support more than one image

489

and are saved to separate files. Use <strong>+adjoin</strong> to force this

490

behavior.</font></td></tr></table>

491

492

<tr>

493

494

495

<img SRC="../images/right_triangle_option.png"

496

ALT=">" BORDER=0 height=14

497

width=15><b><font face="Helvetica, Arial"

498

><font color="#FFFFFF"><font size="+1">

499

<a name="details-affine"></a>-affine <i><matrix></i>

500

</font></font></font></b></td></tr></table>

501

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table>

502

503

This option provides a transform matrix <tt>{sx,rx,ry,sy,tx,ty}</tt> for

504

use by subsequent <strong>-draw</strong> or <strong>-transform</strong> options.</font></td></tr></table>

505

506

<tr>

507

508

509

<img SRC="../images/right_triangle_option.png"

510

ALT=">" BORDER=0 height=14

511

width=15><b><font face="Helvetica, Arial"

512

><font color="#FFFFFF"><font size="+1">

513

<a name="details-antialias"></a>-antialias

514

</font></font></font></b></td></tr></table>

515

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table>

516

517

By default antialiasing algorithms are used when drawing objects (e.g. lines)

518

or rendering vector formats (e.g. WMF and Postscript). Use +antialias to

519

disable use of antialiasing algorithms. Reasons to disable antialiasing

520

include avoiding increasing colors in the image, or improving rendering speed.</font></td></tr></table>

521

522

<tr>

523

524

525

<img SRC="../images/right_triangle_option.png"

526

ALT=">" BORDER=0 height=14

527

width=15><b><font face="Helvetica, Arial"

528

><font color="#FFFFFF"><font size="+1">

529

<a name="details-append"></a>-append

530

</font></font></font></b></td></tr></table>

531

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>append a set of images</td></tr></table>

532

533

This option creates a single image where the images in the original set

534

are stacked top-to-bottom. If they are not of the same width,

535

any narrow images will be expanded to fit using the background color.

536

Use <strong>+append</strong> to stack images left-to-right. The set of images

537

is terminated by the appearance of any option.

538

If the <strong>-append</strong>

539

option appears after all of the input images, all images are appended.</font></td></tr></table>

540

541

<tr>

542

543

544

<img SRC="../images/right_triangle_option.png"

545

ALT=">" BORDER=0 height=14

546

width=15><b><font face="Helvetica, Arial"

547

><font color="#FFFFFF"><font size="+1">

548

<a name="details-authenticate"></a>-authenticate <i><string></i>

549

</font></font></font></b></td></tr></table>

550

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

551

552

Use this option to supply a password for decrypting an image or an

553

image sequence, if it is being read from a format such as PDF that supports

554

encryption. Encrypting images being written is not supported.</font></td></tr></table>

555

556

<tr>

557

558

559

<img SRC="../images/right_triangle_option.png"

560

ALT=">" BORDER=0 height=14

561

width=15><b><font face="Helvetica, Arial"

562

><font color="#FFFFFF"><font size="+1">

563

<a name="details-average"></a>-average

564

</font></font></font></b></td></tr></table>

565

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>average a set of images</td></tr></table>

566

567

The set of images

568

is terminated by the appearance of any option.

569

If the <strong>-average</strong>

570

option appears after all of the input images, all images are averaged.</font></td></tr></table>

571

572

<tr>

573

574

575

<img SRC="../images/right_triangle_option.png"

576

ALT=">" BORDER=0 height=14

577

width=15><b><font face="Helvetica, Arial"

578

><font color="#FFFFFF"><font size="+1">

579

<a name="details-backdrop"></a>-backdrop

580

</font></font></font></b></td></tr></table>

581

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table>

582

583

This backdrop covers the entire workstation screen and is useful for hiding

584

other X window activity while viewing the image. The color of the backdrop

585

is specified as the foreground color (X11 default is black).</font></td></tr></table>

586

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">Refer to

587

"X Resources", below,

588

for details.</font></td></tr></table>

589

590

<tr>

591

592

593

<img SRC="../images/right_triangle_option.png"

594

ALT=">" BORDER=0 height=14

595

width=15><b><font face="Helvetica, Arial"

596

><font color="#FFFFFF"><font size="+1">

597

<a name="details-background"></a>-background <i><color></i>

598

</font></font></font></b></td></tr></table>

599

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

600

601

The color is specified using the format described under the <strong>-fill</strong>

602

option.</font></td></tr></table>

603

604

<tr>

605

606

607

<img SRC="../images/right_triangle_option.png"

608

ALT=">" BORDER=0 height=14

609

width=15><b><font face="Helvetica, Arial"

610

><font color="#FFFFFF"><font size="+1">

611

<a name="details-blue-primary"></a>-blue-primary <i><x>,<y></i>

612

</font></font></font></b></td></tr></table>

613

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table>

614

615

<tr>

616

617

618

<img SRC="../images/right_triangle_option.png"

619

ALT=">" BORDER=0 height=14

620

width=15><b><font face="Helvetica, Arial"

621

><font color="#FFFFFF"><font size="+1">

622

623

</font></font></font></b></td></tr></table>

624

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

625

626

Blur with the given radius and

627

standard deviation (sigma).</font></td></tr></table>

628

629

<tr>

630

631

632

<img SRC="../images/right_triangle_option.png"

633

ALT=">" BORDER=0 height=14

634

width=15><b><font face="Helvetica, Arial"

635

><font color="#FFFFFF"><font size="+1">

636

<a name="details-border"></a>-border <i><width>x<height></i>

637

</font></font></font></b></td></tr></table>

638

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table>

639

640

See <strong>-geometry</strong> for details

641

about the geometry specification.</font></td></tr></table>

642

643

<tr>

644

645

646

<img SRC="../images/right_triangle_option.png"

647

ALT=">" BORDER=0 height=14

648

width=15><b><font face="Helvetica, Arial"

649

><font color="#FFFFFF"><font size="+1">

650

<a name="details-bordercolor"></a>-bordercolor <i><color></i>

651

</font></font></font></b></td></tr></table>

652

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

653

654

The color is specified using the format described under the <strong>-fill</strong>

655

option.</font></td></tr></table>

656

657

<tr>

658

659

660

<img SRC="../images/right_triangle_option.png"

661

ALT=">" BORDER=0 height=14

662

width=15><b><font face="Helvetica, Arial"

663

><font color="#FFFFFF"><font size="+1">

664

-borderwidth <i><geometry></i>

665

</font></font></font></b></td></tr></table>

666

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table>

667

668

<tr>

669

670

671

<img SRC="../images/right_triangle_option.png"

672

ALT=">" BORDER=0 height=14

673

width=15><b><font face="Helvetica, Arial"

674

><font color="#FFFFFF"><font size="+1">

675

676

</font></font></font></b></td></tr></table>

677

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the color of the annotation bounding box</td></tr></table>

678

679

The color is specified using the format described under the <strong>-fill</strong>

680

option.</font></td></tr></table>

681

682

See <strong>-draw</strong> for further

683

details.</font></td></tr></table>

684

685

<tr>

686

687

688

<img SRC="../images/right_triangle_option.png"

689

ALT=">" BORDER=0 height=14

690

width=15><b><font face="Helvetica, Arial"

691

><font color="#FFFFFF"><font size="+1">

692

<a name="details-cache"></a>-cache <i><threshold></i>

693

</font></font></font></b></td></tr></table>

694

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

695

696

<tr>

697

698

699

<img SRC="../images/right_triangle_option.png"

700

ALT=">" BORDER=0 height=14

701

width=15><b><font face="Helvetica, Arial"

702

><font color="#FFFFFF"><font size="+1">

703

<a name="details-channel"></a>-channel <i><type></i>

704

</font></font></font></b></td></tr></table>

705

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table>

706

707

Choose from: <strong>Red</strong>, <strong>Green</strong>, <strong>Blue</strong>, <strong>Opacity</strong>,

708

<strong>Matte</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, or <strong>Black</strong>.</font></td></tr></table>

709

710

Use this option to extract a particular <em>channel</em> from the image.

711

<strong>Matte</strong>,

712

for example, is useful for extracting the opacity values from an image.</font></td></tr></table>

713

714

<tr>

715

716

717

<img SRC="../images/right_triangle_option.png"

718

ALT=">" BORDER=0 height=14

719

width=15><b><font face="Helvetica, Arial"

720

><font color="#FFFFFF"><font size="+1">

721

-charcoal <i><factor></i>

722

</font></font></font></b></td></tr></table>

723

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table>

724

725

<tr>

726

727

728

<img SRC="../images/right_triangle_option.png"

729

ALT=">" BORDER=0 height=14

730

width=15><b><font face="Helvetica, Arial"

731

><font color="#FFFFFF"><font size="+1">

732

733

</font></font></font></b></td></tr></table>

734

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table>

735

736

<em>Width</em> and <em>height</em> give the number of columns and rows to remove,

737

and <em>x</em> and <em>y</em> are offsets that give the location of the

738

leftmost column and topmost row to remove.</font></td></tr></table>

739

740

The <em>x</em> offset normally specifies the leftmost column to remove.

741

If the <strong>-gravity</strong> option is present with <em>NorthEast, East,</em>

742

or <em>SouthEast</em>

743

gravity, it gives the distance leftward from the right edge

744

of the image to the rightmost column to remove. Similarly, the <em>y</em> offset

745

normally specifies the topmost row to remove, but if

746

the <strong>-gravity</strong> option is present with <em>SouthWest, South,</em>

747

or <em>SouthEast</em>

748

gravity, it specifies the distance upward from the bottom edge of the

749

image to the bottom row to remove.</font></td></tr></table>

750

751

The <strong>-chop</strong> option removes entire rows and columns,

752

and moves the remaining corner blocks leftward and upward to close the gaps.</font></td></tr></table>

753

754

<tr>

755

756

757

<img SRC="../images/right_triangle_option.png"

758

ALT=">" BORDER=0 height=14

759

width=15><b><font face="Helvetica, Arial"

760

><font color="#FFFFFF"><font size="+1">

761

<a name="details-clip"></a>-clip

762

</font></font></font></b></td></tr></table>

763

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply the clipping path, if one is present</td></tr></table>

764

765

If a clipping path is present, it will be applied to subsequent operations.</font></td></tr></table>

766

767

For example, if you type the following command:</font></td></tr></table>

768

<pre>

769

gm convert -clip -negate cockatoo.tif negated.tif

770

</pre>

771

772

only the pixels within the clipping path are negated.</font></td></tr></table>

773

774

The <strong>-clip</strong> feature requires the XML library. If the XML library

775

is not present, the option is ignored.</font></td></tr></table>

776

777

<tr>

778

779

780

<img SRC="../images/right_triangle_option.png"

781

ALT=">" BORDER=0 height=14

782

width=15><b><font face="Helvetica, Arial"

783

><font color="#FFFFFF"><font size="+1">

784

<a name="details-coalesce"></a>-coalesce

785

</font></font></font></b></td></tr></table>

786

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>merge a sequence of images</td></tr></table>

787

788

Each image N in the sequence after Image 0 is replaced with the image

789

created by flattening images 0 through N.</font></td></tr></table>

790

791

The set of images

792

is terminated by the appearance of any option.

793

If the <strong>-coalesce</strong>

794

option appears after all of the input images, all images are coalesced.</font></td></tr></table>

795

796

<tr>

797

798

799

<img SRC="../images/right_triangle_option.png"

800

ALT=">" BORDER=0 height=14

801

width=15><b><font face="Helvetica, Arial"

802

><font color="#FFFFFF"><font size="+1">

803

<a name="details-colorize"></a>-colorize <i><value></i>

804

</font></font></font></b></td></tr></table>

805

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colorize the image with the pen color</td></tr></table>

806

807

Specify the amount of colorization as a percentage. You can apply separate

808

colorization values to the red, green, and blue channels of the image with

809

a colorization value list delimited with slashes (e.g. 0/0/50).</font></td></tr></table>

810

811

<tr>

812

813

814

<img SRC="../images/right_triangle_option.png"

815

ALT=">" BORDER=0 height=14

816

width=15><b><font face="Helvetica, Arial"

817

><font color="#FFFFFF"><font size="+1">

818

<a name="details-colormap"></a>-colormap <i><type></i>

819

</font></font></font></b></td></tr></table>

820

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table>

821

822

Choose between <strong>shared</strong> or <strong>private</strong>.</font></td></tr></table>

823

824

This option only applies when the default X server visual is <em>PseudoColor</em>

825

or <em>GRAYScale</em>. Refer to <strong>-visual</strong> for more details. By default,

826

a shared colormap is allocated. The image shares colors with other X clients.

827

Some image colors could be approximated, therefore your image may look

828

very different than intended. Choose <strong>Private</strong> and the image colors

829

appear exactly as they are defined. However, other clients may

830

go <em>technicolor</em> when the image colormap is installed.</font></td></tr></table>

831

832

<tr>

833

834

835

<img SRC="../images/right_triangle_option.png"

836

ALT=">" BORDER=0 height=14

837

width=15><b><font face="Helvetica, Arial"

838

><font color="#FFFFFF"><font size="+1">

839

<a name="details-colors"></a>-colors <i><value></i>

840

</font></font></font></b></td></tr></table>

841

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

842

843

The actual number of colors in the image may be less than your request,

844

but never more. Note, this is a color reduction option. Images with less

845

unique colors than specified with this option will have any duplicate or

846

unused colors removed. The ordering of an existing color palette may be

847

altered. When converting an image from color to grayscale, convert the

848

image to the gray colorspace before reducing the number of colors since

849

doing so is most efficient. Refer to <a

850

href="quantize.html">quantize</a> for more details.</font></td></tr></table>

851

852

Note, options <strong>-dither</strong>, <strong>-colorspace</strong>, and <strong>-treedepth</strong>

853

affect the color reduction algorithm.</font></td></tr></table>

854

855

<tr>

856

857

858

<img SRC="../images/right_triangle_option.png"

859

ALT=">" BORDER=0 height=14

860

width=15><b><font face="Helvetica, Arial"

861

><font color="#FFFFFF"><font size="+1">

862

<a name="details-colorspace"></a>-colorspace <i><value></i>

863

</font></font></font></b></td></tr></table>

864

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

865

866

Choices are:

867

<strong>CMYK</strong>, <strong>GRAY</strong>, <strong>HSL</strong>, <strong>HWB</strong>, <strong>OHTA</strong>, <strong>RGB</strong>,

868

<strong>Transparent</strong>, <strong>XYZ</strong>, <strong>YCbCr</strong>, <strong>YIQ</strong>, <strong>YPbPr</strong>,

869

or

870

871

872

Color reduction, by default, takes place in the RGB color space. Empirical

873

evidence suggests that distances in color spaces such as YUV or YIQ correspond

874

to perceptual color differences more closely than do distances in RGB space.

875

These color spaces may give better results when color reducing an image.

876

Refer to <a href="quantize.html">quantize</a> for more details.</font></td></tr></table>

877

878

The <strong>Transparent</strong> color space behaves uniquely in that it preserves

879

the matte channel of the image if it exists.</font></td></tr></table>

880

881

The <strong>-colors</strong> or <strong>-monochrome</strong> option, or saving to a file

882

format which requires color reduction, is required for this option to

883

take effect.</font></td></tr></table>

884

885

<tr>

886

887

888

<img SRC="../images/right_triangle_option.png"

889

ALT=">" BORDER=0 height=14

890

width=15><b><font face="Helvetica, Arial"

891

><font color="#FFFFFF"><font size="+1">

892

<a name="details-comment"></a>-comment <i><string></i>

893

</font></font></font></b></td></tr></table>

894

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

895

896

Use this option to assign a specific comment to the image, when writing

897

to an image format that supports comments. You can include the

898

image filename, type, width, height, or other image attribute by embedding

899

special format characters listed under the <strong>-format</strong> option.

900

The comment is not drawn on the image, but is embedded in the image

901

datastream via a "Comment" tag or similar mechanism. If you want the

902

comment to be visible on the image itself, use the <strong>-draw</strong> option.</font></td></tr></table>

903

904

For example,</font></td></tr></table>

905

<pre>

906

-comment "%m:%f %wx%h"

907

</pre>

908

909

produces an image comment of <strong>MIFF:bird.miff 512x480</strong> for an image

910

titled <strong>bird.miff</strong> and whose width is 512 and height is 480.</font></td></tr></table>

911

912

If the first character of <em>string</em> is <em>@</em>, the image comment

913

is read from a file titled by the remaining characters in the string.</font></td></tr></table>

914

915

<tr>

916

917

918

<img SRC="../images/right_triangle_option.png"

919

ALT=">" BORDER=0 height=14

920

width=15><b><font face="Helvetica, Arial"

921

><font color="#FFFFFF"><font size="+1">

922

<a name="details-compose"></a>-compose <i><operator></i>

923

</font></font></font></b></td></tr></table>

924

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table>

925

926

The description of composition uses abstract terminology in order to

927

allow the the description to be more clear, while avoiding constant

928

values which are specific to a particular build configuration. Each image

929

pixel is represented by red, green, and blue levels (which are equal for

930

a gray pixel). MaxRGB is the maximum integral value which may be stored

931

in the red, green, or blue channels of the image. Each image pixel may

932

also optionally (if the image matte channel is enabled) have an

933

associated level of opacity (ranging from opaque to transparent), which

934

may be used to determine the influence of the pixel color when

935

compositing the pixel with another image pixel. If the image matte

936

channel is disabled, then all pixels in the image are treated as opaque.

937

The color of an <em>opaque</em> pixel is fully visible while the color of a

938

<em>transparent</em> pixel color is entirely absent (pixel color is ignored).</font></td></tr></table>

939

940

By definition, raster images have a rectangular shape. All image rows are

941

of equal length, and all image columns have the same number of rows. By

942

treating the opacity channel as a visual "mask" the rectangular image may

943

be given a "shape" by treating the opacity channel as a cookie-cutter for

944

the image. Pixels within the shape are opaque, while pixels outside the

945

shape are transparent. Pixels on the boundary of the shape may be between

946

opaque and transparent in order to provide antialiasing (visually smooth

947

edges). The description of the composition operators use this concept of

948

image "shape" in order to make the description of the operators easier to

949

understand. While it is convenient to describe the operators in terms of

950

"shapes" they are by no means limited to mask-style operations since they

951

are based on continuous floating-point mathematics rather than simple

952

boolean operations.</font></td></tr></table>

953

954

By default, the <em>Over</em> composite operator is used. The following

955

composite operators are available:</font></td></tr></table>

956

<pre>

957

Over

958

In

959

Out

960

Atop

961

Xor

962

Plus

963

Minus

964

Add

965

Subtract

966

Difference

967

Multiply

968

Bumpmap

969

Copy

970

CopyRed

971

CopyGreen

972

CopyBlue

973

CopyOpacity

974

</pre>

975

976

The behavior of each operator is described below.</font></td></tr></table>

977

<dl>

978

979

<dd>The result will be the union of the two image shapes, with opaque areas

980

of <em>change-image</em> obscuring <em>base-image</em> in the region of

981

overlap.

982

</dd>

983

984

<dd>The result is simply <em>change-image</em> cut by the shape of

985

<em>base-image</em>. None of the image data of <em>base-image</em> will be in

986

the result.

987

</dd>

988

989

<dd>The resulting image is <em>change-image</em> with the shape of

990

<em>base-image</em> cut out.

991

</dd>

992

993

<dd>The result is the same shape as <em>base-image</em>, with

994

<em>change-image</em> obscuring <em>base-image</em> where the image shapes

995

overlap. Note this differs from <strong>over</strong> because the portion of

996

<em>change-image</em> outside <em>base-image</em>'s shape does not appear in

997

the result.

998

</dd>

999

1000

<dd>The result is the image data from both <em>change-image</em> and

1001

<em>base-image</em> that is outside the overlap region. The overlap region

1002

will be blank.

1003

</dd>

1004

1005

<dd>The result is just the sum of the image data. Output values are cropped

1006

to MaxRGB (no overflow). This operation is independent of the matte

1007

channels.

1008

</dd>

1009

<dt>Minus</dt>

1010

<dd>The result of <em>change-image</em> - <em>base-image</em>, with underflow

1011

cropped to zero. The matte channel is ignored (set to opaque, full

1012

coverage).

1013

</dd>

1014

1015

<dd>The result of <em>change-image</em> + <em>base-image</em>, with overflow

1016

wrapping around (<em>mod</em> MaxRGB+1).

1017

</dd>

1018

<dt>Subtract</dt>

1019

<dd>The result of <em>change-image</em> - <em>base-image</em>, with underflow

1020

wrapping around (<em>mod</em> MaxRGB+1). The <strong>add</strong> and <strong>subtract</strong>

1021

operators can be used to perform reversible transformations.

1022

</dd>

1023

<dt>Difference</dt>

1024

<dd>The result of abs(<em>change-image</em> - <em>base-image</em>). This is

1025

useful for comparing two very similar images.

1026

</dd>

1027

<dt>Multiply</dt>

1028

<dd>The result of <em>change-image</em> * <em>base-image</em>. This is useful for

1029

the creation of drop-shadows.

1030

</dd>

1031

<dt>Bumpmap</dt>

1032

<dd>The result <em>base-image</em> shaded by <em>change-image</em>.

1033

</dd>

1034

1035

<dd>The resulting image is <em>base-image</em> replaced with

1036

<em>change-image</em>. Here the matte information is ignored.

1037

</dd>

1038

<dt>CopyRed</dt>

1039

<dd>The resulting image is the red channel in <em>base-image</em> replaced with

1040

the red channel in <em>change-image</em>. The other channels are copied

1041

untouched.

1042

</dd>

1043

<dt>CopyGreen</dt>

1044

<dd>The resulting image is the green channel in <em>base-image</em> replaced

1045

with the green channel in <em>change-image</em>. The other channels are

1046

copied untouched.

1047

</dd>

1048

<dt>CopyBlue</dt>

1049

<dd>The resulting image is the blue channel in <em>base-image</em> replaced

1050

with the blue channel in <em>change-image</em>. The other channels are

1051

copied untouched.

1052

</dd>

1053

<dt>CopyOpacity</dt>

1054

<dd>The resulting image is the opacity channel in <em>base-image</em> replaced

1055

with the opacity channel in <em>change-image</em>. The other channels are

1056

copied untouched.

1057

</dd>

1058

</dl>

1059

1060

<tr>

1061

1062

1063

<img SRC="../images/right_triangle_option.png"

1064

ALT=">" BORDER=0 height=14

1065

width=15><b><font face="Helvetica, Arial"

1066

><font color="#FFFFFF"><font size="+1">

1067

<a name="details-compress"></a>-compress <i><type></i>

1068

</font></font></font></b></td></tr></table>

1069

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>

1070

1071

Choices are: <em>None</em>, <em>BZip</em>, <em>Fax</em>,

1072

<em>Group4</em>,

1073

<em>JPEG</em>, <em>Lossless</em>,

1074

<em>LZW</em>, <em>RLE</em> or <em>Zip</em>.

1075

</font></td></tr></table>

1076

1077

Specify <strong>+compress</strong> to store the binary image in an uncompressed format.

1078

The default is the compression type of the specified image file.</font></td></tr></table>

1079

1080

If <em>LZW</em> compression is specified but LZW compression has not been enabled,

1081

the image data will be written

1082

in an uncompressed LZW format that can be read by LZW decoders. This

1083

may result in larger-than-expected GIF files.</font></td></tr></table>

1084

1085

<em>"Lossless"</em> refers to lossless JPEG, which is only available if

1086

the JPEG library has been patched to support it. Use of lossless JPEG is

1087

generally not recommended.</font></td></tr></table>

1088

1089

Use the <strong>-quality</strong> option to set the compression level to be used by

1090

JPEG, PNG, MIFF, and MPEG encoders. Use the <strong>-sampling-factor</strong>

1091

option to set the sampling factor to be used by JPEG, MPEG, and YUV encoders

1092

for downsampling the chroma channels.</font></td></tr></table>

1093

1094

<tr>

1095

1096

1097

<img SRC="../images/right_triangle_option.png"

1098

ALT=">" BORDER=0 height=14

1099

width=15><b><font face="Helvetica, Arial"

1100

><font color="#FFFFFF"><font size="+1">

1101

<a name="details-contrast"></a>-contrast

1102

</font></font></font></b></td></tr></table>

1103

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table>

1104

1105

This option enhances the intensity differences between the lighter and

1106

darker elements of the image. Use <strong>-contrast</strong> to enhance

1107

the image

1108

or <strong>+contrast</strong> to reduce the image contrast.

1109

</font></td></tr></table>

1110

1111

For a more pronounced effect you can repeat the option:</font></td></tr></table>

1112

<pre>

1113

gm convert rose: -contrast -contrast rose_c2.png

1114

</pre>

1115

1116

<tr>

1117

1118

1119

<img SRC="../images/right_triangle_option.png"

1120

ALT=">" BORDER=0 height=14

1121

width=15><b><font face="Helvetica, Arial"

1122

><font color="#FFFFFF"><font size="+1">

1123

<a name="details-convolve"></a>-convolve <i><kernel></i>

1124

</font></font></font></b></td></tr></table>

1125

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>convolve image with the specified convolution kernel</td></tr></table>

1126

1127

The kernel is specified as a comma-separated list of integers, ordered

1128

left-to right, starting with the top row.

1129

The order of the kernel is determined by the square root of the

1130

number of entries. Presently only square kernels are supported.</font></td></tr></table>

1131

1132

<tr>

1133

1134

1135

<img SRC="../images/right_triangle_option.png"

1136

ALT=">" BORDER=0 height=14

1137

width=15><b><font face="Helvetica, Arial"

1138

><font color="#FFFFFF"><font size="+1">

1139

1140

</font></font></font></b></td></tr></table>

1141

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

1142

1143

See <strong>-geometry</strong> for details

1144

about the geometry specification.</font></td></tr></table>

1145

1146

The width and height give the size of the image that remains after cropping,

1147

and <em>x</em> and <em>y</em> are offsets that give the location of the top left

1148

corner of the cropped

1149

image with respect to the original image. To specify the amount to be

1150

removed, use <strong>-shave</strong> instead.</font></td></tr></table>

1151

1152

If the <em>x</em> and <em>y</em> offsets are present, a single image is

1153

generated, consisting of the pixels from the cropping region.

1154

The offsets specify the location of the upper left corner of

1155

the cropping region measured downward and rightward with respect to the

1156

upper left corner of the image.

1157

If the <strong>-gravity</strong> option is present with <em>NorthEast, East,</em>

1158

or <em>SouthEast</em>

1159

gravity, it gives the distance leftward from the right edge

1160

of the image to the right edge of the cropping region. Similarly, if

1161

the <strong>-gravity</strong> option is present with <em>SouthWest, South,</em>

1162

or <em>SouthEast</em>

1163

gravity, the distance is measured upward between the bottom

1164

edges.</font></td></tr></table>

1165

1166

If the <em>x</em> and <em>y</em> offsets are omitted, a set of tiles of the

1167

specified geometry, covering the entire input image, is generated. The

1168

rightmost tiles and the bottom tiles are smaller if the

1169

specified geometry extends beyond the dimensions of the input image.</font></td></tr></table>

1170

1171

<tr>

1172

1173

1174

<img SRC="../images/right_triangle_option.png"

1175

ALT=">" BORDER=0 height=14

1176

width=15><b><font face="Helvetica, Arial"

1177

><font color="#FFFFFF"><font size="+1">

1178

<a name="details-cycle"></a>-cycle <i><amount></i>

1179

</font></font></font></b></td></tr></table>

1180

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table>

1181

1182

<em>Amount</em> defines the number of positions each colormap entry isshifted.

1183

</font></td></tr></table>

1184

1185

<tr>

1186

1187

1188

<img SRC="../images/right_triangle_option.png"

1189

ALT=">" BORDER=0 height=14

1190

width=15><b><font face="Helvetica, Arial"

1191

><font color="#FFFFFF"><font size="+1">

1192

-debug <i><events></i>

1193

</font></font></font></b></td></tr></table>

1194

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

1195

1196

The <tt>events</tt> parameter specifies which events are to be logged. It

1197

can be either <tt>None</tt>, <tt>All</tt>, or a comma-separated list

1198

consisting of one or more of the following domains: <tt>Annotate</tt>,

1199

<tt>Blob</tt>, <tt>Cache</tt>, <tt>Coder</tt>, <tt>Configure</tt>,

1200

<tt>Deprecate</tt>, <tt>Error</tt>, <tt>Exception</tt>, <tt>Locale</tt>,

1201

<tt>Render</tt>,<tt>Resource</tt>, <tt>TemporaryFile</tt>,

1202

<tt>Transform</tt>, <tt>Warning</tt>, <tt>X11</tt>, or <tt>User</tt>.

1203

For example, to log cache and blob events, use</font></td></tr></table>

1204

<pre>

1205

gm convert -debug "Cache,Blob" rose: rose.png

1206

</pre>

1207

1208

The "User" domain is normally empty, but developers can log "User" events

1209

in their private copy of GraphicsMagick.</font></td></tr></table>

1210

1211

Use the <strong>-log</strong> option to specify the format for debugging output.</font></td></tr></table>

1212

1213

Use <strong>+debug</strong> to turn off all logging.</font></td></tr></table>

1214

1215

An alternative to using <strong>-debug</strong> is to use the <strong>MAGICK_DEBUG</strong>

1216

environment variable. The allowed values for the <strong>MAGICK_DEBUG</strong>

1217

environment variable are the same as for the <strong>-debug</strong> option.</font></td></tr></table>

1218

1219

<tr>

1220

1221

1222

<img SRC="../images/right_triangle_option.png"

1223

ALT=">" BORDER=0 height=14

1224

width=15><b><font face="Helvetica, Arial"

1225

><font color="#FFFFFF"><font size="+1">

1226

<a name="details-deconstruct"></a>-deconstruct

1227

</font></font></font></b></td></tr></table>

1228

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>break down an image sequence into constituent parts</td></tr></table>

1229

1230

This option compares each image with the next in a sequence and

1231

returns the maximum bounding region of any pixel differences it discovers.

1232

This method can undo a coalesced sequence returned by the

1233

<strong>-coalesce</strong> option, and is useful for removing redundant information

1234

from a GIF or MNG animation.</font></td></tr></table>

1235

1236

The sequence of images

1237

is terminated by the appearance of any option.

1238

If the <strong>-deconstruct</strong>

1239

option appears after all of the input images, all images are deconstructed.</font></td></tr></table>

1240

1241

<tr>

1242

1243

1244

<img SRC="../images/right_triangle_option.png"

1245

ALT=">" BORDER=0 height=14

1246

width=15><b><font face="Helvetica, Arial"

1247

><font color="#FFFFFF"><font size="+1">

1248

<a name="details-define"></a>-define <i><key></i>{<i>=<value></i>}<i>,...</i>

1249

</font></font></font></b></td></tr></table>

1250

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

1251

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">This option creates one or more definitions for coders and

1252

decoders to use while reading and writing image data. Definitions

1253

may be passed to coders and decoders to control options that are

1254

specific to certain image formats. If <em>value</em> is missing for a

1255

definition, an empty-valued definition of a flag will be created with

1256

that name. This is used to control on/off options. Use <tt>+define

1257

<key>,...</tt> to remove definitions previously created. Use

1258

<tt>+define "*"</tt> to remove all existing definitions.</font></td></tr></table>

1259

1260

The following definitions may be created:</font></td></tr></table>

1261

<dl>

1262

1263

<dd>

1264

Specify the compression factor to use while writing JPEG-2000

1265

files. The compression factor is the reciprocal of the compression

1266

ratio. The valid range is 0.0 to 1.0, with 1.0 indicating lossless

1267

compression. If defined, this value overrides the -quality

1268

setting. The default quality setting of 75 results in a rate value of

1269

0.06641.

1270

</dd>

1271

<dt>jpeg:preserve-settings</dt>

1272

<dd>

1273

If the jpeg:preserve-settings flag is defined, the JPEG encoder will

1274

use the same "quality" and "sampling-factor" settings that were found

1275

in the input file, if the input was in JPEG format. These settings are

1276

also preserved if the input is a JPEG file and the output is a JNG

1277

file. If the colorspace of the output file differs from that of the

1278

input file, the quality setting is preserved but the sampling-factors

1279

are not.

1280

</dd>

1281

<dt>ps:imagemask</dt>

1282

<dd>

1283

If the ps:imagemask flag is defined, the PS3 and EPS3 coders will

1284

create Postscript files that render bilevel images with the Postscript

1285

imagemask operator instead of the image operator.

1286

</dd>

1287

<dt>tiff:bits-per-sample=<value></dt>

1288

<dd>

1289

If the tiff:bits-per-sample key is defined to a value less than the

1290

GraphicsMagick Quantum depth, the TIFF coder will write TIFF images

1291

with the defined bits per sample, overriding any value stored in the

1292

image.

1293

</dd>

1294

<dt>tiff:samples-per-pixel=<value></dt>

1295

<dd>

1296

If the tiff:samples-per-pixel key is defined to a value, the TIFF

1297

coder will write TIFF images with the defined samples per pixel,

1298

overriding any value stored in the image.

1299

</dd>

1300

</dl>

1301

1302

For example, to create a postscript file that will render only the black

1303

pixels of a bilevel image, use:</font></td></tr></table>

1304

<pre>

1305

gm convert bilevel.tif -define ps:imagemask eps3:stencil.ps

1306

</pre>

1307

1308

<tr>

1309

1310

1311

<img SRC="../images/right_triangle_option.png"

1312

ALT=">" BORDER=0 height=14

1313

width=15><b><font face="Helvetica, Arial"

1314

><font color="#FFFFFF"><font size="+1">

1315

<a name="details-delay"></a>-delay <i><1/100ths of a second></i>

1316

</font></font></font></b></td></tr></table>

1317

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>

1318

1319

This option is useful for regulating the animation of image sequences

1320

<em>Delay/100</em> seconds must expire before the display

1321

of the next image. The default is no delay between each showing of the

1322

image sequence. The maximum delay is 65535.</font></td></tr></table>

1323

1324

You can specify a delay range (e.g. <em>-delay 10-500</em>) which sets the

1325

minimum and maximum delay.</font></td></tr></table>

1326

1327

<tr>

1328

1329

1330

<img SRC="../images/right_triangle_option.png"

1331

ALT=">" BORDER=0 height=14

1332

width=15><b><font face="Helvetica, Arial"

1333

><font color="#FFFFFF"><font size="+1">

1334

<a name="details-density"></a>-density <i><width>x<height></i>

1335

</font></font></font></b></td></tr></table>

1336

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

1337

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">This option specifies the image resolution to store while encoding a

1338

raster image or the canvas resolution while rendering (reading) vector

1339

formats such as Postscript, PDF, WMF, and SVG into a raster image. Image

1340

resolution provides the unit of measure to apply when rendering to an

1341

output device or raster image. The default unit of measure is in dots

1342

per inch (DPI). The <strong>-units</strong> option may be used to select dots per

1343

centimeter instead.</font></td></tr></table>

1344

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> The default resolution is 72 dots per inch, which is equivalent to

1345

one point per pixel (Macintosh and Postscript standard). Computer

1346

screens are normally 72 or 96 dots per inch while printers typically

1347

support 150, 300, 600, or 1200 dots per inch. To determine the

1348

resolution of your display, use a ruler to measure the width of your

1349

screen in inches, and divide by the number of horizontal pixels (1024 on

1350

a 1024x768 display).</font></td></tr></table>

1351

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">If the file format supports it, this option may be used to update

1352

the stored image resolution. Note that Photoshop stores and obtains

1353

image resolution from a proprietary embedded profile. If this profile is

1354

not stripped from the image, then Photoshop will continue to treat the

1355

image using its former resolution, ignoring the image resolution

1356

specified in the standard file header.</font></td></tr></table>

1357

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">The density option is an attribute and does not alter the underlying

1358

raster image. It may be used to adjust the rendered size for desktop

1359

publishing purposes by adjusting the scale applied to the pixels. To

1360

resize the image so that it is the same size at a different resolution,

1361

use the <strong>-resample</strong> option.</font></td></tr></table>

1362

1363

<tr>

1364

1365

1366

<img SRC="../images/right_triangle_option.png"

1367

ALT=">" BORDER=0 height=14

1368

width=15><b><font face="Helvetica, Arial"

1369

><font color="#FFFFFF"><font size="+1">

1370

<a name="details-depth"></a>-depth <i><value></i>

1371

</font></font></font></b></td></tr></table>

1372

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

1373

1374

This is the number of bits in a color sample within a pixel. The only

1375

acceptable values are 8 or 16. Use this option to specify the depth of

1376

raw images whose depth is unknown such as GRAY, RGB, or CMYK, or to change

1377

the depth of any image after it has been read.</font></td></tr></table>

1378

1379

<tr>

1380

1381

1382

<img SRC="../images/right_triangle_option.png"

1383

ALT=">" BORDER=0 height=14

1384

width=15><b><font face="Helvetica, Arial"

1385

><font color="#FFFFFF"><font size="+1">

1386

-descend

1387

</font></font></font></b></td></tr></table>

1388

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>obtain image by descending window hierarchy</td></tr></table>

1389

1390

<tr>

1391

1392

1393

<img SRC="../images/right_triangle_option.png"

1394

ALT=">" BORDER=0 height=14

1395

width=15><b><font face="Helvetica, Arial"

1396

><font color="#FFFFFF"><font size="+1">

1397

-despeckle

1398

</font></font></font></b></td></tr></table>

1399

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table>

1400

1401

<tr>

1402

1403

1404

<img SRC="../images/right_triangle_option.png"

1405

ALT=">" BORDER=0 height=14

1406

width=15><b><font face="Helvetica, Arial"

1407

><font color="#FFFFFF"><font size="+1">

1408

<a name="details-displace"></a>-displace <i><horizontal scale>x<vertical scale></i>

1409

</font></font></font></b></td></tr></table>

1410

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shift image pixels as defined by a displacement map</td></tr></table>

1411

1412

With this option, <em>composite image</em> is used as a displacement map. Black,

1413

within the displacement map, is a maximum positive displacement. White is a

1414

maximum negative displacement and middle gray is neutral. The displacement

1415

is scaled to determine the pixel shift. By default, the displacement applies

1416

in both the horizontal and vertical directions. However, if you specify

1417

<em>mask</em>, <em>composite image</em> is the horizontal X displacement and

1418

<em>mask</em> the vertical Y displacement.</font></td></tr></table>

1419

1420

<tr>

1421

1422

1423

<img SRC="../images/right_triangle_option.png"

1424

ALT=">" BORDER=0 height=14

1425

width=15><b><font face="Helvetica, Arial"

1426

><font color="#FFFFFF"><font size="+1">

1427

<a name="details-display"></a>-display <i><host:display[.screen]></i>

1428

</font></font></font></b></td></tr></table>

1429

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

1430

1431

This option is used with convert for

1432

obtaining image or font from this X server. See <em>X(1)</em>.</font></td></tr></table>

1433

1434

<tr>

1435

1436

1437

<img SRC="../images/right_triangle_option.png"

1438

ALT=">" BORDER=0 height=14

1439

width=15><b><font face="Helvetica, Arial"

1440

><font color="#FFFFFF"><font size="+1">

1441

<a name="details-dispose"></a>-dispose <i><method></i>

1442

</font></font></font></b></td></tr></table>

1443

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

1444

1445

The Disposal Method indicates the way in which the graphic is to

1446

be treated after being displayed.</font></td></tr></table>

1447

1448

Here are the valid methods:</font></td></tr></table>

1449

<pre>

1450

Undefined No disposal specified.

1451

None Do not dispose between frames.

1452

Background Overwrite the image area with

1453

the background color.

1454

Previous Overwrite the image area with

1455

what was there prior to rendering

1456

the image.

1457

</pre>

1458

1459

<tr>

1460

1461

1462

<img SRC="../images/right_triangle_option.png"

1463

ALT=">" BORDER=0 height=14

1464

width=15><b><font face="Helvetica, Arial"

1465

><font color="#FFFFFF"><font size="+1">

1466

<a name="details-dissolve"></a>-dissolve <i><percent></i>

1467

</font></font></font></b></td></tr></table>

1468

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>dissolve an image into another by the given percent</td></tr></table>

1469

1470

The opacity of the composite image is multiplied by the given percent,

1471

then it is composited over the main image.</font></td></tr></table>

1472

1473

<tr>

1474

1475

1476

<img SRC="../images/right_triangle_option.png"

1477

ALT=">" BORDER=0 height=14

1478

width=15><b><font face="Helvetica, Arial"

1479

><font color="#FFFFFF"><font size="+1">

1480

<a name="details-dither"></a>-dither

1481

</font></font></font></b></td></tr></table>

1482

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

1483

1484

The basic strategy of dithering is to trade intensity resolution for spatial

1485

resolution by averaging the intensities of several neighboring pixels.

1486

Images which suffer from severe contouring when reducing colors can be

1487

improved with this option.</font></td></tr></table>

1488

1489

The <strong>-colors</strong> or <strong>-monochrome</strong> option is required for this option

1490

to take effect.</font></td></tr></table>

1491

1492

Use <strong>+dither</strong> to turn off dithering and to render PostScript

1493

without text or graphic aliasing. Disabling dithering often (but not

1494

always) leads to decreased processing time.</font></td></tr></table>

1495

1496

<tr>

1497

1498

1499

<img SRC="../images/right_triangle_option.png"

1500

ALT=">" BORDER=0 height=14

1501

width=15><b><font face="Helvetica, Arial"

1502

><font color="#FFFFFF"><font size="+1">

1503

1504

</font></font></font></b></td></tr></table>

1505

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table>

1506

1507

Use this option to annotate an image with one or more graphic primitives.

1508

The primitives include shapes, text, transformations,

1509

and pixel operations. The shape primitives are</font></td></tr></table>

1510

<pre>

1511

point x,y

1512

line x0,y0 x1,y1

1513

rectangle x0,y0 x1,y1

1514

roundRectangle x0,y0 x1,y1 wc,hc

1515

arc x0,y0 x1,y1 a0,a1

1516

ellipse x0,y0 rx,ry a0,a1

1517

circle x0,y0 x1,y1

1518

polyline x0,y0 ... xn,yn

1519

polygon x0,y0 ... xn,yn

1520

Bezier x0,y0 ... xn,yn

1521

path path specification

1522

image operator x0,y0 w,h filename

1523

</pre>

1524

1525

The text primitive is</font></td></tr></table>

1526

<pre>

1527

text x0,y0 string

1528

</pre>

1529

1530

The text gravity primitive is</font></td></tr></table>

1531

<pre>

1532

gravity NorthWest, North, NorthEast, West, Center,

1533

East, SouthWest, South, or SouthEast

1534

</pre>

1535

1536

The text gravity primitive only affects the placement of text and

1537

does not interact with the other primitives. It is equivalent to

1538

using the <strong>-gravity</strong> commandline option, except that it is

1539

limited in scope to the <strong>-draw</strong> option in which it appears.</font></td></tr></table>

1540

1541

The transformation primitives are</font></td></tr></table>

1542

<pre>

1543

rotate degrees

1544

translate dx,dy

1545

scale sx,sy

1546

skewX degrees

1547

skewY degrees

1548

</pre>

1549

1550

The pixel operation primitives are</font></td></tr></table>

1551

<pre>

1552

color x0,y0 method

1553

matte x0,y0 method

1554

</pre>

1555

1556

The shape primitives are drawn in the color specified in the preceding

1557

<strong>-stroke</strong> option. Except for the <strong>line</strong> and <strong>point</strong>

1558

primitives, they are filled with the color specified in the preceding

1559

<strong>-fill</strong> option. For unfilled shapes, use <tt>-fill none</tt></font></td></tr></table>.

1560

1561

<strong>Point</strong> requires a single coordinate.</font></td></tr></table>

1562

1563

<strong>Line</strong> requires a start and end coordinate.</font></td></tr></table>

1564

1565

<strong>Rectangle</strong>

1566

expects an upper left and lower right coordinate.</font></td></tr></table>

1567

1568

<strong>RoundRectangle</strong> has the upper left and lower right coordinates

1569

and the width and height of the corners.</font></td></tr></table>

1570

1571

<strong>Circle</strong> has a center coordinate and a coordinate for

1572

the outer edge.</font></td></tr></table>

1573

1574

Use <strong>Arc</strong> to inscribe an elliptical arc within

1575

a rectangle. Arcs require a start and end point as well as the degree

1576

of rotation (e.g. 130,30 200,100 45,90).</font></td></tr></table>

1577

1578

Use <strong>Ellipse</strong> to draw a partial ellipse

1579

centered at the given point with the x-axis and y-axis radius

1580

and start and end of arc in degrees (e.g. 100,100 100,150 0,360).</font></td></tr></table>

1581

1582

Finally, <strong>polyline</strong> and <strong>polygon</strong> require

1583

three or more coordinates to define its boundaries.

1584

Coordinates are integers separated by an optional comma. For example,

1585

to define a circle centered at 100,100

1586

that extends to 150,150 use:</font></td></tr></table>

1587

<pre>

1588

-draw 'circle 100,100 150,150'

1589

</pre>

1590

1591

<strong>Paths</strong>

1592

(See <a href="http://www.w3.org/TR/SVG/paths.html">Paths</a>)

1593

represent an outline of an object which is defined in terms of

1594

moveto (set a new current point), lineto (draw a straight line),

1595

curveto (draw a curve using a cubic Bezier), arc (elliptical or

1596

circular arc) and closepath (close the current shape by drawing a line

1597

to the last moveto) elements. Compound paths (i.e., a path with

1598

subpaths, each consisting of a single moveto followed by one or more

1599

line or curve operations) are possible to allow effects such as

1600

"donut holes" in objects.</font></td></tr></table>

1601

1602

Use <strong>image</strong> to composite an image with another image. Follow the

1603

image keyword with the composite operator, image location, image size,

1604

and filename:</font></td></tr></table>

1605

<pre>

1606

-draw 'image Over 100,100 225,225 image.jpg'

1607

</pre>

1608

1609

You can use 0,0 for the image size, which means to use the actual

1610

dimensions found in the image header. Otherwise, it will

1611

be scaled to the given dimensions.

1612

See <strong>-compose</strong> for a description of the composite operators.</font></td></tr></table>

1613

1614

Use <strong>text</strong> to annotate an image with text. Follow the text

1615

coordinates with a string. If the string has embedded spaces, enclose it

1616

in single or double quotes. Optionally you can include the image

1617

filename, type, width, height, or other image attribute by embedding

1618

special format character. See <strong>-comment</strong> for details.</font></td></tr></table>

1619

1620

For example,

1621

</font></td></tr></table>

1622

<pre>

1623

-draw 'text 100,100 "%m:%f %wx%h"'

1624

</pre>

1625

1626

annotates the image with <tt>MIFF:bird.miff 512x480</tt> for an image titled

1627

1628

and whose width is 512 and height is 480.</font></td></tr></table>

1629

1630

If the first character of <em>string</em> is <em>@</em>, the text is read from

1631

a file titled by the remaining characters in the string.</font></td></tr></table>

1632

1633

<strong>Rotate</strong> rotates subsequent shape primitives and text primitives about

1634

the origin of the main image. If the <strong>-region</strong> option precedes the

1635

<strong>-draw</strong> option, the origin for transformations is the upper left

1636

corner of the region.</font></td></tr></table>

1637

1638

<strong>Translate</strong> translates them.</font></td></tr></table>

1639

1640

<strong>Scale</strong> scales them.</font></td></tr></table>

1641

1642

<strong>SkewX</strong> and <strong>SkewY</strong> skew them with respect to the origin of

1643

the main image or the region.</font></td></tr></table>

1644

1645

The transformations modify the current affine matrix, which is initialized

1646

from the initial affine matrix defined by the <strong>-affine</strong> option.

1647

Transformations are cumulative within the <strong>-draw</strong> option.

1648

The initial affine matrix is not affected; that matrix is only changed by the

1649

appearance of another <strong>-affine</strong> option. If another <strong>-draw</strong>

1650

option appears, the current affine matrix is reinitialized from

1651

the initial affine matrix.</font></td></tr></table>

1652

1653

Use <strong>color</strong> to change the color of a pixel to the fill color (see

1654

<strong>-fill</strong>). Follow the pixel coordinate

1655

with a method:</font></td></tr></table>

1656

<pre>

1657

point

1658

replace

1659

floodfill

1660

filltoborder

1661

reset

1662

</pre>

1663

1664

Consider the target pixel as that specified by your coordinate. The

1665

<strong>point</strong>

1666

method recolors the target pixel. The <strong>replace</strong> method recolors any

1667

pixel that matches the color of the target pixel.

1668

<strong>Floodfill</strong> recolors

1669

any pixel that matches the color of the target pixel and is a neighbor,

1670

whereas <strong>filltoborder</strong> recolors any neighbor pixel that is not the

1671

border color. Finally, <strong>reset</strong> recolors all pixels.</font></td></tr></table>

1672

1673

Use <strong>matte</strong> to the change the pixel matte value to transparent. Follow

1674

the pixel coordinate with a method (see the <strong>color</strong> primitive for

1675

a description of methods). The <strong>point</strong> method changes the matte value

1676

of the target pixel. The <strong>replace</strong> method changes the matte value

1677

of any pixel that matches the color of the target pixel. <strong>Floodfill</strong>

1678

changes the matte value of any pixel that matches the color of the target

1679

pixel and is a neighbor, whereas

1680

<strong>filltoborder</strong> changes the matte

1681

value of any neighbor pixel that is not the border color (<strong>-bordercolor</strong>).

1682

Finally <strong>reset</strong> changes the matte value of all pixels.</font></td></tr></table>

1683

1684

You can set the primitive color, font, and font bounding box

1685

color with

1686

<strong>-fill</strong>, <strong>-font</strong>, and <strong>-box</strong> respectively. Options

1687

are processed in command line order so be sure to use these

1688

options <em>before</em> the <strong>-draw</strong> option.</font></td></tr></table>

1689

1690

<tr>

1691

1692

1693

<img SRC="../images/right_triangle_option.png"

1694

ALT=">" BORDER=0 height=14

1695

width=15><b><font face="Helvetica, Arial"

1696

><font color="#FFFFFF"><font size="+1">

1697

-edge <i><radius></i>

1698

</font></font></font></b></td></tr></table>

1699

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table>

1700

1701

<tr>

1702

1703

1704

<img SRC="../images/right_triangle_option.png"

1705

ALT=">" BORDER=0 height=14

1706

width=15><b><font face="Helvetica, Arial"

1707

><font color="#FFFFFF"><font size="+1">

1708

-emboss <i><radius></i>

1709

</font></font></font></b></td></tr></table>

1710

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table>

1711

1712

<tr>

1713

1714

1715

<img SRC="../images/right_triangle_option.png"

1716

ALT=">" BORDER=0 height=14

1717

width=15><b><font face="Helvetica, Arial"

1718

><font color="#FFFFFF"><font size="+1">

1719

<a name="details-encoding"></a>-encoding <i><type></i>

1720

</font></font></font></b></td></tr></table>

1721

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table>

1722

1723

Choose from <em>AdobeCustom, AdobeExpert, AdobeStandard, AppleRoman,

1724

BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.</em></font></td></tr></table>

1725

1726

<tr>

1727

1728

1729

<img SRC="../images/right_triangle_option.png"

1730

ALT=">" BORDER=0 height=14

1731

width=15><b><font face="Helvetica, Arial"

1732

><font color="#FFFFFF"><font size="+1">

1733

<a name="details-endian"></a>-endian <i><type></i>

1734

</font></font></font></b></td></tr></table>

1735

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

1736

1737

Use <strong>+endian</strong> to revert to unspecified endianness.</font></td></tr></table>

1738

1739

<tr>

1740

1741

1742

<img SRC="../images/right_triangle_option.png"

1743

ALT=">" BORDER=0 height=14

1744

width=15><b><font face="Helvetica, Arial"

1745

><font color="#FFFFFF"><font size="+1">

1746

-enhance

1747

</font></font></font></b></td></tr></table>

1748

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table>

1749

1750

<tr>

1751

1752

1753

<img SRC="../images/right_triangle_option.png"

1754

ALT=">" BORDER=0 height=14

1755

width=15><b><font face="Helvetica, Arial"

1756

><font color="#FFFFFF"><font size="+1">

1757

-equalize

1758

</font></font></font></b></td></tr></table>

1759

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform histogram equalization to the image</td></tr></table>

1760

1761

<tr>

1762

1763

1764

<img SRC="../images/right_triangle_option.png"

1765

ALT=">" BORDER=0 height=14

1766

width=15><b><font face="Helvetica, Arial"

1767

><font color="#FFFFFF"><font size="+1">

1768

1769

</font></font></font></b></td></tr></table>

1770

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table>

1771

1772

Colors are represented in GraphicsMagick in the same form used by SVG. Use "gm convert -list color" to list named colors:</font></td></tr></table>

1773

<pre>

1774

name (named color)

1775

#RGB (hex numbers, 4 bits each)

1776

#RRGGBB (8 bits each)

1777

#RRRGGGBBB (12 bits each)

1778

#RRRRGGGGBBBB (16 bits each)

1779

#RGBA (4 bits each)

1780

#RRGGBBAA (8 bits each)

1781

#RRRGGGBBBAAA (12 bits each)

1782

#RRRRGGGGBBBBAAAA (16 bits each)

1783

rgb(r,g,b) (r,g,b are decimal numbers)

1784

rgba(r,g,b,a) (r,g,b,a are decimal numbers)

1785

</pre>

1786

1787

Enclose the color specification in quotation marks to prevent the "#"

1788

or the parentheses from being interpreted by your shell.</font></td></tr></table>

1789

1790

For example,</font></td></tr></table>

1791

<pre>

1792

gm convert -fill blue ...

1793

gm convert -fill "#ddddff" ...

1794

gm convert -fill "rgb(65000,65000,65535)" ...

1795

</pre>

1796

1797

The shorter forms are scaled up, if necessary by replication. For example,

1798

#3af, #33aaff, and #3333aaaaffff are all equivalent.</font></td></tr></table>

1799

1800

See <strong>-draw</strong> for further details.</font></td></tr></table>

1801

1802

<tr>

1803

1804

1805

<img SRC="../images/right_triangle_option.png"

1806

ALT=">" BORDER=0 height=14

1807

width=15><b><font face="Helvetica, Arial"

1808

><font color="#FFFFFF"><font size="+1">

1809

<a name="details-filter"></a>-filter <i><type></i>

1810

</font></font></font></b></td></tr></table>

1811

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>

1812

1813

Use this option to affect the resizing operation of an image (see

1814

<strong>-geometry</strong>).

1815

Choose from these filters:</font></td></tr></table>

1816

<pre>

1817

Point

1818

Box

1819

Triangle

1820

Hermite

1821

Hanning

1822

Hamming

1823

Blackman

1824

Gaussian

1825

Quadratic

1826

Cubic

1827

Catrom

1828

Mitchell

1829

Lanczos

1830

Bessel

1831

Sinc

1832

</pre>

1833

1834

The default filter is automatically selected to provide the best quality

1835

while consuming a reasonable amount of time. The <strong>Mitchell</strong> filter

1836

is used if the image supports a palette, supports a matte channel, or is

1837

being enlarged, otherwise the <strong>Lanczos</strong> filter is used.</font></td></tr></table>

1838

1839

<tr>

1840

1841

1842

<img SRC="../images/right_triangle_option.png"

1843

ALT=">" BORDER=0 height=14

1844

width=15><b><font face="Helvetica, Arial"

1845

><font color="#FFFFFF"><font size="+1">

1846

<a name="details-flatten"></a>-flatten

1847

</font></font></font></b></td></tr></table>

1848

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>flatten a sequence of images</td></tr></table>

1849

1850

The sequence of images is replaced by a single image created by composing each

1851

image after the first over the first image.</font></td></tr></table>

1852

1853

The sequence of images

1854

is terminated by the appearance of any option.

1855

If the <strong>-flatten</strong>

1856

option appears after all of the input images, all images are flattened.</font></td></tr></table>

1857

1858

<tr>

1859

1860

1861

<img SRC="../images/right_triangle_option.png"

1862

ALT=">" BORDER=0 height=14

1863

width=15><b><font face="Helvetica, Arial"

1864

><font color="#FFFFFF"><font size="+1">

1865

<a name="details-flip"></a>-flip

1866

</font></font></font></b></td></tr></table>

1867

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

1868

1869

reflect the scanlines in the vertical direction.</font></td></tr></table>

1870

1871

<tr>

1872

1873

1874

<img SRC="../images/right_triangle_option.png"

1875

ALT=">" BORDER=0 height=14

1876

width=15><b><font face="Helvetica, Arial"

1877

><font color="#FFFFFF"><font size="+1">

1878

<a name="details-flop"></a>-flop

1879

</font></font></font></b></td></tr></table>

1880

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

1881

1882

reflect the scanlines in the horizontal direction.</font></td></tr></table>

1883

1884

<tr>

1885

1886

1887

<img SRC="../images/right_triangle_option.png"

1888

ALT=">" BORDER=0 height=14

1889

width=15><b><font face="Helvetica, Arial"

1890

><font color="#FFFFFF"><font size="+1">

1891

1892

</font></font></font></b></td></tr></table>

1893

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

1894

1895

You can tag a font to specify whether it is a PostScript, TrueType, or OPTION1

1896

font. For example, <tt>Arial.ttf</tt> is a TrueType font, <tt>ps:helvetica</tt>

1897

is PostScript, and <tt>x:fixed</tt> is OPTION1.</font></td></tr></table>

1898

1899

<tr>

1900

1901

1902

<img SRC="../images/right_triangle_option.png"

1903

ALT=">" BORDER=0 height=14

1904

width=15><b><font face="Helvetica, Arial"

1905

><font color="#FFFFFF"><font size="+1">

1906

<a name="details-foreground"></a>-foreground <i><color></i>

1907

</font></font></font></b></td></tr></table>

1908

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table>

1909

1910

The color is specified using the format described under the <strong>-fill</strong>

1911

option.</font></td></tr></table>

1912

1913

<tr>

1914

1915

1916

<img SRC="../images/right_triangle_option.png"

1917

ALT=">" BORDER=0 height=14

1918

width=15><b><font face="Helvetica, Arial"

1919

><font color="#FFFFFF"><font size="+1">

1920

<a name="details-format"></a>-format <i><type></i>

1921

</font></font></font></b></td></tr></table>

1922

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image format type</td></tr></table>

1923

1924

When used with the <strong>mogrify</strong> utility,

1925

this option will convert any image to the image format you specify.

1926

See <em>GraphicsMagick(1)</em> for a list of image format types supported by

1927

<strong>GraphicsMagick</strong>, or see the output of 'gm -list format'.</font></td></tr></table>

1928

1929

By default the file is written to its original name. However, if the

1930

filename extension matches a supported format, the extension is replaced

1931

with the image format type specified with <strong>-format</strong>. For example,

1932

if you specify <em>tiff</em> as the format type and the input image

1933

filename is <em>image.gif</em>, the output image filename becomes

1934

<em>image.tiff</em>.</font></td></tr></table>

1935

1936

<tr>

1937

1938

1939

<img SRC="../images/right_triangle_option.png"

1940

ALT=">" BORDER=0 height=14

1941

width=15><b><font face="Helvetica, Arial"

1942

><font color="#FFFFFF"><font size="+1">

1943

<a name="details-format"></a>-format <i><string></i>

1944

</font></font></font></b></td></tr></table>

1945

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table>

1946

1947

When used with the <strong>identify</strong> utility,

1948

use this option to print information about the image in a format of your

1949

choosing. You can include the image filename, type, width, height,

1950

Exif data, or other image attributes by embedding special format

1951

characters:</font></td></tr></table>

1952

<pre>

1953

%b file size

1954

%c comment

1955

%d directory

1956

%e filename extension

1957

%f filename

1958

%h height

1959

%i input filename

1960

%k number of unique colors

1961

%l label

1962

%m magick

1963

%n number of scenes

1964

%o output filename

1965

%p page number

1966

%q quantum depth

1967

%s scene number

1968

%t top of filename

1969

%u unique temporary filename

1970

%w width

1971

%x x resolution

1972

%y y resolution

1973

%# signature

1974

\n newline

1975

\r carriage return

1976

</pre>

1977

1978

For example,</font></td></tr></table>

1979

<pre>

1980

-format "%m:%f %wx%h"

1981

</pre>

1982

1983

displays <strong>MIFF:bird.miff 512x480</strong> for an image

1984

titled <strong>bird.miff</strong> and whose width is 512 and height is 480.</font></td></tr></table>

1985

1986

If the first character of <em>string</em> is <strong>@</strong>, the format

1987

is read from a file titled by the remaining characters in the string.</font></td></tr></table>

1988

1989

You can also use the following special formatting syntax to print Exif

1990

information contained in the file:</font></td></tr></table>

1991

<pre>

1992

%[EXIF:<tag>]

1993

</pre>

1994

1995

Where "<tag>" can be one of the following:</font></td></tr></table>

1996

<pre>

1997

* (print all Exif tags, in keyword=data format)

1998

! (print all Exif tags, in tag_number data format)

1999

#hhhh (print data for Exif tag #hhhh)

2000

ImageWidth

2001

ImageLength

2002

BitsPerSample

2003

Compression

2004

PhotometricInterpretation

2005

FillOrder

2006

DocumentName

2007

ImageDescription

2008

Make

2009

Model

2010

StripOffsets

2011

Orientation

2012

SamplesPerPixel

2013

RowsPerStrip

2014

StripByteCounts

2015

XResolution

2016

YResolution

2017

PlanarConfiguration

2018

ResolutionUnit

2019

TransferFunction

2020

Software

2021

DateTime

2022

Artist

2023

WhitePoint

2024

PrimaryChromaticities

2025

TransferRange

2026

JPEGProc

2027

JPEGInterchangeFormat

2028

JPEGInterchangeFormatLength

2029

YCbCrCoefficients

2030

YCbCrSubSampling

2031

YCbCrPositioning

2032

ReferenceBlackWhite

2033

CFARepeatPatternDim

2034

CFAPattern

2035

BatteryLevel

2036

Copyright

2037

ExposureTime

2038

FNumber

2039

IPTC/NAA

2040

ExifOffset

2041

InterColorProfile

2042

ExposureProgram

2043

SpectralSensitivity

2044

GPSInfo

2045

ISOSpeedRatings

2046

OECF

2047

ExifVersion

2048

DateTimeOriginal

2049

DateTimeDigitized

2050

ComponentsConfiguration

2051

CompressedBitsPerPixel

2052

ShutterSpeedValue

2053

ApertureValue

2054

BrightnessValue

2055

ExposureBiasValue

2056

MaxApertureValue

2057

SubjectDistance

2058

MeteringMode

2059

LightSource

2060

Flash

2061

FocalLength

2062

MakerNote

2063

UserComment

2064

SubSecTime

2065

SubSecTimeOriginal

2066

SubSecTimeDigitized

2067

FlashPixVersion

2068

ColorSpace

2069

ExifImageWidth

2070

ExifImageLength

2071

InteroperabilityOffset

2072

FlashEnergy

2073

SpatialFrequencyResponse

2074

FocalPlaneXResolution

2075

FocalPlaneYResolution

2076

FocalPlaneResolutionUnit

2077

SubjectLocation

2078

ExposureIndex

2079

SensingMethod

2080

FileSource

2081

SceneType

2082

</pre>

2083

2084

Surround the format specification with quotation marks to prevent your shell

2085

from misinterpreting any spaces and square brackets.</font></td></tr></table>

2086

2087

<tr>

2088

2089

2090

<img SRC="../images/right_triangle_option.png"

2091

ALT=">" BORDER=0 height=14

2092

width=15><b><font face="Helvetica, Arial"

2093

><font color="#FFFFFF"><font size="+1">

2094

<a name="details-frame"></a>-frame <i><width>x<height>+<outer bevel width>+<inner bevel width></i>

2095

</font></font></font></b></td></tr></table>

2096

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table>

2097

2098

See <strong>-geometry</strong> for details about the geometry

2099

specification. The <strong>-frame</strong> option is not affected by the

2100

<strong>-gravity</strong> option.</font></td></tr></table>

2101

2102

The color of the border is specified with the <strong>-mattecolor</strong>

2103

command line option.</font></td></tr></table>

2104

2105

<tr>

2106

2107

2108

<img SRC="../images/right_triangle_option.png"

2109

ALT=">" BORDER=0 height=14

2110

width=15><b><font face="Helvetica, Arial"

2111

><font color="#FFFFFF"><font size="+1">

2112

-frame

2113

</font></font></font></b></td></tr></table>

2114

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>include the X window frame in the imported image</td></tr></table>

2115

2116

<tr>

2117

2118

2119

<img SRC="../images/right_triangle_option.png"

2120

ALT=">" BORDER=0 height=14

2121

width=15><b><font face="Helvetica, Arial"

2122

><font color="#FFFFFF"><font size="+1">

2123

2124

</font></font></font></b></td></tr></table>

2125

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors within this distance are considered equal</td></tr></table>

2126

2127

A number of algorithms search for a target color. By default the color

2128

must be exact. Use this option to match colors that are close to the target

2129

color in RGB space. For example, if you want to automatically trim the

2130

edges of an image with <strong>-trim</strong> but the image was scanned and the

2131

target background color may differ by a small amount. This option can account

2132

for these differences.</font></td></tr></table>

2133

2134

The <em>distance</em> can be in absolute intensity units or, by appending

2135

<em>"%"</em>, as a percentage of the maximum possible intensity (255,

2136

65535, or 4294967295).</font></td></tr></table>

2137

2138

<tr>

2139

2140

2141

<img SRC="../images/right_triangle_option.png"

2142

ALT=">" BORDER=0 height=14

2143

width=15><b><font face="Helvetica, Arial"

2144

><font color="#FFFFFF"><font size="+1">

2145

<a name="details-gamma"></a>-gamma <i><value></i>

2146

</font></font></font></b></td></tr></table>

2147

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>

2148

2149

The same color image displayed on two different workstations may look

2150

different due to differences in the display monitor. Use gamma

2151

correction to adjust for this color difference. Reasonable values extend

2152

from <strong>0.8</strong> to <strong>2.3</strong>. Gamma less than 1.0 darkens the image and

2153

gamma greater than 1.0 lightens it. Large adjustments to image gamma may

2154

result in the loss of some image information if the pixel quantum size

2155

is only eight bits (quantum range 0 to 255).</font></td></tr></table>

2156

2157

You can apply separate gamma values to the red, green, and blue channels

2158

of the image with a gamma value list delimited with slashes

2159

(e.g., <strong>1.7</strong>/<strong>2.3</strong>/<strong>1.2</strong>).</font></td></tr></table>

2160

2161

Use <strong>+gamma</strong> <em>value</em>

2162

to set the image gamma level without actually adjusting

2163

the image pixels. This option is useful if the image is of a known gamma

2164

but not set as an image attribute (e.g. PNG images).</font></td></tr></table>

2165

2166

<tr>

2167

2168

2169

<img SRC="../images/right_triangle_option.png"

2170

ALT=">" BORDER=0 height=14

2171

width=15><b><font face="Helvetica, Arial"

2172

><font color="#FFFFFF"><font size="+1">

2173

<a name="details-Gaussian"></a>-Gaussian <i><radius></i>{<i>x<sigma></i>}<i></i>

2174

</font></font></font></b></td></tr></table>

2175

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

2176

2177

Use the given radius and standard deviation (sigma).</font></td></tr></table>

2178

2179

<tr>

2180

2181

2182

<img SRC="../images/right_triangle_option.png"

2183

ALT=">" BORDER=0 height=14

2184

width=15><b><font face="Helvetica, Arial"

2185

><font color="#FFFFFF"><font size="+1">

2186

<a name="details-geometry"></a>-geometry <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

2187

</font></font></font></b></td></tr></table>

2188

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

2189

2190

By default, the window size is the image

2191

size and the location is chosen by you when it is mapped.</font></td></tr></table>

2192

2193

By default, the width and height are maximum values. That is, the image

2194

is expanded or contracted to fit the width and height value while maintaining

2195

the aspect ratio of the image. <em>Append an exclamation point to the geometry

2196

to force the image size to exactly the size you specify</em>. For example,

2197

if you specify <tt>640x480!</tt> the image width is set to 640 pixels and

2198

height to 480.</font></td></tr></table>

2199

2200

If only the width is specified, the width assumes the

2201

value and the height is chosen to maintain the aspect ratio of the image.

2202

Similarly, if only the height is specified (e.g., <tt>-geometry x256</tt>),

2203

the width is chosen to maintain the aspect ratio.</font></td></tr></table>

2204

2205

To specify a percentage width or height instead, append %. The image size

2206

is multiplied by the width and height percentages to obtain the final image

2207

dimensions. To increase the size of an image, use a value greater than

2208

100 (e.g. 125%). To decrease an image's size, use a percentage less than

2209

100.</font></td></tr></table>

2210

2211

Use <tt>@</tt> to specify the maximum area in pixels of an image.</font></td></tr></table>

2212

2213

Use <tt>></tt> to change the dimensions of the image <em>only</em> if

2214

its width or height exceeds the geometry specification. <tt><</tt> resizes

2215

the image <em>only</em> if both of its dimensions are less than the geometry

2216

specification. For example,

2217

if you specify <tt>'640x480>'</tt> and the image size is 256x256, the image

2218

size does not change. However, if the image is 512x512 or 1024x1024, it is

2219

resized to 480x480. Enclose the geometry specification in quotation marks to

2220

prevent the <tt><</tt> or <tt>></tt> from being interpreted by your shell

2221

as a file redirection.</font></td></tr></table>

2222

2223

When used with <em>animate</em> and <em>display</em>, offsets are handled in

2224

the same manner as in <em>X(1)</em> and the <strong>-gravity</strong> option is not used.

2225

If the <em>x</em> is negative, the offset is measured leftward

2226

from the right edge of the

2227

screen to the right edge of the image being displayed.

2228

Similarly, negative <em>y</em> is measured between the bottom edges. The

2229

offsets are not affected by "%"; they are always measured in pixels.</font></td></tr></table>

2230

2231

When used as a <em>composite</em> option, <strong>-geometry</strong>

2232

gives the dimensions of the image and its location with respect

2233

to the composite image. If the <strong>-gravity</strong> option is present

2234

with <em>NorthEast, East,</em> or <em>SouthEast</em> gravity, the <em>x</em>

2235

represents the distance from the right edge of the image to the right edge of

2236

the composite image. Similarly, if the <strong>-gravity</strong> option is present

2237

with <em>SouthWest, South,</em> or <em>SouthEast</em> gravity, <em>y</em>

2238

is measured between the bottom edges. Accordingly, a positive offset will

2239

never point in the direction outside of the image. The

2240

offsets are not affected by "%"; they are always measured in pixels.

2241

To specify the dimensions of the composite image, use the <strong>-resize</strong>

2242

option.</font></td></tr></table>

2243

2244

When used as a <em>convert</em>, <em>import</em> or <em>mogrify</em> option,

2245

<strong>-geometry</strong> is synonymous with <strong>-resize</strong> and

2246

specifies the size of the output image. The offsets, if present, are ignored.</font></td></tr></table>

2247

2248

When used as a <em>montage</em> option, <strong>-geometry</strong> specifies the image

2249

size and border size for each tile; default is 256x256+0+0. Negative

2250

offsets (border dimensions) are meaningless. The <strong>-gravity</strong>

2251

option affects the placement of the image within the tile; the default

2252

gravity for this purpose is <em>Center</em>. If the "%" sign appears in

2253

the geometry specification, the tile size is the specified percentage of

2254

the original dimensions of the first tile.

2255

To specify the dimensions of the montage, use the <strong>-resize</strong>

2256

option.</font></td></tr></table>

2257

2258

<tr>

2259

2260

2261

<img SRC="../images/right_triangle_option.png"

2262

ALT=">" BORDER=0 height=14

2263

width=15><b><font face="Helvetica, Arial"

2264

><font color="#FFFFFF"><font size="+1">

2265

<a name="details-gravity"></a>-gravity <i><type></i>

2266

</font></font></font></b></td></tr></table>

2267

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table>

2268

2269

Choices are: NorthWest, North,

2270

NorthEast, West, Center, East, SouthWest, South, SouthEast.</font></td></tr></table>

2271

2272

The direction you choose specifies where to position the text

2273

when annotating

2274

the image. For example <em>Center</em> gravity forces the text to be centered

2275

within the image. By default, the image gravity is <em>NorthWest</em>.

2276

See <strong>-draw</strong> for more details about graphic primitives. Only the

2277

text primitive is affected by the <strong>-gravity</strong> option.</font></td></tr></table>

2278

2279

The <strong>-gravity</strong> option is also used in concert with the <strong>-geometry</strong>

2280

option and other options that take <strong><geometry></strong> as a parameter, such

2281

as the <strong>-crop</strong> option. See <strong>-geometry</strong> for details of how the

2282

<strong>-gravity</strong> option interacts with the

2283

<strong><x></strong> and <strong><y></strong> parameters of a geometry

2284

specification.</font></td></tr></table>

2285

2286

When used as an option to <em>composite</em>, <strong>-gravity</strong>

2287

gives the direction that the image gravitates within the composite.</font></td></tr></table>

2288

2289

When used as an option to <em>montage</em>, <strong>-gravity</strong> gives the direction

2290

that an image gravitates within a tile. The default gravity is <em>Center</em>

2291

for this purpose.</font></td></tr></table>

2292

2293

<tr>

2294

2295

2296

<img SRC="../images/right_triangle_option.png"

2297

ALT=">" BORDER=0 height=14

2298

width=15><b><font face="Helvetica, Arial"

2299

><font color="#FFFFFF"><font size="+1">

2300

<a name="details-green-primary"></a>-green-primary <i><x>,<y></i>

2301

</font></font></font></b></td></tr></table>

2302

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table>

2303

2304

<tr>

2305

2306

2307

<img SRC="../images/right_triangle_option.png"

2308

ALT=">" BORDER=0 height=14

2309

width=15><b><font face="Helvetica, Arial"

2310

><font color="#FFFFFF"><font size="+1">

2311

-help

2312

</font></font></font></b></td></tr></table>

2313

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

2314

2315

<tr>

2316

2317

2318

<img SRC="../images/right_triangle_option.png"

2319

ALT=">" BORDER=0 height=14

2320

width=15><b><font face="Helvetica, Arial"

2321

><font color="#FFFFFF"><font size="+1">

2322

<a name="details-iconGeometry"></a>-iconGeometry <i><geometry></i>

2323

</font></font></font></b></td></tr></table>

2324

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table>

2325

2326

Offsets, if present in the geometry specification, are handled in

2327

the same manner as the <strong>-geometry</strong> option, using X11 style to handle

2328

negative offsets.</font></td></tr></table>

2329

2330

<tr>

2331

2332

2333

<img SRC="../images/right_triangle_option.png"

2334

ALT=">" BORDER=0 height=14

2335

width=15><b><font face="Helvetica, Arial"

2336

><font color="#FFFFFF"><font size="+1">

2337

-iconic

2338

</font></font></font></b></td></tr></table>

2339

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table>

2340

2341

<tr>

2342

2343

2344

<img SRC="../images/right_triangle_option.png"

2345

ALT=">" BORDER=0 height=14

2346

width=15><b><font face="Helvetica, Arial"

2347

><font color="#FFFFFF"><font size="+1">

2348

-immutable

2349

</font></font></font></b></td></tr></table>

2350

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image immutable</td></tr></table>

2351

2352

<tr>

2353

2354

2355

<img SRC="../images/right_triangle_option.png"

2356

ALT=">" BORDER=0 height=14

2357

width=15><b><font face="Helvetica, Arial"

2358

><font color="#FFFFFF"><font size="+1">

2359

-implode <i><factor></i>

2360

</font></font></font></b></td></tr></table>

2361

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>implode image pixels about the center</td></tr></table>

2362

2363

<tr>

2364

2365

2366

<img SRC="../images/right_triangle_option.png"

2367

ALT=">" BORDER=0 height=14

2368

width=15><b><font face="Helvetica, Arial"

2369

><font color="#FFFFFF"><font size="+1">

2370

<a name="details-intent"></a>-intent <i><type></i>

2371

</font></font></font></b></td></tr></table>

2372

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of rendering intent when managing the image color</td></tr></table>

2373

2374

Use this option to affect the the color management operation of an image (see

2375

<strong>-profile</strong>).

2376

Choose from these intents:

2377

<strong>Absolute, Perceptual, Relative, Saturation</strong>.</font></td></tr></table>

2378

2379

The default intent is undefined.</font></td></tr></table>

2380

2381

<tr>

2382

2383

2384

<img SRC="../images/right_triangle_option.png"

2385

ALT=">" BORDER=0 height=14

2386

width=15><b><font face="Helvetica, Arial"

2387

><font color="#FFFFFF"><font size="+1">

2388

<a name="details-interlace"></a>-interlace <i><type></i>

2389

</font></font></font></b></td></tr></table>

2390

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

2391

2392

Choices are: <strong>None, Line, Plane,</strong>

2393

or <strong>Partition</strong>. The default is <strong>None</strong>.</font></td></tr></table>

2394

2395

This option is used to specify the type of interlacing scheme for raw image

2396

formats such as <strong>RGB</strong> or <strong>YUV</strong>.</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">

2397

<strong>None</strong> means do not interlace

2398

(RGBRGBRGBRGBRGBRGB...),</font></td></tr></table>

2399

2400

<strong>Line</strong> uses scanline interlacing

2401

(RRR...GGG...BBB...RRR...GGG...BBB...),

2402

and</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">

2403

<strong>Plane</strong> uses plane interlacing (RRRRRR...GGGGGG...BBBBBB...).</font></td></tr></table>

2404

2405

<strong>Partition</strong>

2406

is like plane except the different planes are saved to individual files

2407

(e.g. image.R, image.G, and image.B).</font></td></tr></table>

2408

2409

Use <strong>Line</strong> or <strong>Plane</strong> to create an

2410

<strong>interlaced PNG</strong> or <strong> GIF</strong> or

2411

<strong>progressive JPEG</strong> image.</font></td></tr></table>

2412

2413

<tr>

2414

2415

2416

<img SRC="../images/right_triangle_option.png"

2417

ALT=">" BORDER=0 height=14

2418

width=15><b><font face="Helvetica, Arial"

2419

><font color="#FFFFFF"><font size="+1">

2420

<a name="details-label"></a>-label <i><name></i>

2421

</font></font></font></b></td></tr></table>

2422

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

2423

2424

Use this option to assign a specific label to the image, when writing

2425

to an image format that supports labels, such as TIFF, PNG, MIFF, or

2426

PostScript. You can include the the image filename, type, width, height,

2427

or other image attribute by embedding special format character. A label

2428

is not drawn on the image, but is embedded in the image datastream via

2429

a "Label" tag or similar mechanism. If you want the

2430

label to be visible on the image itself, use the <strong>-draw</strong> option.

2431

See <strong>-comment</strong> for details.</font></td></tr></table>

2432

2433

For example,</font></td></tr></table>

2434

<pre>

2435

-label "%m:%f %wx%h"

2436

</pre>

2437

2438

produces an image label of <strong>MIFF:bird.miff 512x480</strong> for an image titled

2439

2440

and whose width is 512 and height is 480.</font></td></tr></table>

2441

2442

If the first character of <em>string</em> is <em>@</em>, the image label is

2443

read from a file titled by the remaining characters in the string.</font></td></tr></table>

2444

2445

When converting to <em>PostScript</em>, use this option to specify a header

2446

string to print above the image. Specify the label font with

2447

2448

2449

When creating a montage, by default the label associated with an image

2450

is displayed with the corresponding tile in the montage. Use the

2451

<strong>+label</strong> option to suppress this behavior.</font></td></tr></table>

2452

2453

<tr>

2454

2455

2456

<img SRC="../images/right_triangle_option.png"

2457

ALT=">" BORDER=0 height=14

2458

width=15><b><font face="Helvetica, Arial"

2459

><font color="#FFFFFF"><font size="+1">

2460

-lat <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i>

2461

</font></font></font></b></td></tr></table>

2462

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table>

2463

2464

Perform local adaptive thresholding using the specified width, height,

2465

and offset. The offset is a distance in sample space from the mean,

2466

as an absolute integer ranging from 0 to the maximum sample value or

2467

as a percentage.</font></td></tr></table>

2468

2469

<tr>

2470

2471

2472

<img SRC="../images/right_triangle_option.png"

2473

ALT=">" BORDER=0 height=14

2474

width=15><b><font face="Helvetica, Arial"

2475

><font color="#FFFFFF"><font size="+1">

2476

<a name="details-level"></a>-level <i><black_point></i>{<i>,<gamma></i>}<i></i>{<i>,<white_point></i>}<i></i>{<i>%</i>}<i></i>

2477

</font></font></font></b></td></tr></table>

2478

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>adjust the level of image contrast</td></tr></table>

2479

2480

Give one, two or three values delimited with commas: black-point, gamma,

2481

white-point (e.g. 10,1.0,250 or 2%,0.5,98%). The black and white

2482

points range from 0 to MaxRGB or from 0 to 100%; if the white point is

2483

omitted it is set to MaxRGB-black_point. If a "%" sign is present

2484

anywhere in the string, the black and white points are percentages of

2485

MaxRGB. Gamma is an exponent that ranges from 0.1 to 10.; if it is

2486

omitted, the default of 1.0 (no gamma correction) is assumed. This

2487

interface works similar to Photoshop's "Image->Adjustments->Levels..."

2488

"Input Levels" interface.</font></td></tr></table>

2489

2490

<tr>

2491

2492

2493

<img SRC="../images/right_triangle_option.png"

2494

ALT=">" BORDER=0 height=14

2495

width=15><b><font face="Helvetica, Arial"

2496

><font color="#FFFFFF"><font size="+1">

2497

<a name="details-limit"></a>-limit <i><type> <value></i>

2498

</font></font></font></b></td></tr></table>

2499

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

2500

2501

The value for File is in number of files and the values for the other

2502

resources are in Megabytes. By default the limits are 256 files, 1024MB memory,

2503

4096MB map, and unlimited disk, but these are adjusted at startup

2504

time on platforms that can provide information about available resources.

2505

When the limit is reached, GraphicsMagick will fail in some fashion, or

2506

take compensating actions if possible.

2507

For example, <tt>-limit memory 32 -limit map 64</tt> limits memory

2508

When the pixel cache reaches the memory limit it uses

2509

memory mapping. When that limit is reached it goes to disk. If disk has

2510

a hard limit, the program will fail.</font></td></tr></table>

2511

2512

Resource limits may also be set using environment variables. The

2513

environment variables <strong>MAGICK_LIMIT_DISK</strong>,

2514

<strong>MAGICK_LIMIT_FILES</strong>, <strong>MAGICK_LIMIT_MEMORY</strong>, and

2515

<strong>MAGICK_LIMIT_MAP</strong>, may be used to set the limits for disk space,

2516

open files, heap memory, and memory map size, respectively.</font></td></tr></table>

2517

2518

You can use the option <tt>-list resource</tt> to find out the limits.</font></td></tr></table>

2519

2520

<tr>

2521

2522

2523

<img SRC="../images/right_triangle_option.png"

2524

ALT=">" BORDER=0 height=14

2525

width=15><b><font face="Helvetica, Arial"

2526

><font color="#FFFFFF"><font size="+1">

2527

-linewidth

2528

</font></font></font></b></td></tr></table>

2529

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the line width for subsequent draw operations</td></tr></table>

2530

2531

<tr>

2532

2533

2534

<img SRC="../images/right_triangle_option.png"

2535

ALT=">" BORDER=0 height=14

2536

width=15><b><font face="Helvetica, Arial"

2537

><font color="#FFFFFF"><font size="+1">

2538

2539

</font></font></font></b></td></tr></table>

2540

2541

2542

Choices are: <strong>Color</strong>, <strong>Delegate</strong>, <strong>Format</strong>, <strong>Magic</strong>,

2543

<strong>Module</strong>, <strong>Resource</strong>, or <strong>Type</strong>. The <strong>Module</strong> option

2544

is only available if GraphicsMagick was built to support loadable modules.</font></td></tr></table>

2545

2546

This option lists information about the GraphicsMagick configuration.</font></td></tr></table>

2547

2548

<tr>

2549

2550

2551

<img SRC="../images/right_triangle_option.png"

2552

ALT=">" BORDER=0 height=14

2553

width=15><b><font face="Helvetica, Arial"

2554

><font color="#FFFFFF"><font size="+1">

2555

2556

</font></font></font></b></td></tr></table>

2557

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

2558

2559

This option specifies the format for the log printed when the <strong>-debug</strong>

2560

option is active.</font></td></tr></table>

2561

2562

You can display the following components by embedding

2563

special format characters:</font></td></tr></table>

2564

<pre>

2565

%d domain

2566

%e event

2567

%f function

2568

%l line

2569

%m module

2570

%p process ID

2571

%r real CPU time

2572

%t wall clock time

2573

%u user CPU time

2574

%% percent sign

2575

\n newline

2576

\r carriage return

2577

</pre>

2578

2579

For example:</font></td></tr></table>

2580

<pre>

2581

gm convert -debug coders -log "%u %m:%l %e" in.gif out.png

2582

</pre>

2583

2584

The default behavior is to print all of the components.</font></td></tr></table>

2585

2586

<tr>

2587

2588

2589

<img SRC="../images/right_triangle_option.png"

2590

ALT=">" BORDER=0 height=14

2591

width=15><b><font face="Helvetica, Arial"

2592

><font color="#FFFFFF"><font size="+1">

2593

2594

</font></font></font></b></td></tr></table>

2595

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add Netscape loop extension to your GIF animation</td></tr></table>

2596

2597

A value other than zero forces the animation to repeat itself up to

2598

<em>iterations</em>

2599

times.</font></td></tr></table>

2600

2601

<tr>

2602

2603

2604

<img SRC="../images/right_triangle_option.png"

2605

ALT=">" BORDER=0 height=14

2606

width=15><b><font face="Helvetica, Arial"

2607

><font color="#FFFFFF"><font size="+1">

2608

-magnify <i><factor></i>

2609

</font></font></font></b></td></tr></table>

2610

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table>

2611

2612

<tr>

2613

2614

2615

<img SRC="../images/right_triangle_option.png"

2616

ALT=">" BORDER=0 height=14

2617

width=15><b><font face="Helvetica, Arial"

2618

><font color="#FFFFFF"><font size="+1">

2619

2620

</font></font></font></b></td></tr></table>

2621

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>choose a particular set of colors from this image</td></tr></table>

2622

2623

[<em>convert</em> or <em>mogrify</em>]</font></td></tr></table>

2624

2625

By default, color reduction chooses an optimal set of colors that best

2626

represent the original image. Alternatively, you can choose a particular

2627

set of colors from an image file with this option.</font></td></tr></table>

2628

2629

Use

2630

<strong>+map</strong> to reduce

2631

all images in the image sequence that follows to a single optimal set of colors

2632

that best represent all the images. The sequence of images

2633

is terminated by the appearance of any option.

2634

If the <strong>+map</strong>

2635

option appears after all of the input images, all images are mapped.</font></td></tr></table>

2636

2637

<tr>

2638

2639

2640

<img SRC="../images/right_triangle_option.png"

2641

ALT=">" BORDER=0 height=14

2642

width=15><b><font face="Helvetica, Arial"

2643

><font color="#FFFFFF"><font size="+1">

2644

2645

</font></font></font></b></td></tr></table>

2646

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table>

2647

2648

[<em>animate</em> or <em>display</em>]</font></td></tr></table>

2649

2650

Choose from these <em>Standard Colormap</em> types:</font></td></tr></table>

2651

<pre>

2652

best

2653

default

2654

gray

2655

red

2656

green

2657

blue

2658

</pre>

2659

2660

The <em>X server</em> must support the <em>Standard Colormap</em> you choose,

2661

otherwise an error occurs. Use <strong>list</strong> as the type and <strong>display</strong>

2662

searches the list of colormap types in <strong>top-to-bottom</strong> order until

2663

one is located. See <em>xstdcmap(1)</em> for one way of creating Standard

2664

Colormaps.</font></td></tr></table>

2665

2666

<tr>

2667

2668

2669

<img SRC="../images/right_triangle_option.png"

2670

ALT=">" BORDER=0 height=14

2671

width=15><b><font face="Helvetica, Arial"

2672

><font color="#FFFFFF"><font size="+1">

2673

2674

</font></font></font></b></td></tr></table>

2675

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table>

2676

2677

The image read from the file is used as a clipping mask. It must have

2678

the same dimensions as the image being masked.</font></td></tr></table>

2679

2680

If the mask image contains an opacity channel, the opacity of each pixel is

2681

used to define the mask. Otherwise, the intensity (gray level) of each

2682

pixel is used.</font></td></tr></table>

2683

2684

Use <strong>+mask</strong> to remove the clipping mask.</font></td></tr></table>

2685

2686

It is not necessary to use <strong>-clip</strong> to activate the mask; <strong>-clip</strong>

2687

is implied by <strong>-mask</strong>.</font></td></tr></table>

2688

2689

<tr>

2690

2691

2692

<img SRC="../images/right_triangle_option.png"

2693

ALT=">" BORDER=0 height=14

2694

width=15><b><font face="Helvetica, Arial"

2695

><font color="#FFFFFF"><font size="+1">

2696

<a name="details-matte"></a>-matte

2697

</font></font></font></b></td></tr></table>

2698

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

2699

2700

If the image does not have a matte channel, create an opaque one.</font></td></tr></table>

2701

2702

Use <strong>+matte</strong> to ignore the matte channel and to avoid writing a

2703

matte channel in the output file.</font></td></tr></table>

2704

2705

<tr>

2706

2707

2708

<img SRC="../images/right_triangle_option.png"

2709

ALT=">" BORDER=0 height=14

2710

width=15><b><font face="Helvetica, Arial"

2711

><font color="#FFFFFF"><font size="+1">

2712

<a name="details-mattecolor"></a>-mattecolor <i><color></i>

2713

</font></font></font></b></td></tr></table>

2714

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>

2715

2716

The color is specified using the format described under the <strong>-fill</strong>

2717

option.</font></td></tr></table>

2718

2719

<tr>

2720

2721

2722

<img SRC="../images/right_triangle_option.png"

2723

ALT=">" BORDER=0 height=14

2724

width=15><b><font face="Helvetica, Arial"

2725

><font color="#FFFFFF"><font size="+1">

2726

-median <i><radius></i>

2727

</font></font></font></b></td></tr></table>

2728

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a median filter to the image</td></tr></table>

2729

2730

<tr>

2731

2732

2733

<img SRC="../images/right_triangle_option.png"

2734

ALT=">" BORDER=0 height=14

2735

width=15><b><font face="Helvetica, Arial"

2736

><font color="#FFFFFF"><font size="+1">

2737

-mode <i><value></i>

2738

</font></font></font></b></td></tr></table>

2739

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>mode of operation</td></tr></table>

2740

2741

<tr>

2742

2743

2744

<img SRC="../images/right_triangle_option.png"

2745

ALT=">" BORDER=0 height=14

2746

width=15><b><font face="Helvetica, Arial"

2747

><font color="#FFFFFF"><font size="+1">

2748

<a name="details-modulate"></a>-modulate <i>brightness[,saturation[,hue]]</i>

2749

</font></font></font></b></td></tr></table>

2750

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>vary the brightness, saturation, and hue of an image</td></tr></table>

2751

2752

Specify the percent change in brightness, color saturation, and

2753

hue separated by commas. Default argument values are 100 percent,

2754

resulting in no change. For example, to increase the color brightness

2755

by 20% and decrease the color saturation by 10% and leave the hue

2756

unchanged, use: <strong>-modulate 120,90</strong>.</font></td></tr></table>

2757

2758

Hue is the percentage of absolute rotation from the current

2759

position. For example 50 results in a counter-clockwise rotation of 90

2760

degrees, 150 results in a clockwise rotation of 90 degrees, with 0 and

2761

200 both resulting in a rotation of 180 degrees.</font></td></tr></table>

2762

2763

<tr>

2764

2765

2766

<img SRC="../images/right_triangle_option.png"

2767

ALT=">" BORDER=0 height=14

2768

width=15><b><font face="Helvetica, Arial"

2769

><font color="#FFFFFF"><font size="+1">

2770

-monochrome

2771

</font></font></font></b></td></tr></table>

2772

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

2773

2774

<tr>

2775

2776

2777

<img SRC="../images/right_triangle_option.png"

2778

ALT=">" BORDER=0 height=14

2779

width=15><b><font face="Helvetica, Arial"

2780

><font color="#FFFFFF"><font size="+1">

2781

<a name="details-morph"></a>-morph <i><frames></i>

2782

</font></font></font></b></td></tr></table>

2783

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>morphs an image sequence</td></tr></table>

2784

2785

Both the image pixels and size are linearly interpolated to give the appearance

2786

of a meta-morphosis from one image to the next.</font></td></tr></table>

2787

2788

The sequence of images

2789

is terminated by the appearance of any option.

2790

If the <strong>-morph</strong>

2791

option appears after all of the input images, all images are morphed.</font></td></tr></table>

2792

2793

<tr>

2794

2795

2796

<img SRC="../images/right_triangle_option.png"

2797

ALT=">" BORDER=0 height=14

2798

width=15><b><font face="Helvetica, Arial"

2799

><font color="#FFFFFF"><font size="+1">

2800

<a name="details-mosaic"></a>-mosaic

2801

</font></font></font></b></td></tr></table>

2802

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a mosaic from an image or an image sequence</td></tr></table>

2803

2804

The <strong>-page</strong> option can be used to establish the dimensions of the mosaic

2805

and to locate the images within the mosaic.</font></td></tr></table>

2806

2807

The sequence of images

2808

is terminated by the appearance of any option.

2809

If the <strong>-mosaic</strong>

2810

option appears after all of the input images, all images are included

2811

in the mosaic.</font></td></tr></table>

2812

2813

<tr>

2814

2815

2816

<img SRC="../images/right_triangle_option.png"

2817

ALT=">" BORDER=0 height=14

2818

width=15><b><font face="Helvetica, Arial"

2819

><font color="#FFFFFF"><font size="+1">

2820

-name

2821

</font></font></font></b></td></tr></table>

2822

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table>

2823

2824

<tr>

2825

2826

2827

<img SRC="../images/right_triangle_option.png"

2828

ALT=">" BORDER=0 height=14

2829

width=15><b><font face="Helvetica, Arial"

2830

><font color="#FFFFFF"><font size="+1">

2831

<a name="details-negate"></a>-negate

2832

</font></font></font></b></td></tr></table>

2833

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>

2834

2835

The red, green, and blue intensities of an image are negated.

2836

White becomes black,

2837

yellow becomes blue, etc.

2838

Use <strong>+negate</strong>

2839

to only negate the grayscale pixels of the image.</font></td></tr></table>

2840

2841

<tr>

2842

2843

2844

<img SRC="../images/right_triangle_option.png"

2845

ALT=">" BORDER=0 height=14

2846

width=15><b><font face="Helvetica, Arial"

2847

><font color="#FFFFFF"><font size="+1">

2848

<a name="details-noise"></a>-noise <i><radius|type></i>

2849

</font></font></font></b></td></tr></table>

2850

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add or reduce noise in an image</td></tr></table>

2851

2852

The principal function of noise peak elimination filter is to smooth the

2853

objects within an image without losing edge information and without creating

2854

undesired structures. The central idea of the algorithm is to replace a

2855

pixel with its next neighbor in value within a pixel window, if this pixel

2856

has been found to be noise. A pixel is defined as noise if and only if

2857

this pixel is a maximum or minimum within the pixel window.</font></td></tr></table>

2858

2859

Use <strong>radius</strong> to specify the width of the neighborhood.</font></td></tr></table>

2860

2861

Use <strong>+noise</strong> followed by a noise type to add noise to an image. Choose

2862

from these noise types:</font></td></tr></table>

2863

<pre>

2864

Uniform

2865

Gaussian

2866

Multiplicative

2867

Impulse

2868

Laplacian

2869

Poisson

2870

</pre>

2871

2872

<tr>

2873

2874

2875

<img SRC="../images/right_triangle_option.png"

2876

ALT=">" BORDER=0 height=14

2877

width=15><b><font face="Helvetica, Arial"

2878

><font color="#FFFFFF"><font size="+1">

2879

<a name="details-noop"></a>-noop

2880

</font></font></font></b></td></tr></table>

2881

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>

2882

2883

The <strong>-noop</strong> option can be used to terminate a group of images

2884

and reset all options to their default values, when no other option is

2885

desired.</font></td></tr></table>

2886

2887

<tr>

2888

2889

2890

<img SRC="../images/right_triangle_option.png"

2891

ALT=">" BORDER=0 height=14

2892

width=15><b><font face="Helvetica, Arial"

2893

><font color="#FFFFFF"><font size="+1">

2894

<a name="details-normalize"></a>-normalize

2895

</font></font></font></b></td></tr></table>

2896

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform image to span the full range of color values</td></tr></table>

2897

2898

This is a contrast enhancement technique.</font></td></tr></table>

2899

2900

<tr>

2901

2902

2903

<img SRC="../images/right_triangle_option.png"

2904

ALT=">" BORDER=0 height=14

2905

width=15><b><font face="Helvetica, Arial"

2906

><font color="#FFFFFF"><font size="+1">

2907

<a name="details-opaque"></a>-opaque <i><color></i>

2908

</font></font></font></b></td></tr></table>

2909

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>change this color to the pen color within the image</td></tr></table>

2910

2911

The color is specified using the format described under the <strong>-fill</strong>

2912

option.</font></td></tr></table>

2913

2914

See <strong>-fill</strong> for more details.</font></td></tr></table>

2915

2916

<tr>

2917

2918

2919

<img SRC="../images/right_triangle_option.png"

2920

ALT=">" BORDER=0 height=14

2921

width=15><b><font face="Helvetica, Arial"

2922

><font color="#FFFFFF"><font size="+1">

2923

<a name="details-operator"></a>-operator <i>channel operator rvalue[%]</i>

2924

</font></font></font></b></td></tr></table>

2925

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a mathematical or bitwise operator to an image channel</td></tr></table>

2926

2927

Apply a low-level mathematical or bitwise operator to a selected image

2928

channel or all image channels. Operations which result in negative

2929

results are reset to zero, and operations which overflow the

2930

available range are reset to the maximum possible value.

2931

</font></td></tr></table>

2932

2933

Select a channel from: <strong>Red</strong>, <strong>Green</strong>, <strong>Blue</strong>, <strong>Opacity</strong>,

2934

<strong>Matte</strong>, <strong>Cyan</strong>, <strong>Magenta</strong>, <strong>Yellow</strong>, <strong>Black</strong>,

2935

or <strong>All</strong>.</font></td></tr></table>

2936

2937

Select an operator from <strong>Add</strong>, <strong>And</strong>, <strong>Divide</strong>, <strong>LShift</strong>,

2938

<strong>Multiply</strong>, <strong>Or</strong>, <strong>RShift</strong>, <strong>Subtract</strong>, <strong>Xor</strong>.</font></td></tr></table>

2939

2940

Rvalue may be any floating point value in the range of 0 to MaxRGB, where

2941

MaxRGB is the largest quantum value supported by the GraphicsMagick build

2942

(255, 65535, or 4294967295). If a percent (<strong>%</strong>) symbol is appended

2943

to the argument, then the argument has a range of 0 to 100 percent.</font></td></tr></table>

2944

2945

<tr>

2946

2947

2948

<img SRC="../images/right_triangle_option.png"

2949

ALT=">" BORDER=0 height=14

2950

width=15><b><font face="Helvetica, Arial"

2951

><font color="#FFFFFF"><font size="+1">

2952

<a name="details-ordered-dither"></a>-ordered-dither <i><channeltype> <NxN></i>

2953

</font></font></font></b></td></tr></table>

2954

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table>

2955

2956

The channel or channels specified in the <strong>channeltype</strong> argument are

2957

reduced to binary, using an ordered dither method.

2958

The choices for <strong>channeltype</strong> are:</font></td></tr></table>

2959

<pre>

2960

all

2961

intensity

2962

opacity

2963

matte

2964

</pre>

2965

2966

When <strong>channeltype</strong> is "all", the color samples are dithered into

2967

a graylevel and then that graylevel is stored in the three color

2968

channels. Separately, the opacity channel is dithered into a bilevel

2969

opacity value which is stored in the opacity channel.</font></td></tr></table>

2970

2971

When <strong>channeltype</strong> is "intensity", only the color samples are

2972

dithered. When <strong>channeltype</strong> is "opacity" or "matte", only the

2973

opacity channel is dithered.</font></td></tr></table>

2974

2975

The choices for N are 2, 3, or 4. When N is 2, the image is divided into

2976

2x2 pixel tiles. In each tile, 0, 1, 2, 3, or 4 pixels are turned to

2977

white depending on their intensity. When N is 3, there are 3x3 tiles

2978

and 10 levels of gray can be represented. When N is 4, there are 4x4

2979

tiles and 17 levels of gray.</font></td></tr></table>

2980

2981

<tr>

2982

2983

2984

<img SRC="../images/right_triangle_option.png"

2985

ALT=">" BORDER=0 height=14

2986

width=15><b><font face="Helvetica, Arial"

2987

><font color="#FFFFFF"><font size="+1">

2988

2989

</font></font></font></b></td></tr></table>

2990

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

2991

2992

Use this option to specify the dimensions of the

2993

<em>PostScript</em> page

2994

in dots per inch or a TEXT page in pixels. The choices for a PostScript

2995

page are:</font></td></tr></table>

2996

<pre>

2997

11x17 792 1224

2998

Ledger 1224 792

2999

Legal 612 1008

3000

Letter 612 792

3001

LetterSmall 612 792

3002

ArchE 2592 3456

3003

ArchD 1728 2592

3004

ArchC 1296 1728

3005

ArchB 864 1296

3006

ArchA 648 864

3007

A0 2380 3368

3008

A1 1684 2380

3009

A2 1190 1684

3010

A3 842 1190

3011

A4 595 842

3012

A4Small 595 842

3013

A5 421 595

3014

A6 297 421

3015

A7 210 297

3016

A8 148 210

3017

A9 105 148

3018

A10 74 105

3019

B0 2836 4008

3020

B1 2004 2836

3021

B2 1418 2004

3022

B3 1002 1418

3023

B4 709 1002

3024

B5 501 709

3025

C0 2600 3677

3026

C1 1837 2600

3027

C2 1298 1837

3028

C3 918 1298

3029

C4 649 918

3030

C5 459 649

3031

C6 323 459

3032

Flsa 612 936

3033

Flse 612 936

3034

HalfLetter 396 612

3035

</pre>

3036

3037

For convenience you can specify the page size by media (e.g. A4, Ledger,

3038

etc.). Otherwise, <strong>-page</strong> behaves much like

3039

<strong>-geometry</strong> (e.g. <tt>-page letter+43+43></tt>).</font></td></tr></table>

3040

3041

This option is also used to place subimages when writing to a multi-image

3042

format that supports offsets, such as GIF89 and MNG. When used for this

3043

purpose the offsets are always measured from the

3044

top left corner of the canvas and are not affected by the <strong>-gravity</strong>

3045

option.

3046

To position a GIF or MNG image, use <strong>-page</strong><em>{+-}<x>{+-}<y></em>

3047

(e.g. -page +100+200). When writing to a MNG file, a <strong>-page</strong>

3048

option appearing ahead of the first image in the sequence with nonzero

3049

width and height defines the width and height values that are written in

3050

the <strong>MHDR</strong> chunk. Otherwise, the MNG width and height are computed

3051

from the bounding box that contains all images in the sequence. When

3052

writing a GIF89 file, only the bounding box method is used to determine its

3053

dimensions.</font></td></tr></table>

3054

3055

For a PostScript page, the image is sized as in <strong>-geometry</strong> and positioned

3056

relative to the lower left hand corner of the page by

3057

{+-}<<strong>x</strong><em>offset</em>>{+-}<<strong>y</strong>

3058

<em>offset></em>. Use

3059

<tt>-page 612x792></tt>, for example, to center the

3060

image within the page. If the image size exceeds the PostScript page, it

3061

is reduced to fit the page.

3062

The default gravity for the <strong>-page</strong>

3063

option is <em>NorthWest</em>, i.e., positive <strong>x</strong> and

3064

<strong>y</strong> <em>offset</em> are measured rightward and downward from the top

3065

left corner of the page, unless the <strong>-gravity</strong> option is present with

3066

a value other than <em>NorthWest</em>.</font></td></tr></table>

3067

3068

The default page dimensions for a TEXT image is 612x792.</font></td></tr></table>

3069

3070

This option is used in concert with <strong>-density</strong>.</font></td></tr></table>

3071

3072

Use <strong>+page</strong> to remove the page settings for an image.</font></td></tr></table>

3073

3074

<tr>

3075

3076

3077

<img SRC="../images/right_triangle_option.png"

3078

ALT=">" BORDER=0 height=14

3079

width=15><b><font face="Helvetica, Arial"

3080

><font color="#FFFFFF"><font size="+1">

3081

<a name="details-paint"></a>-paint <i><radius></i>

3082

</font></font></font></b></td></tr></table>

3083

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table>

3084

3085

Each pixel is replaced by the most frequent color in a circular neighborhood

3086

whose width is specified with <em>radius</em>.</font></td></tr></table>

3087

3088

<tr>

3089

3090

3091

<img SRC="../images/right_triangle_option.png"

3092

ALT=">" BORDER=0 height=14

3093

width=15><b><font face="Helvetica, Arial"

3094

><font color="#FFFFFF"><font size="+1">

3095

<a name="details-pause"></a>-pause <i><seconds></i>

3096

</font></font></font></b></td></tr></table>

3097

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between animation loops [animate]</td></tr></table>

3098

3099

Pause for the specified number of seconds before repeating the

3100

animation.</font></td></tr></table>

3101

3102

<tr>

3103

3104

3105

<img SRC="../images/right_triangle_option.png"

3106

ALT=">" BORDER=0 height=14

3107

width=15><b><font face="Helvetica, Arial"

3108

><font color="#FFFFFF"><font size="+1">

3109

<a name="details-pause"></a>-pause <i><seconds></i>

3110

</font></font></font></b></td></tr></table>

3111

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between snapshots [import]</td></tr></table>

3112

3113

Pause for the specified number of seconds before taking the next

3114

snapshot.</font></td></tr></table>

3115

3116

<tr>

3117

3118

3119

<img SRC="../images/right_triangle_option.png"

3120

ALT=">" BORDER=0 height=14

3121

width=15><b><font face="Helvetica, Arial"

3122

><font color="#FFFFFF"><font size="+1">

3123

3124

</font></font></font></b></td></tr></table>

3125

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table>

3126

3127

<tr>

3128

3129

3130

<img SRC="../images/right_triangle_option.png"

3131

ALT=">" BORDER=0 height=14

3132

width=15><b><font face="Helvetica, Arial"

3133

><font color="#FFFFFF"><font size="+1">

3134

-ping

3135

</font></font></font></b></td></tr></table>

3136

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table>

3137

3138

<tr>

3139

3140

3141

<img SRC="../images/right_triangle_option.png"

3142

ALT=">" BORDER=0 height=14

3143

width=15><b><font face="Helvetica, Arial"

3144

><font color="#FFFFFF"><font size="+1">

3145

-pointsize <i><value></i>

3146

</font></font></font></b></td></tr></table>

3147

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, OPTION1, or TrueType font</td></tr></table>

3148

3149

<tr>

3150

3151

3152

<img SRC="../images/right_triangle_option.png"

3153

ALT=">" BORDER=0 height=14

3154

width=15><b><font face="Helvetica, Arial"

3155

><font color="#FFFFFF"><font size="+1">

3156

<a name="details-preview"></a>-preview <i><type></i>

3157

</font></font></font></b></td></tr></table>

3158

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>image preview type</td></tr></table>

3159

3160

Use this option to affect the preview operation of an image (e.g.

3161

<tt>convert file.png -preview Gamma Preview:gamma.png</tt>). Choose

3162

from these previews:</font></td></tr></table>

3163

<pre>

3164

Rotate

3165

Shear

3166

Roll

3167

Hue

3168

Saturation

3169

Brightness

3170

Gamma

3171

Spiff

3172

Dull

3173

Grayscale

3174

Quantize

3175

Despeckle

3176

ReduceNoise

3177

Add Noise

3178

Sharpen

3179

Blur

3180

Threshold

3181

EdgeDetect

3182

Spread

3183

Shade

3184

Raise

3185

Segment

3186

Solarize

3187

Swirl

3188

Implode

3189

Wave

3190

OilPaint

3191

CharcoalDrawing

3192

JPEG

3193

</pre>

3194

3195

The default preview is <strong>JPEG</strong>.</font></td></tr></table>

3196

3197

<tr>

3198

3199

3200

<img SRC="../images/right_triangle_option.png"

3201

ALT=">" BORDER=0 height=14

3202

width=15><b><font face="Helvetica, Arial"

3203

><font color="#FFFFFF"><font size="+1">

3204

<a name="details-process"></a>-process <i><command></i>

3205

</font></font></font></b></td></tr></table>

3206

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>process a sequence of images using a process module</td></tr></table>

3207

3208

The command argument has the form <strong>module=arg1,arg2,arg3,...,argN</strong>

3209

where <strong>module</strong> is the name of the module to invoke (e.g. "analyze")

3210

and arg1,arg2,arg3,...,argN are an arbitrary number of arguments to

3211

pass to the process module.</font></td></tr></table><table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1">

3212

The sequence of images

3213

is terminated by the appearance of any option.</font></td></tr></table>

3214

3215

If the <strong>-process</strong>

3216

option appears after all of the input images, all images are processed.</font></td></tr></table>

3217

3218

<tr>

3219

3220

3221

<img SRC="../images/right_triangle_option.png"

3222

ALT=">" BORDER=0 height=14

3223

width=15><b><font face="Helvetica, Arial"

3224

><font color="#FFFFFF"><font size="+1">

3225

<a name="details-profile"></a>-profile <i><filename></i>

3226

</font></font></font></b></td></tr></table>

3227

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table>

3228

3229

<tt>-profile filename</tt> adds an ICM (ICC color management), IPTC

3230

(newswire information), or a generic profile to the image</font></td></tr></table>.

3231

3232

Use <tt>+profile icm</tt>, <tt>+profile iptc</tt>,

3233

or <tt>+profile profile_name</tt> to remove the respective

3234

profile. Use <tt>identify -verbose</tt> to find out what profiles are in the

3235

image file. Use <tt>+profile "*"</tt> to remove all profiles.</font></td></tr></table>

3236

3237

To extract a profile, the <strong>-profile</strong> option is not used. Instead,

3238

simply write the file to an image

3239

format such as <em>APP1, 8BIM, ICM,</em> or <em>IPTC</em>.</font></td></tr></table>

3240

3241

For example, to extract the Exif data (which is stored in JPEG files

3242

in the <em>APP1</em> profile), use

3243

</font></td></tr></table>

3244

<pre>

3245

gm convert cockatoo.jpg exifdata.app1

3246

</pre>

3247

3248

<tr>

3249

3250

3251

<img SRC="../images/right_triangle_option.png"

3252

ALT=">" BORDER=0 height=14

3253

width=15><b><font face="Helvetica, Arial"

3254

><font color="#FFFFFF"><font size="+1">

3255

<a name="details+progress"></a>+progress

3256

</font></font></font></b></td></tr></table>

3257

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>disable progress monitor and busy cursor</td></tr></table>

3258

3259

By default, when an image is displayed, a progress monitor bar is shown

3260

in the top left corner of an existing image display window, and the

3261

current cursor is replaced with an hourglass cursor. Use <strong>+progress</strong>

3262

to disable the progress monitor and busy cursor during display operations.

3263

While the progress monitor is disabled for all operations, the busy

3264

cursor continues to be enabled for non-display operations such as image

3265

processing. This option is useful for non-interactive display operations,

3266

or when a "clean" look is desired.</font></td></tr></table>

3267

3268

<tr>

3269

3270

3271

<img SRC="../images/right_triangle_option.png"

3272

ALT=">" BORDER=0 height=14

3273

width=15><b><font face="Helvetica, Arial"

3274

><font color="#FFFFFF"><font size="+1">

3275

<a name="details-quality"></a>-quality <i><value></i>

3276

</font></font></font></b></td></tr></table>

3277

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

3278

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td><font size="-1"> For the JPEG and MPEG image formats, quality is 0 (lowest image

3279

quality and highest compression) to 100 (best quality but least

3280

effective compression). The default quality is 75. Use the

3281

<strong>-sampling-factor</strong> option to specify the factors for chroma

3282

downsampling. To use the same quality value as that found by the JPEG

3283

decoder, use the <tt>-define jpeg:preserve-settings</tt> flag.</font></td></tr></table>

3284

3285

For the MIFF image format, quality/10 is the zlib compression level, which

3286

is 0 (worst but fastest compression) to 9 (best but slowest). It has no

3287

effect on the image appearance, since the compression is always lossless.</font></td></tr></table>

3288

3289

For the JPEG-2000 image format, quality is mapped using a non-linear

3290

equation to the compression ratio required by the Jasper library. This

3291

non-linear equation is intended to loosely approximate the quality

3292

provided by the JPEG v1 format. The default quality value 75 results in

3293

a request for 16:1 compression. The quality value 100 results in

3294

a request for non-lossy compression.</font></td></tr></table>

3295

3296

For the MNG and PNG image formats, the quality value sets the zlib compression

3297

level (quality / 10) and filter-type (quality % 10). Compression levels

3298

range from 0 (fastest compression) to 100 (best but slowest). For compression

3299

level 0, the Huffman-only strategy is used, which is fastest but not

3300

necessarily the worst compression.</font></td></tr></table>

3301

3302

If

3303

filter-type is 4 or less, the specified filter-type is used for all scanlines:</font></td></tr></table>

3304

<pre>

3305

0: none

3306

1: sub

3307

2: up

3308

3: average

3309

4: Paeth

3310

</pre>

3311

3312

If filter-type is 5, adaptive filtering is used when quality is greater

3313

than 50 and the image does not have a color map, otherwise no filtering

3314

is used.</font></td></tr></table>

3315

3316

If filter-type is 6, adaptive filtering

3317

with <em>minimum-sum-of-absolute-values</em>

3318

is used.</font></td></tr></table>

3319

3320

Only if the output is MNG, if filter-type is 7, the LOCO color transformation

3321

and adaptive filtering with <em>minimum-sum-of-absolute-values</em>

3322

are used.</font></td></tr></table>

3323

3324

The default is quality is 75, which means nearly the best compression with

3325

adaptive filtering. The quality setting has no effect on the appearance

3326

of PNG and MNG images, since the compression is always lossless.</font></td></tr></table>

3327

3328

For further information, see the <a href="http://www.w3.org/pub/WWW/TR">PNG</a>

3329

specification.</font></td></tr></table>

3330

3331

When writing a JNG image with transparency, two quality values are required,

3332

one for the main image and one for the grayscale image that conveys the

3333

opacity channel. These are written as a single integer equal to the main

3334

image quality plus 1000 times the opacity quality. For example, if you

3335

want to use quality 75 for the main image and quality 90 to compress

3336

the opacity data, use <tt>-quality 90075</tt>.</font></td></tr></table>

3337

3338

<tr>

3339

3340

3341

<img SRC="../images/right_triangle_option.png"

3342

ALT=">" BORDER=0 height=14

3343

width=15><b><font face="Helvetica, Arial"

3344

><font color="#FFFFFF"><font size="+1">

3345

<a name="details-raise"></a>-raise <i><width>x<height></i>

3346

</font></font></font></b></td></tr></table>

3347

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table>

3348

3349

This will create a 3-D effect. See <strong>-geometry</strong> for details

3350

details about the geometry specification. Offsets are not used.</font></td></tr></table>

3351

3352

Use <strong>-raise</strong> to create a raised effect, otherwise use <strong>+raise</strong>.</font></td></tr></table>

3353

3354

<tr>

3355

3356

3357

<img SRC="../images/right_triangle_option.png"

3358

ALT=">" BORDER=0 height=14

3359

width=15><b><font face="Helvetica, Arial"

3360

><font color="#FFFFFF"><font size="+1">

3361

<a name="details-random-threshold"></a>-random-threshold <i><channeltype> <LOWxHIGH></i>

3362

</font></font></font></b></td></tr></table>

3363

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table>

3364

3365

The channel or channels specified in the <channeltype> argument are

3366

reduced to binary, using an random-threshold method. The choices for

3367

<strong>channeltype</strong> are:</font></td></tr></table>

3368

<pre>

3369

all

3370

intensity

3371

opacity

3372

matte

3373

</pre>

3374

3375

When <strong>channeltype</strong> is "all", the color samples are thresholded into

3376

a graylevel and then that graylevel is stored in the three color

3377

channels. Separately, the opacity channel is thresholded into a bilevel

3378

opacity value which is stored in the opacity channel. For each pixel,

3379

a new random number is used to establish the threshold to be used. The

3380

threshold never exceeds the specified maximum (HIGH) and is never less

3381

than the specified minimum (LOW).</font></td></tr></table>

3382

3383

When <strong>channeltype</strong> is "intensity", only the color samples are

3384

thresholded. When <strong>channeltype</strong> is "opacity" or "matte", only the

3385

opacity channel is thresholded.</font></td></tr></table>

3386

3387

<tr>

3388

3389

3390

<img SRC="../images/right_triangle_option.png"

3391

ALT=">" BORDER=0 height=14

3392

width=15><b><font face="Helvetica, Arial"

3393

><font color="#FFFFFF"><font size="+1">

3394

<a name="details-red-primary"></a>-red-primary <i><x>,<y></i>

3395

</font></font></font></b></td></tr></table>

3396

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table>

3397

3398

<tr>

3399

3400

3401

<img SRC="../images/right_triangle_option.png"

3402

ALT=">" BORDER=0 height=14

3403

width=15><b><font face="Helvetica, Arial"

3404

><font color="#FFFFFF"><font size="+1">

3405

<a name="details-region"></a>-region <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>

3406

</font></font></font></b></td></tr></table>

3407

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply options to a portion of the image</td></tr></table>

3408

3409

The <em>x</em> and <em>y</em> offsets are treated in the same manner as in <strong>-crop</strong></font></td></tr></table>.

3410

3411

<tr>

3412

3413

3414

<img SRC="../images/right_triangle_option.png"

3415

ALT=">" BORDER=0 height=14

3416

width=15><b><font face="Helvetica, Arial"

3417

><font color="#FFFFFF"><font size="+1">

3418

<a name="details-remote"></a>-remote

3419

</font></font></font></b></td></tr></table>

3420

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table>

3421

3422

The <strong>-remote</strong> command sends a command to a "gm display" or "gm

3423

animate" which is already running. The only command recognized at this

3424

time is the name of an image file to load. This capability is very

3425

useful to load new images without needing to restart GraphicsMagick

3426

(e.g. for a slide-show or to use GraphicsMagick as the display engine

3427

for a different GUI). Also see the <strong>+progress</strong> option for a way

3428

to disable progress indication for a clean look while loading new images.</font></td></tr></table>

3429

3430

<tr>

3431

3432

3433

<img SRC="../images/right_triangle_option.png"

3434

ALT=">" BORDER=0 height=14

3435

width=15><b><font face="Helvetica, Arial"

3436

><font color="#FFFFFF"><font size="+1">

3437

<a name="details-render"></a>-render

3438

</font></font></font></b></td></tr></table>

3439

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table>

3440

3441

Use <strong>+render</strong> to turn off rendering vector operations. This is

3442

useful when saving the result to vector formats such as MVG or SVG.</font></td></tr></table>

3443

3444

<tr>

3445

3446

3447

<img SRC="../images/right_triangle_option.png"

3448

ALT=">" BORDER=0 height=14

3449

width=15><b><font face="Helvetica, Arial"

3450

><font color="#FFFFFF"><font size="+1">

3451

<a name="details-resample"></a>-resample <i><horizontal>x<vertical></i>

3452

</font></font></font></b></td></tr></table>

3453

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Resample image to specified horizontal and vertical resolution</td></tr></table>

3454

3455

Resize the image so that its rendered size remains the same as the

3456

original at the specified target resolution. Either the current image

3457

resolution units or the previously set with <strong>-units</strong> are used to

3458

interpret the argument. For example, if a 300 DPI image renders at 3

3459

inches by 2 inches on a 300 DPI device, when the image has been

3460

resampled to 72 DPI, it will render at 3 inches by 2 inches on a 72

3461

DPI device. Note that only a small number of image formats

3462

(e.g. JPEG, PNG, and TIFF) are capable of storing the image

3463

resolution. For formats which do not support an image resolution, the

3464

original resolution of the image must be specified via <strong>-density</strong>

3465

on the command line prior to specifying the resample resolution.</font></td></tr></table>

3466

3467

Note that Photoshop stores and obtains image resolution from a

3468

proprietary embedded profile. If this profile exists in the image,

3469

then Photoshop will continue to treat the image using its former

3470

resolution, ignoring the image resolution specified in the standard

3471

file header.</font></td></tr></table>

3472

3473

Some image formats (e.g. PNG) require use of metric or english units

3474

so even if the original image used a particular unit system, if it is

3475

saved to a different format prior to resampling, then it may be

3476

necessary to specify the desired resolution units using <strong>-units</strong>

3477

since the original units may have been lost. In other words, do not

3478

assume that the resolution units are restored if the image has been

3479

saved to a file.</font></td></tr></table>

3480

3481

<tr>

3482

3483

3484

<img SRC="../images/right_triangle_option.png"

3485

ALT=">" BORDER=0 height=14

3486

width=15><b><font face="Helvetica, Arial"

3487

><font color="#FFFFFF"><font size="+1">

3488

<a name="details-resize"></a>-resize <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

3489

</font></font></font></b></td></tr></table>

3490

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table>

3491

3492

This is an alias for the <strong>-geometry</strong> option and it behaves in the

3493

same manner. If the <strong>-filter</strong> option precedes the <strong>-resize</strong>

3494

option, the specified filter is used.</font></td></tr></table>

3495

3496

There are some exceptions:</font></td></tr></table>

3497

3498

When used as a <em>composite</em> option, <strong>-resize</strong> conveys the

3499

preferred size of the output image, while <strong>-geometry</strong> conveys the

3500

size and placement of the <em>composite image</em> within the main

3501

image.</font></td></tr></table>

3502

3503

When used as a <em>montage</em> option, <strong>-resize</strong> conveys the preferred

3504

size of the montage, while <strong>-geometry</strong> conveys

3505

information about the tiles.</font></td></tr></table>

3506

3507

<tr>

3508

3509

3510

<img SRC="../images/right_triangle_option.png"

3511

ALT=">" BORDER=0 height=14

3512

width=15><b><font face="Helvetica, Arial"

3513

><font color="#FFFFFF"><font size="+1">

3514

3515

</font></font></font></b></td></tr></table>

3516

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table>

3517

3518

See <strong>-geometry</strong> for details the geometry specification. The

3519

<em>x</em> and <em>y</em> offsets are not affected by the <strong>-gravity</strong>

3520

option.</font></td></tr></table>

3521

3522

A negative <em>x</em> offset rolls the image left-to-right. A negative

3523

<em>y</em> offset rolls the image top-to-bottom.</font></td></tr></table>

3524

3525

<tr>

3526

3527

3528

<img SRC="../images/right_triangle_option.png"

3529

ALT=">" BORDER=0 height=14

3530

width=15><b><font face="Helvetica, Arial"

3531

><font color="#FFFFFF"><font size="+1">

3532

<a name="details-rotate"></a>-rotate <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

3533

</font></font></font></b></td></tr></table>

3534

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

3535

3536

Use <tt>></tt> to rotate the image only if its width exceeds the height.

3537

<tt><</tt> rotates the image <em>only</em> if its width is less than the

3538

height. For example, if you specify <tt>-rotate "-90>"</tt> and the image

3539

size is 480x640, the image is not rotated. However, if the

3540

image is 640x480, it is rotated by -90 degrees. If you use <tt>></tt> or

3541

<tt><</tt>, enclose it in quotation marks to prevent it from being

3542

misinterpreted as a file redirection.</font></td></tr></table>

3543

3544

Empty triangles left over from rotating the image are filled with the color

3545

defined as <strong>background</strong> (class <strong>backgroundColor</strong>).

3546

The color is specified using the format described under the <strong>-fill</strong>

3547

option.</font></td></tr></table>

3548

3549

<tr>

3550

3551

3552

<img SRC="../images/right_triangle_option.png"

3553

ALT=">" BORDER=0 height=14

3554

width=15><b><font face="Helvetica, Arial"

3555

><font color="#FFFFFF"><font size="+1">

3556

<a name="details-sample"></a>-sample <i><geometry></i>

3557

</font></font></font></b></td></tr></table>

3558

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table>

3559

3560

See <strong>-geometry</strong> for details about

3561

the geometry specification.

3562

<strong>-sample</strong> ignores the <strong>-filter</strong> selection if the <strong>-filter</strong> option

3563

is present. Offsets, if present in the geometry string, are ignored, and

3564

the <strong>-gravity</strong> option has no effect.</font></td></tr></table>

3565

3566

<tr>

3567

3568

3569

<img SRC="../images/right_triangle_option.png"

3570

ALT=">" BORDER=0 height=14

3571

width=15><b><font face="Helvetica, Arial"

3572

><font color="#FFFFFF"><font size="+1">

3573

<a name="details-sampling-factor"></a>-sampling-factor <i><horizontal_factor>x<vertical_factor></i>

3574

</font></font></font></b></td></tr></table>

3575

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

3576

3577

This option specifies the sampling factors to be used by the JPEG encoder for

3578

chroma downsampling. If this option is omitted, the JPEG library

3579

will use its own default values. When reading or writing the YUV format

3580

and when writing the M2V (MPEG-2) format, use

3581

<strong>-sampling-factor 2x1</strong> to specify the 4:2:2 downsampling method.</font></td></tr></table>

3582

3583

To use the same sampling factors as those found by the JPEG decoder, use

3584

the <tt>-define jpeg:preserve-settings</tt> flag.</font></td></tr></table>

3585

3586

<tr>

3587

3588

3589

<img SRC="../images/right_triangle_option.png"

3590

ALT=">" BORDER=0 height=14

3591

width=15><b><font face="Helvetica, Arial"

3592

><font color="#FFFFFF"><font size="+1">

3593

<a name="details-scale"></a>-scale <i><geometry></i>

3594

</font></font></font></b></td></tr></table>

3595

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table>

3596

3597

See <strong>-geometry</strong> for details about

3598

the geometry specification. <strong>-scale</strong> uses a simpler, faster algorithm,

3599

and it ignores the <strong>-filter</strong> selection if the <strong>-filter</strong> option

3600

is present. Offsets, if present in the geometry string, are ignored, and

3601

the <strong>-gravity</strong> option has no effect.</font></td></tr></table>

3602

3603

<tr>

3604

3605

3606

<img SRC="../images/right_triangle_option.png"

3607

ALT=">" BORDER=0 height=14

3608

width=15><b><font face="Helvetica, Arial"

3609

><font color="#FFFFFF"><font size="+1">

3610

<a name="details-scene"></a>-scene <i><value></i>

3611

</font></font></font></b></td></tr></table>

3612

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table>

3613

3614

This option sets the scene number of an image or the first image in

3615

an image sequence.</font></td></tr></table>

3616

3617

<tr>

3618

3619

3620

<img SRC="../images/right_triangle_option.png"

3621

ALT=">" BORDER=0 height=14

3622

width=15><b><font face="Helvetica, Arial"

3623

><font color="#FFFFFF"><font size="+1">

3624

<a name="details-scenes"></a>-scenes <i><value-value></i>

3625

</font></font></font></b></td></tr></table>

3626

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table>

3627

3628

Each image in the range is read

3629

with the filename followed by a period (<strong>.</strong>) and the decimal scene

3630

number. You

3631

can change this behavior by embedding a <strong>%d, %0Nd, %o, %0No, %x, or %0Nx

3632

printf</strong> format specification in the file name. For example,</font></td></tr></table>

3633

<pre>

3634

gm montage -scenes 5-7 image.miff

3635

</pre>

3636

3637

makes a montage of files image.miff.5, image.miff.6, and image.miff.7, and</font></td></tr></table>

3638

<pre>

3639

gm animate -scenes 0-12 image%02d.miff

3640

</pre>

3641

3642

animates files image00.miff, image01.miff, through image12.miff.</font></td></tr></table>

3643

3644

<tr>

3645

3646

3647

<img SRC="../images/right_triangle_option.png"

3648

ALT=">" BORDER=0 height=14

3649

width=15><b><font face="Helvetica, Arial"

3650

><font color="#FFFFFF"><font size="+1">

3651

<a name="details-screen"></a>-screen

3652

</font></font></font></b></td></tr></table>

3653

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the screen to capture</td></tr></table>

3654

3655

This option indicates that the GetImage request used to obtain the image

3656

should be done on the root window, rather than directly on the specified

3657

window. In this way, you can obtain pieces of other windows that overlap

3658

the specified window, and more importantly, you can capture menus or other

3659

popups that are independent windows but appear over the specified window.</font></td></tr></table>

3660

3661

<tr>

3662

3663

3664

<img SRC="../images/right_triangle_option.png"

3665

ALT=">" BORDER=0 height=14

3666

width=15><b><font face="Helvetica, Arial"

3667

><font color="#FFFFFF"><font size="+1">

3668

<a name="details-segment"></a>-segment <i><cluster threshold>x<smoothing threshold></i>

3669

</font></font></font></b></td></tr></table>

3670

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table>

3671

3672

Segment an image by analyzing the histograms of the color components and

3673

identifying units that are homogeneous with the fuzzy c-means technique.</font></td></tr></table>

3674

3675

Specify <em>cluster threshold</em> as the number of pixels in each cluster

3676

must exceed the the cluster threshold to be considered valid. <em>Smoothing

3677

threshold</em> eliminates noise in the second derivative of the histogram.

3678

As the value is increased, you can expect a smoother second derivative.

3679

The default is 1.5. See

3680

"Image Segmentation", below,

3681

for details.</font></td></tr></table>

3682

3683

<tr>

3684

3685

3686

<img SRC="../images/right_triangle_option.png"

3687

ALT=">" BORDER=0 height=14

3688

width=15><b><font face="Helvetica, Arial"

3689

><font color="#FFFFFF"><font size="+1">

3690

<a name="details-shade"></a>-shade <i><azimuth>x<elevation></i>

3691

</font></font></font></b></td></tr></table>

3692

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shade the image using a distant light source</td></tr></table>

3693

3694

Specify <em>azimuth</em> and <em>elevation</em> as the position of the light

3695

source. Use <strong>+shade</strong> to return the shading results as a grayscale

3696

image.</font></td></tr></table>

3697

3698

<tr>

3699

3700

3701

<img SRC="../images/right_triangle_option.png"

3702

ALT=">" BORDER=0 height=14

3703

width=15><b><font face="Helvetica, Arial"

3704

><font color="#FFFFFF"><font size="+1">

3705

-shadow <i><radius></i>{<i>x<sigma></i>}<i></i>

3706

</font></font></font></b></td></tr></table>

3707

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shadow the montage</td></tr></table>

3708

3709

<tr>

3710

3711

3712

<img SRC="../images/right_triangle_option.png"

3713

ALT=">" BORDER=0 height=14

3714

width=15><b><font face="Helvetica, Arial"

3715

><font color="#FFFFFF"><font size="+1">

3716

<a name="details-shared-memory"></a>-shared-memory

3717

</font></font></font></b></td></tr></table>

3718

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table>

3719

3720

This option specifies whether the utility should attempt to use shared

3721

memory for pixmaps. GraphicsMagick must be compiled with shared

3722

memory support, and the display must support the <em>MIT-SHM</em>

3723

extension. Otherwise, this option is ignored. The default is

3724

3725

3726

<tr>

3727

3728

3729

<img SRC="../images/right_triangle_option.png"

3730

ALT=">" BORDER=0 height=14

3731

width=15><b><font face="Helvetica, Arial"

3732

><font color="#FFFFFF"><font size="+1">

3733

<a name="details-sharpen"></a>-sharpen <i><radius></i>{<i>x<sigma></i>}<i></i>

3734

</font></font></font></b></td></tr></table>

3735

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>

3736

3737

Use a Gaussian operator of the given radius and standard deviation

3738

(sigma).</font></td></tr></table>

3739

3740

<tr>

3741

3742

3743

<img SRC="../images/right_triangle_option.png"

3744

ALT=">" BORDER=0 height=14

3745

width=15><b><font face="Helvetica, Arial"

3746

><font color="#FFFFFF"><font size="+1">

3747

<a name="details-shave"></a>-shave <i><width>x<height></i>{<i>%</i>}<i></i>

3748

</font></font></font></b></td></tr></table>

3749

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shave pixels from the image edges</td></tr></table>

3750

3751

Specify the width of the region to be removed from both

3752

sides of the image and the height of the regions to be removed from

3753

top and bottom.</font></td></tr></table>

3754

3755

<tr>

3756

3757

3758

<img SRC="../images/right_triangle_option.png"

3759

ALT=">" BORDER=0 height=14

3760

width=15><b><font face="Helvetica, Arial"

3761

><font color="#FFFFFF"><font size="+1">

3762

<a name="details-shear"></a>-shear <i><x degrees>x<y degrees></i>

3763

</font></font></font></b></td></tr></table>

3764

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shear the image along the X or Y axis</td></tr></table>

3765

3766

Use the specified positive or negative shear angle.</font></td></tr></table>

3767

3768

Shearing slides one edge of an image along the X or Y axis, creating a

3769

parallelogram. An X direction shear slides an edge along the X axis,

3770

while a Y direction shear slides an edge along the Y axis. The amount

3771

of the shear is controlled by a shear angle. For X direction shears,

3772

<em>x degrees</em> is measured relative to the Y axis, and similarly,

3773

for Y direction shears <em>y degrees</em> is measured relative to the X

3774

axis.</font></td></tr></table>

3775

3776

Empty triangles left over from shearing the image are filled with the

3777

color defined as <strong>background</strong> (class <strong>backgroundColor</strong>).

3778

The color is specified using the format described under the

3779

<strong>-fill</strong> option.</font></td></tr></table>

3780

3781

<tr>

3782

3783

3784

<img SRC="../images/right_triangle_option.png"

3785

ALT=">" BORDER=0 height=14

3786

width=15><b><font face="Helvetica, Arial"

3787

><font color="#FFFFFF"><font size="+1">

3788

-silent

3789

</font></font></font></b></td></tr></table>

3790

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>operate silently</td></tr></table>

3791

3792

<tr>

3793

3794

3795

<img SRC="../images/right_triangle_option.png"

3796

ALT=">" BORDER=0 height=14

3797

width=15><b><font face="Helvetica, Arial"

3798

><font color="#FFFFFF"><font size="+1">

3799

<a name="details-size"></a>-size <i><width>x<height></i>{<i>+offset</i>}<i></i>

3800

</font></font></font></b></td></tr></table>

3801

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

3802

3803

Use this option to specify the width and height of raw images whose

3804

dimensions are unknown such as <strong>GRAY</strong>, <strong>RGB</strong>, or

3805

<strong>CMYK</strong>. In addition to width and height, use <strong>-size</strong> with an

3806

offset to skip any header information in the image or tell the number

3807

of colors in a <strong>MAP</strong> image file, (e.g. -size 640x512+256).</font></td></tr></table>

3808

3809

For Photo CD images, choose from these sizes:</font></td></tr></table>

3810

<pre>

3811

192x128

3812

384x256

3813

768x512

3814

1536x1024

3815

3072x2048

3816

</pre>

3817

3818

Finally, use this option to choose a particular resolution layer of a JBIG

3819

or JPEG image (e.g. -size 1024x768).</font></td></tr></table>

3820

3821

<tr>

3822

3823

3824

<img SRC="../images/right_triangle_option.png"

3825

ALT=">" BORDER=0 height=14

3826

width=15><b><font face="Helvetica, Arial"

3827

><font color="#FFFFFF"><font size="+1">

3828

<a name="details-snaps"></a>-snaps <i><value></i>

3829

</font></font></font></b></td></tr></table>

3830

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>number of screen snapshots</td></tr></table>

3831

3832

Use this option

3833

to grab more than one image from the X server screen, to create

3834

an animation sequence.</font></td></tr></table>

3835

3836

<tr>

3837

3838

3839

<img SRC="../images/right_triangle_option.png"

3840

ALT=">" BORDER=0 height=14

3841

width=15><b><font face="Helvetica, Arial"

3842

><font color="#FFFFFF"><font size="+1">

3843

<a name="details-solarize"></a>-solarize <i><factor></i>

3844

</font></font></font></b></td></tr></table>

3845

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>negate all pixels above the threshold level</td></tr></table>

3846

3847

Specify <em>factor</em> as the

3848

percent threshold of the intensity (0 - 99.9%).</font></td></tr></table>

3849

3850

This option produces a <em>solarization</em> effect seen when exposing a

3851

photographic film to light during the development process.</font></td></tr></table>

3852

3853

<tr>

3854

3855

3856

<img SRC="../images/right_triangle_option.png"

3857

ALT=">" BORDER=0 height=14

3858

width=15><b><font face="Helvetica, Arial"

3859

><font color="#FFFFFF"><font size="+1">

3860

<a name="details-spread"></a>-spread <i><amount></i>

3861

</font></font></font></b></td></tr></table>

3862

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image pixels by a random amount</td></tr></table>

3863

3864

<em>Amount</em> defines the size of the neighborhood around each pixel to

3865

choose a candidate pixel to swap.</font></td></tr></table>

3866

3867

<tr>

3868

3869

3870

<img SRC="../images/right_triangle_option.png"

3871

ALT=">" BORDER=0 height=14

3872

width=15><b><font face="Helvetica, Arial"

3873

><font color="#FFFFFF"><font size="+1">

3874

<a name="details-stegano"></a>-stegano <i><offset></i>

3875

</font></font></font></b></td></tr></table>

3876

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>hide watermark within an image</td></tr></table>

3877

3878

Use an offset to start the image hiding some number of pixels from the

3879

beginning of the image. Note this offset and the image size. You will

3880

need this information to recover the steganographic image

3881

(e.g. display -size 320x256+35 stegano:image.png).</font></td></tr></table>

3882

3883

<tr>

3884

3885

3886

<img SRC="../images/right_triangle_option.png"

3887

ALT=">" BORDER=0 height=14

3888

width=15><b><font face="Helvetica, Arial"

3889

><font color="#FFFFFF"><font size="+1">

3890

<a name="details-stereo"></a>-stereo

3891

</font></font></font></b></td></tr></table>

3892

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite two images to create a stereo anaglyph</td></tr></table>

3893

3894

The left side of the stereo pair is saved as the red channel of the output

3895

image. The right side is saved as the green channel. Red-green stereo

3896

glasses are required to properly view the stereo image.</font></td></tr></table>

3897

3898

<tr>

3899

3900

3901

<img SRC="../images/right_triangle_option.png"

3902

ALT=">" BORDER=0 height=14

3903

width=15><b><font face="Helvetica, Arial"

3904

><font color="#FFFFFF"><font size="+1">

3905

<a name="details-stroke"></a>-stroke <i><color></i>

3906

</font></font></font></b></td></tr></table>

3907

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table>

3908

3909

The color is specified using the format described under the <strong>-fill</strong>

3910

option.</font></td></tr></table>

3911

3912

See <strong>-draw</strong> for further details.</font></td></tr></table>

3913

3914

<tr>

3915

3916

3917

<img SRC="../images/right_triangle_option.png"

3918

ALT=">" BORDER=0 height=14

3919

width=15><b><font face="Helvetica, Arial"

3920

><font color="#FFFFFF"><font size="+1">

3921

<a name="details-strokewidth"></a>-strokewidth <i><value></i>

3922

</font></font></font></b></td></tr></table>

3923

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table>

3924

3925

See <strong>-draw</strong> for further details.</font></td></tr></table>

3926

3927

<tr>

3928

3929

3930

<img SRC="../images/right_triangle_option.png"

3931

ALT=">" BORDER=0 height=14

3932

width=15><b><font face="Helvetica, Arial"

3933

><font color="#FFFFFF"><font size="+1">

3934

<a name="details-swirl"></a>-swirl <i><degrees></i>

3935

</font></font></font></b></td></tr></table>

3936

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>swirl image pixels about the center</td></tr></table>

3937

3938

<em>Degrees</em> defines the tightness of the swirl.</font></td></tr></table>

3939

3940

<tr>

3941

3942

3943

<img SRC="../images/right_triangle_option.png"

3944

ALT=">" BORDER=0 height=14

3945

width=15><b><font face="Helvetica, Arial"

3946

><font color="#FFFFFF"><font size="+1">

3947

3948

</font></font></font></b></td></tr></table>

3949

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table>

3950

3951

Specifies the name of the preferred font to use in fixed (typewriter style)

3952

formatted text. The default is 14 point <em>Courier</em>.</font></td></tr></table>

3953

3954

You can tag a font to specify whether it is a PostScript, TrueType, or

3955

OPTION1 font. For example, <tt>Courier.ttf</tt> is a TrueType font

3956

and <tt>x:fixed</tt> is OPTION1.</font></td></tr></table>

3957

3958

<tr>

3959

3960

3961

<img SRC="../images/right_triangle_option.png"

3962

ALT=">" BORDER=0 height=14

3963

width=15><b><font face="Helvetica, Arial"

3964

><font color="#FFFFFF"><font size="+1">

3965

-texture <i><filename></i>

3966

</font></font></font></b></td></tr></table>

3967

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table>

3968

3969

<tr>

3970

3971

3972

<img SRC="../images/right_triangle_option.png"

3973

ALT=">" BORDER=0 height=14

3974

width=15><b><font face="Helvetica, Arial"

3975

><font color="#FFFFFF"><font size="+1">

3976

<a name="details-threshold"></a>-threshold <i><value></i>{<i><green>,<blue>,<opacity></i>}<i></i>{<i>%</i>}<i></i>

3977

</font></font></font></b></td></tr></table>

3978

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table>

3979

3980

Create an image such that any pixel sample that is equal to, or exceeds

3981

the threshold, is reassigned the maximum intensity otherwise the minimum

3982

intensity.</font></td></tr></table>

3983

3984

If the green or blue value is omitted, these channels use the same value

3985

as the first one provided. If all three color values are the same,

3986

the result is a bi-level image. If the opacity threshold is omitted,

3987

OpaqueOpacity will be used and any partially transparent pixel will

3988

become fully transparent. If only a single 0 is provided,

3989

auto-thresholding will be performed.</font></td></tr></table>

3990

3991

To generate an all-black or all-white image with the same dimensions as

3992

the input image, you can use</font></td></tr></table>

3993

<pre>

3994

gm convert -threshold 65535 in.png black.png

3995

gm convert -threshold 0,0 in.png white.png

3996

</pre>

3997

3998

<tr>

3999

4000

4001

<img SRC="../images/right_triangle_option.png"

4002

ALT=">" BORDER=0 height=14

4003

width=15><b><font face="Helvetica, Arial"

4004

><font color="#FFFFFF"><font size="+1">

4005

-tile <i><filename></i>

4006

</font></font></font></b></td></tr></table>

4007

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tile image when filling a graphic primitive</td></tr></table>

4008

4009

<tr>

4010

4011

4012

<img SRC="../images/right_triangle_option.png"

4013

ALT=">" BORDER=0 height=14

4014

width=15><b><font face="Helvetica, Arial"

4015

><font color="#FFFFFF"><font size="+1">

4016

-tile <i><geometry></i>

4017

</font></font></font></b></td></tr></table>

4018

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>layout of images [<em>montage</em>]</td></tr></table>

4019

4020

<tr>

4021

4022

4023

<img SRC="../images/right_triangle_option.png"

4024

ALT=">" BORDER=0 height=14

4025

width=15><b><font face="Helvetica, Arial"

4026

><font color="#FFFFFF"><font size="+1">

4027

<a name="details-title"></a>-title <i><string></i>

4028

</font></font></font></b></td></tr></table>

4029

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table>

4030

4031

Use this option to assign a specific title to the image. This is

4032

assigned to the image window and is typically displayed in the window

4033

title bar. Optionally you can include the image filename, type,

4034

width, height, Exif data, or other image attribute by embedding

4035

special format characters described under the <strong>-format</strong>

4036

option.</font></td></tr></table>

4037

4038

For example,</font></td></tr></table>

4039

<pre>

4040

-title "%m:%f %wx%h"

4041

</pre>

4042

4043

produces an image title of <tt>MIFF:bird.miff 512x480</tt> for an image

4044

titled <tt>bird.miff</tt> and whose width is 512 and height is 480.</font></td></tr></table>

4045

4046

<tr>

4047

4048

4049

<img SRC="../images/right_triangle_option.png"

4050

ALT=">" BORDER=0 height=14

4051

width=15><b><font face="Helvetica, Arial"

4052

><font color="#FFFFFF"><font size="+1">

4053

<a name="details-transform"></a>-transform

4054

</font></font></font></b></td></tr></table>

4055

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table>

4056

4057

This option applies the transformation matrix from a previous

4058

<strong>-affine</strong> option.</font></td></tr></table>

4059

<pre>

4060

gm convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg

4061

</pre>

4062

4063

<tr>

4064

4065

4066

<img SRC="../images/right_triangle_option.png"

4067

ALT=">" BORDER=0 height=14

4068

width=15><b><font face="Helvetica, Arial"

4069

><font color="#FFFFFF"><font size="+1">

4070

<a name="details-transparent"></a>-transparent <i><color></i>

4071

</font></font></font></b></td></tr></table>

4072

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table>

4073

4074

The color is specified using the format described under the <strong>-fill</strong>

4075

option.</font></td></tr></table>

4076

4077

<tr>

4078

4079

4080

<img SRC="../images/right_triangle_option.png"

4081

ALT=">" BORDER=0 height=14

4082

width=15><b><font face="Helvetica, Arial"

4083

><font color="#FFFFFF"><font size="+1">

4084

<a name="details-treedepth"></a>-treedepth <i><value></i>

4085

</font></font></font></b></td></tr></table>

4086

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

4087

4088

Normally, this integer value is zero or one. A value of zero or one

4089

causes the use of an optimal tree depth for the color reduction

4090

algorithm</font></td></tr></table>

4091

4092

An optimal depth generally allows the best representation of the source

4093

image with the fastest computational speed and the least amount of memory.

4094

However, the default depth is inappropriate for some images. To assure

4095

the best representation, try values between 2 and 8 for this parameter.

4096

Refer to

4097

<a href="quantize.html">quantize</a> for more details.</font></td></tr></table>

4098

4099

The <strong>-colors</strong> or <strong>-monochrome</strong> option, or writing to an image

4100

format which requires color reduction, is required for this option to

4101

take effect.</font></td></tr></table>

4102

4103

<tr>

4104

4105

4106

<img SRC="../images/right_triangle_option.png"

4107

ALT=">" BORDER=0 height=14

4108

width=15><b><font face="Helvetica, Arial"

4109

><font color="#FFFFFF"><font size="+1">

4110

<a name="details-trim"></a>-trim

4111

</font></font></font></b></td></tr></table>

4112

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

4113

4114

This option removes any edges that are exactly the same color as the

4115

corner pixels. Use <strong>-fuzz</strong> to make <strong>-trim</strong> remove edges that

4116

are nearly the same color as the corner pixels.</font></td></tr></table>

4117

4118

<tr>

4119

4120

4121

<img SRC="../images/right_triangle_option.png"

4122

ALT=">" BORDER=0 height=14

4123

width=15><b><font face="Helvetica, Arial"

4124

><font color="#FFFFFF"><font size="+1">

4125

4126

</font></font></font></b></td></tr></table>

4127

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table>

4128

4129

Choose from:

4130

<strong>Bilevel</strong>, <strong>Grayscale</strong>, <strong>Palette</strong>,

4131

<strong>PaletteMatte</strong>, <strong>TrueColor</strong>, <strong>TrueColorMatte</strong>,

4132

<strong>ColorSeparation</strong>, <strong>ColorSeparationMatte</strong>, or <strong>Optimize</strong>.</font></td></tr></table>

4133

4134

Normally, when a format supports different subformats such as grayscale

4135

and truecolor, the encoder will try to choose an efficient subformat.

4136

The <strong>-type</strong> option can be used to overrride this behavior. For

4137

example, to prevent a JPEG from being written in grayscale format even

4138

though only gray pixels are present, use</font></td></tr></table>

4139

<pre>

4140

gm convert bird.pgm -type TrueColor bird.jpg

4141

</pre>

4142

4143

Similarly, using <tt>-type TrueColorMatte</tt> will force the encoder

4144

to write an alpha channel even though the image is opaque, if the

4145

output format supports transparency.</font></td></tr></table>

4146

4147

<tr>

4148

4149

4150

<img SRC="../images/right_triangle_option.png"

4151

ALT=">" BORDER=0 height=14

4152

width=15><b><font face="Helvetica, Arial"

4153

><font color="#FFFFFF"><font size="+1">

4154

<a name="details-update"></a>-update <i><seconds></i>

4155

</font></font></font></b></td></tr></table>

4156

4157

detect when image file is modified and redisplay.</td></tr></table>

4158

4159

Suppose that while you are displaying an image the file that is currently

4160

displayed is over-written.

4161

<strong>display</strong> will automatically detect that

4162

the input file has been changed and update the displayed image accordingly.</font></td></tr></table>

4163

4164

<tr>

4165

4166

4167

<img SRC="../images/right_triangle_option.png"

4168

ALT=">" BORDER=0 height=14

4169

width=15><b><font face="Helvetica, Arial"

4170

><font color="#FFFFFF"><font size="+1">

4171

<a name="details-units"></a>-units <i><type></i>

4172

</font></font></font></b></td></tr></table>

4173

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table>

4174

4175

Choose from: <strong>Undefined</strong>, <strong>PixelsPerInch</strong>, or

4176

<strong>PixelsPerCentimeter</strong>. This option is normally used in conjunction

4177

with the <strong>-density</strong> option.</font></td></tr></table>

4178

4179

<tr>

4180

4181

4182

<img SRC="../images/right_triangle_option.png"

4183

ALT=">" BORDER=0 height=14

4184

width=15><b><font face="Helvetica, Arial"

4185

><font color="#FFFFFF"><font size="+1">

4186

<a name="details-unsharp"></a>-unsharp <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i>

4187

</font></font></font></b></td></tr></table>

4188

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table>

4189

4190

The <strong>-unsharp</strong> option sharpens an image. The image is convolved

4191

with a Gaussian operator of the given radius and standard deviation

4192

(sigma). For reasonable results, radius should be larger than sigma. Use

4193

a radius of 0 to have the method select a suitable radius.</font></td></tr></table>

4194

4195

The parameters are:</font></td></tr></table>

4196

<dl>

4197

<dt>radius</dt>

4198

<dd>

4199

The radius of the Gaussian, in pixels, not counting the center pixel (default 0).

4200

</dd>

4201

<dt>sigma</dt>

4202

<dd>

4203

The standard deviation of the Gaussian, in pixels (default 1.0).

4204

</dd>

4205

<dt>amount</dt>

4206

<dd>

4207

The percentage of the difference between the original and the blur image that

4208

is added back into the original (default 1.0).

4209

</dd>

4210

<dt>threshold</dt>

4211

<dd>

4212

The threshold, as a fraction of MaxRGB, needed to apply the difference

4213

amount (default 0.05).

4214

</dd>

4215

</dl>

4216

4217

<tr>

4218

4219

4220

<img SRC="../images/right_triangle_option.png"

4221

ALT=">" BORDER=0 height=14

4222

width=15><b><font face="Helvetica, Arial"

4223

><font color="#FFFFFF"><font size="+1">

4224

-use-pixmap

4225

</font></font></font></b></td></tr></table>

4226

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table>

4227

4228

<tr>

4229

4230

4231

<img SRC="../images/right_triangle_option.png"

4232

ALT=">" BORDER=0 height=14

4233

width=15><b><font face="Helvetica, Arial"

4234

><font color="#FFFFFF"><font size="+1">

4235

<a name="details-verbose"></a>-verbose

4236

</font></font></font></b></td></tr></table>

4237

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

4238

4239

This information is printed: image scene number; image name; image size;

4240

the image class (<em>DirectClass</em> or <em>PseudoClass</em>); the total number

4241

of unique colors; and the number of seconds to read and transform the image.

4242

Refer to <a href="miff.html">miff</a> for a description of the image class.</font></td></tr></table>

4243

4244

If <strong>-colors</strong> is also specified, the total unique colors in the image

4245

and color reduction error values are printed. Refer to <a href="quantize.html">quantize</a>

4246

for a description of these values.</font></td></tr></table>

4247

4248

<tr>

4249

4250

4251

<img SRC="../images/right_triangle_option.png"

4252

ALT=">" BORDER=0 height=14

4253

width=15><b><font face="Helvetica, Arial"

4254

><font color="#FFFFFF"><font size="+1">

4255

<a name="details-version"></a>-version

4256

</font></font></font></b></td></tr></table>

4257

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

4258

4259

<tr>

4260

4261

4262

<img SRC="../images/right_triangle_option.png"

4263

ALT=">" BORDER=0 height=14

4264

width=15><b><font face="Helvetica, Arial"

4265

><font color="#FFFFFF"><font size="+1">

4266

-view <i><string></i>

4267

</font></font></font></b></td></tr></table>

4268

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table>

4269

4270

<tr>

4271

4272

4273

<img SRC="../images/right_triangle_option.png"

4274

ALT=">" BORDER=0 height=14

4275

width=15><b><font face="Helvetica, Arial"

4276

><font color="#FFFFFF"><font size="+1">

4277

<a name="details-virtual-pixel"></a>-virtual-pixel <i><method></i>

4278

</font></font></font></b></td></tr></table>

4279

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table>

4280

4281

This option

4282

defines "virtual pixels" for use in operations that can access pixels outside

4283

the boundaries of an image.</font></td></tr></table>

4284

4285

Choose from these methods:</font></td></tr></table>

4286

<dl>

4287

<dt>Constant</dt>

4288

<dd>

4289

Use the image background color.

4290

</dd>

4291

4292

<dd>

4293

Extend the edge pixel toward infinity (default).

4294

</dd>

4295

<dt>Mirror</dt>

4296

<dd>

4297

Mirror the image.

4298

</dd>

4299

4300

<dd>

4301

Tile the image.

4302

</dd>

4303

</dl>

4304

4305

This option affects operations that use

4306

virtual pixels such as <strong>-blur</strong>, <strong>-sharpen</strong>, <strong>-wave</strong>, etc.</font></td></tr></table>

4307

4308

<tr>

4309

4310

4311

<img SRC="../images/right_triangle_option.png"

4312

ALT=">" BORDER=0 height=14

4313

width=15><b><font face="Helvetica, Arial"

4314

><font color="#FFFFFF"><font size="+1">

4315

<a name="details-visual"></a>-visual <i><type></i>

4316

</font></font></font></b></td></tr></table>

4317

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table>

4318

4319

Choose from these visual classes:</font></td></tr></table>

4320

<pre>

4321

StaticGray

4322

GrayScale

4323

StaticColor

4324

PseudoColor

4325

TrueColor

4326

DirectColor

4327

default

4328

visual id

4329

</pre>

4330

4331

The X server must support the visual you choose, otherwise an error occurs.

4332

If a visual is not specified, the visual class that can display the most

4333

simultaneous colors on the default screen is chosen.</font></td></tr></table>

4334

4335

<tr>

4336

4337

4338

<img SRC="../images/right_triangle_option.png"

4339

ALT=">" BORDER=0 height=14

4340

width=15><b><font face="Helvetica, Arial"

4341

><font color="#FFFFFF"><font size="+1">

4342

-watermark <i><brightness>x<saturation></i>

4343

</font></font></font></b></td></tr></table>

4344

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>percent brightness and saturation of a watermark</td></tr></table>

4345

4346

<tr>

4347

4348

4349

<img SRC="../images/right_triangle_option.png"

4350

ALT=">" BORDER=0 height=14

4351

width=15><b><font face="Helvetica, Arial"

4352

><font color="#FFFFFF"><font size="+1">

4353

4354

</font></font></font></b></td></tr></table>

4355

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>alter an image along a sine wave</td></tr></table>

4356

4357

Specify <em>amplitude</em> and <em>wavelength</em>

4358

of the wave.</font></td></tr></table>

4359

4360

<tr>

4361

4362

4363

<img SRC="../images/right_triangle_option.png"

4364

ALT=">" BORDER=0 height=14

4365

width=15><b><font face="Helvetica, Arial"

4366

><font color="#FFFFFF"><font size="+1">

4367

<a name="details-white-point"></a>-white-point <i><x>,<y></i>

4368

</font></font></font></b></td></tr></table>

4369

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table>

4370

4371

<tr>

4372

4373

4374

<img SRC="../images/right_triangle_option.png"

4375

ALT=">" BORDER=0 height=14

4376

width=15><b><font face="Helvetica, Arial"

4377

><font color="#FFFFFF"><font size="+1">

4378

<a name="details-window"></a>-window <i><id></i>

4379

</font></font></font></b></td></tr></table>

4380

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table>

4381

4382

<em>id</em> can be a window id or name. Specify <strong>root</strong> to

4383

select X's root window as the target window.</font></td></tr></table>

4384

4385

By default the image is tiled onto the background of the target

4386

window. If <strong>backdrop</strong> or <strong>-geometry</strong> are

4387

specified, the image is surrounded by the background color. Refer to

4388

<strong>X RESOURCES</strong> for details.</font></td></tr></table>

4389

4390

The image will not display on the root window if the image has more

4391

unique colors than the target window colormap allows. Use

4392

<strong>-colors</strong> to reduce the number of colors.</font></td></tr></table>

4393

4394

<tr>

4395

4396

4397

<img SRC="../images/right_triangle_option.png"

4398

ALT=">" BORDER=0 height=14

4399

width=15><b><font face="Helvetica, Arial"

4400

><font color="#FFFFFF"><font size="+1">

4401

-window-group

4402

</font></font></font></b></td></tr></table>

4403

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the window group</td></tr></table>

4404

4405

<tr>

4406

4407

4408

<img SRC="../images/right_triangle_option.png"

4409

ALT=">" BORDER=0 height=14

4410

width=15><b><font face="Helvetica, Arial"

4411

><font color="#FFFFFF"><font size="+1">

4412

<a name="details-write"></a>-write <i><filename></i>

4413

</font></font></font></b></td></tr></table>

4414

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write an image sequence [<em>convert, composite</em>]</td></tr></table>

4415

4416

The image sequence following the <strong>-write</strong> <em>filename</em>option is

4417

written out, and then processing continues with the

4418

same image in its current state if there are additional options. To

4419

restore the image to its original state after writing it, use

4420

the <strong>+write</strong> <em>filename</em> option.</font></td></tr></table>

4421

4422

<tr>

4423

4424

4425

<img SRC="../images/right_triangle_option.png"

4426

ALT=">" BORDER=0 height=14

4427

width=15><b><font face="Helvetica, Arial"

4428

><font color="#FFFFFF"><font size="+1">

4429

<a name="details-write"></a>-write <i><filename></i>

4430

</font></font></font></b></td></tr></table>

4431

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write the image to a file [<em>display</em>]</td></tr></table>

4432

4433

If <em>filename</em> already exists, you will be prompted as to whether it should

4434

be overwritten.</font></td></tr></table>

4435

4436

By default, the image is written in the format that it was read in as.

4437

To specify a particular image format, prefix <em>filename</em> with the

4438

image type and a colon (e.g., ps:image) or specify the image type as

4439

the filename suffix (e.g., image.ps). Specify file as - for standard

4440

output. If file has the extension <strong>.Z</strong> or <strong>.gz</strong>, the file

4441

size is <strong>compressed</strong> using compress or <strong>gzip</strong>

4442

respectively. Precede the image file name with | to pipe to a system

4443

command.</font></td></tr></table>

4444

4445

Use <strong>-compress</strong> to specify the type of image compression.</font></td></tr></table>

4446

4447

The equivalent X resource for this option is

4448

<strong>writeFilename</strong> (class <strong>WriteFilename</strong>).

4449

See

4450

"X Resources", below,

4451

for details.</font></td></tr></table>

4452

</td></tr></table>

4453

<p>

4454

<i><a href="#top">Back to Contents</a></i>

4455

 </p>

4456

4457

4458

<tr>

4459

<td ALIGN=LEFT bgcolor="#52799E"><img

4460

SRC="../images/right_triangle.png" ALT=">" BORDER=0

4461

height=14 width=15><b><font face="Helvetica, Arial"><font

4462

color="#FFFFFF"><font size="+1">

4463

<a NAME="animate"></a>gm animate

4464

</font></font></font></b></td></tr></table>

4465

4466

4467

<p>

4468

<strong>Animate</strong> displays a sequence of images on any workstation display

4469

running an X server. <strong>animate</strong> first determines the hardware capabilities

4470

of the workstation. If the number of unique colors in an image is less

4471

than or equal to the number the workstation can support, the image is displayed

4472

in an X window. Otherwise the number of colors in the image is first reduced

4473

to match the color resolution of the workstation before it is displayed.

4474

<p>

4475

This means that a continuous-tone 24 bits-per-pixel image can display on

4476

a 8 bit pseudo-color device or monochrome device. In most instances the

4477

reduced color image closely resembles the original. Alternatively, a monochrome

4478

or pseudo-color image sequence can display on a continuous-tone 24 bits-per-pixel

4479

device.

4480

<p>

4481

To help prevent color flashing on X server visuals that have colormaps,

4482

<strong>animate</strong>

4483

creates a single colormap from the image sequence. This can be rather time

4484

consuming. You can speed this operation up by reducing the colors in the

4485

image before you "animate" them. Use <strong>mogrify</strong> to color reduce the

4486

images to a single colormap. See <strong>mogrify(1)</strong> for details. Alternatively,

4487

you can use a Standard Colormap; or a static, direct, or true color visual.

4488

You can define a Standard Colormap with <em>xstdcmap</em>. See <strong>xstdcmap(1)</strong>

4489

for details. This method is recommended for colormapped X server because

4490

it eliminates the need to compute a global colormap.

4491

</td></tr></table>

4492

<p>

4493

<i><a href="#top">Back to Contents</a></i>

4494

 </p>

4495

4496

<tr>

4497

<td ALIGN=LEFT bgcolor="#52799E"><img

4498

SRC="../images/right_triangle.png" ALT=">" BORDER=0

4499

height=14 width=15><b><font face="Helvetica, Arial"><font

4500

color="#FFFFFF"><font size="+1">

4501

<a NAME="exam"></a>Examples

4502

</font></font></font></b></td></tr></table>

4503

4504

4505

<p>

4506

To animate a set of images of a cockatoo, use:

4507

<pre>

4508

gm animate cockatoo.*

4509

</pre>

4510

<p>

4511

To animate a cockatoo image sequence while using the Standard Colormap

4512

<em>best</em>, use:

4513

<pre>

4514

xstdcmap -best

4515

gm animate -map best cockatoo.*

4516

</pre>

4517

<p>

4518

To animate an image of a cockatoo without a border centered on a backdrop,

4519

use:

4520

4521

<pre>

4522

gm animate +borderwidth -backdrop cockatoo.*

4523

</pre>

4524

</td></tr></table>

4525

<p>

4526

<i><a href="#top">Back to Contents</a></i>

4527

 </p>

4528

4529

<tr>

4530

<td ALIGN=LEFT bgcolor="#52799E"><img

4531

SRC="../images/right_triangle.png" ALT=">" BORDER=0

4532

height=14 width=15><b><font face="Helvetica, Arial"><font

4533

color="#FFFFFF"><font size="+1">

4534

<a NAME="opti"></a>Options

4535

</font></font></font></b></td></tr></table>

4536

4537

4538

<p>

4539

For a more detailed description of each option, see

4540

Options, above.

4541

4542

4543

<tr>

4544

4545

4546

<img SRC="../images/right_triangle_option.png"

4547

ALT=">" BORDER=0 height=14

4548

width=15><b><font face="Helvetica, Arial"

4549

><font color="#FFFFFF"><font size="+1">

4550

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

4551

</font></font></font></b></td></tr></table>

4552

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

4553

4554

<tr>

4555

4556

4557

<img SRC="../images/right_triangle_option.png"

4558

ALT=">" BORDER=0 height=14

4559

width=15><b><font face="Helvetica, Arial"

4560

><font color="#FFFFFF"><font size="+1">

4561

<a href="GraphicsMagick.html#details-backdrop">-backdrop</a>

4562

</font></font></font></b></td></tr></table>

4563

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table>

4564

4565

<tr>

4566

4567

4568

<img SRC="../images/right_triangle_option.png"

4569

ALT=">" BORDER=0 height=14

4570

width=15><b><font face="Helvetica, Arial"

4571

><font color="#FFFFFF"><font size="+1">

4572

<a href="GraphicsMagick.html#details-background">-background</a> <i><color></i>

4573

</font></font></font></b></td></tr></table>

4574

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

4575

4576

<tr>

4577

4578

4579

<img SRC="../images/right_triangle_option.png"

4580

ALT=">" BORDER=0 height=14

4581

width=15><b><font face="Helvetica, Arial"

4582

><font color="#FFFFFF"><font size="+1">

4583

<a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i>

4584

</font></font></font></b></td></tr></table>

4585

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

4586

4587

<tr>

4588

4589

4590

<img SRC="../images/right_triangle_option.png"

4591

ALT=">" BORDER=0 height=14

4592

width=15><b><font face="Helvetica, Arial"

4593

><font color="#FFFFFF"><font size="+1">

4594

-borderwidth <i><geometry></i>

4595

</font></font></font></b></td></tr></table>

4596

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table>

4597

4598

<tr>

4599

4600

4601

<img SRC="../images/right_triangle_option.png"

4602

ALT=">" BORDER=0 height=14

4603

width=15><b><font face="Helvetica, Arial"

4604

><font color="#FFFFFF"><font size="+1">

4605

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

4606

</font></font></font></b></td></tr></table>

4607

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

4608

4609

<tr>

4610

4611

4612

<img SRC="../images/right_triangle_option.png"

4613

ALT=">" BORDER=0 height=14

4614

width=15><b><font face="Helvetica, Arial"

4615

><font color="#FFFFFF"><font size="+1">

4616

4617

</font></font></font></b></td></tr></table>

4618

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table>

4619

4620

<tr>

4621

4622

4623

<img SRC="../images/right_triangle_option.png"

4624

ALT=">" BORDER=0 height=14

4625

width=15><b><font face="Helvetica, Arial"

4626

><font color="#FFFFFF"><font size="+1">

4627

<a href="GraphicsMagick.html#details-colormap">-colormap</a> <i><type></i>

4628

</font></font></font></b></td></tr></table>

4629

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table>

4630

4631

<tr>

4632

4633

4634

<img SRC="../images/right_triangle_option.png"

4635

ALT=">" BORDER=0 height=14

4636

width=15><b><font face="Helvetica, Arial"

4637

><font color="#FFFFFF"><font size="+1">

4638

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

4639

</font></font></font></b></td></tr></table>

4640

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

4641

4642

<tr>

4643

4644

4645

<img SRC="../images/right_triangle_option.png"

4646

ALT=">" BORDER=0 height=14

4647

width=15><b><font face="Helvetica, Arial"

4648

><font color="#FFFFFF"><font size="+1">

4649

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

4650

</font></font></font></b></td></tr></table>

4651

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

4652

4653

<tr>

4654

4655

4656

<img SRC="../images/right_triangle_option.png"

4657

ALT=">" BORDER=0 height=14

4658

width=15><b><font face="Helvetica, Arial"

4659

><font color="#FFFFFF"><font size="+1">

4660

4661

</font></font></font></b></td></tr></table>

4662

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

4663

4664

<tr>

4665

4666

4667

<img SRC="../images/right_triangle_option.png"

4668

ALT=">" BORDER=0 height=14

4669

width=15><b><font face="Helvetica, Arial"

4670

><font color="#FFFFFF"><font size="+1">

4671

-debug <i><events></i>

4672

</font></font></font></b></td></tr></table>

4673

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

4674

4675

<tr>

4676

4677

4678

<img SRC="../images/right_triangle_option.png"

4679

ALT=">" BORDER=0 height=14

4680

width=15><b><font face="Helvetica, Arial"

4681

><font color="#FFFFFF"><font size="+1">

4682

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

4683

</font></font></font></b></td></tr></table>

4684

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

4685

4686

<tr>

4687

4688

4689

<img SRC="../images/right_triangle_option.png"

4690

ALT=">" BORDER=0 height=14

4691

width=15><b><font face="Helvetica, Arial"

4692

><font color="#FFFFFF"><font size="+1">

4693

<a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i>

4694

</font></font></font></b></td></tr></table>

4695

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>

4696

4697

<tr>

4698

4699

4700

<img SRC="../images/right_triangle_option.png"

4701

ALT=">" BORDER=0 height=14

4702

width=15><b><font face="Helvetica, Arial"

4703

><font color="#FFFFFF"><font size="+1">

4704

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

4705

</font></font></font></b></td></tr></table>

4706

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

4707

4708

<tr>

4709

4710

4711

<img SRC="../images/right_triangle_option.png"

4712

ALT=">" BORDER=0 height=14

4713

width=15><b><font face="Helvetica, Arial"

4714

><font color="#FFFFFF"><font size="+1">

4715

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

4716

</font></font></font></b></td></tr></table>

4717

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

4718

4719

<tr>

4720

4721

4722

<img SRC="../images/right_triangle_option.png"

4723

ALT=">" BORDER=0 height=14

4724

width=15><b><font face="Helvetica, Arial"

4725

><font color="#FFFFFF"><font size="+1">

4726

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

4727

</font></font></font></b></td></tr></table>

4728

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

4729

4730

<tr>

4731

4732

4733

<img SRC="../images/right_triangle_option.png"

4734

ALT=">" BORDER=0 height=14

4735

width=15><b><font face="Helvetica, Arial"

4736

><font color="#FFFFFF"><font size="+1">

4737

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

4738

</font></font></font></b></td></tr></table>

4739

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

4740

4741

<tr>

4742

4743

4744

<img SRC="../images/right_triangle_option.png"

4745

ALT=">" BORDER=0 height=14

4746

width=15><b><font face="Helvetica, Arial"

4747

><font color="#FFFFFF"><font size="+1">

4748

<a href="GraphicsMagick.html#details-dither">-dither</a>

4749

</font></font></font></b></td></tr></table>

4750

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

4751

4752

<tr>

4753

4754

4755

<img SRC="../images/right_triangle_option.png"

4756

ALT=">" BORDER=0 height=14

4757

width=15><b><font face="Helvetica, Arial"

4758

><font color="#FFFFFF"><font size="+1">

4759

4760

</font></font></font></b></td></tr></table>

4761

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

4762

4763

<tr>

4764

4765

4766

<img SRC="../images/right_triangle_option.png"

4767

ALT=">" BORDER=0 height=14

4768

width=15><b><font face="Helvetica, Arial"

4769

><font color="#FFFFFF"><font size="+1">

4770

<a href="GraphicsMagick.html#details-foreground">-foreground</a> <i><color></i>

4771

</font></font></font></b></td></tr></table>

4772

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table>

4773

4774

<tr>

4775

4776

4777

<img SRC="../images/right_triangle_option.png"

4778

ALT=">" BORDER=0 height=14

4779

width=15><b><font face="Helvetica, Arial"

4780

><font color="#FFFFFF"><font size="+1">

4781

<a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i>

4782

</font></font></font></b></td></tr></table>

4783

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>

4784

4785

<tr>

4786

4787

4788

<img SRC="../images/right_triangle_option.png"

4789

ALT=">" BORDER=0 height=14

4790

width=15><b><font face="Helvetica, Arial"

4791

><font color="#FFFFFF"><font size="+1">

4792

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

4793

</font></font></font></b></td></tr></table>

4794

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

4795

4796

<tr>

4797

4798

4799

<img SRC="../images/right_triangle_option.png"

4800

ALT=">" BORDER=0 height=14

4801

width=15><b><font face="Helvetica, Arial"

4802

><font color="#FFFFFF"><font size="+1">

4803

-help

4804

</font></font></font></b></td></tr></table>

4805

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

4806

4807

<tr>

4808

4809

4810

<img SRC="../images/right_triangle_option.png"

4811

ALT=">" BORDER=0 height=14

4812

width=15><b><font face="Helvetica, Arial"

4813

><font color="#FFFFFF"><font size="+1">

4814

<a href="GraphicsMagick.html#details-iconGeometry">-iconGeometry</a> <i><geometry></i>

4815

</font></font></font></b></td></tr></table>

4816

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table>

4817

4818

<tr>

4819

4820

4821

<img SRC="../images/right_triangle_option.png"

4822

ALT=">" BORDER=0 height=14

4823

width=15><b><font face="Helvetica, Arial"

4824

><font color="#FFFFFF"><font size="+1">

4825

-iconic

4826

</font></font></font></b></td></tr></table>

4827

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table>

4828

4829

<tr>

4830

4831

4832

<img SRC="../images/right_triangle_option.png"

4833

ALT=">" BORDER=0 height=14

4834

width=15><b><font face="Helvetica, Arial"

4835

><font color="#FFFFFF"><font size="+1">

4836

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

4837

</font></font></font></b></td></tr></table>

4838

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

4839

4840

<tr>

4841

4842

4843

<img SRC="../images/right_triangle_option.png"

4844

ALT=">" BORDER=0 height=14

4845

width=15><b><font face="Helvetica, Arial"

4846

><font color="#FFFFFF"><font size="+1">

4847

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

4848

</font></font></font></b></td></tr></table>

4849

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

4850

4851

<tr>

4852

4853

4854

<img SRC="../images/right_triangle_option.png"

4855

ALT=">" BORDER=0 height=14

4856

width=15><b><font face="Helvetica, Arial"

4857

><font color="#FFFFFF"><font size="+1">

4858

4859

</font></font></font></b></td></tr></table>

4860

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

4861

4862

<tr>

4863

4864

4865

<img SRC="../images/right_triangle_option.png"

4866

ALT=">" BORDER=0 height=14

4867

width=15><b><font face="Helvetica, Arial"

4868

><font color="#FFFFFF"><font size="+1">

4869

4870

</font></font></font></b></td></tr></table>

4871

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table>

4872

4873

<tr>

4874

4875

4876

<img SRC="../images/right_triangle_option.png"

4877

ALT=">" BORDER=0 height=14

4878

width=15><b><font face="Helvetica, Arial"

4879

><font color="#FFFFFF"><font size="+1">

4880

<a href="GraphicsMagick.html#details-matte">-matte</a>

4881

</font></font></font></b></td></tr></table>

4882

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

4883

4884

<tr>

4885

4886

4887

<img SRC="../images/right_triangle_option.png"

4888

ALT=">" BORDER=0 height=14

4889

width=15><b><font face="Helvetica, Arial"

4890

><font color="#FFFFFF"><font size="+1">

4891

<a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i>

4892

</font></font></font></b></td></tr></table>

4893

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>

4894

4895

<tr>

4896

4897

4898

<img SRC="../images/right_triangle_option.png"

4899

ALT=">" BORDER=0 height=14

4900

width=15><b><font face="Helvetica, Arial"

4901

><font color="#FFFFFF"><font size="+1">

4902

-monochrome

4903

</font></font></font></b></td></tr></table>

4904

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

4905

4906

<tr>

4907

4908

4909

<img SRC="../images/right_triangle_option.png"

4910

ALT=">" BORDER=0 height=14

4911

width=15><b><font face="Helvetica, Arial"

4912

><font color="#FFFFFF"><font size="+1">

4913

-name

4914

</font></font></font></b></td></tr></table>

4915

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table>

4916

4917

<tr>

4918

4919

4920

<img SRC="../images/right_triangle_option.png"

4921

ALT=">" BORDER=0 height=14

4922

width=15><b><font face="Helvetica, Arial"

4923

><font color="#FFFFFF"><font size="+1">

4924

4925

</font></font></font></b></td></tr></table>

4926

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>

4927

4928

<tr>

4929

4930

4931

<img SRC="../images/right_triangle_option.png"

4932

ALT=">" BORDER=0 height=14

4933

width=15><b><font face="Helvetica, Arial"

4934

><font color="#FFFFFF"><font size="+1">

4935

<a href="GraphicsMagick.html#details-pause">-pause</a> <i><seconds></i>

4936

</font></font></font></b></td></tr></table>

4937

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between animation loops [animate]</td></tr></table>

4938

4939

<tr>

4940

4941

4942

<img SRC="../images/right_triangle_option.png"

4943

ALT=">" BORDER=0 height=14

4944

width=15><b><font face="Helvetica, Arial"

4945

><font color="#FFFFFF"><font size="+1">

4946

<a href="GraphicsMagick.html#details-remote">-remote</a>

4947

</font></font></font></b></td></tr></table>

4948

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table>

4949

4950

<tr>

4951

4952

4953

<img SRC="../images/right_triangle_option.png"

4954

ALT=">" BORDER=0 height=14

4955

width=15><b><font face="Helvetica, Arial"

4956

><font color="#FFFFFF"><font size="+1">

4957

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

4958

</font></font></font></b></td></tr></table>

4959

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

4960

4961

<tr>

4962

4963

4964

<img SRC="../images/right_triangle_option.png"

4965

ALT=">" BORDER=0 height=14

4966

width=15><b><font face="Helvetica, Arial"

4967

><font color="#FFFFFF"><font size="+1">

4968

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

4969

</font></font></font></b></td></tr></table>

4970

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

4971

4972

<tr>

4973

4974

4975

<img SRC="../images/right_triangle_option.png"

4976

ALT=">" BORDER=0 height=14

4977

width=15><b><font face="Helvetica, Arial"

4978

><font color="#FFFFFF"><font size="+1">

4979

<a href="GraphicsMagick.html#details-scenes">-scenes</a> <i><value-value></i>

4980

</font></font></font></b></td></tr></table>

4981

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table>

4982

4983

<tr>

4984

4985

4986

<img SRC="../images/right_triangle_option.png"

4987

ALT=">" BORDER=0 height=14

4988

width=15><b><font face="Helvetica, Arial"

4989

><font color="#FFFFFF"><font size="+1">

4990

<a href="GraphicsMagick.html#details-shared-memory">-shared-memory</a>

4991

</font></font></font></b></td></tr></table>

4992

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table>

4993

4994

<tr>

4995

4996

4997

<img SRC="../images/right_triangle_option.png"

4998

ALT=">" BORDER=0 height=14

4999

width=15><b><font face="Helvetica, Arial"

5000

><font color="#FFFFFF"><font size="+1">

5001

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

5002

</font></font></font></b></td></tr></table>

5003

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

5004

5005

<tr>

5006

5007

5008

<img SRC="../images/right_triangle_option.png"

5009

ALT=">" BORDER=0 height=14

5010

width=15><b><font face="Helvetica, Arial"

5011

><font color="#FFFFFF"><font size="+1">

5012

5013

</font></font></font></b></td></tr></table>

5014

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table>

5015

5016

<tr>

5017

5018

5019

<img SRC="../images/right_triangle_option.png"

5020

ALT=">" BORDER=0 height=14

5021

width=15><b><font face="Helvetica, Arial"

5022

><font color="#FFFFFF"><font size="+1">

5023

<a href="GraphicsMagick.html#details-title">-title</a> <i><string></i>

5024

</font></font></font></b></td></tr></table>

5025

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table>

5026

5027

<tr>

5028

5029

5030

<img SRC="../images/right_triangle_option.png"

5031

ALT=">" BORDER=0 height=14

5032

width=15><b><font face="Helvetica, Arial"

5033

><font color="#FFFFFF"><font size="+1">

5034

<a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i>

5035

</font></font></font></b></td></tr></table>

5036

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

5037

5038

<tr>

5039

5040

5041

<img SRC="../images/right_triangle_option.png"

5042

ALT=">" BORDER=0 height=14

5043

width=15><b><font face="Helvetica, Arial"

5044

><font color="#FFFFFF"><font size="+1">

5045

5046

</font></font></font></b></td></tr></table>

5047

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

5048

5049

<tr>

5050

5051

5052

<img SRC="../images/right_triangle_option.png"

5053

ALT=">" BORDER=0 height=14

5054

width=15><b><font face="Helvetica, Arial"

5055

><font color="#FFFFFF"><font size="+1">

5056

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

5057

</font></font></font></b></td></tr></table>

5058

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

5059

5060

<tr>

5061

5062

5063

<img SRC="../images/right_triangle_option.png"

5064

ALT=">" BORDER=0 height=14

5065

width=15><b><font face="Helvetica, Arial"

5066

><font color="#FFFFFF"><font size="+1">

5067

<a href="GraphicsMagick.html#details-version">-version</a>

5068

</font></font></font></b></td></tr></table>

5069

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

5070

5071

<tr>

5072

5073

5074

<img SRC="../images/right_triangle_option.png"

5075

ALT=">" BORDER=0 height=14

5076

width=15><b><font face="Helvetica, Arial"

5077

><font color="#FFFFFF"><font size="+1">

5078

<a href="GraphicsMagick.html#details-visual">-visual</a> <i><type></i>

5079

</font></font></font></b></td></tr></table>

5080

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table>

5081

5082

<tr>

5083

5084

5085

<img SRC="../images/right_triangle_option.png"

5086

ALT=">" BORDER=0 height=14

5087

width=15><b><font face="Helvetica, Arial"

5088

><font color="#FFFFFF"><font size="+1">

5089

<a href="GraphicsMagick.html#details-window">-window</a> <i><id></i>

5090

</font></font></font></b></td></tr></table>

5091

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table>

5092

<p>

5093

For a more detailed description of each option, see

5094

Options, above.

5095

5096

<p>

5097

Any option you specify on the command line remains in effect for the group

5098

of images following it, until the group is terminated by the appearance of

5099

any option or <strong>-noop</strong>. For example, to animate three images, the first

5100

with 32 colors, the second with an unlimited number of colors, and the

5101

third with only 16 colors, use:

5102

5103

<pre>

5104

gm animate -colors 32 cockatoo.1 -noop cockatoo.2

5105

-colors 16 cockatoo.3

5106

</pre>

5107

<p>

5108

<strong>Animate</strong> options can appear on the command line or in your X resources

5109

file. See <em>X(1)</em>. Options on the command line supersede values specified

5110

in your X resources file.

5111

<p>Image filenames may appear in any order on the command line if the image

5112

format is <em>MIFF</em> (refer to <strong>miff(5)</strong> and the

5113

<strong>scene</strong> keyword

5114

is specified in the image. Otherwise the images will display in the order

5115

they appear on the command line.

5116

</td></tr></table>

5117

<p>

5118

<i><a href="#top">Back to Contents</a></i>

5119

 </p>

5120

5121

<tr>

5122

<td ALIGN=LEFT bgcolor="#52799E"><img

5123

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5124

height=14 width=15><b><font face="Helvetica, Arial"><font

5125

color="#FFFFFF"><font size="+1">

5126

<a NAME="mous"></a>Mouse Buttons

5127

</font></font></font></b></td></tr></table>

5128

5129

5130

<p>

5131

Press any button to map or unmap the Command widget. See the next section

5132

for more information about the Command widget.

5133

</td></tr></table>

5134

<p>

5135

<i><a href="#top">Back to Contents</a></i>

5136

 </p>

5137

5138

<tr>

5139

<td ALIGN=LEFT bgcolor="#52799E"><img

5140

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5141

height=14 width=15><b><font face="Helvetica, Arial"><font

5142

color="#FFFFFF"><font size="+1">

5143

<a NAME="comm"></a>Command Widget

5144

</font></font></font></b></td></tr></table>

5145

5146

5147

<p>

5148

The Command widget lists a number of sub-menus and commands. They are

5149

<ul>

5150

<li><strong>Animate</strong>

5151

<ul>

5152

<li> Open

5153

<li> Play

5154

<li> Step

5155

<li> Repeat

5156

<li> Auto Reverse

5157

</ul>

5158

<li><strong>Speed</strong>

5159

<ul>

5160

<li> Faster

5161

<li> Slower

5162

</ul>

5163

<li><strong>Direction</strong>

5164

<ul>

5165

<li> Forward

5166

<li> Reverse

5167

</ul>

5168

<li><strong>Image Info</strong>

5169

5170

5171

</ul>

5172

<p>

5173

Menu items with a indented triangle have a sub-menu. They are represented

5174

above as the indented items. To access a sub-menu item, move the pointer

5175

to the appropriate menu and press a button and drag. When you find the

5176

desired sub-menu item, release the button and the command is executed.

5177

Move the pointer away from the sub-menu if you decide not to execute a

5178

particular command.

5179

</td></tr></table>

5180

<p>

5181

<i><a href="#top">Back to Contents</a></i>

5182

 </p>

5183

5184

<tr>

5185

<td ALIGN=LEFT bgcolor="#52799E"><img

5186

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5187

height=14 width=15><b><font face="Helvetica, Arial"><font

5188

color="#FFFFFF"><font size="+1">

5189

<a NAME="keyb"></a>Keyboard Accelerators

5190

</font></font></font></b></td></tr></table>

5191

5192

5193

<dl>

5194

5195

<dd>Press to load an image from a file.</dd>

5196

<dt><strong>space</strong></dt>

5197

<dd>Press to display the next image in the sequence.</dd>

5198

5199

<dd>Press to speed-up the display of the images. Refer to

5200

<strong>-delay</strong> for more information.</dd>

5201

5202

<dd>Press to slow the display of the images. Refer to

5203

<strong>-delay</strong> for more information.</dd>

5204

5205

<dd>Press to display information about the image. Press

5206

any key or button to erase the information.</dd>

5207

<dd>This information is printed: image name; image size;

5208

and the total number of unique colors in the image.</dd>

5209

5210

<dd>Press to display helpful information about <strong>animate(1)</strong>.</dd>

5211

5212

<dd>Press to discard all images and exit program.</dd>

5213

</dl>

5214

</td></tr></table>

5215

<p>

5216

<i><a href="#top">Back to Contents</a></i>

5217

 </p>

5218

5219

<tr>

5220

<td ALIGN=LEFT bgcolor="#52799E"><img

5221

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5222

height=14 width=15><b><font face="Helvetica, Arial"><font

5223

color="#FFFFFF"><font size="+1">

5224

<a NAME="xres"></a>X Resources

5225

</font></font></font></b></td></tr></table>

5226

5227

5228

<p>

5229

<strong>Animate</strong> options can appear on the command line or in your X resource

5230

file. Options on the command line supersede values specified in your X

5231

resource file. See <strong>X(1)</strong> for more information on X resources.

5232

<p>

5233

All <strong>animate</strong> options have a corresponding X resource. In addition,

5234

the <strong>animate</strong> program uses the following X resources:

5235

<dl>

5236

<dt><strong>background</strong> <strong>(</strong><em>class</em> <strong>Background)</strong></dt>

5237

<dd>

5238

Specifies the preferred color to use for the Image window background. The

5239

default is #ccc.</dd>

5240

<dt><strong>borderColor</strong> <strong>(</strong><em>class</em> <strong>BorderColor)</strong></dt>

5241

<dd>

5242

Specifies the preferred color to use for the Image window border. The default

5243

is #ccc.</dd>

5244

<dt><strong>borderWidth</strong> <strong>(</strong><em>class</em> <strong>BorderWidth)</strong></dt>

5245

<dd>

5246

Specifies the width in pixels of the Image window border. The default is

5247

2.</dd>

5248

<dt><strong>font</strong> <strong>(</strong><em>class</em> <strong>Font</strong> <strong>or</strong> <strong>FontList)</strong></dt>

5249

<dd>

5250

Specifies the name of the preferred font to use in normal formatted text.

5251

The default is 14 point <em>Helvetica</em>.</dd>

5252

<dt><strong>foreground</strong> <strong>(</strong><em>class</em> <strong>Foreground)</strong></dt>

5253

<dd>

5254

Specifies the preferred color to use for text within the Image window.

5255

The default is black.</dd>

5256

<dt><strong>geometry</strong> <strong>(</strong><em>class</em> <strong>geometry)</strong></dt>

5257

<dd>

5258

Specifies the preferred size and position of the image window. It is not

5259

necessarily obeyed by all window managers.

5260

Offsets, if present, are handled in <em>X(1)</em> style. A negative x offset is

5261

measured from the right edge of the screen to the right edge of the icon,

5262

and a negative y offset is measured from the bottom edge of the screen

5263

to the bottom edge of the icon.</dd>

5264

<dt><strong>iconGeometry</strong> <strong>(</strong><em>class</em> <strong>IconGeometry)</strong></dt>

5265

<dd>

5266

Specifies the preferred size and position of the application when iconified.

5267

It is not necessarily obeyed by all window managers.

5268

Offsets, if present, are handled in the same manner as in class Geometry.</dd>

5269

<dt><strong>iconic</strong> <strong>(</strong><em>class</em> <strong>Iconic)</strong></dt>

5270

<dd>

5271

This resource indicates that you would prefer that the application's windows

5272

initially not be visible as if the windows had be immediately iconified

5273

by you. Window managers may choose not to honor the application's request.</dd>

5274

<dt><strong>matteColor</strong> <strong>(</strong><em>class</em> <strong>MatteColor)</strong></dt>

5275

<dd>

5276

Specify the color of windows. It is used for the backgrounds of windows,

5277

menus, and notices. A 3D effect is achieved by using highlight and shadow

5278

colors derived from this color. Default value: #ddd.</dd>

5279

<dt><strong>name</strong> <strong>(</strong><em>class</em> <strong>Name)</strong></dt>

5280

<dd>

5281

This resource specifies the name under which resources for the application

5282

should be found. This resource is useful in shell aliases to distinguish

5283

between invocations of an application, without resorting to creating links

5284

to alter the executable file name. The default is the application name.</dd>

5285

<dt><strong>sharedMemory</strong> <strong>(</strong><em>class</em> <strong>SharedMemory)</strong></dt>

5286

<dd>

5287

This resource specifies whether animate should attempt use shared memory

5288

for pixmaps. ImageMagick must be compiled with shared memory support, and

5289

the display must support the MIT-SHM extension. Otherwise, this resource

5290

is ignored. The default is True.</dd>

5291

<dt><strong>text_font</strong> <strong>(</strong><em>class</em> <strong>textFont)</strong></dt>

5292

<dd>

5293

Specifies the name of the preferred font to use in fixed (typewriter style)

5294

formatted text. The default is 14 point <em>Courier</em>.</dd>

5295

<dt><strong>title</strong> <strong>(</strong><em>class</em> <strong>Title)</strong></dt>

5296

<dd>

5297

This resource specifies the title to be used for the Image window. This

5298

information is sometimes used by a window manager to provide some sort

5299

of header identifying the window. The default is the image file name.</dd>

5300

</dl>

5301

</td></tr></table>

5302

<p>

5303

<i><a href="#top">Back to Contents</a></i>

5304

 </p>

5305

5306

5307

<tr>

5308

<td ALIGN=LEFT bgcolor="#52799E"><img

5309

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5310

height=14 width=15><b><font face="Helvetica, Arial"><font

5311

color="#FFFFFF"><font size="+1">

5312

<a NAME="composite"></a>gm composite

5313

</font></font></font></b></td></tr></table>

5314

5315

5316

<p>

5317

<strong>composite</strong> composites (combines) images to create new images.

5318

<p><em>base-image</em> is the base image and <em>change-image</em> contains the changes.

5319

<em>ouput-image</em> is the result, and normally has the same dimensions

5320

as <em>base-image</em>.

5321

5322

<p>

5323

The optional <em>mask-image</em> can be used to provide opacity information

5324

for <em>change-image</em> when it has none or if you want a different mask.

5325

A mask image is typically grayscale and the same size as

5326

<strong>base-image</strong>. If <em>mask-image</em> is not grayscale, it is converted

5327

to grayscale and the resulting intensities are used as opacity

5328

information.

5329

</td></tr></table>

5330

5331

<tr>

5332

<td ALIGN=LEFT bgcolor="#52799E"><img

5333

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5334

height=14 width=15><b><font face="Helvetica, Arial"><font

5335

color="#FFFFFF"><font size="+1">

5336

<a NAME="comp-exam"></a>Examples

5337

</font></font></font></b></td></tr></table>

5338

5339

5340

<p>

5341

To composite an image of a cockatoo with a perch, use:

5342

<pre>

5343

gm composite cockatoo.miff perch.ras composite.miff

5344

</pre>

5345

<p>

5346

To compute the difference between images in a series, use:

5347

<pre>

5348

gm composite -compose difference series.2 series.1

5349

difference.miff

5350

</pre>

5351

<p>

5352

To composite an image of a cockatoo with a perch starting at location (100,150),

5353

use:

5354

<pre>

5355

gm composite -geometry +100+150 cockatoo.miff

5356

perch.ras composite.miff

5357

</pre>

5358

<p>

5359

To tile a logo across your image of a cockatoo, use

5360

<pre>

5361

gm convert +shade 30x60 cockatoo.miff mask.miff

5362

gm composite -compose bumpmap -tile logo.png

5363

cockatoo.miff mask.miff composite.miff

5364

</pre>

5365

<p>

5366

To composite a red, green, and blue color plane into a single composite image,

5367

try

5368

<pre>

5369

gm composite -compose CopyGreen green.png red.png

5370

red-green.png

5371

gm composite -compose CopyBlue blue.png red-green.png

5372

gm composite.png

5373

</pre>

5374

</td></tr></table>

5375

<p>

5376

<i><a href="#top">Back to Contents</a></i>

5377

 </p>

5378

5379

<tr>

5380

<td ALIGN=LEFT bgcolor="#52799E"><img

5381

SRC="../images/right_triangle.png" ALT=">" BORDER=0

5382

height=14 width=15><b><font face="Helvetica, Arial"><font

5383

color="#FFFFFF"><font size="+1">

5384

<a NAME="comp-opti"></a>Options

5385

</font></font></font></b></td></tr></table>

5386

5387

5388

<p>

5389

Options are processed in command line order. Any option you specify on

5390

the command line remains in effect only for the image that follows. All

5391

options are reset to their default values after each image is read.

5392

<p>

5393

For a more detailed description of each option, see

5394

Options, above.

5395

5396

5397

<tr>

5398

5399

5400

<img SRC="../images/right_triangle_option.png"

5401

ALT=">" BORDER=0 height=14

5402

width=15><b><font face="Helvetica, Arial"

5403

><font color="#FFFFFF"><font size="+1">

5404

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

5405

</font></font></font></b></td></tr></table>

5406

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

5407

5408

<tr>

5409

5410

5411

<img SRC="../images/right_triangle_option.png"

5412

ALT=">" BORDER=0 height=14

5413

width=15><b><font face="Helvetica, Arial"

5414

><font color="#FFFFFF"><font size="+1">

5415

<a href="GraphicsMagick.html#details-background">-background</a> <i><color></i>

5416

</font></font></font></b></td></tr></table>

5417

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

5418

5419

<tr>

5420

5421

5422

<img SRC="../images/right_triangle_option.png"

5423

ALT=">" BORDER=0 height=14

5424

width=15><b><font face="Helvetica, Arial"

5425

><font color="#FFFFFF"><font size="+1">

5426

<a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i>

5427

</font></font></font></b></td></tr></table>

5428

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table>

5429

5430

<tr>

5431

5432

5433

<img SRC="../images/right_triangle_option.png"

5434

ALT=">" BORDER=0 height=14

5435

width=15><b><font face="Helvetica, Arial"

5436

><font color="#FFFFFF"><font size="+1">

5437

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

5438

</font></font></font></b></td></tr></table>

5439

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

5440

5441

<tr>

5442

5443

5444

<img SRC="../images/right_triangle_option.png"

5445

ALT=">" BORDER=0 height=14

5446

width=15><b><font face="Helvetica, Arial"

5447

><font color="#FFFFFF"><font size="+1">

5448

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

5449

</font></font></font></b></td></tr></table>

5450

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

5451

5452

<tr>

5453

5454

5455

<img SRC="../images/right_triangle_option.png"

5456

ALT=">" BORDER=0 height=14

5457

width=15><b><font face="Helvetica, Arial"

5458

><font color="#FFFFFF"><font size="+1">

5459

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

5460

</font></font></font></b></td></tr></table>

5461

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

5462

5463

<tr>

5464

5465

5466

<img SRC="../images/right_triangle_option.png"

5467

ALT=">" BORDER=0 height=14

5468

width=15><b><font face="Helvetica, Arial"

5469

><font color="#FFFFFF"><font size="+1">

5470

<a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i>

5471

</font></font></font></b></td></tr></table>

5472

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

5473

5474

<tr>

5475

5476

5477

<img SRC="../images/right_triangle_option.png"

5478

ALT=">" BORDER=0 height=14

5479

width=15><b><font face="Helvetica, Arial"

5480

><font color="#FFFFFF"><font size="+1">

5481

<a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i>

5482

</font></font></font></b></td></tr></table>

5483

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table>

5484

5485

<tr>

5486

5487

5488

<img SRC="../images/right_triangle_option.png"

5489

ALT=">" BORDER=0 height=14

5490

width=15><b><font face="Helvetica, Arial"

5491

><font color="#FFFFFF"><font size="+1">

5492

<a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i>

5493

</font></font></font></b></td></tr></table>

5494

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>

5495

5496

<tr>

5497

5498

5499

<img SRC="../images/right_triangle_option.png"

5500

ALT=">" BORDER=0 height=14

5501

width=15><b><font face="Helvetica, Arial"

5502

><font color="#FFFFFF"><font size="+1">

5503

-debug <i><events></i>

5504

</font></font></font></b></td></tr></table>

5505

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

5506

5507

<tr>

5508

5509

5510

<img SRC="../images/right_triangle_option.png"

5511

ALT=">" BORDER=0 height=14

5512

width=15><b><font face="Helvetica, Arial"

5513

><font color="#FFFFFF"><font size="+1">

5514

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

5515

</font></font></font></b></td></tr></table>

5516

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

5517

5518

<tr>

5519

5520

5521

<img SRC="../images/right_triangle_option.png"

5522

ALT=">" BORDER=0 height=14

5523

width=15><b><font face="Helvetica, Arial"

5524

><font color="#FFFFFF"><font size="+1">

5525

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

5526

</font></font></font></b></td></tr></table>

5527

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

5528

5529

<tr>

5530

5531

5532

<img SRC="../images/right_triangle_option.png"

5533

ALT=">" BORDER=0 height=14

5534

width=15><b><font face="Helvetica, Arial"

5535

><font color="#FFFFFF"><font size="+1">

5536

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

5537

</font></font></font></b></td></tr></table>

5538

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

5539

5540

<tr>

5541

5542

5543

<img SRC="../images/right_triangle_option.png"

5544

ALT=">" BORDER=0 height=14

5545

width=15><b><font face="Helvetica, Arial"

5546

><font color="#FFFFFF"><font size="+1">

5547

<a href="GraphicsMagick.html#details-displace">-displace</a> <i><horizontal scale>x<vertical scale></i>

5548

</font></font></font></b></td></tr></table>

5549

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shift image pixels as defined by a displacement map</td></tr></table>

5550

5551

<tr>

5552

5553

5554

<img SRC="../images/right_triangle_option.png"

5555

ALT=">" BORDER=0 height=14

5556

width=15><b><font face="Helvetica, Arial"

5557

><font color="#FFFFFF"><font size="+1">

5558

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

5559

</font></font></font></b></td></tr></table>

5560

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

5561

5562

<tr>

5563

5564

5565

<img SRC="../images/right_triangle_option.png"

5566

ALT=">" BORDER=0 height=14

5567

width=15><b><font face="Helvetica, Arial"

5568

><font color="#FFFFFF"><font size="+1">

5569

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

5570

</font></font></font></b></td></tr></table>

5571

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

5572

5573

<tr>

5574

5575

5576

<img SRC="../images/right_triangle_option.png"

5577

ALT=">" BORDER=0 height=14

5578

width=15><b><font face="Helvetica, Arial"

5579

><font color="#FFFFFF"><font size="+1">

5580

<a href="GraphicsMagick.html#details-dissolve">-dissolve</a> <i><percent></i>

5581

</font></font></font></b></td></tr></table>

5582

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>dissolve an image into another by the given percent</td></tr></table>

5583

5584

<tr>

5585

5586

5587

<img SRC="../images/right_triangle_option.png"

5588

ALT=">" BORDER=0 height=14

5589

width=15><b><font face="Helvetica, Arial"

5590

><font color="#FFFFFF"><font size="+1">

5591

<a href="GraphicsMagick.html#details-dither">-dither</a>

5592

</font></font></font></b></td></tr></table>

5593

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

5594

5595

<tr>

5596

5597

5598

<img SRC="../images/right_triangle_option.png"

5599

ALT=">" BORDER=0 height=14

5600

width=15><b><font face="Helvetica, Arial"

5601

><font color="#FFFFFF"><font size="+1">

5602

<a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i>

5603

</font></font></font></b></td></tr></table>

5604

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table>

5605

5606

<tr>

5607

5608

5609

<img SRC="../images/right_triangle_option.png"

5610

ALT=">" BORDER=0 height=14

5611

width=15><b><font face="Helvetica, Arial"

5612

><font color="#FFFFFF"><font size="+1">

5613

<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>

5614

</font></font></font></b></td></tr></table>

5615

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

5616

5617

<tr>

5618

5619

5620

<img SRC="../images/right_triangle_option.png"

5621

ALT=">" BORDER=0 height=14

5622

width=15><b><font face="Helvetica, Arial"

5623

><font color="#FFFFFF"><font size="+1">

5624

<a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i>

5625

</font></font></font></b></td></tr></table>

5626

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>

5627

5628

<tr>

5629

5630

5631

<img SRC="../images/right_triangle_option.png"

5632

ALT=">" BORDER=0 height=14

5633

width=15><b><font face="Helvetica, Arial"

5634

><font color="#FFFFFF"><font size="+1">

5635

5636

</font></font></font></b></td></tr></table>

5637

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

5638

5639

<tr>

5640

5641

5642

<img SRC="../images/right_triangle_option.png"

5643

ALT=">" BORDER=0 height=14

5644

width=15><b><font face="Helvetica, Arial"

5645

><font color="#FFFFFF"><font size="+1">

5646

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

5647

</font></font></font></b></td></tr></table>

5648

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

5649

5650

<tr>

5651

5652

5653

<img SRC="../images/right_triangle_option.png"

5654

ALT=">" BORDER=0 height=14

5655

width=15><b><font face="Helvetica, Arial"

5656

><font color="#FFFFFF"><font size="+1">

5657

<a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i>

5658

</font></font></font></b></td></tr></table>

5659

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table>

5660

5661

<tr>

5662

5663

5664

<img SRC="../images/right_triangle_option.png"

5665

ALT=">" BORDER=0 height=14

5666

width=15><b><font face="Helvetica, Arial"

5667

><font color="#FFFFFF"><font size="+1">

5668

<a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i>

5669

</font></font></font></b></td></tr></table>

5670

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table>

5671

5672

<tr>

5673

5674

5675

<img SRC="../images/right_triangle_option.png"

5676

ALT=">" BORDER=0 height=14

5677

width=15><b><font face="Helvetica, Arial"

5678

><font color="#FFFFFF"><font size="+1">

5679

-help

5680

</font></font></font></b></td></tr></table>

5681

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

5682

5683

<tr>

5684

5685

5686

<img SRC="../images/right_triangle_option.png"

5687

ALT=">" BORDER=0 height=14

5688

width=15><b><font face="Helvetica, Arial"

5689

><font color="#FFFFFF"><font size="+1">

5690

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

5691

</font></font></font></b></td></tr></table>

5692

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

5693

5694

<tr>

5695

5696

5697

<img SRC="../images/right_triangle_option.png"

5698

ALT=">" BORDER=0 height=14

5699

width=15><b><font face="Helvetica, Arial"

5700

><font color="#FFFFFF"><font size="+1">

5701

<a href="GraphicsMagick.html#details-label">-label</a> <i><name></i>

5702

</font></font></font></b></td></tr></table>

5703

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

5704

5705

<tr>

5706

5707

5708

<img SRC="../images/right_triangle_option.png"

5709

ALT=">" BORDER=0 height=14

5710

width=15><b><font face="Helvetica, Arial"

5711

><font color="#FFFFFF"><font size="+1">

5712

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

5713

</font></font></font></b></td></tr></table>

5714

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

5715

5716

<tr>

5717

5718

5719

<img SRC="../images/right_triangle_option.png"

5720

ALT=">" BORDER=0 height=14

5721

width=15><b><font face="Helvetica, Arial"

5722

><font color="#FFFFFF"><font size="+1">

5723

5724

</font></font></font></b></td></tr></table>

5725

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

5726

5727

<tr>

5728

5729

5730

<img SRC="../images/right_triangle_option.png"

5731

ALT=">" BORDER=0 height=14

5732

width=15><b><font face="Helvetica, Arial"

5733

><font color="#FFFFFF"><font size="+1">

5734

<a href="GraphicsMagick.html#details-matte">-matte</a>

5735

</font></font></font></b></td></tr></table>

5736

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

5737

5738

<tr>

5739

5740

5741

<img SRC="../images/right_triangle_option.png"

5742

ALT=">" BORDER=0 height=14

5743

width=15><b><font face="Helvetica, Arial"

5744

><font color="#FFFFFF"><font size="+1">

5745

-monochrome

5746

</font></font></font></b></td></tr></table>

5747

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

5748

5749

<tr>

5750

5751

5752

<img SRC="../images/right_triangle_option.png"

5753

ALT=">" BORDER=0 height=14

5754

width=15><b><font face="Helvetica, Arial"

5755

><font color="#FFFFFF"><font size="+1">

5756

<a href="GraphicsMagick.html#details-negate">-negate</a>

5757

</font></font></font></b></td></tr></table>

5758

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>

5759

5760

<tr>

5761

5762

5763

<img SRC="../images/right_triangle_option.png"

5764

ALT=">" BORDER=0 height=14

5765

width=15><b><font face="Helvetica, Arial"

5766

><font color="#FFFFFF"><font size="+1">

5767

5768

</font></font></font></b></td></tr></table>

5769

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

5770

5771

<tr>

5772

5773

5774

<img SRC="../images/right_triangle_option.png"

5775

ALT=">" BORDER=0 height=14

5776

width=15><b><font face="Helvetica, Arial"

5777

><font color="#FFFFFF"><font size="+1">

5778

<a href="GraphicsMagick.html#details-profile">-profile</a> <i><filename></i>

5779

</font></font></font></b></td></tr></table>

5780

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table>

5781

5782

<tr>

5783

5784

5785

<img SRC="../images/right_triangle_option.png"

5786

ALT=">" BORDER=0 height=14

5787

width=15><b><font face="Helvetica, Arial"

5788

><font color="#FFFFFF"><font size="+1">

5789

<a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i>

5790

</font></font></font></b></td></tr></table>

5791

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

5792

5793

<tr>

5794

5795

5796

<img SRC="../images/right_triangle_option.png"

5797

ALT=">" BORDER=0 height=14

5798

width=15><b><font face="Helvetica, Arial"

5799

><font color="#FFFFFF"><font size="+1">

5800

<a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i>

5801

</font></font></font></b></td></tr></table>

5802

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table>

5803

5804

<tr>

5805

5806

5807

<img SRC="../images/right_triangle_option.png"

5808

ALT=">" BORDER=0 height=14

5809

width=15><b><font face="Helvetica, Arial"

5810

><font color="#FFFFFF"><font size="+1">

5811

<a href="GraphicsMagick.html#details-render">-render</a>

5812

</font></font></font></b></td></tr></table>

5813

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table>

5814

5815

<tr>

5816

5817

5818

<img SRC="../images/right_triangle_option.png"

5819

ALT=">" BORDER=0 height=14

5820

width=15><b><font face="Helvetica, Arial"

5821

><font color="#FFFFFF"><font size="+1">

5822

<a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

5823

</font></font></font></b></td></tr></table>

5824

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table>

5825

5826

<tr>

5827

5828

5829

<img SRC="../images/right_triangle_option.png"

5830

ALT=">" BORDER=0 height=14

5831

width=15><b><font face="Helvetica, Arial"

5832

><font color="#FFFFFF"><font size="+1">

5833

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

5834

</font></font></font></b></td></tr></table>

5835

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

5836

5837

<tr>

5838

5839

5840

<img SRC="../images/right_triangle_option.png"

5841

ALT=">" BORDER=0 height=14

5842

width=15><b><font face="Helvetica, Arial"

5843

><font color="#FFFFFF"><font size="+1">

5844

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

5845

</font></font></font></b></td></tr></table>

5846

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

5847

5848

<tr>

5849

5850

5851

<img SRC="../images/right_triangle_option.png"

5852

ALT=">" BORDER=0 height=14

5853

width=15><b><font face="Helvetica, Arial"

5854

><font color="#FFFFFF"><font size="+1">

5855

<a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i>

5856

</font></font></font></b></td></tr></table>

5857

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table>

5858

5859

<tr>

5860

5861

5862

<img SRC="../images/right_triangle_option.png"

5863

ALT=">" BORDER=0 height=14

5864

width=15><b><font face="Helvetica, Arial"

5865

><font color="#FFFFFF"><font size="+1">

5866

<a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

5867

</font></font></font></b></td></tr></table>

5868

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>

5869

5870

<tr>

5871

5872

5873

<img SRC="../images/right_triangle_option.png"

5874

ALT=">" BORDER=0 height=14

5875

width=15><b><font face="Helvetica, Arial"

5876

><font color="#FFFFFF"><font size="+1">

5877

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

5878

</font></font></font></b></td></tr></table>

5879

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

5880

5881

<tr>

5882

5883

5884

<img SRC="../images/right_triangle_option.png"

5885

ALT=">" BORDER=0 height=14

5886

width=15><b><font face="Helvetica, Arial"

5887

><font color="#FFFFFF"><font size="+1">

5888

<a href="GraphicsMagick.html#details-stegano">-stegano</a> <i><offset></i>

5889

</font></font></font></b></td></tr></table>

5890

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>hide watermark within an image</td></tr></table>

5891

5892

<tr>

5893

5894

5895

<img SRC="../images/right_triangle_option.png"

5896

ALT=">" BORDER=0 height=14

5897

width=15><b><font face="Helvetica, Arial"

5898

><font color="#FFFFFF"><font size="+1">

5899

<a href="GraphicsMagick.html#details-stereo">-stereo</a>

5900

</font></font></font></b></td></tr></table>

5901

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite two images to create a stereo anaglyph</td></tr></table>

5902

5903

<tr>

5904

5905

5906

<img SRC="../images/right_triangle_option.png"

5907

ALT=">" BORDER=0 height=14

5908

width=15><b><font face="Helvetica, Arial"

5909

><font color="#FFFFFF"><font size="+1">

5910

<a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i>

5911

</font></font></font></b></td></tr></table>

5912

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

5913

5914

<tr>

5915

5916

5917

<img SRC="../images/right_triangle_option.png"

5918

ALT=">" BORDER=0 height=14

5919

width=15><b><font face="Helvetica, Arial"

5920

><font color="#FFFFFF"><font size="+1">

5921

5922

</font></font></font></b></td></tr></table>

5923

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

5924

5925

<tr>

5926

5927

5928

<img SRC="../images/right_triangle_option.png"

5929

ALT=">" BORDER=0 height=14

5930

width=15><b><font face="Helvetica, Arial"

5931

><font color="#FFFFFF"><font size="+1">

5932

5933

</font></font></font></b></td></tr></table>

5934

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table>

5935

5936

<tr>

5937

5938

5939

<img SRC="../images/right_triangle_option.png"

5940

ALT=">" BORDER=0 height=14

5941

width=15><b><font face="Helvetica, Arial"

5942

><font color="#FFFFFF"><font size="+1">

5943

<a href="GraphicsMagick.html#details-units">-units</a> <i><type></i>

5944

</font></font></font></b></td></tr></table>

5945

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table>

5946

5947

<tr>

5948

5949

5950

<img SRC="../images/right_triangle_option.png"

5951

ALT=">" BORDER=0 height=14

5952

width=15><b><font face="Helvetica, Arial"

5953

><font color="#FFFFFF"><font size="+1">

5954

<a href="GraphicsMagick.html#details-unsharp">-unsharp</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i>

5955

</font></font></font></b></td></tr></table>

5956

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table>

5957

5958

<tr>

5959

5960

5961

<img SRC="../images/right_triangle_option.png"

5962

ALT=">" BORDER=0 height=14

5963

width=15><b><font face="Helvetica, Arial"

5964

><font color="#FFFFFF"><font size="+1">

5965

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

5966

</font></font></font></b></td></tr></table>

5967

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

5968

5969

<tr>

5970

5971

5972

<img SRC="../images/right_triangle_option.png"

5973

ALT=">" BORDER=0 height=14

5974

width=15><b><font face="Helvetica, Arial"

5975

><font color="#FFFFFF"><font size="+1">

5976

<a href="GraphicsMagick.html#details-version">-version</a>

5977

</font></font></font></b></td></tr></table>

5978

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

5979

5980

<tr>

5981

5982

5983

<img SRC="../images/right_triangle_option.png"

5984

ALT=">" BORDER=0 height=14

5985

width=15><b><font face="Helvetica, Arial"

5986

><font color="#FFFFFF"><font size="+1">

5987

-watermark <i><brightness>x<saturation></i>

5988

</font></font></font></b></td></tr></table>

5989

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>percent brightness and saturation of a watermark</td></tr></table>

5990

5991

<tr>

5992

5993

5994

<img SRC="../images/right_triangle_option.png"

5995

ALT=">" BORDER=0 height=14

5996

width=15><b><font face="Helvetica, Arial"

5997

><font color="#FFFFFF"><font size="+1">

5998

<a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i>

5999

</font></font></font></b></td></tr></table>

6000

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table>

6001

6002

<tr>

6003

6004

6005

<img SRC="../images/right_triangle_option.png"

6006

ALT=">" BORDER=0 height=14

6007

width=15><b><font face="Helvetica, Arial"

6008

><font color="#FFFFFF"><font size="+1">

6009

<a href="GraphicsMagick.html#details-write">-write</a> <i><filename></i>

6010

</font></font></font></b></td></tr></table>

6011

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write an image sequence [<em>convert, composite</em>]</td></tr></table>

6012

<p>

6013

For a more detailed description of each option, see

6014

Options, above.

6015

6016

</td></tr></table>

6017

6018

6019

<tr>

6020

<td ALIGN=LEFT bgcolor="#52799E"><img

6021

SRC="../images/right_triangle.png" ALT=">" BORDER=0

6022

height=14 width=15><b><font face="Helvetica, Arial"><font

6023

color="#FFFFFF"><font size="+1">

6024

<a NAME="conjure"></a>gm conjure

6025

</font></font></font></b></td></tr></table>

6026

6027

6028

<p>

6029

The Magick scripting language (MSL) will primarily benefit those that

6030

want to accomplish custom image processing tasks but do not wish to

6031

program, or those that do not have access to a Perl interpreter or a

6032

compiler. The interpreter is called conjure and here is an example

6033

script:

6034

<pre>

6035

<?xml version="1.0" encoding="UTF-8"?>

6036

6037

6038

6039

6040

6041

<print output=

6042

"Image sized from %[base-width]x%[base-height]

6043

to %[width]x%[height].\n" />

6044

6045

</image>

6046

</pre>

6047

<p>

6048

invoked with

6049

<pre>

6050

gm conjure -dimensions 400x400 incantation.msl

6051

</pre>

6052

<p>

6053

All operations will closely follow the key/value pairs defined in

6054

PerlMagick, unless otherwise noted.

6055

<p>

6056

<strong>Conjure</strong> is in the early stages of development as of

6057

April 2002.

6058

<p>

6059

This early announcement is to allow GraphicsMagick users to contribute

6060

ideas early in the process so when the scripting language is released it

6061

will be useful/stable from the get-go! If you want to contribute

6062

suggestions about the Magick scripting language (MSL), post them to the

6063

GraphicsMagick tools list at graphicsmagick-tools @ lists.sourceforge.net.

6064

</td></tr></table>

6065

<p>

6066

<i><a href="#top">Back to Contents</a></i>

6067

 </p>

6068

6069

<tr>

6070

<td ALIGN=LEFT bgcolor="#52799E"><img

6071

SRC="../images/right_triangle.png" ALT=">" BORDER=0

6072

height=14 width=15><b><font face="Helvetica, Arial"><font

6073

color="#FFFFFF"><font size="+1">

6074

<a NAME="conj-opti"></a>Options

6075

</font></font></font></b></td></tr></table>

6076

6077

6078

<p>

6079

Options are processed in command line order. Any option you specify on

6080

the command line remains in effect until it is explicitly changed by specifying

6081

the option again with a different effect, or if it is changed by a statement

6082

in the scripting language.

6083

<p>

6084

You can define your own keyword/value pairs on the command line.

6085

The script can then use this information when setting values by including

6086

%[keyword] in the string. For example, if you included

6087

"-dimensions 400x400" on the command line, as illustrated above,

6088

then any string

6089

containing "%[dimensions]" would have 400x400 substituted.

6090

The "%[string]" can be used either an entire string, such as

6091

geometry="%[dimensions]" or as a part of a string such as

6092

filename="%[basename].png".

6093

<p>

6094

The keyword can be any string except for the following reserved

6095

strings (in any upper, lower, or mixed case variant): <strong>debug</strong>,

6096

<strong>help</strong>, and <strong>verbose</strong>, whose usage is described below.

6097

<p>

6098

The value can be any string. If

6099

either the keyword or the value contains white space or any

6100

symbols that have special meanings to your shell such as "#",

6101

"|",

6102

or

6103

"%", enclose the string in quotation marks or use "\" to escape the white

6104

space and special symbols.

6105

<p>

6106

Keywords and values are case dependent. "Key",

6107

"key",

6108

and "KEY" would

6109

be three different keywords.

6110

<p>

6111

For a more detailed description of each option, see

6112

Options, above.

6113

6114

6115

<tr>

6116

6117

6118

<img SRC="../images/right_triangle_option.png"

6119

ALT=">" BORDER=0 height=14

6120

width=15><b><font face="Helvetica, Arial"

6121

><font color="#FFFFFF"><font size="+1">

6122

-debug <i><events></i>

6123

</font></font></font></b></td></tr></table>

6124

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

6125

6126

<tr>

6127

6128

6129

<img SRC="../images/right_triangle_option.png"

6130

ALT=">" BORDER=0 height=14

6131

width=15><b><font face="Helvetica, Arial"

6132

><font color="#FFFFFF"><font size="+1">

6133

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

6134

</font></font></font></b></td></tr></table>

6135

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

6136

6137

<tr>

6138

6139

6140

<img SRC="../images/right_triangle_option.png"

6141

ALT=">" BORDER=0 height=14

6142

width=15><b><font face="Helvetica, Arial"

6143

><font color="#FFFFFF"><font size="+1">

6144

-help

6145

</font></font></font></b></td></tr></table>

6146

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

6147

6148

<tr>

6149

6150

6151

<img SRC="../images/right_triangle_option.png"

6152

ALT=">" BORDER=0 height=14

6153

width=15><b><font face="Helvetica, Arial"

6154

><font color="#FFFFFF"><font size="+1">

6155

6156

</font></font></font></b></td></tr></table>

6157

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

6158

6159

<tr>

6160

6161

6162

<img SRC="../images/right_triangle_option.png"

6163

ALT=">" BORDER=0 height=14

6164

width=15><b><font face="Helvetica, Arial"

6165

><font color="#FFFFFF"><font size="+1">

6166

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

6167

</font></font></font></b></td></tr></table>

6168

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

6169

6170

<tr>

6171

6172

6173

<img SRC="../images/right_triangle_option.png"

6174

ALT=">" BORDER=0 height=14

6175

width=15><b><font face="Helvetica, Arial"

6176

><font color="#FFFFFF"><font size="+1">

6177

<a href="GraphicsMagick.html#details-version">-version</a>

6178

</font></font></font></b></td></tr></table>

6179

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

6180

</td></tr></table>

6181

<p>

6182

<i><a href="#top">Back to Contents</a></i>

6183

 </p>

6184

6185

<tr>

6186

<td ALIGN=LEFT bgcolor="#52799E"><img

6187

SRC="../images/right_triangle.png" ALT=">" BORDER=0

6188

height=14 width=15><b><font face="Helvetica, Arial"><font

6189

color="#FFFFFF"><font size="+1">

6190

<a NAME="conj-msl"></a>Magick Scripting Language

6191

</font></font></font></b></td></tr></table>

6192

6193

6194

<p>

6195

The Magick Scripting Language (MSL) presently defines the following

6196

elements and their attributes:

6197

<dl>

6198

6199

<dd>

6200

Define a new image object. <strong></image></strong> destroys it. Because of

6201

this, if you wish to reference multiple "subimages" (aka pages or

6202

layers), you can embed one <strong>image</strong> element inside of another. For

6203

example:

6204

</dd>

6205

<dd>

6206

<pre>

6207

<image>

6208

6209

6210

6211

6212

6213

</image>

6214

</pre>

6215

</dd>

6216

<dd>

6217

<pre>

6218

6219

</pre>

6220

</dd>

6221

6222

<dd>

6223

Define a new group of image objects. By default, images are only

6224

valid for the life of their <strong><image></strong>element.

6225

</dd>

6226

<dd>

6227

<pre>

6228

<image> -- creates the image

6229

..... -- do stuff with it

6230

</image> -- dispose of the image

6231

</pre>

6232

</dd>

6233

<dd>

6234

However, in a group, all images in that group will stay around for the

6235

life of the group:

6236

</dd>

6237

<dd>

6238

<pre>

6239

<group> -- start a group

6240

<image> -- create an image

6241

.... -- do stuff

6242

</image> -- NOOP

6243

<image> -- create another image

6244

.... -- do more stuff

6245

</image> -- NOOP

6246

<write filename="image.mng" /> -- output

6247

</group> -- dispose of both images

6248

</pre>

6249

</dd>

6250

6251

<dd>

6252

Read a new image from a disk file.

6253

</dd>

6254

<dd>

6255

<pre>

6256

6257

</pre>

6258

</dd>

6259

<dd>

6260

To read two images use

6261

</dd>

6262

<dd>

6263

<pre>

6264

6265

6266

</pre>

6267

</dd>

6268

6269

<dd>Write the image(s) to disk, either as

6270

a single multiple-image file or multiple ones if necessary.

6271

</dd>

6272

<dd>

6273

<pre>

6274

6275

</pre>

6276

6277

<dd>Get any attribute recognized by

6278

PerlMagick's GetAttribute() and stores it as an image attribute for later

6279

use. Currently only <em>width</em> and <em>height</em> are supported.</dd>

6280

<dd>

6281

<pre>

6282

6283

6284

</pre>

6285

</dd>

6286

6287

<dd>background, bordercolor, clip-mask, colorspace, density,

6288

magick, mattecolor, opacity. Set an attribute recognized by

6289

PerlMagick's GetAttribute().</dd>

6290

6291

<dd>fill, geometry, height, width</dd>

6292

6293

<dd>radius, sigma</dd>

6294

6295

<dd>radius, sigma</dd>

6296

6297

<dd>geometry, height, width, x, y</dd>

6298

6299

<dd>geometry, height, width, x, y</dd>

6300

6301

6302

<dd>radius, sigma</dd>

6303

6304

6305

6306

6307

6308

<dd>fill, geometry, height, width, x, y, inner, outer</dd>

6309

6310

<dd>height, width</dd>

6311

6312

<dd>background, color, id, size</dd>

6313

6314

6315

6316

6317

<dd>output</dd>

6318

6319

6320

<dd>blur, filter, geometry, height, width</dd>

6321

6322

<dd>geometry, x, y</dd>

6323

6324

<dd>degrees</dd>

6325

6326

<dd>geometry, height, width</dd>

6327

6328

<dd>geometry, height, width</dd>

6329

6330

<dd>radius, sigma</dd>

6331

6332

<dd>geometry, height, width</dd>

6333

6334

6335

6336

<dd>threshold</dd>

6337

6338

<dd>radius</dd>

6339

6340

<dd>image</dd>

6341

6342

<dd>image</dd>

6343

6344

<dd>degrees</dd>

6345

6346

<dd>image</dd>

6347

6348

<dd>threshold</dd>

6349

6350

<dd>color</dd>

6351

6352

</dl>

6353

</td></tr></table>

6354

6355

6356

<tr>

6357

<td ALIGN=LEFT bgcolor="#52799E"><img

6358

SRC="../images/right_triangle.png" ALT=">" BORDER=0

6359

height=14 width=15><b><font face="Helvetica, Arial"><font

6360

color="#FFFFFF"><font size="+1">

6361

<a convert="top"></a>gm convert

6362

</font></font></font></b></td></tr></table>

6363

6364

6365

<p>

6366

<strong>Convert</strong> converts an input file using one image format to an output

6367

file with a differing image format. In addition, various types of image

6368

processing can be performed on the converted image during the conversion

6369

process. <strong>Convert</strong> recognizes the image formats listed in

6370

<em>GraphicsMagick(1)</em>.

6371

6372

</td></tr></table>

6373

<p>

6374

<i><a href="#top">Back to Contents</a></i>

6375

 </p>

6376

6377

<tr>

6378

<td ALIGN=LEFT bgcolor="#52799E"><img

6379

SRC="../images/right_triangle.png" ALT=">" BORDER=0

6380

height=14 width=15><b><font face="Helvetica, Arial"><font

6381

color="#FFFFFF"><font size="+1">

6382

<a NAME="conv-exam"></a>Examples

6383

</font></font></font></b></td></tr></table>

6384

6385

6386

<p>

6387

To make a thumbnail of a JPEG image, use:

6388

<pre>

6389

gm convert -size 120x120 cockatoo.jpg -resize 120x120

6390

+profile "*" thumbnail.jpg

6391

</pre>

6392

6393

In this example, <tt>'-size 120x120'</tt> gives a hint to the JPEG decoder

6394

that the image is going to be downscaled to 120x120, allowing it to run

6395

faster by avoiding returning full-resolution images to GraphicsMagick for

6396

the subsequent resizing operation. The

6397

<tt>'-resize 120x120'</tt> specifies the desired dimensions of the

6398

output image. It will be scaled so its largest dimension is 120 pixels. The

6399

<tt>'+profile "*"'</tt> removes any ICM, EXIF, IPTC, or other profiles

6400

that might be present in the input and aren't needed in the thumbnail.</font></td></tr></table>

6401

<p>

6402

To convert a <em>MIFF</em> image of a cockatoo to a SUN raster image, use:

6403

<pre>

6404

gm convert cockatoo.miff sun:cockatoo.ras

6405

</pre>

6406

<p>

6407

To convert a multi-page <em>PostScript</em> document to individual FAX pages,

6408

use:

6409

<pre>

6410

gm convert -monochrome document.ps fax:page

6411

</pre>

6412

<p>

6413

To convert a TIFF image to a <em>PostScript</em> A4 page with the image in

6414

the lower left-hand corner, use:

6415

<pre>

6416

gm convert -page A4+0+0 image.tiff document.ps

6417

</pre>

6418

<p>

6419

To convert a raw Gray image with a 128 byte header to a portable graymap,

6420

use:

6421

<pre>

6422

gm convert -depth 8 -size 768x512+128 gray:raw

6423

image.pgm

6424

</pre>

6425

<p>

6426

In this example, "raw" is the input file. Its format is "gray" and it

6427

has the dimensions and number of header bytes specified by the -size

6428

option and the sample depth specified by the

6429

-depth option. The output file is "image.pgm". The suffix ".pgm"

6430

specifies its format.

6431

<p>

6432

To convert a Photo CD image to a TIFF image, use:

6433

<pre>

6434

gm convert -size 1536x1024 img0009.pcd image.tiff

6435

gm convert img0009.pcd[4] image.tiff

6436

</pre>

6437

<p>

6438

To create a visual image directory of all your JPEG images, use:

6439

<pre>

6440

gm convert 'vid:*.jpg' directory.miff

6441

</pre>

6442

<p>

6443

To annotate an image with blue text using font 12x24 at position (100,100),

6444

use:

6445

<pre>

6446

gm convert -font helvetica -fill blue

6447

-draw "text 100,100 Cockatoo"

6448

bird.jpg bird.miff

6449

</pre>

6450

<p>

6451

To tile a 640x480 image with a JPEG texture with bumps use:

6452

<pre>

6453

gm convert -size 640x480 tile:bumps.jpg tiled.png

6454

</pre>

6455

<p>

6456

To surround an icon with an ornamental border to use with Mosaic(1), use:

6457

<pre>

6458

gm convert -mattecolor "#697B8F" -frame 6x6 bird.jpg

6459

icon.png

6460

</pre>

6461

<p>

6462

To create a MNG animation from a DNA molecule sequence, use:

6463

<pre>

6464

gm convert -delay 20 dna.* dna.mng

6465

</pre>

6466

</td></tr></table>

6467

<p>

6468

<i><a href="#top">Back to Contents</a></i>

6469

 </p>

6470

6471

<tr>

6472

<td ALIGN=LEFT bgcolor="#52799E"><img

6473

SRC="../images/right_triangle.png" ALT=">" BORDER=0

6474

height=14 width=15><b><font face="Helvetica, Arial"><font

6475

color="#FFFFFF"><font size="+1">

6476

<a NAME="conv-opti"></a>Options

6477

</font></font></font></b></td></tr></table>

6478

6479

6480

<p>

6481

Options are processed in command line order. Any option you specify on

6482

the command line remains in effect for the set of images that follows,

6483

until the set is terminated by the appearance of any option or <strong>-noop</strong>.

6484

Some options only affect the decoding of images and others only the encoding.

6485

The latter can appear after the final group of input images.

6486

<p>

6487

For a more detailed description of each option, see

6488

Options, above.

6489

6490

6491

<tr>

6492

6493

6494

<img SRC="../images/right_triangle_option.png"

6495

ALT=">" BORDER=0 height=14

6496

width=15><b><font face="Helvetica, Arial"

6497

><font color="#FFFFFF"><font size="+1">

6498

<a href="GraphicsMagick.html#details-adjoin">-adjoin</a>

6499

</font></font></font></b></td></tr></table>

6500

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>join images into a single multi-image file</td></tr></table>

6501

6502

<tr>

6503

6504

6505

<img SRC="../images/right_triangle_option.png"

6506

ALT=">" BORDER=0 height=14

6507

width=15><b><font face="Helvetica, Arial"

6508

><font color="#FFFFFF"><font size="+1">

6509

<a href="GraphicsMagick.html#details-affine">-affine</a> <i><matrix></i>

6510

</font></font></font></b></td></tr></table>

6511

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table>

6512

6513

<tr>

6514

6515

6516

<img SRC="../images/right_triangle_option.png"

6517

ALT=">" BORDER=0 height=14

6518

width=15><b><font face="Helvetica, Arial"

6519

><font color="#FFFFFF"><font size="+1">

6520

<a href="GraphicsMagick.html#details-antialias">-antialias</a>

6521

</font></font></font></b></td></tr></table>

6522

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table>

6523

6524

<tr>

6525

6526

6527

<img SRC="../images/right_triangle_option.png"

6528

ALT=">" BORDER=0 height=14

6529

width=15><b><font face="Helvetica, Arial"

6530

><font color="#FFFFFF"><font size="+1">

6531

<a href="GraphicsMagick.html#details-append">-append</a>

6532

</font></font></font></b></td></tr></table>

6533

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>append a set of images</td></tr></table>

6534

6535

<tr>

6536

6537

6538

<img SRC="../images/right_triangle_option.png"

6539

ALT=">" BORDER=0 height=14

6540

width=15><b><font face="Helvetica, Arial"

6541

><font color="#FFFFFF"><font size="+1">

6542

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

6543

</font></font></font></b></td></tr></table>

6544

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

6545

6546

<tr>

6547

6548

6549

<img SRC="../images/right_triangle_option.png"

6550

ALT=">" BORDER=0 height=14

6551

width=15><b><font face="Helvetica, Arial"

6552

><font color="#FFFFFF"><font size="+1">

6553

<a href="GraphicsMagick.html#details-average">-average</a>

6554

</font></font></font></b></td></tr></table>

6555

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>average a set of images</td></tr></table>

6556

6557

<tr>

6558

6559

6560

<img SRC="../images/right_triangle_option.png"

6561

ALT=">" BORDER=0 height=14

6562

width=15><b><font face="Helvetica, Arial"

6563

><font color="#FFFFFF"><font size="+1">

6564

<a href="GraphicsMagick.html#details-background">-background</a> <i><color></i>

6565

</font></font></font></b></td></tr></table>

6566

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

6567

6568

<tr>

6569

6570

6571

<img SRC="../images/right_triangle_option.png"

6572

ALT=">" BORDER=0 height=14

6573

width=15><b><font face="Helvetica, Arial"

6574

><font color="#FFFFFF"><font size="+1">

6575

<a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i>

6576

</font></font></font></b></td></tr></table>

6577

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table>

6578

6579

<tr>

6580

6581

6582

<img SRC="../images/right_triangle_option.png"

6583

ALT=">" BORDER=0 height=14

6584

width=15><b><font face="Helvetica, Arial"

6585

><font color="#FFFFFF"><font size="+1">

6586

6587

</font></font></font></b></td></tr></table>

6588

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

6589

6590

<tr>

6591

6592

6593

<img SRC="../images/right_triangle_option.png"

6594

ALT=">" BORDER=0 height=14

6595

width=15><b><font face="Helvetica, Arial"

6596

><font color="#FFFFFF"><font size="+1">

6597

<a href="GraphicsMagick.html#details-border">-border</a> <i><width>x<height></i>

6598

</font></font></font></b></td></tr></table>

6599

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table>

6600

6601

<tr>

6602

6603

6604

<img SRC="../images/right_triangle_option.png"

6605

ALT=">" BORDER=0 height=14

6606

width=15><b><font face="Helvetica, Arial"

6607

><font color="#FFFFFF"><font size="+1">

6608

<a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i>

6609

</font></font></font></b></td></tr></table>

6610

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

6611

6612

<tr>

6613

6614

6615

<img SRC="../images/right_triangle_option.png"

6616

ALT=">" BORDER=0 height=14

6617

width=15><b><font face="Helvetica, Arial"

6618

><font color="#FFFFFF"><font size="+1">

6619

6620

</font></font></font></b></td></tr></table>

6621

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the color of the annotation bounding box</td></tr></table>

6622

6623

<tr>

6624

6625

6626

<img SRC="../images/right_triangle_option.png"

6627

ALT=">" BORDER=0 height=14

6628

width=15><b><font face="Helvetica, Arial"

6629

><font color="#FFFFFF"><font size="+1">

6630

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

6631

</font></font></font></b></td></tr></table>

6632

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

6633

6634

<tr>

6635

6636

6637

<img SRC="../images/right_triangle_option.png"

6638

ALT=">" BORDER=0 height=14

6639

width=15><b><font face="Helvetica, Arial"

6640

><font color="#FFFFFF"><font size="+1">

6641

<a href="GraphicsMagick.html#details-channel">-channel</a> <i><type></i>

6642

</font></font></font></b></td></tr></table>

6643

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table>

6644

6645

<tr>

6646

6647

6648

<img SRC="../images/right_triangle_option.png"

6649

ALT=">" BORDER=0 height=14

6650

width=15><b><font face="Helvetica, Arial"

6651

><font color="#FFFFFF"><font size="+1">

6652

-charcoal <i><factor></i>

6653

</font></font></font></b></td></tr></table>

6654

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table>

6655

6656

<tr>

6657

6658

6659

<img SRC="../images/right_triangle_option.png"

6660

ALT=">" BORDER=0 height=14

6661

width=15><b><font face="Helvetica, Arial"

6662

><font color="#FFFFFF"><font size="+1">

6663

6664

</font></font></font></b></td></tr></table>

6665

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table>

6666

6667

<tr>

6668

6669

6670

<img SRC="../images/right_triangle_option.png"

6671

ALT=">" BORDER=0 height=14

6672

width=15><b><font face="Helvetica, Arial"

6673

><font color="#FFFFFF"><font size="+1">

6674

6675

</font></font></font></b></td></tr></table>

6676

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply the clipping path, if one is present</td></tr></table>

6677

6678

<tr>

6679

6680

6681

<img SRC="../images/right_triangle_option.png"

6682

ALT=">" BORDER=0 height=14

6683

width=15><b><font face="Helvetica, Arial"

6684

><font color="#FFFFFF"><font size="+1">

6685

<a href="GraphicsMagick.html#details-coalesce">-coalesce</a>

6686

</font></font></font></b></td></tr></table>

6687

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>merge a sequence of images</td></tr></table>

6688

6689

<tr>

6690

6691

6692

<img SRC="../images/right_triangle_option.png"

6693

ALT=">" BORDER=0 height=14

6694

width=15><b><font face="Helvetica, Arial"

6695

><font color="#FFFFFF"><font size="+1">

6696

<a href="GraphicsMagick.html#details-colorize">-colorize</a> <i><value></i>

6697

</font></font></font></b></td></tr></table>

6698

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colorize the image with the pen color</td></tr></table>

6699

6700

<tr>

6701

6702

6703

<img SRC="../images/right_triangle_option.png"

6704

ALT=">" BORDER=0 height=14

6705

width=15><b><font face="Helvetica, Arial"

6706

><font color="#FFFFFF"><font size="+1">

6707

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

6708

</font></font></font></b></td></tr></table>

6709

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

6710

6711

<tr>

6712

6713

6714

<img SRC="../images/right_triangle_option.png"

6715

ALT=">" BORDER=0 height=14

6716

width=15><b><font face="Helvetica, Arial"

6717

><font color="#FFFFFF"><font size="+1">

6718

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

6719

</font></font></font></b></td></tr></table>

6720

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

6721

6722

<tr>

6723

6724

6725

<img SRC="../images/right_triangle_option.png"

6726

ALT=">" BORDER=0 height=14

6727

width=15><b><font face="Helvetica, Arial"

6728

><font color="#FFFFFF"><font size="+1">

6729

<a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i>

6730

</font></font></font></b></td></tr></table>

6731

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

6732

6733

<tr>

6734

6735

6736

<img SRC="../images/right_triangle_option.png"

6737

ALT=">" BORDER=0 height=14

6738

width=15><b><font face="Helvetica, Arial"

6739

><font color="#FFFFFF"><font size="+1">

6740

<a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i>

6741

</font></font></font></b></td></tr></table>

6742

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table>

6743

6744

<tr>

6745

6746

6747

<img SRC="../images/right_triangle_option.png"

6748

ALT=">" BORDER=0 height=14

6749

width=15><b><font face="Helvetica, Arial"

6750

><font color="#FFFFFF"><font size="+1">

6751

<a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i>

6752

</font></font></font></b></td></tr></table>

6753

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>

6754

6755

<tr>

6756

6757

6758

<img SRC="../images/right_triangle_option.png"

6759

ALT=">" BORDER=0 height=14

6760

width=15><b><font face="Helvetica, Arial"

6761

><font color="#FFFFFF"><font size="+1">

6762

<a href="GraphicsMagick.html#details-contrast">-contrast</a>

6763

</font></font></font></b></td></tr></table>

6764

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table>

6765

6766

<tr>

6767

6768

6769

<img SRC="../images/right_triangle_option.png"

6770

ALT=">" BORDER=0 height=14

6771

width=15><b><font face="Helvetica, Arial"

6772

><font color="#FFFFFF"><font size="+1">

6773

<a href="GraphicsMagick.html#details-convolve">-convolve</a> <i><kernel></i>

6774

</font></font></font></b></td></tr></table>

6775

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>convolve image with the specified convolution kernel</td></tr></table>

6776

6777

<tr>

6778

6779

6780

<img SRC="../images/right_triangle_option.png"

6781

ALT=">" BORDER=0 height=14

6782

width=15><b><font face="Helvetica, Arial"

6783

><font color="#FFFFFF"><font size="+1">

6784

6785

</font></font></font></b></td></tr></table>

6786

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

6787

6788

<tr>

6789

6790

6791

<img SRC="../images/right_triangle_option.png"

6792

ALT=">" BORDER=0 height=14

6793

width=15><b><font face="Helvetica, Arial"

6794

><font color="#FFFFFF"><font size="+1">

6795

<a href="GraphicsMagick.html#details-cycle">-cycle</a> <i><amount></i>

6796

</font></font></font></b></td></tr></table>

6797

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table>

6798

6799

<tr>

6800

6801

6802

<img SRC="../images/right_triangle_option.png"

6803

ALT=">" BORDER=0 height=14

6804

width=15><b><font face="Helvetica, Arial"

6805

><font color="#FFFFFF"><font size="+1">

6806

-debug <i><events></i>

6807

</font></font></font></b></td></tr></table>

6808

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

6809

6810

<tr>

6811

6812

6813

<img SRC="../images/right_triangle_option.png"

6814

ALT=">" BORDER=0 height=14

6815

width=15><b><font face="Helvetica, Arial"

6816

><font color="#FFFFFF"><font size="+1">

6817

<a href="GraphicsMagick.html#details-deconstruct">-deconstruct</a>

6818

</font></font></font></b></td></tr></table>

6819

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>break down an image sequence into constituent parts</td></tr></table>

6820

6821

<tr>

6822

6823

6824

<img SRC="../images/right_triangle_option.png"

6825

ALT=">" BORDER=0 height=14

6826

width=15><b><font face="Helvetica, Arial"

6827

><font color="#FFFFFF"><font size="+1">

6828

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

6829

</font></font></font></b></td></tr></table>

6830

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

6831

6832

<tr>

6833

6834

6835

<img SRC="../images/right_triangle_option.png"

6836

ALT=">" BORDER=0 height=14

6837

width=15><b><font face="Helvetica, Arial"

6838

><font color="#FFFFFF"><font size="+1">

6839

<a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i>

6840

</font></font></font></b></td></tr></table>

6841

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>

6842

6843

<tr>

6844

6845

6846

<img SRC="../images/right_triangle_option.png"

6847

ALT=">" BORDER=0 height=14

6848

width=15><b><font face="Helvetica, Arial"

6849

><font color="#FFFFFF"><font size="+1">

6850

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

6851

</font></font></font></b></td></tr></table>

6852

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

6853

6854

<tr>

6855

6856

6857

<img SRC="../images/right_triangle_option.png"

6858

ALT=">" BORDER=0 height=14

6859

width=15><b><font face="Helvetica, Arial"

6860

><font color="#FFFFFF"><font size="+1">

6861

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

6862

</font></font></font></b></td></tr></table>

6863

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

6864

6865

<tr>

6866

6867

6868

<img SRC="../images/right_triangle_option.png"

6869

ALT=">" BORDER=0 height=14

6870

width=15><b><font face="Helvetica, Arial"

6871

><font color="#FFFFFF"><font size="+1">

6872

-despeckle

6873

</font></font></font></b></td></tr></table>

6874

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table>

6875

6876

<tr>

6877

6878

6879

<img SRC="../images/right_triangle_option.png"

6880

ALT=">" BORDER=0 height=14

6881

width=15><b><font face="Helvetica, Arial"

6882

><font color="#FFFFFF"><font size="+1">

6883

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

6884

</font></font></font></b></td></tr></table>

6885

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

6886

6887

<tr>

6888

6889

6890

<img SRC="../images/right_triangle_option.png"

6891

ALT=">" BORDER=0 height=14

6892

width=15><b><font face="Helvetica, Arial"

6893

><font color="#FFFFFF"><font size="+1">

6894

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

6895

</font></font></font></b></td></tr></table>

6896

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

6897

6898

<tr>

6899

6900

6901

<img SRC="../images/right_triangle_option.png"

6902

ALT=">" BORDER=0 height=14

6903

width=15><b><font face="Helvetica, Arial"

6904

><font color="#FFFFFF"><font size="+1">

6905

<a href="GraphicsMagick.html#details-dither">-dither</a>

6906

</font></font></font></b></td></tr></table>

6907

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

6908

6909

<tr>

6910

6911

6912

<img SRC="../images/right_triangle_option.png"

6913

ALT=">" BORDER=0 height=14

6914

width=15><b><font face="Helvetica, Arial"

6915

><font color="#FFFFFF"><font size="+1">

6916

6917

</font></font></font></b></td></tr></table>

6918

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table>

6919

6920

<tr>

6921

6922

6923

<img SRC="../images/right_triangle_option.png"

6924

ALT=">" BORDER=0 height=14

6925

width=15><b><font face="Helvetica, Arial"

6926

><font color="#FFFFFF"><font size="+1">

6927

-edge <i><radius></i>

6928

</font></font></font></b></td></tr></table>

6929

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table>

6930

6931

<tr>

6932

6933

6934

<img SRC="../images/right_triangle_option.png"

6935

ALT=">" BORDER=0 height=14

6936

width=15><b><font face="Helvetica, Arial"

6937

><font color="#FFFFFF"><font size="+1">

6938

-emboss <i><radius></i>

6939

</font></font></font></b></td></tr></table>

6940

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table>

6941

6942

<tr>

6943

6944

6945

<img SRC="../images/right_triangle_option.png"

6946

ALT=">" BORDER=0 height=14

6947

width=15><b><font face="Helvetica, Arial"

6948

><font color="#FFFFFF"><font size="+1">

6949

<a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i>

6950

</font></font></font></b></td></tr></table>

6951

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table>

6952

6953

<tr>

6954

6955

6956

<img SRC="../images/right_triangle_option.png"

6957

ALT=">" BORDER=0 height=14

6958

width=15><b><font face="Helvetica, Arial"

6959

><font color="#FFFFFF"><font size="+1">

6960

<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>

6961

</font></font></font></b></td></tr></table>

6962

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

6963

6964

<tr>

6965

6966

6967

<img SRC="../images/right_triangle_option.png"

6968

ALT=">" BORDER=0 height=14

6969

width=15><b><font face="Helvetica, Arial"

6970

><font color="#FFFFFF"><font size="+1">

6971

-enhance

6972

</font></font></font></b></td></tr></table>

6973

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table>

6974

6975

<tr>

6976

6977

6978

<img SRC="../images/right_triangle_option.png"

6979

ALT=">" BORDER=0 height=14

6980

width=15><b><font face="Helvetica, Arial"

6981

><font color="#FFFFFF"><font size="+1">

6982

-equalize

6983

</font></font></font></b></td></tr></table>

6984

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform histogram equalization to the image</td></tr></table>

6985

6986

<tr>

6987

6988

6989

<img SRC="../images/right_triangle_option.png"

6990

ALT=">" BORDER=0 height=14

6991

width=15><b><font face="Helvetica, Arial"

6992

><font color="#FFFFFF"><font size="+1">

6993

6994

</font></font></font></b></td></tr></table>

6995

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table>

6996

6997

<tr>

6998

6999

7000

<img SRC="../images/right_triangle_option.png"

7001

ALT=">" BORDER=0 height=14

7002

width=15><b><font face="Helvetica, Arial"

7003

><font color="#FFFFFF"><font size="+1">

7004

<a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i>

7005

</font></font></font></b></td></tr></table>

7006

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>

7007

7008

<tr>

7009

7010

7011

<img SRC="../images/right_triangle_option.png"

7012

ALT=">" BORDER=0 height=14

7013

width=15><b><font face="Helvetica, Arial"

7014

><font color="#FFFFFF"><font size="+1">

7015

<a href="GraphicsMagick.html#details-flatten">-flatten</a>

7016

</font></font></font></b></td></tr></table>

7017

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>flatten a sequence of images</td></tr></table>

7018

7019

<tr>

7020

7021

7022

<img SRC="../images/right_triangle_option.png"

7023

ALT=">" BORDER=0 height=14

7024

width=15><b><font face="Helvetica, Arial"

7025

><font color="#FFFFFF"><font size="+1">

7026

7027

</font></font></font></b></td></tr></table>

7028

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

7029

7030

<tr>

7031

7032

7033

<img SRC="../images/right_triangle_option.png"

7034

ALT=">" BORDER=0 height=14

7035

width=15><b><font face="Helvetica, Arial"

7036

><font color="#FFFFFF"><font size="+1">

7037

7038

</font></font></font></b></td></tr></table>

7039

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

7040

7041

<tr>

7042

7043

7044

<img SRC="../images/right_triangle_option.png"

7045

ALT=">" BORDER=0 height=14

7046

width=15><b><font face="Helvetica, Arial"

7047

><font color="#FFFFFF"><font size="+1">

7048

7049

</font></font></font></b></td></tr></table>

7050

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

7051

7052

<tr>

7053

7054

7055

<img SRC="../images/right_triangle_option.png"

7056

ALT=">" BORDER=0 height=14

7057

width=15><b><font face="Helvetica, Arial"

7058

><font color="#FFFFFF"><font size="+1">

7059

<a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i>

7060

</font></font></font></b></td></tr></table>

7061

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table>

7062

7063

<tr>

7064

7065

7066

<img SRC="../images/right_triangle_option.png"

7067

ALT=">" BORDER=0 height=14

7068

width=15><b><font face="Helvetica, Arial"

7069

><font color="#FFFFFF"><font size="+1">

7070

7071

</font></font></font></b></td></tr></table>

7072

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors within this distance are considered equal</td></tr></table>

7073

7074

<tr>

7075

7076

7077

<img SRC="../images/right_triangle_option.png"

7078

ALT=">" BORDER=0 height=14

7079

width=15><b><font face="Helvetica, Arial"

7080

><font color="#FFFFFF"><font size="+1">

7081

<a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i>

7082

</font></font></font></b></td></tr></table>

7083

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>

7084

7085

<tr>

7086

7087

7088

<img SRC="../images/right_triangle_option.png"

7089

ALT=">" BORDER=0 height=14

7090

width=15><b><font face="Helvetica, Arial"

7091

><font color="#FFFFFF"><font size="+1">

7092

<a href="GraphicsMagick.html#details-Gaussian">-Gaussian</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

7093

</font></font></font></b></td></tr></table>

7094

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

7095

7096

<tr>

7097

7098

7099

<img SRC="../images/right_triangle_option.png"

7100

ALT=">" BORDER=0 height=14

7101

width=15><b><font face="Helvetica, Arial"

7102

><font color="#FFFFFF"><font size="+1">

7103

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

7104

</font></font></font></b></td></tr></table>

7105

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

7106

7107

<tr>

7108

7109

7110

<img SRC="../images/right_triangle_option.png"

7111

ALT=">" BORDER=0 height=14

7112

width=15><b><font face="Helvetica, Arial"

7113

><font color="#FFFFFF"><font size="+1">

7114

<a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i>

7115

</font></font></font></b></td></tr></table>

7116

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table>

7117

7118

<tr>

7119

7120

7121

<img SRC="../images/right_triangle_option.png"

7122

ALT=">" BORDER=0 height=14

7123

width=15><b><font face="Helvetica, Arial"

7124

><font color="#FFFFFF"><font size="+1">

7125

<a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i>

7126

</font></font></font></b></td></tr></table>

7127

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table>

7128

7129

<tr>

7130

7131

7132

<img SRC="../images/right_triangle_option.png"

7133

ALT=">" BORDER=0 height=14

7134

width=15><b><font face="Helvetica, Arial"

7135

><font color="#FFFFFF"><font size="+1">

7136

-help

7137

</font></font></font></b></td></tr></table>

7138

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

7139

7140

<tr>

7141

7142

7143

<img SRC="../images/right_triangle_option.png"

7144

ALT=">" BORDER=0 height=14

7145

width=15><b><font face="Helvetica, Arial"

7146

><font color="#FFFFFF"><font size="+1">

7147

-implode <i><factor></i>

7148

</font></font></font></b></td></tr></table>

7149

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>implode image pixels about the center</td></tr></table>

7150

7151

<tr>

7152

7153

7154

<img SRC="../images/right_triangle_option.png"

7155

ALT=">" BORDER=0 height=14

7156

width=15><b><font face="Helvetica, Arial"

7157

><font color="#FFFFFF"><font size="+1">

7158

<a href="GraphicsMagick.html#details-intent">-intent</a> <i><type></i>

7159

</font></font></font></b></td></tr></table>

7160

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of rendering intent when managing the image color</td></tr></table>

7161

7162

<tr>

7163

7164

7165

<img SRC="../images/right_triangle_option.png"

7166

ALT=">" BORDER=0 height=14

7167

width=15><b><font face="Helvetica, Arial"

7168

><font color="#FFFFFF"><font size="+1">

7169

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

7170

</font></font></font></b></td></tr></table>

7171

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

7172

7173

<tr>

7174

7175

7176

<img SRC="../images/right_triangle_option.png"

7177

ALT=">" BORDER=0 height=14

7178

width=15><b><font face="Helvetica, Arial"

7179

><font color="#FFFFFF"><font size="+1">

7180

<a href="GraphicsMagick.html#details-label">-label</a> <i><name></i>

7181

</font></font></font></b></td></tr></table>

7182

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

7183

7184

<tr>

7185

7186

7187

<img SRC="../images/right_triangle_option.png"

7188

ALT=">" BORDER=0 height=14

7189

width=15><b><font face="Helvetica, Arial"

7190

><font color="#FFFFFF"><font size="+1">

7191

-lat <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i>

7192

</font></font></font></b></td></tr></table>

7193

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table>

7194

7195

<tr>

7196

7197

7198

<img SRC="../images/right_triangle_option.png"

7199

ALT=">" BORDER=0 height=14

7200

width=15><b><font face="Helvetica, Arial"

7201

><font color="#FFFFFF"><font size="+1">

7202

<a href="GraphicsMagick.html#details-level">-level</a> <i><black_point></i>{<i>,<gamma></i>}<i></i>{<i>,<white_point></i>}<i></i>{<i>%</i>}<i></i>

7203

</font></font></font></b></td></tr></table>

7204

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>adjust the level of image contrast</td></tr></table>

7205

7206

<tr>

7207

7208

7209

<img SRC="../images/right_triangle_option.png"

7210

ALT=">" BORDER=0 height=14

7211

width=15><b><font face="Helvetica, Arial"

7212

><font color="#FFFFFF"><font size="+1">

7213

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

7214

</font></font></font></b></td></tr></table>

7215

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

7216

7217

<tr>

7218

7219

7220

<img SRC="../images/right_triangle_option.png"

7221

ALT=">" BORDER=0 height=14

7222

width=15><b><font face="Helvetica, Arial"

7223

><font color="#FFFFFF"><font size="+1">

7224

7225

</font></font></font></b></td></tr></table>

7226

7227

7228

<tr>

7229

7230

7231

<img SRC="../images/right_triangle_option.png"

7232

ALT=">" BORDER=0 height=14

7233

width=15><b><font face="Helvetica, Arial"

7234

><font color="#FFFFFF"><font size="+1">

7235

7236

</font></font></font></b></td></tr></table>

7237

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

7238

7239

<tr>

7240

7241

7242

<img SRC="../images/right_triangle_option.png"

7243

ALT=">" BORDER=0 height=14

7244

width=15><b><font face="Helvetica, Arial"

7245

><font color="#FFFFFF"><font size="+1">

7246

7247

</font></font></font></b></td></tr></table>

7248

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add Netscape loop extension to your GIF animation</td></tr></table>

7249

7250

<tr>

7251

7252

7253

<img SRC="../images/right_triangle_option.png"

7254

ALT=">" BORDER=0 height=14

7255

width=15><b><font face="Helvetica, Arial"

7256

><font color="#FFFFFF"><font size="+1">

7257

7258

</font></font></font></b></td></tr></table>

7259

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>choose a particular set of colors from this image</td></tr></table>

7260

7261

<tr>

7262

7263

7264

<img SRC="../images/right_triangle_option.png"

7265

ALT=">" BORDER=0 height=14

7266

width=15><b><font face="Helvetica, Arial"

7267

><font color="#FFFFFF"><font size="+1">

7268

7269

</font></font></font></b></td></tr></table>

7270

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table>

7271

7272

<tr>

7273

7274

7275

<img SRC="../images/right_triangle_option.png"

7276

ALT=">" BORDER=0 height=14

7277

width=15><b><font face="Helvetica, Arial"

7278

><font color="#FFFFFF"><font size="+1">

7279

<a href="GraphicsMagick.html#details-matte">-matte</a>

7280

</font></font></font></b></td></tr></table>

7281

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

7282

7283

<tr>

7284

7285

7286

<img SRC="../images/right_triangle_option.png"

7287

ALT=">" BORDER=0 height=14

7288

width=15><b><font face="Helvetica, Arial"

7289

><font color="#FFFFFF"><font size="+1">

7290

<a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i>

7291

</font></font></font></b></td></tr></table>

7292

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>

7293

7294

<tr>

7295

7296

7297

<img SRC="../images/right_triangle_option.png"

7298

ALT=">" BORDER=0 height=14

7299

width=15><b><font face="Helvetica, Arial"

7300

><font color="#FFFFFF"><font size="+1">

7301

-median <i><radius></i>

7302

</font></font></font></b></td></tr></table>

7303

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a median filter to the image</td></tr></table>

7304

7305

<tr>

7306

7307

7308

<img SRC="../images/right_triangle_option.png"

7309

ALT=">" BORDER=0 height=14

7310

width=15><b><font face="Helvetica, Arial"

7311

><font color="#FFFFFF"><font size="+1">

7312

<a href="GraphicsMagick.html#details-modulate">-modulate</a> <i>brightness[,saturation[,hue]]</i>

7313

</font></font></font></b></td></tr></table>

7314

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>vary the brightness, saturation, and hue of an image</td></tr></table>

7315

7316

<tr>

7317

7318

7319

<img SRC="../images/right_triangle_option.png"

7320

ALT=">" BORDER=0 height=14

7321

width=15><b><font face="Helvetica, Arial"

7322

><font color="#FFFFFF"><font size="+1">

7323

-monochrome

7324

</font></font></font></b></td></tr></table>

7325

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

7326

7327

<tr>

7328

7329

7330

<img SRC="../images/right_triangle_option.png"

7331

ALT=">" BORDER=0 height=14

7332

width=15><b><font face="Helvetica, Arial"

7333

><font color="#FFFFFF"><font size="+1">

7334

<a href="GraphicsMagick.html#details-morph">-morph</a> <i><frames></i>

7335

</font></font></font></b></td></tr></table>

7336

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>morphs an image sequence</td></tr></table>

7337

7338

<tr>

7339

7340

7341

<img SRC="../images/right_triangle_option.png"

7342

ALT=">" BORDER=0 height=14

7343

width=15><b><font face="Helvetica, Arial"

7344

><font color="#FFFFFF"><font size="+1">

7345

<a href="GraphicsMagick.html#details-mosaic">-mosaic</a>

7346

</font></font></font></b></td></tr></table>

7347

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a mosaic from an image or an image sequence</td></tr></table>

7348

7349

<tr>

7350

7351

7352

<img SRC="../images/right_triangle_option.png"

7353

ALT=">" BORDER=0 height=14

7354

width=15><b><font face="Helvetica, Arial"

7355

><font color="#FFFFFF"><font size="+1">

7356

<a href="GraphicsMagick.html#details-negate">-negate</a>

7357

</font></font></font></b></td></tr></table>

7358

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>

7359

7360

<tr>

7361

7362

7363

<img SRC="../images/right_triangle_option.png"

7364

ALT=">" BORDER=0 height=14

7365

width=15><b><font face="Helvetica, Arial"

7366

><font color="#FFFFFF"><font size="+1">

7367

<a href="GraphicsMagick.html#details-noise">-noise</a> <i><radius|type></i>

7368

</font></font></font></b></td></tr></table>

7369

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add or reduce noise in an image</td></tr></table>

7370

7371

<tr>

7372

7373

7374

<img SRC="../images/right_triangle_option.png"

7375

ALT=">" BORDER=0 height=14

7376

width=15><b><font face="Helvetica, Arial"

7377

><font color="#FFFFFF"><font size="+1">

7378

7379

</font></font></font></b></td></tr></table>

7380

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>

7381

7382

<tr>

7383

7384

7385

<img SRC="../images/right_triangle_option.png"

7386

ALT=">" BORDER=0 height=14

7387

width=15><b><font face="Helvetica, Arial"

7388

><font color="#FFFFFF"><font size="+1">

7389

<a href="GraphicsMagick.html#details-normalize">-normalize</a>

7390

</font></font></font></b></td></tr></table>

7391

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform image to span the full range of color values</td></tr></table>

7392

7393

<tr>

7394

7395

7396

<img SRC="../images/right_triangle_option.png"

7397

ALT=">" BORDER=0 height=14

7398

width=15><b><font face="Helvetica, Arial"

7399

><font color="#FFFFFF"><font size="+1">

7400

<a href="GraphicsMagick.html#details-opaque">-opaque</a> <i><color></i>

7401

</font></font></font></b></td></tr></table>

7402

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>change this color to the pen color within the image</td></tr></table>

7403

7404

<tr>

7405

7406

7407

<img SRC="../images/right_triangle_option.png"

7408

ALT=">" BORDER=0 height=14

7409

width=15><b><font face="Helvetica, Arial"

7410

><font color="#FFFFFF"><font size="+1">

7411

<a href="GraphicsMagick.html#details-operator">-operator</a> <i>channel operator rvalue[%]</i>

7412

</font></font></font></b></td></tr></table>

7413

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a mathematical or bitwise operator to an image channel</td></tr></table>

7414

7415

<tr>

7416

7417

7418

<img SRC="../images/right_triangle_option.png"

7419

ALT=">" BORDER=0 height=14

7420

width=15><b><font face="Helvetica, Arial"

7421

><font color="#FFFFFF"><font size="+1">

7422

<a href="GraphicsMagick.html#details-ordered-dither">-ordered-dither</a> <i><channeltype> <NxN></i>

7423

</font></font></font></b></td></tr></table>

7424

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table>

7425

7426

<tr>

7427

7428

7429

<img SRC="../images/right_triangle_option.png"

7430

ALT=">" BORDER=0 height=14

7431

width=15><b><font face="Helvetica, Arial"

7432

><font color="#FFFFFF"><font size="+1">

7433

7434

</font></font></font></b></td></tr></table>

7435

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

7436

7437

<tr>

7438

7439

7440

<img SRC="../images/right_triangle_option.png"

7441

ALT=">" BORDER=0 height=14

7442

width=15><b><font face="Helvetica, Arial"

7443

><font color="#FFFFFF"><font size="+1">

7444

<a href="GraphicsMagick.html#details-paint">-paint</a> <i><radius></i>

7445

</font></font></font></b></td></tr></table>

7446

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table>

7447

7448

<tr>

7449

7450

7451

<img SRC="../images/right_triangle_option.png"

7452

ALT=">" BORDER=0 height=14

7453

width=15><b><font face="Helvetica, Arial"

7454

><font color="#FFFFFF"><font size="+1">

7455

7456

</font></font></font></b></td></tr></table>

7457

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table>

7458

7459

<tr>

7460

7461

7462

<img SRC="../images/right_triangle_option.png"

7463

ALT=">" BORDER=0 height=14

7464

width=15><b><font face="Helvetica, Arial"

7465

><font color="#FFFFFF"><font size="+1">

7466

-ping

7467

</font></font></font></b></td></tr></table>

7468

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table>

7469

7470

<tr>

7471

7472

7473

<img SRC="../images/right_triangle_option.png"

7474

ALT=">" BORDER=0 height=14

7475

width=15><b><font face="Helvetica, Arial"

7476

><font color="#FFFFFF"><font size="+1">

7477

-pointsize <i><value></i>

7478

</font></font></font></b></td></tr></table>

7479

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, OPTION1, or TrueType font</td></tr></table>

7480

7481

<tr>

7482

7483

7484

<img SRC="../images/right_triangle_option.png"

7485

ALT=">" BORDER=0 height=14

7486

width=15><b><font face="Helvetica, Arial"

7487

><font color="#FFFFFF"><font size="+1">

7488

<a href="GraphicsMagick.html#details-preview">-preview</a> <i><type></i>

7489

</font></font></font></b></td></tr></table>

7490

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>image preview type</td></tr></table>

7491

7492

<tr>

7493

7494

7495

<img SRC="../images/right_triangle_option.png"

7496

ALT=">" BORDER=0 height=14

7497

width=15><b><font face="Helvetica, Arial"

7498

><font color="#FFFFFF"><font size="+1">

7499

<a href="GraphicsMagick.html#details-process">-process</a> <i><command></i>

7500

</font></font></font></b></td></tr></table>

7501

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>process a sequence of images using a process module</td></tr></table>

7502

7503

<tr>

7504

7505

7506

<img SRC="../images/right_triangle_option.png"

7507

ALT=">" BORDER=0 height=14

7508

width=15><b><font face="Helvetica, Arial"

7509

><font color="#FFFFFF"><font size="+1">

7510

<a href="GraphicsMagick.html#details-profile">-profile</a> <i><filename></i>

7511

</font></font></font></b></td></tr></table>

7512

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table>

7513

7514

<tr>

7515

7516

7517

<img SRC="../images/right_triangle_option.png"

7518

ALT=">" BORDER=0 height=14

7519

width=15><b><font face="Helvetica, Arial"

7520

><font color="#FFFFFF"><font size="+1">

7521

<a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i>

7522

</font></font></font></b></td></tr></table>

7523

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

7524

7525

<tr>

7526

7527

7528

<img SRC="../images/right_triangle_option.png"

7529

ALT=">" BORDER=0 height=14

7530

width=15><b><font face="Helvetica, Arial"

7531

><font color="#FFFFFF"><font size="+1">

7532

<a href="GraphicsMagick.html#details-raise">-raise</a> <i><width>x<height></i>

7533

</font></font></font></b></td></tr></table>

7534

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table>

7535

7536

<tr>

7537

7538

7539

<img SRC="../images/right_triangle_option.png"

7540

ALT=">" BORDER=0 height=14

7541

width=15><b><font face="Helvetica, Arial"

7542

><font color="#FFFFFF"><font size="+1">

7543

<a href="GraphicsMagick.html#details-random-threshold">-random-threshold</a> <i><channeltype> <LOWxHIGH></i>

7544

</font></font></font></b></td></tr></table>

7545

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table>

7546

7547

<tr>

7548

7549

7550

<img SRC="../images/right_triangle_option.png"

7551

ALT=">" BORDER=0 height=14

7552

width=15><b><font face="Helvetica, Arial"

7553

><font color="#FFFFFF"><font size="+1">

7554

<a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i>

7555

</font></font></font></b></td></tr></table>

7556

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table>

7557

7558

<tr>

7559

7560

7561

<img SRC="../images/right_triangle_option.png"

7562

ALT=">" BORDER=0 height=14

7563

width=15><b><font face="Helvetica, Arial"

7564

><font color="#FFFFFF"><font size="+1">

7565

<a href="GraphicsMagick.html#details-region">-region</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>

7566

</font></font></font></b></td></tr></table>

7567

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply options to a portion of the image</td></tr></table>

7568

7569

<tr>

7570

7571

7572

<img SRC="../images/right_triangle_option.png"

7573

ALT=">" BORDER=0 height=14

7574

width=15><b><font face="Helvetica, Arial"

7575

><font color="#FFFFFF"><font size="+1">

7576

<a href="GraphicsMagick.html#details-render">-render</a>

7577

</font></font></font></b></td></tr></table>

7578

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table>

7579

7580

<tr>

7581

7582

7583

<img SRC="../images/right_triangle_option.png"

7584

ALT=">" BORDER=0 height=14

7585

width=15><b><font face="Helvetica, Arial"

7586

><font color="#FFFFFF"><font size="+1">

7587

<a href="GraphicsMagick.html#details-resample">-resample</a> <i><horizontal>x<vertical></i>

7588

</font></font></font></b></td></tr></table>

7589

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Resample image to specified horizontal and vertical resolution</td></tr></table>

7590

7591

<tr>

7592

7593

7594

<img SRC="../images/right_triangle_option.png"

7595

ALT=">" BORDER=0 height=14

7596

width=15><b><font face="Helvetica, Arial"

7597

><font color="#FFFFFF"><font size="+1">

7598

<a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

7599

</font></font></font></b></td></tr></table>

7600

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table>

7601

7602

<tr>

7603

7604

7605

<img SRC="../images/right_triangle_option.png"

7606

ALT=">" BORDER=0 height=14

7607

width=15><b><font face="Helvetica, Arial"

7608

><font color="#FFFFFF"><font size="+1">

7609

7610

</font></font></font></b></td></tr></table>

7611

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table>

7612

7613

<tr>

7614

7615

7616

<img SRC="../images/right_triangle_option.png"

7617

ALT=">" BORDER=0 height=14

7618

width=15><b><font face="Helvetica, Arial"

7619

><font color="#FFFFFF"><font size="+1">

7620

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

7621

</font></font></font></b></td></tr></table>

7622

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

7623

7624

<tr>

7625

7626

7627

<img SRC="../images/right_triangle_option.png"

7628

ALT=">" BORDER=0 height=14

7629

width=15><b><font face="Helvetica, Arial"

7630

><font color="#FFFFFF"><font size="+1">

7631

<a href="GraphicsMagick.html#details-sample">-sample</a> <i><geometry></i>

7632

</font></font></font></b></td></tr></table>

7633

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table>

7634

7635

<tr>

7636

7637

7638

<img SRC="../images/right_triangle_option.png"

7639

ALT=">" BORDER=0 height=14

7640

width=15><b><font face="Helvetica, Arial"

7641

><font color="#FFFFFF"><font size="+1">

7642

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

7643

</font></font></font></b></td></tr></table>

7644

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

7645

7646

<tr>

7647

7648

7649

<img SRC="../images/right_triangle_option.png"

7650

ALT=">" BORDER=0 height=14

7651

width=15><b><font face="Helvetica, Arial"

7652

><font color="#FFFFFF"><font size="+1">

7653

<a href="GraphicsMagick.html#details-scale">-scale</a> <i><geometry></i>

7654

</font></font></font></b></td></tr></table>

7655

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table>

7656

7657

<tr>

7658

7659

7660

<img SRC="../images/right_triangle_option.png"

7661

ALT=">" BORDER=0 height=14

7662

width=15><b><font face="Helvetica, Arial"

7663

><font color="#FFFFFF"><font size="+1">

7664

<a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i>

7665

</font></font></font></b></td></tr></table>

7666

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table>

7667

7668

<tr>

7669

7670

7671

<img SRC="../images/right_triangle_option.png"

7672

ALT=">" BORDER=0 height=14

7673

width=15><b><font face="Helvetica, Arial"

7674

><font color="#FFFFFF"><font size="+1">

7675

<a href="GraphicsMagick.html#details-segment">-segment</a> <i><cluster threshold>x<smoothing threshold></i>

7676

</font></font></font></b></td></tr></table>

7677

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table>

7678

7679

<tr>

7680

7681

7682

<img SRC="../images/right_triangle_option.png"

7683

ALT=">" BORDER=0 height=14

7684

width=15><b><font face="Helvetica, Arial"

7685

><font color="#FFFFFF"><font size="+1">

7686

<a href="GraphicsMagick.html#details-shade">-shade</a> <i><azimuth>x<elevation></i>

7687

</font></font></font></b></td></tr></table>

7688

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shade the image using a distant light source</td></tr></table>

7689

7690

<tr>

7691

7692

7693

<img SRC="../images/right_triangle_option.png"

7694

ALT=">" BORDER=0 height=14

7695

width=15><b><font face="Helvetica, Arial"

7696

><font color="#FFFFFF"><font size="+1">

7697

<a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

7698

</font></font></font></b></td></tr></table>

7699

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>

7700

7701

<tr>

7702

7703

7704

<img SRC="../images/right_triangle_option.png"

7705

ALT=">" BORDER=0 height=14

7706

width=15><b><font face="Helvetica, Arial"

7707

><font color="#FFFFFF"><font size="+1">

7708

<a href="GraphicsMagick.html#details-shave">-shave</a> <i><width>x<height></i>{<i>%</i>}<i></i>

7709

</font></font></font></b></td></tr></table>

7710

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shave pixels from the image edges</td></tr></table>

7711

7712

<tr>

7713

7714

7715

<img SRC="../images/right_triangle_option.png"

7716

ALT=">" BORDER=0 height=14

7717

width=15><b><font face="Helvetica, Arial"

7718

><font color="#FFFFFF"><font size="+1">

7719

<a href="GraphicsMagick.html#details-shear">-shear</a> <i><x degrees>x<y degrees></i>

7720

</font></font></font></b></td></tr></table>

7721

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shear the image along the X or Y axis</td></tr></table>

7722

7723

<tr>

7724

7725

7726

<img SRC="../images/right_triangle_option.png"

7727

ALT=">" BORDER=0 height=14

7728

width=15><b><font face="Helvetica, Arial"

7729

><font color="#FFFFFF"><font size="+1">

7730

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

7731

</font></font></font></b></td></tr></table>

7732

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

7733

7734

<tr>

7735

7736

7737

<img SRC="../images/right_triangle_option.png"

7738

ALT=">" BORDER=0 height=14

7739

width=15><b><font face="Helvetica, Arial"

7740

><font color="#FFFFFF"><font size="+1">

7741

<a href="GraphicsMagick.html#details-solarize">-solarize</a> <i><factor></i>

7742

</font></font></font></b></td></tr></table>

7743

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>negate all pixels above the threshold level</td></tr></table>

7744

7745

<tr>

7746

7747

7748

<img SRC="../images/right_triangle_option.png"

7749

ALT=">" BORDER=0 height=14

7750

width=15><b><font face="Helvetica, Arial"

7751

><font color="#FFFFFF"><font size="+1">

7752

<a href="GraphicsMagick.html#details-spread">-spread</a> <i><amount></i>

7753

</font></font></font></b></td></tr></table>

7754

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image pixels by a random amount</td></tr></table>

7755

7756

<tr>

7757

7758

7759

<img SRC="../images/right_triangle_option.png"

7760

ALT=">" BORDER=0 height=14

7761

width=15><b><font face="Helvetica, Arial"

7762

><font color="#FFFFFF"><font size="+1">

7763

<a href="GraphicsMagick.html#details-stroke">-stroke</a> <i><color></i>

7764

</font></font></font></b></td></tr></table>

7765

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table>

7766

7767

<tr>

7768

7769

7770

<img SRC="../images/right_triangle_option.png"

7771

ALT=">" BORDER=0 height=14

7772

width=15><b><font face="Helvetica, Arial"

7773

><font color="#FFFFFF"><font size="+1">

7774

<a href="GraphicsMagick.html#details-strokewidth">-strokewidth</a> <i><value></i>

7775

</font></font></font></b></td></tr></table>

7776

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table>

7777

7778

<tr>

7779

7780

7781

<img SRC="../images/right_triangle_option.png"

7782

ALT=">" BORDER=0 height=14

7783

width=15><b><font face="Helvetica, Arial"

7784

><font color="#FFFFFF"><font size="+1">

7785

<a href="GraphicsMagick.html#details-swirl">-swirl</a> <i><degrees></i>

7786

</font></font></font></b></td></tr></table>

7787

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>swirl image pixels about the center</td></tr></table>

7788

7789

<tr>

7790

7791

7792

<img SRC="../images/right_triangle_option.png"

7793

ALT=">" BORDER=0 height=14

7794

width=15><b><font face="Helvetica, Arial"

7795

><font color="#FFFFFF"><font size="+1">

7796

-texture <i><filename></i>

7797

</font></font></font></b></td></tr></table>

7798

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table>

7799

7800

<tr>

7801

7802

7803

<img SRC="../images/right_triangle_option.png"

7804

ALT=">" BORDER=0 height=14

7805

width=15><b><font face="Helvetica, Arial"

7806

><font color="#FFFFFF"><font size="+1">

7807

<a href="GraphicsMagick.html#details-threshold">-threshold</a> <i><value></i>{<i><green>,<blue>,<opacity></i>}<i></i>{<i>%</i>}<i></i>

7808

</font></font></font></b></td></tr></table>

7809

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table>

7810

7811

<tr>

7812

7813

7814

<img SRC="../images/right_triangle_option.png"

7815

ALT=">" BORDER=0 height=14

7816

width=15><b><font face="Helvetica, Arial"

7817

><font color="#FFFFFF"><font size="+1">

7818

-tile <i><filename></i>

7819

</font></font></font></b></td></tr></table>

7820

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tile image when filling a graphic primitive</td></tr></table>

7821

7822

<tr>

7823

7824

7825

<img SRC="../images/right_triangle_option.png"

7826

ALT=">" BORDER=0 height=14

7827

width=15><b><font face="Helvetica, Arial"

7828

><font color="#FFFFFF"><font size="+1">

7829

<a href="GraphicsMagick.html#details-transform">-transform</a>

7830

</font></font></font></b></td></tr></table>

7831

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table>

7832

7833

<tr>

7834

7835

7836

<img SRC="../images/right_triangle_option.png"

7837

ALT=">" BORDER=0 height=14

7838

width=15><b><font face="Helvetica, Arial"

7839

><font color="#FFFFFF"><font size="+1">

7840

<a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i>

7841

</font></font></font></b></td></tr></table>

7842

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table>

7843

7844

<tr>

7845

7846

7847

<img SRC="../images/right_triangle_option.png"

7848

ALT=">" BORDER=0 height=14

7849

width=15><b><font face="Helvetica, Arial"

7850

><font color="#FFFFFF"><font size="+1">

7851

<a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i>

7852

</font></font></font></b></td></tr></table>

7853

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

7854

7855

<tr>

7856

7857

7858

<img SRC="../images/right_triangle_option.png"

7859

ALT=">" BORDER=0 height=14

7860

width=15><b><font face="Helvetica, Arial"

7861

><font color="#FFFFFF"><font size="+1">

7862

7863

</font></font></font></b></td></tr></table>

7864

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

7865

7866

<tr>

7867

7868

7869

<img SRC="../images/right_triangle_option.png"

7870

ALT=">" BORDER=0 height=14

7871

width=15><b><font face="Helvetica, Arial"

7872

><font color="#FFFFFF"><font size="+1">

7873

7874

</font></font></font></b></td></tr></table>

7875

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table>

7876

7877

<tr>

7878

7879

7880

<img SRC="../images/right_triangle_option.png"

7881

ALT=">" BORDER=0 height=14

7882

width=15><b><font face="Helvetica, Arial"

7883

><font color="#FFFFFF"><font size="+1">

7884

<a href="GraphicsMagick.html#details-units">-units</a> <i><type></i>

7885

</font></font></font></b></td></tr></table>

7886

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table>

7887

7888

<tr>

7889

7890

7891

<img SRC="../images/right_triangle_option.png"

7892

ALT=">" BORDER=0 height=14

7893

width=15><b><font face="Helvetica, Arial"

7894

><font color="#FFFFFF"><font size="+1">

7895

<a href="GraphicsMagick.html#details-unsharp">-unsharp</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i>

7896

</font></font></font></b></td></tr></table>

7897

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table>

7898

7899

<tr>

7900

7901

7902

<img SRC="../images/right_triangle_option.png"

7903

ALT=">" BORDER=0 height=14

7904

width=15><b><font face="Helvetica, Arial"

7905

><font color="#FFFFFF"><font size="+1">

7906

-use-pixmap

7907

</font></font></font></b></td></tr></table>

7908

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table>

7909

7910

<tr>

7911

7912

7913

<img SRC="../images/right_triangle_option.png"

7914

ALT=">" BORDER=0 height=14

7915

width=15><b><font face="Helvetica, Arial"

7916

><font color="#FFFFFF"><font size="+1">

7917

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

7918

</font></font></font></b></td></tr></table>

7919

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

7920

7921

<tr>

7922

7923

7924

<img SRC="../images/right_triangle_option.png"

7925

ALT=">" BORDER=0 height=14

7926

width=15><b><font face="Helvetica, Arial"

7927

><font color="#FFFFFF"><font size="+1">

7928

<a href="GraphicsMagick.html#details-version">-version</a>

7929

</font></font></font></b></td></tr></table>

7930

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

7931

7932

<tr>

7933

7934

7935

<img SRC="../images/right_triangle_option.png"

7936

ALT=">" BORDER=0 height=14

7937

width=15><b><font face="Helvetica, Arial"

7938

><font color="#FFFFFF"><font size="+1">

7939

-view <i><string></i>

7940

</font></font></font></b></td></tr></table>

7941

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table>

7942

7943

<tr>

7944

7945

7946

<img SRC="../images/right_triangle_option.png"

7947

ALT=">" BORDER=0 height=14

7948

width=15><b><font face="Helvetica, Arial"

7949

><font color="#FFFFFF"><font size="+1">

7950

<a href="GraphicsMagick.html#details-virtual-pixel">-virtual-pixel</a> <i><method></i>

7951

</font></font></font></b></td></tr></table>

7952

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table>

7953

7954

<tr>

7955

7956

7957

<img SRC="../images/right_triangle_option.png"

7958

ALT=">" BORDER=0 height=14

7959

width=15><b><font face="Helvetica, Arial"

7960

><font color="#FFFFFF"><font size="+1">

7961

7962

</font></font></font></b></td></tr></table>

7963

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>alter an image along a sine wave</td></tr></table>

7964

7965

<tr>

7966

7967

7968

<img SRC="../images/right_triangle_option.png"

7969

ALT=">" BORDER=0 height=14

7970

width=15><b><font face="Helvetica, Arial"

7971

><font color="#FFFFFF"><font size="+1">

7972

<a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i>

7973

</font></font></font></b></td></tr></table>

7974

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table>

7975

7976

<tr>

7977

7978

7979

<img SRC="../images/right_triangle_option.png"

7980

ALT=">" BORDER=0 height=14

7981

width=15><b><font face="Helvetica, Arial"

7982

><font color="#FFFFFF"><font size="+1">

7983

<a href="GraphicsMagick.html#details-write">-write</a> <i><filename></i>

7984

</font></font></font></b></td></tr></table>

7985

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write an image sequence [<em>convert, composite</em>]</td></tr></table>

7986

<p>

7987

For a more detailed description of each option, see

7988

Options, above.

7989

7990

7991

<tr>

7992

<td ALIGN=LEFT bgcolor="#52799E"><img

7993

SRC="../images/right_triangle.png" ALT=">" BORDER=0

7994

height=14 width=15><b><font face="Helvetica, Arial"><font

7995

color="#FFFFFF"><font size="+1">

7996

<a NAME="display"></a>gm display

7997

</font></font></font></b></td></tr></table>

7998

7999

8000

<p>

8001

<a href="../images/screen.png">Display</a> is a machine architecture independent

8002

image processing and display program. It can display an image on any workstation

8003

screen running an X server. <strong>Display</strong> can read and write

8004

8005

of the more popular image <a href="formats.html">formats</a> (e.g. <strong>JPEG</strong>,

8006

<strong>TIFF</strong>,

8007

<strong>PNM</strong>,

8008

<strong>Photo

8009

CD</strong>, etc.).

8010

<p>

8011

With <strong>display</strong>, you can perform these functions on an image:

8012

<dl>

8013

<dd><img SRC="../images/ball.png" ALT="*">load an image from a file

8014

<dd><img SRC="../images/ball.png" ALT="*">display the next image

8015

<dd><img SRC="../images/ball.png" ALT="*">display the former image

8016

<dd><img SRC="../images/ball.png" ALT="*">display a sequence of images as a slide show

8017

<dd><img SRC="../images/ball.png" ALT="*">write the image to a file

8018

<dd><img SRC="../images/ball.png" ALT="*">print the image to a <em>PostScript</em> printer

8019

<dd><img SRC="../images/ball.png" ALT="*">delete the image file

8020

<dd><img SRC="../images/ball.png" ALT="*">create a Visual Image Directory

8021

<dd><img SRC="../images/ball.png" ALT="*">select the image to display by its thumbnail rather than name

8022

<dd><img SRC="../images/ball.png" ALT="*">undo last image transformation

8023

<dd><img SRC="../images/ball.png" ALT="*">copy a region of the image

8024

<dd><img SRC="../images/ball.png" ALT="*">paste a region to the image

8025

<dd><img SRC="../images/ball.png" ALT="*">restore the image to its original size

8026

<dd><img SRC="../images/ball.png" ALT="*">refresh the image

8027

<dd><img SRC="../images/ball.png" ALT="*">half the image size

8028

<dd><img SRC="../images/ball.png" ALT="*">double the image size

8029

<dd><img SRC="../images/ball.png" ALT="*">resize the image

8030

<dd><img SRC="../images/ball.png" ALT="*">crop the image

8031

<dd><img SRC="../images/ball.png" ALT="*">cut the image

8032

<dd><img SRC="../images/ball.png" ALT="*">flop image in the horizontal direction

8033

<dd><img SRC="../images/ball.png" ALT="*">flip image in the vertical direction

8034

<dd><img SRC="../images/ball.png" ALT="*">rotate the image 90 degrees clockwise

8035

<dd><img SRC="../images/ball.png" ALT="*">rotate the image 90 degrees counter-clockwise

8036

<dd><img SRC="../images/ball.png" ALT="*">rotate the image

8037

<dd><img SRC="../images/ball.png" ALT="*">shear the image

8038

<dd><img SRC="../images/ball.png" ALT="*">roll the image

8039

<dd><img SRC="../images/ball.png" ALT="*">trim the image edges

8040

<dd><img SRC="../images/ball.png" ALT="*">invert the colors of the image

8041

<dd><img SRC="../images/ball.png" ALT="*">vary the color brightness

8042

<dd><img SRC="../images/ball.png" ALT="*">vary the color saturation

8043

<dd><img SRC="../images/ball.png" ALT="*">vary the image hue

8044

<dd><img SRC="../images/ball.png" ALT="*">gamma correct the image

8045

<dd><img SRC="../images/ball.png" ALT="*">sharpen the image contrast

8046

<dd><img SRC="../images/ball.png" ALT="*">dull the image contrast

8047

<dd><img SRC="../images/ball.png" ALT="*">perform histogram equalization on the image

8048

<dd><img SRC="../images/ball.png" ALT="*">perform histogram normalization on the image

8049

<dd><img SRC="../images/ball.png" ALT="*">negate the image colors

8050

<dd><img SRC="../images/ball.png" ALT="*">convert the image to grayscale

8051

<dd><img SRC="../images/ball.png" ALT="*">set the maximum number of unique colors in the image

8052

<dd><img SRC="../images/ball.png" ALT="*">reduce the speckles within an image

8053

<dd><img SRC="../images/ball.png" ALT="*">eliminate peak noise from an image

8054

<dd><img SRC="../images/ball.png" ALT="*">detect edges within the image

8055

<dd><img SRC="../images/ball.png" ALT="*">emboss an image

8056

<dd><img SRC="../images/ball.png" ALT="*">segment the image by color

8057

<dd><img SRC="../images/ball.png" ALT="*">simulate an oil painting

8058

<dd><img SRC="../images/ball.png" ALT="*">simulate a charcoal drawing

8059

<dd><img SRC="../images/ball.png" ALT="*">annotate the image with text

8060

<dd><img SRC="../images/ball.png" ALT="*">draw on the image

8061

<dd><img SRC="../images/ball.png" ALT="*">edit an image pixel color

8062

<dd><img SRC="../images/ball.png" ALT="*">edit the image matte information

8063

<dd><img SRC="../images/ball.png" ALT="*">composite an image with another

8064

<dd><img SRC="../images/ball.png" ALT="*">add a border to the image

8065

<dd><img SRC="../images/ball.png" ALT="*">surround image with an ornamental border

8066

<dd><img SRC="../images/ball.png" ALT="*">apply image processing techniques to a region of interest

8067

<dd><img SRC="../images/ball.png" ALT="*">display information about the image

8068

<dd><img SRC="../images/ball.png" ALT="*">zoom a portion of the image

8069

<dd><img SRC="../images/ball.png" ALT="*">show a histogram of the image

8070

<dd><img SRC="../images/ball.png" ALT="*">display image to background of a window

8071

<dd><img SRC="../images/ball.png" ALT="*">set user preferences

8072

<dd><img SRC="../images/ball.png" ALT="*">display information about this program

8073

<dd><img SRC="../images/ball.png" ALT="*">discard all images and exit program

8074

<dd><img SRC="../images/ball.png" ALT="*">change the level of magnification

8075

<dd><img SRC="../images/ball.png" ALT="*">display images specified by a World Wide Web (WWW) uniform resource locator (URL)

8076

</dl>

8077

</td></tr></table>

8078

<p>

8079

<i><a href="#top">Back to Contents</a></i>

8080

 </p>

8081

8082

<tr>

8083

<td ALIGN=LEFT bgcolor="#52799E"><img

8084

SRC="../images/right_triangle.png" ALT=">" BORDER=0

8085

height=14 width=15><b><font face="Helvetica, Arial"><font

8086

color="#FFFFFF"><font size="+1">

8087

<a NAME="disp-exam"></a>Examples

8088

</font></font></font></b></td></tr></table>

8089

8090

8091

<p>

8092

To scale an image of a cockatoo to exactly 640 pixels in width and 480

8093

pixels in height and position the window at location (200,200), use:

8094

<pre>

8095

gm display -geometry 640x480+200+200! cockatoo.miff

8096

</pre>

8097

<p>

8098

To display an image of a cockatoo without a border centered on a backdrop,

8099

use:

8100

<pre>

8101

gm display +borderwidth -backdrop cockatoo.miff

8102

</pre>

8103

<p>

8104

To tile a slate texture onto the root window, use:

8105

<pre>

8106

gm display -size 1280x1024 -window root slate.png

8107

</pre>

8108

<p>

8109

To display a visual image directory of all your JPEG images, use:

8110

<pre>

8111

gm display 'vid:*.jpg'

8112

</pre>

8113

<p>

8114

To display a MAP image that is 640 pixels in width and 480 pixels in height

8115

with 256 colors, use:

8116

<pre>

8117

gm display -size 640x480+256 cockatoo.map

8118

</pre>

8119

<p>

8120

To display an image of a cockatoo specified with a <strong>World Wide Web (WWW)</strong>

8121

uniform resource locator <strong>(URL)</strong>, use:

8122

<pre>

8123

gm display ftp://wizards.dupont.com/images/cockatoo.jpg

8124

</pre>

8125

<p>

8126

To display histogram of an image, use:

8127

<pre>

8128

gm convert file.jpg HISTOGRAM:- | display -

8129

</pre>

8130

</td></tr></table>

8131

<p>

8132

<i><a href="#top">Back to Contents</a></i>

8133

 </p>

8134

8135

<tr>

8136

<td ALIGN=LEFT bgcolor="#52799E"><img

8137

SRC="../images/right_triangle.png" ALT=">" BORDER=0

8138

height=14 width=15><b><font face="Helvetica, Arial"><font

8139

color="#FFFFFF"><font size="+1">

8140

<a NAME="disp-opti"></a>Options

8141

</font></font></font></b></td></tr></table>

8142

8143

8144

<p>

8145

Options are processed in command line order. Any option you specify on

8146

the command line remains in effect until it is explicitly changed by specifying

8147

the option again with a different effect. For example to display three images,

8148

the first with 32 colors, the second with an unlimited number of colors,

8149

and the third with only 16 colors, use:

8150

<pre>

8151

gm display -colors 32 cockatoo.miff -noop duck.miff

8152

-colors 16 macaw.miff

8153

</pre>

8154

<p>

8155

<strong>Display</strong> options can appear on the command line or in your X resources

8156

file. See <em>X(1)</em>. Options on the command line supersede values specified

8157

in your X resources file.

8158

<p>

8159

For a more detailed description of each option, see

8160

Options, above.

8161

8162

8163

<tr>

8164

8165

8166

<img SRC="../images/right_triangle_option.png"

8167

ALT=">" BORDER=0 height=14

8168

width=15><b><font face="Helvetica, Arial"

8169

><font color="#FFFFFF"><font size="+1">

8170

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

8171

</font></font></font></b></td></tr></table>

8172

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

8173

8174

<tr>

8175

8176

8177

<img SRC="../images/right_triangle_option.png"

8178

ALT=">" BORDER=0 height=14

8179

width=15><b><font face="Helvetica, Arial"

8180

><font color="#FFFFFF"><font size="+1">

8181

<a href="GraphicsMagick.html#details-backdrop">-backdrop</a>

8182

</font></font></font></b></td></tr></table>

8183

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table>

8184

8185

<tr>

8186

8187

8188

<img SRC="../images/right_triangle_option.png"

8189

ALT=">" BORDER=0 height=14

8190

width=15><b><font face="Helvetica, Arial"

8191

><font color="#FFFFFF"><font size="+1">

8192

<a href="GraphicsMagick.html#details-background">-background</a> <i><color></i>

8193

</font></font></font></b></td></tr></table>

8194

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

8195

8196

<tr>

8197

8198

8199

<img SRC="../images/right_triangle_option.png"

8200

ALT=">" BORDER=0 height=14

8201

width=15><b><font face="Helvetica, Arial"

8202

><font color="#FFFFFF"><font size="+1">

8203

<a href="GraphicsMagick.html#details-border">-border</a> <i><width>x<height></i>

8204

</font></font></font></b></td></tr></table>

8205

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table>

8206

8207

<tr>

8208

8209

8210

<img SRC="../images/right_triangle_option.png"

8211

ALT=">" BORDER=0 height=14

8212

width=15><b><font face="Helvetica, Arial"

8213

><font color="#FFFFFF"><font size="+1">

8214

<a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i>

8215

</font></font></font></b></td></tr></table>

8216

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

8217

8218

<tr>

8219

8220

8221

<img SRC="../images/right_triangle_option.png"

8222

ALT=">" BORDER=0 height=14

8223

width=15><b><font face="Helvetica, Arial"

8224

><font color="#FFFFFF"><font size="+1">

8225

-borderwidth <i><geometry></i>

8226

</font></font></font></b></td></tr></table>

8227

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table>

8228

8229

<tr>

8230

8231

8232

<img SRC="../images/right_triangle_option.png"

8233

ALT=">" BORDER=0 height=14

8234

width=15><b><font face="Helvetica, Arial"

8235

><font color="#FFFFFF"><font size="+1">

8236

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

8237

</font></font></font></b></td></tr></table>

8238

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

8239

8240

<tr>

8241

8242

8243

<img SRC="../images/right_triangle_option.png"

8244

ALT=">" BORDER=0 height=14

8245

width=15><b><font face="Helvetica, Arial"

8246

><font color="#FFFFFF"><font size="+1">

8247

<a href="GraphicsMagick.html#details-colormap">-colormap</a> <i><type></i>

8248

</font></font></font></b></td></tr></table>

8249

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table>

8250

8251

<tr>

8252

8253

8254

<img SRC="../images/right_triangle_option.png"

8255

ALT=">" BORDER=0 height=14

8256

width=15><b><font face="Helvetica, Arial"

8257

><font color="#FFFFFF"><font size="+1">

8258

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

8259

</font></font></font></b></td></tr></table>

8260

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

8261

8262

<tr>

8263

8264

8265

<img SRC="../images/right_triangle_option.png"

8266

ALT=">" BORDER=0 height=14

8267

width=15><b><font face="Helvetica, Arial"

8268

><font color="#FFFFFF"><font size="+1">

8269

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

8270

</font></font></font></b></td></tr></table>

8271

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

8272

8273

<tr>

8274

8275

8276

<img SRC="../images/right_triangle_option.png"

8277

ALT=">" BORDER=0 height=14

8278

width=15><b><font face="Helvetica, Arial"

8279

><font color="#FFFFFF"><font size="+1">

8280

<a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i>

8281

</font></font></font></b></td></tr></table>

8282

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

8283

8284

<tr>

8285

8286

8287

<img SRC="../images/right_triangle_option.png"

8288

ALT=">" BORDER=0 height=14

8289

width=15><b><font face="Helvetica, Arial"

8290

><font color="#FFFFFF"><font size="+1">

8291

<a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i>

8292

</font></font></font></b></td></tr></table>

8293

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>

8294

8295

<tr>

8296

8297

8298

<img SRC="../images/right_triangle_option.png"

8299

ALT=">" BORDER=0 height=14

8300

width=15><b><font face="Helvetica, Arial"

8301

><font color="#FFFFFF"><font size="+1">

8302

<a href="GraphicsMagick.html#details-contrast">-contrast</a>

8303

</font></font></font></b></td></tr></table>

8304

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table>

8305

8306

<tr>

8307

8308

8309

<img SRC="../images/right_triangle_option.png"

8310

ALT=">" BORDER=0 height=14

8311

width=15><b><font face="Helvetica, Arial"

8312

><font color="#FFFFFF"><font size="+1">

8313

8314

</font></font></font></b></td></tr></table>

8315

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

8316

8317

<tr>

8318

8319

8320

<img SRC="../images/right_triangle_option.png"

8321

ALT=">" BORDER=0 height=14

8322

width=15><b><font face="Helvetica, Arial"

8323

><font color="#FFFFFF"><font size="+1">

8324

-debug <i><events></i>

8325

</font></font></font></b></td></tr></table>

8326

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

8327

8328

<tr>

8329

8330

8331

<img SRC="../images/right_triangle_option.png"

8332

ALT=">" BORDER=0 height=14

8333

width=15><b><font face="Helvetica, Arial"

8334

><font color="#FFFFFF"><font size="+1">

8335

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

8336

</font></font></font></b></td></tr></table>

8337

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

8338

8339

<tr>

8340

8341

8342

<img SRC="../images/right_triangle_option.png"

8343

ALT=">" BORDER=0 height=14

8344

width=15><b><font face="Helvetica, Arial"

8345

><font color="#FFFFFF"><font size="+1">

8346

<a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i>

8347

</font></font></font></b></td></tr></table>

8348

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>

8349

8350

<tr>

8351

8352

8353

<img SRC="../images/right_triangle_option.png"

8354

ALT=">" BORDER=0 height=14

8355

width=15><b><font face="Helvetica, Arial"

8356

><font color="#FFFFFF"><font size="+1">

8357

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

8358

</font></font></font></b></td></tr></table>

8359

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

8360

8361

<tr>

8362

8363

8364

<img SRC="../images/right_triangle_option.png"

8365

ALT=">" BORDER=0 height=14

8366

width=15><b><font face="Helvetica, Arial"

8367

><font color="#FFFFFF"><font size="+1">

8368

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

8369

</font></font></font></b></td></tr></table>

8370

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

8371

8372

<tr>

8373

8374

8375

<img SRC="../images/right_triangle_option.png"

8376

ALT=">" BORDER=0 height=14

8377

width=15><b><font face="Helvetica, Arial"

8378

><font color="#FFFFFF"><font size="+1">

8379

-despeckle

8380

</font></font></font></b></td></tr></table>

8381

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table>

8382

8383

<tr>

8384

8385

8386

<img SRC="../images/right_triangle_option.png"

8387

ALT=">" BORDER=0 height=14

8388

width=15><b><font face="Helvetica, Arial"

8389

><font color="#FFFFFF"><font size="+1">

8390

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

8391

</font></font></font></b></td></tr></table>

8392

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

8393

8394

<tr>

8395

8396

8397

<img SRC="../images/right_triangle_option.png"

8398

ALT=">" BORDER=0 height=14

8399

width=15><b><font face="Helvetica, Arial"

8400

><font color="#FFFFFF"><font size="+1">

8401

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

8402

</font></font></font></b></td></tr></table>

8403

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

8404

8405

<tr>

8406

8407

8408

<img SRC="../images/right_triangle_option.png"

8409

ALT=">" BORDER=0 height=14

8410

width=15><b><font face="Helvetica, Arial"

8411

><font color="#FFFFFF"><font size="+1">

8412

<a href="GraphicsMagick.html#details-dither">-dither</a>

8413

</font></font></font></b></td></tr></table>

8414

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

8415

8416

<tr>

8417

8418

8419

<img SRC="../images/right_triangle_option.png"

8420

ALT=">" BORDER=0 height=14

8421

width=15><b><font face="Helvetica, Arial"

8422

><font color="#FFFFFF"><font size="+1">

8423

-edge <i><radius></i>

8424

</font></font></font></b></td></tr></table>

8425

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table>

8426

8427

<tr>

8428

8429

8430

<img SRC="../images/right_triangle_option.png"

8431

ALT=">" BORDER=0 height=14

8432

width=15><b><font face="Helvetica, Arial"

8433

><font color="#FFFFFF"><font size="+1">

8434

<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>

8435

</font></font></font></b></td></tr></table>

8436

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

8437

8438

<tr>

8439

8440

8441

<img SRC="../images/right_triangle_option.png"

8442

ALT=">" BORDER=0 height=14

8443

width=15><b><font face="Helvetica, Arial"

8444

><font color="#FFFFFF"><font size="+1">

8445

-enhance

8446

</font></font></font></b></td></tr></table>

8447

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table>

8448

8449

<tr>

8450

8451

8452

<img SRC="../images/right_triangle_option.png"

8453

ALT=">" BORDER=0 height=14

8454

width=15><b><font face="Helvetica, Arial"

8455

><font color="#FFFFFF"><font size="+1">

8456

<a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i>

8457

</font></font></font></b></td></tr></table>

8458

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>

8459

8460

<tr>

8461

8462

8463

<img SRC="../images/right_triangle_option.png"

8464

ALT=">" BORDER=0 height=14

8465

width=15><b><font face="Helvetica, Arial"

8466

><font color="#FFFFFF"><font size="+1">

8467

8468

</font></font></font></b></td></tr></table>

8469

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

8470

8471

<tr>

8472

8473

8474

<img SRC="../images/right_triangle_option.png"

8475

ALT=">" BORDER=0 height=14

8476

width=15><b><font face="Helvetica, Arial"

8477

><font color="#FFFFFF"><font size="+1">

8478

8479

</font></font></font></b></td></tr></table>

8480

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

8481

8482

<tr>

8483

8484

8485

<img SRC="../images/right_triangle_option.png"

8486

ALT=">" BORDER=0 height=14

8487

width=15><b><font face="Helvetica, Arial"

8488

><font color="#FFFFFF"><font size="+1">

8489

8490

</font></font></font></b></td></tr></table>

8491

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

8492

8493

<tr>

8494

8495

8496

<img SRC="../images/right_triangle_option.png"

8497

ALT=">" BORDER=0 height=14

8498

width=15><b><font face="Helvetica, Arial"

8499

><font color="#FFFFFF"><font size="+1">

8500

<a href="GraphicsMagick.html#details-foreground">-foreground</a> <i><color></i>

8501

</font></font></font></b></td></tr></table>

8502

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table>

8503

8504

<tr>

8505

8506

8507

<img SRC="../images/right_triangle_option.png"

8508

ALT=">" BORDER=0 height=14

8509

width=15><b><font face="Helvetica, Arial"

8510

><font color="#FFFFFF"><font size="+1">

8511

<a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i>

8512

</font></font></font></b></td></tr></table>

8513

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table>

8514

8515

<tr>

8516

8517

8518

<img SRC="../images/right_triangle_option.png"

8519

ALT=">" BORDER=0 height=14

8520

width=15><b><font face="Helvetica, Arial"

8521

><font color="#FFFFFF"><font size="+1">

8522

<a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i>

8523

</font></font></font></b></td></tr></table>

8524

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>

8525

8526

<tr>

8527

8528

8529

<img SRC="../images/right_triangle_option.png"

8530

ALT=">" BORDER=0 height=14

8531

width=15><b><font face="Helvetica, Arial"

8532

><font color="#FFFFFF"><font size="+1">

8533

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

8534

</font></font></font></b></td></tr></table>

8535

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

8536

8537

<tr>

8538

8539

8540

<img SRC="../images/right_triangle_option.png"

8541

ALT=">" BORDER=0 height=14

8542

width=15><b><font face="Helvetica, Arial"

8543

><font color="#FFFFFF"><font size="+1">

8544

-help

8545

</font></font></font></b></td></tr></table>

8546

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

8547

8548

<tr>

8549

8550

8551

<img SRC="../images/right_triangle_option.png"

8552

ALT=">" BORDER=0 height=14

8553

width=15><b><font face="Helvetica, Arial"

8554

><font color="#FFFFFF"><font size="+1">

8555

<a href="GraphicsMagick.html#details-iconGeometry">-iconGeometry</a> <i><geometry></i>

8556

</font></font></font></b></td></tr></table>

8557

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table>

8558

8559

<tr>

8560

8561

8562

<img SRC="../images/right_triangle_option.png"

8563

ALT=">" BORDER=0 height=14

8564

width=15><b><font face="Helvetica, Arial"

8565

><font color="#FFFFFF"><font size="+1">

8566

-iconic

8567

</font></font></font></b></td></tr></table>

8568

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>iconic animation</td></tr></table>

8569

8570

<tr>

8571

8572

8573

<img SRC="../images/right_triangle_option.png"

8574

ALT=">" BORDER=0 height=14

8575

width=15><b><font face="Helvetica, Arial"

8576

><font color="#FFFFFF"><font size="+1">

8577

-immutable

8578

</font></font></font></b></td></tr></table>

8579

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image immutable</td></tr></table>

8580

8581

<tr>

8582

8583

8584

<img SRC="../images/right_triangle_option.png"

8585

ALT=">" BORDER=0 height=14

8586

width=15><b><font face="Helvetica, Arial"

8587

><font color="#FFFFFF"><font size="+1">

8588

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

8589

</font></font></font></b></td></tr></table>

8590

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

8591

8592

<tr>

8593

8594

8595

<img SRC="../images/right_triangle_option.png"

8596

ALT=">" BORDER=0 height=14

8597

width=15><b><font face="Helvetica, Arial"

8598

><font color="#FFFFFF"><font size="+1">

8599

<a href="GraphicsMagick.html#details-label">-label</a> <i><name></i>

8600

</font></font></font></b></td></tr></table>

8601

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

8602

8603

<tr>

8604

8605

8606

<img SRC="../images/right_triangle_option.png"

8607

ALT=">" BORDER=0 height=14

8608

width=15><b><font face="Helvetica, Arial"

8609

><font color="#FFFFFF"><font size="+1">

8610

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

8611

</font></font></font></b></td></tr></table>

8612

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

8613

8614

<tr>

8615

8616

8617

<img SRC="../images/right_triangle_option.png"

8618

ALT=">" BORDER=0 height=14

8619

width=15><b><font face="Helvetica, Arial"

8620

><font color="#FFFFFF"><font size="+1">

8621

8622

</font></font></font></b></td></tr></table>

8623

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

8624

8625

<tr>

8626

8627

8628

<img SRC="../images/right_triangle_option.png"

8629

ALT=">" BORDER=0 height=14

8630

width=15><b><font face="Helvetica, Arial"

8631

><font color="#FFFFFF"><font size="+1">

8632

-magnify <i><factor></i>

8633

</font></font></font></b></td></tr></table>

8634

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>magnify the image</td></tr></table>

8635

8636

<tr>

8637

8638

8639

<img SRC="../images/right_triangle_option.png"

8640

ALT=">" BORDER=0 height=14

8641

width=15><b><font face="Helvetica, Arial"

8642

><font color="#FFFFFF"><font size="+1">

8643

8644

</font></font></font></b></td></tr></table>

8645

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table>

8646

8647

<tr>

8648

8649

8650

<img SRC="../images/right_triangle_option.png"

8651

ALT=">" BORDER=0 height=14

8652

width=15><b><font face="Helvetica, Arial"

8653

><font color="#FFFFFF"><font size="+1">

8654

<a href="GraphicsMagick.html#details-matte">-matte</a>

8655

</font></font></font></b></td></tr></table>

8656

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

8657

8658

<tr>

8659

8660

8661

<img SRC="../images/right_triangle_option.png"

8662

ALT=">" BORDER=0 height=14

8663

width=15><b><font face="Helvetica, Arial"

8664

><font color="#FFFFFF"><font size="+1">

8665

<a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i>

8666

</font></font></font></b></td></tr></table>

8667

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>

8668

8669

<tr>

8670

8671

8672

<img SRC="../images/right_triangle_option.png"

8673

ALT=">" BORDER=0 height=14

8674

width=15><b><font face="Helvetica, Arial"

8675

><font color="#FFFFFF"><font size="+1">

8676

-monochrome

8677

</font></font></font></b></td></tr></table>

8678

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

8679

8680

<tr>

8681

8682

8683

<img SRC="../images/right_triangle_option.png"

8684

ALT=">" BORDER=0 height=14

8685

width=15><b><font face="Helvetica, Arial"

8686

><font color="#FFFFFF"><font size="+1">

8687

-name

8688

</font></font></font></b></td></tr></table>

8689

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name an image</td></tr></table>

8690

8691

<tr>

8692

8693

8694

<img SRC="../images/right_triangle_option.png"

8695

ALT=">" BORDER=0 height=14

8696

width=15><b><font face="Helvetica, Arial"

8697

><font color="#FFFFFF"><font size="+1">

8698

<a href="GraphicsMagick.html#details-negate">-negate</a>

8699

</font></font></font></b></td></tr></table>

8700

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>

8701

8702

<tr>

8703

8704

8705

<img SRC="../images/right_triangle_option.png"

8706

ALT=">" BORDER=0 height=14

8707

width=15><b><font face="Helvetica, Arial"

8708

><font color="#FFFFFF"><font size="+1">

8709

8710

</font></font></font></b></td></tr></table>

8711

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>

8712

8713

<tr>

8714

8715

8716

<img SRC="../images/right_triangle_option.png"

8717

ALT=">" BORDER=0 height=14

8718

width=15><b><font face="Helvetica, Arial"

8719

><font color="#FFFFFF"><font size="+1">

8720

8721

</font></font></font></b></td></tr></table>

8722

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

8723

8724

<tr>

8725

8726

8727

<img SRC="../images/right_triangle_option.png"

8728

ALT=">" BORDER=0 height=14

8729

width=15><b><font face="Helvetica, Arial"

8730

><font color="#FFFFFF"><font size="+1">

8731

<a href="GraphicsMagick.html#details+progress">+progress</a>

8732

</font></font></font></b></td></tr></table>

8733

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>disable progress monitor and busy cursor</td></tr></table>

8734

8735

<tr>

8736

8737

8738

<img SRC="../images/right_triangle_option.png"

8739

ALT=">" BORDER=0 height=14

8740

width=15><b><font face="Helvetica, Arial"

8741

><font color="#FFFFFF"><font size="+1">

8742

<a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i>

8743

</font></font></font></b></td></tr></table>

8744

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

8745

8746

<tr>

8747

8748

8749

<img SRC="../images/right_triangle_option.png"

8750

ALT=">" BORDER=0 height=14

8751

width=15><b><font face="Helvetica, Arial"

8752

><font color="#FFFFFF"><font size="+1">

8753

<a href="GraphicsMagick.html#details-raise">-raise</a> <i><width>x<height></i>

8754

</font></font></font></b></td></tr></table>

8755

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table>

8756

8757

<tr>

8758

8759

8760

<img SRC="../images/right_triangle_option.png"

8761

ALT=">" BORDER=0 height=14

8762

width=15><b><font face="Helvetica, Arial"

8763

><font color="#FFFFFF"><font size="+1">

8764

<a href="GraphicsMagick.html#details-remote">-remote</a>

8765

</font></font></font></b></td></tr></table>

8766

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table>

8767

8768

<tr>

8769

8770

8771

<img SRC="../images/right_triangle_option.png"

8772

ALT=">" BORDER=0 height=14

8773

width=15><b><font face="Helvetica, Arial"

8774

><font color="#FFFFFF"><font size="+1">

8775

8776

</font></font></font></b></td></tr></table>

8777

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table>

8778

8779

<tr>

8780

8781

8782

<img SRC="../images/right_triangle_option.png"

8783

ALT=">" BORDER=0 height=14

8784

width=15><b><font face="Helvetica, Arial"

8785

><font color="#FFFFFF"><font size="+1">

8786

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

8787

</font></font></font></b></td></tr></table>

8788

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

8789

8790

<tr>

8791

8792

8793

<img SRC="../images/right_triangle_option.png"

8794

ALT=">" BORDER=0 height=14

8795

width=15><b><font face="Helvetica, Arial"

8796

><font color="#FFFFFF"><font size="+1">

8797

<a href="GraphicsMagick.html#details-sample">-sample</a> <i><geometry></i>

8798

</font></font></font></b></td></tr></table>

8799

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table>

8800

8801

<tr>

8802

8803

8804

<img SRC="../images/right_triangle_option.png"

8805

ALT=">" BORDER=0 height=14

8806

width=15><b><font face="Helvetica, Arial"

8807

><font color="#FFFFFF"><font size="+1">

8808

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

8809

</font></font></font></b></td></tr></table>

8810

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

8811

8812

<tr>

8813

8814

8815

<img SRC="../images/right_triangle_option.png"

8816

ALT=">" BORDER=0 height=14

8817

width=15><b><font face="Helvetica, Arial"

8818

><font color="#FFFFFF"><font size="+1">

8819

<a href="GraphicsMagick.html#details-scenes">-scenes</a> <i><value-value></i>

8820

</font></font></font></b></td></tr></table>

8821

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table>

8822

8823

<tr>

8824

8825

8826

<img SRC="../images/right_triangle_option.png"

8827

ALT=">" BORDER=0 height=14

8828

width=15><b><font face="Helvetica, Arial"

8829

><font color="#FFFFFF"><font size="+1">

8830

<a href="GraphicsMagick.html#details-segment">-segment</a> <i><cluster threshold>x<smoothing threshold></i>

8831

</font></font></font></b></td></tr></table>

8832

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table>

8833

8834

<tr>

8835

8836

8837

<img SRC="../images/right_triangle_option.png"

8838

ALT=">" BORDER=0 height=14

8839

width=15><b><font face="Helvetica, Arial"

8840

><font color="#FFFFFF"><font size="+1">

8841

<a href="GraphicsMagick.html#details-shared-memory">-shared-memory</a>

8842

</font></font></font></b></td></tr></table>

8843

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use shared memory</td></tr></table>

8844

8845

<tr>

8846

8847

8848

<img SRC="../images/right_triangle_option.png"

8849

ALT=">" BORDER=0 height=14

8850

width=15><b><font face="Helvetica, Arial"

8851

><font color="#FFFFFF"><font size="+1">

8852

<a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

8853

</font></font></font></b></td></tr></table>

8854

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>

8855

8856

<tr>

8857

8858

8859

<img SRC="../images/right_triangle_option.png"

8860

ALT=">" BORDER=0 height=14

8861

width=15><b><font face="Helvetica, Arial"

8862

><font color="#FFFFFF"><font size="+1">

8863

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

8864

</font></font></font></b></td></tr></table>

8865

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

8866

8867

<tr>

8868

8869

8870

<img SRC="../images/right_triangle_option.png"

8871

ALT=">" BORDER=0 height=14

8872

width=15><b><font face="Helvetica, Arial"

8873

><font color="#FFFFFF"><font size="+1">

8874

8875

</font></font></font></b></td></tr></table>

8876

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table>

8877

8878

<tr>

8879

8880

8881

<img SRC="../images/right_triangle_option.png"

8882

ALT=">" BORDER=0 height=14

8883

width=15><b><font face="Helvetica, Arial"

8884

><font color="#FFFFFF"><font size="+1">

8885

-texture <i><filename></i>

8886

</font></font></font></b></td></tr></table>

8887

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table>

8888

8889

<tr>

8890

8891

8892

<img SRC="../images/right_triangle_option.png"

8893

ALT=">" BORDER=0 height=14

8894

width=15><b><font face="Helvetica, Arial"

8895

><font color="#FFFFFF"><font size="+1">

8896

<a href="GraphicsMagick.html#details-title">-title</a> <i><string></i>

8897

</font></font></font></b></td></tr></table>

8898

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table>

8899

8900

<tr>

8901

8902

8903

<img SRC="../images/right_triangle_option.png"

8904

ALT=">" BORDER=0 height=14

8905

width=15><b><font face="Helvetica, Arial"

8906

><font color="#FFFFFF"><font size="+1">

8907

<a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i>

8908

</font></font></font></b></td></tr></table>

8909

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

8910

8911

<tr>

8912

8913

8914

<img SRC="../images/right_triangle_option.png"

8915

ALT=">" BORDER=0 height=14

8916

width=15><b><font face="Helvetica, Arial"

8917

><font color="#FFFFFF"><font size="+1">

8918

8919

</font></font></font></b></td></tr></table>

8920

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

8921

8922

<tr>

8923

8924

8925

<img SRC="../images/right_triangle_option.png"

8926

ALT=">" BORDER=0 height=14

8927

width=15><b><font face="Helvetica, Arial"

8928

><font color="#FFFFFF"><font size="+1">

8929

<a href="GraphicsMagick.html#details-update">-update</a> <i><seconds></i>

8930

</font></font></font></b></td></tr></table>

8931

8932

detect when image file is modified and redisplay.</td></tr></table>

8933

8934

<tr>

8935

8936

8937

<img SRC="../images/right_triangle_option.png"

8938

ALT=">" BORDER=0 height=14

8939

width=15><b><font face="Helvetica, Arial"

8940

><font color="#FFFFFF"><font size="+1">

8941

-use-pixmap

8942

</font></font></font></b></td></tr></table>

8943

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table>

8944

8945

<tr>

8946

8947

8948

<img SRC="../images/right_triangle_option.png"

8949

ALT=">" BORDER=0 height=14

8950

width=15><b><font face="Helvetica, Arial"

8951

><font color="#FFFFFF"><font size="+1">

8952

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

8953

</font></font></font></b></td></tr></table>

8954

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

8955

8956

<tr>

8957

8958

8959

<img SRC="../images/right_triangle_option.png"

8960

ALT=">" BORDER=0 height=14

8961

width=15><b><font face="Helvetica, Arial"

8962

><font color="#FFFFFF"><font size="+1">

8963

<a href="GraphicsMagick.html#details-version">-version</a>

8964

</font></font></font></b></td></tr></table>

8965

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

8966

8967

<tr>

8968

8969

8970

<img SRC="../images/right_triangle_option.png"

8971

ALT=">" BORDER=0 height=14

8972

width=15><b><font face="Helvetica, Arial"

8973

><font color="#FFFFFF"><font size="+1">

8974

<a href="GraphicsMagick.html#details-visual">-visual</a> <i><type></i>

8975

</font></font></font></b></td></tr></table>

8976

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table>

8977

8978

<tr>

8979

8980

8981

<img SRC="../images/right_triangle_option.png"

8982

ALT=">" BORDER=0 height=14

8983

width=15><b><font face="Helvetica, Arial"

8984

><font color="#FFFFFF"><font size="+1">

8985

<a href="GraphicsMagick.html#details-window">-window</a> <i><id></i>

8986

</font></font></font></b></td></tr></table>

8987

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table>

8988

8989

<tr>

8990

8991

8992

<img SRC="../images/right_triangle_option.png"

8993

ALT=">" BORDER=0 height=14

8994

width=15><b><font face="Helvetica, Arial"

8995

><font color="#FFFFFF"><font size="+1">

8996

-window-group

8997

</font></font></font></b></td></tr></table>

8998

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the window group</td></tr></table>

8999

9000

<tr>

9001

9002

9003

<img SRC="../images/right_triangle_option.png"

9004

ALT=">" BORDER=0 height=14

9005

width=15><b><font face="Helvetica, Arial"

9006

><font color="#FFFFFF"><font size="+1">

9007

<a href="GraphicsMagick.html#details-write">-write</a> <i><filename></i>

9008

</font></font></font></b></td></tr></table>

9009

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>write the image to a file [<em>display</em>]</td></tr></table>

9010

<p>

9011

For a more detailed description of each option, see

9012

Options, above.

9013

9014

</td></tr></table>

9015

<p>

9016

<i><a href="#top">Back to Contents</a></i>

9017

 </p>

9018

9019

<tr>

9020

<td ALIGN=LEFT bgcolor="#52799E"><img

9021

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9022

height=14 width=15><b><font face="Helvetica, Arial"><font

9023

color="#FFFFFF"><font size="+1">

9024

<a NAME="disp-mous"></a>Mouse Buttons

9025

</font></font></font></b></td></tr></table>

9026

9027

9028

<p>

9029

The effects of each button press is described below. Three buttons are

9030

required. If you have a two button mouse, button 1 and 3 are returned.

9031

Press <strong>ALT</strong> and button 3 to simulate button 2.

9032

9033

<tr>

9034

9035

9036

<img SRC="../images/right_triangle_option.png"

9037

ALT=">" BORDER=0 height=14

9038

width=15><b><font face="Helvetica, Arial"

9039

><font color="#FFFFFF"><font size="+1">

9040

1

9041

</font></font></font></b></td></tr></table>

9042

9043

Press this button to map or unmap the <a href="#disp-comm">Command

9044

widget</a> . See the next section for more information about the Command

9045

widget.</td></tr></table>

9046

9047

<tr>

9048

9049

9050

<img SRC="../images/right_triangle_option.png"

9051

ALT=">" BORDER=0 height=14

9052

width=15><b><font face="Helvetica, Arial"

9053

><font color="#FFFFFF"><font size="+1">

9054

2

9055

</font></font></font></b></td></tr></table>

9056

9057

Press and drag to define a region of the image to magnify.</td></tr></table>

9058

9059

<tr>

9060

9061

9062

<img SRC="../images/right_triangle_option.png"

9063

ALT=">" BORDER=0 height=14

9064

width=15><b><font face="Helvetica, Arial"

9065

><font color="#FFFFFF"><font size="+1">

9066

3

9067

</font></font></font></b></td></tr></table>

9068

9069

Press and drag to choose from a select set of <strong>display(1)</strong>

9070

commands. This button behaves differently if the image being displayed

9071

is a visual image directory. Choose a particular tile of the directory

9072

and press this button and drag to select a command from a pop-up menu.

9073

Choose from these menu items:</td></tr></table>

9074

<ul>

9075

<li>Open

9076

<li>Next

9077

<li>Former

9078

<li>Delete

9079

<li>Update

9080

</ul>

9081

<p>

9082

If you choose <strong>Open</strong>, the image represented by the tile is displayed.

9083

To return to the visual image directory, choose <strong>Next</strong> from the Command

9084

widget (refer to <a href="#disp-comm">Command Widget</a>).

9085

<strong>Next</strong> and <strong>Former</strong>

9086

moves to the next or former image respectively. Choose <strong>Delete</strong> to

9087

delete a particular image tile. Finally, choose <strong>Update</strong> to synchronize

9088

all the image tiles with their respective images. See

9089

<a href="montage.html">montage</a>

9090

and

9091

<a href="miff.html">miff</a> for more details.

9092

</td></tr></table>

9093

<p>

9094

<i><a href="#top">Back to Contents</a></i>

9095

 </p>

9096

9097

<tr>

9098

<td ALIGN=LEFT bgcolor="#52799E"><img

9099

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9100

height=14 width=15><b><font face="Helvetica, Arial"><font

9101

color="#FFFFFF"><font size="+1">

9102

<a NAME="disp-comm"></a>Command Widget

9103

</font></font></font></b></td></tr></table>

9104

9105

9106

<p>

9107

The Command widget lists a number of sub-menus and commands. They are

9108

<ul>

9109

9110

<ul>

9111

<li>Open...

9112

<li>Next

9113

<li>Former

9114

<li>Select...

9115

<li>Save...

9116

<li>Print...

9117

<li>Delete...

9118

<li>Canvas...

9119

<li>Visual Directory...

9120

<li>Quit

9121

</ul>

9122

</ul>

9123

<ul>

9124

9125

<ul>

9126

<li>Undo

9127

<li>Redo

9128

<li>Cut

9129

<li>Copy

9130

<li>Paste

9131

</ul>

9132

</ul>

9133

<ul>

9134

9135

<ul>

9136

<li>Half Size

9137

<li>Original Size

9138

<li>Double Size

9139

<li>Resize...

9140

<li>Apply

9141

<li>Refresh

9142

<li>Restore

9143

</ul>

9144

</ul>

9145

<ul>

9146

<li><strong>Transform</strong>

9147

<ul>

9148

<li>Crop

9149

<li>Chop

9150

<li>Flop

9151

<li>Flip

9152

<li>Rotate Right

9153

<li>Rotate Left

9154

<li>Rotate...

9155

<li>Shear...

9156

<li>Roll...

9157

<li>Trim Edges

9158

</ul>

9159

</ul>

9160

<ul>

9161

<li><strong>Enhance</strong>

9162

<ul>

9163

<li>Hue...

9164

<li>Saturation...

9165

<li>Brightness...

9166

<li>Gamma...

9167

<li>Spiff...

9168

<li>Dull

9169

<li>Equalize

9170

<li>Normalize

9171

<li>Negate

9172

<li>GRAYscale

9173

<li>Quantize...

9174

</ul>

9175

</ul>

9176

<ul>

9177

<li><strong>Effects</strong>

9178

<ul>

9179

<li>Despeckle

9180

<li>Emboss

9181

<li>Reduce Noise

9182

<li>Add Noise

9183

<li>Sharpen...

9184

<li>Blur...

9185

<li>Threshold...

9186

<li>Edge Detect...

9187

<li>Spread...

9188

<li>Shade...

9189

<li>Raise...

9190

<li>Segment...

9191

</ul>

9192

</ul>

9193

<ul>

9194

9195

<ul>

9196

<li>Solarize...

9197

<li>Swirl...

9198

<li>Implode...

9199

<li>Wave...

9200

<li>Oil Paint...

9201

<li>Charcoal Draw...

9202

</ul>

9203

</ul>

9204

<ul>

9205

<li><strong>Image Edit</strong>

9206

<ul>

9207

<li>Annotate...

9208

<li>Draw...

9209

<li>Color...

9210

<li>Matte...

9211

<li>Composite...

9212

<li>Add Border...

9213

<li>Add Frame...

9214

<li>Comment...

9215

<li>Launch...

9216

<li>Region of Interest...

9217

</ul>

9218

</ul>

9219

<ul>

9220

<li><strong>Miscellany</strong>

9221

<ul>

9222

<li>Image Info

9223

<li>Zoom Image

9224

<li>Show Preview...

9225

<li>Show Histogram

9226

<li>Show Matte

9227

<li>Background...

9228

<li>Slide Show

9229

<li>Preferences...

9230

</ul>

9231

</ul>

9232

<ul>

9233

9234

<ul>

9235

<li>Overview

9236

<li>Browse Documentation

9237

<li>About Display

9238

</ul>

9239

</ul>

9240

<p>

9241

Menu items with a indented triangle have a sub-menu. They are represented

9242

above as the indented items. To access a sub-menu item, move the pointer

9243

to the appropriate menu and press button 1 and drag. When you find the

9244

desired sub-menu item, release the button and the command is executed.

9245

Move the pointer away from the sub-menu if you decide not to execute a

9246

particular command.

9247

</td></tr></table>

9248

<p>

9249

<i><a href="#top">Back to Contents</a></i>

9250

 </p>

9251

9252

<tr>

9253

<td ALIGN=LEFT bgcolor="#52799E"><img

9254

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9255

height=14 width=15><b><font face="Helvetica, Arial"><font

9256

color="#FFFFFF"><font size="+1">

9257

<a NAME="disp-keyb"></a>Keyboard Accelerators

9258

</font></font></font></b></td></tr></table>

9259

9260

9261

<p>

9262

Accelerators are one or two key presses that effect a particular command.

9263

The keyboard accelerators that

9264

<strong>display</strong> understands is:

9265

<pre>

9266

Ctl+O Press to <a href="#disp-imlo">load</a> an image from a file.

9267

space Press to display the next image.

9268

</pre>

9269

<p>

9270

If the image is a multi-paged document such as a

9271

<em>PostScript</em> document,

9272

you can skip ahead several pages by preceding this command with a number.

9273

For example to display the fourth page beyond the current page,

9274

press <tt>4space</tt>.

9275

<pre>

9276

backspace Press to display the former image.

9277

</pre>

9278

<p>

9279

If the image is a multi-paged document such as a

9280

<em>PostScript</em> document,

9281

you can skip behind several pages by preceding this command with a number.

9282

For example to display the fourth page preceding the current page, press

9283

4n.

9284

<pre>

9285

Ctl-S Press to save the image to a file.

9286

Ctl-P Press to print the image to a

9287

<em>PostScript</em> printer.

9288

Ctl-D Press to delete an image file.

9289

Ctl-N Press to create a blank canvas.

9290

Ctl-Q Press to discard all images and exit program.

9291

Ctl+Z Press to undo last image transformation.

9292

Ctl+R Press to redo last image transformation.

9293

Ctl-X Press to <a href="#disp-imcu">cut</a> a region of

9294

the image.

9295

Ctl-C Press to <a href="#disp-imco">copy</a> a region of

9296

the image.

9297

Ctl-V Press to <a href="#disp-impa">paste</a> a region to

9298

the image.

9299

< Press to halve the image size.

9300

. Press to return to the original image size.

9301

> Press to double the image size.

9302

% Press to resize the image to a width and height

9303

you specify.

9304

Cmd-A Press to make any image transformations

9305

permanent.

9306

By default, any image size transformations are

9307

applied to the original image to create the

9308

image displayed on the X server. However, the

9309

transformations are not permanent (i.e. the

9310

original image does not change size only the

9311

X image does). For example, if you press ">"

9312

the X image will appear to double in size, but

9313

the original image will in fact remain the same

9314

size. To force the original image to double in

9315

size, press ">" followed by "Cmd-A".

9316

@ Press to refresh the image window.

9317

C Press to <a href="#disp-imcr">crop</a> the image.

9318

[ Press to <a href="#disp-imch">chop</a> the image.

9319

H Press to flop image in the horizontal direction.

9320

V Press to flip image in the vertical direction.

9321

/ Press to rotate the image 90 degrees clockwise.

9322

\ Press to rotate the image 90 degrees

9323

counter-clockwise.

9324

* Press to <a href="#disp-imro">rotate</a> the image

9325

the number of degrees you specify.

9326

S Press to shear the image the number of degrees

9327

you specify.

9328

R Press to roll the image.

9329

T Press to trim the image edges.

9330

Shft-H Press to vary the color hue.

9331

Shft-S Press to vary the color saturation.

9332

Shft-L Press to vary the image brightness.

9333

Shft-G Press to gamma correct the image.

9334

Shft-C Press to spiff up the image contrast.

9335

Shft-Z Press to dull the image contrast.

9336

= Press to perform histogram equalization on

9337

the image.

9338

Shft-N Press to perform histogram normalization on

9339

the image.

9340

Shft-~ Press to negate the colors of the image.

9341

. Press to convert the image colors to gray.

9342

Shft-# Press to set the maximum number of unique

9343

colors in the image.

9344

F2 Press to reduce the speckles in an image.

9345

F2 Press to emboss an image.

9346

F4 Press to eliminate peak noise from an image.

9347

F5 Press to add noise to an image.

9348

F6 Press to sharpen an image.

9349

F7 Press to blur image an image.

9350

F8 Press to threshold the image.

9351

F9 Press to detect edges within an image.

9352

F10 Press to displace pixels by a random amount.

9353

F11 Press to shade the image using a distant light

9354

source.

9355

F12 Press to lighten or darken image edges to

9356

create a 3-D effect.

9357

F13 Press to segment the image by color.

9358

Meta-S Press to swirl image pixels about the center.

9359

Meta-I Press to implode image pixels about the center.

9360

Meta-W Press to alter an image along a sine wave.

9361

Meta-P Press to simulate an oil painting.

9362

Meta-C Press to simulate a charcoal drawing.

9363

Alt-X Press to <a href="#disp-imcomp">composite</a> the image

9364

with another.

9365

Alt-A Press to <a href="#disp-iman">annotate</a> the image with text.

9366

Alt-D Press to <a href="#disp-imdr">draw</a> a line on the image.

9367

Alt-P Press to <a href="#disp-cole">edit an image pixel color</a>.

9368

Alt-M Press to <a href="#disp-matt">edit the image matte</a> information.

9369

Alt-X Press to <a href="#disp-imcomp">composite</a> the image with another.

9370

Alt-A Press to add a border to the image.

9371

Alt-F Press to add a ornamental frame to the image.

9372

Alt-Shft-! Press to add an image comment.

9373

Ctl-A Press to apply image processing techniques to a

9374

region of interest.

9375

Shft-? Press to display information about the image.

9376

Shft-+ Press to map the zoom image window.

9377

Shft-P Press to preview an image enhancement, effect,

9378

or f/x.

9379

F1 Press to display helpful information about

9380

the "display" utility.

9381

Find Press to browse documentation about

9382

GraphicsMagick.

9383

1-9 Press to change the level of magnification.

9384

</pre>

9385

<p>

9386

Use the arrow keys to move the image one pixel up, down, left, or right

9387

within the magnify window. Be sure to first map the magnify window by pressing

9388

button 2.

9389

<p>

9390

Press ALT and one of the arrow keys to trim off one pixel from any side

9391

of the image.

9392

</td></tr></table>

9393

<p>

9394

<i><a href="#top">Back to Contents</a></i>

9395

 </p>

9396

9397

<tr>

9398

<td ALIGN=LEFT bgcolor="#52799E"><img

9399

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9400

height=14 width=15><b><font face="Helvetica, Arial"><font

9401

color="#FFFFFF"><font size="+1">

9402

<a NAME="disp-xres"></a>X Resources

9403

</font></font></font></b></td></tr></table>

9404

9405

9406

<p>

9407

<strong>Display</strong> options can appear on the command line or in your X resource

9408

file. Options on the command line supersede values specified in your X

9409

resource file. See <em>X(1)</em> for more information on X resources.

9410

<p>

9411

Most <strong>display</strong> options have a corresponding X resource. In addition,

9412

<strong>display</strong>

9413

uses the following X resources:

9414

9415

<tr>

9416

9417

9418

<img SRC="../images/right_triangle_option.png"

9419

ALT=">" BORDER=0 height=14

9420

width=15><b><font face="Helvetica, Arial"

9421

><font color="#FFFFFF"><font size="+1">

9422

background <i>(class Background)</i>

9423

</font></font></font></b></td></tr></table>

9424

9425

Specifies the preferred color to use for the Image window background. The

9426

default is #ccc.</td></tr></table>

9427

9428

<tr>

9429

9430

9431

<img SRC="../images/right_triangle_option.png"

9432

ALT=">" BORDER=0 height=14

9433

width=15><b><font face="Helvetica, Arial"

9434

><font color="#FFFFFF"><font size="+1">

9435

borderColor <i>(class BorderColor)</i>

9436

</font></font></font></b></td></tr></table>

9437

9438

Specifies the preferred color to use for the Image window border. The default

9439

is #ccc.</td></tr></table>

9440

9441

<tr>

9442

9443

9444

<img SRC="../images/right_triangle_option.png"

9445

ALT=">" BORDER=0 height=14

9446

width=15><b><font face="Helvetica, Arial"

9447

><font color="#FFFFFF"><font size="+1">

9448

borderWidth <i>(class BorderWidth)</i>

9449

</font></font></font></b></td></tr></table>

9450

9451

Specifies the width in pixels of the image window border. The default is

9452

2.</td></tr></table>

9453

9454

<tr>

9455

9456

9457

<img SRC="../images/right_triangle_option.png"

9458

ALT=">" BORDER=0 height=14

9459

width=15><b><font face="Helvetica, Arial"

9460

><font color="#FFFFFF"><font size="+1">

9461

browseCommand <i>(class browseCommand)</i>

9462

</font></font></font></b></td></tr></table>

9463

9464

Specifies the name of the preferred browser when displaying GraphicsMagick

9465

documentation. The default is <tt>netscape %s</tt>.</td></tr></table>

9466

9467

<tr>

9468

9469

9470

<img SRC="../images/right_triangle_option.png"

9471

ALT=">" BORDER=0 height=14

9472

width=15><b><font face="Helvetica, Arial"

9473

><font color="#FFFFFF"><font size="+1">

9474

confirmExit <i>(class ConfirmExit)</i>

9475

</font></font></font></b></td></tr></table>

9476

9477

<strong>Display</strong> pops up a dialog box to confirm exiting the program when

9478

exiting the program. Set this resource to <tt>False</tt> to exit without

9479

a confirmation.</td></tr></table>

9480

9481

<tr>

9482

9483

9484

<img SRC="../images/right_triangle_option.png"

9485

ALT=">" BORDER=0 height=14

9486

width=15><b><font face="Helvetica, Arial"

9487

><font color="#FFFFFF"><font size="+1">

9488

displayGamma <i>(class DisplayGamma)</i>

9489

</font></font></font></b></td></tr></table>

9490

9491

Specifies the gamma of the X server.</td></tr></table>

9492

9493

You can apply separate gamma values to the red, green, and blue channels

9494

of the image with a gamma value list delineated with slashes (i.e. 1.7/2.3/1.2).</td></tr></table>

9495

9496

The default is 2.2.</td></tr></table>

9497

9498

<tr>

9499

9500

9501

<img SRC="../images/right_triangle_option.png"

9502

ALT=">" BORDER=0 height=14

9503

width=15><b><font face="Helvetica, Arial"

9504

><font color="#FFFFFF"><font size="+1">

9505

displayWarnings <i>(class DisplayWarnings)</i>

9506

</font></font></font></b></td></tr></table>

9507

9508

<strong>Display</strong> pops up a dialog box whenever a warning message occurs.

9509

Set this resource to <tt>False</tt> to ignore warning messages.</td></tr></table>

9510

9511

<tr>

9512

9513

9514

<img SRC="../images/right_triangle_option.png"

9515

ALT=">" BORDER=0 height=14

9516

width=15><b><font face="Helvetica, Arial"

9517

><font color="#FFFFFF"><font size="+1">

9518

font <i>(class FontList)</i>

9519

</font></font></font></b></td></tr></table>

9520

9521

Specifies the name of the preferred font to use in normal formatted text.

9522

The default is 14 point Helvetica.</td></tr></table>

9523

9524

<tr>

9525

9526

9527

<img SRC="../images/right_triangle_option.png"

9528

ALT=">" BORDER=0 height=14

9529

width=15><b><font face="Helvetica, Arial"

9530

><font color="#FFFFFF"><font size="+1">

9531

font[1-9] <i>(class Font[1-9])</i>

9532

</font></font></font></b></td></tr></table>

9533

9534

Specifies the name of the preferred font to use when

9535

<a href="#iman">annotating</a>

9536

the image window with text. The default fonts are fixed, variable, 5x8,

9537

6x10, 7x13bold, 8x13bold, 9x15bold, 10x20, and 12x24.</td></tr></table>

9538

9539

<tr>

9540

9541

9542

<img SRC="../images/right_triangle_option.png"

9543

ALT=">" BORDER=0 height=14

9544

width=15><b><font face="Helvetica, Arial"

9545

><font color="#FFFFFF"><font size="+1">

9546

foreground <i>(class Foreground)</i>

9547

</font></font></font></b></td></tr></table>

9548

9549

Specifies the preferred color to use for text within the image window.

9550

The default is black.</td></tr></table>

9551

9552

<tr>

9553

9554

9555

<img SRC="../images/right_triangle_option.png"

9556

ALT=">" BORDER=0 height=14

9557

width=15><b><font face="Helvetica, Arial"

9558

><font color="#FFFFFF"><font size="+1">

9559

gammaCorrect <i>(class gammaCorrect)</i>

9560

</font></font></font></b></td></tr></table>

9561

9562

This resource, if true, will lighten or darken an image of known gamma

9563

to match the gamma of the display (see resource <strong>displayGamma</strong>). The

9564

default is True.</td></tr></table>

9565

9566

<tr>

9567

9568

9569

<img SRC="../images/right_triangle_option.png"

9570

ALT=">" BORDER=0 height=14

9571

width=15><b><font face="Helvetica, Arial"

9572

><font color="#FFFFFF"><font size="+1">

9573

geometry <i>(class Geometry)</i>

9574

</font></font></font></b></td></tr></table>

9575

9576

Specifies the preferred size and position of the image window. It is not

9577

necessarily obeyed by all window managers.</td></tr></table>

9578

9579

Offsets, if present, are handled in <em>X(1)</em> style. A negative x offset is

9580

measured from the right edge of the screen to the right edge of the icon,

9581

and a negative y offset is measured from the bottom edge of the screen

9582

to the bottom edge of the icon.</font></td></tr></table>

9583

9584

<tr>

9585

9586

9587

<img SRC="../images/right_triangle_option.png"

9588

ALT=">" BORDER=0 height=14

9589

width=15><b><font face="Helvetica, Arial"

9590

><font color="#FFFFFF"><font size="+1">

9591

iconGeometry <i>(class IconGeometry)</i>

9592

</font></font></font></b></td></tr></table>

9593

9594

Specifies the preferred size and position of the application when iconified.

9595

It is not necessarily obeyed by all window managers.</td></tr></table>

9596

9597

Offsets, if present, are handled in the same manner as in class Geometry.</font></td></tr></table>

9598

9599

<tr>

9600

9601

9602

<img SRC="../images/right_triangle_option.png"

9603

ALT=">" BORDER=0 height=14

9604

width=15><b><font face="Helvetica, Arial"

9605

><font color="#FFFFFF"><font size="+1">

9606

iconic <i>(class Iconic)</i>

9607

</font></font></font></b></td></tr></table>

9608

9609

This resource indicates that you would prefer that the application's windows

9610

initially not be visible as if the windows had be immediately iconified

9611

by you. Window managers may choose not to honor the application's request.</td></tr></table>

9612

9613

<tr>

9614

9615

9616

<img SRC="../images/right_triangle_option.png"

9617

ALT=">" BORDER=0 height=14

9618

width=15><b><font face="Helvetica, Arial"

9619

><font color="#FFFFFF"><font size="+1">

9620

magnify <i>(class Magnify)</i>

9621

</font></font></font></b></td></tr></table>

9622

9623

specifies an integral factor by which the image should be enlarged. The

9624

default is 3.</td></tr></table>

9625

9626

This value only affects the magnification window which is invoked with

9627

<a href="#disp-mous">button</a>

9628

number 3 after the image is displayed.</td></tr></table>

9629

9630

<tr>

9631

9632

9633

<img SRC="../images/right_triangle_option.png"

9634

ALT=">" BORDER=0 height=14

9635

width=15><b><font face="Helvetica, Arial"

9636

><font color="#FFFFFF"><font size="+1">

9637

matteColor <i>(class MatteColor)</i>

9638

</font></font></font></b></td></tr></table>

9639

9640

Specify the color of windows. It is used for the backgrounds of windows,

9641

menus, and notices. A 3D effect is achieved by using highlight and shadow

9642

colors derived from this color. Default value: #697B8F.</td></tr></table>

9643

9644

<tr>

9645

9646

9647

<img SRC="../images/right_triangle_option.png"

9648

ALT=">" BORDER=0 height=14

9649

width=15><b><font face="Helvetica, Arial"

9650

><font color="#FFFFFF"><font size="+1">

9651

name <i>(class Name)</i>

9652

</font></font></font></b></td></tr></table>

9653

9654

This resource specifies the name under which resources for the application

9655

should be found. This resource is useful in shell aliases to distinguish

9656

between invocations of an application, without resorting to creating links

9657

to alter the executable file name. The default is the application name.</td></tr></table>

9658

9659

<tr>

9660

9661

9662

<img SRC="../images/right_triangle_option.png"

9663

ALT=">" BORDER=0 height=14

9664

width=15><b><font face="Helvetica, Arial"

9665

><font color="#FFFFFF"><font size="+1">

9666

pen[1-9] <i>(class Pen[1-9])</i>

9667

</font></font></font></b></td></tr></table>

9668

9669

Specifies the color of the preferred font to use when

9670

<a href="#disp-iman">annotating</a>

9671

the image window with text. The default colors are black, blue, green,

9672

cyan, gray, red, magenta, yellow, and white.</td></tr></table>

9673

9674

<tr>

9675

9676

9677

<img SRC="../images/right_triangle_option.png"

9678

ALT=">" BORDER=0 height=14

9679

width=15><b><font face="Helvetica, Arial"

9680

><font color="#FFFFFF"><font size="+1">

9681

printCommand <i>(class PrintCommand)</i>

9682

</font></font></font></b></td></tr></table>

9683

9684

This command is executed whenever Print is issued. In general, it is the

9685

command to print <em>PostScript</em> to your printer. Default value: <tt>lp

9686

-c -s %i</tt>.</td></tr></table>

9687

9688

<tr>

9689

9690

9691

<img SRC="../images/right_triangle_option.png"

9692

ALT=">" BORDER=0 height=14

9693

width=15><b><font face="Helvetica, Arial"

9694

><font color="#FFFFFF"><font size="+1">

9695

sharedMemory <i>(class SharedMemory)</i>

9696

</font></font></font></b></td></tr></table>

9697

9698

This resource specifies whether display should attempt use shared memory

9699

for pixmaps. GraphicsMagick must be compiled with shared memory support,

9700

and the display must support the MIT-SHM extension. Otherwise, this

9701

resource is ignored. The default is True.</td></tr></table>

9702

9703

<tr>

9704

9705

9706

<img SRC="../images/right_triangle_option.png"

9707

ALT=">" BORDER=0 height=14

9708

width=15><b><font face="Helvetica, Arial"

9709

><font color="#FFFFFF"><font size="+1">

9710

textFont <i>(class textFont)</i>

9711

</font></font></font></b></td></tr></table>

9712

9713

Specifies the name of the preferred font to use in fixed (typewriter style)

9714

formatted text. The default is 14 point Courier.</td></tr></table>

9715

9716

<tr>

9717

9718

9719

<img SRC="../images/right_triangle_option.png"

9720

ALT=">" BORDER=0 height=14

9721

width=15><b><font face="Helvetica, Arial"

9722

><font color="#FFFFFF"><font size="+1">

9723

title <i>(class Title)</i>

9724

</font></font></font></b></td></tr></table>

9725

9726

This resource specifies the title to be used for the image window. This

9727

information is sometimes used by a window manager to provide a header identifying

9728

the window. The default is the image file name.</td></tr></table>

9729

9730

<tr>

9731

9732

9733

<img SRC="../images/right_triangle_option.png"

9734

ALT=">" BORDER=0 height=14

9735

width=15><b><font face="Helvetica, Arial"

9736

><font color="#FFFFFF"><font size="+1">

9737

undoCache <i>(class UndoCache)</i>

9738

</font></font></font></b></td></tr></table>

9739

9740

Specifies, in mega-bytes, the amount of memory in the undo edit cache.

9741

Each time you modify the image it is saved in the undo edit cache as long

9742

as memory is available. You can subsequently <em>undo</em> one or more of

9743

these transformations. The default is 16 Megabytes.</td></tr></table>

9744

9745

<tr>

9746

9747

9748

<img SRC="../images/right_triangle_option.png"

9749

ALT=">" BORDER=0 height=14

9750

width=15><b><font face="Helvetica, Arial"

9751

><font color="#FFFFFF"><font size="+1">

9752

usePixmap <i>(class UsePixmap)</i>

9753

</font></font></font></b></td></tr></table>

9754

9755

Images are maintained as a XImage by default. Set this resource to True

9756

to utilize a server Pixmap instead. This option is useful if your image

9757

exceeds the dimensions of your server screen and you intend to pan the

9758

image. Panning is much faster with Pixmaps than with a XImage. Pixmaps

9759

are considered a precious resource, use them with discretion.</td></tr></table>

9760

<p>

9761

To set the geometry of the Magnify or Pan or window, use the geometry resource.

9762

For example, to set the Pan window geometry to 256x256, use:

9763

<pre>

9764

gm display.pan.geometry: 256x256

9765

</pre>

9766

</td></tr></table>

9767

<p>

9768

<i><a href="#top">Back to Contents</a></i>

9769

 </p>

9770

9771

<tr>

9772

<td ALIGN=LEFT bgcolor="#52799E"><img

9773

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9774

height=14 width=15><b><font face="Helvetica, Arial"><font

9775

color="#FFFFFF"><font size="+1">

9776

<a NAME="disp-imlo"></a>Image Loading

9777

</font></font></font></b></td></tr></table>

9778

9779

9780

<p>

9781

To select an image to display, choose <strong>Open</strong> of the <strong>File</strong> sub-menu

9782

from the <a href="#disp-comm">Command widget</a>. A file browser is displayed.

9783

To choose a particular image file, move the pointer to the filename and

9784

press any button. The filename is copied to the text window. Next, press

9785

9786

or press the <strong>RETURN</strong> key. Alternatively, you can type the image file

9787

name directly into the text window. To descend directories, choose a directory

9788

name and press the button twice quickly. A scrollbar allows a large list

9789

of filenames to be moved through the viewing area if it exceeds the size

9790

of the list area.

9791

<p>

9792

You can trim the list of file names by using shell globbing characters.

9793

For example, type <tt>*.jpg</tt> to list only files that end

9794

with <tt>.jpg</tt>.

9795

<p>

9796

To select your image from the X server screen instead of from a file, Choose

9797

<strong>Grab</strong> of the <strong>Open</strong> widget.

9798

</td></tr></table>

9799

<p>

9800

<i><a href="#top">Back to Contents</a></i>

9801

 </p>

9802

9803

<tr>

9804

<td ALIGN=LEFT bgcolor="#52799E"><img

9805

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9806

height=14 width=15><b><font face="Helvetica, Arial"><font

9807

color="#FFFFFF"><font size="+1">

9808

<a NAME="disp-visu"></a>Visual Image Directory

9809

</font></font></font></b></td></tr></table>

9810

9811

9812

<p>

9813

To create a Visual Image Directory, choose Visual Directory of the <strong>File</strong>

9814

sub-menu from the <a href="#disp-comm">Command widget</a> . A file browser is

9815

displayed. To create a Visual Image Directory from all the images in the

9816

current directory, press <strong>Directory</strong> or press the <strong>RETURN key</strong>.

9817

Alternatively, you can select a set of image names by using shell globbing

9818

characters. For example, type <tt>*.jpg</tt> to include only files that

9819

end with <tt>.jpg</tt>. To descend directories, choose a directory name

9820

and press the button twice quickly. A scrollbar allows a large list of

9821

filenames to be moved through the viewing area if it exceeds the size of

9822

the list area.

9823

<p>

9824

After you select a set of files, they are turned into thumbnails and tiled

9825

onto a single image. Now move the pointer to a particular thumbnail and

9826

press <strong>button 3</strong> and drag. Finally, select Open. The image represented

9827

by the thumbnail is displayed at its full size. Choose <strong>Next</strong> from

9828

the <strong>File</strong> sub-menu of the Command widget to return to the Visual

9829

Image Directory.

9830

</td></tr></table>

9831

<p>

9832

<i><a href="#top">Back to Contents</a></i>

9833

 </p>

9834

9835

<tr>

9836

<td ALIGN=LEFT bgcolor="#52799E"><img

9837

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9838

height=14 width=15><b><font face="Helvetica, Arial"><font

9839

color="#FFFFFF"><font size="+1">

9840

<a NAME="disp-imcu"></a>Image Cutting

9841

</font></font></font></b></td></tr></table>

9842

9843

9844

<p>

9845

Note that cut information for image window is not retained for colormapped

9846

X server visuals (e.g. <em>StaticColor</em>,

9847

<em>StaticColor</em>, <em>GRAYScale</em>,

9848

<em>PseudoColor</em>).

9849

Correct cutting behavior may require a <em>TrueColor</em> or <em>DirectColor</em>

9850

visual or a <em>Standard Colormap</em>.

9851

<p>

9852

To begin, press choose <strong>Cut</strong> of the <strong>Edit</strong> sub-menu from the

9853

<a href="#disp-comm">Command

9854

widget</a>. Alternatively, press

9855

<strong>F3</strong> in the image window.

9856

<p>

9857

A small window appears showing the location of the cursor in the image

9858

window. You are now in cut mode. In cut mode, the Command widget has these

9859

options:

9860

<ul>

9861

9862

<li><strong>Dismiss</strong>

9863

</ul>

9864

<p>

9865

To define a cut region, press button 1 and drag. The cut region is defined

9866

by a highlighted rectangle that expands or contracts as it follows the

9867

pointer. Once you are satisfied with the cut region, release the button.

9868

You are now in rectify mode. In rectify mode, the Command widget has these

9869

options:

9870

<ul>

9871

9872

9873

<li><strong>Dismiss</strong>

9874

</ul>

9875

<p>

9876

You can make adjustments by moving the pointer to one of the cut rectangle

9877

corners, pressing a button, and dragging. Finally, press Cut to commit

9878

your copy region. To exit without cutting the image, press Dismiss.

9879

</td></tr></table>

9880

<p>

9881

<i><a href="#top">Back to Contents</a></i>

9882

 </p>

9883

9884

<tr>

9885

<td ALIGN=LEFT bgcolor="#52799E"><img

9886

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9887

height=14 width=15><b><font face="Helvetica, Arial"><font

9888

color="#FFFFFF"><font size="+1">

9889

<a NAME="disp-imco"></a>Image Copying

9890

</font></font></font></b></td></tr></table>

9891

9892

9893

<p>

9894

To begin, press choose <strong>Copy</strong> of the <strong>Edit</strong> sub-menu from the

9895

<a href="#disp-comm">Command

9896

widget</a>. Alternatively, press

9897

<strong>F4</strong> in the image window.

9898

<p>

9899

A small window appears showing the location of the cursor in the image

9900

window. You are now in copy mode. In copy mode, the Command widget has

9901

these options:

9902

<ul>

9903

<li>Help

9904

<li>Dismiss

9905

</ul>

9906

<p>

9907

To define a copy region, press button 1 and drag. The copy region is defined

9908

by a highlighted rectangle that expands or contracts as it follows the

9909

pointer. Once you are satisfied with the copy region, release the button.

9910

You are now in rectify mode. In rectify mode, the Command widget has these

9911

options:

9912

<ul>

9913

<li>Copy

9914

<li>Help

9915

<li>Dismiss

9916

</ul>

9917

<p>

9918

You can make adjustments by moving the pointer to one of the copy rectangle

9919

corners, pressing a button, and dragging. Finally, press Copy to commit

9920

your copy region. To exit without copying the image, press Dismiss.

9921

</td></tr></table>

9922

<p>

9923

<i><a href="#top">Back to Contents</a></i>

9924

 </p>

9925

9926

<tr>

9927

<td ALIGN=LEFT bgcolor="#52799E"><img

9928

SRC="../images/right_triangle.png" ALT=">" BORDER=0

9929

height=14 width=15><b><font face="Helvetica, Arial"><font

9930

color="#FFFFFF"><font size="+1">

9931

<a NAME="disp-impas"></a>Image Pasting

9932

</font></font></font></b></td></tr></table>

9933

9934

9935

<p>

9936

To begin, press choose <strong>Paste</strong> of the <strong>Edit</strong> sub-menu from the

9937

<a href="#disp-comm">Command

9938

widget</a>. Alternatively, press

9939

<strong>F5</strong> in the image window.

9940

<p>

9941

A small window appears showing the location of the cursor in the image

9942

window. You are now in Paste mode. To exit immediately, press Dismiss.

9943

In Paste mode, the Command widget has these options:

9944

<ul>

9945

<li><strong>Operators</strong>

9946

<ul>

9947

<li>over

9948

<li>in

9949

<li>out

9950

<li>atop

9951

<li>xor

9952

<li>plus

9953

<li>minus

9954

<li>add

9955

<li>subtract

9956

<li>difference

9957

<li>multiply

9958

<li>bumpmap

9959

<li>replace

9960

</ul>

9961

9962

<li><strong>Dismiss</strong>

9963

</ul>

9964

<p>

9965

Choose a composite operation from the <strong>Operators</strong> sub-menu of the

9966

<a href="#disp-comm">Command

9967

widget</a>. How each operator behaves is described below. <em>image window</em>

9968

is the image currently displayed on your X server and <em>image</em> is the

9969

image obtained with the File Browser widget.

9970

9971

<tr>

9972

9973

9974

<img SRC="../images/right_triangle_option.png"

9975

ALT=">" BORDER=0 height=14

9976

width=15><b><font face="Helvetica, Arial"

9977

><font color="#FFFFFF"><font size="+1">

9978

over

9979

</font></font></font></b></td></tr></table>

9980

9981

The result is the union of the two image shapes, with <em>image</em> obscuring

9982

<em>image

9983

window</em> in the region of overlap.</td></tr></table>

9984

9985

<tr>

9986

9987

9988

<img SRC="../images/right_triangle_option.png"

9989

ALT=">" BORDER=0 height=14

9990

width=15><b><font face="Helvetica, Arial"

9991

><font color="#FFFFFF"><font size="+1">

9992

in

9993

</font></font></font></b></td></tr></table>

9994

9995

The result is simply <em>image</em> cut by the shape of

9996

<em>image window</em>.

9997

None of the image data of image window is in the result.</td></tr></table>

9998

9999

<tr>

10000

10001

10002

<img SRC="../images/right_triangle_option.png"

10003

ALT=">" BORDER=0 height=14

10004

width=15><b><font face="Helvetica, Arial"

10005

><font color="#FFFFFF"><font size="+1">

10006

out

10007

</font></font></font></b></td></tr></table>

10008

10009

The resulting image is <em>image</em> with the shape of

10010

<em>image window</em>

10011

cut out.</td></tr></table>

10012

10013

<tr>

10014

10015

10016

<img SRC="../images/right_triangle_option.png"

10017

ALT=">" BORDER=0 height=14

10018

width=15><b><font face="Helvetica, Arial"

10019

><font color="#FFFFFF"><font size="+1">

10020

atop

10021

</font></font></font></b></td></tr></table>

10022

10023

The result is the same shape as <em>image window</em>, with

10024

<em>image</em>

10025

obscuring <em>image window</em> where the image shapes overlap. Note this

10026

differs from over because the portion of image outside

10027

<em>image window</em>'s

10028

shape does not appear in the result.</td></tr></table>

10029

10030

<tr>

10031

10032

10033

<img SRC="../images/right_triangle_option.png"

10034

ALT=">" BORDER=0 height=14

10035

width=15><b><font face="Helvetica, Arial"

10036

><font color="#FFFFFF"><font size="+1">

10037

xor

10038

</font></font></font></b></td></tr></table>

10039

10040

The result is the image data from both <em>image</em> and

10041

<em>image window</em>

10042

that is outside the overlap region. The overlap region is blank.</td></tr></table>

10043

10044

<tr>

10045

10046

10047

<img SRC="../images/right_triangle_option.png"

10048

ALT=">" BORDER=0 height=14

10049

width=15><b><font face="Helvetica, Arial"

10050

><font color="#FFFFFF"><font size="+1">

10051

plus

10052

</font></font></font></b></td></tr></table>

10053

10054

The result is just the sum of the image data. Output values are cropped

10055

to the maximum value (no overflow). This operation is independent of the

10056

matte channels.</td></tr></table>

10057

10058

<tr>

10059

10060

10061

<img SRC="../images/right_triangle_option.png"

10062

ALT=">" BORDER=0 height=14

10063

width=15><b><font face="Helvetica, Arial"

10064

><font color="#FFFFFF"><font size="+1">

10065

minus

10066

</font></font></font></b></td></tr></table>

10067

10068

The result of <em>image</em> - <em>image window</em>, with underflow cropped

10069

to zero. The matte channel is ignored (set to opaque, full coverage).</td></tr></table>

10070

10071

<tr>

10072

10073

10074

<img SRC="../images/right_triangle_option.png"

10075

ALT=">" BORDER=0 height=14

10076

width=15><b><font face="Helvetica, Arial"

10077

><font color="#FFFFFF"><font size="+1">

10078

add

10079

</font></font></font></b></td></tr></table>

10080

10081

The result of <em>image</em> + <em>image window</em>, with overflow wrapping

10082

around (mod MaxRGB+1).</td></tr></table>

10083

10084

<tr>

10085

10086

10087

<img SRC="../images/right_triangle_option.png"

10088

ALT=">" BORDER=0 height=14

10089

width=15><b><font face="Helvetica, Arial"

10090

><font color="#FFFFFF"><font size="+1">

10091

subtract

10092

</font></font></font></b></td></tr></table>

10093

10094

The result of <em>image</em> - <em>image window</em>, with underflow wrapping

10095

around (mod MaxRGB+1). The add and subtract operators can be used to perform

10096

reversible transformations.</td></tr></table>

10097

10098

<tr>

10099

10100

10101

<img SRC="../images/right_triangle_option.png"

10102

ALT=">" BORDER=0 height=14

10103

width=15><b><font face="Helvetica, Arial"

10104

><font color="#FFFFFF"><font size="+1">

10105

difference

10106

</font></font></font></b></td></tr></table>

10107

10108

The result of abs(<em>image</em> - <em>image window</em>). This is useful for

10109

comparing two very similar images.</td></tr></table>

10110

10111

<tr>

10112

10113

10114

<img SRC="../images/right_triangle_option.png"

10115

ALT=">" BORDER=0 height=14

10116

width=15><b><font face="Helvetica, Arial"

10117

><font color="#FFFFFF"><font size="+1">

10118

multiply

10119

</font></font></font></b></td></tr></table>

10120

10121

The result of <em>image</em> * <em>image window</em>. This is useful for

10122

the creation of drop-shadows.</td></tr></table>

10123

10124

<tr>

10125

10126

10127

<img SRC="../images/right_triangle_option.png"

10128

ALT=">" BORDER=0 height=14

10129

width=15><b><font face="Helvetica, Arial"

10130

><font color="#FFFFFF"><font size="+1">

10131

bumpmap

10132

</font></font></font></b></td></tr></table>

10133

10134

The result of <em>image window</em> shaded by <em>window</em>.</td></tr></table>

10135

10136

<tr>

10137

10138

10139

<img SRC="../images/right_triangle_option.png"

10140

ALT=">" BORDER=0 height=14

10141

width=15><b><font face="Helvetica, Arial"

10142

><font color="#FFFFFF"><font size="+1">

10143

replace

10144

</font></font></font></b></td></tr></table>

10145

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>The resulting image is <em>image window</em> replaced with

10146

<em>image</em>.

10147

Here the matte information is ignored.</td></tr></table>

10148

<p>

10149

The image compositor requires a matte, or alpha channel in the image for

10150

some operations. This extra channel usually defines a mask which represents

10151

a sort of a cookie-cutter for the image. This is the case when matte is

10152

255 (full coverage) for pixels inside the shape, zero outside, and between

10153

zero and 255 on the boundary. If image does not have a matte channel, it

10154

is initialized with 0 for any pixel matching in color to pixel location

10155

(0,0), otherwise 255. See <a href="#disp-matt">Matte Editing</a> for a method

10156

of defining a matte channel.

10157

<p>

10158

Note that matte information for image window is not retained for colormapped

10159

X server visuals (e.g. <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>).

10160

Correct compositing behavior may require a

10161

<em>TrueColor</em> or <em>DirectColor</em>

10162

visual or a <em>Standard Colormap</em>.

10163

<p>

10164

Choosing a composite operator is optional. The default operator is replace.

10165

However, you must choose a location to composite your image and press button

10166

1. Press and hold the button before releasing and an outline of the image

10167

will appear to help you identify your location.

10168

<p>

10169

The actual colors of the pasted image is saved. However, the color that

10170

appears in image window may be different. For example, on a monochrome

10171

screen image window will appear black or white even though your pasted

10172

image may have many colors. If the image is saved to a file it is written

10173

with the correct colors. To assure the correct colors are saved in the

10174

final image, any <em>PseudoClass</em> image is promoted to <em>DirectClass</em>.

10175

To force a

10176

<em>PseudoClass</em> image to remain <em>PseudoClass</em>,

10177

use <strong>-colors</strong>.

10178

</td></tr></table>

10179

<p>

10180

<i><a href="#top">Back to Contents</a></i>

10181

 </p>

10182

10183

<tr>

10184

<td ALIGN=LEFT bgcolor="#52799E"><img

10185

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10186

height=14 width=15><b><font face="Helvetica, Arial"><font

10187

color="#FFFFFF"><font size="+1">

10188

<a NAME="disp-imcr"></a>Image Cropping

10189

</font></font></font></b></td></tr></table>

10190

10191

10192

<p>

10193

To begin, press choose <strong>Crop</strong> of the <strong>Transform</strong> submenu from

10194

the <a href="#disp-comm">Command widget</a>. Alternatively,

10195

<a href="#disp-keyb">press</a> [ in the image window.

10196

<p>

10197

A small window appears showing the location of the cursor in the image

10198

window. You are now in crop mode. In crop mode, the Command widget has

10199

these options:

10200

<ul>

10201

10202

<li><strong>Dismiss</strong>

10203

</ul>

10204

<p>

10205

To define a cropping region, press button 1 and drag. The cropping region

10206

is defined by a highlighted rectangle that expands or contracts as it follows

10207

the pointer. Once you are satisfied with the cropping region, release the

10208

button. You are now in rectify mode. In rectify mode, the Command widget

10209

has these options:

10210

<ul>

10211

10212

10213

<li><strong>Dismiss</strong>

10214

</ul>

10215

<p>

10216

You can make adjustments by moving the pointer to one of the cropping rectangle

10217

corners, pressing a button, and dragging. Finally, press Crop to commit

10218

your cropping region. To exit without cropping the image, press Dismiss.

10219

</td></tr></table>

10220

<p>

10221

<i><a href="#top">Back to Contents</a></i>

10222

 </p>

10223

10224

<tr>

10225

<td ALIGN=LEFT bgcolor="#52799E"><img

10226

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10227

height=14 width=15><b><font face="Helvetica, Arial"><font

10228

color="#FFFFFF"><font size="+1">

10229

<a NAME="disp-imch"></a>Image Chopping

10230

</font></font></font></b></td></tr></table>

10231

10232

10233

<p>

10234

An image is chopped interactively. There is no command line argument to

10235

chop an image. To begin, choose <strong>Chop</strong> of the <strong>Transform</strong> sub-menu

10236

from the <a href="#disp-comm">Command widget</a>. Alternatively,

10237

<a href="#disp-keyb">press</a> ] in the Image window.

10238

<p>

10239

You are now in <strong>Chop</strong> mode. To exit immediately, press

10240

<strong>Dismiss</strong>.

10241

In Chop mode, the Command widget has these options:

10242

<ul>

10243

<li><strong>Direction</strong>

10244

<ul>

10245

<li>horizontal

10246

<li>vertical

10247

</ul>

10248

10249

<li><strong>Dismiss</strong>

10250

</ul>

10251

<p>

10252

If the you choose the horizontal direction (this is the default), the area

10253

of the image between the two horizontal endpoints of the chop line is removed.

10254

Otherwise, the area of the image between the two vertical endpoints of

10255

the chop line is removed.

10256

<p>

10257

Select a location within the image window to begin your chop, press and

10258

hold any button. Next, move the pointer to another location in the image.

10259

As you move a line will connect the initial location and the pointer. When

10260

you release the button, the area within the image to chop is determined

10261

by which direction you choose from the Command widget.

10262

<p>

10263

To cancel the image chopping, move the pointer back to the starting point

10264

of the line and release the button.

10265

</td></tr></table>

10266

<p>

10267

<i><a href="#top">Back to Contents</a></i>

10268

 </p>

10269

10270

<tr>

10271

<td ALIGN=LEFT bgcolor="#52799E"><img

10272

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10273

height=14 width=15><b><font face="Helvetica, Arial"><font

10274

color="#FFFFFF"><font size="+1">

10275

<a NAME="disp-imro"></a>Image Rotation

10276

</font></font></font></b></td></tr></table>

10277

10278

10279

<p>

10280

Press the / key to rotate the image 90 degrees or \ to rotate -90 degrees.

10281

To interactively choose the degree of rotation, choose

10282

<strong>Rotate...</strong>

10283

of the <strong>Transform</strong> submenu from the <a href="#disp-comm">Command Widget</a>.

10284

Alternatively, <a href="#disp-keyb">press</a> * in the image window.

10285

<p>

10286

A small horizontal line is drawn next to the pointer. You are now in rotate

10287

mode. To exit immediately, press Dismiss. In rotate mode, the Command widget

10288

has these options:

10289

<ul>

10290

<li><strong>Pixel Color</strong>

10291

<ul>

10292

<li>black

10293

<li>blue

10294

<li>cyan

10295

<li>green

10296

<li>gray

10297

<li>red

10298

<li>magenta

10299

<li>yellow

10300

<li>white

10301

<li>Browser...

10302

</ul>

10303

<li><strong>Direction</strong>

10304

<ul>

10305

<li>horizontal

10306

<li>vertical

10307

</ul>

10308

10309

<li><strong>Dismiss</strong>

10310

</ul>

10311

<p>

10312

Choose a background color from the Pixel Color sub-menu. Additional background

10313

colors can be specified with the color browser. You can change the menu

10314

colors by setting the <a href="#disp-xres">X resources</a> pen1 through pen9.

10315

<p>

10316

If you choose the color browser and press <strong>Grab</strong>, you can select the

10317

background color by moving the pointer to the desired color on the screen

10318

and press any button.

10319

<p>

10320

Choose a point in the image window and press this button and hold. Next,

10321

move the pointer to another location in the image. As you move a line connects

10322

the initial location and the pointer. When you release the button, the

10323

degree of image rotation is determined by the slope of the line you just

10324

drew. The slope is relative to the direction you choose from the Direction

10325

sub-menu of the Command widget.

10326

<p>

10327

To cancel the image rotation, move the pointer back to the starting point

10328

of the line and release the button.

10329

</td></tr></table>

10330

<p>

10331

<i><a href="#top">Back to Contents</a></i>

10332

 </p>

10333

<p>

10334

<i><a href="#top">Back to Contents</a></i>

10335

 </p>

10336

10337

<tr>

10338

<td ALIGN=LEFT bgcolor="#52799E"><img

10339

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10340

height=14 width=15><b><font face="Helvetica, Arial"><font

10341

color="#FFFFFF"><font size="+1">

10342

<a NAME="disp-iman"></a>Image Annotation

10343

</font></font></font></b></td></tr></table>

10344

10345

10346

<p>

10347

An image is annotated interactively. There is no command line argument

10348

to annotate an image. To begin, choose

10349

<strong>Annotate</strong> of the <strong>Image

10350

Edit</strong> sub-menu from the <a href="#disp-comm">Command widget</a>. Alternatively,

10351

<a href="#disp-keyb">press</a> a in the image window.

10352

<p>

10353

A small window appears showing the location of the cursor in the image

10354

window. You are now in annotate mode. To exit immediately, press Dismiss.

10355

In annotate mode, the Command widget has these options:

10356

<ul>

10357

<li>

10358

10359

<ul>

10360

<li>

10361

fixed

10362

<li>

10363

variable

10364

<li>

10365

5x8

10366

<li>

10367

6x10

10368

<li>

10369

7x13bold

10370

<li>

10371

8x13bold

10372

<li>

10373

9x15bold

10374

<li>

10375

10x20

10376

<li>

10377

12x24

10378

<li>

10379

Browser...

10380

</ul>

10381

<li>

10382

<strong>Font Color</strong>

10383

<ul>

10384

<li>

10385

black

10386

<li>

10387

blue

10388

<li>

10389

cyan

10390

<li>

10391

green

10392

<li>

10393

gray

10394

<li>

10395

red

10396

<li>

10397

magenta

10398

<li>

10399

yellow

10400

<li>

10401

white

10402

<li>

10403

transparent

10404

<li>

10405

Browser...

10406

</ul>

10407

<li>

10408

<strong>Box Color</strong>

10409

<ul>

10410

<li>

10411

black

10412

<li>

10413

blue

10414

<li>

10415

cyan

10416

<li>

10417

green

10418

<li>

10419

gray

10420

<li>

10421

red

10422

<li>

10423

magenta

10424

<li>

10425

yellow

10426

<li>

10427

white

10428

<li>

10429

transparent

10430

<li>

10431

Browser...

10432

</ul>

10433

<li>

10434

<strong>Rotate Text</strong>

10435

<ul>

10436

<li>

10437

-90

10438

<li>

10439

-45

10440

<li>

10441

-30

10442

<li>

10443

0

10444

<li>

10445

30

10446

<li>

10447

45

10448

<li>

10449

90

10450

<li>

10451

180

10452

<li>

10453

Dialog...

10454

</ul>

10455

<li>

10456

10457

<li>

10458

<strong>Dismiss</strong>

10459

</ul>

10460

<p>

10461

Choose a font name from the <strong>Font Name</strong> sub-menu. Additional font

10462

names can be specified with the font browser. You can change the menu names

10463

by setting the <a href="#disp-xres">X resources</a> font1 through font9.

10464

<p>

10465

Choose a font color from the <strong>Font Color</strong> sub-menu. Additional font

10466

colors can be specified with the color browser. You can change the menu

10467

colors by setting the <a href="#disp-xres">X resources</a> pen1 through pen9.

10468

<p>

10469

If you select the color browser and press <strong>Grab</strong>, you can choose the

10470

font color by moving the pointer to the desired color on the screen and

10471

press any button.

10472

<p>

10473

If you choose to rotate the text, choose <strong>Rotate Text</strong> from the menu

10474

and select an angle. Typically you will only want to rotate one line of

10475

text at a time. Depending on the angle you choose, subsequent lines may

10476

end up overwriting each other.

10477

<p>

10478

Choosing a font and its color is optional. The default font is fixed and

10479

the default color is black. However, you must choose a location to begin

10480

entering text and press a button. An underscore character will appear at

10481

the location of the pointer. The cursor changes to a pencil to indicate

10482

you are in text mode. To exit immediately, press Dismiss.

10483

<p>

10484

In text mode, any key presses will display the character at the location

10485

of the underscore and advance the underscore cursor. Enter your text and

10486

once completed press Apply to finish your image annotation. To correct

10487

errors press <strong>BACK SPACE</strong>. To delete an entire line of text, press

10488

<strong>DELETE</strong>.

10489

Any text that exceeds the boundaries of the image window is automatically

10490

continued onto the next line.

10491

<p>

10492

The actual color you request for the font is saved in the image. However,

10493

the color that appears in your Image window may be different. For example,

10494

on a monochrome screen the text will appear black or white even if you

10495

choose the color red as the font color. However, the image saved to a file

10496

with <strong>-write</strong> is written with red lettering. To assure the correct

10497

color text in the final image, any <em>PseudoClass</em> image is promoted

10498

to <em>DirectClass</em> (see miff(5)). To force a <em>PseudoClass</em> image

10499

to remain

10500

<em>PseudoClass</em>, use <strong>-colors</strong>.

10501

</td></tr></table>

10502

<p>

10503

<i><a href="#top">Back to Contents</a></i>

10504

 </p>

10505

10506

<tr>

10507

<td ALIGN=LEFT bgcolor="#52799E"><img

10508

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10509

height=14 width=15><b><font face="Helvetica, Arial"><font

10510

color="#FFFFFF"><font size="+1">

10511

<a NAME="disp-imcomp"></a>Image Compositing

10512

</font></font></font></b></td></tr></table>

10513

10514

10515

<p>

10516

An image composite is created interactively. <strong>There is no command line

10517

argument to composite an image</strong>. To begin, choose <strong>Composite</strong> of

10518

the <strong>Image Edit</strong> from the <a href="#disp-comm">Command widget</a>. Alternatively,

10519

<a href="#disp-keyb">press</a> x in the Image window.

10520

<p>

10521

First a popup window is displayed requesting you to enter an image name.

10522

Press <strong>Composite</strong>, <strong>Grab</strong> or type a file name. Press <strong>Cancel</strong>

10523

if you choose not to create a composite image. When you choose <strong>Grab</strong>,

10524

move the pointer to the desired window and press any button.

10525

<p>

10526

If the <strong>Composite</strong> image does not have any matte information, you

10527

are informed and the file browser is displayed again. Enter the name of

10528

a mask image. The image is typically grayscale and the same size as the

10529

composite image. If the image is not grayscale, it is converted to grayscale

10530

and the resulting intensities are used as matte information.

10531

<p>

10532

A small window appears showing the location of the cursor in the image

10533

window. You are now in composite mode. To exit immediately, press Dismiss.

10534

In composite mode, the Command widget has these options:

10535

<ul>

10536

<li>

10537

<strong>Operators</strong>

10538

<ul>

10539

<li>

10540

over

10541

<li>

10542

in

10543

<li>

10544

out

10545

<li>

10546

atop

10547

<li>

10548

xor

10549

<li>

10550

plus

10551

<li>

10552

minus

10553

<li>

10554

add

10555

<li>

10556

subtract

10557

<li>

10558

difference

10559

<li>

10560

bumpmap

10561

<li>

10562

replace

10563

</ul>

10564

<li>

10565

<strong>Blend</strong>

10566

<li>

10567

<strong>Displace</strong>

10568

<li>

10569

10570

<li>

10571

<strong>Dismiss</strong>

10572

</ul>

10573

<p>

10574

Choose a composite operation from the Operators sub-menu of the Command

10575

widget. How each operator behaves is described below. image window is the

10576

image currently displayed on your X server and image is the image obtained

10577

10578

<tr>

10579

10580

10581

<img SRC="../images/right_triangle_option.png"

10582

ALT=">" BORDER=0 height=14

10583

width=15><b><font face="Helvetica, Arial"

10584

><font color="#FFFFFF"><font size="+1">

10585

over

10586

</font></font></font></b></td></tr></table>

10587

10588

The result is the union of the two image shapes, with <em>image</em> obscuring

10589

<em>image

10590

window</em> in the region of overlap.</td></tr></table>

10591

10592

<tr>

10593

10594

10595

<img SRC="../images/right_triangle_option.png"

10596

ALT=">" BORDER=0 height=14

10597

width=15><b><font face="Helvetica, Arial"

10598

><font color="#FFFFFF"><font size="+1">

10599

in

10600

</font></font></font></b></td></tr></table>

10601

10602

The result is simply <em>image</em> cut by the shape of

10603

<em>image window</em>.

10604

None of the image data of image window is in the result.</td></tr></table>

10605

10606

<tr>

10607

10608

10609

<img SRC="../images/right_triangle_option.png"

10610

ALT=">" BORDER=0 height=14

10611

width=15><b><font face="Helvetica, Arial"

10612

><font color="#FFFFFF"><font size="+1">

10613

out

10614

</font></font></font></b></td></tr></table>

10615

10616

The resulting image is <em>image</em> with the shape of

10617

<em>image window</em>

10618

cut out.</td></tr></table>

10619

10620

<tr>

10621

10622

10623

<img SRC="../images/right_triangle_option.png"

10624

ALT=">" BORDER=0 height=14

10625

width=15><b><font face="Helvetica, Arial"

10626

><font color="#FFFFFF"><font size="+1">

10627

atop

10628

</font></font></font></b></td></tr></table>

10629

10630

The result is the same shape as <em>image window</em>, with

10631

<em>image</em>

10632

obscuring <em>image window</em> where the image shapes overlap. Note this

10633

differs from over because the portion of image outside

10634

<em>image window</em>'s

10635

shape does not appear in the result.</td></tr></table>

10636

10637

<tr>

10638

10639

10640

<img SRC="../images/right_triangle_option.png"

10641

ALT=">" BORDER=0 height=14

10642

width=15><b><font face="Helvetica, Arial"

10643

><font color="#FFFFFF"><font size="+1">

10644

xor

10645

</font></font></font></b></td></tr></table>

10646

10647

The result is the image data from both <em>image</em> and

10648

<em>image window</em>

10649

that is outside the overlap region. The overlap region is blank.</td></tr></table>

10650

10651

<tr>

10652

10653

10654

<img SRC="../images/right_triangle_option.png"

10655

ALT=">" BORDER=0 height=14

10656

width=15><b><font face="Helvetica, Arial"

10657

><font color="#FFFFFF"><font size="+1">

10658

plus

10659

</font></font></font></b></td></tr></table>

10660

10661

The result is just the sum of the image data. Output values are cropped

10662

to 255 (no overflow). This operation is independent of the matte channels.</td></tr></table>

10663

10664

<tr>

10665

10666

10667

<img SRC="../images/right_triangle_option.png"

10668

ALT=">" BORDER=0 height=14

10669

width=15><b><font face="Helvetica, Arial"

10670

><font color="#FFFFFF"><font size="+1">

10671

minus

10672

</font></font></font></b></td></tr></table>

10673

10674

The result of <em>image</em> - <em>image window</em>, with underflow cropped

10675

to zero. The matte channel is ignored (set to 255, full coverage).</td></tr></table>

10676

10677

<tr>

10678

10679

10680

<img SRC="../images/right_triangle_option.png"

10681

ALT=">" BORDER=0 height=14

10682

width=15><b><font face="Helvetica, Arial"

10683

><font color="#FFFFFF"><font size="+1">

10684

add

10685

</font></font></font></b></td></tr></table>

10686

10687

The result of <em>image</em> + <em>image window</em>, with overflow wrapping

10688

around (mod 256).</td></tr></table>

10689

10690

<tr>

10691

10692

10693

<img SRC="../images/right_triangle_option.png"

10694

ALT=">" BORDER=0 height=14

10695

width=15><b><font face="Helvetica, Arial"

10696

><font color="#FFFFFF"><font size="+1">

10697

subtract

10698

</font></font></font></b></td></tr></table>

10699

10700

The result of <em>image</em> - <em>image window</em>, with underflow wrapping

10701

around (mod 256). The add and subtract operators can be used to perform

10702

reversible transformations.</td></tr></table>

10703

10704

<tr>

10705

10706

10707

<img SRC="../images/right_triangle_option.png"

10708

ALT=">" BORDER=0 height=14

10709

width=15><b><font face="Helvetica, Arial"

10710

><font color="#FFFFFF"><font size="+1">

10711

difference

10712

</font></font></font></b></td></tr></table>

10713

10714

The result of abs(<em>image</em> - <em>image window</em>). This is useful for

10715

comparing two very similar images.</td></tr></table>

10716

10717

<tr>

10718

10719

10720

<img SRC="../images/right_triangle_option.png"

10721

ALT=">" BORDER=0 height=14

10722

width=15><b><font face="Helvetica, Arial"

10723

><font color="#FFFFFF"><font size="+1">

10724

bumpmap

10725

</font></font></font></b></td></tr></table>

10726

10727

The result of <em>image window</em> shaded by <em>window</em>.</td></tr></table>

10728

10729

<tr>

10730

10731

10732

<img SRC="../images/right_triangle_option.png"

10733

ALT=">" BORDER=0 height=14

10734

width=15><b><font face="Helvetica, Arial"

10735

><font color="#FFFFFF"><font size="+1">

10736

replace

10737

</font></font></font></b></td></tr></table>

10738

10739

The resulting image is <em>image window</em> replaced with

10740

<em>image</em>.

10741

Here the matte information is ignored.</td></tr></table>

10742

<p>

10743

The image compositor requires a matte, or alpha channel in the image for

10744

some operations. This extra channel usually defines a mask which represents

10745

a sort of a cookie-cutter for the image. This is the case when matte is

10746

255 (full coverage) for pixels inside the shape, zero outside, and between

10747

zero and 255 on the boundary. If image does not have a matte channel, it

10748

is initialized with 0 for any pixel matching in color to pixel location

10749

(0,0), otherwise 255. See <a href="#disp-matt">Matte Editing</a> for a method

10750

of defining a matte channel.

10751

<p>

10752

If you choose <strong>blend</strong>, the composite operator becomes <strong>over</strong>.

10753

The image matte channel percent transparency is initialized to factor.

10754

The image window is initialized to (100-factor). Where factor is the value

10755

you specify in the Dialog widget.

10756

<p>

10757

<strong>Displace</strong> shifts the image pixels as defined by a displacement map.

10758

With this option, <em>image</em> is used as a displacement map. Black, within

10759

the displacement map, is a maximum positive displacement. White is a maximum

10760

negative displacement and middle gray is neutral. The displacement is scaled

10761

to determine the pixel shift. By default, the displacement applies in both

10762

the horizontal and vertical directions. However, if you specify

10763

<em>mask</em>,

10764

<em>image</em>

10765

is the horizontal X displacement and

10766

<em>mask</em> the vertical Y displacement.

10767

<p>

10768

Note that matte information for image window is not retained for colormapped

10769

X server visuals (e.g.

10770

<em>StaticColor, StaticColor, GrayScale, PseudoColor</em>).

10771

Correct compositing behavior may require a <em>TrueColor</em> or

10772

<em>DirectColor</em>

10773

visual or a <em>Standard Colormap</em>.

10774

<p>

10775

Choosing a composite operator is optional. The default operator is replace.

10776

However, you must choose a location to composite your image and press button

10777

1. Press and hold the button before releasing and an outline of the image

10778

will appear to help you identify your location.

10779

<p>

10780

The actual colors of the composite image is saved. However, the color that

10781

appears in image window may be different. For example, on a monochrome

10782

screen Image window will appear black or white even though your composited

10783

image may have many colors. If the image is saved to a file it is written

10784

with the correct colors. To assure the correct colors are saved in the

10785

final image, any PseudoClass image is promoted to <em>DirectClass</em> (see

10786

<a href="miff.html">miff</a>).

10787

To force a <em>PseudoClass</em> image to remain <em>PseudoClass</em>,

10788

use <strong>-colors</strong>.

10789

</td></tr></table>

10790

<p>

10791

<i><a href="#top">Back to Contents</a></i>

10792

 </p>

10793

10794

<tr>

10795

<td ALIGN=LEFT bgcolor="#52799E"><img

10796

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10797

height=14 width=15><b><font face="Helvetica, Arial"><font

10798

color="#FFFFFF"><font size="+1">

10799

<a NAME="disp-cole"></a>Color Editing

10800

</font></font></font></b></td></tr></table>

10801

10802

10803

<p>

10804

Changing the the color of a set of pixels is performed interactively. There

10805

is no command line argument to edit a pixel. To begin, choose <strong>Color</strong>

10806

from the <strong>Image Edit</strong> submenu of the <a href="#disp-comm">Command widget</a>.

10807

Alternatively, <a href="#disp-keyb">press</a> c in the image window.

10808

<p>

10809

A small window appears showing the location of the cursor in the image

10810

window. You are now in color edit mode. To exit immediately, press <strong>Dismiss</strong>.

10811

In color edit mode, the

10812

<strong>Command widget</strong> has these options:

10813

<ul>

10814

<li>

10815

<strong>Method</strong>

10816

<ul>

10817

<li>

10818

point

10819

<li>

10820

replace

10821

<li>

10822

floodfill

10823

<li>

10824

reset

10825

</ul>

10826

<li>

10827

<strong>Pixel Color</strong>

10828

<ul>

10829

<li>

10830

black

10831

<li>

10832

blue

10833

<li>

10834

cyan

10835

<li>

10836

green

10837

<li>

10838

gray

10839

<li>

10840

red

10841

<li>

10842

magenta

10843

<li>

10844

yellow

10845

<li>

10846

white

10847

<li>

10848

Browser...

10849

</ul>

10850

<li>

10851

<strong>Border Color</strong>

10852

<ul>

10853

<li>

10854

black

10855

<li>

10856

blue

10857

<li>

10858

cyan

10859

<li>

10860

green

10861

<li>

10862

gray

10863

<li>

10864

red

10865

<li>

10866

magenta

10867

<li>

10868

yellow

10869

<li>

10870

white

10871

<li>

10872

Browser...

10873

</ul>

10874

<li>

10875

10876

<ul>

10877

<li>

10878

0

10879

<li>

10880

2

10881

<li>

10882

4

10883

<li>

10884

8

10885

<li>

10886

16

10887

<li>Dialog...

10888

</ul>

10889

<li>

10890

10891

<li>

10892

10893

<li>

10894

<strong>Dismiss</strong>

10895

</ul>

10896

<p>

10897

Choose a color editing method from the <strong>Method</strong> sub-menu of

10898

the <a href="#disp-comm">Command

10899

widget</a>. The <strong>point method</strong> recolors any pixel selected with the

10900

pointer unless the button is released. The <strong>replace method</strong> recolors

10901

any pixel that matches the color of the pixel you select with a button

10902

press. <strong>Floodfill</strong> recolors any pixel that matches the color of the

10903

pixel you select with a button press and is a neighbor.

10904

Whereas <strong>filltoborder</strong>

10905

changes the matte value of any neighbor pixel that is not the border color.

10906

Finally <strong>reset</strong> changes the entire image to the designated color.

10907

<p>

10908

Next, choose a pixel color from the <strong>Pixel Color</strong> sub-menu. Additional

10909

pixel colors can be specified with the color browser. You can change the

10910

menu colors by setting the <a href="#disp-xres">X resources</a> pen1 through

10911

pen9.

10912

<p>

10913

Now press button 1 to select a pixel within the Image window to change

10914

its color. Additional pixels may be recolored as prescribed by the method

10915

you choose. additional pixels by increasing the Delta value.

10916

<p>

10917

If the <strong>Magnify widget</strong> is mapped, it can be helpful in positioning

10918

your pointer within the image (refer to button 2). Alternatively you can

10919

select a pixel to recolor from within the <strong>Magnify widget</strong>. Move the

10920

pointer to the <strong>Magnify widget</strong> and position the pixel with the cursor

10921

control keys. Finally, press a button to recolor the selected pixel (or

10922

pixels).

10923

<p>

10924

The actual color you request for the pixels is saved in the image. However,

10925

the color that appears in your Image window may be different. For example,

10926

on a monochrome screen the pixel will appear black or white even if you

10927

choose the color red as the pixel color. However, the image saved to a

10928

file with -write is written with red pixels. To assure the correct color

10929

text in the final image, any <em>PseudoClass</em> image is promoted

10930

to <em>DirectClass</em>

10931

To force a <em>PseudoClass</em> image to remain

10932

<em>PseudoClass</em>, use <strong>-colors</strong>.

10933

</td></tr></table>

10934

<p>

10935

<i><a href="#top">Back to Contents</a></i>

10936

 </p>

10937

10938

<tr>

10939

<td ALIGN=LEFT bgcolor="#52799E"><img

10940

SRC="../images/right_triangle.png" ALT=">" BORDER=0

10941

height=14 width=15><b><font face="Helvetica, Arial"><font

10942

color="#FFFFFF"><font size="+1">

10943

<a NAME="disp-matt"></a>Matte Editing

10944

</font></font></font></b></td></tr></table>

10945

10946

10947

<p>

10948

Matte information within an image is useful for some operations such as

10949

image <a href="#disp-imcomp">compositing</a>. This extra channel usually defines

10950

a mask which represents a sort of a cookie-cutter for the image. This is

10951

the case when matte is 255 (full coverage) for pixels inside the shape,

10952

zero outside, and between zero and 255 on the boundary.

10953

<p>

10954

Setting the matte information in an image is done interactively. There

10955

is no command line argument to edit a pixel. To begin, and choose <strong>Matte</strong>

10956

of the <strong>Image Edit</strong> sub-menu from the <a href="#disp-comm">Command widget</a>.

10957

<p>

10958

Alternatively, <a href="#disp-keyb">press</a> m in the image window.

10959

<p>

10960

A small window appears showing the location of the cursor in the image

10961

window. You are now in matte edit mode. To exit immediately, press Dismiss.

10962

In matte edit mode, the Command widget has these options:

10963

<ul>

10964

<li>

10965

<strong>Method</strong>

10966

<ul>

10967

<li>

10968

point

10969

<li>

10970

replace

10971

<li>

10972

floodfill

10973

<li>

10974

reset

10975

</ul>

10976

<li>

10977

<strong>Border Color</strong>

10978

<ul>

10979

<li>

10980

black

10981

<li>

10982

blue

10983

<li>

10984

cyan

10985

<li>

10986

green

10987

<li>

10988

gray

10989

<li>

10990

red

10991

<li>

10992

magenta

10993

<li>

10994

yellow

10995

<li>

10996

white

10997

<li>

10998

Browser...

10999

</ul>

11000

<li>

11001

11002

<ul>

11003

<li>

11004

0

11005

<li>

11006

2

11007

<li>

11008

4

11009

<li>

11010

8

11011

<li>

11012

16

11013

<li>Dialog...

11014

</ul>

11015

<li>

11016

<strong>Matte</strong>

11017

<li>

11018

11019

<li>

11020

11021

<li>

11022

<strong>Dismiss</strong>

11023

</ul>

11024

Choose a matte editing method from the <strong>Method</strong> sub-menu of the <a href="#disp-comm">Command

11025

widget</a>. The <strong>point method</strong> changes the matte value of the any

11026

pixel selected with the pointer until the button is released. The <strong>replace

11027

method</strong> changes the matte value of any pixel that matches the color

11028

of the pixel you select with a button press. <strong>Floodfill</strong> changes the

11029

matte value of any pixel that matches the color of the pixel you select

11030

with a button press and is a neighbor. Whereas

11031

<strong>filltoborder</strong> recolors

11032

any neighbor pixel that is not the border color. Finally <strong>reset</strong> changes

11033

the entire image to the designated matte value.

11034

<p>Choose <strong>Matte Value</strong> and a dialog appears requesting a matte value.

11035

Enter a value between <strong>0 and 255</strong>. This value is assigned as the matte

11036

value of the selected pixel or pixels.

11037

<p>Now, press any button to select a pixel within the Image window to change

11038

its matte value. You can change the matte value of additional pixels by

11039

increasing the Delta value. The Delta value is first added then subtracted

11040

from the red, green, and blue of the target color. Any pixels within the

11041

range also have their matte value updated.

11042

<p>If the <strong>Magnify widget</strong> is mapped, it can be helpful in positioning

11043

your pointer within the image (refer to button 2). Alternatively you can

11044

select a pixel to change the matte value from within the

11045

<strong>Magnify widget</strong>.

11046

Move the pointer to the <strong>Magnify widget</strong> and position the pixel with

11047

the cursor control keys. Finally, press a button to change the matte value

11048

of the selected pixel (or pixels).

11049

<p>Matte information is only valid in a <em>DirectClass image</em>. Therefore,

11050

any <em>PseudoClass</em> image is promoted to

11051

<em>DirectClass</em>. Note that

11052

matte information for <em>PseudoClass</em> is not retained for colormapped

11053

X server visuals (e.g. <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>)

11054

unless you immediately save your image to a file (refer to Write). Correct

11055

matte editing behavior may require a <em>TrueColor</em> or <em>DirectColor</em>

11056

visual or a <em>Standard Colormap</em>.

11057

</td></tr></table>

11058

<p>

11059

<i><a href="#top">Back to Contents</a></i>

11060

 </p>

11061

11062

<tr>

11063

<td ALIGN=LEFT bgcolor="#52799E"><img

11064

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11065

height=14 width=15><b><font face="Helvetica, Arial"><font

11066

color="#FFFFFF"><font size="+1">

11067

<a NAME="disp-imdr"></a>Image Drawing

11068

</font></font></font></b></td></tr></table>

11069

11070

11071

<p>

11072

An image is drawn upon interactively. <strong>There is no command line argument

11073

to draw on an image</strong>. To begin, choose <strong>Draw</strong> of the Image <strong>Edit</strong>

11074

sub-menu from the <a href="#disp-comm">Command widget</a>.

11075

Alternatively, <a href="#disp-keyb">press</a> d in the image window.

11076

<p>

11077

The cursor changes to a crosshair to indicate you are in draw mode. To

11078

exit immediately, press Dismiss. In draw mode, the Command widget has these

11079

options:

11080

<ul>

11081

<li>

11082

<strong>Primitive</strong>

11083

<ul>

11084

<li>

11085

point

11086

<li>

11087

line

11088

<li>

11089

rectangle

11090

<li>

11091

fill rectangle

11092

<li>

11093

circle

11094

<li>

11095

fill circle

11096

<li>

11097

ellipse

11098

<li>

11099

fill ellipse

11100

<li>

11101

polygon

11102

<li>

11103

fill polygon

11104

</ul>

11105

<li>

11106

<strong>Color</strong>

11107

<ul>

11108

<li>

11109

black

11110

<li>

11111

blue

11112

<li>

11113

cyan

11114

<li>

11115

green

11116

<li>

11117

gray

11118

<li>

11119

red

11120

<li>

11121

magenta

11122

<li>

11123

yellow

11124

<li>

11125

white

11126

<li>

11127

transparent

11128

<li>

11129

Browser...

11130

</ul>

11131

<li>

11132

<strong>Stipple</strong>

11133

<ul>

11134

<li>

11135

Brick

11136

<li>

11137

Diagonal

11138

<li>

11139

Scales

11140

<li>

11141

Vertical

11142

<li>

11143

Wavy

11144

<li>

11145

Translucent

11146

<li>

11147

Opaque

11148

<li>

11149

Open...

11150

</ul>

11151

<li>

11152

<strong>Width</strong>

11153

<ul>

11154

<li>

11155

1

11156

<li>

11157

2

11158

<li>

11159

4

11160

<li>

11161

8

11162

<li>

11163

16

11164

<li>Dialog...

11165

</ul>

11166

<li>

11167

11168

<li>

11169

11170

<li>

11171

<strong>Dismiss</strong>

11172

</ul>

11173

Choose a drawing primitive from the <strong>Primitive</strong> sub-menu.

11174

<p>

11175

Next, choose a color from the <strong>Color</strong> sub-menu. Additional colors

11176

can be specified with the color browser. You can change the menu colors

11177

by setting the <a href="#disp-xres">X resources</a> pen1 through pen9. The transparent

11178

color updates the image matte channel and is useful for image compositing.

11179

<p>

11180

If you choose the color browser and press <strong>Grab</strong>, you can select the

11181

primitive color by moving the pointer to the desired color on the screen

11182

and press any button. The transparent color updates the image matte channel

11183

and is useful for image compositing.

11184

<p>

11185

Choose a stipple, if appropriate, from the <strong>Stipple</strong> sub-menu. Additional

11186

stipples can be specified with the file browser. Stipples obtained from

11187

the file browser must be on disk in the X11 bitmap format.

11188

<p>

11189

Choose a line width, if appropriate, from the <strong>Width</strong> sub-menu. To

11190

choose a specific width select the <strong>Dialog</strong> widget.

11191

<p>

11192

Choose a point in the image window and press button 1 and hold. Next, move

11193

the pointer to another location in the image. As you move, a line connects

11194

the initial location and the pointer. When you release the button, the

11195

image is updated with the primitive you just drew. For polygons, the image

11196

is updated when you press and release the button without moving the pointer.

11197

<p>

11198

To cancel image drawing, move the pointer back to the starting point of

11199

the line and release the button.

11200

</td></tr></table>

11201

<p>

11202

<i><a href="#top">Back to Contents</a></i>

11203

 </p>

11204

11205

<tr>

11206

<td ALIGN=LEFT bgcolor="#52799E"><img

11207

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11208

height=14 width=15><b><font face="Helvetica, Arial"><font

11209

color="#FFFFFF"><font size="+1">

11210

<a NAME="disp-regi"></a>Region of Interest

11211

</font></font></font></b></td></tr></table>

11212

11213

11214

<p>

11215

To begin, press choose Region of Interest of the Pixel Transform sub-menu

11216

from the <a href="#disp-comm">Command widget</a>.

11217

Alternatively, <a href="#disp-keyb">press</a> R in the image window.

11218

<p>

11219

A small window appears showing the location of the cursor in the image

11220

window. You are now in region of interest mode. In region of interest mode,

11221

the Command widget has these options:

11222

<ul>

11223

<li>

11224

11225

<li>

11226

<strong>Dismiss</strong>

11227

</ul>

11228

<p>

11229

To define a region of interest, press button 1 and drag. The region of

11230

interest is defined by a highlighted rectangle that expands or contracts

11231

as it follows the pointer. Once you are satisfied with the region of interest,

11232

release the button. You are now in apply mode. In apply mode the Command

11233

widget has these options:

11234

<ul>

11235

<li>

11236

11237

<ul>

11238

<li>

11239

Save...

11240

<li>

11241

Print...

11242

</ul>

11243

<li>

11244

11245

<ul>

11246

<li>

11247

Undo

11248

<li>

11249

Redo

11250

</ul>

11251

<li>

11252

<strong>Transform</strong>

11253

<ul>

11254

<li>

11255

Flip

11256

<li>

11257

Flop

11258

<li>

11259

Rotate Right

11260

<li>

11261

Rotate Left

11262

</ul>

11263

<li>

11264

<strong>Enhance</strong>

11265

<ul>

11266

<li>

11267

Hue...

11268

<li>

11269

Saturation...

11270

<li>

11271

Brightness...

11272

<li>

11273

Gamma...

11274

<li>

11275

Spiff

11276

<li>

11277

Dull

11278

<li>

11279

Equalize

11280

<li>

11281

Normalize

11282

<li>

11283

Negate

11284

<li>

11285

GRAYscale

11286

<li>

11287

Quantize...

11288

</ul>

11289

<li>

11290

<strong>Effects</strong>

11291

<ul>

11292

<li>

11293

Despeckle

11294

<li>

11295

Emboss

11296

<li>

11297

Reduce Noise

11298

<li>

11299

Add Noise

11300

<li>

11301

Sharpen...

11302

<li>

11303

Blur...

11304

<li>

11305

Threshold...

11306

<li>

11307

Edge Detect...

11308

<li>

11309

Spread...

11310

<li>

11311

Shade...

11312

<li>

11313

Raise...

11314

<li>

11315

Segment...

11316

</ul>

11317

</ul>

11318

<ul>

11319

<li>

11320

11321

<ul>

11322

<li>

11323

Solarize...

11324

<li>

11325

Swirl...

11326

<li>

11327

Implode...

11328

<li>

11329

Wave...

11330

<li>

11331

Oil Paint

11332

<li>

11333

Charcoal Draw...

11334

</ul>

11335

</ul>

11336

<ul>

11337

<li>

11338

<strong>Miscellany</strong>

11339

<ul>

11340

<li>

11341

Image Info

11342

<li>

11343

Zoom Image

11344

<li>

11345

Show Preview...

11346

<li>

11347

Show Histogram

11348

<li>

11349

Show Matte

11350

</ul>

11351

<li>

11352

11353

<li>

11354

<strong>Dismiss</strong>

11355

</ul>

11356

<p>

11357

You can make adjustments to the region of interest by moving the pointer

11358

to one of the rectangle corners, pressing a button, and dragging. Finally,

11359

choose an image processing technique from the Command widget. You can choose

11360

more than one image processing technique to apply to an area. Alternatively,

11361

you can move the region of interest before applying another image processing

11362

technique. To exit, press Dismiss.

11363

</td></tr></table>

11364

<p>

11365

<i><a href="#top">Back to Contents</a></i>

11366

 </p>

11367

11368

<tr>

11369

<td ALIGN=LEFT bgcolor="#52799E"><img

11370

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11371

height=14 width=15><b><font face="Helvetica, Arial"><font

11372

color="#FFFFFF"><font size="+1">

11373

<a NAME="disp-impa"></a>Image Panning

11374

</font></font></font></b></td></tr></table>

11375

11376

11377

<p>

11378

When an image exceeds the width or height of the X server screen, display

11379

maps a small panning icon. The rectangle within the panning icon shows

11380

the area that is currently displayed in the the image window. To pan about

11381

the image, press any button and drag the pointer within the panning icon.

11382

The pan rectangle moves with the pointer and the image window is updated

11383

to reflect the location of the rectangle within the panning icon. When

11384

you have selected the area of the image you wish to view, release the button.

11385

<p>

11386

Use the arrow keys to pan the image one pixel up, down, left, or right

11387

within the image window.

11388

<p>

11389

The panning icon is withdrawn if the image becomes smaller than the dimensions

11390

of the X server screen.

11391

</td></tr></table>

11392

<p>

11393

<i><a href="#top">Back to Contents</a></i>

11394

 </p>

11395

11396

<tr>

11397

<td ALIGN=LEFT bgcolor="#52799E"><img

11398

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11399

height=14 width=15><b><font face="Helvetica, Arial"><font

11400

color="#FFFFFF"><font size="+1">

11401

<a NAME="disp-pref"></a>User Preferences

11402

</font></font></font></b></td></tr></table>

11403

11404

11405

<p>

11406

Preferences affect the default behavior of <strong>display(1)</strong>. The preferences

11407

are either true or false and are stored in your home directory

11408

as <tt>.displayrc</tt>:

11409

<dl>

11410

<dt>

11411

<strong>display image centered on a backdrop</strong></dt>

11412

<dd>

11413

This backdrop covers the entire workstation screen and is useful for hiding

11414

other X window activity while viewing the image. The color of the backdrop

11415

is specified as the background color. Refer to <a href="#disp-xres">X Resources</a>

11416

for details.</dd>

11417

<dt>

11418

<strong>confirm on program exit</strong></dt>

11419

<dd>

11420

Ask for a confirmation before exiting the <strong>display(1)</strong> program.</dd>

11421

<dt>

11422

<strong>correct image for display gamma</strong></dt>

11423

<dd>

11424

If the image has a known gamma, the gamma is corrected to match that of

11425

the X server (see the <a href="#disp-xres">X Resource</a><strong> displayGamma</strong>).</dd>

11426

<dt>

11427

<strong>display warning messages</strong></dt>

11428

<dd>

11429

Display any warning messages.</dd>

11430

<dt>

11431

<strong>apply Floyd/Steinberg error diffusion to image</strong></dt>

11432

<dd>

11433

The basic strategy of dithering is to trade intensity resolution for spatial

11434

resolution by averaging the intensities of several neighboring pixels.

11435

Images which suffer from severe contouring when reducing colors can be

11436

improved with this preference.</dd>

11437

<dt>

11438

<strong>use a shared colormap for colormapped X visuals</strong></dt>

11439

<dd>

11440

This option only applies when the default X server visual is

11441

<em>PseudoColor</em>

11442

or <em>GRAYScale</em>. Refer to <strong>-visual</strong> for more details. By default,

11443

a shared colormap is allocated. The image shares colors with other X clients.

11444

Some image colors could be approximated, therefore your image may look

11445

very different than intended. Otherwise the image colors appear exactly

11446

as they are defined. However, other clients may go technicolor when the

11447

image colormap is installed.</dd>

11448

<dt>

11449

<strong>display images as an X server pixmap</strong></dt>

11450

<dd>

11451

Images are maintained as a XImage by default. Set this resource to True

11452

to utilize a server Pixmap instead. This option is useful if your image

11453

exceeds the dimensions of your server screen and you intend to pan the

11454

image. Panning is much faster with Pixmaps than with a XImage. Pixmaps

11455

are considered a precious resource, use them with discretion.</dd>

11456

</dl>

11457

</td></tr></table>

11458

<p>

11459

<i><a href="#top">Back to Contents</a></i>

11460

 </p>

11461

11462

11463

<tr>

11464

<td ALIGN=LEFT bgcolor="#52799E"><img

11465

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11466

height=14 width=15><b><font face="Helvetica, Arial"><font

11467

color="#FFFFFF"><font size="+1">

11468

<a NAME="gm identify"></a>gm identify

11469

</font></font></font></b></td></tr></table>

11470

11471

11472

<p>

11473

<strong>Identify</strong> describes the format and characteristics of one or more

11474

image files. It will also report if an image is incomplete or corrupt.

11475

The information displayed includes the scene number, the file name, the

11476

width and height of the image, whether the image is colormapped or not,

11477

the number of colors in the image, the number of bytes in the image, the

11478

format of the image (JPEG, PNM, etc.), and finally the number of seconds

11479

it took to read and process the image. An example line output

11480

from <strong>identify</strong> follows:

11481

<pre>

11482

images/aquarium.miff 640x480 PseudoClass 256c

11483

308135b MIFF 1s

11484

</pre>

11485

<p>

11486

If <tt>-verbose</tt> is set, expect additional output including any image

11487

comment:

11488

11489

<pre>

11490

Image: images/aquarium.miff

11491

class: PseudoClass

11492

colors: 256

11493

signature: eb5dca81dd93ae7e6ffae99a527eb5dca8...

11494

matte: False

11495

geometry: 640x480

11496

depth: 8

11497

bytes: 308135

11498

format: MIFF

11499

comments:

11500

Imported from MTV raster image: aquarium.mtv

11501

</pre>

11502

<p>

11503

For some formats, additional format-specific information about the file

11504

will be written if the <tt>-debug coder</tt> or <tt>-debug all</tt> option

11505

is used.

11506

</td></tr></table>

11507

<p>

11508

<i><a href="#top">Back to Contents</a></i>

11509

 </p>

11510

11511

<tr>

11512

<td ALIGN=LEFT bgcolor="#52799E"><img

11513

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11514

height=14 width=15><b><font face="Helvetica, Arial"><font

11515

color="#FFFFFF"><font size="+1">

11516

<a NAME="ident-opti"></a>Identify options

11517

</font></font></font></b></td></tr></table>

11518

11519

11520

<p>

11521

Options are processed in command line order. Any option you specify on

11522

the command line remains in effect for the set of images immediately

11523

following, until the set is terminated by the appearance of any option

11524

or <strong>-noop</strong>.

11525

<p>

11526

For a more detailed description of each option, see

11527

Options, above.

11528

11529

11530

<tr>

11531

11532

11533

<img SRC="../images/right_triangle_option.png"

11534

ALT=">" BORDER=0 height=14

11535

width=15><b><font face="Helvetica, Arial"

11536

><font color="#FFFFFF"><font size="+1">

11537

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

11538

</font></font></font></b></td></tr></table>

11539

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

11540

11541

<tr>

11542

11543

11544

<img SRC="../images/right_triangle_option.png"

11545

ALT=">" BORDER=0 height=14

11546

width=15><b><font face="Helvetica, Arial"

11547

><font color="#FFFFFF"><font size="+1">

11548

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

11549

</font></font></font></b></td></tr></table>

11550

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

11551

11552

<tr>

11553

11554

11555

<img SRC="../images/right_triangle_option.png"

11556

ALT=">" BORDER=0 height=14

11557

width=15><b><font face="Helvetica, Arial"

11558

><font color="#FFFFFF"><font size="+1">

11559

-debug <i><events></i>

11560

</font></font></font></b></td></tr></table>

11561

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

11562

11563

<tr>

11564

11565

11566

<img SRC="../images/right_triangle_option.png"

11567

ALT=">" BORDER=0 height=14

11568

width=15><b><font face="Helvetica, Arial"

11569

><font color="#FFFFFF"><font size="+1">

11570

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

11571

</font></font></font></b></td></tr></table>

11572

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

11573

11574

<tr>

11575

11576

11577

<img SRC="../images/right_triangle_option.png"

11578

ALT=">" BORDER=0 height=14

11579

width=15><b><font face="Helvetica, Arial"

11580

><font color="#FFFFFF"><font size="+1">

11581

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

11582

</font></font></font></b></td></tr></table>

11583

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

11584

11585

<tr>

11586

11587

11588

<img SRC="../images/right_triangle_option.png"

11589

ALT=">" BORDER=0 height=14

11590

width=15><b><font face="Helvetica, Arial"

11591

><font color="#FFFFFF"><font size="+1">

11592

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

11593

</font></font></font></b></td></tr></table>

11594

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

11595

11596

<tr>

11597

11598

11599

<img SRC="../images/right_triangle_option.png"

11600

ALT=">" BORDER=0 height=14

11601

width=15><b><font face="Helvetica, Arial"

11602

><font color="#FFFFFF"><font size="+1">

11603

<a href="GraphicsMagick.html#details-format">-format</a> <i><string></i>

11604

</font></font></font></b></td></tr></table>

11605

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table>

11606

11607

<tr>

11608

11609

11610

<img SRC="../images/right_triangle_option.png"

11611

ALT=">" BORDER=0 height=14

11612

width=15><b><font face="Helvetica, Arial"

11613

><font color="#FFFFFF"><font size="+1">

11614

-help

11615

</font></font></font></b></td></tr></table>

11616

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

11617

11618

<tr>

11619

11620

11621

<img SRC="../images/right_triangle_option.png"

11622

ALT=">" BORDER=0 height=14

11623

width=15><b><font face="Helvetica, Arial"

11624

><font color="#FFFFFF"><font size="+1">

11625

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

11626

</font></font></font></b></td></tr></table>

11627

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

11628

11629

<tr>

11630

11631

11632

<img SRC="../images/right_triangle_option.png"

11633

ALT=">" BORDER=0 height=14

11634

width=15><b><font face="Helvetica, Arial"

11635

><font color="#FFFFFF"><font size="+1">

11636

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

11637

</font></font></font></b></td></tr></table>

11638

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

11639

11640

<tr>

11641

11642

11643

<img SRC="../images/right_triangle_option.png"

11644

ALT=">" BORDER=0 height=14

11645

width=15><b><font face="Helvetica, Arial"

11646

><font color="#FFFFFF"><font size="+1">

11647

11648

</font></font></font></b></td></tr></table>

11649

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

11650

11651

<tr>

11652

11653

11654

<img SRC="../images/right_triangle_option.png"

11655

ALT=">" BORDER=0 height=14

11656

width=15><b><font face="Helvetica, Arial"

11657

><font color="#FFFFFF"><font size="+1">

11658

-ping

11659

</font></font></font></b></td></tr></table>

11660

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table>

11661

11662

<tr>

11663

11664

11665

<img SRC="../images/right_triangle_option.png"

11666

ALT=">" BORDER=0 height=14

11667

width=15><b><font face="Helvetica, Arial"

11668

><font color="#FFFFFF"><font size="+1">

11669

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

11670

</font></font></font></b></td></tr></table>

11671

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

11672

11673

<tr>

11674

11675

11676

<img SRC="../images/right_triangle_option.png"

11677

ALT=">" BORDER=0 height=14

11678

width=15><b><font face="Helvetica, Arial"

11679

><font color="#FFFFFF"><font size="+1">

11680

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

11681

</font></font></font></b></td></tr></table>

11682

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

11683

11684

<tr>

11685

11686

11687

<img SRC="../images/right_triangle_option.png"

11688

ALT=">" BORDER=0 height=14

11689

width=15><b><font face="Helvetica, Arial"

11690

><font color="#FFFFFF"><font size="+1">

11691

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

11692

</font></font></font></b></td></tr></table>

11693

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

11694

11695

<tr>

11696

11697

11698

<img SRC="../images/right_triangle_option.png"

11699

ALT=">" BORDER=0 height=14

11700

width=15><b><font face="Helvetica, Arial"

11701

><font color="#FFFFFF"><font size="+1">

11702

<a href="GraphicsMagick.html#details-version">-version</a>

11703

</font></font></font></b></td></tr></table>

11704

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

11705

<p>

11706

For a more detailed description of each option, see

11707

Options, above.

11708

11709

</td></tr></table>

11710

<p>

11711

<i><a href="#top">Back to Contents</a></i>

11712

 </p>

11713

11714

11715

<tr>

11716

<td ALIGN=LEFT bgcolor="#52799E"><img

11717

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11718

height=14 width=15><b><font face="Helvetica, Arial"><font

11719

color="#FFFFFF"><font size="+1">

11720

<a NAME="import"></a>gm import

11721

</font></font></font></b></td></tr></table>

11722

11723

11724

<p>

11725

<strong>Import</strong> reads an image from any visible window on an X server and

11726

outputs it as an image file. You can capture a single window, the entire

11727

screen, or any rectangular portion of the screen.

11728

Use <em><a href="display.html">display</a></em>

11729

for redisplay, printing, editing, formatting, archiving, image processing,

11730

etc. of the captured image.

11731

<p>

11732

The target window can be specified by id, name, or may be selected

11733

by clicking the mouse in the desired window. If you press a button and

11734

then drag, a rectangle will form which expands and contracts as the mouse

11735

moves. To save the portion of the screen defined by the rectangle, just

11736

release the button. The keyboard bell is rung once at the beginning of

11737

the screen capture and twice when it completes.

11738

</td></tr></table>

11739

<p>

11740

<i><a href="#top">Back to Contents</a></i>

11741

 </p>

11742

11743

<tr>

11744

<td ALIGN=LEFT bgcolor="#52799E"><img

11745

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11746

height=14 width=15><b><font face="Helvetica, Arial"><font

11747

color="#FFFFFF"><font size="+1">

11748

<a NAME="imp-exam"></a>Examples

11749

</font></font></font></b></td></tr></table>

11750

11751

11752

<p>

11753

To select an X window or an area of the screen with the mouse and save it

11754

in the MIFF image format to a file entitled window.miff, use:

11755

<pre>

11756

gm import window.miff

11757

</pre>

11758

<p>

11759

To select an X window or an area of the screen with the mouse and save it

11760

in the Encapsulated PostScript format to include in another document, use:

11761

<pre>

11762

gm import figure.eps

11763

</pre>

11764

<p>

11765

To capture the entire X server screen in the JPEG image format in a file

11766

entitled root.jpeg, without using the mouse, use:

11767

<pre>

11768

gm import -window root root.jpeg

11769

</pre>

11770

<p>

11771

To capture the 512x256 area at the upper right corner of the X server

11772

screen in the PNG image format in a well-compressed file entitled corner.png,

11773

without using the mouse, use:

11774

<pre>

11775

gm import -window root -crop 512x256-0+0 -quality 90

11776

corner.png

11777

</pre>

11778

</td></tr></table>

11779

<p>

11780

<i><a href="#top">Back to Contents</a></i>

11781

 </p>

11782

11783

<tr>

11784

<td ALIGN=LEFT bgcolor="#52799E"><img

11785

SRC="../images/right_triangle.png" ALT=">" BORDER=0

11786

height=14 width=15><b><font face="Helvetica, Arial"><font

11787

color="#FFFFFF"><font size="+1">

11788

<a NAME="imp-opti"></a>Options

11789

</font></font></font></b></td></tr></table>

11790

11791

11792

<p>

11793

Options are processed in command line order. Any option you specify on

11794

the command line remains in effect until it is explicitly changed by specifying

11795

the option again with a different effect.

11796

<p>

11797

<strong>Import</strong> options can appear on the command line or in your

11798

X resources file. See <em>X(1)</em>. Options on the command line supersede

11799

values specified in your X resources file.

11800

<p>

11801

For a more detailed description of each option, see

11802

Options, above.

11803

11804

11805

<tr>

11806

11807

11808

<img SRC="../images/right_triangle_option.png"

11809

ALT=">" BORDER=0 height=14

11810

width=15><b><font face="Helvetica, Arial"

11811

><font color="#FFFFFF"><font size="+1">

11812

<a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i>

11813

</font></font></font></b></td></tr></table>

11814

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

11815

11816

<tr>

11817

11818

11819

<img SRC="../images/right_triangle_option.png"

11820

ALT=">" BORDER=0 height=14

11821

width=15><b><font face="Helvetica, Arial"

11822

><font color="#FFFFFF"><font size="+1">

11823

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

11824

</font></font></font></b></td></tr></table>

11825

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

11826

11827

<tr>

11828

11829

11830

<img SRC="../images/right_triangle_option.png"

11831

ALT=">" BORDER=0 height=14

11832

width=15><b><font face="Helvetica, Arial"

11833

><font color="#FFFFFF"><font size="+1">

11834

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

11835

</font></font></font></b></td></tr></table>

11836

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

11837

11838

<tr>

11839

11840

11841

<img SRC="../images/right_triangle_option.png"

11842

ALT=">" BORDER=0 height=14

11843

width=15><b><font face="Helvetica, Arial"

11844

><font color="#FFFFFF"><font size="+1">

11845

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

11846

</font></font></font></b></td></tr></table>

11847

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

11848

11849

<tr>

11850

11851

11852

<img SRC="../images/right_triangle_option.png"

11853

ALT=">" BORDER=0 height=14

11854

width=15><b><font face="Helvetica, Arial"

11855

><font color="#FFFFFF"><font size="+1">

11856

<a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i>

11857

</font></font></font></b></td></tr></table>

11858

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

11859

11860

<tr>

11861

11862

11863

<img SRC="../images/right_triangle_option.png"

11864

ALT=">" BORDER=0 height=14

11865

width=15><b><font face="Helvetica, Arial"

11866

><font color="#FFFFFF"><font size="+1">

11867

11868

</font></font></font></b></td></tr></table>

11869

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

11870

11871

<tr>

11872

11873

11874

<img SRC="../images/right_triangle_option.png"

11875

ALT=">" BORDER=0 height=14

11876

width=15><b><font face="Helvetica, Arial"

11877

><font color="#FFFFFF"><font size="+1">

11878

-debug <i><events></i>

11879

</font></font></font></b></td></tr></table>

11880

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

11881

11882

<tr>

11883

11884

11885

<img SRC="../images/right_triangle_option.png"

11886

ALT=">" BORDER=0 height=14

11887

width=15><b><font face="Helvetica, Arial"

11888

><font color="#FFFFFF"><font size="+1">

11889

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

11890

</font></font></font></b></td></tr></table>

11891

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

11892

11893

<tr>

11894

11895

11896

<img SRC="../images/right_triangle_option.png"

11897

ALT=">" BORDER=0 height=14

11898

width=15><b><font face="Helvetica, Arial"

11899

><font color="#FFFFFF"><font size="+1">

11900

<a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i>

11901

</font></font></font></b></td></tr></table>

11902

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>

11903

11904

<tr>

11905

11906

11907

<img SRC="../images/right_triangle_option.png"

11908

ALT=">" BORDER=0 height=14

11909

width=15><b><font face="Helvetica, Arial"

11910

><font color="#FFFFFF"><font size="+1">

11911

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

11912

</font></font></font></b></td></tr></table>

11913

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

11914

11915

<tr>

11916

11917

11918

<img SRC="../images/right_triangle_option.png"

11919

ALT=">" BORDER=0 height=14

11920

width=15><b><font face="Helvetica, Arial"

11921

><font color="#FFFFFF"><font size="+1">

11922

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

11923

</font></font></font></b></td></tr></table>

11924

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

11925

11926

<tr>

11927

11928

11929

<img SRC="../images/right_triangle_option.png"

11930

ALT=">" BORDER=0 height=14

11931

width=15><b><font face="Helvetica, Arial"

11932

><font color="#FFFFFF"><font size="+1">

11933

-descend

11934

</font></font></font></b></td></tr></table>

11935

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>obtain image by descending window hierarchy</td></tr></table>

11936

11937

<tr>

11938

11939

11940

<img SRC="../images/right_triangle_option.png"

11941

ALT=">" BORDER=0 height=14

11942

width=15><b><font face="Helvetica, Arial"

11943

><font color="#FFFFFF"><font size="+1">

11944

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

11945

</font></font></font></b></td></tr></table>

11946

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

11947

11948

<tr>

11949

11950

11951

<img SRC="../images/right_triangle_option.png"

11952

ALT=">" BORDER=0 height=14

11953

width=15><b><font face="Helvetica, Arial"

11954

><font color="#FFFFFF"><font size="+1">

11955

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

11956

</font></font></font></b></td></tr></table>

11957

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

11958

11959

<tr>

11960

11961

11962

<img SRC="../images/right_triangle_option.png"

11963

ALT=">" BORDER=0 height=14

11964

width=15><b><font face="Helvetica, Arial"

11965

><font color="#FFFFFF"><font size="+1">

11966

<a href="GraphicsMagick.html#details-dither">-dither</a>

11967

</font></font></font></b></td></tr></table>

11968

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

11969

11970

<tr>

11971

11972

11973

<img SRC="../images/right_triangle_option.png"

11974

ALT=">" BORDER=0 height=14

11975

width=15><b><font face="Helvetica, Arial"

11976

><font color="#FFFFFF"><font size="+1">

11977

<a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i>

11978

</font></font></font></b></td></tr></table>

11979

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table>

11980

11981

<tr>

11982

11983

11984

<img SRC="../images/right_triangle_option.png"

11985

ALT=">" BORDER=0 height=14

11986

width=15><b><font face="Helvetica, Arial"

11987

><font color="#FFFFFF"><font size="+1">

11988

<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>

11989

</font></font></font></b></td></tr></table>

11990

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

11991

11992

<tr>

11993

11994

11995

<img SRC="../images/right_triangle_option.png"

11996

ALT=">" BORDER=0 height=14

11997

width=15><b><font face="Helvetica, Arial"

11998

><font color="#FFFFFF"><font size="+1">

11999

-frame

12000

</font></font></font></b></td></tr></table>

12001

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>include the X window frame in the imported image</td></tr></table>

12002

12003

<tr>

12004

12005

12006

<img SRC="../images/right_triangle_option.png"

12007

ALT=">" BORDER=0 height=14

12008

width=15><b><font face="Helvetica, Arial"

12009

><font color="#FFFFFF"><font size="+1">

12010

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

12011

</font></font></font></b></td></tr></table>

12012

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

12013

12014

<tr>

12015

12016

12017

<img SRC="../images/right_triangle_option.png"

12018

ALT=">" BORDER=0 height=14

12019

width=15><b><font face="Helvetica, Arial"

12020

><font color="#FFFFFF"><font size="+1">

12021

-help

12022

</font></font></font></b></td></tr></table>

12023

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

12024

12025

<tr>

12026

12027

12028

<img SRC="../images/right_triangle_option.png"

12029

ALT=">" BORDER=0 height=14

12030

width=15><b><font face="Helvetica, Arial"

12031

><font color="#FFFFFF"><font size="+1">

12032

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

12033

</font></font></font></b></td></tr></table>

12034

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

12035

12036

<tr>

12037

12038

12039

<img SRC="../images/right_triangle_option.png"

12040

ALT=">" BORDER=0 height=14

12041

width=15><b><font face="Helvetica, Arial"

12042

><font color="#FFFFFF"><font size="+1">

12043

<a href="GraphicsMagick.html#details-label">-label</a> <i><name></i>

12044

</font></font></font></b></td></tr></table>

12045

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

12046

12047

<tr>

12048

12049

12050

<img SRC="../images/right_triangle_option.png"

12051

ALT=">" BORDER=0 height=14

12052

width=15><b><font face="Helvetica, Arial"

12053

><font color="#FFFFFF"><font size="+1">

12054

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

12055

</font></font></font></b></td></tr></table>

12056

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

12057

12058

<tr>

12059

12060

12061

<img SRC="../images/right_triangle_option.png"

12062

ALT=">" BORDER=0 height=14

12063

width=15><b><font face="Helvetica, Arial"

12064

><font color="#FFFFFF"><font size="+1">

12065

12066

</font></font></font></b></td></tr></table>

12067

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

12068

12069

<tr>

12070

12071

12072

<img SRC="../images/right_triangle_option.png"

12073

ALT=">" BORDER=0 height=14

12074

width=15><b><font face="Helvetica, Arial"

12075

><font color="#FFFFFF"><font size="+1">

12076

-monochrome

12077

</font></font></font></b></td></tr></table>

12078

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

12079

12080

<tr>

12081

12082

12083

<img SRC="../images/right_triangle_option.png"

12084

ALT=">" BORDER=0 height=14

12085

width=15><b><font face="Helvetica, Arial"

12086

><font color="#FFFFFF"><font size="+1">

12087

<a href="GraphicsMagick.html#details-negate">-negate</a>

12088

</font></font></font></b></td></tr></table>

12089

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>

12090

12091

<tr>

12092

12093

12094

<img SRC="../images/right_triangle_option.png"

12095

ALT=">" BORDER=0 height=14

12096

width=15><b><font face="Helvetica, Arial"

12097

><font color="#FFFFFF"><font size="+1">

12098

12099

</font></font></font></b></td></tr></table>

12100

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

12101

12102

<tr>

12103

12104

12105

<img SRC="../images/right_triangle_option.png"

12106

ALT=">" BORDER=0 height=14

12107

width=15><b><font face="Helvetica, Arial"

12108

><font color="#FFFFFF"><font size="+1">

12109

<a href="GraphicsMagick.html#details-pause">-pause</a> <i><seconds></i>

12110

</font></font></font></b></td></tr></table>

12111

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pause between snapshots [import]</td></tr></table>

12112

12113

<tr>

12114

12115

12116

<img SRC="../images/right_triangle_option.png"

12117

ALT=">" BORDER=0 height=14

12118

width=15><b><font face="Helvetica, Arial"

12119

><font color="#FFFFFF"><font size="+1">

12120

-ping

12121

</font></font></font></b></td></tr></table>

12122

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table>

12123

12124

<tr>

12125

12126

12127

<img SRC="../images/right_triangle_option.png"

12128

ALT=">" BORDER=0 height=14

12129

width=15><b><font face="Helvetica, Arial"

12130

><font color="#FFFFFF"><font size="+1">

12131

-pointsize <i><value></i>

12132

</font></font></font></b></td></tr></table>

12133

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, OPTION1, or TrueType font</td></tr></table>

12134

12135

<tr>

12136

12137

12138

<img SRC="../images/right_triangle_option.png"

12139

ALT=">" BORDER=0 height=14

12140

width=15><b><font face="Helvetica, Arial"

12141

><font color="#FFFFFF"><font size="+1">

12142

<a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i>

12143

</font></font></font></b></td></tr></table>

12144

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

12145

12146

<tr>

12147

12148

12149

<img SRC="../images/right_triangle_option.png"

12150

ALT=">" BORDER=0 height=14

12151

width=15><b><font face="Helvetica, Arial"

12152

><font color="#FFFFFF"><font size="+1">

12153

<a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

12154

</font></font></font></b></td></tr></table>

12155

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table>

12156

12157

<tr>

12158

12159

12160

<img SRC="../images/right_triangle_option.png"

12161

ALT=">" BORDER=0 height=14

12162

width=15><b><font face="Helvetica, Arial"

12163

><font color="#FFFFFF"><font size="+1">

12164

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

12165

</font></font></font></b></td></tr></table>

12166

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

12167

12168

<tr>

12169

12170

12171

<img SRC="../images/right_triangle_option.png"

12172

ALT=">" BORDER=0 height=14

12173

width=15><b><font face="Helvetica, Arial"

12174

><font color="#FFFFFF"><font size="+1">

12175

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

12176

</font></font></font></b></td></tr></table>

12177

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

12178

12179

<tr>

12180

12181

12182

<img SRC="../images/right_triangle_option.png"

12183

ALT=">" BORDER=0 height=14

12184

width=15><b><font face="Helvetica, Arial"

12185

><font color="#FFFFFF"><font size="+1">

12186

<a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i>

12187

</font></font></font></b></td></tr></table>

12188

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table>

12189

12190

<tr>

12191

12192

12193

<img SRC="../images/right_triangle_option.png"

12194

ALT=">" BORDER=0 height=14

12195

width=15><b><font face="Helvetica, Arial"

12196

><font color="#FFFFFF"><font size="+1">

12197

<a href="GraphicsMagick.html#details-screen">-screen</a>

12198

</font></font></font></b></td></tr></table>

12199

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the screen to capture</td></tr></table>

12200

12201

<tr>

12202

12203

12204

<img SRC="../images/right_triangle_option.png"

12205

ALT=">" BORDER=0 height=14

12206

width=15><b><font face="Helvetica, Arial"

12207

><font color="#FFFFFF"><font size="+1">

12208

-silent

12209

</font></font></font></b></td></tr></table>

12210

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>operate silently</td></tr></table>

12211

12212

<tr>

12213

12214

12215

<img SRC="../images/right_triangle_option.png"

12216

ALT=">" BORDER=0 height=14

12217

width=15><b><font face="Helvetica, Arial"

12218

><font color="#FFFFFF"><font size="+1">

12219

<a href="GraphicsMagick.html#details-snaps">-snaps</a> <i><value></i>

12220

</font></font></font></b></td></tr></table>

12221

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>number of screen snapshots</td></tr></table>

12222

12223

<tr>

12224

12225

12226

<img SRC="../images/right_triangle_option.png"

12227

ALT=">" BORDER=0 height=14

12228

width=15><b><font face="Helvetica, Arial"

12229

><font color="#FFFFFF"><font size="+1">

12230

<a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i>

12231

</font></font></font></b></td></tr></table>

12232

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table>

12233

12234

<tr>

12235

12236

12237

<img SRC="../images/right_triangle_option.png"

12238

ALT=">" BORDER=0 height=14

12239

width=15><b><font face="Helvetica, Arial"

12240

><font color="#FFFFFF"><font size="+1">

12241

12242

</font></font></font></b></td></tr></table>

12243

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

12244

12245

<tr>

12246

12247

12248

<img SRC="../images/right_triangle_option.png"

12249

ALT=">" BORDER=0 height=14

12250

width=15><b><font face="Helvetica, Arial"

12251

><font color="#FFFFFF"><font size="+1">

12252

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

12253

</font></font></font></b></td></tr></table>

12254

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

12255

12256

<tr>

12257

12258

12259

<img SRC="../images/right_triangle_option.png"

12260

ALT=">" BORDER=0 height=14

12261

width=15><b><font face="Helvetica, Arial"

12262

><font color="#FFFFFF"><font size="+1">

12263

<a href="GraphicsMagick.html#details-version">-version</a>

12264

</font></font></font></b></td></tr></table>

12265

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

12266

<p>

12267

For a more detailed description of each option, see

12268

Options, above.

12269

12270

</td></tr></table>

12271

12272

12273

<tr>

12274

<td ALIGN=LEFT bgcolor="#52799E"><img

12275

SRC="../images/right_triangle.png" ALT=">" BORDER=0

12276

height=14 width=15><b><font face="Helvetica, Arial"><font

12277

color="#FFFFFF"><font size="+1">

12278

<a NAME="mogrify"></a>gm mogrify

12279

</font></font></font></b></td></tr></table>

12280

12281

12282

<p>

12283

<strong>Mogrify</strong> transforms an image or a sequence of images. These transforms

12284

include image scaling, image rotation, color reduction, and others. Each

12285

transmogrified image overwrites the corresponding original image, unless an

12286

option such as

12287

<strong>-format</strong> causes the output filename to be different from the input

12288

filename.

12289

12290

The graphics formats supported by <strong>mogrify</strong> are listed in

12291

<em>GraphicsMagick(1)</em>.

12292

</td></tr></table>

12293

<p>

12294

<i><a href="#top">Back to Contents</a></i>

12295

 </p>

12296

12297

<tr>

12298

<td ALIGN=LEFT bgcolor="#52799E"><img

12299

SRC="../images/right_triangle.png" ALT=">" BORDER=0

12300

height=14 width=15><b><font face="Helvetica, Arial"><font

12301

color="#FFFFFF"><font size="+1">

12302

<a NAME="mog-exam"></a>Examples

12303

</font></font></font></b></td></tr></table>

12304

12305

12306

<p>

12307

To convert all the TIFF files in a particular directory to JPEG, use:

12308

<pre>

12309

gm mogrify -format jpeg *.tiff

12310

</pre>

12311

<p>

12312

To convert a directory full of JPEG images to thumbnails, use:

12313

<pre>

12314

gm mogrify -size 120x120 *.jpg -resize 120x120 +profile "*"

12315

</pre>

12316

12317

In this example, <tt>'-size 120x120'</tt> gives a hint to the JPEG decoder

12318

that the images are going to be downscaled to 120x120, allowing it to run

12319

faster by avoiding returning full-resolution images to GraphicsMagick for

12320

the subsequent resizing operation. The

12321

<tt>'-resize 120x120'</tt> specifies the desired dimensions of the

12322

output images. It will be scaled so its largest dimension is 120 pixels. The

12323

<tt>'+profile "*"'</tt> removes any ICM, EXIF, IPTC, or other profiles

12324

that might be present in the input and aren't needed in the thumbnails.</font></td></tr></table>

12325

<p>

12326

To scale an image of a cockatoo to exactly 640 pixels in width and 480

12327

pixels in height, use:

12328

<pre>

12329

gm mogrify -resize 640x480! cockatoo.miff

12330

</pre>

12331

</td></tr></table>

12332

<p>

12333

<i><a href="#top">Back to Contents</a></i>

12334

 </p>

12335

12336

<tr>

12337

<td ALIGN=LEFT bgcolor="#52799E"><img

12338

SRC="../images/right_triangle.png" ALT=">" BORDER=0

12339

height=14 width=15><b><font face="Helvetica, Arial"><font

12340

color="#FFFFFF"><font size="+1">

12341

<a NAME="mog-opti"></a>Options

12342

</font></font></font></b></td></tr></table>

12343

12344

12345

<p>

12346

Options are processed in command line order. Any option you specify on

12347

the command line remains in effect for the set of images that follows,

12348

until the set is terminated by the appearance of any option or <strong>-noop</strong>.

12349

<p>

12350

For a more detailed description of each option, see

12351

Options, above.

12352

12353

12354

<tr>

12355

12356

12357

<img SRC="../images/right_triangle_option.png"

12358

ALT=">" BORDER=0 height=14

12359

width=15><b><font face="Helvetica, Arial"

12360

><font color="#FFFFFF"><font size="+1">

12361

<a href="GraphicsMagick.html#details-affine">-affine</a> <i><matrix></i>

12362

</font></font></font></b></td></tr></table>

12363

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>drawing transform matrix</td></tr></table>

12364

12365

<tr>

12366

12367

12368

<img SRC="../images/right_triangle_option.png"

12369

ALT=">" BORDER=0 height=14

12370

width=15><b><font face="Helvetica, Arial"

12371

><font color="#FFFFFF"><font size="+1">

12372

<a href="GraphicsMagick.html#details-antialias">-antialias</a>

12373

</font></font></font></b></td></tr></table>

12374

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixel aliasing</td></tr></table>

12375

12376

<tr>

12377

12378

12379

<img SRC="../images/right_triangle_option.png"

12380

ALT=">" BORDER=0 height=14

12381

width=15><b><font face="Helvetica, Arial"

12382

><font color="#FFFFFF"><font size="+1">

12383

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

12384

</font></font></font></b></td></tr></table>

12385

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

12386

12387

<tr>

12388

12389

12390

<img SRC="../images/right_triangle_option.png"

12391

ALT=">" BORDER=0 height=14

12392

width=15><b><font face="Helvetica, Arial"

12393

><font color="#FFFFFF"><font size="+1">

12394

<a href="GraphicsMagick.html#details-background">-background</a> <i><color></i>

12395

</font></font></font></b></td></tr></table>

12396

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

12397

12398

<tr>

12399

12400

12401

<img SRC="../images/right_triangle_option.png"

12402

ALT=">" BORDER=0 height=14

12403

width=15><b><font face="Helvetica, Arial"

12404

><font color="#FFFFFF"><font size="+1">

12405

<a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i>

12406

</font></font></font></b></td></tr></table>

12407

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table>

12408

12409

<tr>

12410

12411

12412

<img SRC="../images/right_triangle_option.png"

12413

ALT=">" BORDER=0 height=14

12414

width=15><b><font face="Helvetica, Arial"

12415

><font color="#FFFFFF"><font size="+1">

12416

12417

</font></font></font></b></td></tr></table>

12418

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

12419

12420

<tr>

12421

12422

12423

<img SRC="../images/right_triangle_option.png"

12424

ALT=">" BORDER=0 height=14

12425

width=15><b><font face="Helvetica, Arial"

12426

><font color="#FFFFFF"><font size="+1">

12427

<a href="GraphicsMagick.html#details-border">-border</a> <i><width>x<height></i>

12428

</font></font></font></b></td></tr></table>

12429

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table>

12430

12431

<tr>

12432

12433

12434

<img SRC="../images/right_triangle_option.png"

12435

ALT=">" BORDER=0 height=14

12436

width=15><b><font face="Helvetica, Arial"

12437

><font color="#FFFFFF"><font size="+1">

12438

<a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i>

12439

</font></font></font></b></td></tr></table>

12440

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

12441

12442

<tr>

12443

12444

12445

<img SRC="../images/right_triangle_option.png"

12446

ALT=">" BORDER=0 height=14

12447

width=15><b><font face="Helvetica, Arial"

12448

><font color="#FFFFFF"><font size="+1">

12449

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

12450

</font></font></font></b></td></tr></table>

12451

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

12452

12453

<tr>

12454

12455

12456

<img SRC="../images/right_triangle_option.png"

12457

ALT=">" BORDER=0 height=14

12458

width=15><b><font face="Helvetica, Arial"

12459

><font color="#FFFFFF"><font size="+1">

12460

<a href="GraphicsMagick.html#details-channel">-channel</a> <i><type></i>

12461

</font></font></font></b></td></tr></table>

12462

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of channel</td></tr></table>

12463

12464

<tr>

12465

12466

12467

<img SRC="../images/right_triangle_option.png"

12468

ALT=">" BORDER=0 height=14

12469

width=15><b><font face="Helvetica, Arial"

12470

><font color="#FFFFFF"><font size="+1">

12471

-charcoal <i><factor></i>

12472

</font></font></font></b></td></tr></table>

12473

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate a charcoal drawing</td></tr></table>

12474

12475

<tr>

12476

12477

12478

<img SRC="../images/right_triangle_option.png"

12479

ALT=">" BORDER=0 height=14

12480

width=15><b><font face="Helvetica, Arial"

12481

><font color="#FFFFFF"><font size="+1">

12482

<a href="GraphicsMagick.html#details-colorize">-colorize</a> <i><value></i>

12483

</font></font></font></b></td></tr></table>

12484

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colorize the image with the pen color</td></tr></table>

12485

12486

<tr>

12487

12488

12489

<img SRC="../images/right_triangle_option.png"

12490

ALT=">" BORDER=0 height=14

12491

width=15><b><font face="Helvetica, Arial"

12492

><font color="#FFFFFF"><font size="+1">

12493

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

12494

</font></font></font></b></td></tr></table>

12495

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

12496

12497

<tr>

12498

12499

12500

<img SRC="../images/right_triangle_option.png"

12501

ALT=">" BORDER=0 height=14

12502

width=15><b><font face="Helvetica, Arial"

12503

><font color="#FFFFFF"><font size="+1">

12504

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

12505

</font></font></font></b></td></tr></table>

12506

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

12507

12508

<tr>

12509

12510

12511

<img SRC="../images/right_triangle_option.png"

12512

ALT=">" BORDER=0 height=14

12513

width=15><b><font face="Helvetica, Arial"

12514

><font color="#FFFFFF"><font size="+1">

12515

<a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i>

12516

</font></font></font></b></td></tr></table>

12517

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

12518

12519

<tr>

12520

12521

12522

<img SRC="../images/right_triangle_option.png"

12523

ALT=">" BORDER=0 height=14

12524

width=15><b><font face="Helvetica, Arial"

12525

><font color="#FFFFFF"><font size="+1">

12526

<a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i>

12527

</font></font></font></b></td></tr></table>

12528

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table>

12529

12530

<tr>

12531

12532

12533

<img SRC="../images/right_triangle_option.png"

12534

ALT=">" BORDER=0 height=14

12535

width=15><b><font face="Helvetica, Arial"

12536

><font color="#FFFFFF"><font size="+1">

12537

<a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i>

12538

</font></font></font></b></td></tr></table>

12539

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>

12540

12541

<tr>

12542

12543

12544

<img SRC="../images/right_triangle_option.png"

12545

ALT=">" BORDER=0 height=14

12546

width=15><b><font face="Helvetica, Arial"

12547

><font color="#FFFFFF"><font size="+1">

12548

<a href="GraphicsMagick.html#details-contrast">-contrast</a>

12549

</font></font></font></b></td></tr></table>

12550

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table>

12551

12552

<tr>

12553

12554

12555

<img SRC="../images/right_triangle_option.png"

12556

ALT=">" BORDER=0 height=14

12557

width=15><b><font face="Helvetica, Arial"

12558

><font color="#FFFFFF"><font size="+1">

12559

<a href="GraphicsMagick.html#details-convolve">-convolve</a> <i><kernel></i>

12560

</font></font></font></b></td></tr></table>

12561

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>convolve image with the specified convolution kernel</td></tr></table>

12562

12563

<tr>

12564

12565

12566

<img SRC="../images/right_triangle_option.png"

12567

ALT=">" BORDER=0 height=14

12568

width=15><b><font face="Helvetica, Arial"

12569

><font color="#FFFFFF"><font size="+1">

12570

12571

</font></font></font></b></td></tr></table>

12572

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

12573

12574

<tr>

12575

12576

12577

<img SRC="../images/right_triangle_option.png"

12578

ALT=">" BORDER=0 height=14

12579

width=15><b><font face="Helvetica, Arial"

12580

><font color="#FFFFFF"><font size="+1">

12581

<a href="GraphicsMagick.html#details-cycle">-cycle</a> <i><amount></i>

12582

</font></font></font></b></td></tr></table>

12583

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image colormap by amount</td></tr></table>

12584

12585

<tr>

12586

12587

12588

<img SRC="../images/right_triangle_option.png"

12589

ALT=">" BORDER=0 height=14

12590

width=15><b><font face="Helvetica, Arial"

12591

><font color="#FFFFFF"><font size="+1">

12592

-debug <i><events></i>

12593

</font></font></font></b></td></tr></table>

12594

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

12595

12596

<tr>

12597

12598

12599

<img SRC="../images/right_triangle_option.png"

12600

ALT=">" BORDER=0 height=14

12601

width=15><b><font face="Helvetica, Arial"

12602

><font color="#FFFFFF"><font size="+1">

12603

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

12604

</font></font></font></b></td></tr></table>

12605

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

12606

12607

<tr>

12608

12609

12610

<img SRC="../images/right_triangle_option.png"

12611

ALT=">" BORDER=0 height=14

12612

width=15><b><font face="Helvetica, Arial"

12613

><font color="#FFFFFF"><font size="+1">

12614

<a href="GraphicsMagick.html#details-delay">-delay</a> <i><1/100ths of a second></i>

12615

</font></font></font></b></td></tr></table>

12616

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>

12617

12618

<tr>

12619

12620

12621

<img SRC="../images/right_triangle_option.png"

12622

ALT=">" BORDER=0 height=14

12623

width=15><b><font face="Helvetica, Arial"

12624

><font color="#FFFFFF"><font size="+1">

12625

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

12626

</font></font></font></b></td></tr></table>

12627

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

12628

12629

<tr>

12630

12631

12632

<img SRC="../images/right_triangle_option.png"

12633

ALT=">" BORDER=0 height=14

12634

width=15><b><font face="Helvetica, Arial"

12635

><font color="#FFFFFF"><font size="+1">

12636

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

12637

</font></font></font></b></td></tr></table>

12638

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

12639

12640

<tr>

12641

12642

12643

<img SRC="../images/right_triangle_option.png"

12644

ALT=">" BORDER=0 height=14

12645

width=15><b><font face="Helvetica, Arial"

12646

><font color="#FFFFFF"><font size="+1">

12647

-despeckle

12648

</font></font></font></b></td></tr></table>

12649

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table>

12650

12651

<tr>

12652

12653

12654

<img SRC="../images/right_triangle_option.png"

12655

ALT=">" BORDER=0 height=14

12656

width=15><b><font face="Helvetica, Arial"

12657

><font color="#FFFFFF"><font size="+1">

12658

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

12659

</font></font></font></b></td></tr></table>

12660

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

12661

12662

<tr>

12663

12664

12665

<img SRC="../images/right_triangle_option.png"

12666

ALT=">" BORDER=0 height=14

12667

width=15><b><font face="Helvetica, Arial"

12668

><font color="#FFFFFF"><font size="+1">

12669

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

12670

</font></font></font></b></td></tr></table>

12671

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

12672

12673

<tr>

12674

12675

12676

<img SRC="../images/right_triangle_option.png"

12677

ALT=">" BORDER=0 height=14

12678

width=15><b><font face="Helvetica, Arial"

12679

><font color="#FFFFFF"><font size="+1">

12680

<a href="GraphicsMagick.html#details-dither">-dither</a>

12681

</font></font></font></b></td></tr></table>

12682

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

12683

12684

<tr>

12685

12686

12687

<img SRC="../images/right_triangle_option.png"

12688

ALT=">" BORDER=0 height=14

12689

width=15><b><font face="Helvetica, Arial"

12690

><font color="#FFFFFF"><font size="+1">

12691

12692

</font></font></font></b></td></tr></table>

12693

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table>

12694

12695

<tr>

12696

12697

12698

<img SRC="../images/right_triangle_option.png"

12699

ALT=">" BORDER=0 height=14

12700

width=15><b><font face="Helvetica, Arial"

12701

><font color="#FFFFFF"><font size="+1">

12702

-edge <i><radius></i>

12703

</font></font></font></b></td></tr></table>

12704

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table>

12705

12706

<tr>

12707

12708

12709

<img SRC="../images/right_triangle_option.png"

12710

ALT=">" BORDER=0 height=14

12711

width=15><b><font face="Helvetica, Arial"

12712

><font color="#FFFFFF"><font size="+1">

12713

-emboss <i><radius></i>

12714

</font></font></font></b></td></tr></table>

12715

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>emboss an image</td></tr></table>

12716

12717

<tr>

12718

12719

12720

<img SRC="../images/right_triangle_option.png"

12721

ALT=">" BORDER=0 height=14

12722

width=15><b><font face="Helvetica, Arial"

12723

><font color="#FFFFFF"><font size="+1">

12724

<a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i>

12725

</font></font></font></b></td></tr></table>

12726

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table>

12727

12728

<tr>

12729

12730

12731

<img SRC="../images/right_triangle_option.png"

12732

ALT=">" BORDER=0 height=14

12733

width=15><b><font face="Helvetica, Arial"

12734

><font color="#FFFFFF"><font size="+1">

12735

<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>

12736

</font></font></font></b></td></tr></table>

12737

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

12738

12739

<tr>

12740

12741

12742

<img SRC="../images/right_triangle_option.png"

12743

ALT=">" BORDER=0 height=14

12744

width=15><b><font face="Helvetica, Arial"

12745

><font color="#FFFFFF"><font size="+1">

12746

-enhance

12747

</font></font></font></b></td></tr></table>

12748

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table>

12749

12750

<tr>

12751

12752

12753

<img SRC="../images/right_triangle_option.png"

12754

ALT=">" BORDER=0 height=14

12755

width=15><b><font face="Helvetica, Arial"

12756

><font color="#FFFFFF"><font size="+1">

12757

-equalize

12758

</font></font></font></b></td></tr></table>

12759

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform histogram equalization to the image</td></tr></table>

12760

12761

<tr>

12762

12763

12764

<img SRC="../images/right_triangle_option.png"

12765

ALT=">" BORDER=0 height=14

12766

width=15><b><font face="Helvetica, Arial"

12767

><font color="#FFFFFF"><font size="+1">

12768

12769

</font></font></font></b></td></tr></table>

12770

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table>

12771

12772

<tr>

12773

12774

12775

<img SRC="../images/right_triangle_option.png"

12776

ALT=">" BORDER=0 height=14

12777

width=15><b><font face="Helvetica, Arial"

12778

><font color="#FFFFFF"><font size="+1">

12779

<a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i>

12780

</font></font></font></b></td></tr></table>

12781

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>

12782

12783

<tr>

12784

12785

12786

<img SRC="../images/right_triangle_option.png"

12787

ALT=">" BORDER=0 height=14

12788

width=15><b><font face="Helvetica, Arial"

12789

><font color="#FFFFFF"><font size="+1">

12790

12791

</font></font></font></b></td></tr></table>

12792

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

12793

12794

<tr>

12795

12796

12797

<img SRC="../images/right_triangle_option.png"

12798

ALT=">" BORDER=0 height=14

12799

width=15><b><font face="Helvetica, Arial"

12800

><font color="#FFFFFF"><font size="+1">

12801

12802

</font></font></font></b></td></tr></table>

12803

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>

12804

12805

<tr>

12806

12807

12808

<img SRC="../images/right_triangle_option.png"

12809

ALT=">" BORDER=0 height=14

12810

width=15><b><font face="Helvetica, Arial"

12811

><font color="#FFFFFF"><font size="+1">

12812

12813

</font></font></font></b></td></tr></table>

12814

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

12815

12816

<tr>

12817

12818

12819

<img SRC="../images/right_triangle_option.png"

12820

ALT=">" BORDER=0 height=14

12821

width=15><b><font face="Helvetica, Arial"

12822

><font color="#FFFFFF"><font size="+1">

12823

<a href="GraphicsMagick.html#details-format">-format</a> <i><type></i>

12824

</font></font></font></b></td></tr></table>

12825

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image format type</td></tr></table>

12826

12827

<tr>

12828

12829

12830

<img SRC="../images/right_triangle_option.png"

12831

ALT=">" BORDER=0 height=14

12832

width=15><b><font face="Helvetica, Arial"

12833

><font color="#FFFFFF"><font size="+1">

12834

<a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i>

12835

</font></font></font></b></td></tr></table>

12836

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table>

12837

12838

<tr>

12839

12840

12841

<img SRC="../images/right_triangle_option.png"

12842

ALT=">" BORDER=0 height=14

12843

width=15><b><font face="Helvetica, Arial"

12844

><font color="#FFFFFF"><font size="+1">

12845

12846

</font></font></font></b></td></tr></table>

12847

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors within this distance are considered equal</td></tr></table>

12848

12849

<tr>

12850

12851

12852

<img SRC="../images/right_triangle_option.png"

12853

ALT=">" BORDER=0 height=14

12854

width=15><b><font face="Helvetica, Arial"

12855

><font color="#FFFFFF"><font size="+1">

12856

<a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i>

12857

</font></font></font></b></td></tr></table>

12858

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>

12859

12860

<tr>

12861

12862

12863

<img SRC="../images/right_triangle_option.png"

12864

ALT=">" BORDER=0 height=14

12865

width=15><b><font face="Helvetica, Arial"

12866

><font color="#FFFFFF"><font size="+1">

12867

<a href="GraphicsMagick.html#details-Gaussian">-Gaussian</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

12868

</font></font></font></b></td></tr></table>

12869

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

12870

12871

<tr>

12872

12873

12874

<img SRC="../images/right_triangle_option.png"

12875

ALT=">" BORDER=0 height=14

12876

width=15><b><font face="Helvetica, Arial"

12877

><font color="#FFFFFF"><font size="+1">

12878

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

12879

</font></font></font></b></td></tr></table>

12880

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

12881

12882

<tr>

12883

12884

12885

<img SRC="../images/right_triangle_option.png"

12886

ALT=">" BORDER=0 height=14

12887

width=15><b><font face="Helvetica, Arial"

12888

><font color="#FFFFFF"><font size="+1">

12889

<a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i>

12890

</font></font></font></b></td></tr></table>

12891

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table>

12892

12893

<tr>

12894

12895

12896

<img SRC="../images/right_triangle_option.png"

12897

ALT=">" BORDER=0 height=14

12898

width=15><b><font face="Helvetica, Arial"

12899

><font color="#FFFFFF"><font size="+1">

12900

<a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i>

12901

</font></font></font></b></td></tr></table>

12902

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table>

12903

12904

<tr>

12905

12906

12907

<img SRC="../images/right_triangle_option.png"

12908

ALT=">" BORDER=0 height=14

12909

width=15><b><font face="Helvetica, Arial"

12910

><font color="#FFFFFF"><font size="+1">

12911

-help

12912

</font></font></font></b></td></tr></table>

12913

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

12914

12915

<tr>

12916

12917

12918

<img SRC="../images/right_triangle_option.png"

12919

ALT=">" BORDER=0 height=14

12920

width=15><b><font face="Helvetica, Arial"

12921

><font color="#FFFFFF"><font size="+1">

12922

-implode <i><factor></i>

12923

</font></font></font></b></td></tr></table>

12924

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>implode image pixels about the center</td></tr></table>

12925

12926

<tr>

12927

12928

12929

<img SRC="../images/right_triangle_option.png"

12930

ALT=">" BORDER=0 height=14

12931

width=15><b><font face="Helvetica, Arial"

12932

><font color="#FFFFFF"><font size="+1">

12933

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

12934

</font></font></font></b></td></tr></table>

12935

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

12936

12937

<tr>

12938

12939

12940

<img SRC="../images/right_triangle_option.png"

12941

ALT=">" BORDER=0 height=14

12942

width=15><b><font face="Helvetica, Arial"

12943

><font color="#FFFFFF"><font size="+1">

12944

<a href="GraphicsMagick.html#details-label">-label</a> <i><name></i>

12945

</font></font></font></b></td></tr></table>

12946

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

12947

12948

<tr>

12949

12950

12951

<img SRC="../images/right_triangle_option.png"

12952

ALT=">" BORDER=0 height=14

12953

width=15><b><font face="Helvetica, Arial"

12954

><font color="#FFFFFF"><font size="+1">

12955

-lat <i><width>x<height></i>{<i>+-</i>}<i><offset></i>{<i>%</i>}<i></i>

12956

</font></font></font></b></td></tr></table>

12957

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>perform local adaptive thresholding</td></tr></table>

12958

12959

<tr>

12960

12961

12962

<img SRC="../images/right_triangle_option.png"

12963

ALT=">" BORDER=0 height=14

12964

width=15><b><font face="Helvetica, Arial"

12965

><font color="#FFFFFF"><font size="+1">

12966

<a href="GraphicsMagick.html#details-level">-level</a> <i><black_point></i>{<i>,<gamma></i>}<i></i>{<i>,<white_point></i>}<i></i>{<i>%</i>}<i></i>

12967

</font></font></font></b></td></tr></table>

12968

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>adjust the level of image contrast</td></tr></table>

12969

12970

<tr>

12971

12972

12973

<img SRC="../images/right_triangle_option.png"

12974

ALT=">" BORDER=0 height=14

12975

width=15><b><font face="Helvetica, Arial"

12976

><font color="#FFFFFF"><font size="+1">

12977

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

12978

</font></font></font></b></td></tr></table>

12979

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

12980

12981

<tr>

12982

12983

12984

<img SRC="../images/right_triangle_option.png"

12985

ALT=">" BORDER=0 height=14

12986

width=15><b><font face="Helvetica, Arial"

12987

><font color="#FFFFFF"><font size="+1">

12988

-linewidth

12989

</font></font></font></b></td></tr></table>

12990

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the line width for subsequent draw operations</td></tr></table>

12991

12992

<tr>

12993

12994

12995

<img SRC="../images/right_triangle_option.png"

12996

ALT=">" BORDER=0 height=14

12997

width=15><b><font face="Helvetica, Arial"

12998

><font color="#FFFFFF"><font size="+1">

12999

13000

</font></font></font></b></td></tr></table>

13001

13002

13003

<tr>

13004

13005

13006

<img SRC="../images/right_triangle_option.png"

13007

ALT=">" BORDER=0 height=14

13008

width=15><b><font face="Helvetica, Arial"

13009

><font color="#FFFFFF"><font size="+1">

13010

13011

</font></font></font></b></td></tr></table>

13012

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

13013

13014

<tr>

13015

13016

13017

<img SRC="../images/right_triangle_option.png"

13018

ALT=">" BORDER=0 height=14

13019

width=15><b><font face="Helvetica, Arial"

13020

><font color="#FFFFFF"><font size="+1">

13021

13022

</font></font></font></b></td></tr></table>

13023

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add Netscape loop extension to your GIF animation</td></tr></table>

13024

13025

<tr>

13026

13027

13028

<img SRC="../images/right_triangle_option.png"

13029

ALT=">" BORDER=0 height=14

13030

width=15><b><font face="Helvetica, Arial"

13031

><font color="#FFFFFF"><font size="+1">

13032

13033

</font></font></font></b></td></tr></table>

13034

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>choose a particular set of colors from this image</td></tr></table>

13035

13036

<tr>

13037

13038

13039

<img SRC="../images/right_triangle_option.png"

13040

ALT=">" BORDER=0 height=14

13041

width=15><b><font face="Helvetica, Arial"

13042

><font color="#FFFFFF"><font size="+1">

13043

13044

</font></font></font></b></td></tr></table>

13045

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify a clipping mask</td></tr></table>

13046

13047

<tr>

13048

13049

13050

<img SRC="../images/right_triangle_option.png"

13051

ALT=">" BORDER=0 height=14

13052

width=15><b><font face="Helvetica, Arial"

13053

><font color="#FFFFFF"><font size="+1">

13054

<a href="GraphicsMagick.html#details-matte">-matte</a>

13055

</font></font></font></b></td></tr></table>

13056

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

13057

13058

<tr>

13059

13060

13061

<img SRC="../images/right_triangle_option.png"

13062

ALT=">" BORDER=0 height=14

13063

width=15><b><font face="Helvetica, Arial"

13064

><font color="#FFFFFF"><font size="+1">

13065

<a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i>

13066

</font></font></font></b></td></tr></table>

13067

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>

13068

13069

<tr>

13070

13071

13072

<img SRC="../images/right_triangle_option.png"

13073

ALT=">" BORDER=0 height=14

13074

width=15><b><font face="Helvetica, Arial"

13075

><font color="#FFFFFF"><font size="+1">

13076

-median <i><radius></i>

13077

</font></font></font></b></td></tr></table>

13078

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a median filter to the image</td></tr></table>

13079

13080

<tr>

13081

13082

13083

<img SRC="../images/right_triangle_option.png"

13084

ALT=">" BORDER=0 height=14

13085

width=15><b><font face="Helvetica, Arial"

13086

><font color="#FFFFFF"><font size="+1">

13087

<a href="GraphicsMagick.html#details-modulate">-modulate</a> <i>brightness[,saturation[,hue]]</i>

13088

</font></font></font></b></td></tr></table>

13089

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>vary the brightness, saturation, and hue of an image</td></tr></table>

13090

13091

<tr>

13092

13093

13094

<img SRC="../images/right_triangle_option.png"

13095

ALT=">" BORDER=0 height=14

13096

width=15><b><font face="Helvetica, Arial"

13097

><font color="#FFFFFF"><font size="+1">

13098

-monochrome

13099

</font></font></font></b></td></tr></table>

13100

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

13101

13102

<tr>

13103

13104

13105

<img SRC="../images/right_triangle_option.png"

13106

ALT=">" BORDER=0 height=14

13107

width=15><b><font face="Helvetica, Arial"

13108

><font color="#FFFFFF"><font size="+1">

13109

<a href="GraphicsMagick.html#details-negate">-negate</a>

13110

</font></font></font></b></td></tr></table>

13111

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>

13112

13113

<tr>

13114

13115

13116

<img SRC="../images/right_triangle_option.png"

13117

ALT=">" BORDER=0 height=14

13118

width=15><b><font face="Helvetica, Arial"

13119

><font color="#FFFFFF"><font size="+1">

13120

<a href="GraphicsMagick.html#details-noise">-noise</a> <i><radius|type></i>

13121

</font></font></font></b></td></tr></table>

13122

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add or reduce noise in an image</td></tr></table>

13123

13124

<tr>

13125

13126

13127

<img SRC="../images/right_triangle_option.png"

13128

ALT=">" BORDER=0 height=14

13129

width=15><b><font face="Helvetica, Arial"

13130

><font color="#FFFFFF"><font size="+1">

13131

13132

</font></font></font></b></td></tr></table>

13133

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>

13134

13135

<tr>

13136

13137

13138

<img SRC="../images/right_triangle_option.png"

13139

ALT=">" BORDER=0 height=14

13140

width=15><b><font face="Helvetica, Arial"

13141

><font color="#FFFFFF"><font size="+1">

13142

<a href="GraphicsMagick.html#details-normalize">-normalize</a>

13143

</font></font></font></b></td></tr></table>

13144

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform image to span the full range of color values</td></tr></table>

13145

13146

<tr>

13147

13148

13149

<img SRC="../images/right_triangle_option.png"

13150

ALT=">" BORDER=0 height=14

13151

width=15><b><font face="Helvetica, Arial"

13152

><font color="#FFFFFF"><font size="+1">

13153

<a href="GraphicsMagick.html#details-opaque">-opaque</a> <i><color></i>

13154

</font></font></font></b></td></tr></table>

13155

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>change this color to the pen color within the image</td></tr></table>

13156

13157

<tr>

13158

13159

13160

<img SRC="../images/right_triangle_option.png"

13161

ALT=">" BORDER=0 height=14

13162

width=15><b><font face="Helvetica, Arial"

13163

><font color="#FFFFFF"><font size="+1">

13164

<a href="GraphicsMagick.html#details-operator">-operator</a> <i>channel operator rvalue[%]</i>

13165

</font></font></font></b></td></tr></table>

13166

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply a mathematical or bitwise operator to an image channel</td></tr></table>

13167

13168

<tr>

13169

13170

13171

<img SRC="../images/right_triangle_option.png"

13172

ALT=">" BORDER=0 height=14

13173

width=15><b><font face="Helvetica, Arial"

13174

><font color="#FFFFFF"><font size="+1">

13175

<a href="GraphicsMagick.html#details-ordered-dither">-ordered-dither</a> <i><channeltype> <NxN></i>

13176

</font></font></font></b></td></tr></table>

13177

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>ordered dither the image</td></tr></table>

13178

13179

<tr>

13180

13181

13182

<img SRC="../images/right_triangle_option.png"

13183

ALT=">" BORDER=0 height=14

13184

width=15><b><font face="Helvetica, Arial"

13185

><font color="#FFFFFF"><font size="+1">

13186

13187

</font></font></font></b></td></tr></table>

13188

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

13189

13190

<tr>

13191

13192

13193

<img SRC="../images/right_triangle_option.png"

13194

ALT=">" BORDER=0 height=14

13195

width=15><b><font face="Helvetica, Arial"

13196

><font color="#FFFFFF"><font size="+1">

13197

<a href="GraphicsMagick.html#details-paint">-paint</a> <i><radius></i>

13198

</font></font></font></b></td></tr></table>

13199

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>simulate an oil painting</td></tr></table>

13200

13201

<tr>

13202

13203

13204

<img SRC="../images/right_triangle_option.png"

13205

ALT=">" BORDER=0 height=14

13206

width=15><b><font face="Helvetica, Arial"

13207

><font color="#FFFFFF"><font size="+1">

13208

13209

</font></font></font></b></td></tr></table>

13210

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table>

13211

13212

<tr>

13213

13214

13215

<img SRC="../images/right_triangle_option.png"

13216

ALT=">" BORDER=0 height=14

13217

width=15><b><font face="Helvetica, Arial"

13218

><font color="#FFFFFF"><font size="+1">

13219

-pointsize <i><value></i>

13220

</font></font></font></b></td></tr></table>

13221

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, OPTION1, or TrueType font</td></tr></table>

13222

13223

<tr>

13224

13225

13226

<img SRC="../images/right_triangle_option.png"

13227

ALT=">" BORDER=0 height=14

13228

width=15><b><font face="Helvetica, Arial"

13229

><font color="#FFFFFF"><font size="+1">

13230

<a href="GraphicsMagick.html#details-profile">-profile</a> <i><filename></i>

13231

</font></font></font></b></td></tr></table>

13232

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add ICM, IPTC, or generic profile to image</td></tr></table>

13233

13234

<tr>

13235

13236

13237

<img SRC="../images/right_triangle_option.png"

13238

ALT=">" BORDER=0 height=14

13239

width=15><b><font face="Helvetica, Arial"

13240

><font color="#FFFFFF"><font size="+1">

13241

<a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i>

13242

</font></font></font></b></td></tr></table>

13243

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

13244

13245

<tr>

13246

13247

13248

<img SRC="../images/right_triangle_option.png"

13249

ALT=">" BORDER=0 height=14

13250

width=15><b><font face="Helvetica, Arial"

13251

><font color="#FFFFFF"><font size="+1">

13252

<a href="GraphicsMagick.html#details-raise">-raise</a> <i><width>x<height></i>

13253

</font></font></font></b></td></tr></table>

13254

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table>

13255

13256

<tr>

13257

13258

13259

<img SRC="../images/right_triangle_option.png"

13260

ALT=">" BORDER=0 height=14

13261

width=15><b><font face="Helvetica, Arial"

13262

><font color="#FFFFFF"><font size="+1">

13263

<a href="GraphicsMagick.html#details-random-threshold">-random-threshold</a> <i><channeltype> <LOWxHIGH></i>

13264

</font></font></font></b></td></tr></table>

13265

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>random threshold the image</td></tr></table>

13266

13267

<tr>

13268

13269

13270

<img SRC="../images/right_triangle_option.png"

13271

ALT=">" BORDER=0 height=14

13272

width=15><b><font face="Helvetica, Arial"

13273

><font color="#FFFFFF"><font size="+1">

13274

<a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i>

13275

</font></font></font></b></td></tr></table>

13276

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table>

13277

13278

<tr>

13279

13280

13281

<img SRC="../images/right_triangle_option.png"

13282

ALT=">" BORDER=0 height=14

13283

width=15><b><font face="Helvetica, Arial"

13284

><font color="#FFFFFF"><font size="+1">

13285

<a href="GraphicsMagick.html#details-region">-region</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>

13286

</font></font></font></b></td></tr></table>

13287

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply options to a portion of the image</td></tr></table>

13288

13289

<tr>

13290

13291

13292

<img SRC="../images/right_triangle_option.png"

13293

ALT=">" BORDER=0 height=14

13294

width=15><b><font face="Helvetica, Arial"

13295

><font color="#FFFFFF"><font size="+1">

13296

<a href="GraphicsMagick.html#details-render">-render</a>

13297

</font></font></font></b></td></tr></table>

13298

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table>

13299

13300

<tr>

13301

13302

13303

<img SRC="../images/right_triangle_option.png"

13304

ALT=">" BORDER=0 height=14

13305

width=15><b><font face="Helvetica, Arial"

13306

><font color="#FFFFFF"><font size="+1">

13307

<a href="GraphicsMagick.html#details-resample">-resample</a> <i><horizontal>x<vertical></i>

13308

</font></font></font></b></td></tr></table>

13309

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Resample image to specified horizontal and vertical resolution</td></tr></table>

13310

13311

<tr>

13312

13313

13314

<img SRC="../images/right_triangle_option.png"

13315

ALT=">" BORDER=0 height=14

13316

width=15><b><font face="Helvetica, Arial"

13317

><font color="#FFFFFF"><font size="+1">

13318

<a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

13319

</font></font></font></b></td></tr></table>

13320

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table>

13321

13322

<tr>

13323

13324

13325

<img SRC="../images/right_triangle_option.png"

13326

ALT=">" BORDER=0 height=14

13327

width=15><b><font face="Helvetica, Arial"

13328

><font color="#FFFFFF"><font size="+1">

13329

13330

</font></font></font></b></td></tr></table>

13331

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table>

13332

13333

<tr>

13334

13335

13336

<img SRC="../images/right_triangle_option.png"

13337

ALT=">" BORDER=0 height=14

13338

width=15><b><font face="Helvetica, Arial"

13339

><font color="#FFFFFF"><font size="+1">

13340

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

13341

</font></font></font></b></td></tr></table>

13342

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

13343

13344

<tr>

13345

13346

13347

<img SRC="../images/right_triangle_option.png"

13348

ALT=">" BORDER=0 height=14

13349

width=15><b><font face="Helvetica, Arial"

13350

><font color="#FFFFFF"><font size="+1">

13351

<a href="GraphicsMagick.html#details-sample">-sample</a> <i><geometry></i>

13352

</font></font></font></b></td></tr></table>

13353

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table>

13354

13355

<tr>

13356

13357

13358

<img SRC="../images/right_triangle_option.png"

13359

ALT=">" BORDER=0 height=14

13360

width=15><b><font face="Helvetica, Arial"

13361

><font color="#FFFFFF"><font size="+1">

13362

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

13363

</font></font></font></b></td></tr></table>

13364

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

13365

13366

<tr>

13367

13368

13369

<img SRC="../images/right_triangle_option.png"

13370

ALT=">" BORDER=0 height=14

13371

width=15><b><font face="Helvetica, Arial"

13372

><font color="#FFFFFF"><font size="+1">

13373

<a href="GraphicsMagick.html#details-scale">-scale</a> <i><geometry></i>

13374

</font></font></font></b></td></tr></table>

13375

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>scale the image.</td></tr></table>

13376

13377

<tr>

13378

13379

13380

<img SRC="../images/right_triangle_option.png"

13381

ALT=">" BORDER=0 height=14

13382

width=15><b><font face="Helvetica, Arial"

13383

><font color="#FFFFFF"><font size="+1">

13384

<a href="GraphicsMagick.html#details-scene">-scene</a> <i><value></i>

13385

</font></font></font></b></td></tr></table>

13386

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set scene number</td></tr></table>

13387

13388

<tr>

13389

13390

13391

<img SRC="../images/right_triangle_option.png"

13392

ALT=">" BORDER=0 height=14

13393

width=15><b><font face="Helvetica, Arial"

13394

><font color="#FFFFFF"><font size="+1">

13395

<a href="GraphicsMagick.html#details-segment">-segment</a> <i><cluster threshold>x<smoothing threshold></i>

13396

</font></font></font></b></td></tr></table>

13397

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>segment an image</td></tr></table>

13398

13399

<tr>

13400

13401

13402

<img SRC="../images/right_triangle_option.png"

13403

ALT=">" BORDER=0 height=14

13404

width=15><b><font face="Helvetica, Arial"

13405

><font color="#FFFFFF"><font size="+1">

13406

<a href="GraphicsMagick.html#details-shade">-shade</a> <i><azimuth>x<elevation></i>

13407

</font></font></font></b></td></tr></table>

13408

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shade the image using a distant light source</td></tr></table>

13409

13410

<tr>

13411

13412

13413

<img SRC="../images/right_triangle_option.png"

13414

ALT=">" BORDER=0 height=14

13415

width=15><b><font face="Helvetica, Arial"

13416

><font color="#FFFFFF"><font size="+1">

13417

<a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

13418

</font></font></font></b></td></tr></table>

13419

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>

13420

13421

<tr>

13422

13423

13424

<img SRC="../images/right_triangle_option.png"

13425

ALT=">" BORDER=0 height=14

13426

width=15><b><font face="Helvetica, Arial"

13427

><font color="#FFFFFF"><font size="+1">

13428

<a href="GraphicsMagick.html#details-shave">-shave</a> <i><width>x<height></i>{<i>%</i>}<i></i>

13429

</font></font></font></b></td></tr></table>

13430

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shave pixels from the image edges</td></tr></table>

13431

13432

<tr>

13433

13434

13435

<img SRC="../images/right_triangle_option.png"

13436

ALT=">" BORDER=0 height=14

13437

width=15><b><font face="Helvetica, Arial"

13438

><font color="#FFFFFF"><font size="+1">

13439

<a href="GraphicsMagick.html#details-shear">-shear</a> <i><x degrees>x<y degrees></i>

13440

</font></font></font></b></td></tr></table>

13441

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shear the image along the X or Y axis</td></tr></table>

13442

13443

<tr>

13444

13445

13446

<img SRC="../images/right_triangle_option.png"

13447

ALT=">" BORDER=0 height=14

13448

width=15><b><font face="Helvetica, Arial"

13449

><font color="#FFFFFF"><font size="+1">

13450

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

13451

</font></font></font></b></td></tr></table>

13452

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

13453

13454

<tr>

13455

13456

13457

<img SRC="../images/right_triangle_option.png"

13458

ALT=">" BORDER=0 height=14

13459

width=15><b><font face="Helvetica, Arial"

13460

><font color="#FFFFFF"><font size="+1">

13461

<a href="GraphicsMagick.html#details-solarize">-solarize</a> <i><factor></i>

13462

</font></font></font></b></td></tr></table>

13463

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>negate all pixels above the threshold level</td></tr></table>

13464

13465

<tr>

13466

13467

13468

<img SRC="../images/right_triangle_option.png"

13469

ALT=">" BORDER=0 height=14

13470

width=15><b><font face="Helvetica, Arial"

13471

><font color="#FFFFFF"><font size="+1">

13472

<a href="GraphicsMagick.html#details-spread">-spread</a> <i><amount></i>

13473

</font></font></font></b></td></tr></table>

13474

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>displace image pixels by a random amount</td></tr></table>

13475

13476

<tr>

13477

13478

13479

<img SRC="../images/right_triangle_option.png"

13480

ALT=">" BORDER=0 height=14

13481

width=15><b><font face="Helvetica, Arial"

13482

><font color="#FFFFFF"><font size="+1">

13483

<a href="GraphicsMagick.html#details-stroke">-stroke</a> <i><color></i>

13484

</font></font></font></b></td></tr></table>

13485

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table>

13486

13487

<tr>

13488

13489

13490

<img SRC="../images/right_triangle_option.png"

13491

ALT=">" BORDER=0 height=14

13492

width=15><b><font face="Helvetica, Arial"

13493

><font color="#FFFFFF"><font size="+1">

13494

<a href="GraphicsMagick.html#details-strokewidth">-strokewidth</a> <i><value></i>

13495

</font></font></font></b></td></tr></table>

13496

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table>

13497

13498

<tr>

13499

13500

13501

<img SRC="../images/right_triangle_option.png"

13502

ALT=">" BORDER=0 height=14

13503

width=15><b><font face="Helvetica, Arial"

13504

><font color="#FFFFFF"><font size="+1">

13505

<a href="GraphicsMagick.html#details-swirl">-swirl</a> <i><degrees></i>

13506

</font></font></font></b></td></tr></table>

13507

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>swirl image pixels about the center</td></tr></table>

13508

13509

<tr>

13510

13511

13512

<img SRC="../images/right_triangle_option.png"

13513

ALT=">" BORDER=0 height=14

13514

width=15><b><font face="Helvetica, Arial"

13515

><font color="#FFFFFF"><font size="+1">

13516

-texture <i><filename></i>

13517

</font></font></font></b></td></tr></table>

13518

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table>

13519

13520

<tr>

13521

13522

13523

<img SRC="../images/right_triangle_option.png"

13524

ALT=">" BORDER=0 height=14

13525

width=15><b><font face="Helvetica, Arial"

13526

><font color="#FFFFFF"><font size="+1">

13527

<a href="GraphicsMagick.html#details-threshold">-threshold</a> <i><value></i>{<i><green>,<blue>,<opacity></i>}<i></i>{<i>%</i>}<i></i>

13528

</font></font></font></b></td></tr></table>

13529

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>threshold the image</td></tr></table>

13530

13531

<tr>

13532

13533

13534

<img SRC="../images/right_triangle_option.png"

13535

ALT=">" BORDER=0 height=14

13536

width=15><b><font face="Helvetica, Arial"

13537

><font color="#FFFFFF"><font size="+1">

13538

-tile <i><filename></i>

13539

</font></font></font></b></td></tr></table>

13540

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tile image when filling a graphic primitive</td></tr></table>

13541

13542

<tr>

13543

13544

13545

<img SRC="../images/right_triangle_option.png"

13546

ALT=">" BORDER=0 height=14

13547

width=15><b><font face="Helvetica, Arial"

13548

><font color="#FFFFFF"><font size="+1">

13549

<a href="GraphicsMagick.html#details-transform">-transform</a>

13550

</font></font></font></b></td></tr></table>

13551

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image</td></tr></table>

13552

13553

<tr>

13554

13555

13556

<img SRC="../images/right_triangle_option.png"

13557

ALT=">" BORDER=0 height=14

13558

width=15><b><font face="Helvetica, Arial"

13559

><font color="#FFFFFF"><font size="+1">

13560

<a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i>

13561

</font></font></font></b></td></tr></table>

13562

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table>

13563

13564

<tr>

13565

13566

13567

<img SRC="../images/right_triangle_option.png"

13568

ALT=">" BORDER=0 height=14

13569

width=15><b><font face="Helvetica, Arial"

13570

><font color="#FFFFFF"><font size="+1">

13571

<a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i>

13572

</font></font></font></b></td></tr></table>

13573

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

13574

13575

<tr>

13576

13577

13578

<img SRC="../images/right_triangle_option.png"

13579

ALT=">" BORDER=0 height=14

13580

width=15><b><font face="Helvetica, Arial"

13581

><font color="#FFFFFF"><font size="+1">

13582

13583

</font></font></font></b></td></tr></table>

13584

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

13585

13586

<tr>

13587

13588

13589

<img SRC="../images/right_triangle_option.png"

13590

ALT=">" BORDER=0 height=14

13591

width=15><b><font face="Helvetica, Arial"

13592

><font color="#FFFFFF"><font size="+1">

13593

13594

</font></font></font></b></td></tr></table>

13595

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table>

13596

13597

<tr>

13598

13599

13600

<img SRC="../images/right_triangle_option.png"

13601

ALT=">" BORDER=0 height=14

13602

width=15><b><font face="Helvetica, Arial"

13603

><font color="#FFFFFF"><font size="+1">

13604

<a href="GraphicsMagick.html#details-units">-units</a> <i><type></i>

13605

</font></font></font></b></td></tr></table>

13606

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the units of image resolution</td></tr></table>

13607

13608

<tr>

13609

13610

13611

<img SRC="../images/right_triangle_option.png"

13612

ALT=">" BORDER=0 height=14

13613

width=15><b><font face="Helvetica, Arial"

13614

><font color="#FFFFFF"><font size="+1">

13615

<a href="GraphicsMagick.html#details-unsharp">-unsharp</a> <i><radius></i>{<i>x<sigma></i>}<i></i>{<i>+<amount></i>}<i></i>{<i>+<threshold></i>}<i></i>

13616

</font></font></font></b></td></tr></table>

13617

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image with an unsharp mask operator</td></tr></table>

13618

13619

<tr>

13620

13621

13622

<img SRC="../images/right_triangle_option.png"

13623

ALT=">" BORDER=0 height=14

13624

width=15><b><font face="Helvetica, Arial"

13625

><font color="#FFFFFF"><font size="+1">

13626

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

13627

</font></font></font></b></td></tr></table>

13628

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

13629

13630

<tr>

13631

13632

13633

<img SRC="../images/right_triangle_option.png"

13634

ALT=">" BORDER=0 height=14

13635

width=15><b><font face="Helvetica, Arial"

13636

><font color="#FFFFFF"><font size="+1">

13637

<a href="GraphicsMagick.html#details-version">-version</a>

13638

</font></font></font></b></td></tr></table>

13639

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

13640

13641

<tr>

13642

13643

13644

<img SRC="../images/right_triangle_option.png"

13645

ALT=">" BORDER=0 height=14

13646

width=15><b><font face="Helvetica, Arial"

13647

><font color="#FFFFFF"><font size="+1">

13648

-view <i><string></i>

13649

</font></font></font></b></td></tr></table>

13650

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>FlashPix viewing parameters</td></tr></table>

13651

13652

<tr>

13653

13654

13655

<img SRC="../images/right_triangle_option.png"

13656

ALT=">" BORDER=0 height=14

13657

width=15><b><font face="Helvetica, Arial"

13658

><font color="#FFFFFF"><font size="+1">

13659

<a href="GraphicsMagick.html#details-virtual-pixel">-virtual-pixel</a> <i><method></i>

13660

</font></font></font></b></td></tr></table>

13661

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify contents of "virtual pixels"</td></tr></table>

13662

13663

<tr>

13664

13665

13666

<img SRC="../images/right_triangle_option.png"

13667

ALT=">" BORDER=0 height=14

13668

width=15><b><font face="Helvetica, Arial"

13669

><font color="#FFFFFF"><font size="+1">

13670

13671

</font></font></font></b></td></tr></table>

13672

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>alter an image along a sine wave</td></tr></table>

13673

13674

<tr>

13675

13676

13677

<img SRC="../images/right_triangle_option.png"

13678

ALT=">" BORDER=0 height=14

13679

width=15><b><font face="Helvetica, Arial"

13680

><font color="#FFFFFF"><font size="+1">

13681

<a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i>

13682

</font></font></font></b></td></tr></table>

13683

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table>

13684

<p>

13685

For a more detailed description of each option, see

13686

Options, above.

13687

13688

</td></tr></table>

13689

<p>

13690

<i><a href="#top">Back to Contents</a></i>

13691

 </p>

13692

13693

13694

<tr>

13695

<td ALIGN=LEFT bgcolor="#52799E"><img

13696

SRC="../images/right_triangle.png" ALT=">" BORDER=0

13697

height=14 width=15><b><font face="Helvetica, Arial"><font

13698

color="#FFFFFF"><font size="+1">

13699

<a NAME="montage"></a>gm montage

13700

</font></font></font></b></td></tr></table>

13701

13702

13703

<p>

13704

<strong>montage</strong> creates a composite image by combining several separate

13705

images. The images are tiled on the composite image with the name of the

13706

image optionally appearing just below the individual tile.

13707

<p>

13708

The composite image is constructed in the following manner. First, each

13709

image specified on the command line, except for the last, is scaled to

13710

fit the maximum tile size. The maximum tile size by default is 120x120.

13711

It can be modified with the <strong>-geometry</strong> command line argument or X

13712

resource. See

13713

<strong>Options</strong>

13714

for more information on command line arguments. See

13715

<strong>X(1)</strong> for more information on X resources.

13716

Note that the maximum tile size need not be a square.

13717

<p>

13718

Next the composite image is initialized with the color specified by the

13719

<strong>-background</strong>

13720

command line argument or X resource. The width and height of the composite

13721

image is determined by the title specified, the maximum tile size, the

13722

number of tiles per row, the tile border width and height, the image border

13723

width, and the label height. The number of tiles per row specifies how

13724

many images are to appear in each row of the composite image. The default

13725

is to have 5 tiles in each row and 4 tiles in each column of the composite.

13726

A specific value is specified with <strong>-tile</strong>. The tile border width

13727

and height, and the image border width defaults to the value of the X resource

13728

<strong>-borderwidth</strong>. It can be changed with the <strong>-borderwidth</strong> or

13729

<strong>-geometry</strong> command line argument or X resource. The label height

13730

is determined by the font you specify with the <strong>-font</strong> command line

13731

argument or X resource. If you do not specify a font, a font is chosen

13732

that allows the name of the image to fit the maximum width of a tiled area.

13733

The label colors is determined by the <strong>-background</strong> and <strong>-fill</strong>

13734

command line argument or X resource. Note, that if the background and pen

13735

colors are the same, labels will not appear.

13736

<p>

13737

Initially, the composite image title is placed at the top if one is specified

13738

(refer to <strong>-fill</strong>). Next, each image is set onto the composite image,

13739

surrounded by its border color, with its name centered just below it. The

13740

individual images are left-justified within the width of the tiled area.

13741

The order of the images is the same as they appear on the command line

13742

unless the images have a scene keyword. If a scene number is specified

13743

in each image, then the images are tiled onto the composite in the order

13744

of their scene number. Finally, the last argument on the command line is

13745

the name assigned to the composite image. By default, the image is written

13746

in the <strong>MIFF</strong> format and can be viewed or printed with

13747

<em>display(1)</em>.

13748

13749

<p>

13750

Note, that if the number of tiles exceeds the default number of 20 (5 per

13751

row, 4 per column), more than one composite image is created. To ensure

13752

a single image is produced, use <strong>-tile</strong> to increase the number of

13753

tiles to meet or exceed the number of input images.

13754

<p>

13755

Finally, to create one or more empty spaces in the sequence of tiles, use

13756

the <strong>"NULL:"</strong> image format.

13757

<p>

13758

Note, a composite MIFF image displayed to an X server with

13759

<strong>display</strong>

13760

behaves differently than other images. You can think of the composite as

13761

a visual image directory. Choose a particular tile of the composite and

13762

press a button to display it. See <strong>display(1)</strong> and <strong>miff(5)</strong>

13763

</td></tr></table>

13764

<p>

13765

<i><a href="#top">Back to Contents</a></i>

13766

 </p>

13767

13768

<tr>

13769

<td ALIGN=LEFT bgcolor="#52799E"><img

13770

SRC="../images/right_triangle.png" ALT=">" BORDER=0

13771

height=14 width=15><b><font face="Helvetica, Arial"><font

13772

color="#FFFFFF"><font size="+1">

13773

<a NAME=mont-exam"></a>Examples

13774

</font></font></font></b></td></tr></table>

13775

13776

13777

<p>

13778

To create a montage of a cockatoo, a parrot, and a hummingbird and write

13779

it to a file called birds, use:

13780

<pre>

13781

gm montage cockatoo.miff parrot.miff hummingbird.miff

13782

birds.miff

13783

</pre>

13784

<p>

13785

To tile several bird images so that they are at most 256 pixels in width

13786

and 192 pixels in height, surrounded by a red border, and separated by

13787

10 pixels of background color, use:

13788

<pre>

13789

gm montage -geometry 256x192+10+10 -bordercolor red

13790

birds.* montage.miff

13791

</pre>

13792

<p>

13793

To create an unlabeled parrot image, 640 by 480 pixels, and surrounded

13794

by a border of black, use:

13795

<pre>

13796

gm montage -geometry 640x480 -bordercolor black

13797

-label "" parrot.miff bird.miff

13798

</pre>

13799

<p>

13800

To create an image of an eagle with a textured background, use:

13801

<pre>

13802

gm montage -texture bumps.jpg eagle.jpg eagle.png

13803

</pre>

13804

<p>

13805

To join several GIF images together without any extraneous graphics (e.g.

13806

no label, no shadowing, no surrounding tile frame), use:

13807

<pre>

13808

gm montage +frame +shadow +label -tile 5x1

13809

-geometry 50x50+0+0 *.png joined.png

13810

</pre>

13811

</td></tr></table>

13812

<p>

13813

<i><a href="#top">Back to Contents</a></i>

13814

 </p>

13815

13816

<tr>

13817

<td ALIGN=LEFT bgcolor="#52799E"><img

13818

SRC="../images/right_triangle.png" ALT=">" BORDER=0

13819

height=14 width=15><b><font face="Helvetica, Arial"><font

13820

color="#FFFFFF"><font size="+1">

13821

<a NAME=mont-opti"></a>Options

13822

</font></font></font></b></td></tr></table>

13823

13824

13825

<p>

13826

Any option you specify on the command line remains in effect for the group

13827

of images following it, until the group is terminated by the appearance of

13828

any option or <strong>-noop</strong>. For example, to make a montage of three images,

13829

the first with 32 colors, the second with an unlimited number of colors, and

13830

the third with only 16 colors, use:

13831

13832

<pre>

13833

gm montage -colors 32 cockatoo.1 -noop cockatoo.2

13834

-colors 16 cockatoo.3 cockatoos.miff

13835

</pre>

13836

<p>

13837

For a more detailed description of each option, see

13838

Options, above.

13839

13840

13841

<tr>

13842

13843

13844

<img SRC="../images/right_triangle_option.png"

13845

ALT=">" BORDER=0 height=14

13846

width=15><b><font face="Helvetica, Arial"

13847

><font color="#FFFFFF"><font size="+1">

13848

<a href="GraphicsMagick.html#details-adjoin">-adjoin</a>

13849

</font></font></font></b></td></tr></table>

13850

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>join images into a single multi-image file</td></tr></table>

13851

13852

<tr>

13853

13854

13855

<img SRC="../images/right_triangle_option.png"

13856

ALT=">" BORDER=0 height=14

13857

width=15><b><font face="Helvetica, Arial"

13858

><font color="#FFFFFF"><font size="+1">

13859

<a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i><string></i>

13860

</font></font></font></b></td></tr></table>

13861

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>

13862

13863

<tr>

13864

13865

13866

<img SRC="../images/right_triangle_option.png"

13867

ALT=">" BORDER=0 height=14

13868

width=15><b><font face="Helvetica, Arial"

13869

><font color="#FFFFFF"><font size="+1">

13870

<a href="GraphicsMagick.html#details-background">-background</a> <i><color></i>

13871

</font></font></font></b></td></tr></table>

13872

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the background color</td></tr></table>

13873

13874

<tr>

13875

13876

13877

<img SRC="../images/right_triangle_option.png"

13878

ALT=">" BORDER=0 height=14

13879

width=15><b><font face="Helvetica, Arial"

13880

><font color="#FFFFFF"><font size="+1">

13881

<a href="GraphicsMagick.html#details-blue-primary">-blue-primary</a> <i><x>,<y></i>

13882

</font></font></font></b></td></tr></table>

13883

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blue chromaticity primary point</td></tr></table>

13884

13885

<tr>

13886

13887

13888

<img SRC="../images/right_triangle_option.png"

13889

ALT=">" BORDER=0 height=14

13890

width=15><b><font face="Helvetica, Arial"

13891

><font color="#FFFFFF"><font size="+1">

13892

13893

</font></font></font></b></td></tr></table>

13894

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>blur the image with a Gaussian operator</td></tr></table>

13895

13896

<tr>

13897

13898

13899

<img SRC="../images/right_triangle_option.png"

13900

ALT=">" BORDER=0 height=14

13901

width=15><b><font face="Helvetica, Arial"

13902

><font color="#FFFFFF"><font size="+1">

13903

<a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i><color></i>

13904

</font></font></font></b></td></tr></table>

13905

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border color</td></tr></table>

13906

13907

<tr>

13908

13909

13910

<img SRC="../images/right_triangle_option.png"

13911

ALT=">" BORDER=0 height=14

13912

width=15><b><font face="Helvetica, Arial"

13913

><font color="#FFFFFF"><font size="+1">

13914

-borderwidth <i><geometry></i>

13915

</font></font></font></b></td></tr></table>

13916

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the border width</td></tr></table>

13917

13918

<tr>

13919

13920

13921

<img SRC="../images/right_triangle_option.png"

13922

ALT=">" BORDER=0 height=14

13923

width=15><b><font face="Helvetica, Arial"

13924

><font color="#FFFFFF"><font size="+1">

13925

<a href="GraphicsMagick.html#details-cache">-cache</a> <i><threshold></i>

13926

</font></font></font></b></td></tr></table>

13927

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -limit option)</td></tr></table>

13928

13929

<tr>

13930

13931

13932

<img SRC="../images/right_triangle_option.png"

13933

ALT=">" BORDER=0 height=14

13934

width=15><b><font face="Helvetica, Arial"

13935

><font color="#FFFFFF"><font size="+1">

13936

13937

</font></font></font></b></td></tr></table>

13938

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>remove pixels from the interior of an image</td></tr></table>

13939

13940

<tr>

13941

13942

13943

<img SRC="../images/right_triangle_option.png"

13944

ALT=">" BORDER=0 height=14

13945

width=15><b><font face="Helvetica, Arial"

13946

><font color="#FFFFFF"><font size="+1">

13947

<a href="GraphicsMagick.html#details-colors">-colors</a> <i><value></i>

13948

</font></font></font></b></td></tr></table>

13949

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>

13950

13951

<tr>

13952

13953

13954

<img SRC="../images/right_triangle_option.png"

13955

ALT=">" BORDER=0 height=14

13956

width=15><b><font face="Helvetica, Arial"

13957

><font color="#FFFFFF"><font size="+1">

13958

<a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i><value></i>

13959

</font></font></font></b></td></tr></table>

13960

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>

13961

13962

<tr>

13963

13964

13965

<img SRC="../images/right_triangle_option.png"

13966

ALT=">" BORDER=0 height=14

13967

width=15><b><font face="Helvetica, Arial"

13968

><font color="#FFFFFF"><font size="+1">

13969

<a href="GraphicsMagick.html#details-comment">-comment</a> <i><string></i>

13970

</font></font></font></b></td></tr></table>

13971

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>

13972

13973

<tr>

13974

13975

13976

<img SRC="../images/right_triangle_option.png"

13977

ALT=">" BORDER=0 height=14

13978

width=15><b><font face="Helvetica, Arial"

13979

><font color="#FFFFFF"><font size="+1">

13980

<a href="GraphicsMagick.html#details-compose">-compose</a> <i><operator></i>

13981

</font></font></font></b></td></tr></table>

13982

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image composition</td></tr></table>

13983

13984

<tr>

13985

13986

13987

<img SRC="../images/right_triangle_option.png"

13988

ALT=">" BORDER=0 height=14

13989

width=15><b><font face="Helvetica, Arial"

13990

><font color="#FFFFFF"><font size="+1">

13991

<a href="GraphicsMagick.html#details-compress">-compress</a> <i><type></i>

13992

</font></font></font></b></td></tr></table>

13993

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>

13994

13995

<tr>

13996

13997

13998

<img SRC="../images/right_triangle_option.png"

13999

ALT=">" BORDER=0 height=14

14000

width=15><b><font face="Helvetica, Arial"

14001

><font color="#FFFFFF"><font size="+1">

14002

14003

</font></font></font></b></td></tr></table>

14004

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>

14005

14006

<tr>

14007

14008

14009

<img SRC="../images/right_triangle_option.png"

14010

ALT=">" BORDER=0 height=14

14011

width=15><b><font face="Helvetica, Arial"

14012

><font color="#FFFFFF"><font size="+1">

14013

-debug <i><events></i>

14014

</font></font></font></b></td></tr></table>

14015

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>

14016

14017

<tr>

14018

14019

14020

<img SRC="../images/right_triangle_option.png"

14021

ALT=">" BORDER=0 height=14

14022

width=15><b><font face="Helvetica, Arial"

14023

><font color="#FFFFFF"><font size="+1">

14024

<a href="GraphicsMagick.html#details-define">-define</a> <i><key></i>{<i>=<value></i>}<i>,...</i>

14025

</font></font></font></b></td></tr></table>

14026

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>

14027

14028

<tr>

14029

14030

14031

<img SRC="../images/right_triangle_option.png"

14032

ALT=">" BORDER=0 height=14

14033

width=15><b><font face="Helvetica, Arial"

14034

><font color="#FFFFFF"><font size="+1">

14035

<a href="GraphicsMagick.html#details-density">-density</a> <i><width>x<height></i>

14036

</font></font></font></b></td></tr></table>

14037

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>

14038

14039

<tr>

14040

14041

14042

<img SRC="../images/right_triangle_option.png"

14043

ALT=">" BORDER=0 height=14

14044

width=15><b><font face="Helvetica, Arial"

14045

><font color="#FFFFFF"><font size="+1">

14046

<a href="GraphicsMagick.html#details-depth">-depth</a> <i><value></i>

14047

</font></font></font></b></td></tr></table>

14048

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>

14049

14050

<tr>

14051

14052

14053

<img SRC="../images/right_triangle_option.png"

14054

ALT=">" BORDER=0 height=14

14055

width=15><b><font face="Helvetica, Arial"

14056

><font color="#FFFFFF"><font size="+1">

14057

<a href="GraphicsMagick.html#details-display">-display</a> <i><host:display[.screen]></i>

14058

</font></font></font></b></td></tr></table>

14059

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>

14060

14061

<tr>

14062

14063

14064

<img SRC="../images/right_triangle_option.png"

14065

ALT=">" BORDER=0 height=14

14066

width=15><b><font face="Helvetica, Arial"

14067

><font color="#FFFFFF"><font size="+1">

14068

<a href="GraphicsMagick.html#details-dispose">-dispose</a> <i><method></i>

14069

</font></font></font></b></td></tr></table>

14070

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>

14071

14072

<tr>

14073

14074

14075

<img SRC="../images/right_triangle_option.png"

14076

ALT=">" BORDER=0 height=14

14077

width=15><b><font face="Helvetica, Arial"

14078

><font color="#FFFFFF"><font size="+1">

14079

<a href="GraphicsMagick.html#details-dither">-dither</a>

14080

</font></font></font></b></td></tr></table>

14081

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>

14082

14083

<tr>

14084

14085

14086

<img SRC="../images/right_triangle_option.png"

14087

ALT=">" BORDER=0 height=14

14088

width=15><b><font face="Helvetica, Arial"

14089

><font color="#FFFFFF"><font size="+1">

14090

14091

</font></font></font></b></td></tr></table>

14092

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>annotate an image with one or more graphic primitives</td></tr></table>

14093

14094

<tr>

14095

14096

14097

<img SRC="../images/right_triangle_option.png"

14098

ALT=">" BORDER=0 height=14

14099

width=15><b><font face="Helvetica, Arial"

14100

><font color="#FFFFFF"><font size="+1">

14101

<a href="GraphicsMagick.html#details-encoding">-encoding</a> <i><type></i>

14102

</font></font></font></b></td></tr></table>

14103

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the text encoding</td></tr></table>

14104

14105

<tr>

14106

14107

14108

<img SRC="../images/right_triangle_option.png"

14109

ALT=">" BORDER=0 height=14

14110

width=15><b><font face="Helvetica, Arial"

14111

><font color="#FFFFFF"><font size="+1">

14112

<a href="GraphicsMagick.html#details-endian">-endian</a> <i><type></i>

14113

</font></font></font></b></td></tr></table>

14114

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify endianness (MSB or LSB) of output image</td></tr></table>

14115

14116

<tr>

14117

14118

14119

<img SRC="../images/right_triangle_option.png"

14120

ALT=">" BORDER=0 height=14

14121

width=15><b><font face="Helvetica, Arial"

14122

><font color="#FFFFFF"><font size="+1">

14123

14124

</font></font></font></b></td></tr></table>

14125

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when filling a graphic primitive</td></tr></table>

14126

14127

<tr>

14128

14129

14130

<img SRC="../images/right_triangle_option.png"

14131

ALT=">" BORDER=0 height=14

14132

width=15><b><font face="Helvetica, Arial"

14133

><font color="#FFFFFF"><font size="+1">

14134

<a href="GraphicsMagick.html#details-filter">-filter</a> <i><type></i>

14135

</font></font></font></b></td></tr></table>

14136

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>

14137

14138

<tr>

14139

14140

14141

<img SRC="../images/right_triangle_option.png"

14142

ALT=">" BORDER=0 height=14

14143

width=15><b><font face="Helvetica, Arial"

14144

><font color="#FFFFFF"><font size="+1">

14145

14146

</font></font></font></b></td></tr></table>

14147

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>

14148

14149

<tr>

14150

14151

14152

<img SRC="../images/right_triangle_option.png"

14153

ALT=">" BORDER=0 height=14

14154

width=15><b><font face="Helvetica, Arial"

14155

><font color="#FFFFFF"><font size="+1">

14156

<a href="GraphicsMagick.html#details-frame">-frame</a> <i><width>x<height>+<outer bevel width>+<inner bevel width></i>

14157

</font></font></font></b></td></tr></table>

14158

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table>

14159

14160

<tr>

14161

14162

14163

<img SRC="../images/right_triangle_option.png"

14164

ALT=">" BORDER=0 height=14

14165

width=15><b><font face="Helvetica, Arial"

14166

><font color="#FFFFFF"><font size="+1">

14167

<a href="GraphicsMagick.html#details-gamma">-gamma</a> <i><value></i>

14168

</font></font></font></b></td></tr></table>

14169

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>

14170

14171

<tr>

14172

14173

14174

<img SRC="../images/right_triangle_option.png"

14175

ALT=">" BORDER=0 height=14

14176

width=15><b><font face="Helvetica, Arial"

14177

><font color="#FFFFFF"><font size="+1">

14178

<a href="GraphicsMagick.html#details-geometry">-geometry</a> <i><width>x<height></i>{<i>+-</i>}<i><x></i>{<i>+-</i>}<i><y></i>{<i>%</i>}<i></i>{<i>@</i>}<i> </i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

14179

</font></font></font></b></td></tr></table>

14180

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>preferred size and location of the Image window.</td></tr></table>

14181

14182

<tr>

14183

14184

14185

<img SRC="../images/right_triangle_option.png"

14186

ALT=">" BORDER=0 height=14

14187

width=15><b><font face="Helvetica, Arial"

14188

><font color="#FFFFFF"><font size="+1">

14189

<a href="GraphicsMagick.html#details-gravity">-gravity</a> <i><type></i>

14190

</font></font></font></b></td></tr></table>

14191

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>direction primitive gravitates to when annotating the image.</td></tr></table>

14192

14193

<tr>

14194

14195

14196

<img SRC="../images/right_triangle_option.png"

14197

ALT=">" BORDER=0 height=14

14198

width=15><b><font face="Helvetica, Arial"

14199

><font color="#FFFFFF"><font size="+1">

14200

<a href="GraphicsMagick.html#details-green-primary">-green-primary</a> <i><x>,<y></i>

14201

</font></font></font></b></td></tr></table>

14202

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>green chromaticity primary point</td></tr></table>

14203

14204

<tr>

14205

14206

14207

<img SRC="../images/right_triangle_option.png"

14208

ALT=">" BORDER=0 height=14

14209

width=15><b><font face="Helvetica, Arial"

14210

><font color="#FFFFFF"><font size="+1">

14211

-help

14212

</font></font></font></b></td></tr></table>

14213

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>

14214

14215

<tr>

14216

14217

14218

<img SRC="../images/right_triangle_option.png"

14219

ALT=">" BORDER=0 height=14

14220

width=15><b><font face="Helvetica, Arial"

14221

><font color="#FFFFFF"><font size="+1">

14222

<a href="GraphicsMagick.html#details-interlace">-interlace</a> <i><type></i>

14223

</font></font></font></b></td></tr></table>

14224

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>

14225

14226

<tr>

14227

14228

14229

<img SRC="../images/right_triangle_option.png"

14230

ALT=">" BORDER=0 height=14

14231

width=15><b><font face="Helvetica, Arial"

14232

><font color="#FFFFFF"><font size="+1">

14233

<a href="GraphicsMagick.html#details-label">-label</a> <i><name></i>

14234

</font></font></font></b></td></tr></table>

14235

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>

14236

14237

<tr>

14238

14239

14240

<img SRC="../images/right_triangle_option.png"

14241

ALT=">" BORDER=0 height=14

14242

width=15><b><font face="Helvetica, Arial"

14243

><font color="#FFFFFF"><font size="+1">

14244

<a href="GraphicsMagick.html#details-limit">-limit</a> <i><type> <value></i>

14245

</font></font></font></b></td></tr></table>

14246

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Disk, File, Map, or Memory resource limit</td></tr></table>

14247

14248

<tr>

14249

14250

14251

<img SRC="../images/right_triangle_option.png"

14252

ALT=">" BORDER=0 height=14

14253

width=15><b><font face="Helvetica, Arial"

14254

><font color="#FFFFFF"><font size="+1">

14255

14256

</font></font></font></b></td></tr></table>

14257

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>

14258

14259

<tr>

14260

14261

14262

<img SRC="../images/right_triangle_option.png"

14263

ALT=">" BORDER=0 height=14

14264

width=15><b><font face="Helvetica, Arial"

14265

><font color="#FFFFFF"><font size="+1">

14266

<a href="GraphicsMagick.html#details-matte">-matte</a>

14267

</font></font></font></b></td></tr></table>

14268

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>

14269

14270

<tr>

14271

14272

14273

<img SRC="../images/right_triangle_option.png"

14274

ALT=">" BORDER=0 height=14

14275

width=15><b><font face="Helvetica, Arial"

14276

><font color="#FFFFFF"><font size="+1">

14277

<a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i><color></i>

14278

</font></font></font></b></td></tr></table>

14279

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>

14280

14281

<tr>

14282

14283

14284

<img SRC="../images/right_triangle_option.png"

14285

ALT=">" BORDER=0 height=14

14286

width=15><b><font face="Helvetica, Arial"

14287

><font color="#FFFFFF"><font size="+1">

14288

-mode <i><value></i>

14289

</font></font></font></b></td></tr></table>

14290

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>mode of operation</td></tr></table>

14291

14292

<tr>

14293

14294

14295

<img SRC="../images/right_triangle_option.png"

14296

ALT=">" BORDER=0 height=14

14297

width=15><b><font face="Helvetica, Arial"

14298

><font color="#FFFFFF"><font size="+1">

14299

-monochrome

14300

</font></font></font></b></td></tr></table>

14301

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>

14302

14303

<tr>

14304

14305

14306

<img SRC="../images/right_triangle_option.png"

14307

ALT=">" BORDER=0 height=14

14308

width=15><b><font face="Helvetica, Arial"

14309

><font color="#FFFFFF"><font size="+1">

14310

14311

</font></font></font></b></td></tr></table>

14312

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>

14313

14314

<tr>

14315

14316

14317

<img SRC="../images/right_triangle_option.png"

14318

ALT=">" BORDER=0 height=14

14319

width=15><b><font face="Helvetica, Arial"

14320

><font color="#FFFFFF"><font size="+1">

14321

14322

</font></font></font></b></td></tr></table>

14323

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>

14324

14325

<tr>

14326

14327

14328

<img SRC="../images/right_triangle_option.png"

14329

ALT=">" BORDER=0 height=14

14330

width=15><b><font face="Helvetica, Arial"

14331

><font color="#FFFFFF"><font size="+1">

14332

14333

</font></font></font></b></td></tr></table>

14334

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>(This option has been replaced by the -fill option)</td></tr></table>

14335

14336

<tr>

14337

14338

14339

<img SRC="../images/right_triangle_option.png"

14340

ALT=">" BORDER=0 height=14

14341

width=15><b><font face="Helvetica, Arial"

14342

><font color="#FFFFFF"><font size="+1">

14343

-pointsize <i><value></i>

14344

</font></font></font></b></td></tr></table>

14345

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>pointsize of the PostScript, OPTION1, or TrueType font</td></tr></table>

14346

14347

<tr>

14348

14349

14350

<img SRC="../images/right_triangle_option.png"

14351

ALT=">" BORDER=0 height=14

14352

width=15><b><font face="Helvetica, Arial"

14353

><font color="#FFFFFF"><font size="+1">

14354

<a href="GraphicsMagick.html#details-quality">-quality</a> <i><value></i>

14355

</font></font></font></b></td></tr></table>

14356

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG compression level</td></tr></table>

14357

14358

<tr>

14359

14360

14361

<img SRC="../images/right_triangle_option.png"

14362

ALT=">" BORDER=0 height=14

14363

width=15><b><font face="Helvetica, Arial"

14364

><font color="#FFFFFF"><font size="+1">

14365

<a href="GraphicsMagick.html#details-red-primary">-red-primary</a> <i><x>,<y></i>

14366

</font></font></font></b></td></tr></table>

14367

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>red chromaticity primary point</td></tr></table>

14368

14369

<tr>

14370

14371

14372

<img SRC="../images/right_triangle_option.png"

14373

ALT=">" BORDER=0 height=14

14374

width=15><b><font face="Helvetica, Arial"

14375

><font color="#FFFFFF"><font size="+1">

14376

<a href="GraphicsMagick.html#details-render">-render</a>

14377

</font></font></font></b></td></tr></table>

14378

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>render vector operations</td></tr></table>

14379

14380

<tr>

14381

14382

14383

<img SRC="../images/right_triangle_option.png"

14384

ALT=">" BORDER=0 height=14

14385

width=15><b><font face="Helvetica, Arial"

14386

><font color="#FFFFFF"><font size="+1">

14387

<a href="GraphicsMagick.html#details-resize">-resize</a> <i><width>x<height></i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

14388

</font></font></font></b></td></tr></table>

14389

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>resize an image</td></tr></table>

14390

14391

<tr>

14392

14393

14394

<img SRC="../images/right_triangle_option.png"

14395

ALT=">" BORDER=0 height=14

14396

width=15><b><font face="Helvetica, Arial"

14397

><font color="#FFFFFF"><font size="+1">

14398

<a href="GraphicsMagick.html#details-rotate">-rotate</a> <i><degrees></i>{<i><</i>}<i></i>{<i>></i>}<i></i>

14399

</font></font></font></b></td></tr></table>

14400

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>apply Paeth image rotation to the image</td></tr></table>

14401

14402

<tr>

14403

14404

14405

<img SRC="../images/right_triangle_option.png"

14406

ALT=">" BORDER=0 height=14

14407

width=15><b><font face="Helvetica, Arial"

14408

><font color="#FFFFFF"><font size="+1">

14409

<a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i><horizontal_factor>x<vertical_factor></i>

14410

</font></font></font></b></td></tr></table>

14411

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.</td></tr></table>

14412

14413

<tr>

14414

14415

14416

<img SRC="../images/right_triangle_option.png"

14417

ALT=">" BORDER=0 height=14

14418

width=15><b><font face="Helvetica, Arial"

14419

><font color="#FFFFFF"><font size="+1">

14420

<a href="GraphicsMagick.html#details-scenes">-scenes</a> <i><value-value></i>

14421

</font></font></font></b></td></tr></table>

14422

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table>

14423

14424

<tr>

14425

14426

14427

<img SRC="../images/right_triangle_option.png"

14428

ALT=">" BORDER=0 height=14

14429

width=15><b><font face="Helvetica, Arial"

14430

><font color="#FFFFFF"><font size="+1">

14431

-shadow <i><radius></i>{<i>x<sigma></i>}<i></i>

14432

</font></font></font></b></td></tr></table>

14433

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>shadow the montage</td></tr></table>

14434

14435

<tr>

14436

14437

14438

<img SRC="../images/right_triangle_option.png"

14439

ALT=">" BORDER=0 height=14

14440

width=15><b><font face="Helvetica, Arial"

14441

><font color="#FFFFFF"><font size="+1">

14442

<a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i><radius></i>{<i>x<sigma></i>}<i></i>

14443

</font></font></font></b></td></tr></table>

14444

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>

14445

14446

<tr>

14447

14448

14449

<img SRC="../images/right_triangle_option.png"

14450

ALT=">" BORDER=0 height=14

14451

width=15><b><font face="Helvetica, Arial"

14452

><font color="#FFFFFF"><font size="+1">

14453

<a href="GraphicsMagick.html#details-size">-size</a> <i><width>x<height></i>{<i>+offset</i>}<i></i>

14454

</font></font></font></b></td></tr></table>

14455

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>

14456

14457

<tr>

14458

14459

14460

<img SRC="../images/right_triangle_option.png"

14461

ALT=">" BORDER=0 height=14

14462

width=15><b><font face="Helvetica, Arial"

14463

><font color="#FFFFFF"><font size="+1">

14464

<a href="GraphicsMagick.html#details-stroke">-stroke</a> <i><color></i>

14465

</font></font></font></b></td></tr></table>

14466

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color to use when stroking a graphic primitive</td></tr></table>

14467

14468

<tr>

14469

14470

14471

<img SRC="../images/right_triangle_option.png"

14472

ALT=">" BORDER=0 height=14

14473

width=15><b><font face="Helvetica, Arial"

14474

><font color="#FFFFFF"><font size="+1">

14475

<a href="GraphicsMagick.html#details-strokewidth">-strokewidth</a> <i><value></i>

14476

</font></font></font></b></td></tr></table>

14477

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>set the stroke width</td></tr></table>

14478

14479

<tr>

14480

14481

14482

<img SRC="../images/right_triangle_option.png"

14483

ALT=">" BORDER=0 height=14

14484

width=15><b><font face="Helvetica, Arial"

14485

><font color="#FFFFFF"><font size="+1">

14486

-texture <i><filename></i>

14487

</font></font></font></b></td></tr></table>

14488

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table>

14489

14490

<tr>

14491

14492

14493

<img SRC="../images/right_triangle_option.png"

14494

ALT=">" BORDER=0 height=14

14495

width=15><b><font face="Helvetica, Arial"

14496

><font color="#FFFFFF"><font size="+1">

14497

-tile <i><geometry></i>

14498

</font></font></font></b></td></tr></table>

14499

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>layout of images [<em>montage</em>]</td></tr></table>

14500

14501

<tr>

14502

14503

14504

<img SRC="../images/right_triangle_option.png"

14505

ALT=">" BORDER=0 height=14

14506

width=15><b><font face="Helvetica, Arial"

14507

><font color="#FFFFFF"><font size="+1">

14508

<a href="GraphicsMagick.html#details-title">-title</a> <i><string></i>

14509

</font></font></font></b></td></tr></table>

14510

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table>

14511

14512

<tr>

14513

14514

14515

<img SRC="../images/right_triangle_option.png"

14516

ALT=">" BORDER=0 height=14

14517

width=15><b><font face="Helvetica, Arial"

14518

><font color="#FFFFFF"><font size="+1">

14519

<a href="GraphicsMagick.html#details-transparent">-transparent</a> <i><color></i>

14520

</font></font></font></b></td></tr></table>

14521

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>make this color transparent within the image</td></tr></table>

14522

14523

<tr>

14524

14525

14526

<img SRC="../images/right_triangle_option.png"

14527

ALT=">" BORDER=0 height=14

14528

width=15><b><font face="Helvetica, Arial"

14529

><font color="#FFFFFF"><font size="+1">

14530

<a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i><value></i>

14531

</font></font></font></b></td></tr></table>

14532

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>

14533

14534

<tr>

14535

14536

14537

<img SRC="../images/right_triangle_option.png"

14538

ALT=">" BORDER=0 height=14

14539

width=15><b><font face="Helvetica, Arial"

14540

><font color="#FFFFFF"><font size="+1">

14541

14542

</font></font></font></b></td></tr></table>

14543

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>trim an image</td></tr></table>

14544

14545

<tr>

14546

14547

14548

<img SRC="../images/right_triangle_option.png"

14549

ALT=">" BORDER=0 height=14

14550

width=15><b><font face="Helvetica, Arial"

14551

><font color="#FFFFFF"><font size="+1">

14552

14553

</font></font></font></b></td></tr></table>

14554

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>the image type</td></tr></table>

14555

14556

<tr>

14557

14558

14559

<img SRC="../images/right_triangle_option.png"

14560

ALT=">" BORDER=0 height=14

14561

width=15><b><font face="Helvetica, Arial"

14562

><font color="#FFFFFF"><font size="+1">

14563

<a href="GraphicsMagick.html#details-verbose">-verbose</a>

14564

</font></font></font></b></td></tr></table>

14565

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>

14566

14567

<tr>

14568

14569

14570

<img SRC="../images/right_triangle_option.png"

14571

ALT=">" BORDER=0 height=14

14572

width=15><b><font face="Helvetica, Arial"

14573

><font color="#FFFFFF"><font size="+1">

14574

<a href="GraphicsMagick.html#details-version">-version</a>

14575

</font></font></font></b></td></tr></table>

14576

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>

14577

14578

<tr>

14579

14580

14581

<img SRC="../images/right_triangle_option.png"

14582

ALT=">" BORDER=0 height=14

14583

width=15><b><font face="Helvetica, Arial"

14584

><font color="#FFFFFF"><font size="+1">

14585

<a href="GraphicsMagick.html#details-white-point">-white-point</a> <i><x>,<y></i>

14586

</font></font></font></b></td></tr></table>

14587

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>chromaticity white point</td></tr></table>

14588

<p>

14589

For a more detailed description of each option, see

14590

Options, above.

14591

14592

</td></tr></table>

14593

<p>

14594

<i><a href="#top">Back to Contents</a></i>

14595

 </p>

14596

14597

<tr>

14598

<td ALIGN=LEFT bgcolor="#52799E"><img

14599

SRC="../images/right_triangle.png" ALT=">" BORDER=0

14600

height=14 width=15><b><font face="Helvetica, Arial"><font

14601

color="#FFFFFF"><font size="+1">

14602

<a NAME=mont-xres"></a>X Resources

14603

</font></font></font></b></td></tr></table>

14604

14605

14606

<p>

14607

<strong>Montage</strong> options can appear on the command line or in your X resource

14608

file. Options on the command line supersede values specified in your X

14609

resource file. See <strong>X(1)</strong> for more information on X resources.

14610

<p>

14611

All <strong>montage</strong> options have a corresponding X resource. In addition,

14612

<strong>montage</strong>

14613

uses the following X resources:

14614

14615

<tr>

14616

14617

14618

<img SRC="../images/right_triangle_option.png"

14619

ALT=">" BORDER=0 height=14

14620

width=15><b><font face="Helvetica, Arial"

14621

><font color="#FFFFFF"><font size="+1">

14622

background <i>(class Background)</i>

14623

</font></font></font></b></td></tr></table>

14624

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>background color</td></tr></table>

14625

<p>

14626

Specifies the preferred color to use for the composite image background.

14627

The default is #ccc.

14628

14629

<tr>

14630

14631

14632

<img SRC="../images/right_triangle_option.png"

14633

ALT=">" BORDER=0 height=14

14634

width=15><b><font face="Helvetica, Arial"

14635

><font color="#FFFFFF"><font size="+1">

14636

borderColor <i>(class BorderColor)</i>

14637

</font></font></font></b></td></tr></table>

14638

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>border color</td></tr></table>

14639

<p>

14640

Specifies the preferred color to use for the composite image border. The

14641

default is #ccc.

14642

14643

<tr>

14644

14645

14646

<img SRC="../images/right_triangle_option.png"

14647

ALT=">" BORDER=0 height=14

14648

width=15><b><font face="Helvetica, Arial"

14649

><font color="#FFFFFF"><font size="+1">

14650

borderWidth <i>(class BorderWidth)</i>

14651

</font></font></font></b></td></tr></table>

14652

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>border width</td></tr></table>

14653

<p>

14654

Specifies the width in pixels of the composite image border. The default

14655

is 2.

14656

14657

<tr>

14658

14659

14660

<img SRC="../images/right_triangle_option.png"

14661

ALT=">" BORDER=0 height=14

14662

width=15><b><font face="Helvetica, Arial"

14663

><font color="#FFFFFF"><font size="+1">

14664

font <i>(class Font)</i>

14665

</font></font></font></b></td></tr></table>

14666

14667

<p>

14668

Specifies the name of the preferred font to use when displaying text within

14669

the composite image. The default is 9x15, fixed, or 5x8 determined by the

14670

composite image size.

14671

14672

<tr>

14673

14674

14675

<img SRC="../images/right_triangle_option.png"

14676

ALT=">" BORDER=0 height=14

14677

width=15><b><font face="Helvetica, Arial"

14678

><font color="#FFFFFF"><font size="+1">

14679

matteColor <i>(class MatteColor)</i>

14680

</font></font></font></b></td></tr></table>

14681

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>color of the frame</td></tr></table>

14682

<p>

14683

Specify the color of an image frame. A 3D effect is achieved by using highlight

14684

and shadow colors derived from this color. The default value is #697B8F.

14685

14686

<tr>

14687

14688

14689

<img SRC="../images/right_triangle_option.png"

14690

ALT=">" BORDER=0 height=14

14691

width=15><b><font face="Helvetica, Arial"

14692

><font color="#FFFFFF"><font size="+1">

14693

pen <i>(class Pen)</i>

14694

</font></font></font></b></td></tr></table>

14695

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>text color</td></tr></table>

14696

<p>

14697

Specifies the preferred color to use for text within the composite image.

14698

The default is black.

14699

14700

<tr>

14701

14702

14703

<img SRC="../images/right_triangle_option.png"

14704

ALT=">" BORDER=0 height=14

14705

width=15><b><font face="Helvetica, Arial"

14706

><font color="#FFFFFF"><font size="+1">

14707

title <i>(class Title)</i>

14708

</font></font></font></b></td></tr></table>

14709

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>composite image title</td></tr></table>

14710

<p>

14711

This resource specifies the title to be placed at the top of the composite

14712

image. The default is not to place a title at the top of the composite

14713

image.

14714

</td></tr></table>

14715

<p>

14716

<i><a href="#top">Back to Contents</a></i>

14717

 </p>

14718

14719

<tr>

14720

<td ALIGN=LEFT bgcolor="#52799E"><img

14721

SRC="../images/right_triangle.png" ALT=">" BORDER=0

14722

height=14 width=15><b><font face="Helvetica, Arial"><font

14723

color="#FFFFFF"><font size="+1">

14724

<a NAME=mont-envi"></a>Environment

14725

</font></font></font></b></td></tr></table>

14726

14727

14728

14729

<tr>

14730

14731

14732

<img SRC="../images/right_triangle_option.png"

14733

ALT=">" BORDER=0 height=14

14734

width=15><b><font face="Helvetica, Arial"

14735

><font color="#FFFFFF"><font size="+1">

14736

COLUMNS

14737

</font></font></font></b></td></tr></table>

14738

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Output screen width. Used when formatting text for the screen. Many

14739

Unix systems keep this shell variable up to date, but it may need to be

14740

explicitly exported in order for GraphicsMagick to see it.</td></tr></table>

14741

14742

<tr>

14743

14744

14745

<img SRC="../images/right_triangle_option.png"

14746

ALT=">" BORDER=0 height=14

14747

width=15><b><font face="Helvetica, Arial"

14748

><font color="#FFFFFF"><font size="+1">

14749

DISPLAY

14750

</font></font></font></b></td></tr></table>

14751

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>X11 display ID (host, display number, and screen in the form

14752

hostname:display.screen).</td></tr></table>

14753

14754

<tr>

14755

14756

14757

<img SRC="../images/right_triangle_option.png"

14758

ALT=">" BORDER=0 height=14

14759

width=15><b><font face="Helvetica, Arial"

14760

><font color="#FFFFFF"><font size="+1">

14761

HOME

14762

</font></font></font></b></td></tr></table>

14763

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Location of user's home directory. GraphicsMagick searches for

14764

configuration files in $HOME/.magick if the directory exists. See

14765

<strong>MAGICK_CODER_MODULE_PATH</strong>, <strong>MAGICK_CONFIGURE_PATH</strong>, and

14766

<strong>MAGICK_FILTER_MODULE_PATH</strong> if more flexibility is needed.</td></tr></table>

14767

14768

<tr>

14769

14770

14771

<img SRC="../images/right_triangle_option.png"

14772

ALT=">" BORDER=0 height=14

14773

width=15><b><font face="Helvetica, Arial"

14774

><font color="#FFFFFF"><font size="+1">

14775

MAGICK_CODER_MODULE_PATH

14776

</font></font></font></b></td></tr></table>

14777

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for image format coder modules.

14778

This path allows the user to arbitrarily extend the image formats

14779

supported by GraphicsMagick by adding loadable modules to an arbitrary

14780

location rather than copying them into the GraphicsMagick installation

14781

directory. The formatting of the search path is similar to operating

14782

system search paths (i.e. colon delimited for Unix, and semi-colon

14783

delimited for Microsoft Windows). This user specified search path is used

14784

before trying the default search path.</td></tr></table>

14785

14786

<tr>

14787

14788

14789

<img SRC="../images/right_triangle_option.png"

14790

ALT=">" BORDER=0 height=14

14791

width=15><b><font face="Helvetica, Arial"

14792

><font color="#FFFFFF"><font size="+1">

14793

MAGICK_CONFIGURE_PATH

14794

</font></font></font></b></td></tr></table>

14795

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for configuration (.mgk) files.

14796

The formatting of the search path is similar to operating system search

14797

paths (i.e. colon delimited for Unix, and semi-colon delimited for

14798

Microsoft Windows). This user specified search path is used before trying

14799

the default search path.</td></tr></table>

14800

14801

<tr>

14802

14803

14804

<img SRC="../images/right_triangle_option.png"

14805

ALT=">" BORDER=0 height=14

14806

width=15><b><font face="Helvetica, Arial"

14807

><font color="#FFFFFF"><font size="+1">

14808

MAGICK_DEBUG

14809

</font></font></font></b></td></tr></table>

14810

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Debug options (see <strong>-debug</strong> for details)</td></tr></table>

14811

14812

<tr>

14813

14814

14815

<img SRC="../images/right_triangle_option.png"

14816

ALT=">" BORDER=0 height=14

14817

width=15><b><font face="Helvetica, Arial"

14818

><font color="#FFFFFF"><font size="+1">

14819

MAGICK_FILTER_MODULE_PATH

14820

</font></font></font></b></td></tr></table>

14821

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Search path to use when searching for filter process modules

14822

(invoked via <strong>-process</strong>). This path allows the user to arbitrarily

14823

extend GraphicsMagick's image processing functionality by adding loadable

14824

modules to an arbitrary location rather than copying them into the

14825

GraphicsMagick installation directory. The formatting of the search path

14826

is similar to operating system search paths (i.e. colon delimited for

14827

Unix, and semi-colon delimited for Microsoft Windows). This user

14828

specified search path is used before trying the default search path.</td></tr></table>

14829

14830

<tr>

14831

14832

14833

<img SRC="../images/right_triangle_option.png"

14834

ALT=">" BORDER=0 height=14

14835

width=15><b><font face="Helvetica, Arial"

14836

><font color="#FFFFFF"><font size="+1">

14837

MAGICK_FONT_PATH

14838

</font></font></font></b></td></tr></table>

14839

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Directory where GraphicsMagick should look for TrueType and

14840

Postscript Type1 font files if the font file is not found in the current

14841

directory. It is preferred to define the available fonts via type.mgk

14842

rather than use <strong>MAGICK_FONT_PATH</strong>.</td></tr></table>

14843

14844

<tr>

14845

14846

14847

<img SRC="../images/right_triangle_option.png"

14848

ALT=">" BORDER=0 height=14

14849

width=15><b><font face="Helvetica, Arial"

14850

><font color="#FFFFFF"><font size="+1">

14851

MAGICK_HOME

14852

</font></font></font></b></td></tr></table>

14853

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to top of GraphicsMagick installation directory. Only observed

14854

by "uninstalled" builds of GraphicsMagick which do not have their location

14855

hard-coded or set by an installer.</td></tr></table>

14856

14857

<tr>

14858

14859

14860

<img SRC="../images/right_triangle_option.png"

14861

ALT=">" BORDER=0 height=14

14862

width=15><b><font face="Helvetica, Arial"

14863

><font color="#FFFFFF"><font size="+1">

14864

MAGICK_LIMIT_DISK

14865

</font></font></font></b></td></tr></table>

14866

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum amount of disk space allowed for use by the pixel cache.</td></tr></table>

14867

14868

<tr>

14869

14870

14871

<img SRC="../images/right_triangle_option.png"

14872

ALT=">" BORDER=0 height=14

14873

width=15><b><font face="Helvetica, Arial"

14874

><font color="#FFFFFF"><font size="+1">

14875

MAGICK_LIMIT_FILES

14876

</font></font></font></b></td></tr></table>

14877

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum number of open files.</td></tr></table>

14878

14879

<tr>

14880

14881

14882

<img SRC="../images/right_triangle_option.png"

14883

ALT=">" BORDER=0 height=14

14884

width=15><b><font face="Helvetica, Arial"

14885

><font color="#FFFFFF"><font size="+1">

14886

MAGICK_LIMIT_MAP

14887

</font></font></font></b></td></tr></table>

14888

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum size of a memory map.</td></tr></table>

14889

14890

<tr>

14891

14892

14893

<img SRC="../images/right_triangle_option.png"

14894

ALT=">" BORDER=0 height=14

14895

width=15><b><font face="Helvetica, Arial"

14896

><font color="#FFFFFF"><font size="+1">

14897

MAGICK_LIMIT_MEMORY

14898

</font></font></font></b></td></tr></table>

14899

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Maximum amount of memory to allocate from the heap.</td></tr></table>

14900

14901

<tr>

14902

14903

14904

<img SRC="../images/right_triangle_option.png"

14905

ALT=">" BORDER=0 height=14

14906

width=15><b><font face="Helvetica, Arial"

14907

><font color="#FFFFFF"><font size="+1">

14908

MAGICK_TMPDIR

14909

</font></font></font></b></td></tr></table>

14910

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>Path to directory where GraphicsMagick should write temporary

14911

files. The default is to use the system default, or the location set by

14912

<strong>TMPDIR</strong>.</td></tr></table>

14913

14914

<tr>

14915

14916

14917

<img SRC="../images/right_triangle_option.png"

14918

ALT=">" BORDER=0 height=14

14919

width=15><b><font face="Helvetica, Arial"

14920

><font color="#FFFFFF"><font size="+1">

14921

TMPDIR

14922

</font></font></font></b></td></tr></table>

14923

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For POSIX-compatible systems (Unix-compatible), the path to the

14924

directory where all applications should write temporary files.

14925

Overridden by <strong>MAGICK_TMPDIR</strong> if it is set.</td></tr></table>

14926

14927

<tr>

14928

14929

14930

<img SRC="../images/right_triangle_option.png"

14931

ALT=">" BORDER=0 height=14

14932

width=15><b><font face="Helvetica, Arial"

14933

><font color="#FFFFFF"><font size="+1">

14934

TMP <i>or TEMP</i>

14935

</font></font></font></b></td></tr></table>

14936

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>For Microsoft Windows, the path to the directory where applications

14937

should write temporary files. Overridden by <strong>MAGICK_TMPDIR</strong> if it

14938

is set.</td></tr></table>

14939

</td></tr></table>

14940

<p>

14941

<i><a href="#top">Back to Contents</a></i>

14942

 </p>

14943

14944

<tr>

14945

<td ALIGN=LEFT bgcolor="#52799E"><img

14946

SRC="../images/right_triangle.png" ALT=">" BORDER=0

14947

height=14 width=15><b><font face="Helvetica, Arial"><font

14948

color="#FFFFFF"><font size="+1">

14949

<a NAME="mont-file"></a>Configuration Files

14950

</font></font></font></b></td></tr></table>

14951

14952

14953

<p>GraphicsMagick uses a number of XML format configuration files:

14954

14955

<tr>

14956

14957

14958

<img SRC="../images/right_triangle_option.png"

14959

ALT=">" BORDER=0 height=14

14960

width=15><b><font face="Helvetica, Arial"

14961

><font color="#FFFFFF"><font size="+1">

14962

colors.mgk

14963

</font></font></font></b></td></tr></table>

14964

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>colors configuration file</td></tr></table>

14965

<pre>

14966

<?xml version="1.0"?>

14967

14968

<color name="AliceBlue" red="240" green="248" blue="255"

14969

compliance="SVG, X11, XPM" />

14970

</colormap>

14971

</pre>

14972

14973

<tr>

14974

14975

14976

<img SRC="../images/right_triangle_option.png"

14977

ALT=">" BORDER=0 height=14

14978

width=15><b><font face="Helvetica, Arial"

14979

><font color="#FFFFFF"><font size="+1">

14980

delegates.mgk

14981

</font></font></font></b></td></tr></table>

14982

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>delegates configuration file</td></tr></table>

14983

14984

<tr>

14985

14986

14987

<img SRC="../images/right_triangle_option.png"

14988

ALT=">" BORDER=0 height=14

14989

width=15><b><font face="Helvetica, Arial"

14990

><font color="#FFFFFF"><font size="+1">

14991

log.mgk

14992

</font></font></font></b></td></tr></table>

14993

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>logging configuration file</td></tr></table>

14994

<pre>

14995

<?xml version="1.0"?>

14996

14997

14998

14999

15000

15001

15002

15003

</magicklog>

15004

</pre>

15005

15006

<tr>

15007

15008

15009

<img SRC="../images/right_triangle_option.png"

15010

ALT=">" BORDER=0 height=14

15011

width=15><b><font face="Helvetica, Arial"

15012

><font color="#FFFFFF"><font size="+1">

15013

magic.mgk

15014

</font></font></font></b></td></tr></table>

15015

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>file header magic test configuration file</td></tr></table>

15016

<pre>

15017

<?xml version="1.0"?>

15018

15019

15020

</magicmap>

15021

</pre>

15022

15023

<tr>

15024

15025

15026

<img SRC="../images/right_triangle_option.png"

15027

ALT=">" BORDER=0 height=14

15028

width=15><b><font face="Helvetica, Arial"

15029

><font color="#FFFFFF"><font size="+1">

15030

modules.mgk

15031

</font></font></font></b></td></tr></table>

15032

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>loadable modules configuration file</td></tr></table>

15033

<pre>

15034

<?xml version="1.0"?>

15035

15036

15037

</modulemap>

15038

</pre>

15039

15040

<tr>

15041

15042

15043

<img SRC="../images/right_triangle_option.png"

15044

ALT=">" BORDER=0 height=14

15045

width=15><b><font face="Helvetica, Arial"

15046

><font color="#FFFFFF"><font size="+1">

15047

type.mgk

15048

</font></font></font></b></td></tr></table>

15049

<table width="90%" border="0" cellspacing="0" cellpadding="8"> <tr><td width="6%"><br></td><td>master type (fonts) configuration file</td></tr></table>

15050

<pre>

15051

<?xml version="1.0"?>

15052

15053

<<strong></strong>include file="type-windows.mgk" />

15054

<type

15055

name="AvantGarde-Book"

15056

fullname="AvantGarde Book"

15057

family="AvantGarde"

15058

foundry="URW"

15059

weight="400"

15060

style="normal"

15061

stretch="normal"

15062

format="type1"

15063

metrics="/usr/local/share/ghostscript/fonts/a010013l.afm"

15064

glyphs="/usr/local/share/ghostscript/fonts/a010013l.pfb"

15065

/>

15066

</typemap>

15067

</pre>

15068

</td></tr></table>

15069

<p>

15070

<i><a href="#top">Back to Contents</a></i>

15071

 </p>

15072

15073

<tr>

15074

<td ALIGN=LEFT bgcolor="#52799E"><img

15075

SRC="../images/right_triangle.png" ALT=">" BORDER=0

15076

height=14 width=15><b><font face="Helvetica, Arial"><font

15077

color="#FFFFFF"><font size="+1">

15078

<a NAME=mont-ackn"></a>Acknowledgements

15079

</font></font></font></b></td></tr></table>

15080

15081

15082

<p>

15083

The <strong>MIT X Consortium</strong> for making network transparent graphics a reality.

15084

15085

<p>

15086

<em>Michael Halle</em>, <strong>Spatial Imaging Group at MIT</strong>, for the initial

15087

implementation of Alan Paeth's image rotation algorithm.

15088

15089

<p>

15090

<em>David Pensak</em>, <strong>E. I. du Pont de Nemours and Company</strong>, for

15091

providing a computing environment that made this program possible.

15092

15093

<p>

15094

<em>Peder Langlo</em>, <strong>Hewlett Packard</strong>, Norway, made hundreds of suggestions

15095

and bug reports. Without Peder, this software would not be nearly

15096

as useful as it is today.

15097

<p>

15098

<em>Rod Bogart</em> and <em>John W. Peterson</em>, <strong>University of Utah</strong>.

15099

Image compositing is loosely based on rlecomp of the Utah Raster Toolkit.

15100

<p>

15101

<em>Paul Heckbert</em>, <strong>Carnegie Mellon University</strong>. Image resizing is

15102

based on his Zoom program.

15103

<p>

15104

<em>Paul Raveling</em>, <strong>USC Information Sciences Institute</strong>. The

15105

spatial subdivision color reduction algorithm is based on his Img software.

15106

</td></tr></table>

15107

15108

<tr>

15109

<td ALIGN=LEFT bgcolor="#52799E"><img

15110

SRC="../images/right_triangle.png" ALT=">" BORDER=0

15111

height=14 width=15><b><font face="Helvetica, Arial"><font

15112

color="#FFFFFF"><font size="+1">

15113

<a NAME="copy"></a>Copyright

15114

</font></font></font></b></td></tr></table>

15115

15116

15117

<p>

15118

15119

dedicated to making software imaging solutions freely available.</strong>

15120

<p>

15121

<strong>Permission is hereby granted, free of charge, to any person obtaining a

15122

copy of this software and associated documentation files

15123

("GraphicsMagick"), to deal in GraphicsMagick without restriction,

15124

including without limitation the rights to use, copy, modify, merge,

15125

publish, distribute, sublicense, and/or sell copies of GraphicsMagick,

15126

and to permit persons to whom GraphicsMagick is furnished to do so,

15127

subject to the following conditions:</strong>

15128

<p>

15129

<strong>The above copyright notice and this permission notice shall be included

15130

in all copies or substantial portions of GraphicsMagick.</strong>

15131

<p>

15132

<strong>The software is provided "as is", without warranty of any kind,

15133

express or implied, including but not limited to the warranties of

15134

merchantability, fitness for a particular purpose and noninfringement.

15135

In no event shall GraphicsMagick Group be liable for any claim, damages

15136

or other liability, whether in an action of contract, tort or otherwise,

15137

arising from, out of or in connection with GraphicsMagick or the use or

15138

other dealings in GraphicsMagick.</strong>

15139

<p>

15140

<strong>Except as contained in this notice, the name of the GraphicsMagick

15141

Group shall not be used in advertising or otherwise to promote the sale,

15142

use or other dealings in GraphicsMagick without prior written

15143

authorization from the GraphicsMagick Group.</strong>

15144

<p>

15145

<strong>Additional copyrights and licenses apply to this software. You should

15146

have received a copy of Copyright.txt with this package, which describes

15147

additional copyrights and licenses which apply to this software;

15148

otherwise see http://www.graphicsmagick.org/www/Copyright.html.</strong>

15149

</td></tr></table>

15150

<p>

15151

<i><a href="#top">Back to Contents</a></i>

15152

 </p>

15153

<HR>

15154

15155

[<a href="../index.html">Home</a>] [<a href="utilities.html">Utilities Index</a>]

15156

<BR>

15157

<p align=center <a href="Copyright.html">Copyright � GraphicsMagick Group 2002, 2003</a></p></td>

15158

</tr></table>

15159

</body></html>