MAN page from Other AfterStep-2.2.2-20060804.i386.rpm

asimagexml

Section: AfterStep X11 window manager (1)
Updated: AfterStep v.2.2.2
Index

NAME

asimagexml - XML schema to be used for scripting image manipulation by AfterStep and ascomposelibAfterImage/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, performsuperimposition of arbitrary number of images, and save images intofiles 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 operationcould 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 optionis specified. If -r option is specified, then this image will bedisplayed in root window of X display, effectively setting a backgroundfor a desktop. If -o option is specified, this image will also besaved into the file or requested type.

NAMEtext

- render text string into new image, using specific font, size and texture.

SYNOPSIS

<text id="new_id" font="font" point="size" fgcolor="color"      bgcolor="color" fgimage="image_id" bgimage="image_id"      spacing="points">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 represeend different 3d type.

NOTES

<text> without bgcolor, fgcolor, fgimage, or bgimage will NOTproduce 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, overlay, saturate, screen, sub, tint, value.
merge: Optional. Default is "expand". Valid values are "clip" and "expand". 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.

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 imageof the root X window, if any.  No attempt will be made to offset thisimage 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">

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 define7 other variables :     domain.sym_name.red, domain.sym_name.green,                         domain.sym_name.blue, domain.sym_name.alpha,                         domain.sym_name.hue, domain.sym_name.saturation,                        domain.sym_name.value

NAMEprintf

- prints variable value to standard output.

SYNOPSIS

<printf format="format_string" var="variable_name" val="value"/>

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/gradient

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 colors 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. Effectively 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 - usefull for CGI apps.
format: Optional. Ouput format of saved image. Defaults to the extension 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 transparent, 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 multimage 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.  Anyfurther 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.  Anyfurther 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.  Anyfurther 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 colors 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.  Anyfurther 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.  Anyfurther 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">* ATTRIBUTESid       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    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.  Anyfurther images will be discarded.

NAMEscale

- scale image to arbitrary size

SYNOPSIS

<scale id="new_id" ref_id="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 "proportional"
instead: of specific size for particular dimention.libAfterImage/asimagexml/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. Corresponds to the right side of the left corners.
x_end: Optional. Position at which vertical image slicing end. Corresponds 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. Corresponds 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.  Anyfurther 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 usefull to get background 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.

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.  Anyfurther 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.  Anyfurther 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 beperformed.This tag applies to the first image contained within the tag.  Anyfurther 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.  Anyfurther images will be discarded.

Index

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
NAMEprintf
SYNOPSIS
ATTRIBUTES
NOTESlibAfterImage/asimagexml/gradient
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
NAMEcrop
SYNOPSIS
ATTRIBUTES
NOTES
NAMEtile
SYNOPSIS
ATTRIBUTES
NOTES
NAMEhsv
SYNOPSIS
ATTRIBUTES
NOTES
NAMEpad
SYNOPSIS
ATTRIBUTES
NOTES

This document was created byman2html,using the manual pages.

asimagexml

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

NAMEprintf

SYNOPSIS

ATTRIBUTES

NOTESlibAfterImage/asimagexml/gradient

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

NAMEcrop

SYNOPSIS

ATTRIBUTES

NOTES

NAMEtile

SYNOPSIS

ATTRIBUTES

NOTES

NAMEhsv

SYNOPSIS

ATTRIBUTES