cmd_stopic Function (ROM Call 0x391)

AMS 1.01 or higher bascmd.h

void cmd_stopic (ESI Args);

Executes TI-Basic 'StoPic' command.

cmd_stopic displays the Graph Screen and stores a part of it in a TI-Basic PIC variable. This function expects one of the following layouts on the expression stack:

END_TAG symname
END_TAG y symname
END_TAG x y symname
END_TAG width x y symname
END_TAG height width x y symname

Additionally, each of the entries x, y and width may be omitted and replaced with NOTHING_TAG. The parameter Args should point to the tag of the last item (i.e. symname). x, y, width and height should be integer items. x and y represent the upper left corner of the area to copy. Both default to 0 if they are omitted. width and height specify the dimensions in pixels. They default to the width and height of the whole graph screen. The symname entry is the VAT symbol name of a TI-Basic variable in which the graph data will be stored (it will be created if it does not exist).

See BitmapGet for a much faster low-level way of getting bitmapped data, independently of the Graph Screen.


Uses: GetValue, next_expression_index, gr_active, gr_stopic, GraphActivate


See also: cmd_rclpic, cmd_rplcpic, cmd_andpic, cmd_xorpic, BitmapGet