15 pyzzle 2025

Pyzzle 15, игра известная в нашей стране, как «Пятнашки». «Пятнашки» – это логическая игра-головоломка. Цель игры – упорядочить пронумерованные плитки на игровом поле размером 4Х4 клетки.

Пишем компьютерную версию игры на языке программирования Python с использованием библиотеки Pygame Zero.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""

pgzrun.go()      # Запускается главный игровой цикл

Лист. 1. Подключаем библиотеку pgzrun (pygame) и запускаем главный игровой цикл.

В программе листинг 1 метод filterwarnings из библиотеки warnings устраняет сообщение о не оптимально скомпилированной для вашего компьютера библиотеке pgzrun (pygame).  Функция go() из библиотеки pgzrun запускает главный игровой цикл.

Рис. 1. Окно, созданное программой листинг 1.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    pass


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    pass


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()      # Запускается главный игровой цикл

Лист. 2. В программу добавлены функции, периодически запускаемые из цикла в функции pgzrun().

Если вы в своей программе создадите функции с именами draw, on_mouse_down, on_key_down и некоторые другие функции, то эти функции будут вызываться (запускаться на выполнение) автоматически, так как их вызовы прописаны в функции pgzrun.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    pass


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 3. В программу добавлены 3 глобальные константы и добавлена функция очистки экрана в определение функции draw.

Обратите внимание, у функции draw в программе листинг 3 появился функционал. В функцию draw добавлен метод fill объекта screen. Fill (заливка) очищает screen (экран), заливая окно сгенерированное программой определённым цветом.

  • Обязательные глобальные переменные которые использует функция pgzrun:
    • WIDTH = 800 # Ширина окна (обязательно)
    • HEIGHT = 600 # Высота окна (обязательно)
    • TITLE = "Game" # Заголовок окна (рекомендуется)
  • Основные функции, которые вызывает pgzrun:
    • Отрисовка:
      • def draw(): # Вызывается каждый кадр (60 FPS)
      • def draw(): # или с параметром (редко используется)
    • Обработка ввода:
      • def on_mouse_down(pos): # Нажатие кнопки мыши
      • def on_mouse_up(pos): # Отпускание кнопки мыши
      • def on_mouse_move(pos): # Движение мыши
      • def on_key_down(key): # Нажатие клавиши
      • def on_key_up(key): # Отпускание клавиши
    • Игровой цикл:
      • def update(): # Вызывается каждый кадр ДО draw()
      • def update(dt): # С параметром delta-time
    • Дополнительные возможности:
      • Акторы (спрайты):# Создание акторов
        • actor = Actor('image_name') # Загружает image_name.png
        • actor.pos = (100, 100) # Позиция актора. pgzrun автоматически отрисует всех созданных акторов
      • Звуки:
        • sounds.sound_name.play() # Воспроизводит sound_name.wav
      • Таймеры:
        • clock.schedule(func, delay) # Вызов функции через delay секунд
        • clock.schedule_interval(func, interval) # Периодический вызов

Рис. 2. Окно, созданное программой листинг 3.

В программе листинг 3 мы создали глобальную константу BACKGROUND_COLOR со значением "khaki". Эту константу, в качестве параметра получает функция fill в определении функции draw. Функция fill интерпретирует значение "khaki" строкового типа, как цвет и использует этот цвет для заливки окна.

В программах с графическим интерфейсом, написанных на  Python, чаще всего, мы можем использовать коды цветов или их строковые значения из таблицы 1.

