move

Category:Turtle

move(x, y)

Category: Turtle

Moves the turtle by adding x pixels to the turtle's current x position and y pixels to the turtle's current y position.

Some drawings are more easily described by movements of the turtle relative to the current turtle location. Unlike moveForward(pixels), the turtle can move in a direction different from its facing direction.

Examples

// Draw a line while moving the turtle to the right and down.
move(50, 50);

Example: Turtle Direction Irrelevant Draw the same line as the previous example but with the turtle facing a different direction.

// Draw the same line as the previous example but with the turtle facing a different direction.
turnRight(90);
move(50, 50);

Example: Arrow Draw a arrow pointing up from a random location on the screen.

// Draw a arrow pointing up from a random location on the screen.
penUp();
moveTo(randomNumber(320),randomNumber(480));
penDown();
move(0, -100);
move(-25, 50);
move(50, 0);
move(-25, -50);

Syntax

move(x, y);

Parameters

Name	Type	Required?	Description
x	number	Yes	The number of pixels to move the turtle right.
y	number	Yes	The number of pixels to move the turtle down.

Returns

No return value. Moves turtle only.

Tips

Use penUp() before calling move(x,y) to have the turtle not draw as it moves.
The screen default size is 320 pixels wide and 450 pixels high, but you can move the turtle off the screen by exceeding those dimensions.
There are three ways to move the turtle in a straight line:
- Specify the number of pixels to move the turtle in the direction it is facing using moveForward(pixels) or moveBackward(pixels).
- Specify a number of pixels in the x and y direction to move the turtle using move(x,y), regardless of direction that the turtle is facing.
- Specify an x and y pixel location on the screen to move the turtle to using moveTo(x,y), regardless of direction that the turtle is facing.

Found a bug in the documentation? Let us know at documentation@code.org