Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
asimagexml(1)		 AfterStep X11 window manager		 asimagexml(1)

NAME
       asimagexml -  XML schema	to be used for scripting image manipulation by
       AfterStep and ascompose libAfterImage/asimagexml

NAMEascompose
       is a tool to compose image(s) and display/save it based on supplied XML
       input file.

DESCRIPTION
       ascompose  reads	 supplied XML data, and	manipulates image accordingly.
       It could	transform images from files of any supported file format, draw
       gradients,  render antialiased texturized text, perform superimposition
       of arbitrary number of images, and save images into  files  of  any  of
       supported output	file formats.

       At any point, the result	of any operation could be assigned a name, and
       later on	referenced under this name.

       At any point during the script  processing,  result  of	any  operation
       could be	saved into a file of any supported file	types.

       Internal	image format is	32bit ARGB with	8bit per channel.

       Last  image referenced, will be displayed in X window, unless -n	option
       is specified. If	-r option is specified,	then this image	will  be  dis-
       played  in  root	 window	of X display, effectively setting a background
       for a desktop. If -o option is specified, this image will also be saved
       into the	file or	requested type.

TAGS
       Here  is	 the  list  and	description of possible	XML tags to use	in the
       script :
	   img	     - load image from the file.
	   recall    - recall previously loaded/generated image	by its name.
	   text	     - render text string into new image.
	   save	     - save an image into the file.
	   bevel     - draw solid bevel	frame around the image.
	   gradient  - render multipoint gradient.
	   mirror    - create mirror copy of an	image.
	   blur	     - perform gaussian	blur on	an image.
	   rotate    - rotate/flip image in 90 degree increments.
	   scale     - scale an	image to arbitrary size.
	   slice     - enlarge image to	arbitrary  size	 leaving  corners  un-
       changed.
	   crop	     - crop an image to	arbitrary size.
	   tile	     - tile an image to	arbitrary size.
	   hsv	     - adjust Hue, Saturation and Value	of an image.
	   pad	     - pad image with solid color from either or all sides.
	   solid     - generate	new image of requested size, filled with solid
		    color.
	   composite - superimpose arbitrary number of images using one	of 15
		    available methods.
	if	  - conditional	processing based on value of the variables
	set	  - sets value of the variable
	printf	  - formated printing of the value of the variable

       Each  tag generates new image as	the result of the transformation - ex-
       isting images are never modified	and could be reused as many  times  as
       needed. See below for description of each tag.

       Whenever	 numerical  values are involved, the basic math	ops (add, sub-
       tract, multiply,	divide), unary minus, and parentheses are supported.

       Operator	precedence is NOT supported.  Percentages are allowed, and ap-
       ply to either width or height of	the appropriate	image (usually the re-
       fid image).

       Also, variables of the form $image.width	 and  $image.height  are  sup-
       ported.	$image.width is	the width of the image with refid "image", and
       $image.height  is  the  height  of  the	same   image.	 The   special
       $xroot.width  and  $xroot.height	 values	 are defined by	the the	X root
       window, if there	is one.	 This allows images to be scaled to the	 desk-
       top size: <scale	width="$xroot.width" height="$xroot.height">.

       Each tag	is only	allowed	to return ONE image.

NAMEtext
       - render	text string into new image, using specific font, size and tex-
       ture.

SYNOPSIS
       <text id="new_id" font="font" point="size" fgcolor="color"
	     bgcolor="color" fgimage="image_id"	bgimage="image_id"
	     spacing="points" type="3dtype">My Text Here</text>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       font   Optional.	Default	is "fixed". Font to use	for text.

       point  Optional.	Default	is 12. Size of text in points.

       fgcolor
	      Optional.	No default. The	text will be drawn in this color.

       bgcolor
	      Optional.	No default. The	area behind the	text will be drawn  in
	      this color.

       fgimage
	      Optional.	No default. The	text will be textured by this image.

       bgimage
	      Optional.	 No  default.  The area	behind the text	will be	filled
	      with this	image.

       spacing
	      Optional.	Default	0. Extra pixels	to place between each glyph.

       type   Optional.	Default	0. Valid values	are from 0 to 7	and each  rep-
	      reseend different	3d type.

