GitHub - snowfarthing/nibbles_3d: A simple Python 3D graphics engine

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
.gitignore		.gitignore
II-littlecube.tex		II-littlecube.tex
II-wormsegments.py		II-wormsegments.py
LICENSE		LICENSE
README		README
camera-snapshot-rotateview1.png		camera-snapshot-rotateview1.png
camera-snapshot-xview.png		camera-snapshot-xview.png
camera-snapshot-zoomaway1.png		camera-snapshot-zoomaway1.png
camera.py		camera.py
coords.dat		coords.dat
latex-wormsegments.py		latex-wormsegments.py
littlecube.dat		littlecube.dat
littlecube.tex		littlecube.tex
littlecubesystem.py		littlecubesystem.py
math3d.py		math3d.py
matrix.py		matrix.py
movable.py		movable.py
nibbles3d.pdf		nibbles3d.pdf
nibbles3d.tex		nibbles3d.tex
position.py		position.py
quat.py		quat.py
screenshots4.png		screenshots4.png
sintable.dat		sintable.dat
ttable.py		ttable.py
vertex.py		vertex.py
wf.py		wf.py
wf_data.py		wf_data.py
worm.py		worm.py
worm_ball_type_I.dat		worm_ball_type_I.dat
worm_elbow.dat		worm_elbow.dat
worm_head_tail.dat		worm_head_tail.dat
worm_middle_segment.dat		worm_middle_segment.dat
wormsegments.py		wormsegments.py

Repository files navigation

==================================================
   NIBBLES 3D -- A SIMPLE PYTHON 3D GAME ENGINE
==================================================

This is a simple 3D Game Engine, written in Python and using the PyGame
game library for graphics and keyboard/mouse controls.  Due to various
constraints, I haven't worked on the engine for some time.

To run the demo, make sure python-pygame is installed, and run

    python II-wormsegments.py

A more detailed explanation of the code, and its various modules, can
be found in "nibbles3d.pdf", or alternatively the source of this file,
"nibbles3d.tex".

If you wish to try the demo, note that you need to press "f" or "F"
(which stands for "floating camera mode").  The "worm" functions
aren't yet implemented.  Once you are in "floating camera mode",
you can navigate using the mouse by clicking in the various regions--
up, down, left and right translate the camera, center up goes forward,
and center back goes backward.  The regions surrounding the center
twist the camera clockwise or counter-clockwise.  (Note that the mouse
cursor changes to indicate what the different motions will be.)


This code is covered by an MIT License.  See LICENSE for more
details.