47#include "MagickWand/studio.h"
48#include "MagickWand/MagickWand.h"
49#include "MagickWand/mogrify-private.h"
50#include "MagickCore/stream-private.h"
51#include "MagickCore/string-private.h"
87static MagickBooleanType StreamUsage(
void)
91 " -channel mask set the image channel mask\n"
92 " -debug events display copious debugging information\n"
93 " -help print program options\n"
94 " -list type print a list of supported option arguments\n"
95 " -log format format of debugging information\n"
96 " -version print version information",
98 " -authenticate password\n"
99 " decipher image with this password\n"
100 " -colorspace type alternate image colorspace\n"
101 " -compress type type of pixel compression when writing the image\n"
102 " -define format:option\n"
103 " define one or more image format options\n"
104 " -density geometry horizontal and vertical density of the image\n"
105 " -depth value image depth\n"
106 " -extract geometry extract area from image\n"
107 " -identify identify the format and characteristics of the image\n"
108 " -interlace type type of image interlacing scheme\n"
109 " -interpolate method pixel color interpolation method\n"
110 " -limit type value pixel cache resource limit\n"
111 " -map components one or more pixel components\n"
112 " -monitor monitor progress\n"
113 " -quantize colorspace reduce colors in this colorspace\n"
114 " -quiet suppress all warning messages\n"
115 " -regard-warnings pay attention to warning messages\n"
116 " -respect-parentheses settings remain in effect until parenthesis boundary\n"
117 " -sampling-factor geometry\n"
118 " horizontal and vertical sampling factor\n"
119 " -seed value seed a new sequence of pseudo-random numbers\n"
120 " -set attribute value set an image attribute\n"
121 " -size geometry width and height of image\n"
122 " -storage-type type pixel storage type\n"
123 " -synchronize synchronize image to storage device\n"
124 " -taint declare the image as modified\n"
125 " -transparent-color color\n"
126 " transparent color\n"
127 " -verbose print detailed information about the image\n"
128 " -virtual-pixel method\n"
129 " virtual pixel access method";
131 ListMagickVersion(stdout);
132 (void) printf(
"Usage: %s [options ...] input-image raw-image\n",
134 (void) printf(
"\nImage Settings:\n");
135 (void) puts(settings);
136 (void) printf(
"\nMiscellaneous Options:\n");
137 (void) puts(miscellaneous);
139 "\nBy default, the image format of 'file' is determined by its magic\n");
141 "number. To specify a particular image format, precede the filename\n");
143 "with an image format name and a colon (i.e. ps:image) or specify the\n");
145 "image type as the filename suffix (i.e. image.ps). Specify 'file' as\n");
146 (void) printf(
"'-' for standard input or output.\n");
150WandExport MagickBooleanType StreamImageCommand(ImageInfo *image_info,
151 int argc,
char **argv,
char **metadata,ExceptionInfo *exception)
153#define DestroyStream() \
155 DestroyImageStack(); \
156 stream_info=DestroyStreamInfo(stream_info); \
157 for (i=0; i < (ssize_t) argc; i++) \
158 argv[i]=DestroyString(argv[i]); \
159 argv=(char **) RelinquishMagickMemory(argv); \
161#define ThrowStreamException(asperity,tag,option) \
163 char *message = GetExceptionMessage(errno); \
164 (void) ThrowMagickException(exception,GetMagickModule(),asperity,tag, \
165 "`%s'",option == (char *) NULL ? message : option); \
166 message=DestroyString(message); \
168 return(MagickFalse); \
170#define ThrowStreamInvalidArgumentException(option,argument) \
172 (void) ThrowMagickException(exception,GetMagickModule(),OptionError, \
173 "InvalidArgument","'%s': %s",option,argument); \
175 return(MagickFalse); \
186 *image = (Image *) NULL;
189 image_stack[MaxImageStackDepth+1];
212 assert(image_info != (ImageInfo *) NULL);
213 assert(image_info->signature == MagickCoreSignature);
214 assert(exception != (ExceptionInfo *) NULL);
215 if (IsEventLogging() != MagickFalse)
216 (void) LogMagickEvent(TraceEvent,GetMagickModule(),
"...");
221 if ((LocaleCompare(
"help",option+1) == 0) ||
222 (LocaleCompare(
"-help",option+1) == 0))
223 return(StreamUsage());
224 if ((LocaleCompare(
"version",option+1) == 0) ||
225 (LocaleCompare(
"-version",option+1) == 0))
227 ListMagickVersion(stdout);
233 (void) ThrowMagickException(exception,GetMagickModule(),OptionError,
234 "MissingArgument",
"%s",
"");
235 (void) StreamUsage();
243 option=(
char *) NULL;
245 respect_parentheses=MagickFalse;
246 stream_info=AcquireStreamInfo(image_info,exception);
251 ReadCommandlLine(argc,&argv);
252 status=ExpandFilenames(&argc,&argv);
253 if (status == MagickFalse)
254 ThrowStreamException(ResourceLimitError,
"MemoryAllocationFailed",
256 status=OpenStream(image_info,stream_info,argv[argc-1],exception);
257 if (status == MagickFalse)
262 for (i=1; i < ((ssize_t) argc-1); i++)
265 if (LocaleCompare(option,
"(") == 0)
267 FireImageStack(MagickFalse,MagickTrue,pend);
268 if (k == MaxImageStackDepth)
269 ThrowStreamException(OptionError,
"ParenthesisNestedTooDeeply",option);
273 if (LocaleCompare(option,
")") == 0)
275 FireImageStack(MagickFalse,MagickTrue,MagickTrue);
277 ThrowStreamException(OptionError,
"UnableToParseExpression",option);
281 if (IsCommandOption(option) == MagickFalse)
289 FireImageStack(MagickFalse,MagickFalse,pend);
291 if ((LocaleCompare(filename,
"--") == 0) && (i < ((ssize_t) argc-1)))
293 (void) CopyMagickString(image_info->filename,filename,MagickPathExtent);
294 images=StreamImage(image_info,stream_info,exception);
295 status&=(MagickStatusType) (images != (Image *) NULL) &&
296 (exception->severity < ErrorException);
297 if (images == (Image *) NULL)
299 AppendImageStack(images);
302 pend=image != (Image *) NULL ? MagickTrue : MagickFalse;
307 if (LocaleCompare(
"authenticate",option+1) == 0)
312 if (i == (ssize_t) argc)
313 ThrowStreamException(OptionError,
"MissingArgument",option);
316 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
320 if (LocaleCompare(
"cache",option+1) == 0)
325 if (i == (ssize_t) argc)
326 ThrowStreamException(OptionError,
"MissingArgument",option);
327 if (IsGeometry(argv[i]) == MagickFalse)
328 ThrowStreamInvalidArgumentException(option,argv[i]);
331 if (LocaleCompare(
"channel",option+1) == 0)
339 if (i == (ssize_t) argc)
340 ThrowStreamException(OptionError,
"MissingArgument",option);
341 channel=ParseChannelOption(argv[i]);
343 ThrowStreamException(OptionError,
"UnrecognizedChannelType",
347 if (LocaleCompare(
"colorspace",option+1) == 0)
355 if (i == (ssize_t) argc)
356 ThrowStreamException(OptionError,
"MissingArgument",option);
357 colorspace=ParseCommandOption(MagickColorspaceOptions,MagickFalse,
360 ThrowStreamException(OptionError,
"UnrecognizedColorspace",
364 if (LocaleCompare(
"compress",option+1) == 0)
372 if (i == (ssize_t) argc)
373 ThrowStreamException(OptionError,
"MissingArgument",option);
374 compress=ParseCommandOption(MagickCompressOptions,MagickFalse,
377 ThrowStreamException(OptionError,
"UnrecognizedImageCompression",
381 if (LocaleCompare(
"concurrent",option+1) == 0)
383 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
387 if (LocaleCompare(
"debug",option+1) == 0)
395 if (i == (ssize_t) argc)
396 ThrowStreamException(OptionError,
"MissingArgument",option);
397 event=ParseCommandOption(MagickLogEventOptions,MagickFalse,argv[i]);
399 ThrowStreamException(OptionError,
"UnrecognizedEventType",argv[i]);
400 (void) SetLogEventMask(argv[i]);
403 if (LocaleCompare(
"define",option+1) == 0)
406 if (i == (ssize_t) argc)
407 ThrowStreamException(OptionError,
"MissingArgument",option);
413 define=GetImageOption(image_info,argv[i]);
414 if (define == (
const char *) NULL)
415 ThrowStreamException(OptionError,
"NoSuchOption",argv[i]);
420 if (LocaleCompare(
"density",option+1) == 0)
425 if (i == (ssize_t) argc)
426 ThrowStreamException(OptionError,
"MissingArgument",option);
427 if (IsGeometry(argv[i]) == MagickFalse)
428 ThrowStreamInvalidArgumentException(option,argv[i]);
431 if (LocaleCompare(
"depth",option+1) == 0)
436 if (i == (ssize_t) argc)
437 ThrowStreamException(OptionError,
"MissingArgument",option);
438 if (IsGeometry(argv[i]) == MagickFalse)
439 ThrowStreamInvalidArgumentException(option,argv[i]);
442 if (LocaleCompare(
"duration",option+1) == 0)
447 if (i == (ssize_t) argc)
448 ThrowStreamException(OptionError,
"MissingArgument",option);
449 if (IsGeometry(argv[i]) == MagickFalse)
450 ThrowStreamInvalidArgumentException(option,argv[i]);
453 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
457 if (LocaleCompare(
"extract",option+1) == 0)
462 if (i == (ssize_t) argc)
463 ThrowStreamException(OptionError,
"MissingArgument",option);
464 if (IsGeometry(argv[i]) == MagickFalse)
465 ThrowStreamInvalidArgumentException(option,argv[i]);
468 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
472 if ((LocaleCompare(
"help",option+1) == 0) ||
473 (LocaleCompare(
"-help",option+1) == 0))
476 return(StreamUsage());
478 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
482 if (LocaleCompare(
"identify",option+1) == 0)
484 if (LocaleCompare(
"interlace",option+1) == 0)
492 if (i == (ssize_t) argc)
493 ThrowStreamException(OptionError,
"MissingArgument",option);
494 interlace=ParseCommandOption(MagickInterlaceOptions,MagickFalse,
497 ThrowStreamException(OptionError,
"UnrecognizedInterlaceType",
501 if (LocaleCompare(
"interpolate",option+1) == 0)
509 if (i == (ssize_t) argc)
510 ThrowStreamException(OptionError,
"MissingArgument",option);
511 interpolate=ParseCommandOption(MagickInterpolateOptions,MagickFalse,
514 ThrowStreamException(OptionError,
"UnrecognizedInterpolateMethod",
518 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
522 if (LocaleCompare(
"limit",option+1) == 0)
536 if (i == (ssize_t) argc)
537 ThrowStreamException(OptionError,
"MissingArgument",option);
538 resource=ParseCommandOption(MagickResourceOptions,MagickFalse,
541 ThrowStreamException(OptionError,
"UnrecognizedResourceType",
544 if (i == (ssize_t) argc)
545 ThrowStreamException(OptionError,
"MissingArgument",option);
546 value=StringToDouble(argv[i],&p);
548 if ((p == argv[i]) && (LocaleCompare(
"unlimited",argv[i]) != 0))
549 ThrowStreamInvalidArgumentException(option,argv[i]);
552 if (LocaleCompare(
"list",option+1) == 0)
560 if (i == (ssize_t) argc)
561 ThrowStreamException(OptionError,
"MissingArgument",option);
562 list=ParseCommandOption(MagickListOptions,MagickFalse,argv[i]);
564 ThrowStreamException(OptionError,
"UnrecognizedListType",argv[i]);
565 status=MogrifyImageInfo(image_info,(
int) (i-j+1),(
const char **)
568 return(status == 0 ? MagickFalse : MagickTrue);
570 if (LocaleCompare(
"log",option+1) == 0)
575 if ((i == (ssize_t) argc) || (strchr(argv[i],
'%') == (
char *) NULL))
576 ThrowStreamException(OptionError,
"MissingArgument",option);
579 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
583 if (LocaleCompare(
"map",option+1) == 0)
585 (void) CopyMagickString(argv[i]+1,
"san",MagickPathExtent);
589 SetStreamInfoMap(stream_info,argv[i]);
592 if (LocaleCompare(
"monitor",option+1) == 0)
594 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
598 if (LocaleCompare(
"quantize",option+1) == 0)
606 if (i == (ssize_t) argc)
607 ThrowStreamException(OptionError,
"MissingArgument",option);
608 colorspace=ParseCommandOption(MagickColorspaceOptions,
609 MagickFalse,argv[i]);
611 ThrowStreamException(OptionError,
"UnrecognizedColorspace",
615 if (LocaleCompare(
"quiet",option+1) == 0)
617 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
621 if (LocaleCompare(
"regard-warnings",option+1) == 0)
623 if (LocaleNCompare(
"respect-parentheses",option+1,17) == 0)
625 respect_parentheses=(*option ==
'-') ? MagickTrue : MagickFalse;
628 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
632 if (LocaleCompare(
"sampling-factor",option+1) == 0)
637 if (i == (ssize_t) argc)
638 ThrowStreamException(OptionError,
"MissingArgument",option);
639 if (IsGeometry(argv[i]) == MagickFalse)
640 ThrowStreamInvalidArgumentException(option,argv[i]);
643 if (LocaleCompare(
"seed",option+1) == 0)
648 if (i == (ssize_t) argc)
649 ThrowStreamException(OptionError,
"MissingArgument",option);
650 if (IsGeometry(argv[i]) == MagickFalse)
651 ThrowStreamInvalidArgumentException(option,argv[i]);
654 if (LocaleCompare(
"set",option+1) == 0)
657 if (i == (ssize_t) argc)
658 ThrowStreamException(OptionError,
"MissingArgument",option);
662 if (i == (ssize_t) argc)
663 ThrowStreamException(OptionError,
"MissingArgument",option);
666 if (LocaleCompare(
"size",option+1) == 0)
671 if (i == (ssize_t) argc)
672 ThrowStreamException(OptionError,
"MissingArgument",option);
673 if (IsGeometry(argv[i]) == MagickFalse)
674 ThrowStreamInvalidArgumentException(option,argv[i]);
677 if (LocaleCompare(
"storage-type",option+1) == 0)
685 if (i == (ssize_t) argc)
686 ThrowStreamException(OptionError,
"MissingArgument",option);
687 type=ParseCommandOption(MagickStorageOptions,MagickFalse,argv[i]);
689 ThrowStreamException(OptionError,
"UnrecognizedStorageType",
691 SetStreamInfoStorageType(stream_info,(StorageType) type);
694 if (LocaleCompare(
"synchronize",option+1) == 0)
696 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
700 if (LocaleCompare(
"taint",option+1) == 0)
702 if (LocaleCompare(
"transparent-color",option+1) == 0)
707 if (i == (ssize_t) argc)
708 ThrowStreamException(OptionError,
"MissingArgument",option);
711 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
715 if (LocaleCompare(
"verbose",option+1) == 0)
717 if ((LocaleCompare(
"version",option+1) == 0) ||
718 (LocaleCompare(
"-version",option+1) == 0))
720 ListMagickVersion(stdout);
723 if (LocaleCompare(
"virtual-pixel",option+1) == 0)
731 if (i == (ssize_t) argc)
732 ThrowStreamException(OptionError,
"MissingArgument",option);
733 method=ParseCommandOption(MagickVirtualPixelOptions,MagickFalse,
736 ThrowStreamException(OptionError,
"UnrecognizedVirtualPixelMethod",
740 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
745 ThrowStreamException(OptionError,
"UnrecognizedOption",option)
747 fire=(GetCommandOptionFlags(MagickCommandOptions,MagickFalse,option) &
748 FireOptionFlag) == 0 ? MagickFalse : MagickTrue;
749 if (fire != MagickFalse)
750 FireImageStack(MagickFalse,MagickTrue,MagickTrue);
753 ThrowStreamException(OptionError,
"UnbalancedParenthesis",argv[i]);
754 if (i-- != ((ssize_t) argc-1))
755 ThrowStreamException(OptionError,
"MissingAnImageFilename",argv[i]);
756 if (image == (Image *) NULL)
757 ThrowStreamException(OptionError,
"MissingAnImageFilename",argv[i]);
758 FinalizeImageSettings(image_info,image,MagickTrue);
759 if (image == (Image *) NULL)
760 ThrowStreamException(OptionError,
"MissingAnImageFilename",argv[i]);
762 return(status != 0 ? MagickTrue : MagickFalse);