NOTES
       <text>  without	bgcolor, fgcolor, fgimage, or bgimage will NOT produce
       visible output by itself.  See EXAMPLES below.

NAMEcomposite
       - superimpose arbitrary number of images	on top of each other.

SYNOPSIS
       <composite id="new_id" op="op_desc"
		  keep-transparency="0|1" merge="0|1">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       op     Optional.	Default	is "alphablend".  The  compositing  operation.
	      Valid  values are	the standard AS	blending ops: add, alphablend,
	      allanon, colorize, darken, diff, dissipate, hue, lighten,	 over-
	      lay, saturate, screen, sub, tint,	value.

       merge  Optional.	 Default is "expand". Valid values are "clip" and "ex-
	      pand". Determines	whether	final image will be  expanded  to  the
	      maximum size of the layers, or clipped to	the bottom layer.

       keep-transparency
	      Optional.	 Default  is "0". Valid	values are "0" and "1".	If set
	      to "1", the transparency of the bottom layer will	 be  kept  for
	      the final	image.

NOTES
       All images surrounded by	this tag will be composited with the given op.

ATTRIBUTES
	All tags surrounded by this tag	may have some of the common attributes
	in addition to their normal ones.  Under no circumstances is there a
	conflict with the normal child attributes:

       crefid Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	percentages  in	 "x"  and  "y"
	      will be derived from the width and height	of the crefid image.

       x      Optional.	Default	is 0. Pixel coordinate of left edge.

       y      Optional.	Default	is 0. Pixel coordinate of top edge.

       align  Optional.	 Alternative  to  x - allowed values are right,	center
	      and left.

       valign Optional.	Alternative to y - allowed values are top, middle  and
	      bottom.

       clip_x Optional.	 Default is 0. X Offset	on infinite surface tiled with
	      this image, from which to	cut portion of an image	to be used  in
	      composition.

       clip_y Optional.	 Default is 0. Y Offset	on infinite surface tiled with
	      this image, from which to	cut portion of an image	to be used  in
	      composition.

       clip_width
	      Optional.	Default	is image width.	Tile image to this width prior
	      to superimposition.

       clip_height
	      Optional.	Default	is image height. Tile  image  to  this	height
	      prior to superimposition.

       tile   Optional.	 Default  is  0.  If  set will cause image to be tiled
	      across entire composition, unless	overridden  by	clip_width  or
	      clip_height.

       tint   Optional.	Additionally tint an image to specified	color. Tinting
	      can both lighten	and  darken  an	 image.	 Tinting  color	 0  or
	      #7f7f7f7f	 yields	 no  tinting.  Tinting can be performed	on any
	      channel, including alpha channel.

SEE ALSO
       libAfterImage

NAMEimg
       - load image from the file.

SYNOPSIS
       <img id="new_img_id" src="filename"/>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       src    Required.	The filename (NOT URL) of the image file to load.

NOTES
       The special image src "xroot:" will import the background image of  the
       root X window, if any.  No attempt will be made to offset this image to
       fit the location	of the resulting window, if one	is displayed.

NAMErecall
       - recall	previously generated and named image by	its id.

SYNOPSIS
       <recall id="new_id" srcid="image_id" default_src="filename"/>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       srcid  Required.	An image ID defined with the "id"  parameter  for  any
	      previously created image.	 libAfterImage/asimagexml/release

NAMErelease
       - release (destroy if possible) previously generated and	named image by
       its id.

SYNOPSIS
       <release	srcid="image_id"/>

ATTRIBUTES
       srcid  Required.	An image ID defined with the "id"  parameter  for  any
	      previously created image.	 libAfterImage/asimagexml/color

NAMEcolor
       - defines symbolic name for a color and set of variables.

SYNOPSIS
       <color name="sym_name" domain="var_domain" argb="colorvalue"/>

