Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for conjure (redhat section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

conjure(1)									       conjure(1)

       conjure - process a Magick Scripting Language (MSL) script

       WARNING:  Conjure  and  MSL  are  in  very  early development and the syntax is subject to

       conjure [ options ] script.msl [ [ options ] script.msl ]

       The Magick scripting language (MSL) will primarily benefit those that want  to  accomplish
       custom image processing tasks but do not wish to program, or those that do not have access
       to a Perl interpreter or a compiler.  The interpreter is called conjure	and  here  is  an
       example script:

	   <?xml version="1.0" encoding="UTF-8"?>
	   <image size="400x400" >
	     <read filename="image.gif" />
	     <get width="base-width" height="base-height" />
	     <resize geometry="%[dimensions]" />
	     <get width="width" height="height" />
	     <print output=
	       "Image sized from %[base-width]x%[base-height]
		to %[width]x%[height].\n" />
	     <write filename="image.png" />

       invoked with

	   conjure -dimensions 400x400 incantation.msl

       All  operations will closely follow the key/value pairs defined in PerlMagick, unless oth-
       erwise noted.

       Conjure is in the early stages of development as of April 2002.

       This early announcement is to allow ImageMagick users to contribute  ideas  early  in  the
       process	so when the scripting language is released it will be useful/stable from the get-
       go!  If you want to contribute suggestions about the Magick scripting language (MSL), post
       them to magick-developers@imagemagick.org.

       Options	are  processed	in command line order. Any option you specify on the command line
       remains in effect until it is explicitly changed by specifying the  option  again  with	a
       different effect, or if it is changed by a statement in the scripting language.

       You  can define your own keyword/value pairs on the command line.  The script can then use
       this information when setting values by including %[keyword] in the string.  For  example,
       if  you included "-dimensions 400x400" on the command line, as illustrated above, then any
       string containing "%[dimensions]" would have 400x400 substituted.  The "%[string]" can  be
       used  either  an  entire string, such as geometry="%[dimensions]" or as a part of a string
       such as filename="%[basename].png".

       The keyword can be any string except for the following reserved	strings  (in  any  upper,
       lower, or mixed case variant): debug, help, and verbose, whose usage is described below.

       The  value  can be any string.  If either the keyword or the value contains white space or
       any symbols that have special meanings to your shell such as "#", "|", or "%", enclose the
       string in quotation marks or use "\" to escape the white space and special symbols.

       Keywords  and values are case dependent.  "Key", "key", and "KEY" would be three different

       For a more detailed description of each option, see ImageMagick(1).

       -debug enable debug printout

       -help  print usage instructions

	      print detailed information about the image

       The Magick Scripting Language (MSL) presently defines the  following  elements  and  their


		    Define  a  new  image  object.  </image> destroys it. Because of this, if you
		    wish to reference multiple "subimages" (aka pages or layers), you  can  embed
		    one image element inside of another. For example:

			<read filename="input.png" />
			<get width="base-width" height="base-height" />
			<image height="base-height" width="base-width">
			<image />
			<write filename="output.mng" />

			<image size="400x400" />


		    Define  a  new group of image objects.  By default, images are only valid for
		    the life of their <image>element.

			<image>   -- creates the image
			.....	  -- do stuff with it
			</image>  -- dispose of the image

		    However, in a group, all images in that group will stay around for	the  life
		    of the group:

			<group> 			  -- start a group
			    <image>			  -- create an image
			    ....			  -- do stuff
			    </image>			  -- NOOP
			    <image>			  -- create another image
			    ....			  -- do more stuff
			    </image>			  -- NOOP
			    <write filename="image.mng" />  -- output
			</group>			  -- dispose of both images


		    Read a new image from a disk file.

			<read filename="image.gif" />

		    To read two images use

			<read filename="image.gif" />
			<read filename="image.png />


		    Write  the image(s) to disk, either as a single multiple-image file or multi-
		    ple ones if necessary.

			 <write filename=image.tiff" />

		    Get any attribute recognized by PerlMagick's GetAttribute() and stores it  as
		    an	image  attribute  for later use. Currently only width and height are sup-

			<get width="base-width" height="base-height" />
			<print output="Image size is %[base-width]x%[base-height].\n" />


		    background, bordercolor, clip-mask, colorspace, density, magick,  mattecolor,
		    opacity.  Set an attribute recognized by PerlMagick's GetAttribute().

			fill, geometry, height, width

			radius, sigma

			radius, sigma

			geometry, height, width, x, y

			geometry, height, width, x, y


			radius, sigma





			fill, geometry, height, width, x, y, inner, outer

			height, width

			background, color, id, size






			blur, filter, geometry, height, width

			geometry, x, y


			geometry, height, width

			geometry, height, width

			radius, sigma

			geometry, height, width

			x, y









       animate(1), display(1), composite(1), convert(1), identify(1), import(1), mogrify(1), mon-

       Copyright (C) 2002 ImageMagick Studio

       Permission is hereby granted, free of charge, to any person obtaining a copy of this soft-
       ware  and  associated  documentation files ("ImageMagick"), to deal in ImageMagick without
       restriction, including without limitation the rights to use, copy, modify, merge, publish,
       distribute,  sublicense,  and/or sell copies of ImageMagick, and to permit persons to whom
       the ImageMagick is furnished to do so, subject to the following conditions:

       The above copyright notice and this permission notice shall be included in all  copies  or
       substantial portions of ImageMagick.

       The  software  is  provided  "as  is",  without	warranty of any kind, express or implied,
       including but not limited to the warranties of merchantability, fitness for  a  particular
       purpose	and noninfringement.In no event shall ImageMagick Studio be liable for any claim,
       damages or other liability, whether in an action of contract, tort or  otherwise,  arising
       from,  out  of or in connection with ImageMagick or the use or other dealings in ImageMag-

       Except as contained in this notice, the name of the ImageMagick Studio LLC  shall  not  be
       used in advertising or otherwise to promote the sale, use or other dealings in ImageMagick
       without prior written authorization from the ImageMagick Studio.

	John Cristy, ImageMagick Studio LLC,
       Glenn Randers-Pehrson, ImageMagick Studio LLC,
       Leonard Rosenthol, ImageMagick Studio LLC.

ImageMagick			    Date: 2002/02/15 01:00:00			       conjure(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 03:28 AM.