Previous: GUI Installation, Up: GUI


10.2 GUI Usage

To use xasy, one must first deconstruct Asymptote pictures into transparent GIF (or PNG) images with the command asy -xN, where N denotes the magnification (a positive real number, say 2). The command asy -VxN automatically invokes xasy once deconstruction is complete. Alternatively, one may turn on the -xN option in interactive mode or from within a module using the function gui() or gui(N). One can turn GUI mode off again with gui(0). Deconstruction using transparent GIF files requires that ImageMagick (see convert) be installed.

The modified layout can be written to disk with the w key in a form readable to Asymptote. A wheel mouse is convenient for raising and lowering objects, to expose the object to be moved. If a wheel mouse is not available, mouse Button-2 (lower) can be used repeatedly instead. Here are the currently defined key mappings:

z
undo
r
redo
<Delete>
delete
w
write
q
quit

One can also draw connected line segments by holding down the shift key and pressing mouse Button-1 at each desired node. Releasing the shift key ends the definition of the path. More features will be added to this preliminary GUI soon.

Deconstruction of compound objects (such as arrows) can be prevented by enclosing them within the commands

void begingroup(picture pic=currentpicture);
void endgroup(picture pic=currentpicture);
By default, the elements of a picture or frame will be grouped together on adding them to a picture. However, the elements of a frame added to another frame are not grouped together by default: their elements will be individually deconstructed (see add).