ATTRIBUTES
       name   Symbolic	name  for the color value, to be used to refer to that
	      color.

       argb   8	characters hex definition of the color or other	symbolic color
	      name.

       domain string to	be used	to prepend names of defined variables.

NOTES
       In  addition  to	defining symbolic name for the color this tag will de-
       fine    7    other    variables	  :	   domain.sym_name.red,	   do-
       main.sym_name.green,
			       domain.sym_name.blue, domain.sym_name.alpha,
			       domain.sym_name.hue,    domain.sym_name.satura-
       tion,
			       domain.sym_name.value

NAMEcolor2alpha
       - set alpha channel based on color closeness to specified color

SYNOPSIS
       <color2alpha	id="new_id"	ref_id="other_imag"	width="pixels"
       height="pixels"
	      clip_x="clip_x" clip_y="clip_y"
	      color="color">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       width  Required.	The image will be scaled to this width.

       height Required.	The image will be scaled to this height.

       clip_x Optional.	Offset into original image.

       clip_y Optional.	Offset into original image.

       color  Required.	Color to match against.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther  images  will be discarded.	 If you	want to	keep image proportions
       while resizing-use "proportional" instead of specific size for particu-
       lar dimention.

NAMEprintf
       - prints	variable value to standard output.

SYNOPSIS
       <printf format="format_string" var="variable_name" val="expression"/>

ATTRIBUTES
       format_string
	      Standard C format	string with exactly 1 placeholder.

       var    Name of the variable, which value	will be	printed.

       val    math expression to be printed.

NOTESlibAfterImage/asimagexml/set
NAMEset
       - declares variable, assigning it a numeric value of expression.

SYNOPSIS
       <set var="variable_name"	domain="var_domain" val="expression"/>

ATTRIBUTES
       var    Name of the variable, which value	will be	set.

       val    math expression to be evaluated.

       domain (optional)  variable's  domain to	be prepended to	its name using
	      format var_domain.variable_name libAfterImage/asimagexml/if

NAMEif
       - evaluates logical expression and if result evaluates to  not  true(or
       false if	<unless> tag is	used ),	handles	tags within.

SYNOPSIS
       <if val1="expression" [op="gt|lt|ge|le|eq|ne" val2="expression"]/>
	   [<then>...</then><else>...</else>]  </if> <unless val1="expression"
       [op="gt|lt|ge|le|eq|ne" val2="expression"]/>

ATTRIBUTES
       val1   math expression to be evaluated.

       val2   math expression to be evaluated.

       op     (optional) comparison op to be applied to	values

EXAMPLE
       <if		    val1="$ascs.Base.value"		     val2="50"
       op="gt"><then>...</then><else>...</else></if>

NAMEgradient
       - render	multipoint gradient.

SYNOPSIS
       <gradient id="new_id" angle="degrees"
		 refid="refid" width="pixels" height="pixels"
		 colors	="color1 color2	color3 [...]"
		 offsets="fraction1 fraction2 fraction3	[...]"/>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       width  Optional.	The result will	have this width.

       height Optional.	The result will	have this height.

       colors Required.	Whitespace-separated list of colors. At	least two col-
	      ors  are	required.  Each	 color in this list will be visited in
	      turn, at the intervals given by the offsets attribute.

       offsets
	      Optional.	Whitespace-separated list  of  floating	 point	values
	      ranging  from  0.0  to 1.0. The colors from the colors attribute
	      are given	these offsets, and the final gradient is rendered from
	      the combination of the two. If both colors and offsets are given
	      but the number of	colors and offsets do not match,  the  minimum
	      of  the  two  will  be  used, and	the other will be truncated to
	      match. If	offsets	are not	given, a smooth	stepping from  0.0  to
	      1.0 will be used.

       angle  Optional.	 Given in degrees. Default is 0. This is the direction
	      of the gradient. Currently the only supported values are 0,  45,
	      90, 135, 180, 225, 270, 315. 0 means left	to right, 90 means top
	      to bottom, etc.  libAfterImage/asimagexml/solid

