Системные файлы и пути

Программа хранит данные в трёх разных местах: в папке проекта лежит всё, что вы построили; в папке документов программы — библиотеки, рабочие пространства и журнал работы; в самой системе Windows — настройки программы и лицензия. Знать это нужно в трёх случаях: когда проект переносят на другой компьютер, когда после переноса или переустановки в проекте не находятся картинки и видео, и когда служба поддержки просит прислать журнал работы.

Папка документов программы — это папка Light Stream в системной папке Документы текущего пользователя; программа создаёт её сама при первом запуске. Папку проекта вы выбираете сами, когда его создаёте, а папку установки — в мастере установки. Прежде чем что-то копировать или удалять, откройте эти папки у себя и сверьтесь с тем, что в них реально лежит.

Коротко: что где лежит

Что	Где	Переносится с проектом
Приборы, патчинг, композиции, эффекты, 3D-сцена	Файл проекта `*.ls` в папке проекта	Да, это и есть проект
Картинки, видео, аудио, текстуры моделей	Там, где вы их взяли; в проекте записаны только ссылки	Только если собрать проект в одну папку
Кадры импортированных видеосеквенций	Подпапка `Import\Video` внутри папки проекта	Да, если переносить папку проекта целиком
Экспортированные анимации `*.cue`	Папка, указанная в поле Путь окна Экспорт (в новом проекте — подпапка `Export` рядом с проектом)	Нет, экспорт делается заново
Пользовательские приборы, библиотека эффектов, рабочие пространства, журнал	Папка документов программы	Нет, копируются отдельно
Настройки программы, список последних проектов, лицензия	В системе Windows, в профиле текущего пользователя	Нет, задаются заново

Папка проекта

Как она появляется

Выберите Файл → Новый проект (Ctrl+N) или Создать в приветственном окне Добро пожаловать в Light Stream.
В окне Создать проект задайте Название проекта — по нему будет назван и файл, и папка.
В поле Путь укажите, где эту папку создать: вручную или кнопкой Открыть. В первый раз программа предлагает подпапку Scenes в папке документов программы, дальше — ту папку, которую вы выбрали в прошлый раз. Проект удобнее держать там, где вы храните рабочие материалы объекта.
При необходимости измените Кадров в секунду для проекта — с этой частотой будут создаваться новые композиции.
Нажмите Создать.

Программа создаст в указанном месте папку с названием проекта, положит в неё файл проекта с расширением .ls и заодно создаст рядом подпапку Export — она сразу подставится в поле Путь окна Экспорт.

Если в выбранное место писать нельзя, программа предупредит сообщением Нет доступа для записи. Так бывает с корнем системного диска и с папкой Program Files — выберите другое место, например в Документах.

Дальше эту папку удобно считать папкой объекта: складывайте в неё все картинки, видео, аудио и модели, которые используете в проекте. Программа умеет искать потерянные файлы именно внутри папки проекта, а не по всему диску.

Что лежит внутри файла проекта

Файл .ls — это один файл, в котором собрано всё построенное вами:

приборы на маппинге, их размеры, адреса и имена;
устройства (Player, конвертеры, порты) и патчинг;
композиции, лейауты, эффекты и их ключевые кадры;
3D-сцена целиком, включая геометрию импортированных моделей: после импорта исходный файл модели *.obj или *.fbx уже не нужен, проект откроется и без него;
приборы, использованные в проекте, — поэтому проект нормально откроется и на компьютере, где вашей пользовательской библиотеки приборов нет;
папка экспорта и отметки, какие композиции экспортировать.

Чего в файле проекта нет — это самих медиафайлов. Изображения, видео, видеосеквенции, аудиодорожки, текстуры моделей и фоновые картинки лейаутов остаются на диске, а в проекте записаны только пути к ним. Если такой файл переименовать, удалить или оставить на старом компьютере, эффект в проекте останется без картинки.

Кадры видеосеквенций

Видео, импортированное в проект как видеосеквенция, программа заранее раскладывает на отдельные кадры — иначе его не удалось бы проигрывать без рывков. Кадры записываются в подпапку Import\Video внутри папки проекта: на каждое видео создаётся своя папка с именем видеофайла, а в ней лежат пронумерованные файлы 00000000.png, 00000001.png и так далее.

Что из этого следует:

