GIMP Script-fu

    (Vectors::stroke-new-from-points path 
                                     VECTORS-STROKE-TYPE-BEZIER  
                                     '(34 5 40 10 42 15 54 15 41 20 68 24)
                                     1)
      ==> stroke-id
      
Note that this transformation of counted arrays only applies to GIMP internal
procedures; plug-ins with counted array parameters (such as 'plug-in-film') need to be handled in the traditional manner. Fortunately, there are very few instances where this is a concern.

NAMESPACES

By now you've probably realized that Schemey-fu functions follow the naming convention of "Namespace::function", which consistly maps to the corresponding PDB procedure's name.

Within the PDB, procedures are divided up into different namespaces with the namespace supplied as a prefix in the procedure name. The main top-level namespaces are 'gimp', 'file', 'script-fu', and 'plug-in'. Schemey-fu is mostly limited to the procedures within the 'gimp' namespace. The 'gimp' namespace itself generally follows the naming convention of gimp-object-action, where the object might be an image, a layer, a tool, or somesuch.

................................................................................
        Reverse the order of the characters in a string.
    Fu::string-trim (str [pred])
        Per SRFI-13 without optional start/end.
        Skip over initial characters matching the 'pred'. 
        'pred' can be either a procedure or a char; if 
        not supplied, pred defaults to #\space.
    Fu::string-pad (str n [char])
       Per SRFI-13 without start/end (also does not truncate str).
       Prepends enough 'char's to string to fill field of size 'n'
       If not supplied, 'char' is #\space.
    Fu::string-delete (pred str)
        Per SRFI-13 without optional start/end.
        Remove all chars from a string that match 'pred'
        'pred' can be either a procedure or a char.

    Fu::progression (start end [num-elements [growth]])
        Return a list of N elements from start to end with either
................................................................................
        Merge sort a list based on compare? Optimal for longer lists (> 50 items)
        Example:
          (Fu::msort < '(30 20 50 40 10)) ==> (10 20 30 40 50)
          
    Fu::get-bounds (drawables)
        Accepts either the ID of a single drawable or a list of drawable IDs. 
        If a list then the bounds of all drawables in the list is returned.
    






    Fu::calc-fontsize (text font width height)
        Calculate the largest size of the given font that will fit within 
        the given dimensions.

USEFUL MACROS
   
   Schemey-fu also provides some useful macros. These do not follow the 

    (Vectors::stroke-new-from-points path 
                                     VECTORS-STROKE-TYPE-BEZIER  
                                     '(34 5 40 10 42 15 54 15 41 20 68 24)
                                     1)
      ==> stroke-id
      

Note that this transformation of counted arrays only applies to GIMP internal procedures; plug-ins with counted array parameters (such as 'plug-in-film') need to be handled in the traditional manner. Fortunately, there are very few instances where this is a concern.

NAMESPACES

By now you've probably realized that Schemey-fu functions follow the naming convention of "Namespace::function", which consistly maps to the corresponding PDB procedure's name.

Within the PDB, procedures are divided up into different namespaces with the namespace supplied as a prefix in the procedure name. The main top-level namespaces are 'gimp', 'file', 'script-fu', and 'plug-in'. Schemey-fu is mostly limited to the procedures within the 'gimp' namespace. The 'gimp' namespace itself generally follows the naming convention of gimp-object-action, where the object might be an image, a layer, a tool, or somesuch.

................................................................................
        Reverse the order of the characters in a string.
    Fu::string-trim (str [pred])
        Per SRFI-13 without optional start/end.
        Skip over initial characters matching the 'pred'. 
        'pred' can be either a procedure or a char; if 
        not supplied, pred defaults to #\space.
    Fu::string-pad (str n [char])
        Per SRFI-13 without start/end (also does not truncate str).
        Prepends enough 'char's to string to fill field of size 'n'
        If not supplied, 'char' is #\space.
    Fu::string-delete (pred str)
        Per SRFI-13 without optional start/end.
        Remove all chars from a string that match 'pred'
        'pred' can be either a procedure or a char.

    Fu::progression (start end [num-elements [growth]])
        Return a list of N elements from start to end with either
................................................................................
        Merge sort a list based on compare? Optimal for longer lists (> 50 items)
        Example:
          (Fu::msort < '(30 20 50 40 10)) ==> (10 20 30 40 50)
          
    Fu::get-bounds (drawables)
        Accepts either the ID of a single drawable or a list of drawable IDs. 
        If a list then the bounds of all drawables in the list is returned.

    Fu::grow-while (pred? . args)
        Returns the largest integer that satisfies the 'pred?' function.
        The 'pred?' function should accept a single "size" argument
        and return #t if the size fits the criteria. (Se Fu::calc-fontsize
        for an example of usage.)

    Fu::calc-fontsize (text font width height)
        Calculate the largest size of the given font that will fit within 
        the given dimensions.

USEFUL MACROS
   
   Schemey-fu also provides some useful macros. These do not follow the