NAMEsolid
       - generate image	of specified size and fill it with solid color.

SYNOPSIS
       <solid id="new_id" color="color"	opacity="opacity"
	   width="pixels" height="pixels"
	   refid="refid" width="pixels"	height="pixels"/>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       width  Optional.	The result will	have this width.

       height Optional.	The result will	have this height.

       refid  Optional.	An image ID defined with the "id"  parameter  for  any
	      previously  created  image.  If  set, percentages	in "width" and
	      "height" will be derived from the	width and height of the	 refid
	      image.

       color  Optional.	 Default  is "#ffffffff". An image will	be created and
	      filled with this color.

       width  Required.	The image will have this width.

       height Required.	The image will have this height.

       opacity
	      Optional.	Default	is 100.	Values from 0  to  100	represent  the
	      opacity of resulting image with 100 being	completely opaque. Ef-
	      fectively	 overrides  alpha  component  of  the  color  setting.
	      libAfterImage/asimagexml/save

NAMEsave
       -  write	 generated/loaded  image into the file of one of the supported
       types

SYNOPSIS
       <save id="new_id" dst="filename"	format="format"	compress="value"
	     opacity="value" replace="0|1" delay="mlsecs">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       dst    Optional.	Name of	file image will	be saved to. If	omitted	 image
	      will be dumped into stdout - useful for CGI apps.

       format Optional.	 Output	 format	of saved image.	Defaults to the	exten-
	      sion of the "dst"	parameter. Valid values	are  the  standard  AS
	      image file formats: xpm, jpg, png, gif, tiff.

       compress
	      Optional.	 Compression level if supported	by output file format.
	      Valid values are in range	of 0  -	 100  and  any	of  "deflate",
	      "jpeg",  "ojpeg",	 "packbits" for	TIFF files. Note that JPEG and
	      GIF will produce images with deteriorated	quality	when  compress
	      is  greater then 0. For JPEG default is 25, for PNG default is 6
	      and for GIF it is	0.

       opacity
	      Optional.	Level below which pixel	is considered to be  transpar-
	      ent, while saving	image as XPM or	GIF. Valid values are in range
	      0-255. Default is	127.

       replace
	      Optional.	Causes ascompose to delete file	if the file  with  the
	      same name	already	exists.	Valid values are 0 and 1. Default is 1
	      -	files are deleted before being saved. Disable this to get mul-
	      timage animated gifs.

       delay  Optional.	Delay to be stored in GIF image. This could be used to
	      create animated gifs. Note that you have to set replace="0"  and
	      then write several images	into the GIF file with the same	name.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEbackground
       - set image's background	color.

SYNOPSIS
	<background id="new_id"	color="color">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       color  Required.	Color to be used for background	- fills	all the	spaces
	      in image with missing pixels.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEblur
       - perform a gaussian blurr on an	image.

SYNOPSIS
       <blur id="new_id" horz="radius" vert="radius" channels="argb">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       horz   Optional.	Horizontal radius of the blur in pixels.

       vert   Optional.	Vertical radius	of the blur in pixels.

       channels
	      Optional.	Applys blur only on listed color channels: a -	alpha,
	      r	- red, g - green, b - blue

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEbevel
       - draws solid bevel frame around	the image.

SYNOPSIS
       <bevel id="new_id" colors="color1 color2"
		 width="pixels"	height="pixels"	refid="refid"
	      border="left top right bottom" solid=0|1 outline=0|1>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       colors Optional.	Whitespace-separated list of colors. Exactly two  col-
	      ors  are	required.  Default is "#ffdddddd #ff555555". The first
	      color is the color of the	upper and left edges, and  the	second
	      is the color of the lower	and right edges.

       borders
	      Optional.	 Whitespace-separated  list of integer values. Default
	      is "10 10	10 10".	The values represent the  offsets  toward  the
	      center of	the image of each border: left,	top, right, bottom.

       solid  Optional	-  default is 1. If set	to 0 will draw bevel gradually
	      fading into the image.

       outline
	      Optional - default is 0. If set to 1 will	draw bevel around  the
	      image vs.	inside the image.

       width  Optional.	The result will	have this width.

       height Optional.	The result will	have this height.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEmirror
       - create	new image as mirror copy of an old one.

