Skip to content

sprite_editor.md

Latest commit

 

History

History
170 lines (130 loc) · 5.82 KB

sprite_editor.md

File metadata and controls

170 lines (130 loc) · 5.82 KB

Sprite Editor (Редактор сцен)

Визуальный редактор игровых сцен в стиле Unity. Поддерживает модульные окна, drag-and-drop, Inspector, настройку камеры/сетки.

Запуск

python -m spritePro.cli --editor
python -m spritePro.cli -e
python -m spritePro.editor

Интерфейс

┌──────────────────────────────────────────────────────────────┐
│  File  GameObject  Tools  View                    Scene *   │
├────────┬───────────────────────────────┬────────────────────┤
│Objects │                               │ Properties          │
│  ● Player│       Viewport              │ Name: Player       │
│  ● Ground│   ┌──────────┐              │ Position X: [100] │
│  ○ Label │   │  Sprite  │              │ Scale X: [1.0]   │
│          │   └──────────┘              │ Sprite: player.png│
├────────┴───────────────────────────────┴────────────────────┤
│  X: 100  Y: 200  │  Zoom: 100%  │  Grid: 10px  │  Snap: ON │
└──────────────────────────────────────────────────────────────┘

Основные области

Область Описание
Toolbar File, GameObject, Tools, View, Run (F5)
Hierarchy Список объектов (● активен, ○ скрыт)
Inspector Свойства выделенного объекта
Viewport Область редактирования с сеткой
Statusbar Координаты мыши, Zoom, Grid, Snap

Инструменты

Клавиша Инструмент Описание
V Select Выделение объектов
G Move Перемещение
R Rotate Вращение (шаг 15°)
T Scale Масштабирование

Управление

Действие Управление
Zoom Колесо мыши
Pan Средняя кнопка мыши
Выделить Левый клик
Добавить к выделению Shift + клик
Удалить Delete / Backspace
Отменить Ctrl + Z
Повторить Ctrl + Y
Сохранить Ctrl + S
Запустить игру F5

Типы спрайтов

  • Image — изображение из файла
  • Rectangle — прямоугольник (кнопка Rect)
  • Circle — круг (кнопка Circle)
  • Ellipse — эллипс (кнопка Ellipse)

Drag & Drop

Перетащите PNG/JPG/BMP/GIF из проводника в viewport — спрайт добавится в позицию курсора.

Сохранение и загрузка

# Сохранение: Ctrl+S в редакторе → scene_name.json
# Загрузка в игру
from spritePro.editor.scene import Scene
scene = Scene.load("level1.json")

Интеграция с игрой

Рекомендуемый способ: spawn_scene

import spritePro as s
from spritePro.editor.runtime import spawn_scene

class LevelScene(s.Scene):
    def __init__(self):
        super().__init__()
        self.rt = spawn_scene("level1.json", scene=self, apply_camera=True)
        
        self.player = self.rt.first("player")
        self.enemies = self.rt.startswith("enemy")


s.run(scene=LevelScene, size=(800, 600))

Превращение в UI-компоненты

# Спрайт → кнопка
btn = rt.exact("button").to_button(text="Click", on_click=callback)

# Спрайт → текст
label = rt.exact("label").to_text_sprite(text="Hello", font_size=32)

# Спрайт → переключатель
toggle = rt.exact("toggle").to_toggle(text_on="ON", text_off="OFF")

Физика из редактора

Если в Inspector у объекта выставлен тип Physics (Static/Kinematic/Dynamic), при загрузке через spawn_scene тело создаётся автоматически. Настройки: Mass, Friction, Bounce.

Экспорт сцены из кода

from spritePro.editor.scene import Scene as EditorScene

# Экспорт: код → JSON → редактор
EditorScene.export_from_runtime(MyScene, "scene_a.json")

Полный цикл: spritePro/demoGames/scenes_demo editor.py

Формат JSON

{
    "version": "1.0",
    "name": "My Scene",
    "objects": [
        {
            "id": "abc12345",
            "name": "Player",
            "sprite_path": "assets/player.png",
            "sprite_shape": "image",
            "transform": {"x": 100.0, "y": 200.0, "rotation": 0.0, "scale_x": 1.0, "scale_y": 1.0},
            "z_index": 10,
            "active": true,
            "custom_data": {}
        }
    ]
}

Горячие клавиши

Клавиша Действие
V Select
G Move
R Rotate
T Scale
F1 Settings
Ctrl+Z Отменить
Ctrl+Y Повторить
Ctrl+S Сохранить
F5 Запустить игру

Демо

python -m spritePro.demoGames.platformer_demo
python -m spritePro.demoGames.editor_scene_runtime_demo