T-Engine

A C/C++ Tetris engine

A C Tetris engine (2009 Tetris Guideline compliant-ish). Bring your own input handling and rendering. See Examples.

Not 100% complete but deciding to open source it.

Table of Contents

• Features
• TODO
• API
• Example Implementation
• Resources
• License

Features

• I, O, T, S, Z, J, L pieces
• Super Rotation System (SRS) (implementation variation but result still the same)
• Random Generator ("random bag" or "7-system")
• Ghost piece
• "Hold piece"
• Top out on overlapping spawn or partial lock out of bounds
• Level up conditions
• Scoring
• Gravity
  • Naive (most games use this i.e. clear at most 4 lines at once)
  • Sticky
  • Cascade
• Lock Delay

TODO

• CLEAN UP CODE/DOCUMENTATION/Better implementation of some things
• T-spin condition check (for scoring). Currently counts as normal single, double or triple.
• Combos/Back-to-back
• Use a configuration struct to pass into te_init_system()
• Delay Auto Shift (DAS)
• Time-based update function (currently frame based)

API

Please refer to tengine.h for the typedefs.

// Movement
void te_move_left();
void te_move_right();
void te_move_down();
void te_hard_drop();
void te_rotate_left();
void te_rotate_right();

// Initialize the system
void te_init_system();

// Free resources allocated
void te_destroy_system();

// Get the game state
TState *te_get_state();

// Get the board, used for rendering
Board *te_get_board();

// Get the value of the board at index i and j
int te_get_board_xy(Board *b, int x, int y);

// Get the current piece
Piece te_get_current_piece();

// Get the buffer to the next piece buffer
// Used for rendering the next piece list
// Returns a pointer to the start of the buffer and length in out_buf_length
PieceType *te_get_next_piece_buf(int *out_buf_len);

// Get the offsets for a piece, that can be used to render pieces individually
PieceOffsets te_get_piece_offsets(PieceType type, PieceOrientation orientation);

// Holds the current piece and swaps to held
void te_hold();

// Get the location of the current piece if hard dropped
void te_get_ghost();

// Commits piece to board
void te_commit();

// Updates the state of the game
void te_update(int d_frame);

// Did we top out?
int te_is_game_over();

// Get the current level
int te_get_level();

// Get the current score
int te_get_score();

// The following are for debugging, you probably won't use these
void te_load_board(int data[220]);
Board *te_get_committed_board();
Piece te_get_next_piece();

Example Implementation

Rough implementation with C++/SDL2/SDL2_ttf compiled using MSVC. Yes, I know the UI sucks.

Resources

Tetris Guidelines

Super Rotation System (SRS)

T-Spin

Line Clear

Combo

Random Generator

Gravity Curve

How Tetris 99 Gravity Works

License

MIT License

Copyright (c) [2019] [Raymond Wan]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.