SYNOPSIS
	<mirror	id="new_id" dir="direction"
		   width="pixels" height="pixels" refid="refid">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       dir    Required.	 Possible  values are "vertical" and "horizontal". The
	      image will be flipped over the x-axis if dir  is	vertical,  and
	      flipped over the y-axis if dir is	horizontal.

       width  Optional.	The result will	have this width.

       height Optional.	The result will	have this height.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMErotate
       - rotate	an image in 90 degree increments (flip).

SYNOPSIS
	<rotate	id="new_id" angle="degrees"
		   width="pixels"  height="pixels" refid="refid"> * ATTRIBUTES
       id	Optional. Image	will be	given this name	for future  reference.
       angle	Required.  Given in degrees.  Possible values are currently
		"90", "180", and "270".	 Rotates the image through the given
		angle.	 width	   Optional.  The result will have this	width.
       height	Optional.  The result will have	 this  height.	 refid	   Op-
       tional.	An image ID defined with the "id" parameter for
		any previously created image.  If set, percentages in "width"
		and "height" will be derived from the width and	height of the
		refid image.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEscale
       - scale image to	arbitrary size

SYNOPSIS
       <scale id="new_id" refid="other_imag" src_x="pixels"  src_y="pixels"
	      src_width="pixels" src_height="pixels"
	      width="pixels" height="pixels">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	An image ID defined with the "id"  parameter  for  any
	      previously  created  image.  If  set, percentages	in "width" and
	      "height" will be derived from the	width and height of the	 refid
	      image.

       width  Required.	The image will be scaled to this width.

       height Required.	The image will be scaled to this height.

       src_x  Optional.	 Default is 0. X Offset	on infinite surface tiled with
	      this image, from which to	cut portion of an image	to be used  in
	      scaling.

       src_y  Optional.	 Default is 0. Y Offset	on infinite surface tiled with
	      this image, from which to	cut portion of an image	to be used  in
	      scaling.

       src_width
	      Optional.	Default	is image width.	Tile image to this width prior
	      to scaling.

       src_height
	      Optional.	Default	is image height. Tile  image  to  this	height
	      prior to scaling.

       *      NOTES

       This   tag applies to the first image contained within the tag. Any

       further
	      images will be discarded.

       If     you  want	to keep	image proportions while	scaling	- use "propor-
	      tional"

       instead
	      of specific size for particular dimention.   libAfterImage/asim-
	      agexml/slice

NAMEslice
       - slice image to	arbitrary size leaving corners unchanged

SYNOPSIS
       <slice id="new_id" ref_id="other_imag" width="pixels" height="pixels"
	      x_start="slice_x_start" x_end="slice_x_end"
		 y_start="slice_y_start" y_end="slice_y_end"
		 scale="0|1">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       width  Required.	The image will be scaled to this width.

       height Required.	The image will be scaled to this height.

       x_start
	      Optional.	Position at which vertical image slicing begins.  Cor-
	      responds to the right side of the	left corners.

       x_end  Optional.	 Position  at which vertical image slicing end.	Corre-
	      sponds to	the left side of the right corners.

       y_start
	      Optional.	Position at which  horisontal  image  slicing  begins.
	      Corresponds to the bottom	side of	the top	corners.

       y_end  Optional.	Position at which horisontal image slicing end.	Corre-
	      sponds to	the top	side of	the bottom corners.

       scale  Optional.	If set to 1 will cause middle portion of the image  to
	      be scaled	instead	of tiled.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.  Contents	of the image  between  x_start
       and  x_end  will	 be  tiled horizontally. Contents of the image between
       y_start and y_end will be tiled vertically. This	is useful to get back-
       ground images to	fit the	size of	the text or a widget, while preserving
       its borders undistorted,	which is the usuall result of simple  scaling.
       If you want to keep image proportions while resizing-use	"proportional"
       instead of specific size	for particular dimention.

