84PCSE:BCALLs:54A3

From WikiTI
Revision as of 09:29, 20 October 2013 by FloppusMaximus (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Synopsis

Unofficial Name: HighlightRect

BCALL Address: 54A3h

Highlight a rectangular area of the LCD by changing non-black pixels to pale cyan.

Inputs

  • HL = X coordinate of left edge
  • DE = X coordinate of right edge (must be greater than or equal to HL and at most 319)
  • B = Y coordinate of top edge (from top of screen)
  • C = Y coordinate of bottom edge (must be greater than or equal to B and at most 239)

Outputs

None

Destroys

  • AF

Comments

The rectangle is drawn only to the LCD, never to the graph buffer.

For each pixel in the rectangle, if its most significant byte is zero (i.e., the color is either black, blue, or blue plus a very small amount of green), the pixel will be set to black. Otherwise it will be set to pale cyan (7FFEh.) (The fact that blue pixels are treated as black may be a mistake on TI's part, but in any case, it is clear that this routine isn't intended to be used for anything other than black-and-white text.)

The dimensions of the highlighted area are (HL-DE+1) × (C-B+1). The routine doesn't check that the provided coordinates are valid.

The interrupt state (IFF) is preserved.

See also

UnHighlightRect