138 lines
3.1 KiB
C
138 lines
3.1 KiB
C
#ifndef TETRIS_PIECE_H_
|
|
#define TETRIS_PIECE_H_
|
|
|
|
#include <inttypes.h>
|
|
|
|
/**
|
|
* \defgroup TetrisPieceTypes Piece: Data types
|
|
*/
|
|
/*@{*/
|
|
|
|
/*********
|
|
* types *
|
|
*********/
|
|
|
|
/** shape attributes for a piece */
|
|
typedef enum tetris_piece_shape_t
|
|
{
|
|
TETRIS_PC_LINE, /**< the I shaped brick */
|
|
TETRIS_PC_T, /**< the T shaped brick */
|
|
TETRIS_PC_SQUARE, /**< the sqare shaped brick */
|
|
TETRIS_PC_L, /**< the L shaped brick */
|
|
TETRIS_PC_LBACK, /**< the reverse L shaped brick */
|
|
TETRIS_PC_S, /**< the S shaped brick */
|
|
TETRIS_PC_Z /**< the Z shaped brick */
|
|
}
|
|
tetris_piece_shape_t;
|
|
|
|
|
|
/** possible angles for a brick */
|
|
typedef enum tetris_piece_angle_t
|
|
{
|
|
TETRIS_PC_ANGLE_0, /**< standard angle */
|
|
TETRIS_PC_ANGLE_90, /**< rotated by 90 degrees */
|
|
TETRIS_PC_ANGLE_180, /**< rotated by 180 degrees */
|
|
TETRIS_PC_ANGLE_270 /**< rotated by 270 degrees */
|
|
}
|
|
tetris_piece_angle_t;
|
|
|
|
|
|
/** rotation attributes */
|
|
typedef enum tetris_piece_rotation_t
|
|
{
|
|
TETRIS_PC_ROT_CW, /**< clockwise rotation */
|
|
TETRIS_PC_ROT_CCW /**< counter clockwise rotation */
|
|
}
|
|
tetris_piece_rotation_t;
|
|
|
|
/**
|
|
* describes the attributes of a piece
|
|
* @see tetris_piece_shape_t
|
|
* @see tetris_piece_angle_t
|
|
*/
|
|
typedef struct tetris_piece_t
|
|
{
|
|
tetris_piece_shape_t shape; /**< specifies the shape of the piece */
|
|
tetris_piece_angle_t angle; /**< specifies one of 4 angels */
|
|
}
|
|
tetris_piece_t;
|
|
|
|
/*@}*/
|
|
|
|
|
|
/**
|
|
* \defgroup TetrisPieceRelated Piece: Interface functions
|
|
*/
|
|
/*@{*/
|
|
|
|
/*****************************
|
|
* construction/destruction *
|
|
*****************************/
|
|
|
|
/**
|
|
* constructs a piece with the given attributes
|
|
* @param s shape of the piece (see tetris_piece_shape_t)
|
|
* @param a its angle (see tetris_piece_angel_t)
|
|
* @return pointer to a newly created piece
|
|
*/
|
|
tetris_piece_t *tetris_piece_construct(tetris_piece_shape_t s,
|
|
tetris_piece_angle_t a);
|
|
|
|
|
|
/**
|
|
* destructs a piece
|
|
* @param pPc pointer to the piece to be destructed
|
|
*/
|
|
void tetris_piece_destruct(tetris_piece_t *pPc);
|
|
|
|
|
|
/***************************
|
|
* piece related functions *
|
|
***************************/
|
|
|
|
/**
|
|
* returns bitfield representation of the piece
|
|
* @param pPc piece from which the bitfield shuld be retrieved
|
|
* @return bitfield representation of the piece
|
|
*/
|
|
uint16_t tetris_piece_getBitmap(tetris_piece_t *pPc);
|
|
|
|
|
|
/**
|
|
* rotates a piece
|
|
* @param pPc piece to rotate
|
|
* @param r type of rotation (see tetris_piece_rotation_t)
|
|
*/
|
|
void tetris_piece_rotate(tetris_piece_t *pPc,
|
|
tetris_piece_rotation_t r);
|
|
|
|
|
|
/**
|
|
* changes the shape of a piece
|
|
* @param pPc piece to change
|
|
* @param shape the shape of interest
|
|
*/
|
|
void tetris_piece_setShape(tetris_piece_t *pPc,
|
|
tetris_piece_shape_t shape);
|
|
|
|
|
|
/**
|
|
* changes the angle of a piece
|
|
* @param pPc piece to change
|
|
* @param angle the angle of interest
|
|
*/
|
|
void tetris_piece_setAngle(tetris_piece_t *pPc,
|
|
tetris_piece_angle_t angle);
|
|
|
|
|
|
/**
|
|
* returns the number of different angles
|
|
* @param pPc piece whose angle count we want to know
|
|
* @return number of different angles
|
|
*/
|
|
int8_t tetris_piece_getAngleCount(tetris_piece_t *pPc);
|
|
|
|
/*@}*/
|
|
|
|
#endif /*TETRIS_PIECE_H_*/
|