Образец Код Название CSS Название
          #F0F8FF aliceblue блекло-голубой
         #FAEBD7 antiquewhite античный белый
     #00FFFF aqua синий
          #7FFF00 chartreuse фисташковый
          #F5F5DC azure лазурь
          #F5F5DC beige бежевый
          #FFE4C4 bisque бисквитный
          #FFF8DC cornsilk темно-зеленый
       #FFEBCD blanchedalmond светло-кремовый
       #0000FF blue голубой
       #8A2BE2 blueviolet светло-фиолетовый
       #B8860B darkgoldenrot темный красно-золотой
       #006400 darkgreen темно-зеленый
       #8B008B darkmagenta темный фуксин
       #FF8C00 darkorange темно-оранжевый
    #8B0000 darkred темно-красный
    #8FBC8F darkseagreen темный морской волны
    #2F4F4F darkslategray темный сине-серый
    #9400D3 darkviolet темно-фиолетовый
    #00BFFF deepskyblue темный небесно-голубой
    #1E90FF dodgerblue тускло-васильковый
    #FFFAF0 floralwhite цветочно-белый
    #FF00FF fuchsia фуксии
    #DCDCDC gainsboro гейнсборо
    #DAA520 goldenrod красного золота
    #008000 green зеленый
    #F0FFF0 honeydew свежего меда
    #CD5C5C indianred ярко-красный
    #FFFFF0 ivory слоновой кости
    #E6E6FA lavender бледно-лиловый
    #7CFC00 lawngreen зеленой лужайки
    #ADD8E6 lightblue светло-голубой
    #E0FFFF lightcyan светло-циановый
    #90EE90 lightgreen светло-зеленый
    #FFB6C1 lightpink светло-розовый
    #20B2AA lightseagreen светлый морской волны
    #778899 lightslategray светлый сине-серый
    #FFFFE0 lightyellow светло-желтый
    #32CD32 limegreen зеленовато-известковый
    #FF00FF фуксин blanchedalmond
    #66CDAA mediumaquamarine умеренно-аквамариновый
    #3CB371 mediumseagreen умеренный морской волны
    #BA55D3 mediumorchid умеренно-орхидейный
    #00FA9A mediumspringgreen умеренный сине-серый
    #0C71585 mediumvioletred умеренный красно-фиолетовый
    #0F5FFFA mintcream мятно-кремовый
    #FFE4B5 moccasin болотный
    #000080 navy морской
    #808000 olive оливковый
    #FFA500 orange оранжевый
    #DA70D6 orchid орхидейный
    #98FB98 palegreen бледно-зеленый
    #DB7093 palevioletred бледный красно-фиолетовый
    #FFDAB9 peachpuff персиковый
    #FFC0CB pink розовый
    #B0E0E6 powderblue туманно-голубой
    #FF0000 red красный
    #4169E1 royalblue королевский голубой
    #FA8072 salmon оранжево-розовый
    #2E8B57 seagreen морской зеленый
    #A0522D sienna охра
        #87CEEB skyblue небесно-голубой
        #708090 slategray сине-серый
        #00FF7F springgreen весенне-зеленый
        #D2B48C tan желто-коричневый
        #D8BFD8 thistle чертополоха
        #40E0D0 turquoise бирюзовый
        #F5DEB3 wheat пшеничный
        #F5F5F5 whitesmoke белый дымчатый
        #9ACD32 yellowgreen желто-зеленый
          #A52A2A brown коричневый
         #DEB887 burlywood старого дерева
     #5F9EA0 cadetblue блеклый серо-голубой
          #FF7F50 coral коралловый
          #D2691E chocolate шоколадный
          #6495ED cornflowerblue васильковый
          #000000 black черный
          #DC143C crimson малиновый
       #00FFFF cyan циан
       #00008B darkblue темно-голубой
       #008B8B darkcyan темный циан
    #A9A9A darkgray темно-серый
       #BDB76B darkkhaki темный хаки
       #556B2F darkolivegreen темно-оливковый
    #9932CC darkorchid темно-орхидейный
    #E9967A darksalmon темно-оранжево-розовый
    #483D8B darkslateblue темный сине-серый
    #00CED1 darkturqueise темно-бирюзовый
    #FF1493 deeppink темно-розовый
    #696969 dimgray тускло-серый
    #B22222 firebrick огнеупорного кирпича
    #228B22 forestgreen лесной зеленый
    #F8F8FF ghostwhite туманно-белый
    #FFD700 gold золотой
    #808080 gray серый
    #ADFF2F greenyellow желто-зеленый
    #FF69B4 hotpink ярко-розовый
    #4B0082 indigo индиго
    #F0E68C khaki хаки
    #FFF0F5 lavenderblush бледный розово-лиловый
    #FFFACD lemonchiffon лимонный
    #F08080 lightcoral светло-коралловый
    #FAFAD2 lightgoldenrodyellow светлый золотисто-желтый
    #D3D3D3 lightgrey светло-серый
    #FFA07A lightsalmon светлый оранжево-розовый
    #87CEFA lightskyblue светлый небесно-голубой
    #B0C4DE lightsteelblue светло-стальной
    #00FF00 lime цвета извести
    #FAF0E6 linen льняной
    #800000 maroon оранжево-розовый
    #0000CD mediumblue умеренно-голубой
    #7B68EE mediumslateblue умеренный серо-голубой
    #9370DB mediumpurple умеренно-пурпурный
    #48D1CC mediumturquose умеренно-бирюзовый
    #191970 midnightblue полуночный синий
    #FFE4E1 mistyrose туманно-розовый
    #FFDEAD navajowhite грязно-серый
    #FDF5E6 oldlace старого коньяка
    #6B8E23 olivedrab
    #FF4500 orangered оранжево-красный
    #EEE8AA palegoldenrod бледно-золотистый
    #AFEEEE paleturquoise бледно-бирюзовый
    #FFEFD5 papayawhip дынный
    #CD853F peru коричневый
    #DDA0DD plum сливовый
    #800080 purple пурпурный
    #BC8F8F rosybrown розово-коричневый
    #8B4513 saddlebrown старой кожи
    #F4A460 sandybrown рыже-коричневый
    #FFF5EE seashell морской пены
    #C0C0C0 silver серебристый
        #6A5ACD slateblue серо-голубой
        #FFFAFA snow снежный
        #4682B4 steelblue сине-стальной
        #008080 teal чайный
        #FF6347 tomato томатный
        #EE82EE violet фиолетовый
        #FFFFFF white белый
        #FFFF00 yellow желтый
        #7FFFD4 aquamarine аквамарин

