Реферат: Помощь в обучении программированию

Наше предложение для тех, кто хочет научиться программировать на 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 Получение фигуры случайным образом