1. Stefan Göbel
  2. Tortoise3D

Overview

HTTPS SSH

Tortoise3D - Like 3D turtle graphics, but without the graphics part.

This Python package does not provide any graphical output!

It allows you to move a turtle (tortoise) in 3D space and query the coordinates to include it in your own scripts or modules.

A Tortoise3D instance keeps track of its position in world space and a local coordinate system. This local space may differ from the world coordinate system as a result of a rotation of the tortoise. The basic movement operations - e.g. forwardX() - move the tortoise by a user defined distance (by default this distance is 1). These basic movements always operate on the local coordinate system. A tortoise instance also maintains a simple stack, allowing you to push and pop the tortoise's state.

Example Usage:

Create the Tortoise3D instance, move it one unit in x direction, rotate it by 90 degrees around the y-axis and move it one unit in the new x direction. Save the tortoise position in the variables x, y and z.

>>> import tortoise3d
>>> tortoise = tortoise3d.Tortoise3D ()
>>> tortoise.forwardX ()
((0.0, 0.0, 0.0), (1.0, 0.0, 0.0))
>>> tortoise.radians (False)
True
>>> tortoise.rotateY (90)
>>> (_, (x, y, z)) = tortoise.forwardX ()

Installation:

Tortoise3D is not available on PyPI. You need to manually download (or clone) it. After that, use the following commands to install it.

To install Tortoise3D for all users, run:

python setup.py install

To install it in your $HOME directory, run:

python setup.py install --user

More options are available. For more details see

python setup.py --help install

Documentation:

Documentation is available from within Python:

>>> import tortoise3d
>>> help (tortoise3d.tortoise3d)

License:

Copyright 2008-2010, 2014 Stefan Goebel <tortoise3d at subtype dot de>

Tortoise3D is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Tortoise3D is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Tortoise3D. If not, see <http://www.gnu.org/licenses/>.