Табл. 1. Таблица цветов с кодами и названиями, которые применимы в Python с библиотекой Pygame, pgzrun. Каждый раз, когда в результате действий игрока или игрового алгоритма ситуация на игровом поле меняется, программа должна перерисовать игровое поле и тем самым привести его в соответствие сложившейся игровой ситуации. Для этой цели в библиотеке pgzrun, в соответствии с определённым алгоритмом, вызывается функция draw. В нашей программе, функция draw должна:

  • очистить окно программы (игровое поле)
  • нарисовать сетку игрового поля
  • вывести в клетки на сетке числа в соответствии с игровой ситуацией
  • вывести дополнительную текстовую информацию, если это требуется

В программе листинг 4 мы предусмотрели весь этот функционал.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    pass


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    pass


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    pass


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 4. В программу добавлены определения функций draw_grid(), draw_numbers(), draw_text() и их вызов из функции draw().

В программе листинг 4 созданы прототипы (определения) нужных нам функций, но не прописаны их тела. Так как в Python функция не может быть создана без тела, временно, в тело новых функций запишем оператор pass, который ничего не делает.

Теперь приступим к разработке этих функций и начнём с функции draw_grid.

def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    screen.draw.line((125,0),(125,500), "dimgray")      # вертикальная линия
    screen.draw.line((250,0),(250,500), "dimgray")      # вертикальная линия
    screen.draw.line((375,0),(375,500), "dimgray")      # вертикальная линия
    screen.draw.line((0,125),(500,125), "dimgray")      # горизонтальная линия
    screen.draw.line((0,250),(500,250), "dimgray")      # горизонтальная линия
    screen.draw.line((0,375),(500,375), "dimgray")      # горизонтальная линия

Определение функции draw_grid.

Чтобы код нашей программы легче было разрабатывать, а в дальнейшем поддерживать, желательно параметры, используемые в методе draw.line в функции draw_grid определить как глобальные константы и использовать имена этих констант.

# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    screen.draw.line((CELL_SIZE,0),(CELL_SIZE,HEIGHT), GRID_COLOR)          # вертикальная линия
    screen.draw.line((CELL_SIZE*2,0),(CELL_SIZE*2,HEIGHT), GRID_COLOR)      # вертикальная линия
    screen.draw.line((CELL_SIZE*3,0),(CELL_SIZE*3,HEIGHT), GRID_COLOR)      # вертикальная линия
    screen.draw.line((0,CELL_SIZE),(WIDTH,CELL_SIZE), GRID_COLOR)           # горизонтальная линия
    screen.draw.line((0,CELL_SIZE*2),(WIDTH,CELL_SIZE*2), GRID_COLOR)       # горизонтальная линия
    screen.draw.line((0,CELL_SIZE*3),(WIDTH,CELL_SIZE*3), GRID_COLOR)       # горизонтальная линия

Определение некоторых глобальных констант и функции draw_grid.

Циклы позволяют существенно сократить количество  строк повторяющегося кода. В выше приведённом варианте функции draw_grid, желательно для этой цели использовать цикл.

В Python мы можем использовать цикл for или цикл while. Цикл for, чаще используется когда известно количество повторений тела цикла, а цикл while используют тогда, когда количество повторений тела цикла заранее не известно.

