Cognitive Solutions A776, B780 Apply margin message mode ColorPOS, Shade and store logo ColorPOS

Chapter 5: Programming commands  75

Apply margin message mode (ColorPOS®)

ASCII	GS 0x99 l m n o
Hexadecimal	1D 99 l m n o
Decimal	29 153 l m n o
Value of l:	l is a binary switch:

0 = disables margin message merging

1 = enable left margin message merging

2 = enable right margin message merging

l> 2 ignore command

Value of m: m is the ID (index) of the logo to be used in the merging. If a logo with index m does not exist or is wider than the print raster width then this command is ignored.

Value of n: n is the number of raster rows to be empty (skipped) before repeating the designated margin message merge

Value of o: o is a right – left toggle switch:

o = 0 no toggling of the margin message merge

o = 1 enable toggling, starting with a left margin message first o = 2 enable toggling, starting with a right margin message first o > 2 ignore entire command

This command performs a dynamic merge of a designated logo/message (or logo/message pair, which can be the same) into each raster line to be printed after the character data has been placed and in conjunction with any other active merge modes. The parameter l specifies whether merging should take place from the left side or the right side. A left side merge followed by a right side merge (or vice-versa) must be issued, with the latter side merge command setting the toggle switch = 1 or 2 will create the desired left – right printing effect. Each merge side retains its n value of raster rows to be skipped. If toggling is not selected when both sides are defined, then if the n skip row values are different, or the logo height sizes are different, the side logos will not line up as printing progresses. If toggling is selected then both left and right sides merge margin message must be defined; otherwise toggling is ignored.

Each side logo can be > ½ of the raster print line. In that case the printing process is additive in the overlap region. This command with the first parameterl = 0 turns all margin message merging to off.

Shade and store logo (ColorPOS®)

ASCII	GS 0x9A n m o
Hexadecimal	1D 9A n m o
Decimal	29 154 n m o
Value of n:	n is ID (logo index value) of an existing logo in either flash or RAM memory
Value of m:	m is the % of shading to be applied to the logo, 0 <= m <=100.
Value of o:	o is the new ID (logo index value) to be used to store the shaded result, according to the current setting of
	user storage into flash or RAM.

This command applies shading to an existing logo of any size, storing the result in a new logo at index o. The new logo is thus better suited for use in a merging mode. The % of shading will have only a few perceptible gradations, so large increments (20 is suggested) should be used to achieve visibly distinct effects.

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