Original Author Paul Laughton, 2011
Page 181
De Re BASIC!
Gr.get.pixel x, y, alpha, red, green, blue
Returns the color data for the screen pixel at the specified x, y coordinate. The x and y values must not
exceed the width and height of the screen and must not be less than zero.
To get a pixel from the screen, BASIC! must first create a bitmap from the screen. If there is not enough
memory available to create the bitmap, you will get an "out-of-memory" run-time error.
Gr.save <filename_sexp> {,<quality_nexp>}
Saves the current screen to a file. The default path is "<pref base drive>/rfo-basic/data/".
The file will be saved as a JPEG file if the filename ends in ".jpg".
The file will be saved as a PNG file if the filename ends in anything else (including ".png").
The optional <quality_nexp> is used to specify the quality of a saved JPEG file. The value may range from
0 (bad) to 100 (very good). The default value is 50. The quality parameter has no effect on PNG files
which are always saved at the highest quality level.
Note: The size of the JPEG file depends on the quality. Lower quality values produce smaller files.
Gr.get.type <object_ptr_nexp>, <type_svar>
Get the type of the specified display list object. The type is a string that matches the name of the
command that created the object: "point", "circle", "rect", etc. For a complete list of types, see the table
in Gr.Modify.
If the <object_ptr_nexp> parameter does not specify a valid display list object, the returned type is the
empty string, "". You can call the GETERROR$() function to get information about the error.
Gr.get.params <object_ptr_nexp>, <param_array$[]>
Get the modifiable parameters of the specified display list object. The parameter strings are returned in
the <param_array$[]> in no particular order. The array is specified without an index. If the array exists, it
is overwritten. Otherwise a new array is created. The result is always a one-dimensional array.
For a complete list of parameters, see the table in Gr.Modify.
Gr.get.position <object_ptr_nexp>, x, y
Get the current x,y position of the specified display list object. If the object was specified with rectangle
parameters (left, top, right, bottom) then left is returned in x and top is returned in y. For Line objects,
the x1 and y1 parameters are returned.
Gr.move <object_ptr_nexp> {{, dx}{, dy}}
Moves the graphics object by the amounts dx and dy. If the object is a group, all of the graphical objects
in the group are moved. The dx and dy parameters are optional. If omitted they default to 0.