папка проекта после импорта видео вырастает в разы — распакованные кадры весят гораздо больше исходного ролика. Планируйте место на диске;
эти кадры и есть сама секвенция: удалите папку — эффект перестанет что-либо показывать, импорт придётся повторить;
переносить проект нужно вместе с подпапкой Import, иначе на новом компьютере видео придётся импортировать заново;
если импортировать один и тот же ролик второй раз, программа не перезаписывает старые кадры, а заводит рядом папку с номером в имени.

Резервная копия проекта

При каждом сохранении программа сначала откладывает предыдущее состояние проекта в копию: рядом с файлом проекта появляется файл с тем же именем и добавленным .backup на конце.

Если проект перестал открываться после неудачного сохранения:

Закройте программу.
Сохраните повреждённый файл .ls куда-нибудь в сторону — на случай, если он ещё пригодится.
Скопируйте файл с .backup и уберите .backup из имени копии, чтобы получился обычный файл .ls.
Откройте его в программе.

Вы получите проект в том виде, в каком он был на предыдущее сохранение. Копия всего одна и перезаписывается при каждом сохранении, поэтому на неё нельзя рассчитывать как на архив: важные этапы работы сохраняйте через Файл → Сохранить как… под отдельными именами.

Как программа ищет пропавшие файлы

Если файл не находится по записанному в проекте пути, программа не сдаётся сразу, а ищет его сама:

файл с таким же именем — в папке проекта и во всех её подпапках;
папку видеосеквенции — ещё и в подпапке Import\Video внутри папки проекта.

Если и там ничего не нашлось, эффект остаётся пустым, а его название на таймлайне становится красным. Так сразу видно, какие именно эффекты потеряли свои файлы: выделите такой эффект и укажите файл заново в окне Свойства.

Отсюда простое правило: держите медиафайлы внутри папки проекта. Тогда проект переживёт и переименование папки, и переезд на другой диск — программа найдёт всё сама. Если же картинка лежала на рабочем столе или на флешке, после переезда её придётся выбирать заново вручную.

Перенос проекта на другой компьютер

Чтобы собрать проект вместе со всеми внешними файлами, используйте Файл → Собрать проект:

Откройте проект и выберите Файл → Собрать проект. Пока проект не открыт, пункт неактивен.
Укажите папку, в которую всё собрать. Лучше пустую: программа сложит туда и файл проекта, и все файлы, которые он использует.
Дождитесь окончания — на больших проектах с видео это занимает время, курсор всё это время показывает ожидание.

Что происходит: в выбранную папку записывается копия файла проекта, а все внешние файлы копируются в подпапку CollectProjectFiles, где раскладываются по вложенным папкам, повторяющим их исходное расположение на диске. Пути внутри собранного проекта перестраиваются относительно новой папки, поэтому переносить нужно всю папку целиком, а не один файл .ls.

Собираются изображения и видео из эффектов, видеосеквенции, аудиодорожки, фоновые картинки лейаутов и текстуры импортированных моделей.

Полезно знать:

если в выбранную папку нельзя писать, программа предупредит сообщением Нет доступа для записи и ничего не соберёт — выберите другое место;
после сборки вы продолжаете работать в исходном проекте, собранная копия просто лежит на диске отдельно;
вместе с проектом не переносятся настройки программы, рабочие пространства и лицензия — на новом компьютере их задают заново.

Экспортированные файлы

Экспорт композиций складывает файлы в папку, указанную в поле Путь окна Экспорт. В новом проекте там сразу стоит подпапка Export рядом с проектом; изменить её можно кнопкой Открыть. Выбранная папка запоминается в проекте.

Файл	Как называется
Анимация для Light Stream Player	Имя из столбца Имя файла окна Экспорт; по умолчанию это название композиции с расширением `.cue`
Видео для презентации (режим Видео рендер)	Название композиции с расширением, которое зависит от выбранного кодека: `.mp4`, `.mov` или `.avi`
Кадры в режиме PNG Sequence	Папка с именем композиции и окончанием VideoSequence, внутри — файлы `000000.png`, `000001.png` и далее
Маска приборов	Файл `*.png` с именем, которое вы задали при сохранении

Имена файлов по умолчанию берутся из названий композиций, поэтому в названии композиции программа сама убирает служебные символы — \ / : * ? " < > | и другие, которые Windows не разрешает в именах файлов. Длина названия композиции ограничена 40 символами.

