Все инструкции
Подготовка модели
- 04Move, rotate, scale and auto-orient
- 05Check and repair a model
- 06Cut and split a model
- 07Arrange models and use more than one plate
- 08Полая модель и дренажные отверстия
- 09Поддержки: автоматически и вручную
- 10Press a texture into the surface
- 11Write text on a model
- 12Combine models: union, subtract, intersect
- 13Read the layer check before you print
Печать
Помочь проекту
Печать · Инструкция 20 из 21
Слайсер в командной строке
Команда encrust — это слайсер для фотополимерной печати в терминале. Без окна программы она нарезает модель, платформы проекта или целую папку в файл для принтера, например .ctb или .goo, и управляет принтером в вашей сети. С --json каждый запуск выводит один документ JSON, а код выхода сообщает скрипту, чем всё закончилось.
Нарезка, которая не прошла проверку, не оставляет после себя полуготового файла. С --strict модель с дефектами или модель, которая не помещается на платформу, завершает запуск с кодом 3, а только что записанный файл или папка с PNG сразу удаляется с диска. Код выхода всегда совпадает с тем, что лежит на диске, поэтому скрипт может доверять и тому, и другому.
Одну модель или платформу удобнее нарезать в окне программы, как в инструкции Первая печать. Команда нужна, когда моделей целая папка или нарезку запускает скрипт. Окно и команда работают на одном и том же коде. Ниже — команды, которые понадобятся первыми, остальное есть в справочнике.
Что понадобится
Установленный Encrust (Установка Encrust), принтер, выбранный как в инструкции Первая печать, и смола, которую вы добавили сами (Printer, resin and support profiles, на английском). На входе — модель в STL, OBJ или 3MF.
Команда — это отдельная программа encrust. Она лежит рядом с обычной программой Encrust. В переносных архивах encrust-*.tar.gz и .zip обе программы лежат в папке Encrust, так их упаковывает сборка релиза. Выполните в терминале encrust --version: так видно, есть ли команда в PATH. Если терминал её не находит, запускайте из распакованной папки. Если у вас клон исходников, запускайте её так, как написано в README: cargo run --release -p encrust-cli --bin encrust --. Дальше encrust означает любой из этих вариантов.
Узнайте id принтера и смолы
Выполните encrust profiles list. Команда выведет три блока: принтеры, смолы и профили поддержек, а ваши собственные профили будут помечены. В блоке смол только то, что вы создали сами: в каталоге нет ни одной смолы, потому что экспозицию подбирают на своём принтере.
Принтер без смолы команда не примет и стандартных чисел за вас не подставит. Если блок смол пуст, сначала создайте смолу в окне Принтер и смола или напишите файл TOML и подключите его: encrust profiles import grey.toml --kind resin --printer elegoo-mars-4-ultra. encrust profiles show <id> выводит любой профиль в TOML, как он и хранится. С -o file.toml профиль запишется в файл: отредактируйте его и передайте обратно через --profile (принтер) или --material (смола). Если указан путь к файлу, id из каталога не учитывается.
Нарежьте одну модель
encrust slice model.stl \
--printer elegoo-mars-4-ultra --resin my-grey --center -o model.goo
Формат выбирает расширение в -o: .goo, .prz, .ctb, .cbddlp, .photon, .sl1, .zip, .crmaslice, .cxdlp, .cxdlpv4, .fdg, .phz, .photons, .cxline и остальные из списка, среди них расширения Anycubic и семейство .pwsz. Если расширения нет, получится папка со слоями в PNG.
.ctb записывается в той версии, которую называет профиль принтера: в пятой или, для экрана больше 4095 пикселей по стороне, в зашифрованном контейнере. --ctb-version 4, 5 или encrypted выбирает версию вручную. .goo записывается в версии 5.1, если её называет профиль, иначе в 3.0. Для файла любого формата нужен --printer (или --profile), ведь слои рисуются на экране принтера. Без него команда завершится ошибкой.
В терминале виден индикатор прогресса по слоям. --quiet, --no-progress и --json его убирают.
Полость, поддержки, рельеф и другие инструменты окна у slice тоже есть, в виде флагов: --hollow 2 --drain 4 --drain-at 30,30,60, --supports medium, --relief 0.4.
--infill hive --infill-cell 6 --infill-density 0.3 заполняет полость, --keep-solid X,Y,Z оставляет стенку сплошной в точке (--keep-solid-size — на сколько миллиметров дальше неё), --keep-solid-under 6 оставляет сплошным всё, где модель тоньше 6 мм, так что пальцы и лезвия переживают выдалбливание, а --drain-walled и --drain-support-at X,Y,Z сверлят углубление в стенке или отверстие в поддержках. Вместо выбора точки --drain-at auto сверлит дренажное отверстие и отверстие для воздуха у каждого кармана, где всё ещё застревает смола, и оставляет отверстие, только если проверка нашла этот карман пустым; --no-drain-vent убирает отверстия для воздуха (справочник). --supports auto подбирает каждую поддержку под то, что она держит, как профиль Auto в окне, а --support-cavity ставит поддержки ещё и внутри полости полой модели, как кнопка Поддержки в полости. Каждый флаг с примером описан в справочнике, а что делают числа, объясняют инструкции о полых моделях и поддержках.
Эти числа — примеры для одного принтера и одной смолы, а не рекомендации: инструкции производителей смолы и принтера важнее.
Автоматическая ориентация
--orient первым делом поворачивает модель и сообщает --rotate, который повторит этот поворот. --orient-goal задаёт, что искать: fewest-supports (по умолчанию, меньше всего поддержек), least-peel (самый лёгкий отрыв), shortest-print (самая короткая печать) или auto (компромисс между тремя). --max-tilt 30 не даёт отклонить модель больше чем на 30° от того, как она стоит в файле. --clean-surface для любой цели оставляет как можно меньше контактов там, где модель на виду, судя по её форме (справочник). Если принтер указан, команда выводит несколько лучших положений на выбор, как Автоориентация в окне (ориентация).
Подготовка модели одной командой
--prepare выполняет шаги по порядку, ничего не подстраивая: ориентация (--orient-goal auto), починка, если импорт нашёл дефект, полость, если она экономит не меньше 10 мл и 40 %, дренаж, поддержки. Там, где смола остаётся в кармане или модель на поддержках не помещается, команда останавливается и сообщает об этом. --strict она не подразумевает. --recipe ID|PATH у slice, estimate и batch выполняет вместо этого рецепт: встроенный по id (их показывает encrust recipes list) или ваш файл. У проекта свои шаги, поэтому он не принимает ни то, ни другое.
encrust slice figure.stl --printer elegoo-mars-4-ultra --resin my-grey --prepare -o figure.goo
Починка модели
--repair сшивает швы, выбрасывает мелкие крошки, закрывает дыры и удаляет задвоенные грани, как инструмент Починка. Если после починки ошибок осталось бы больше, модель остаётся такой, какой пришла. --repair=close-holes, =close-small-holes или =turn выполняют только часть работы; =wrap оборачивает каждую оболочку одной внешней поверхностью, а =deep чинит, оборачивает и чинит ещё раз. --seam-tolerance MM (по умолчанию 0,01 мм) задаёт, как далеко вершина может отстоять от открытого ребра, чтобы её пришили, а --smallest-shell MM2 (по умолчанию 1 мм²) — наименьшую площадь, при которой открытая оболочка сохраняется.
Вручную, как в режиме Грани и в списке Оболочки: --flip-faces 3,4 разворачивает грани, --drop-faces удаляет их, --drop-shells 2 удаляет оболочки по номерам с единицы, как их перечисляет inspect --shells, а --bridge A-B:C-D строит грани между двумя открытыми рёбрами. Все номера относятся к модели в том виде, в каком её оставил импорт. Что делает каждый способ, описано в инструкции о починке (на английском).
encrust inspect broken.stl --repair
encrust slice parts.stl --drop-shells 2,3 -o out
Сглаживание краёв
Края маски затеняются так, как задано в разделе [edges] смолы, а если там ничего нет, сглаживаются. --anti-alias затеняет край по тому, какую долю пикселя закрывает модель, --no-anti-alias засвечивает каждый пиксель целиком или не засвечивает вовсе. --grey-levels N округляет края до N оттенков серого, --blur PX размывает каждый край, а --grey-range MIN..MAX раскладывает серые на краях по этому диапазону вместо диапазона из профиля принтера. Принтер, маски которого не содержат оттенков серого, эти флаги игнорирует и предупреждает об этом.
Проверьте модель до нарезки
encrust inspect model.stl --printer elegoo-mars-4-ultra читает модель и, ничего не нарезая, сообщает её размер, дефекты и помещается ли она. С --center видны габариты после размещения, с --shells — все оболочки с номерами от единицы, а --intersections считает пары пересекающихся граней. Вдоль краёв платформы производитель оставляет свободную полосу. Модель, которая заходит в неё, всё равно считается помещающейся, а отчёт пишет, насколько глубоко она зашла. Если стенка 2 мм сэкономила бы на сплошной модели не меньше 10 мл и 40 % смолы, в отчёте появляется строка solid с этой экономией.
encrust estimate model.stl --printer elegoo-mars-4-ultra --resin my-grey принимает то же, что slice, ничего не записывает и выводит число слоёв, время печати, объём и вес смолы, а также слои, которые, скорее всего, не получатся. Это и есть пробный прогон: флага --dry-run нет. inspect тоже понимает --strict, так что им можно отсеять модель, не записывая файла.
Отчёт работает так же, как список На платформе в «Проверке». Когда --supports поставил поддержки, строка fits пересчитывается для модели вместе с поддержками и подложкой там, где они встали. Две модели, которые заходят друг в друга, или поддержки одной, которые залезают в другую, названы один раз: meeting a.stl and b.stl. Касание считается, зазор — нет. С --strict запуск проваливается в обоих случаях, а каждая модель в batch перечисляет в meets те, с которыми встречается.
encrust info plate.ctb работает в обратную сторону: открывает нарезанный файл любого формата из справочника. Что он выводит, разобрано в инструкции Как открыть файл .ctb, .goo или .pwmx. --thumbnail out.png сохраняет в PNG самую большую миниатюру из файла.
Нарежьте папку
encrust batch models/ \
--printer elegoo-mars-4-ultra --resin my-grey --center --orient --supports light -o out/
encrust batch models/ --printer elegoo-mars-4-ultra --resin my-grey \
--name "{model}_{resin}_{layer}um_{date}" -o out/
Все .stl, .obj и .3mf в папке нарезаются с одними и теми же флагами, остальные файлы Encrust не трогает. Каждая модель получает свой файл для принтера и отчёт <имя>.json, а в конце запуск пишет общий batch.json. Без -o всё попадает в out. --name называет файлы по шаблону, как настройка Имя файла в окне: {model}, {ext} (родное расширение модели), {printer}, {resin}, {layer} в мкм, {plate}, {date} и {time}, а расширение принтера добавляется в конце.
--jobs N нарезает столько моделей одновременно, по умолчанию одну. Если одна модель не нарезалась, остальные всё равно нарежутся, а запуск завершится с кодом 4. Здесь на каждую модель получается свой файл. Чтобы собрать несколько моделей на одной платформе, передайте slice несколько файлов и --arrange, как в инструкции Arrange models (на английском).
Запуск из скрипта
Скрипт может положиться на две вещи. Первая — --json: в stdout выводится ровно один документ JSON, в котором рядом с полями отчёта стоит "schema": 1. Журнал и прогресс уходят в stderr, поэтому encrust inspect model.stl --json | jq получает чистый JSON. Неудачный запуск выводит на то же место {"schema": 1, "error": {"message", "chain", "cancelled"}}. Номер схемы растёт, когда поле удаляют или оно меняет смысл, но новое поле его не повышает. Поэтому читайте нужные поля по имени, а на остальные не обращайте внимания. Находки приходят с местом: cured.risks перечисляет риски со слоем и точкой at_mm, slicing.trapped — каждый карман с застрявшей смолой, а supports.no_room_why объясняет, почему для контакта не нашлось места (head-blocked, faces-up или no-ground). Точки даны в тех координатах, которые принимает --drain-at, так что скрипт может передать любую обратно.
Вторая — код выхода:
| Код | Что значит |
|---|---|
| 0 | Готово |
| 1 | Запуск не удался |
| 2 | Неверные аргументы |
| 3 | Включён --strict, а у модели есть дефекты или она не помещается; на диске ничего не осталось |
| 4 | Пакет, в котором хотя бы одна модель не нарезалась |
| 130 | Остановлено по Ctrl-C |
Источник: коды выхода. Первый Ctrl-C останавливает работу между слоями или между моделями пакета и удаляет недописанный файл. Второй выходит сразу.
Число после флага может быть отрицательным: --rotate -90,0,0 работает так, как написано.
Флаги в файле
--config FILE читает флаги из файла TOML: ключ — это длинное имя флага, а таблица называет подкоманду.
[slice]
printer = "elegoo-mars-4-ultra"
resin = "my-grey"
center = true
Флаг, набранный в командной строке, важнее файла. Ключ, которого команда не знает, — ошибка с кодом 2.
Файлы платформы и проекты
encrust slice plate.toml -o plate.goo читает файл платформы со списком моделей, у каждой из которых свои rotate, scale, position, supports и hollow. Проект, сохранённый в окне, нарезается таким, каким его сохранили: encrust slice plate.encrust --resin my-grey -o plate.goo. Принтер и смолу проект называет только по id, поэтому если их нет среди ваших профилей, нужен флаг. Флаги, которые меняют форму модели, например --hollow или --supports, для проекта не принимаются.
Настроек печати проект не хранит: они лежат в профилях принтера и смолы. --layer-height, --adaptive, --samples-per-layer, --exposure-at и флаги маски действуют на проект так же, как на модель.
Выбор платформы
Проект с несколькими платформами нарезает ту, на которой его сохранили, и сообщает об этом. --plate N выбирает для slice и estimate другую, счёт с единицы, как в полосе платформ. slice --all-plates записывает каждую платформу с моделями в отдельный файл, названный по ней: plate-small-parts.goo рядом с plate.goo, как пункт Файл > Нарезать все платформы (N) в .goo. Его --json — один документ, где в plates лежит отчёт по каждой платформе.
encrust slice plate.encrust --plate 2 -o small.goo
encrust slice plate.encrust --all-plates -o plate.goo
Другие подкоманды
encrust convert plate.ctb --printer elegoo-mars-4-ultra -o plate.goo переписывает нарезанный файл в другой формат, не пересчитывая слои, поэтому экран принтера должен быть того же размера, под который рисовался файл. encrust completions zsh выводит автодополнение для bash, zsh, fish, elvish или PowerShell.
encrust profiles reset-unreadable удаляет копии встроенных профилей, которые перестали читаться, и Encrust снова берёт встроенные. С --with-own удаляются и ваши собственные нечитаемые файлы, как по кнопке Удалить в окне.
Принтер в вашей сети
encrust printer discover, status и send работают с принтером по локальной сети: discover ищет платы ELEGOO в сети, а status и send принимают IP-адрес платы. send --start запускает файл, как только плата его проверит. Запускайте печать, только когда стоите у принтера, а ванна и платформа готовы, и следуйте инструкции к принтеру. Принтер Prusa так не найти, а отправить ему можно только .sl1 и .sl1s. Укажите его адрес через --prusalink, а ключ или пароль передайте в ENCRUST_PRUSALINK_KEY или ENCRUST_PRUSALINK_PASSWORD, чтобы они не остались в истории оболочки.
Пока идёт печать, то же, что кнопки карточки принтера, делают команды:
| Команда | Что делает |
|---|---|
pause, resume |
Ставит печать на паузу или продолжает её |
stop |
Останавливает печать; остановленную печать не продолжить, а команда ни о чём не спрашивает |
history |
Перечисляет последние печати, которые помнит плата ELEGOO, 10 штук, если --count не задаёт другое число; с принтера Prusa Encrust историю не читает |
camera on, camera off |
Выводит RTSP-адрес, куда плата ELEGOO транслирует видео, для видеоплеера, или выключает трансляцию |
picture -o FILE |
Сохраняет снимок платформы, который принтер хранит для текущей печати |
encrust printer pause 192.168.1.42
encrust printer history 192.168.1.42 --count 5
Это команды принтера из справочника; с --json каждая выводит свои поля.
От чего команда отказывается и о чём только предупреждает
Если Encrust не может сделать то, что попросили, он отказывается и говорит почему, а не записывает вместо этого какой-то другой файл. Он откажется, если:
- указан принтер без смолы или формат файла без принтера;
- для проекта задан флаг, меняющий форму модели;
- число заполнения дано без
--infill; - точка дренажного отверстия приходится на ребро или угол модели;
- для
.sl1заданы--exposure-atили адаптивные слои.
Предупредит, но файл запишет, если настройка смолы выходит за то, что принимает принтер или советует его производитель (slice и convert называют каждую такую настройку), и если флаги маски даны принтеру, маски которого не содержат оттенков серого.
Если что-то пошло не так
Код выхода 2
Неверный аргумент: флаг, которого подкоманда не принимает, два несовместимых флага или ключ в файле --config, которого команда не знает. Сообщение в stderr называет его. Точный список флагов показывает encrust slice --help.
Команда не принимает принтер
Вы указали принтер, но не смолу. Назовите её через --resin или передайте путь к TOML через --material. Список смол показывает encrust profiles list.
Код выхода 3, а файла нет
Так и работает --strict. Отчёт всё равно называет каждый дефект или выход за область печати. Исправьте модель, поставьте её по центру с --center или уберите --strict, если дефект вас устраивает.
Пакет завершился с кодом 4
Хотя бы одна модель не нарезалась, остальные нарезаны. Какая именно, видно в batch.json и в <модель>.json рядом с каждым файлом.
Источники
- Encrust: the command line · Все подкоманды с примерами, коды выхода и формат JSON
- Encrust: from the command line · Нарезка одной строкой и запуск программы из клона исходников
- Encrust: the --json document · Номер схемы и когда он меняется
- Encrust: how a run ends · Коды выхода и код для Ctrl-C