NAMEpixelize
       - pixelize image	using arbitrary	pixel size

SYNOPSIS
       <pixelize id="new_id" ref_id="other_imag"  width="pixels"  height="pix-
       els"
	      clip_x="clip_x" clip_y="clip_y"
	      pixel_width="pixel_width"	pixel_height="pixel_height">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       width  Required.	The image will be scaled to this width.

       height Required.	The image will be scaled to this height.

       clip_x Optional.	Offset into original image.

       clip_y Optional.	Offset into original image.

       pixel_width
	      Required.	Horizontal pixelization	step;

       pixel_height
	      Required.	Vertical pixelization step;

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther  images  will be discarded.	 If you	want to	keep image proportions
       while resizing-use "proportional" instead of specific size for particu-
       lar dimention.

NAMEcrop
       - crop image to arbitrary area within it.

SYNOPSIS
	<crop id="new_id" refid="other_image" srcx="pixels" srcy="pixels"
	      width="pixels" height="pixels" tint="color">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       srcx   Optional.	Default	is "0".	Skip this many pixels from the left.

       srcy   Optional.	Default	is "0".	Skip this many pixels from the top.

       width  Optional.	Default	is "100%". Keep	this many pixels wide.

       height Optional.	Default	is "100%". Keep	this many pixels tall.

       tint   Optional.	Additionally tint an image to specified	color. Tinting
	      can  both	 lighten  and  darken  an  image.  Tinting  color 0 or
	      #7f7f7f7f	yeilds no tinting. Tinting can	be  performed  on  any
	      channel, including alpha channel.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEtile
       - tile an image to specified area.

SYNOPSIS
	<tile id="new_id" refid="other_image" width="pixels" height="pixels"
	      x_origin="pixels"	y_origin="pixels" tint="color" complement=0|1>

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	An image ID defined with the "id"  parameter  for  any
	      previously  created  image.  If  set, percentages	in "width" and
	      "height" will be derived from the	width and height of the	 refid
	      image.

       width  Optional.	 Default  is  "100%".  The image will be tiled to this
	      width.

       height Optional.	Default	is "100%". The image will  be  tiled  to  this
	      height.

       x_origin
	      Optional.	 Horizontal position on	infinite surface, covered with
	      tiles of the image, from which to	cut out	resulting image.

       y_origin
	      Optional.	Vertical position on infinite  surface,	 covered  with
	      tiles of the image, from which to	cut out	resulting image.

       tint   Optional.	Additionally tint an image to specified	color. Tinting
	      can both lighten	and  darken  an	 image.	 Tinting  color	 0  or
	      #7f7f7f7f	 yields	 no  tinting.  Tinting can be performed	on any
	      channel, including alpha channel.

       complement
	      Optional.	Will use color that is the complement  to  tint	 color
	      for the tinting, if set to 1. Default is 0.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEhsv
       - adjust	Hue, Saturation	and/or Value of	an image and  optionally  tile
       an image	to arbitrary area.

SYNOPSIS
       <hsv id="new_id"	refid="other_image"
	    x_origin="pixels" y_origin="pixels"	width="pixels" height="pixels"
	    affected_hue="degrees|color" affected_radius="degrees"
	    hue_offset="degrees" saturation_offset="value"
	    value_offset="value">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       width  Optional.	Default	is "100%". The image will  be  tiled  to  this
	      width.

       height Optional.	 Default  is  "100%".  The image will be tiled to this
	      height.

       x_origin
	      Optional.	Horizontal position on infinite	surface, covered  with
	      tiles of the image, from which to	cut out	resulting image.

       y_origin
	      Optional.	 Vertical  position  on	infinite surface, covered with
	      tiles of the image, from which to	cut out	resulting image.

       affected_hue
	      Optional.	Limits effects to the renage of	hues around this  hue.
	      If  numeric value	is specified - it is treated as	degrees	on 360
	      degree circle, with : red	= 0, yellow = 60, green	= 120, cyan  =
	      180,  blue  = 240, magenta = 300.	If colorname or	value preceded
	      with # is	specified here - it will be treated as RGB  color  and
	      converted	into hue automagically.

       affected_radius
	      Optional.	 Value in degrees to be	used in	order to calculate the
	      range of affected	hues. Range is determined by substracting  and
	      adding this value	from/to	affected_hue.

       hue_offset
	      Optional.	Value by which to adjust the hue.

       saturation_offset
	      Optional.	Value by which to adjust the saturation.

       value_offset
	      Optional.	Value by which to adjust the value.

