.move()

Bitsbox's .move command moves a stamp,  text object, or circle on the screen. You can tell it to move to a specific location on the screen, or move in a specific direction by a specified distance. You can also specify how long the move should take to complete. This number is expressed in milliseconds (thousandths of a second).

• stamp.move(X,Y,MILLISECONDS)
• stamp.move(DIRECTION,DISTANCE,MILLISECONDS)
• stamp.move()
• text.move(X,Y,MILLISECONDS)
• text.move(DIRECTION,DISTANCE,MILLISECONDS)
• text.move()
• circle.move(X,Y,MILLISECONDS)
• circle.move(DIRECTION,DISTANCE,MILLISECONDS)
• circle.move()

This program instantly moves the apple stamp to 200,200 and the text 'apple' to 200,300, and the circle to 200,250 when you tap on the screen.

c = circle(384,550,150,'light green') a = stamp('apple') b = text('apple',CENTER,386,600) function tap() {   a.move(200,200)   b.move(200,300)   c.move(200,250) }

This example does the same move, but animates the move over 1000 milliseconds (1 second).

c = circle(384,550,150,'light green') a = stamp('apple') b = text('apple',CENTER,386,600) function tap() {   a.move(200,200,1000)   b.move(200,300,1000)   c.move(200,250,1000) }

Handing in the name of a direction, moves a stamp, text object, or circle that direction by a distance equal to its size.

c = circle(384,500,60,'light green') a = stamp('apple') b = text('apple',CENTER,386,600,50) function tap() {   a.move(RIGHT)   b.move(RIGHT)   c.move(RIGHT) }

You can also add a second parameter to move it by a certain number of pixels.

c = circle(384,550,'light green') a = stamp('apple') b = text('apple',CENTER,386,600) function tap() {   a.move(UP,200)   b.move(UP,200)   c.move(UP,200) }

Adding a third parameter animates the move over that number of milliseconds.

c = circle(384,550,'light green') a = stamp('apple') b = text('apple',CENTER,386,600) function tap() {   a.move(UP,200,1000)   b.move(UP,200,1000)   c.move(UP,200,1000) }

Calling move with no parameters instantly moves the stamp, text object, or circle to a random screen position. In this example, the stamp,  text object, and circle probably won't end up near each other. They each get their own random location.

c = circle(384,550,'light green') a = stamp('apple') b = text('apple',CENTER,386,600) function tap(){   a.move()   b.move()   c.move() }

Note that if you use a direction like UP or RIGHT, the actual direction the stamp, text object, or circle moves can depend on the object's rotation. If a stamp, text object, or circle is unrotated, UP means up. If an object is rotated 90 degrees (toward 3 o'clock), then UP will move it to the right. Here's a little program that slowly rotates a watermelon. Every time you tap it moves UP, but as you'll see, UP is relative to the stamp's rotation.

w = stamp('watermelon') w.rotate(360,15000) function tap() {   w.move(UP, 20) }

If you want your stamp, text object, or circle to move UP regardless of its rotation, consider trying the direction NORTH instead. NORTH in Bitsbox is always toward the top of your screen.