Wincor Nixdorf TH320, Programmer'S Manual

Page: 62 / 157

Programmers Guide TH320/420
54
would normally be printed to the other color. The parameter m specifies the shading effect and has an
initial value of 0 which signifies no effect.
m specifies the percentage of shading, 0 <= m <= 100.
m = 0 is the initial value and turns this mode off.
Note
Only a few gradations will be perceptible, so large increments of m, such as 20, should be used. If a
reverse print mode is on, the shade effect will be applied to the background only.
When the current color mode is set to black, increasing values of m relate to the relative amount of paper-
color that replaces black dots. Analogously, when the paper-color is the current color, m defines the relative
amount of black color dots replacing the paper-color ones.
Both text and monochrome graphics are affected by this command.
Turning on monochrome shade mode, turns off color shade mode.
Logo print with color plane swap
ASCII GS 0x89 n m
Hexadecimal 1D 89 n m
Decimal 29 137 n m
This command will print logo n. The command is ignored if a logo with index n has not been defined. If
m = 0 the color(s) as defined in the logo are used; if m = 1 and if the logo is a color one, then the two
color planes (black and paper-color) in the logo are swapped.
Form and merge real-time surround graphic
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, the 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 time’s 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.