Return to picfile.5 CVS log

Up to [Research Unix] / researchv10dc / man / man5

Annotation of researchv10dc/man/man5/picfile.5, revision 1.1.1.1

1.1       root        1: .TH PICFILE 5
                      2: .CT 1 inst_info graphics
                      3: .SH NAME
                      4: picfile \- raster graphic image format
                      5: .SH DESCRIPTION
                      6: Files in this format store images represented as two-dimensional
                      7: arrays of multiple-channel pixels.
                      8: A
                      9: .I picfile
                     10: consists of an
                     11: .SM ASCII
                     12: header followed by binary data encoding the pixels
                     13: in row-major order.
                     14: The header is a list of attribute/value pairs
                     15: separated by newlines, terminated by an
                     16: empty line.
                     17: Each header line has the form
                     18: .IB name = value.
                     19: The name may not contain an 
                     20: .SM ASCII NUL,
                     21: newline or
                     22: .LR = ;
                     23: the value may not contain null or newline.
                     24: The last line of a header is empty.
                     25: .PP
                     26: The standard attributes are described below; all but
                     27: .BR TYPE
                     28: and
                     29: .BR WINDOW
                     30: are optional.
                     31: .B TYPE
                     32: must come first; otherwise order is irrelevant.
                     33: As any unrecognised attribute is passed over uninterpreted by all standard software,
                     34: applications are welcome to include arbitrary annotations, like
                     35: .BR SHOESIZE=10 ,
                     36: if they wish.
                     37: .TP
                     38: .BI TYPE= type
                     39: How the pixels are encoded.
                     40: Standard types are
                     41: .PD 0
                     42: .RS
                     43: .TF runcode
                     44: .TP
                     45: .B runcode
                     46: A run-length encoding.
                     47: The data are a sequence of
                     48: .RI ( nchan +1)-byte
                     49: records each containing a count
                     50: .I k
                     51: and
                     52: .I nchan
                     53: bytes giving a pixel value to be repeated
                     54: .IR k +1
                     55: times.
                     56: A run may not span scanlines.
                     57: .TP
                     58: .B dump
                     59: A two-dimensional array of
                     60: .IR nchan -byte
                     61: records in row major order.
                     62: .TP
                     63: .B bitmap
                     64: One-bit pixels, packed into bytes high bit leftmost.
                     65: Zero bits are white, one bits are black.
                     66: Rows are padded with zeros to a multiple of 16 bits.
                     67: .TP
                     68: .B ccitt-g4
                     69: A black-and-white image under CCITT FAX Group 4 compression.
                     70: This format is highly compressive on images of text and line art.
                     71: Similarly,
                     72: .L ccitt-g31
                     73: and
                     74: .L ccitt-g32
                     75: for Group 3, 1-D and 2-D.
                     76: .TP
                     77: .B pico
                     78: A sequence of
                     79: .I nchan
                     80: two-dimensional arrays of single bytes.
                     81: .TP
                     82: .B ccir601
                     83: Pixels are in dump order, 2 bytes per pixel
                     84: encoded according to the IEEE digital component video standard.
                     85: .RE
                     86: .TP
                     87: .BI WINDOW= "x0 y0 x1 y1
                     88: The 
                     89: .I x,y
                     90: coordinates of the upper left corner and
                     91: the point just diagonally outside the lower right corner,
                     92: .I x
                     93: increasing to the right,
                     94: .I y
                     95: down.
                     96: .TP
                     97: .BI NCHAN= nchan
                     98: The number of channels, default 1.
                     99: .TP
                    100: .BI CHAN= value
                    101: The order of channels. 
                    102: .TP
                    103: .BI RES= "x y
                    104: The digitizing resolution horizontally and vertically, in pixels/inch.
                    105: .PD
                    106: .TP
                    107: .B CMAP=
                    108: (The value is empty.)
                    109: A color map, a 256\(mu3-byte translation table for
                    110: color values, follows the header.
                    111: In a full-color picture, each color-map row maps pixel
                    112: values of the corresponding channel.
                    113: In a monochrome picture, pixel values index
                    114: the color map to yield red, green and blue, like this:
                    115: .IP
                    116: .EX
                    117: unsigned char cmap[256][3];
                    118: red=cmap[pixel][0];
                    119: green=cmap[pixel][1];
                    120: blue=cmap[pixel][2];
                    121: .EE
                    122: .SH EXAMPLES
                    123: .TP
                    124: .B sed '/^$/q' image
                    125: Print a header.
                    126: A sample header follows.
                    127: .LP
                    128: .EX
                    129: TYPE=dump
                    130: WINDOW=0 0 512 512
                    131: NCHAN=1
                    132: CHAN=m
                    133: RES=300 300
                    134: CMAP=
                    135: COMMAND= antiquantize 'halftone CLASSIC' 512.halftone LIBERTY.anticlassic 
                    136: COMMAND=  halftone CLASSIC 512.liberty 512.halftone 1.75 512.halftone 
                    137: COMMAND=   transpose IN OUT 
                    138: COMMAND=    resample 512 IN OUT 
                    139: COMMAND=     transpose IN OUT 
                    140: COMMAND=      resample 512 IN OUT 
                    141: COMMAND=       clip 400 400 LIBERTY OUT
                    142: .EE
                    143: .SH "SEE ALSO"
                    144: .IR bcp (1),
                    145: .IR cscan (1),
                    146: .IR imscan (1),
                    147: .IR pico (1), 
                    148: .IR flicks (9.1), 
                    149: .IR mugs
                    150: in
                    151: .IR face (9.7), 
                    152: .IR rebecca (9.1),
                    153: .IR flickfile (9.5)
                    154: .br
                    155: T. Duff,
                    156: `The 10th Edition Raster Graphics System',
                    157: this manual, Volume\ 2

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