| Наше предложение для тех, кто хочет научиться программировать на Delphi, изучая исходники других программ!
Вы можете бесплатно скачать саму игру (ТЕТРИС), но обязаны заплатить 5 долларов за исходник программы. Вы получаете полный текст программы на Delphi и комментарии к ней! Всего за 5 долларов вы сможете изучить текст самой известной программы и понять, как создаются игры, такие как Tetris!
Мы дадим вам математический алгоритм программы! Теперь вы станете намного опытнее и сможете самостоятельно создавать программы и зарабатывать на этом деньги как в реальной жизни, так и в интернете!
Избегайте своих ошибок, мы научились правильно программировать и поможем
научить этому вас!
www.tetriswithsource.com
Описание модулей
TetrisP - Основной файл проекта
Tetris00 - Модуль содержит основную форму проекта (TMainForm). Производит связку между нажатиями горячих клавиш и кнопок панели управления с вызовом процедур обработки соответствующих событий находящихся в модуле Tetris02 и вызовам процедур прорисовки поля.
Tetris01 - Модуль содержит определение ячейки поля (TFieldCell), как записи о цвете и номере отображаемой в ячейке текстуры. А также реализацию игрового поля (класс TField) - позволяющего проводить отрисовку и простейшие операции над игровым полем.
Tetris02 - Модуль содержит реализацию алгоритма игры (класс TTetrisGame), обрабатывает события от таймера, ведет статистику (время игры, количество выпущенных фигур, удаленных линий). Создает фигуру случайным образом фигуру которая будет активной в течении следующего промежутка времени и производит с ней непосредственное взаимодействие. Отлавливает все логические ошибки происходящие во время игры и связанные например с попыткой запустить уже активную игру.
Tetris03 - Модуль содержит методы по работе со всеми фигурами используемыми в проекте и учитывает все их особенности реализации. (классы фигур TXXXXFigure).
Tetris04 - Модуль содержит определение констант используемых в программе и процедуру генерации цвета случайным образом с учетом того что цвет не должен будет сливаться с пустой ячейкой поля.
Tetris05 - Модуль содержит форму настроек (TOptionsForm) позволяющую отображать список существующих фигур читать и устанавливать их свойство Enabled.
Tetris06 - Модуль содержит определение структуры (TFigureInfo) для хранения необходимой информации о существующей фигуре, массив записей этого типа с описанием всех фигур проекта (для возможности отображения в форме настроек и выбора фигуры случайным образом), а также методы по доступу к этим данным
Tetris07 - Модуль обеспечивает многоязыковую поддержку. Он содержит в себе определение всех строковых констант используемых в сообщениях проекта и позволяет создавать исполнимый файл с сообщениями как на английском так и на русском языке.
Описание классов
TMainForm
- класс основной формы проекта. Включает в себя такие объекты, как
| MainToolBar
|
панель инструментов (TToolBar*)
|
Расположена на форме в правой части и содержит в себе набор кнопок (btnXXXX)
|
| btnXXXX
|
кнопки (TButton*)
|
Расположены на панели инструментов и предназначены для удобного вызова заданных процедур
|
| MainImageList
|
список изображений (TImageList*)
|
Содержит изображения иконок используемых кнопками (btnXXXX)
|
| MainActionList
|
список действий (TActionList*)
|
Содержит перечень действий (actXXXX) используемый программой
|
| actXXXX
|
действия (TAction*)
|
Предназначена связи кнопок (btnXXXX), горячих клавиш и вызова заданных процедур
|
| MainPanel
|
панель (TPanel*)
|
Расположена в верхней части формы и предназначена для выводы статистической инфорамции (время, количество фигур, количество удаленных линий)в процессе игры
|
| MainImage
|
изображение (TImage)*
|
Расположено в центральной части формы и предназначена для показа игрового поля на экране. (Но не его прорисовку!)
|
| MainStatusBar
|
строка состояния (TStatusBar)*
|
Расположена в нижней части основной формы, предназначена для отображения статуса игры (активна, приостановлена, закончена и т.д.) и подсказки для кнопок над которыми находится манипулятор мышь
|
| fReg
|
реестр (TRegistryDef*)
|
Предназначена для работы с реестром - сохранением настроек программы между сеансами работы
|
| fField
|
игровое поле (TField)
|
Реализует хранение логической информации о состоянии поля и его прорисовку т.е. вывод в изображение (TImage)
|
| fOptionsForm
|
форма настроек (TOptionsForm)
|
Предназначена для возможности выбора фигур используемых в программе
|
| fGame
|
игра (TTetrisGame)
|
Реализует алгоритм игры
|
(* - помечены стандартные объекты Delphi)
TFieldCell
- запись содержащая информацию об каждой ячейке игрового поля.
| Color
|
longint
|
Цвет в ячейке если не используется текстура
|
| FigureNum
|
integer
|
Номер фигуры которая попадает в данную ячейку. 0 - если фигуры нет
|
| TextureNum
|
smallint
|
Номер текстуры в ячейке. Отрицательные числа соответствуют текстурам бомб
|
TField
- класс игровое поле. Включает в себя такие объекты, как
| fBomb
|
Список объектов (TObjectList)
|
Предназначен для хранения списка текстур бомб
|
| fTexture
|
Список объектов (TObjectList)
|
Предназначен для хранения списка текстур непустых клеток
|
| fImage
|
Изображение (TImage)
|
Предназначено для хранения указателя на изображение основной формы
|
| fFieldMatrix
|
Матрица (TFieldMatrix)
|
Предназначена для хранения массива с данными типа TFieldCell о клетках.
|
поля:
| fFieldSize
|
Размер ячейки (integer)
|
Хранит размер ячейки поля в пикселах
|
свойства:
| FieldCountX
|
Число ячеек по X (integer)
|
Позволяет определить размер поля в количестве ячеек вдоль X
|
| FieldCountY
|
Число ячеек по Y (integer)
|
Позволяет определить размер поля приспособленный для игры в количестве ячеек вдоль Y *
|
| FieldRealCountY
|
Число ячеек по Y (integer)
|
Позволяет определить фактический размер поля в количестве ячеек вдоль Y
|
| FieldVisibleCountY
|
Число ячеек по Y (integer)
|
Позволяет определить видимый размер поля в количестве ячеек вдоль Y
|
* Фактически размерность массива по X совпадает с тем что отображается на экране, по Y ситуация другая. Фактически в памяти поле представлено по Y с большим размером (+ReservedLines). Это вызвано необходимостью хранить данные о фигуре которая только начала падать и находится вне пределов видимости в верних строках и тем что именно по занятости хотя бы одной ячейки верхних ReservedLines строк определяется окончена игра или нет. Фактический размер определяется FieldRealCountY, допустимый для нахождения фигур FieldCountY. В то же время на экране может отображаться любое число строк от 1 до FieldRealCountY. Поэтому присутствует еще одно свойство FieldVisibleCountY, которое как раз и определяет сколько строк видно пользователю. В частности этот момент использовался при отладке - когда на экране было все поле целиком, фигура начинала падать не с самого верха и игра заканчивалась когда фигура застревала на верхних ReservedLines строках, а не обязательно достигнув верхней границы.
методы:
| ClearAll
|
Очистка игрового поля, путем занесения 0 во все ячейки
|
| ClearCell (x,y:integer)
|
Очистка ячейки (x,y) путем занесения 0 в эту ячейку
|
| SetAtCell (x,y:integer;const Cell:TFieldCell)
|
Установка в ячейку (x,y) значения Cell. Т.е. логическое получение занятой ячейки
|
| GetAtCell (x,y:integer)
|
Получение значения из ячейки (x,y)
|
| ClearAt (x,y:integer;CurCell:PFieldCell=nil)
|
Определяет свободна ли ячейка (x,y) логически и если указан CurCell то ячейка считается свободной даже когда там находится значения совпадающее с CurCell.
|
| DelFullLine
|
Удаление одной из полностью занятых строк.
|
| IsOverflow
|
Проверка на переполнение. Переполненным полем считается поле для которого хотя бы одна ячейка верхних ReservedLines занята
|
| DeleteFigure(FigureNum:integer)
|
Удаление с поля фигуры с номером FigureNum. Используется при падении Бомбы-2
|
| DrawToImage
|
Прорисовка текущего состояния поля
|
Игра может находится в одном из логических состояний:
| gmNothing
|
Игра не начата
|
| gmActive=1
|
Игра идет
|
| gmSuspend=2
|
Игра приостановлена
|
| gmEnded=3
|
Игра завершена
|
| gmAborted=4
|
Игра прервана пользователем
|
| gmGraphicError
|
Игра завершена с ошибкой во время рисования
|
| gmCreateFigureError
|
Игра завершена с ошибкой создания фигуры
|
TTetrisGame
- класс реализующий алгоритм игры. Включает в себя такие объекты, как:
| fFiguresEnum
|
управление набором фигур (TFigureEnumManager)
|
Реализует хранение и доступ к массиву существующих фигур
|
| fField
|
игровое поле (TField)
|
Предназначено для хранения указателя на объект игровое поле
|
| fCurrentFigure
|
текущая фигура (TBaseFigure)
|
Предназначено для хранения указателя на текущую фигуру и проведения с ней всяких операций типа вращения
|
| fTimer
|
таймер (TTimer*)
|
Предназначен для появления событий в программе через определенный промежуток времени, чтобы реализовывать перемещение фигуры
|
поля:
| fQuickCoef
|
коэффициент ускорения (integer)
|
Предназначено для хранения коэффициента, который используется при ускоренном падении фигуры при нажатии клавиши
|
| fInProcess
|
статус игры (byte)
|
Предназначено для хранения статуса игры
|
| fFigNum
|
количество фигур (integer)
|
Предназначено для хранения числа выпущенных фигур и отображении в статистике
|
| fTimerClicks
|
время игры (integer)
|
Предназначено для хранения времени игры и отображении в статистике
|
| fDeletedLines
|
число удаленных линий (integer)
|
Предназначено для хранения числа удаленных линий и отображении в статистике
|
| fOldTimer
|
интервал таймера (integer)
|
Интервал таймера до ускорения или 0 если таймер находится не в ускоренном режиме
|
события:
| TimerTick(Sender:TObject)
|
Событие от таймера. Происходит через заданный интервал времени
|
методы:
| SetInProcess(AInProcess:byte)
|
Установка статуса игры. Использование данного метода, а не непосредственный доступ к полю гарантирует установку только допустимых значений и своевременное изменение строки статуса в основной форме
|
| LogicalError(ErrMsg:PChar)
|
Вызывается при необходимости сообщить пользователю о произошедшей логической ошибке
|
| InitCurrentFigure;
|
Создание текущей фигуры случайным образом. Указатель на текущую фигуру остается в fCurrentFigure
|
| Start
|
Запуск игры или продолжение после приостановки
|
| Stop
|
Остановка игры
|
| Pause
|
Приостановка игры
|
| NotActive:boolean
|
Проверяет не находиться ли игра в состоянии игры, если да выдается сообщение
|
| IsGoing(ShowMsg:boolean=true)
|
Проверяет не активна ли игра. если нет и ShowMsg то выдается сообщение
|
| ClearAll
|
Вызов очистки игрового поля, обнуление fFigNum, fDeletedLines, fTimerClicks
|
| GetTextStatus:string
|
Получение статистики по игре в текстовом виде для вывода на экран
|
| RotateAgainst
|
Проверка активна ли игра и есть ли текущая фигура, если да то происходит поворот фигуры
|
| RotateAlong
|
| MoveLeft
|
Проверка активна ли игра и есть ли текущая фигура, если да то происходит сдвиг фигуры
|
| MoveRight
|
| GetInfo
|
Получения статуса игры в текстовом виде для отображения в строке статуса
|
| DoFall
|
Реализация метода падения (вызывается по клавиши вниз)
|
| StartQuickFall(Quick:boolean=true)
|
Если Quick то установка режима ускоренного падения, нет возврат к обычному
|
* Основными процедурами являются: TimerTick, DoFall
| TimerTick
|
Реакцию на событие от таймера можно представить следующим образом:
Проверить есть текущая фигура Assigned(fCurrentFigure)
Если есть проверить может ли она сдвинуться на клетку вниз fCurrentFigure.CanDown
Если может, то сдвинуть fCurrentFigure.Down
Иначе обрабатываем ситуацию упал (для бомб падение предполагает очистку других ячеек поля) fCurrentFigure.Falled
Если нет, то проверяется заполненность хотя бы одной из линий поля полностью
Если таковая находится то она удаляется fField.DelFullLine
Иначе проверяется заполненность ячеек из вернего уровня fField.IsOverflow
Если хотя бы одна занята - игра заканчивается
Иначе создается очередная фигура случайным образом InitCurrentFigure
|
| DoFall
|
Реакцию на событие от пользователя "отпускание фигуры" можно представить следующим образом:
Проверить есть текущая фигура Assigned(fCurrentFigure)
Если есть то пока она может сдвигаться вниз (fCurrentFigure.CanDown)
сдвигать ее вниз (fCurrentFigure.Down)
обрабатываем ситуацию упал (для бомб падение предполагает очистку других ячеек поля) fCurrentFigure.Falled
|
| RotateAgainst, RotateAlong
|
Реакцию на событие от пользователя "поворот фигуры" можно представить следующим образом:
Проверить идет ли игра и есть текущая фигура IsGoing and Assigned(fCurrentFigure)
Если есть то повернуть фигуру fCurrentFigure:=fCurrentFigure.Rotate
|
При выполнении перечисленных операций с фигурой совершенно не важно какая она на самом деле. Операции проводятся с базовой фигурой, которая имеет лишь методы по своему повороту, сдвигу. Реализация всех этих действий выполняется в потомках объекта базовая фигура (TBaseFigure), перечисленных ниже. В потомках даже приходиться лишь правильно определить координаты относительно базовой точки, остальное сделает TBaseFigure!
TBaseFigure
- класс базовая фигура позволяющий задать очертания фигуры и методы по ее перемещению, повороту. Включает в себя следующие поля
| Cell
|
ячейка (TFieldCell)
|
Описание основной ячейки - цвет, текстура, номер находящийся в ней.
|
| Xbase
|
координата по X (integer)
|
Координаты базовой точки фигуры на поле
|
| Ybase
|
координата по Y (integer)
|
| DownLimit
|
отступ снизу (integer)
|
Отступы вниз, влево, вправо от базовой точки до границ фигуры, чтобы не вылазить за границы поля при перемещении. Т.е. общие очертания фигуры всегда прямоугольник. Конкретно какие ячейки она занимает в этом пространстве опредялются для потомков индивидуально
|
| RightLimit
|
отступ справа (integer)
|
| LeftLimit
|
отступ слева (integer)
|
методы:
| Rotate(AlongClock:boolean)
|
Реализует поворот фигуры по или против часовой стрелки
|
| CanDown
|
Определяет - может ли фигура упасть на одну клетку вниз
|
| Down
|
Реализует фактического падения фигуры
|
| Move(Left:boolean;AField:TField)
|
Реализует фактическое перемещение фигуры вправо или влево.
|
| Falled
|
Реализует реакцию после того как фигура упала. Перекрыто в бомбе и очищает клетку под ней
|
| MakeCurrent
|
Реализует фактическое рисование фигуры на поле
|
| IsEmptyCell
|
Определяет свободна ли клетка (i,j) на поле
|
| IsEmptyAndOnFieldCell
|
Определяет входит ли клетка (i,j) на поле и свободна ли она. При таком подходе работает быстрей чем два вызова - отдельная процедура "входит ли на поле" и "свободная ли она"
|
| ClearCell(i,j:integer)
|
Реализует очистку одной клетки (i,j)принадлежащей фигуре
|
| FillCell(i,j:integer)
|
Реализует рисование в определенную клетку (i,j)
|
| AfterInit
|
Обеспечивает возможность изменения полей наследуемой фигуры
|
| CheckEach(Proc:TCheckProc;Xabs,Yabs:integer)
|
Конкретно определяет какие ячейки используются фигурой. Процедура обязательно перекрывается в потомках.
|
| ClearCurrent
|
Обеспечивает стирание фигуры с поля (перед шагом вниз/влево/вправо/падения)
|
| GetTwinFigure(AlongClock:boolean)
|
Обеспечивает получение фигуры-близнеца. Т.е той фигуры, которая получается после поворота данной под углом 90 или -90 градусов. Перекрыто в конкретных потомках. Если нет, то поворот не осуществляется. Например для квадрата.
|
| SetBaseCell
|
Обеспечивает установку конкретного номера текстуры в потомке, таким образом обеспечивается одна фигура, один цвет.
|
Основными методами являются
| Rotate
|
Получить фигуру близнец. (GetTwinFigure)
Если фигура близнец есть (TwinConstructor<>nil)
то создаем фигуру близнец на основе своих параметров TwinConstructor.CreateTwin
проверяем не залазит ли созданная фигура на клетки занятые другими фигурами Twin.CheckEach
Если не залазит то
Очистить все клетки занятые текущей фигурой (ClearCurrent)
Нарисовать во все клетки фигуры близнеца (Twin.MakeCurrent)
Возвратить как результат выполнения функции созданного близнеца (Rotate:=Twin)
Освободить ресурсы занятые текущей фигурой (Free)
Иначе если залазит то удалить созданного близнеца (Twin.Free)
Возвратить как результат выполнения функции себя, так поворот не удался и фигура падает в прежнем виде (Rotate:=self)
|
| CanDown
|
Проверить не выходит ли нижняя граница фигуры за пределы поля (Ybase>DownLimit) и проверить не попадают ли в случае перемещения вниз клетки данной фигуры на клетки другой фигуры CheckEach(IsEmptyCell,Xbase,Ybase-1)
|
| Down
|
Очистить все клетки занятые фигурой (ClearCurrent)
Уменьшить координату по Y базовой точки
Нарисовать во все клетки фигуры (MakeCurrent)
|
| Move
|
Если движение фигуры налево
Проверить не выходит ли левая граница фигуры за пределы поля (Xbase>LeftLimit) и проверить не попадают ли в случае перемещения клетки данной фигуры на клетки другой фигуры CheckEach(IsEmptyCell,Xbase-1,Ybase)
Если не попадает то
Очистить все клетки занятые фигурой (ClearCurrent)
Уменьшить координату по X базовой точки
Нарисовать во все клетки фигуры (MakeCurrent)
Если движение фигуры направо
Проверить не выходит ли правая граница фигуры за пределы поля (Xbase<AField.FieldCountX-RightLimit-1) и проверить не попадают ли в случае перемещения клетки данной фигуры на клетки другой фигуры CheckEach(IsEmptyCell,Xbase+1,Ybase)
Если не попадает то
Очистить все клетки занятые фигурой (ClearCurrent)
Увеличить координату по X базовой точки
Нарисовать во все клетки фигуры (MakeCurrent)
|
| MakeCurrent
|
Для всех клеток принадлежащих фигуре вызвать метод по рисованию ячейки (FillCell)
|
| ClearCurrent
|
Для всех клеток принадлежащих фигуре вызвать метод по стиранию ячейки (ClearCell)
|
Используются следующие потомки класса TBaseFigure
| TOneCellFigure
|
Одноклеточная фигура
|
| TBombFigure
|
Бомба
|
| TBombFigureExtra
|
Бомба-2
|
| TTwoCellFigureH
|
Двухклеточная фигура расположенная горизонтально
|
| TTwoCellFigureV
|
Двухклеточная фигура расположенная вертикально
|
| TThreeCellFigure13
|
Трехклеточная прямая фигура расположенная горизонтально
|
| TThreeCellFigure20
|
Трехклеточная прямая фигура расположенная вертикально
|
| TThreeCellFigure12
|
Трехклеточный уголок. Соответствие цифр расположению фигуры на площади следующее:
0
3 1
2
|
| TThreeCellFigure23
|
| TThreeCellFigure30
|
| TThreeCellFigure01
|
| TFourCellBend0145
|
Четырехклеточный изгиб извилистая дорога. Соответствие цифр расположению фигуры на площади следующее: 0 1 2
3 4 5
6 7 8
|
| TFourCellBend1436
|
| TFourCellBend0347
|
| TFourCellBend3412
|
| TFourCellG1036
|
Четырехлеточная фигура типа буквы L или Г. Соответствие цифр расположению фигуры на площади следующее: 0 1 2
3 4 5
6 7 8
|
| TFourCellG1476
|
| TFourCellG0125
|
| TFourCellG0345
|
| TFourCellG0147
|
| TFourCellG0367
|
| TFourCellG3012
|
| TFourCellG3452
|
| TFourCellT0
|
Четырехлеточная фигура типа буквы Т. Соответствие цифр расположению выпирающей клетки фигуры на площади следующее:0
3 1
2
|
| TFourCellT1
|
| TFourCellT2
|
| TFourCellT3
|
| TFourCellFigureH
|
Четырехклеточная прямая фигура расположенная горизонтально
|
| TFourCellFigureV
|
Четырехклеточная прямая фигура расположенная вертикально
|
| TFourCellBox
|
Квадрат 2х2
|
Перекрытие виртуальных методов для реализации конкретной фигуры (например TThreeCellFigure23) осуществляется следующим образом:
| AfterInit
|
LeftLimit:=1
DownLimit:=1
|
Установка значений отступов для данной фигуры. влево на единицу и вниз на единицу
|
| CheckEach
|
Proc(Xabs,Yabs-1)and Proc(Xabs,Yabs)and
Proc(Xabs-1,Yabs)
|
Вызов процедуры Proc для конретных ячеек. Обычно вызываются процедуры для этих ячеек по рисованию, стиранию, проверки отсутствия в данной ячейке другой фигуры.
Для данной фигуры ячейками относящимися к данной фигуре являются ячейки расположенные относительно базовой
1) на одну ниже по Y,
2) в том же месте что и базовая
3) на одну левее по X
|
| GetTwinFigure
|
if AlongClock then
GetTwinFigure:=TThreeCellFigure30
else
GetTwinFigure:=TThreeCellFigure12
|
Если вращение вдоль часовой стрелки то фигурой-близнецом будет TThreeCellFigure30 
Если против часовой то TThreeCellFigure12 
|
| SetBaseCell
|
Cell.Color:=RandomColors[25];
Cell.TextureNum:=26
|
Установка определенных значений для текста и текстуры фигуры данного типа
|
Для остальных фигур перекрытие осуществляется аналогично.
TOptionsForm
- класс формы настроек. Включает в себя такие объекты как:
| MainPageControl;
|
Закладки (TPageControl*)
|
Расположен на форме настроек, включает в себя закладки (tabFigures)
|
| tabFigures
|
Закладка (TTabSheet*)
|
Расположена на MainPageControl, содержит на себе (FiguresListView)
|
| FiguresListView
|
Просмотр списков (TListView*)
|
Предназначен для отображения списка фигур используемых в проекте и расстановки им свойства разрешения использования при генерации
|
| FiguresImageList
|
список изображений (TImageList*)
|
Содержит список изображений используемый списком (FiguresListView) для отображения пиктограмм фигур
|
(* - помечены стандартные объекты Delphi)
методы:
| InitData
|
Помещает данные о разрешенных фигурах в список, отображаемый на форме
|
| DoneData
|
Берет данные о разрешенных фигурах из списка, отображаемого на форме
|
TFigureInfo
- запись содержащая информацию о фигуре используемой при случайной генерации
| Fig
|
TFigure
|
Тип одной из существующих фигур
|
| Enabled
|
Boolean
|
Определяет разрешено ли создание данной фигуры
|
| FigureHint
|
string
|
Наименование фигуры, для отображения в форме настроек. Если пусто фигура самостоятельно не отображется, а считается что она является близнецом для описанной выше
|
| Icon
|
integer
|
Индекс иконки в списке иконок для отображения в форме настроек
|
TFigureEnumManager
- класс управляющий массивом записей типа TFigureInfo. Включает в себя следующие методы:
| GetExistingFigure(Index:integer)
|
Получение информации об определенной фигуре
|
| LoadFiguresInfo(Reg:TRegistryDef)
|
Запись в реестр (registry) для сохранения настроек между сеансами работы
|
| SaveFiguresInfo(Reg:TRegistryDef)
|
Чтение из реестра
|
| GetIndexByName(const Name:ShortString)
|
Получение индекса фигуры в массиве по ее имени
|
| GetAmount
|
Получение общего числа фигур в массиве
|
| CreateRandomFigure
|
Получение фигуры случайным образом
|
|
