asimage - internal structures and methods used for image manipulation in libAfterImage

       Sasha Vasko <sasha at aftercode dot net>
       libAfterImage/ASAltImFormats

       This function will translate contents of selected channel (usually alpha)  into  a  list  of  rectangles,
       ecompasing  regions with values above the threshold. This is useful to generate shape of the window to be
       used with X Shape extension.

3rd Berkeley Distribution                      AfterStep v.2.2.12                                    asimage(3x)

       asview.c: ASView.5
       libAfterImage/asimage/asimage_replace()

       This are flags that define what should be printed by asimage_print_line():
           VRB_LINE_SUMMARY    - print only summary for each scanline
           VRB_LINE_CONTENT    - print summary and data for each scanline
           VRB_CTRL_EXPLAIN    - print summary, data and control codes for each
                                 scanline

       src    - ASImage which will donate its channel to dst;

       channel
              - what source image channel to copy data from;

       threshold
              - threshold to compare channel values against;

       rects_count_ret
              - returns count of generated rectangles.

asimage -   internal   structures   and   methods   used   for   image   manipulation   in  libAfterImage
       libAfterImage/asimage.h

       identifies  what output format should be used for storing the transformation result. Also identifies what
       data is currently stored in alt member of ASImage structure.

       describes how gradient is to be drawn.

       defined  as  0 - disables compression.  ASIM_COMPRESSION_FULL defined as 100 - highest compression level.
       Anything in between 0 and 100 will cause only part of the scanline to be compressed.  This  is  obsolete.
       Now all images are compressed if possible.  libAfterImage/asimage/asimage_init()

       is the main structure to hold image data.

       frees datamembers of the supplied ASImage structure, and initializes it to all 0.

       will replace ASImage's data using data from another ASImage

       Allocates memory needed to store scanline of the image of supplied size. Assigns  all  the  data  members
       valid values. Makes sure that ASImage structure is ready to store image data.

       specifies parameters of the image superimposition.

       structure to be used to maintain list of loaded images for given set of search paths  and  gamma.  Images
       are named and reference counted.

       contains palette allowing us to map double values in vector image data into actuall ARGB values.

       Performs  memory  allocation  for  the  new  ASImage  structure,  as  well as initialization of allocated
       structure based on supplied parameters.

       - allocate and initialize set of ASImageLayer's.

       create ASImage management and reference counting object.

       -      destroy      ASGradient      structure,       deallocating       all       associated       memory
       libAfterImage/asimage/init_image_layers()

       frees all the memory allocated for specified ASImage.

       - destroy set of ASImageLayer structures.

       destroy management obejct.

       increment reference count of stored ASImage.

       query_asimage()

       - rotates gradient in 90 degree increments.

       defines  rotation  of  90  degrees  counterclockwise.   FLIP_UPSIDEDOWN  defines  rotation of 180 degrees
       counterclockwise. combined they define rotation of 270 degrees counterclockwise.

       destroys XImage and mask XImage kept from previous conversions to/from X Pixmap.

       remove  ASImage  from  ASImageManager's  hash  by  pointer.   forget_asimage_name()  remove  ASImage from
       ASImageManager's hash by its name.

       - translate image into a list of rectangles.

       normal  left-to-right  gradient.   GRADIENT_TopLeft2BottomRight  diagonal   top-left   to   bottom-right.
       GRADIENT_Top2Bottom  vertical  top to bottom gradient.  GRADIENT_BottomLeft2TopRight diagonal bottom-left
       to top-right.

       when  set  it  will cause gradient's direction to be rotated by 45 degrees GRADIENT_TYPE_ORIENTATION will
       cause gradient direction to be rotated by 90 degrees. When combined  with  GRADIENT_TYPE_DIAG  -  rotates
       gradient direction by 135 degrees.

       - initialize set of ASImageLayer structures.

       effectively  limits  size  of  the  allowed  images to be loaded from files. That is needed to be able to
       filter out corrupt files.  MAX_BEVEL_OUTLINE Limit on  bevel  outline  to  be  drawn  around  the  image.
       MAX_SEARCH_PATHS Number of search paths to be used while loading images from files.

           #define  MAX_IMPORT_IMAGE_SIZE    8000  #define  MAX_BEVEL_OUTLINE       100 #define MAX_SEARCH_PATHS
           8      /* prudently limiting ourselfs */

       libAfterImage/ASVectorPalette

       prints      list      of      images      referenced      in      given     ASImageManager     structure.
       libAfterImage/asimage/destroy_asgradient()

       decrement reference count for given ASImage.  release_asimage_by_name()  decrement  reference  count  for
       ASImage identifyed by its name.

       relocate ASImage into a different image manager.

       either release or destroy asimage, checking if it is attached to ASImageManager.

       This function replaces contents of the vector member of ASImage structure with new double precision data.

       add ASImage to the reference.

       special value that disables tinting TINT_LEAVE_SAME also disables tinting.

       This function replaces contents of the vector member of ASImage structure with new double precision data,
       generated  from  native  ARGB32 image contents. Color palette is generated by indexing color values using
       max_colors, dither and opaque_threshold parameters.

       Source  image (donor) will loose its channel data, as it will be moved to destination ASImage. Also there
       is a condition that both images must be of the same width -  otherwise  function  returns  without  doing
       anything. If height is different - the minimum of two will be used.
       libAfterImage/asimage/copy_asimage_channel()

       amount of memory used by this particular channel of specified scanline.

       make_gradient()

           #define  VRB_LINE_SUMMARY    (0x01<<0) #define VRB_LINE_CONTENT    (0x01<<1) #define VRB_CTRL_EXPLAIN
           (0x01<<2) #define VRB_EVERYTHING      (VRB_LINE_SUMMARY|VRB_CTRL_EXPLAIN| \
                                        VRB_LINE_CONTENT)

       libAfterImage/asimage/asimage_print_line()

       XRectangle*
           get_asimage_channel_rects( ASImage *src, int channel,
                                      unsigned int threshold,
                                      unsigned int *rects_count_ret );