 |
cmd_newpic |
Function (ROM Call 0x365) |
Executes TI-Basic 'NewPic' command.
cmd_newpic creates a new TI-Basic PIC variable based on data from a matrix on
the expression stack (see TI-Basic manual for more info). The parameter
Matrix should point to the tag of an n x 2 matrix on the
expression stack (its elements must be integer items). Each row in the matrix
represents a pixel. Pixel coordinates starts at (0,0). PicName should
point to the variable tag of the symbol (i.e. TI-Basic variable) which will
be created (see SYMSTR). If the symbol
already exists, cmd_newpic replaces it. The parameters MaxRow and
MaxCol should point to two integer items which determine the height
and the width of the created PIC variable, i.e. the maximum boundary limits
for it. Optionally, either MaxRow or MaxCol may point to
END_TAG. In this case, default values
will be used, which are determined from the minimum area required for the
matrix values.
This function may cause heap compression.
Uses: ER_catch, ER_success, ER_throwVar, GetValue, next_expression_index, DerefSym, VarStore, MakeWinRect, WinBitmapGet, WinBitmapSize, WinOpen, WinPixSet, WinRemove