HomeHomeHomeHomeHome
 
Home
News
Downloads
Documentation
Looks and Themes
Icons, Clipart, etc.
Mailing List and Contacts
aterm terminal emulator
 
title_image
 Preface  Introduction  Topic index  Glossary  F.A.Q.  Copyright

AfterImage XMLXML schema to be used for scripting image manipulation by AfterStep and ascompose



    libAfterImage/asimagexml
  • NAME
    ascompose

    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.
    
    
  • 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 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
    • NAME
      text

      - 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 NOT
      produce visible output by itself.  See EXAMPLES below.
      
      libAfterImage/asimagexml/composite
    • NAME
      composite

      - 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
    • NAME
      img

      - 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
    • NAME
      recall

      -  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
    • NAME
      release

      - 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
    • NAME
      color

      - 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/printf
    • NAME
      printf

      - 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.
    • NOTES
      libAfterImage/asimagexml/set
    • NAME
      set

      - 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
    • NAME
      if

      - 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
    • NAME
      gradient

      - 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
    • NAME
      solid

      - 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
    • NAME
      save

      - 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.  Any
      further images will be discarded.
      
      libAfterImage/asimagexml/background
    • NAME
      background

      -  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
    • NAME
      blur

      - 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
    • NAME
      bevel

      - 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
    • NAME
      mirror

      - 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
    • NAME
      rotate

      -  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
    • NAME
      scale

      -  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
    • NAME
      slice

      -  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 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.
      
      libAfterImage/asimagexml/crop
    • NAME
      crop

      -  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
    • NAME
      tile

      -  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
    • NAME
      hsv

      - 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
    • NAME
      pad

      -  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.
      


AfterStep Documentation   -   October 2005     ( 80% complete )

lowbarimage