NOTES
       One  of	the  Offsets  must be not 0, in	order for operation to be per-
       formed.

       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

NAMEpad
       - pad an	image with solid color rectangles.

SYNOPSIS
       <pad id="new_id"	left="pixels" top="pixels"
	    right="pixels" bottom="pixels" color="color"
	       refid="refid" width="pixels" height="pixels">

ATTRIBUTES
       id     Optional.	Image will be given this name for future reference.

       width  Optional.	The result will	have this width.

       height Optional.	The result will	have this height.

       refid  Optional.	 An  image  ID defined with the	"id" parameter for any
	      previously created image.	If set,	 percentages  in  "width"  and
	      "height"	will be	derived	from the width and height of the refid
	      image.

       left   Optional.	Size to	add to the left	of the image.

       top    Optional.	Size to	add to the top of the image.

       right  Optional.	Size to	add to the right of the	image.

       bottom Optional.	Size to	add to the bottom of the image.

       color  Optional.	Color value to fill added  areas  with.	 It  could  be
	      transparent of course. Default is	#FF000000 - totally black.

NOTES
       This tag	applies	to the first image contained within the	tag.  Any fur-
       ther images will	be discarded.

3rd Berkeley Distribution     AfterStep	v.2.2.12		 asimagexml(1)

NAME | NAMEascompose | DESCRIPTION | TAGS | NAMEtext | SYNOPSIS | ATTRIBUTES | NOTES | NAMEcomposite | SYNOPSIS | ATTRIBUTES | NOTES | ATTRIBUTES | SEE ALSO | NAMEimg | SYNOPSIS | ATTRIBUTES | NOTES | NAMErecall | SYNOPSIS | ATTRIBUTES | NAMErelease | SYNOPSIS | ATTRIBUTES | NAMEcolor | SYNOPSIS | ATTRIBUTES | NOTES | NAMEcolor2alpha | SYNOPSIS | ATTRIBUTES | NOTES | NAMEprintf | SYNOPSIS | ATTRIBUTES | NOTESlibAfterImage/asimagexml/set | NAMEset | SYNOPSIS | ATTRIBUTES | NAMEif | SYNOPSIS | ATTRIBUTES | EXAMPLE | NAMEgradient | SYNOPSIS | ATTRIBUTES | NAMEsolid | SYNOPSIS | ATTRIBUTES | NAMEsave | SYNOPSIS | ATTRIBUTES | NOTES | NAMEbackground | SYNOPSIS | ATTRIBUTES | NOTES | NAMEblur | SYNOPSIS | ATTRIBUTES | NOTES | NAMEbevel | SYNOPSIS | ATTRIBUTES | NOTES | NAMEmirror | SYNOPSIS | ATTRIBUTES | NOTES | NAMErotate | SYNOPSIS | NOTES | NAMEscale | SYNOPSIS | ATTRIBUTES | NAMEslice | SYNOPSIS | ATTRIBUTES | NOTES | NAMEpixelize | SYNOPSIS | ATTRIBUTES | NOTES | NAMEcrop | SYNOPSIS | ATTRIBUTES | NOTES | NAMEtile | SYNOPSIS | ATTRIBUTES | NOTES | NAMEhsv | SYNOPSIS | ATTRIBUTES | NOTES | NAMEpad | SYNOPSIS | ATTRIBUTES | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=asimagexml&sektion=1x&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help