Return to postmd.h CVS log

Up to [Research Unix] / researchv10no / cmd / postscript / postmd

Annotation of researchv10no/cmd/postscript/postmd/postmd.h, revision 1.1

1.1     ! root        1: /*
        !             2:  *
        !             3:  * An interval list used to map matrix elements into integers in the range 0 to
        !             4:  * 254 representing shades of gray on a PostScript printer. The list can be given
        !             5:  * using the -i option or can be set in the optional header that can preceed each
        !             6:  * matrix. The list should be a comma or space separated list that looks like,
        !             7:  *
        !             8:  *             num1,num2, ... ,numn
        !             9:  *
        !            10:  * where each num is a floating point number. The list must be given in increasing
        !            11:  * numerical order. The n numbers in the list partion the real line into 2n+1
        !            12:  * regions given by,
        !            13:  *
        !            14:  *             region1         element < num1
        !            15:  *             region2         element = num1
        !            16:  *             region3         element < num2
        !            17:  *             region4         element = num3
        !            18:  *                .                 .
        !            19:  *                .                 .
        !            20:  *                .                 .
        !            21:  *             region2n        element = numn
        !            22:  *             region2n+1      element > numn
        !            23:  *
        !            24:  * Every number in a given region is mapped into an integer in the range 0 to 254
        !            25:  * and that number, when displayed on a PostScript printer using the image operator,
        !            26:  * prints as a square filled with a gray scale that reflects the integer that was
        !            27:  * chosen. 0 maps to black and 255 white (that's why 255 is normally omitted).
        !            28:  *
        !            29:  * The shades of gray chosen by the program are normally generated automatically,
        !            30:  * but can be reassigned using the -g option or by including a grayscale line in
        !            31:  * the optional header. The grayscale list is comma or space separated list of
        !            32:  * integers between 0 and 255 that's used to map individual regions into arbitray
        !            33:  * shade of gray, thus overriding the default choice made in the program. The list
        !            34:  * should look like,
        !            35:  *
        !            36:  *             color1,color2, ... ,color2n+1
        !            37:  *
        !            38:  * where color1 applies to region1 and color2n+1 applies to region2n+1. If less
        !            39:  * than 2n+1 numbers are given the default assignments will be used for the missing
        !            40:  * regions. Each color must be an integer in the range 0 to 255.
        !            41:  *
        !            42:  * The default interval list is given below. The default grayscale maps 254 (almost
        !            43:  * white) into the first region and 0 (black) into the last.
        !            44:  *
        !            45:  */
        !            46: 
        !            47: #define DFLTILIST      "-1,0,1"
        !            48: 
        !            49: /*
        !            50:  *
        !            51:  * The active interval list is built from an interval string and stored in an array
        !            52:  * whose elements are of type Ilist.
        !            53:  *
        !            54:  */
        !            55: 
        !            56: typedef struct  {
        !            57:        double  val;                    /* only valid in kind is ENDPOINT */
        !            58:        int     color;                  /* gray scale color */
        !            59:        long    count;                  /* statistics for each region */
        !            60: } Ilist;
        !            61: 
        !            62: /*
        !            63:  *
        !            64:  * Non-integer function declarations.
        !            65:  *
        !            66:  */
        !            67: 
        !            68: char   *savestring();
        !            69: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.