Документация Pip3D
Pip3D это компактный software 3D engine для ESP32-S3 с дисплеем ST7789 320x240. Здесь собраны как API-срезы движка, так и guide-страницы по архитектуре, pipeline и практике.
Начните здесь
Требования к компиляции, build-флаги, путь подключения, begin3D(...), первый рабочий скетч и заметки по интеграции.
Типы и хелперы
Vector3, Color, DisplayConfig, типы для skybox и небольшой runtime-хелпер getDeltaTime().
Рендерер
Инициализация рендерера, жизненный цикл кадра, drawMesh, HUD и overlay-вывод, диагностика и флаги рендерера.
Камеры и движение
Настройка камеры, отдельные camera-классы, анимационные хелперы, FreeCam, OrbitCam и camera-timeline.
Геометрия и инстансы
Меши, готовые примитивы, MeshInstance и InstanceManager для размещения геометрии сцены.
Освещение и атмосфера
Свет, тени, skybox-пресеты, управление временем суток и вспомогательные инструменты для состояния мира.
Сцена и геймплей
Граф сцены, character controller, эффекты частиц и input-слой для интерактивного поведения.
Начало работы
Оборудование, тулчейн и базовая ментальная модель перед тем, как запускать движок на реальной плате.
Обзор архитектуры
Основные подсистемы Pip3D и то, как они общаются друг с другом: ядро, рендерер, граф сцены, математика и утилиты.
Конвейер рендеринга
Что происходит между отправкой сцены и появлением пикселей на ST7789: преобразования, отсечение, растеризация и другое.
Сцена и сущности
Как представлены объекты, камеры и источники света, как построить граф сцены и обновлять его каждый кадр.
Система задач и производительность
Разбиение рендеринга и симуляции на небольшие задачи, которые помещаются в ядра ESP32-S3 и бюджеты по памяти.
Примеры и паттерны
Типичные способы использовать Pip3D в проекте: демо, HUD-оверлеи, отладочная визуализация и простые игры.