Функция draw_grid должна нарисовать на игровом поле три горизонтальные и три вертикальные линии. Если тело цикла будет состоять из двух строк одна из которых будет рисовать горизонтальные линии, а вторая - вертикальные, то цикл должен будет повторить эти действия три раза. Следовательно нам подойдёт цикл for.

Цикл for и функция range.

for n in range(0,10,1):
    print(n, end='; ')

Пример использования цикла for и функции range.

0; 1; 2; 3; 4; 5; 6; 7; 8; 9;

Результат работы программы с циклом. 

for n in range(0,500,125):
    print(n, end='; ')

Пример использования цикла for и функции range применимый в нашей программе.

0; 125; 250; 375;

Результат работы программы с циклом.  Так как WIDTH=500, а CELL_SIZE=125, заменим числовые значения параметров функции range соответствующими им константами. Эти значения, посредством переменной цикла n, могут быть использованы в качестве параметров в методе screen.draw.line().

for n in range(0, WIDTH, CELL_SIZE):
    print(n)

Этот цикл работает так же, как и предыдущий, но теперь при изменении значения константы WIDTH в начале программы изменится размер окна игрового поля и пропорционально ему изменится и размер сетки на игровом поле. Так же, изменение значения константы SIZE приведёт к перерасчёту константы CELL_SIZE, что приведёт к изменению числа линий сетки на игровом поле.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    pass


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    pass


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 5. В программе в функции draw_grid для создания сетки на игровом поле используется цикл.

Рис. 3. Окно, созданное программой листинг 5.

Приступим к разработке функции draw_numbers.

Функция draw_numbers выводит в клетках игрового поля числа, соответствующие игровой ситуации. В нашей программе состояние игры в любой момент времени может быть определено порядком чисел от 1 до 15 включительно и положением пустой клетки между ними или перед ними или после них. Следовательно, хранить и менять состояние игры мы сможем используя структуру из 16 элементов.

В языке Python определён тип данных список. Список в Python — это последовательность значений любого типа. Создаётся список в квадратных скобках путём перечисления значений элементов списка через запятую.

В нашей игре, для хранения  чисел от 1 до 15 включительно и пустой клетки в виде строки с пробелом будем использовать список. Причём, любой элемент этого списка в процессе игры может перемещаться. Порядок элементов этого списка определяет положение цифр и пробела на игровом поле. Присвоим переменной с именем playground значение этого списка.

playground = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, ' ']

Список playground, порядок элементов в котором соответствует порядку чисел на игровом поле.

Более гибким будет способ создания списка из числовой последовательности с помощью функции range.

Функция range(start, stop, step) создаёт диапазон из целых. Начало диапазона задаётся параметром start включительно, конец диапазона задаётся параметром stop, причём, само значение stop не включается в диапазон. Третий параметр функции range задаёт шаг в последовательности чисел. Первый и третий параметры функции range не обязательны. В случае, если эти параметры не указаны, start = 0, step = 1.

В нашей программе мы можем создать список playground используя функцию range, а также функцию list которая преобразует диапазон range в список.

playground = list(range(1, 16)) + [' ']

Так как в списке playground кроме элементов представляющих числовую последовательность присутствует символ пробела - элемент строкового типа, мы применили оператор +. В случае, когда аргументами операции + являются списки, операция + объединяет эти списки.

Программа будет более универсальной, если мы в функции range в качестве правой границы диапазона будем использовать вместо числа 16 константу SIZE в квадрате.

playground = list(range(1, SIZE**2)) + [' ']

Теперь, если мы изменим константу SIZE, изменится и размер виртуального игрового поля playground.

Определим цвет чисел на игровом поле.

DIGITS_COLOR = 'sienna'                         # цвет цифр

Константа DIGITS_COLOR будет определять цвет цифр.

Можно приступить к созданию тела функции  draw_numbers которая должна выводить в клетках игрового поля цифры из списка playground.

Метод screen.draw.text() в библиотеке pgzrun предназначен для вывода текста в окно программы. При вызове метода screen.draw.text() нужно указать текст и позицию. В параметр text можно передать только строковый объект str.

