{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "260597ec",
   "metadata": {},
   "source": [
    "# 20-23 · Анимация спрайт-листов\n",
    "\n",
    "Практика к разделу [«Анимация спрайт-листов»](../../site/chapters/glava-20/20-23-animatsiya.html)."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "22fb949a",
   "metadata": {},
   "source": [
    "## Цель\n",
    "\n",
    "Переключать кадр анимации по собственному таймеру, а не каждый кадр цикла."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c7d32c86",
   "metadata": {},
   "source": [
    "## Про игровой цикл в этом ноутбуке\n",
    "\n",
    "В обычном `.py`-файле игровой цикл — это `while rabotaet:`, где `rabotaet` становится `False`, когда пользователь закрывает окно. В автоматически выполняемом ноутбуке некому закрыть окно, поэтому здесь мы прогоняем фиксированное число кадров через `for _ in range(N):` — логика каждого отдельного кадра (движение, отрисовка, `clock.tick()`) при этом точно такая же, как в настоящей игре."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e2c1df52",
   "metadata": {},
   "source": [
    "## Рабочий пример"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "163fb469",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-09-03T10:12:19.285799Z",
     "iopub.status.busy": "2026-09-03T10:12:19.285639Z",
     "iopub.status.idle": "2026-09-03T10:12:20.440385Z",
     "shell.execute_reply": "2026-09-03T10:12:20.439260Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "pygame-ce 2.5.8 (SDL 2.32.10, Python 3.14.6)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Кадр анимации сменился хотя бы раз: True\n",
      "Все значения кадра в допустимом диапазоне: True\n"
     ]
    }
   ],
   "source": [
    "import pygame\n",
    "\n",
    "pygame.init()\n",
    "screen = pygame.display.set_mode((600, 400))\n",
    "clock = pygame.time.Clock()\n",
    "\n",
    "KOLICHESTVO_KADROV = 4\n",
    "INTERVAL_KADRA = 0.1  # секунд на кадр анимации\n",
    "\n",
    "tekushij_kadr = 0\n",
    "vremya_animacii = 0.0\n",
    "istoriya_kadrov = []\n",
    "\n",
    "for _ in range(60):\n",
    "    dt = clock.tick(60) / 1000\n",
    "    vremya_animacii += dt\n",
    "    while vremya_animacii >= INTERVAL_KADRA:\n",
    "        vremya_animacii -= INTERVAL_KADRA\n",
    "        tekushij_kadr = (tekushij_kadr + 1) % KOLICHESTVO_KADROV\n",
    "    istoriya_kadrov.append(tekushij_kadr)\n",
    "\n",
    "print(\"Кадр анимации сменился хотя бы раз:\", len(set(istoriya_kadrov)) > 1)\n",
    "print(\"Все значения кадра в допустимом диапазоне:\", all(0 <= k < KOLICHESTVO_KADROV for k in istoriya_kadrov))\n",
    "pygame.quit()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "129dd14d",
   "metadata": {},
   "source": [
    "## Проверка результата"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "5b96253d",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2026-09-03T10:12:20.443386Z",
     "iopub.status.busy": "2026-09-03T10:12:20.443213Z",
     "iopub.status.idle": "2026-09-03T10:12:20.446382Z",
     "shell.execute_reply": "2026-09-03T10:12:20.445907Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Верно: анимация переключает кадры и никогда не выходит за пределы спрайт-листа.\n"
     ]
    }
   ],
   "source": [
    "assert len(set(istoriya_kadrov)) > 1\n",
    "assert all(0 <= k < KOLICHESTVO_KADROV for k in istoriya_kadrov)\n",
    "print(\"Верно: анимация переключает кадры и никогда не выходит за пределы спрайт-листа.\")"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Cartesian Python 3.14",
   "language": "python",
   "name": "cartesian-python314"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.14.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}