Fork: 0
root / navi-1
Transfer to URL with SHA Find file
Newer
Older
navi-1 / manuals / render_3d.md
@Eugene Sukhodolskiy Eugene Sukhodolskiy on 30 Apr 3 KB Improve 3D modeling workflow discipline
Raw Blame History

render_3d

Что делает

Рендерит PNG-скриншоты ракурсов из STL-файла через OpenSCAD CLI.

Требует: OpenSCAD установлен в системе (openscad в PATH).

Предпосылки

  1. STL-файл уже должен существовать. Сгенерируйте его через model_3d заранее.
  2. OpenSCAD должен быть установлен.

Формат вызова

render_3d(
    source="session_files/{session_id}/bracket.stl",
    views=["iso", "front", "top"]
)

Параметры

Параметр Обязательно Описание
source Да Путь к существующему .stl-файлу
views Нет Список ракурсов (макс. 3). Доступные: front, back, top, bottom, left, right, iso. По умолчанию ["iso"].

Доступные ракурсы

Ракурс Описание
front Вид спереди
back Вид сзади
top Вид сверху
bottom Вид снизу
left Вид слева
right Вид справа
iso Изометрия (по умолчанию)

Workflow

1. Сгенерировать STL

model_3d(scad_path="...", output_path="...")

2. Отрендерить ракурсы

render_3d(
    source="session_files/sess-abc/bracket.stl",
    views=["iso", "front", "top"]
)

3. Проверить рендеры

Каждый PNG сохраняется рядом с STL с суффиксом вида:

  • bracket.iso.png
  • bracket.front.png
  • bracket.top.png

Обычно эти PNG нужны Нави для внутренней проверки геометрии перед публикацией STL. Откройте их через image_view и проверьте форму, пропорции, печатную ориентацию и очевидные проблемы печати.

Не публикуйте PNG пользователю, если пользователь явно не попросил preview-картинки.

image_view(source="session_files/sess-abc/bracket.iso.png")
image_view(source="session_files/sess-abc/bracket.front.png")
image_view(source="session_files/sess-abc/bracket.top.png")

Что возвращает

При успехе:

Generated 3 image(s):
  bracket.iso.png
  bracket.front.png
  bracket.top.png

При ошибке:

  • openscad_not_found — OpenSCAD не установлен
  • stl_not_found — исходный файл не найден
  • too_many_views — больше 3 ракурсов за раз
  • invalid_views — неизвестное имя ракурса
  • render_failed — все рендеры не удались

Важные правила

  1. Максимум 3 ракурса за вызов — если нужно больше, разбейте на несколько вызовов.
  2. Фиксированное разрешение — 400×300, не настраивается.
  3. PNG сохраняются рядом с STL — в той же директории, с суффиксом ракурса.
  4. Всегда preview mode — быстрый рендер, не полный CSG.
  5. Не склеивает в сетку — каждый ракурс — отдельный файл. PNG обычно нужны для внутренней проверки; публикуйте их только по явной просьбе пользователя.