кроме того, можно указать следующие дополнительные параметры:

  • fontname — название шрифта (системного или в папке fonts);
  • fontsize — размер шрифта;
  • antialias — сглаживать шрифт или нет;
  • color — цвет в виде «red», (255, 0, 0) или «#ff0000»;
  • background — цвет фона;
  • width — жёсткое указание ширины прямоугольника с текстом в пикселях;
  • lineheight — высота строки, по умолчанию 1.0;
  • align — выравнивание текста внутри прямоугольника;
  • owidth — ширина обводки;
  • ocolor — цвет обводки;
  • shadow — сдвиг тени по X и Y, например, (0.2, 0.5);
  • scolor — цвет тени;
  • gcolor — цвет градиента;
  • alpha — степень прозрачности слоя с текстом;
  • anchor — смещение якорной точки в долях от размера прямоугольника;
  • angle — угол поворота текста.

В нашей программе в функции draw_numbers для вывода первого числа из списка playground в первую клетку игрового поля применим следующий код:

x = CELL_SIZE // 2
y = CELL_SIZE // 2
text = str(playground[0])
screen.draw.text(str(playground[0]), center=(x, y), color = DIGITS_COLOR, fontsize = DIGITS_SIZE)

Создадим переменную dig_params значением которой будет словарь, содержащий параметры color и fontsize. Это сделает код более удобным для дальнейшей работы.

dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
x = CELL_SIZE // 2
y = CELL_SIZE // 2
text = str(playground[0])
screen.draw.text(str(playground[0]), center=(x, y), **dig_params)

При использовании переменной dig_params в качестве параметра метода screen.draw.text() мы используем ** для распаковки словаря.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    pass


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 6.

Рис. 4.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    playground[n], playground[m] = playground[m], playground[n]


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    play(xy_to_n(*pos))                         # сделать ход


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 7.

Рис. 5.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    play(xy_to_n(*pos))                         # сделать ход


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    pass


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 8. В функцию play добавлена проверка выбранного хода на соответствие правилам игры.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    play(xy_to_n(*pos))                         # сделать ход


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            play(n)
            counter -= 1


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 9.

Рис. 6.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]
        return True                             # если сделан ход
    return False                                # ходить было невозможно


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    play(xy_to_n(*pos))                         # сделать ход


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 10. Теперь функция play возвращает значение True или False, и это значение используется в функции on_key_down при перемешивании фишек.

В начале игры или в процессе игры когда фишки с числами упорядочены, необходимо запретить игроку ходить пока он не нажмёт на клавишу "пробел" и не перемешает фишки случайным образом.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def in_order():
    """
    Проверка порядка цифр
    """
    if playground == list(range(1, SIZE**2)) + [' ']:
        return True
    return False


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]
        return True                             # если сделан ход
    return False                                # ходить было невозможно


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    if in_order():              # невозможно сделать ход пока цифры упорядочены
        return
    play(xy_to_n(*pos))                         # сделать ход


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 11. Добавлена функция in_order.

Добавим глобальный счётчик ходов. Пусть счётчик обнуляется когда игрок нажимает на клавишу пробел и тем самым перемешивает фишки с числами.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun, pygame
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле
counter = 0                                     # счётчик ходов


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    pass


def in_order():
    """
    Проверка порядка цифр
    """
    if playground == list(range(1, SIZE**2)) + [' ']:
        return True
    return False


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]
        return True                             # если сделан ход
    return False                                # ходить было невозможно


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    draw_text()                                 # показать текстовую информацию
    pygame.display.set_caption(TITLE)           # обновление заголовка


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    global counter, TITLE
    if in_order():              # невозможно сделать ход пока цифры упорядочены
        return
    if play(xy_to_n(*pos)):                     # сделать ход
        counter += 1                            # увеличиваем счётчик ходов
        TITLE = "Ход № " + str(counter)         # обновляем заголовок окна


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    global counter, TITLE
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1
        TITLE = "Головоломка 15"                # обновляем заголовок окна


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 12. Добавлена библиотека pygame и глобальная переменная counter. Изменились функции draw, on_mouse_down и on_key_down.

Рис. 7. Обратите внимание, в заголовке окна выводится значение счётчика ходов.

В начале игры или в процессе игры когда фишки с числами упорядочены, игроку ходить запрещено, пока он не нажмёт на клавишу "пробел" и не перемешает фишки случайным образом. В это время, на игровом поле должна отображаться подсказка "Клавиша пробел - Старт".

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun, pygame
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
FONT_COLOR = 'olive'                            # Цвет шрифта сообщений
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле
counter = 0                                     # счётчик ходов


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    fnt_params = {'color': FONT_COLOR,'fontsize': DIGITS_SIZE // 2}
    screen.draw.text("Клавиша", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 30), **fnt_params)
    screen.draw.text("пробел-", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 50),  **fnt_params)
    screen.draw.text("Старт", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 70),  **fnt_params)


