Cognitive Solutions A799 manual Apply margin message mode ColorPOS, Shade and store logo ColorPOS

Revision D 12/09 Chapter 4: Programming Commands  75

Apply margin message mode (ColorPOS®)

ASCII	GS 0x99 l m n o
Hexadecimal:	1D 99 l m n o
Decimal:	29 155 l m n o
Value of l:	l is a binary switch:
	l = 0	disables margin message merging
	l = 1	enable left margin message merging
	l = 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/margin message (or logo/margin 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 message(graphic) 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 parameter l = 0 turns all margin message merging to off.

Shade and store logo (ColorPOS®)

ASCII	GS Ox9A 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.

A799-PG00001D