| cmd_pton | Function (ROM Call 0x374)

AMS 1.01 or higher | bascmd.h

void cmd_pton (CESI xValOrList, CESI yValOrList);

Executes TI-Basic 'PtOn' command.

cmd_pton displays the Graph Screen and turns on the screen pixel nearest to the window coordinates (x,y) which are relative to the current window settings (you can change them using the "Window Editor" application, or directly by storing values in system variables like "xmin", using the VarStore function). The parameters xValOrList and yValOrList should either point to integer or floating point items on the expression stack, or to lists of integer or floating point items which contain x and y coordinates respectively (both lists must have an equal number of elements). In the second case, a set of corresponding pixels will be turned on, instead of just one pixel.
See also cmd_pxlon, which uses pixel coordinates instead of window relative ones, and DrawPix for much faster low-level pixel drawing (independently of the Graph Screen).

Uses: GetValue, next_expression_index, gr_active, ForceFloat, GraphActivate, XCvtFtoP, YCvtFtoP, WinAttr, WinDupStat, WinPixSet, _bcd_math

See also: cmd_ptoff, cmd_ptchg, cmd_pxlon, cmd_line, cmd_circle, DrawPix