def in_order():
    """
    Проверка порядка цифр
    """
    if playground == list(range(1, SIZE**2)) + [' ']:
        return True
    return False


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]
        return True                             # если сделан ход
    return False                                # ходить было невозможно


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    if in_order():                              # если числа упорядочены
        draw_text()                             # показать текстовую информацию
    pygame.display.set_caption(TITLE)           # обновление заголовка


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    global counter, TITLE
    if in_order():              # невозможно сделать ход пока цифры упорядочены
        return
    if play(xy_to_n(*pos)):                     # сделать ход
        counter += 1                            # увеличиваем счётчик ходов
        TITLE = "Ход № " + str(counter)         # обновляем заголовок окна


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    global counter, TITLE
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1
        TITLE = "Головоломка 15"                # обновляем заголовок окна


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 13.

В программе листинг 13 появилась глобальная переменная FONT_COLOR - цвет шрифта сообщений.

Функция draw_text теперь выводит в 16-ю клетку игрового поля сообщение "Клавиша пробел - Старт".

Функция  функция draw изменилась таким образом, что функция draw_text теперь запускается если функция in_order возвращает значение True.

Рис. 8. Функция draw_text() выводит в 16-ю клетку игрового поля сообщение "Клавиша пробел - Старт".

Теперь нам не хватает сообщения о победе. Создадим функцию draw_win и будем вызывать её из функции draw в случае, если числа на игровом поле упорядочены, а счётчик ходов не равен 0.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun, pygame
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
DIGITS_COLOR = 'sienna'                         # цвет цифр
FONT_COLOR = 'olive'                            # Цвет шрифта сообщений
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле
counter = 0                                     # счётчик ходов


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    fnt_params = {'color': FONT_COLOR,'fontsize': DIGITS_SIZE // 2}
    screen.draw.text("Клавиша", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 30), **fnt_params)
    screen.draw.text("пробел-", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 50),  **fnt_params)
    screen.draw.text("Старт", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 70),  **fnt_params)


def draw_win():
    """
    Выводит на игровое поле сообщение:
    ПОБЕДА!
    """
    x = CELL_SIZE + 1                                               # координата x верхнего левого угла
    y0 = 2 * CELL_SIZE                                              # координата y середины флага
    w = 2 * CELL_SIZE - 1                                           # ширина флага
    h = CELL_SIZE * 0.5                                             # высота секции флага
    screen.draw.filled_rect(Rect(x, y0 - h * 1.5, w, h), 'white')
    screen.draw.filled_rect(Rect(x, y0 - h // 2, w, h), 'blue')
    screen.draw.filled_rect(Rect(x, y0 + h // 2, w, h), 'red')
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    screen.draw.text("Победа!", center=(y0, y0 - h), **dig_params)


def in_order():
    """
    Проверка порядка цифр
    """
    if playground == list(range(1, SIZE**2)) + [' ']:
        return True
    return False


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]
        return True                             # если сделан ход
    return False                                # ходить было невозможно


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    if in_order():                              # если числа упорядочены
        draw_text()                             # показать текстовую информацию
    pygame.display.set_caption(TITLE)           # обновление заголовка
    if counter > 0 and in_order():              # если победа
        draw_win()                              # вывести сообщение Победа!


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    global counter, TITLE
    if in_order():              # невозможно сделать ход пока цифры упорядочены
        return
    if play(xy_to_n(*pos)):                     # сделать ход
        counter += 1                            # увеличиваем счётчик ходов
        TITLE = "Ход № " + str(counter)         # обновляем заголовок окна


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    global counter, TITLE
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1
        TITLE = "Головоломка 15"                # обновляем заголовок окна


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 14. Создана функция draw_win

Рис. 9.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun, pygame
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
BORDER_COLOR = 'gold'                           # цвет бордюра
DIGITS_COLOR = 'sienna'                         # цвет цифр
FONT_COLOR = 'olive'                            # Цвет шрифта сообщений
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле
counter = 0                                     # счётчик ходов


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH+1, CELL_SIZE):                              # линии бордюра
        screen.draw.filled_rect(Rect(n-7, 0, 15, HEIGHT), BORDER_COLOR) # вертикальные
        screen.draw.filled_rect(Rect(0, n-7, WIDTH, 15), BORDER_COLOR)  # горизонтальные
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    fnt_params = {'color': FONT_COLOR,'fontsize': DIGITS_SIZE // 2}
    screen.draw.text("Клавиша", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 30), **fnt_params)
    screen.draw.text("пробел-", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 50),  **fnt_params)
    screen.draw.text("Старт", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 70),  **fnt_params)


