Cognitive Solutions A776, B780 manual Form and merge real-time surround graphic ColorPOS

Chapter 5: Programming commands  73

Form and merge real-time surround graphic (ColorPOS®)

ASCII	GS 0x90 m x y o p q
Hexadecimal	1D 90 m x y o p q
Decimal	29 144 m x y o p q

This command will print a real-time graphic style designated by m. m = 0 rectangle, m =1 oval, m =2 ellipse (if printed in a square area the ellipse becomes a circle),

m = 3 is a 5 point star, m = 4 is a free hand underline,

m = 5 is a free hand ellipse and other values of m reserved for future styles. This graphic is formed into a RAM based graphics buffer, and the buffer state is set to “graphic merge pending”.

Whenever the buffer is in the pending merge state and print output is started, the state will be changed to frozen and a merge process started (logically OR-ed graphic data) into the print lines that follow. The application determines how close the graphic is to any printed character data by subsequent printing of blank lines or blank dot rows. The merge process stops when the buffer is exhausted or its state changed (by a save graphics buffer as logo or new form and merge real time surround graphics command). The form and merge real time surround graphics command can be given multiple consecutive times, allowing the application to set up a multi-polygon background before starting its printout with placed text or logo.

The geometric location points for this graphic are defined by a rectangular area start position of x bytes from the left edge and y bytes from the top of the new line and times

o bytes wide times p bytes in length. For the case of

m =3 (star), the value passed for o is also used as the implicit p value (passed value is ignored), i.e. a square area. The thickness of the graphic is defined by q dots. This will form a bit image in a RAM graphics buffer. Subsequent surround graphic commands can be added into (logical OR process) with expanded size if needed) the graphics buffer until an output action is issued. It is expected that area left white will then be (usually) filled in with text or other data that is to be printed. Printing starts as soon as the first line of data or other printout arrives. After this printing is started, any new surround graphics commands will set the graphics buffer to a merge pending state. Example: Create different size stars and an ellipse around a block of text.

The graphics buffer is at a frozen state at printer initialization or reset, with blank data in it.

Each the time this command is given, the current color and shade mode values (if any) are used for the surround graphic, and may be changed before any subsequent surround graphics and/or printing output. This command may be used in page mode.

A776-PG00001 C 12/09 A776 (B780) Programming Guide