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
displayed 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.
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 unchanged.
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 -
existing 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,
subtract, multiply, divide), unary minus, and parentheses are
supported.
Operator precedence is NOT supported. Percentages are allowed, and
apply to either width or height of the appropriate image (usually
the refid image).
Also, variables of the form $image.width and $image.height are
supported. $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
desktop size: <scale width="$xroot.width" height="$xroot.height">.
Each tag is only allowed to return ONE image.
libAfterImage/asimagexml/text
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" 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
represeend different 3d type.
NOTES¶
<text> without bgcolor, fgcolor, fgimage, or bgimage will NOT
produce visible output by itself. See EXAMPLES below.
libAfterImage/asimagexml/composite
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.
SEE ALSO¶
libAfterImage
libAfterImage/asimagexml/img
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.
libAfterImage/asimagexml/recall
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 define
7 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
libAfterImage/asimagexml/color2alpha
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
further images will be discarded.
If you want to keep image proportions while resizing-use "proportional"
instead of specific size for particular dimention.
libAfterImage/asimagexml/printf
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>
libAfterImage/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 - useful for CGI apps.
- format
- Optional. Output 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. Any
further images will be discarded.
libAfterImage/asimagexml/background
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
further images will be discarded.
libAfterImage/asimagexml/blur
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
further images will be discarded.
libAfterImage/asimagexml/bevel
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. Any
further images will be discarded.
libAfterImage/asimagexml/mirror
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
further images will be discarded.
libAfterImage/asimagexml/rotate
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 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
further images will be discarded.
libAfterImage/asimagexml/scale
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
"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. Any
further 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 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.
libAfterImage/asimagexml/pixelize
NAMEpixelize¶
- pixelize image using arbitrary pixel size
SYNOPSIS¶
<pixelize id="new_id" ref_id="other_imag" width="pixels" height="pixels"
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
further images will be discarded.
If you want to keep image proportions while resizing-use "proportional"
instead of specific size for particular dimention.
libAfterImage/asimagexml/crop
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
further images will be discarded.
libAfterImage/asimagexml/tile
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
further images will be discarded.
libAfterImage/asimagexml/hsv
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
performed.
This tag applies to the first image contained within the tag. Any
further images will be discarded.
libAfterImage/asimagexml/pad
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
further images will be discarded.