BB___UP

=UP= toc

Description
> For use with graphics windows and graphicboxes, UP lifts up the pen. > With the pen UP, all //go// and //goto// commands will move the pen without drawing. > Any other drawing commands are ignored until the pen is put down.

> UP is the opposite of down.

Syntax
//This command is NOT case sensitive//.
 * 1)  - a graphics window
 * 2)  - a graphicbox

Hints
> This command (UP) is clearly turtle-graphic remainder, and would be of use only while thinking / drawing in turtle mode.
 * //**Reason to exist.**// Actually, if you want to place pen to new position without drawing, there is a special command "//place X Y//".

Here is a list of commands that affect the pen position or status: down go goto home north place posxy set size turn up

Example
An example of the command in a graphics window. Try it as is and with "   //#g "up"//" commented out. code format="lb" nomainwin

WindowWidth=400 WindowHeight=300 open "Command Demo" for graphics_nsb_nf as #g #g "trapclose [quit]"

'put pen down #g "down; home" 'draw a box #g "box 300 250" 'put pen up   #g "up" #g "goto 10 10" 'put pen down #g "down" 'draw a box #g "box 35 35" wait

[quit] close #g end code

An example of the command in a graphicbox. code format="lb" nomainwin

WindowWidth=400 WindowHeight=300

graphicbox #g.gb 2, 2, 390, 270 open "Command Demo" for graphics_nsb_nf as #g #g "trapclose [quit]"

'put pen down #g.gb "down; home" 'draw a box #g.gb "box 300 250" 'put pen up   #g.gb "up" #g.gb "goto 10 10" 'put pen down #g.gb "down" 'draw a box #g.gb "box 35 35" wait

[quit] close #g end code

Useful Functions
code format="lb" Place a useful function using this keyword here code