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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Файл	Как называется
Анимация для Light Stream Player	Название композиции с расширением .cue
Видео для презентации (режим видеорендера)	Название композиции с расширением .mp4
Маска приборов	Файл *.png с именем, которое вы задали при сохранении

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Смотрите также

• Light Stream - Быстрый старт
• Settings
• Workspace
• Экспорт композиций
• Библиотека приборов
• Импорт моделей OBJ
• Терминология