Командний рядок

Повне посилання на опції командного рядка.

rayforge [опції] [файли...]

---

Позиційні аргументи

Аргумент	Опис
файли	SVG або зображення при запуску.

---

Опції

Опція	Опис
--version	Вивести версію та вийти.
-h, --help	Показати довідку та вийти.
--loglevel РІВЕНЬ	Рівень журналу. За замовчуванням: INFO.
--config КАТАЛОГ	Кастомний каталог конфігурації.
--exit	Вийти після імпорту.
--vector	Примусовий імпорт як прямих векторів.
--trace	Примусовий імпорт через трасування bitmap.
--script СКРИПТ	Ранній скрипт запуску.
--uiscript СКРИПТ	Скрипт UI (після завантаження).

---

Приклади

Відкрити файл

rayforge мійпроект.ryp

Відкрити кілька файлів

rayforge деталь1.svg logo.png дизайн.ryp

Імпорт з трасуванням

rayforge --trace фото.png

Запустити ранній скрипт і вийти

rayforge --exit --script реєстрація.py \
    мійпроект.ryp

Скрипт UI (автоматизація)

rayforge --exit --uiscript скриншот.py \
    мійпроект.ryp

Пакетна обробка

rayforge --exit --vector вхід.svg

---

Ранні скрипти (--script)

Прапор --script запускає Python скрипт синхронно під час запуску, до завантаження аддонів та до створення головного вікна. Підходить для:

• Реєстрації плагінів з менеджером pluggy
• Налаштування контексту додатку
• Реєстрації функцій шаблонів для текстових полів
• Встановлення змінних середовища перед запуском

Скрипт має доступ до контексту через get_context():

from rayforge.context import get_context

ctx = get_context()

Приклад: Реєстрація кастомної функції шаблону

"""Реєстрація кастомної функції для шаблонів тексту.

Запуск: rayforge --script реєстрація_fn.py
"""
from sketcher.core.template_functions import (
    register_template_function,
)

register_template_function("мій_id", lambda: "ДЕТАЛЬ-001")

Тепер {мій_id()} працює в будь-якому текстовому полі.

Див. Кастомні функції шаблонів у документації скетчера для повного підручника.

---

Скрипти UI (--uiscript)

Прапор --uiscript запускає Python скрипт після повного завантаження головного вікна, у фоновому потоці. Підходить для:

• Автоматизованого тестування UI
• Зняття скріншотів додатку
• Робочих процесів від початку до кінця

Скрипт може імпортувати додаток і вікно безпосередньо:

from rayforge.uiscript import app, win

Скрипт працює у фоновому потоці — будь обережний з потокобезпекою при доступі до віджетів GTK (використовуй GLib.idle_add для операцій GTK).

Приклад: Зняття скріншота

"""Зняття скріншота головного вікна."""
from rayforge.uiscript import app, win

import gi
gi.require_version("Gtk", "4.0")
from gi.repository import GLib

def capture():
    surface = win.get_surface()
    if surface:
        surface.write_to_png("/tmp/rayforge_screenshot.png")
    return GLib.SOURCE_REMOVE

GLib.idle_add(capture)

---

Використання обох прапорів

--script та --uiscript можна використовувати разом. --script запускається першим (синхронно), потім завантажується вікно, і потім запускається --uiscript:

rayforge --script раннє_налаштування.py \
    --uiscript автоматизація.py \
    мійпроект.ryp

Це корисно, коли тобі потрібно спочатку зареєструвати плагіни, а потім керувати інтерфейсом пізніше.