К содержанию
fohbookбета/ TouchDesigner

Палитра и компоненты .tox

Что взять из палитры в первую неделю, как сохранить свой компонент в .tox и почему правки во внешнем .tox пропадают, если его не пересохранить.

Ветка вашего пульта:
Быстрый выбор:

Палитра — встроенная библиотека готовых компонентов. Открывается кнопкой в левом верхнем углу окна, через Dialogs → Palette Browser или Alt+L, и нужный блок там чаще всего уже есть.

Компонент Зачем
audioAnalysis Разбор звука: низ, середина, верх, кик, снейр, ритм — Анализ звука
kantanMapper Проекционный мэппинг фигурами и масками, папка Mapping — Kantan Mapper
stoner Угловая подстройка по четырём точкам плюс деформация сеткой; отдаёт картинку и карту смещения для Remap TOP
camSchnappr Находит положение проектора по 3D-модели объекта, папка Mapping
probe Наглядный монитор времени CPU и GPU и памяти — Монитор и Probe
moviePlayer, movieEngine Плеер с переключением файлов без пропуска кадров, кью и звуком; movieEngine — то же без интерфейса
moviePlaylist Цикл по папке с видео и картинками или по таблице, с переходами
blendModes Микшер на два входа со всеми режимами наложения Composite TOP и превью каждого
tdPyEnvManager Управление окружениями Python и Conda — Внешние модули
logger Запись логов в файл через стандартный logging Python

Перетащенный в сеть компонент — обычный узел: параметры снаружи, сеть внутри. Зайдите внутрь (Enter) и посмотрите, как он собран; лучше учебника не найти.

.tox

Любой компонент сохраняется в файл через RMB → Save Component..., обратно — перетаскиванием .tox в сеть или Ctrl+I. В .tox хранят свои библиотеки блоков, куски проекта, над которыми работают разные люди, содержимое Engine COMP и плагины сообщества — MediaPipe, диффузия.

Внешний .tox

Если на странице Common указан External .tox Path и включён Enable External .tox, при открытии проекта содержимое компонента берётся из файла, а не из .toe. Так один компонент делят несколько проектов.

Правки внутри компонента в этот файл сами не попадают. Сохраняют его отдельно — Save Component... поверх того же файла или op('mycomp').saveExternalTox(). Не сохранили — при следующем открытии компонент загрузится из старого файла, и правок не будет.

Пути к файлам внутри считаются от .toe или от самого .tox, как выставлено в Relative File Path Behavior на той же странице.

Перед выездом

Внешний .tox из вашей папки библиотек на площадку сам не попадёт. Соберите проект целиком и откройте его на чистой машине, пока вы дома.

Своя палитра

Раздел My Components в палитре — ваша папка. Компонент, перетащенный на неё, сохраняется туда и доступен в любом проекте. Новую папку даёт RMB → Add Folder, файлы, скопированные на диск вручную, подхватывает RMB → Refresh Folder, а где эта папка на диске, скажет app.userPaletteFolder. Свои компоненты удобно называть с префиксом — xx_audioSplit, xx_dmxPatch, — тогда они не путаются со встроенными.

Нашли в статье ошибку, устаревшее или непонятное место?

рядом по смыслу