Penguin
Recent Changes
Annotated edit history of mogrify(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 mogrify
2 !!!mogrify
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 OPTIONS
8 IMAGE SEGMENTATION
9 ENVIRONMENT
10 SEE ALSO
11 COPYRIGHT
12 AUTHORS
13 ----
14 !!NAME
15
16
17 mogrify - mogrify an image
18 !!SYNOPSIS
19
20
21 __mogrify [[__ ''options'' __... ]__ ''file
22 ...''
23 !!DESCRIPTION
24
25
26 __Mogrify__ transforms an image or a sequence of images.
27 These transforms include image scaling, image rotation,
28 color reduction, and others. The transmogrified image
29 overwrites the original image.
30
31
32 The graphics formats supported by __mogrify__ are listed
2 perry 33 in ''!ImageMagick(1)''.
1 perry 34 !!EXAMPLES
35
36
37 To convert all the TIFF files in a particular directory to
38 JPEG, use:
39
40
41 mogrify -format jpeg *.tiff
42
43
44 To scale an image of a cockatoo to exactly 640 pixels in
45 width and 480 pixels in height, use:
46
47
48 mogrify -geometry 640x480! cockatoo.miff
49 !!OPTIONS
50
51
52 Options are processed in command line order. Any option you
53 specify on the command line remains in effect for the set of
54 images that follows, until the set is terminated by the
55 appearance of any option or __-noop__.
56
57
58 For a more detailed description of each option, see
2 perry 59 ''!ImageMagick(1)''.
1 perry 60
61
62 __-affine__ ''''
63
64
65 drawing transform matrix
66
67
68 __-antialias__
69
70
71 remove pixel aliasing
72
73
74 __-background__ ''''
75
76
77 the background color
78
79
80 __-blur__
81 ''''
82
83
84 blur the image with a gaussian operator
85
86
87 __-border__
88 ''''
89
90
91 surround the image with a border of color
92
93
94 __-bordercolor__ ''''
95
96
97 the border color
98
99
100 __-cache__ ''''
101
102
103 megabytes of memory available to the pixel
104 cache
105
106
107 __-channel__ ''''
108
109
110 the type of channel
111
112
113 __-charcoal__ ''''
114
115
116 simulate a charcoal drawing
117
118
119 __-colorize__ ''''
120
121
122 colorize the image with the pen color
123
124
125 __-colors__ ''''
126
127
128 preferred number of colors in the image
129
130
131 __-colorspace__ ''''
132
133
134 the type of colorspace
135
136
137 __-comment__ ''''
138
139
140 annotate an image with a comment
141
142
143 __-compress__ ''''
144
145
146 the type of image compression
147
148
149 __-contrast__
150
151
152 enhance or reduce the image contrast
153
154
155 __-crop__
156 ''''
157
158
159 preferred size and location of the cropped
160 image
161
162
163 __-cycle__ ''''
164
165
166 displace image colormap by amount
167
168
169 __-debug__
170
171
172 enable debug printout
173
174
175 __-delay__ ''
176 ''
177
178
179 display the next image after pausing
180
181
182 __-density__
183 ''''
184
185
186 vertical and horizontal resolution in pixels of the
187 image
188
189
190 __-depth__ ''''
191
192
193 depth of the image
194
195
196 __-despeckle__
197
198
199 reduce the speckles within an image
200
201
202 __-display__
203 ''''
204
205
206 specifies the X server to contact
207
208
209 __-dispose__ ''''
210
211
212 GIF disposal method
213
214
215 __-dither__
216
217
218 apply Floyd/Steinberg error diffusion to the
219 image
220
221
222 __-draw__ ''''
223
224
225 annotate an image with one or more graphic
226 primitives
227
228
229 __-edge__ ''''
230
231
232 detect edges within an image
233
234
235 __-emboss__
236
237
238 emboss an image
239
240
241 __-endian__ ''''
242
243
244 specify endianness (MSB or LSB) of output image
245
246
247 __-enhance__
248
249
250 apply a digital filter to enhance a noisy image
251
252
253 __-equalize__
254
255
256 perform histogram equalization to the image
257
258
259 __-fill__ ''''
260
261
262 color to use when filling a graphic primitive
263
264
265 __-filter__ ''''
266
267
268 use this type of filter when resizing an image
269
270
271 __-flip__
272
273
274 create a
275
276
277 __-flop__
278
279
280 create a
281
282
283 __-font__ ''''
284
285
286 use this font when annotating the image with
287 text
288
289
290 __-format__ ''''
291
292
293 the image format type
294
295
296 __-frame__ ''
297 ''
298
299
300 surround the image with an ornamental border
301
302
303 __-fuzz__ ''''
304
305
306 colors within this distance are considered
307 equal
308
309
310 __-gamma__ ''''
311
312
313 level of gamma correction
314
315
316 __-gaussian__
317 ''''
318
319
320 blur the image with a gaussian operator
321
322
323 __-geometry__
324 ''
325 ''
326
327
328 preferred size and location of the Image
329 window.
330
331
332 __-gravity__ ''''
333
334
335 direction primitive gravitates to when annotating the
336 image.
337
338
339 __-help__
340
341
342 print usage instructions
343
344
345 __-implode__ ''''
346
347
348 implode image pixels about the center
349
350
351 __-interlace__ ''''
352
353
354 the type of interlacing scheme
355
356
357 __-label__ ''''
358
359
360 assign a label to an image
361
362
363 __-level__ ''''
364
365
366 adjust the level of image contrast
367
368
369 __-linewidth__
370
371
372 the line width for subsequent draw operations
373
374
375 __-list__ ''''
376
377
378 the type of list
379
380
381 __-loop__ ''''
382
383
384 add Netscape loop extension to your GIF
385 animation
386
387
388 __-map__ ''''
389
390
391 choose a particular set of colors from this
392 image
393
394
395 __-mask__ ''''
396
397
398 Specify a clipping mask
399
400
401 __-matte__
402
403
404 store matte channel if the image has one
405
406
407 __-mattecolor__ ''''
408
409
410 specify the matte color
411
412
413 __-median__ ''''
414
415
416 apply a median filter to the image
417
418
419 __-modulate__ ''''
420
421
422 vary the brightness, saturation, and hue of an
423 image
424
425
426 __-monochrome__
427
428
429 transform the image to black and white
430
431
432 __-negate__
433
434
435 replace every pixel with its complementary
436 color
437
438
439 __-noise__ ''''
440
441
442 add or reduce noise in an image
443
444
445 __-noop__
446
447
448 NOOP (no option)
449
450
451 __-normalize__
452
453
454 transform image to span the full range of color
455 values
456
457
458 __-opaque__ ''''
459
460
461 change this color to the pen color within the
462 image
463
464
465 __-page__
466 ''''
467
468
469 size and location of an image canvas
470
471
472 __-paint__ ''''
473
474
475 simulate an oil painting
476
477
478 __-pen__ ''''
479
480
481 specify the pen color for drawing operations
482
483
484 __-pointsize__ ''''
485
486
2 perry 487 pointsize of the Postscript, OPTION1, or !TrueType
1 perry 488 font
489
490
491 __-profile__ ''''
492
493
494 add ICM, IPTC, or generic profile to image
495
496
497 __-quality__ ''''
498
499
500 JPEG/MIFF/PNG compression level
501
502
503 __-raise__
504 ''''
505
506
507 lighten or darken image edges
508
509
510 __-region__
511 ''''
512
513
514 apply options to a portion of the image
515
516
517 __-resize__
518 ''''
519
520
521 resize and locate an image
522
523
524 __-roll__ ''{+-}''
525
526
527 roll an image vertically or horizontally
528
529
530 __-rotate__
531 ''''
532
533
534 apply Paeth image rotation to the image
535
536
537 __-sample__ ''''
538
539
540 scale image with pixel sampling
541
542
543 __-sampling_factor__
544 ''''
545
546
547 sampling factors used by JPEG encoder.
548
549
550 __-scale__ ''''
551
552
553 scale the image.
554
555
556 __-scene__ ''''
557
558
559 set scene number
560
561
562 __-seed__ ''''
563
564
565 pseudo-random number generator seed value
566
567
568 __-segment__ ''
569 ''
570
571
572 segment an image
573
574
575 __-shade__
576 ''''
577
578
579 shade the image using a distant light source
580
581
582 __-sharpen__
583 ''''
584
585
586 sharpen the image
587
588
589 __-shave__
590 ''''
591
592
593 shave pixels from the image edges
594
595
596 __-shear__ ''
597 ''
598
599
600 shear the image along the X or Y axis
601
602
603 __-size__
604 ''''
605
606
607 width and height of the image
608
609
610 __-solarize__ ''''
611
612
613 negate all pixels above the threshold level
614
615
616 __-spread__ ''''
617
618
619 displace image pixels by a random amount
620
621
622 __-stroke__ ''''
623
624
625 color to use when stroking a graphic primitive
626
627
628 __-strokewidth__ ''''
629
630
631 set the stroke width
632
633
634 __-swirl__ ''''
635
636
637 swirl image pixels about the center
638
639
640 __-texture__ ''''
641
642
643 name of texture to tile onto the image
644 background
645
646
647 __-threshold__ ''''
648
649
650 threshold the image
651
652
653 __-tile__ ''''
654
655
656 tile image when filling a graphic primitive
657
658
659 __-transparent__ ''''
660
661
662 make this color transparent within the image
663
664
665 __-treedepth__ ''''
666
667
668 tree depth for the color reduction algorithm
669
670
671 __-trim__
672
673
674 trim an image
675
676
677 __-type__ ''''
678
679
680 the image type
681
682
683 __-units__ ''''
684
685
686 the type of image resolution
687
688
689 __-unsharp__
690 ''''
691
692
693 sharpen the image with an unsharp mask operator
694
695
696 __-verbose__
697
698
699 print detailed information about the image
700
701
702 __-view__ ''''
703
704
2 perry 705 !FlashPix viewing parameters
1 perry 706
707
708 __-wave__
709 ''''
710
711
712 alter an image along a sine wave
713
714
715 For a more detailed description of each option, see
2 perry 716 ''!ImageMagick(1)''.
1 perry 717 !!IMAGE SEGMENTATION
718
719
720 Use __-segment__ to segment an image by analyzing the
721 histograms of the color components and identifying units
722 that are homogeneous with the fuzzy c-means technique. The
723 scale-space filter analyzes the histograms of the three
724 color components of the image and identifies a set of
725 classes. The extents of each class is used to coarsely
726 segment the image with thresholding. The color associated
727 with each class is determined by the mean color of all
728 pixels within the extents of a particular class. Finally,
729 any unclassified pixels are assigned to the closest class
730 with the fuzzy c-means technique.
731
732
733 The fuzzy c-Means algorithm can be summarized as
734 follows:
735
736
737 Build a histogram, one for each color component of the
738 image.
739
740
741 For each histogram, successively apply the scale-space
742 filter and build an interval tree of zero crossings in the
743 second derivative at each scale. Analyze this scale-space
744
745
746 The fingerprint defines intervals on the axis of the
747 histogram. Each interval contains either a minima or a
748 maxima in the original signal. If each color component lies
749 within the maxima interval, that pixel is considered
750
751
752 Any pixel that fails to be classified in the above
753 thresholding pass is classified using the fuzzy c-Means
754 technique. It is assigned to one of the classes discovered
755 in the histogram analysis phase.
756
757
758 The fuzzy c-Means technique attempts to cluster a pixel by
759 finding the local minima of the generalized within group sum
760 of squared error objective function. A pixel is assigned to
761 the closest class of which the fuzzy membership has a
762 maximum value.
763
764
765 For additional information see: Young Won Lim,
766 Sang Uk Lee'', ``__On The Color Image Segmentation
767 Algorithm Based on the Thresholding and the Fuzzy c-Means
768 Techniques__'', Pattern Recognition, Volume 23, Number 9,
769 pages 935-952, 1990.__
770 !!ENVIRONMENT
771
772
773 __DISPLAY__
774
775
776 To get the default host, display number, and
777 screen.
778 !!SEE ALSO
779
780
781 display(1), animate(1), identify(1), montage(1), convert(1),
2 perry 782 !ImageMagick(1), composite(1)
1 perry 783 !!COPYRIGHT
784
785
2 perry 786 __Copyright (C) 2002 !ImageMagick Studio__
1 perry 787
788
789 __Permission is hereby granted, free of charge, to any
790 person obtaining a copy of this software and associated
791 documentation files (
792 __
793
794
795 __The above copyright notice and this permission notice
796 shall be included in all copies or substantial portions of
2 perry 797 !ImageMagick.__
1 perry 798
799
800 __The software is provided
801 __
802
803
804 __Except as contained in this notice, the name of the
2 perry 805 !ImageMagick Studio LLC shall not be used in advertising or
1 perry 806 otherwise to promote the sale, use or other dealings in
2 perry 807 !ImageMagick without prior written authorization from the
808 !ImageMagick Studio.__
1 perry 809 !!AUTHORS
810
811
2 perry 812 ''John Cristy, !ImageMagick Studio LLC, Glenn
813 Randers-Pehrson, !ImageMagick Studio LLC.''
1 perry 814 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.