model_3d

Что делает

Компилирует существующий OpenSCAD-скрипт (.scad) в binary STL-файл.

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

Предпосылки

Файл .scad уже должен существовать. Напишите его заранее через filesystem write.
OpenSCAD должен быть установлен. Если нет — инструмент вернёт ошибку openscad_not_found.

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

model_3d(
    scad_path="session_files/{session_id}/handle.scad",
    output_path="session_files/{session_id}/handle.stl"
)

Параметры

Параметр	Обязательно	Описание
`scad_path`	Да	Путь к существующему `.scad`-файлу
`output_path`	Да	Путь, куда записать сгенерированный `.stl`. Родительские директории создаются автоматически.

Workflow

1. Написать OpenSCAD-скрипт

filesystem write session_files/sess-abc/bracket.scad '
difference() {
    cube([40, 20, 5], center=true);
    translate([15, 0, 0]) cylinder(h=6, d=4, center=true);
    translate([-15, 0, 0]) cylinder(h=6, d=4, center=true);
}
'

2. Скомпилировать в STL

model_3d(
    scad_path="session_files/sess-abc/bracket.scad",
    output_path="session_files/sess-abc/bracket.stl"
)

3. Показать пользователю

content_publish(filename="bracket.stl", title="Bracket")

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

При успехе:

Generated: bracket.stl
Path: /home/.../session_files/sess-abc/bracket.stl
Size: 12.4 KB

При ошибке:

openscad_not_found — OpenSCAD не установлен
scad_not_found — исходный файл не найден
openscad_compile_error — ошибка компиляции (невалидный CSG, деление на ноль и т.д.)
no_output — OpenSCAD завершился без ошибок, но файл не создался

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

Всегда binary STL — нет параметра ASCII/binary, всегда используется --export-format binstl.
Скрипт должен существовать до вызова — model_3d не пишет .scad, только компилирует.
Ошибки OpenSCAD читаемы: строка, символ, тип ошибки — всё в stderr.