def draw_win():
    """
    Выводит на игровое поле сообщение:
    ПОБЕДА!
    """
    x = CELL_SIZE + 1                                               # координата x верхнего левого угла
    y0 = 2 * CELL_SIZE                                              # координата y середины флага
    w = 2 * CELL_SIZE - 1                                           # ширина флага
    h = CELL_SIZE * 0.5                                             # высота секции флага
    screen.draw.filled_rect(Rect(x, y0 - h * 1.5, w, h), 'white')
    screen.draw.filled_rect(Rect(x, y0 - h // 2, w, h), 'blue')
    screen.draw.filled_rect(Rect(x, y0 + h // 2, w, h), 'red')
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    screen.draw.text("Победа!", center=(y0, y0 - h), **dig_params)


def in_order():
    """
    Проверка порядка цифр
    """
    if playground == list(range(1, SIZE**2)) + [' ']:
        return True
    return False


def play(n):
    """
    Делает ход из клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                   # индекс пустой клетки
    # если клетки n и m находятся по соседству в одном ряду или колонке
    if n in [m+1, m-1] and m // SIZE == n // SIZE or n in [m-SIZE, m+SIZE]:
        playground[n], playground[m] = playground[m], playground[n]
        return True                             # если сделан ход
    return False                                # ходить было невозможно


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    if in_order():                              # если числа упорядочены
        draw_text()                             # показать текстовую информацию
    pygame.display.set_caption(TITLE)           # обновление заголовка
    if counter > 0 and in_order():              # если победа
        draw_win()                              # вывести сообщение Победа!


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    global counter, TITLE
    if in_order():              # невозможно сделать ход пока цифры упорядочены
        return
    if play(xy_to_n(*pos)):                     # сделать ход
        counter += 1                            # увеличиваем счётчик ходов
        TITLE = "Ход № " + str(counter)         # обновляем заголовок окна


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    global counter, TITLE
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1
        TITLE = "Головоломка 15"                # обновляем заголовок окна


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 15. Изменена функция draw_grid.

Рис. 10.

import warnings
warnings.filterwarnings("ignore", category=RuntimeWarning, message=".*AVX2.*")
from random import choice                       # выбрать случайный элемент списка
import pgzrun, pygame
"""
Pygame Zero (pgzrun) - это обёртка над Pygame,
которая упрощает создание игр,
автоматизируя многие рутинные задачи.
"""


# Настройки игры, глобальные константы и переменные
TITLE = "Головоломка 15"                        # заголовок окна
WIDTH = HEIGHT = 500                            # ширина и высота окна
SIZE = 4                                        # размер игрового поля (4x4)
CELL_SIZE = WIDTH // SIZE                       # размер клетки
DIGITS_SIZE = int(CELL_SIZE / 2.2)              # размер цифр
BACKGROUND_COLOR = 'khaki'                      # цвет кнопки
GRID_COLOR = 'dimgray'                          # цвет сетки
BORDER_COLOR = 'gold'                           # цвет бордюра
DIGITS_COLOR = 'sienna'                         # цвет цифр
FONT_COLOR = 'olive'                            # Цвет шрифта сообщений
playground = list(range(1, SIZE**2)) + [' ']    # виртуальное игровое поле
counter = 0                                     # счётчик ходов


def draw_grid():
    """
    Рисует игровое поле в клетку
    """
    for n in range(0, WIDTH+1, CELL_SIZE):                              # линии бордюра
        screen.draw.filled_rect(Rect(n-7, 0, 15, HEIGHT), BORDER_COLOR) # вертикальные
        screen.draw.filled_rect(Rect(0, n-7, WIDTH, 15), BORDER_COLOR)  # горизонтальные
    for n in range(0, WIDTH, CELL_SIZE):                        # линии сетки
        screen.draw.line((n, 0), (n, HEIGHT), GRID_COLOR)       # вертикальные линии
        screen.draw.line((0, n), (WIDTH, n), GRID_COLOR)        # горизонтальные линии


def xy_to_n(x, y):
    """
    Конвертирует пару координат x, y в номер клетки
    """
    col = x // (WIDTH // SIZE)
    row = y // (HEIGHT // SIZE)
    return row * SIZE + col


def draw_numbers():
    """
    Выводит в клетках игрового поля цифры,
    соответствующие игровой ситуации
    """
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    for x in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
        for y in range(CELL_SIZE // 2, WIDTH, CELL_SIZE):
            n = xy_to_n(x, y)
            screen.draw.text(str(playground[n]), center=(x, y), **dig_params)


def draw_text():
    """
    Выводит на игровое поле текстовую информацию,
    приглашение к началу игры:
    Клавиша пробел - Старт
    """
    fnt_params = {'color': FONT_COLOR,'fontsize': DIGITS_SIZE // 2}
    screen.draw.text("Клавиша", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 30), **fnt_params)
    screen.draw.text("пробел-", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 50),  **fnt_params)
    screen.draw.text("Старт", (WIDTH - CELL_SIZE + 20, HEIGHT - CELL_SIZE + 70),  **fnt_params)


def draw_win():
    """
    Выводит на игровое поле сообщение:
    ПОБЕДА!
    """
    x = CELL_SIZE + 1                                               # координата x верхнего левого угла
    y0 = 2 * CELL_SIZE                                              # координата y середины флага
    w = 2 * CELL_SIZE - 1                                           # ширина флага
    h = CELL_SIZE * 0.5                                             # высота секции флага
    screen.draw.filled_rect(Rect(x, y0 - h * 1.5, w, h), 'white')
    screen.draw.filled_rect(Rect(x, y0 - h // 2, w, h), 'blue')
    screen.draw.filled_rect(Rect(x, y0 + h // 2, w, h), 'red')
    dig_params = {'color': DIGITS_COLOR,'fontsize': DIGITS_SIZE}    # цвет и размер цифр
    screen.draw.text("Победа!", center=(y0, y0 - h), **dig_params)


def in_order():
    """
    Проверка порядка цифр
    """
    if playground == list(range(1, SIZE**2)) + [' ']:
        return True
    return False


def play(n):
    """
    Сдвигает строку или колонку начиная клетки с номером n
    в пустую клетку, если это возможно!
    """
    m = playground.index(' ')                                           # индекс пустой клетки
    step = 0                                                            # Шаг и направление
    if m // SIZE == n // SIZE:                                          # m и n в одной строке
        step = -1                                                       # пустая клетка справа
        if m < n:                                                       # пустая клетка слева
            step = 1
    if m % SIZE == n % SIZE:                                            # m и n в одной колонке
        step = -SIZE                                                    # пустая клетка снизу
        if m < n:                                                       # пустая клетка сверху
            step = SIZE
    if step != 0:
        for i in range(m, n, step):
            playground[i], playground[i+step] = playground[i+step], playground[i]   # ход
        return True
    return False


def draw():
    """
    draw() особая функция, вызывается автоматически каждый кадр,
    обычно, 60 FPS. Доступны объекты: screen, actors и др.
    Назначение: отрисовка всего, что должно быть на экране.
    """
    screen.fill(BACKGROUND_COLOR)               # очистка экрана
    draw_grid()                                 # нарисовать клетки
    draw_numbers()                              # вывести цифры
    if in_order():                              # если числа упорядочены
        draw_text()                             # показать текстовую информацию
    pygame.display.set_caption(TITLE)           # обновление заголовка
    if counter > 0 and in_order():              # если победа
        draw_win()                              # вывести сообщение Победа!


def on_mouse_down(pos):
    """
    on_mouse_down(pos) особая функция, вызывается автоматически при клике мыши
    Через параметр pos в функцию передаётся кортеж из пары координат (x, y)
    """
    global counter, TITLE
    if in_order():              # невозможно сделать ход пока цифры упорядочены
        return
    if play(xy_to_n(*pos)):                     # сделать ход
        counter += 1                            # увеличиваем счётчик ходов
        TITLE = "Ход № " + str(counter)         # обновляем заголовок окна


def on_key_down(key):
    """
    on_key_down(pos) особая функция, вызывается автоматически при нажатии
    клавиши на клавиатуре. Через параметр key в функцию передаётся
    код нажатой клавиши.
    """
    global counter, TITLE
    if key == keys.SPACE :                      # выбор кнопки Старт -> "Пробел"
        counter = 1000                          # количество перемешиваний
        while(counter != 0):
            n = choice(range(SIZE**2))          # выбор случайного хода
            if play(n):                         # если был сделан ход
                counter -= 1
        TITLE = "Головоломка 15"                # обновляем заголовок окна


pgzrun.go()                                     # Запускается главный игровой цикл

Лист. 16. Изменена функция play.