Если в проекте несколько устройств Light Stream Player, программа создаёт в папке экспорта отдельную подпапку на каждое устройство и раскладывает *.cue по ним — так сразу видно, какие анимации на какой плеер загружать. Подробнее об экспорте — в статье Экспорт композиций.

Папка документов программы

При первом запуске программа заводит в системной папке Документы свою папку Light Stream и держит в ней всё, что относится к рабочему месту, а не к отдельному проекту.

Что это	Где искать
Папка, которая по умолчанию предлагается для новых проектов. При самом первом запуске программа заполняет по ней список проектов в приветственном окне: туда попадают все файлы `*.ls`, найденные в этой папке и её подпапках	Подпапка `Scenes`
Библиотека приборов: заводская `fixtures.lslib`, ваша пользовательская `UserFixtures.lslib` и картинки приборов и производителей в подпапке `Images`	Подпапка `Fixtures`
Библиотека эффектов — состав окна Эффекты вместе с вашими сохранёнными эффектами (файл `LightStream.effects`)	Подпапка `Effects`
Рабочие пространства — сохранённые раскладки окон (файл `ls.workspace`)	Корень папки документов программы
Журнал работы программы (файл `ls.log`)	Подпапка `logs`

Что из этого имеет смысл копировать при переезде на новый компьютер:

UserFixtures.lslib и подпапку Images — если вы делали свои приборы и хотите пользоваться ими в новых проектах;
LightStream.effects — если вы перестраивали библиотеку эффектов под себя. При сохранении библиотеки программа оставляет рядом копию предыдущей версии с .backup на конце;
ls.workspace — если вам дорога своя раскладка окон.

Копировать файлы этой папки следует при закрытой программе, иначе часть изменений будет записана поверх при выходе: рабочие пространства, например, программа сохраняет в момент закрытия.

Папка установки программы

Путь для установки задаётся в мастере установки; по умолчанию это папка внутри Program Files. Там лежит сама программа — исполняемый файл, который, например, выбирают в панели управления NVIDIA при настройке производительности (см. Light Stream - Быстрый старт).

Своих файлов туда класть не нужно: в Program Files у обычного пользователя нет прав на запись, а при обновлении программы содержимое папки перезаписывается. Проекты, медиа и экспорт держите в папке проекта.

Настройки, последние проекты и лицензия

Настройки из окна Параметры, список Файл → Последние файлы и данные лицензии не хранятся ни в проекте, ни в отдельном файле, который можно скопировать: они записаны в системе Windows и привязаны к учётной записи пользователя на этом компьютере. Из этого следует:

перенести настройки на другой компьютер копированием папок нельзя — язык, сетевую карту, аудиоустройства и прочее задают заново;
у каждого пользователя Windows на одном компьютере свои настройки и свой список последних проектов;
список последних проектов хранит не больше десяти записей — и в меню Файл → Последние файлы, и в приветственном окне. Лишнюю строку убирают через ПКМ → Удалить из этого списка, а найти папку проекта на диске помогает ПКМ → Показать в проводнике;
лицензия привязывается к компьютеру. Перед переносом программы на другую машину её нужно деактивировать в окне Активация (Справка → Активация) — иначе ключ останется занятым;
после обновления с давней версии программы раскладка окон может вернуться к стандартной. Это нормально, свои рабочие пространства сохраняются заново.

Журнал работы программы

Программа ведёт журнал: подпапка logs в папке документов программы, файл ls.log. Когда файл дорастает примерно до мегабайта, он уезжает в подпапку archives, а запись продолжается в новый; архивов хранится не больше десяти, старые удаляются сами.

Журнал нужен при обращении в техподдержку: если программа закрылась сама, зависла или выдала непонятную ошибку, приложите к обращению содержимое папки logs и опишите, что вы делали перед этим. Включать запись журнала отдельно не нужно — он ведётся всегда.

Что стоит сохранять

Минимальный набор для резервной копии:

Папка проекта целиком — файл .ls вместе с медиафайлами и подпапкой Import. Если медиа лежат где попало, сначала сделайте Файл → Собрать проект и сохраняйте собранную папку.
Экспортированные *.cue — если не хотите повторять экспорт на объекте.
Из папки документов программы: UserFixtures.lslib с подпапкой Images, LightStream.effects, ls.workspace.

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