4DTris Software Structure

Overview

This document is a draft description of the main SW components of 4DTris.

Main - main modul - contains init functions, window ~, event handling. Triggers other moduls.

Menu - State machine for on screen menu. (Main menu, About, Scores, Options, ...)

UI-handling - user interface handling - contains corresponding functions for user interactions which links them to operations in the game model and drawing modul.

4D-draw-modul - Reads the 4D vertex datas from model modul, projects them to 3D and draws them by calling 3D-draw-modul.

3D-draw-modul - wrapper layer to openGL, buffers the facet drawing request, computes z-buffer, and draws with openGL rutines triggered by main modul.

computer-gamer - computes steps for computer player using a template game field.

model-dynamics - queue object movements requested by UI-handling/computer-player. Check movement validity, time/animate movements.

4D-model - stores positions of blocks, objects (set of blocks), checks collisions. Provide functions to move/rotate objects to model dynamics.

tetris-modul - checks the 4D model for filled spaces, reached top space and landed blocks. Erases filled spaces and indicates game over. Assigns isolevel blocks to object.

4D-library - 4D geometry functions: Rotation, Perspective projection to 3D,

Main

Functionality:

• Window initialisation
• OpenGL initialisation
• Game Initialisation
• Event Handling
• Trigger tetris modul
• Trigger model-dynamics modul
• Trigger 3D-draw modul
• Trigger computer player

UI-handling

Functionality:

• track mouse moving for camera movement, move camera.
• request object rotation from model-dynamics modul on keyboard events
• activate menu - navigate in menu

model-dynamics modul

Functionality:

• Provide functions of falling object 90 deg rotation for UI handling
• Queue movements
• Animates movements by slice rotations/movements to short angled/lengthed. Calls rotation/move function of the mode
• Undo and delete actual movement from queue if invalid based on model collosion check.
• Indicate end of movement to main modul to trigger tetris modul.

4D-model

4D-model modul is a very simple physical model of the 4D game-hyperspace. It contains hypercube blocks which are components of 4D objects. The blocks of an object are moving together. Blocks in the space are: actual falling object and each levels containing any blocks. Tetris modul creates level objects from iso-level blocks for each level, which can fall together later, when filled level erased below them.

Stored datas:

• Objects - set of blocks.
  • center positions
  • directions
  • block IDs
• Blocks - hypercubes fills the gamespace
  • relative positions
  relative directions coords of vertices

• Collosion check
• Rotate object (angle)
• Move object
• Remove object
• Create object
• Add block to object
• Explode object (blocks remain)

Collosion check - first simple model: each block contains a sphere with same diameter as hypercube edge length. These spheres are solid, can no section each other. Sphere collosion calculation: distance between blocks center points can not be lower than edge length.

tetris modul

Functionality:

• Requests falling object move down on time
• Checks if object landed.
• Explodes landed object and merge/forms its blocks to level objects.
• Checks if level filled, erase filled levels, request falling for levels above.
• Checks is landed object reached the top level. Indicates game over.

4D geometry library

Rotation matrix for plane defined by a1-a3 axles :

cos x	0	- sin x	0
0	1	0	0
sin x	0	cos x	0
0	0	0	1

menu modul

Menu items:

• [back to game]
• New game
• Options
• Audio options
• Video options
• Game options
• Control options
• Help
• Description
• Help
• High scores
• About
• Quit