| Справка QLDT |
QLDT поддерживает две игры: Quake Live с расширением демок dm_73 и Quake 3 Arena с расширением dm_68. Под поддержкой понимается совместимость с указанными расширениями на программном уровне. В рамках одного и того же протокола могут быть логические различия, вызванные, например, модами (Quake 3), или постепенной эволюцией игры (Quake Live). И если изменения привносимые в протокол Quake Live незначительны, то изменения привносимые модами Quake 3 заставляют поддерживать каждый из них отдельно. Из модов в Quake 3 поддерживаются (помимо ванильного режима) только OSP и CPMA, и все возможности программы распространяются и на них в том числе.
Для воспроизведения демок Quake Live, используется плагин для Firefox. Сам плагин - это библиотека, носящая разные названия в зависимости от платформы: npquakelive.i386.so на Linux x86, npquakelive.x64.so на Linux x86_64 и npquakezero.dll в Win32. Путь к этой библиотеке определяется автоматически при первом запуске, но у пользователя остаётся возможность его изменить или прописать вручную в настройках. Кроме пути к плагину, также необходим путь к домашней директории (home path), который также определяется автоматически. Путь к домашней директории - это путь к директории содержащей каталог baseq3, в котором находятся ваши скриншоты, демки и конфиги.
Запуск двух экземпляров плагина в одно и то же время (в браузере, и, от другого пользователя, в QLDT) приведёт к вылету. Закрывайте страницу игры в Firefox перед использованием программы, или, если у вас Linux, используйте такое же имя пользователя, и игра разлогинится автоматически. Также, запуск двух экземпляров Quake Live, в одно и то же время, сразу приводит к вылету программы.
Есть два типа списков демок: основной, он всегда открыт в первой вкладке, через него осуществляется управление демками находящимися в домашней директории игры, и список с результатами поиска. Все списки, справа, имеют две таблицы с информацией из заголовков демок. В верхней перечислены имена игроков без клантегов и цветов, причём зрители всегда находятся в списке ниже чем игроки, которые рассортированы по командам, сначала красные, затем синие. В нижней таблице перечислены все серверные переменные из заголовка выбранной демки. В меню Вид есть возможность включить показ клатегов в таблице с игроками.
Не считая таблицы с результатами поиска демок, которая похожа на основную таблицу, списки с результатами поиска бывают двух видов, в зависимости от типа поиска. Не считая отображаемой информации, разница между ними только в том, что при просмотре сегментов из поиска фрагов, их длина равна времени от первого до последнего фрага, плюс двойное время расширения границ отрезков, а длина сегментов из поиска текста равна только двойному времени расширения границ отрезков.
Записи из таблиц с результатами поиска фрагов и текста изначально не являются файлами на жёстком диске, несмотря на то, что с ними можно работать также, как с записями из основной таблицы. При удалении записей из таблицы с результатами поиска демок, сами файлы не удаляются.
Для выделения нескольких записей используются клавиши Control, Shift или Insert. Delete - удаляет запись, Enter или двойной клик - воспроизводят. Кроме того в основной таблице могут быть использованы клавиши: F5 - для обновления таблицы, F9 - для переименования файла.
Сортировка таблиц осуществляется нажатием на заголовок нужной колонки, нажатие на заголовок уже отсортированной колонки меняет порядок сортировки.
Строки внутри таблиц демок можно перетаскивать, также меняя их порядок относительно друг друга.
Другие функции находятся в контекстном меню таблиц, вызываемом правой кнопкой мыши.
Показ колонок таблиц настраивается в меню Вид.
Все таблицы соединены разделителями с изменяемыми размерами.
Альтернативные цвета строк и цвета выделения, могут быть изменены в настройках посредством изменения их факторов осветления или затемнения. Фактор - это процент на который должен быть осветлён или затемнён цвет. То есть, если цвет вашей системной темы - тёмный, то фактор будет использован для осветления, и наоборот.
Автоматически сохраняются при выходе из программы: ширины колонок, размеры разделителей, колонки сортировки и их порядок, а также размер и местоположение основного окна (в Linux за местоположение отвечает окружение рабочего стола, поэтому в нём оно не сохраняется).
Для наполнения основной таблицы информацией, используется чтение заголовков демок. Заголовок - это самое первое сообщение игры, он содержит в себе всю информацию, которая необходима для инициализации клиента перед просмотром демки. В заголовках демок хранится только та информация, которая доступна игре в момент начала их записи. При открытии каталога, QLDT считывает заголовки всех демок, которые в нём находятся, а поскольку на медленных машинах считывание заголовков тысяч демок может занять минуты, вся прочитанная при индексировании информация помещается в базу данных, и в дальнейшем извлекается оттуда при повторном открытии проиндексированных каталогов. База данных находится в домашнем каталоге пользователя в директории Application Data\QLDT\db в Windows или .qldt/db в GNU/Linux. Для очистки всей базы демок достаточно удалить вышеуказанный каталог db.
Демки, при чтении заголовков которых произошла ошибка, помечены специальной иконкой. Если демка повреждена где-то внутри, то она скорее всего не сможет быть открыта на редактирование, в таком случае для её прочтения или исправления можно использовать экспорт в XML.
На главное окно программы можно сбрасывать файлы с расширениями: dm_68, dm_73, zip, rar, 7z, cfg, menu, h. Архивы при этом будут распакованы, а текстовые файлы открыты в редакторе конфигов. Кроме того, записи таблиц с демками можно перетаскивать в открытое дерево каталогов, или окна других программ.
Эта функция переименовывает выбранные демки в соответствии с указанным форматом, используя данные из их заголовков. Нельзя переименовать демки, которые открыты на редактирование.
Упорядочивание перемещает все выбранные демки в подкаталоги в соответствии с заданным форматом. Например, если использовать формат <T>/<Y> (при указании пути, также можно использовать обратный слеш - \), то выбранные демки будут сгруппированы по типу игры и году записи, и перемещены в соответствующие подкаталоги (указанная структура каталогов, при необходимости, будет создана автоматически). Если ни одна демка не выбрана, то будет произведена операция со всеми демками в каталоге.
Через дерево каталогов осуществляется навигация по подкаталогам директории demos и выбор игры. По умолчанию, дерево вызывается нажатием на логотип игры слева от вкладки с основным списком демок. Также, его можно разместить слева от основной таблицы и держать всегда открытым, включив соответствующую опцию в настройках. Директории в дереве выбираются двойным кликом, а разворачиваются нажатием на стрелки слева от значков папок. Создать новую директорию, а так же переименовать, удалить или упаковать можно через контекстное меню дерева.
В этот каталог, по умолчанию, попадают все демки открытые приложением. Он временный, и очищается при закрытии или открытии программы. Его использование можно отключить, и все новые демки будут попадать в текущую выбранную деректорию.
При установке QLDT через Windows setup или Debian package, он ассоциирует себя с файлами, имеющими расширения dm_68, dm_73, cfg и menu. В инсталляторе Windows имеется возможность опционально не ассоциировать QLDT с какими-либо расширениями. При открытии файла, ассоциированного с QLDT, через системный менеджер файлов, он будет открыт в программе.
Для установки ассоциаций файлов, на не-Debian дистрибутивах Linux, необходимо скопировать эти файлы из каталога desktop:
*.desktop в /usr/share/applications
*.xml в /usr/share/mime/packages
*.png в /usr/share/pixmaps
Обновите базу данных mime после копирования:
$ update-mime-database /usr/share/mime
При открытии ссылки, файл на который она указывает будет скачан, и распакован, в случае если это архив. Так же ссылки могут быть отправлены из Firefox, через его пункт контекстного меню Отправить ссылку. Ссылка может быть сброшена на главное окно программы, как и файл, в этом случае она также будет скачана.
По умолчанию, все клавиши фильтруются программой, это делает возможным использование некоторых функций проигрывателя, таких как следующая или предыдущая демка или любое назначенное в настройках действие. Если фильр перехватывает какую-либо клавишу не назначенную в настройках, или если открыта консоль, он отправляет её игре. Фильтр клавиатуры может быть отключен в настройках.
| Действия и привязки клавиш по умолчанию | |
| Пауза | Пробел |
| Медленный timescale * | Delete |
| Быстрый timescale * | End |
| Очень быстрый timescale * | Page Down |
| Следующая демка | Вправо |
| Предыдущая демка | Влево |
| Увеличить громкость звука | Равно |
| Уменьшить громкость звука | Минус |
| Громкость звука 10-100% | 1-0 |
| Выключить звук | Backspace |
| Показать очки * | Tab |
| Показать меткость * | A |
| Показать окно чата | T |
| Сделать скриншот | F11 |
| Повторить текущую демку | Enter |
* Действие заканчивается, когда эта клавиша отпускается.
Также можно назначить свои действия, используя вкладку Пользовательские. В ней можно задавать действия, которые будут происходить как при нажатии клавиш, так и при их отпускании.
Это меню предоставляет возможность разорвать соединение с quakelive.com и закрыть плагин.
Игры могут кешировать настройки после воспроизведения демок. Для того, чтобы всегда играть с одними и теми же установками, нужно создать файл autoexec.cfg с настройками в директории baseq3. Но, по умолчанию, для просмотра демок Quake Live, и последующей игры с теми же настройками, autoexec.cfg не нужен. Так как Quake Live исполняется в окружении QLDT, был сделан запрет на сохранение игрой настроек, которые QLDT может изменить. Следующие настройки: r_fullscreen, r_mode, com_cameramode, r_inBrowserMode, cl_quitOnDemoCompleted, timescale, in_nograb, s_volume, cg_draw2D и com_allowConsole, после воспроизведения демки в QLDT останутся с прежними значениями. Этот запрет можно отключить в настройках, и, тогда, если в baseq3 нет файла autoexec.cfg, программа, перед просмотром демки, предложит его создать, иначе значения вышеперечисленных переменных могут повлиять на дальнейшую игру через браузер.
com_cameramode и Freeze tag:
Добавьте seta com_cameramode 0 в ваш демо-конфиг для того, чтобы видеть замороженное тело персонажа. Помните, что com_cameramode 0 остановит воспроизведение демки, после нажатия любой клавиши, которая не определена в настройках QLDT.
Эта настройка убирает задержку со статичным экраном и надписью "Waiting on Advertisement". По умолчанию она отключена, и, в этом режиме, пользователи без подписки не могут смотреть короткие демки. При редактировании задержка убирается автоматически, не зависимо от настроек программы. При использовании этой опции, изменения вносятся только во временные копии демок, выбранных для воспроизведения, а оригинальные их версии остаются без изменений.
Для воспроизведения демок Quake 3, QLDT запускает её процесс, указывая через командную строку, какой мод необходимо запустить, и передавая таким же образом другие настройки. Если, при запущенном процессе Quake 3, запустить другую демку этой же игры, он будет остановлен, и запущен заново, с другой демкой в командной строке.
Другие программы выполняются по тому же принципу, что и Quake 3, но без указания мода. Через настройки, программа может быть добавлена, как в контекстное меню определённых форматов, так и в действие вызываемое по двойному клику, или в действие предпросмотра редактируемой демки.
Настрока дополнительной программы на примере WolfcamQL (может быть найдена на форуме ESR):
После распаковки и настроки WolfcamQL, необходимо, в подкаталоге wolfcam-ql, создать ссылку на каталог demos из директории baseq3 Quake Live, для того, чтобы QL и другая программа, в данном случае WolfcamQL, могли работать вместе.
Перед созданием ссылки, нужно удалить или переместить каталог demos из подкаталога wolfcam-ql.
В Windows эту ссылку можно создать при помощи программы Junction. Например, если домашней директорией QL является C:\Documents and Settings\User\Application Data\id Software\quakelive\home, а WolfcamQL находится в C:\wolfcamql, команда для создания ссылки будет выглядеть так:
junction C:\wolfcamql\wolfcam-ql\demos "C:\Documents and Settings\User\Application Data\id Software\quakelive\home\baseq3\demos"
В GNU/Linux ссылку можно создать следующей командой, при условии что WolfcamQL находится в ~/wolfcamql:
ln -s ~/.quakelive/quakelive/home/baseq3/demos ~/wolfcamql/wolfcam-ql/demos
После этого, для полноценной работы, достаточно указать путь к исполняемому файлу WolfcamQL в настройках QLDT, и выбрать действия, при которых будет использоваться эта программа.
Записи всех таблиц можно редактировать при помощи двойного клика. Таблица справа от таблицы команд служит для более удобного редактирования информации о игроках или переменных. При редактировании названия команды в таблице команд, требуется вводить её код, поэтому эта операция не рекомендуется пользователем, не знакомым с протоколом игры.
Временная шкала служит для выбора частей демки, которые в дальнейшем могут быть включены в результат редактирования, или, наоборот, вырезаны из него. Если ничего не выбрано, то подразумевается, что выбрано всё. Серые зоны показывают разминку и паузы. Границы выбранных отрезков можно выделять и перемещать: мышью, перетаскивая их, или программно, изменяя соответствующее значение времени под шкалой. Кнопка справа от шкалы снимает выделение.
По умолчанию, красным, на временной шкале показаны продолжительные лаги, способные привести к показу сообщения Connection Interrupted.
Эти опции указывают QLDT не включать в результат редактирования все кадры относящиеся к разминке или паузам.
Эта опция предназначена для удаления некоторых эффектов лагов. Она может сделать игру полее плавной, но не более, потому что зачастую, эффекты вызванные лагами являются частью игры, и удаление их, в этом случае, может быть осуществлено только вырезанием части кадров.
Кроме возможности сохранить результат в виде демо файла, также можно сохранить его в форматах XML и TXT. При сохранении в XML , сохраняется вся структура демки и есть возможность в дальнейшем импортировать файл обратно. При сохранении в формате TXT, в файл записывается только исходный лог чата, без символов раскраски текста.
Эта функция ищет демки в базе данных по указанным критериям и выводит результат в отдельную таблицу. В текстовых полях могут использоваться специальные шаблонные символы, они могут быть заэкранированы при помощи символа \ (обратный слеш).
| Шаблонные символы | |
| ? | Вхождение любого одного символа. |
| * | Ноль или более вхождений любых символов. |
| [...] | В квадратных скобках могут быть представлены наборы символов, по аналогии с регулярными выражениями. |
Эта функция сканирует указанные демки в каталоге в поисках последовательности фрагов, сделанных игроком, записавшим демку, в соответствии с выбранными условиями. Фраги, сделанные во время разминки, игнорируются. Результат выводится в отдельную таблицу, с которой можно работать практически также, как и с основной.
В поле Игроки, имена игроков могут быть перечислены через запятую.
Следующее оружие: Rocket Launcher, Grenade Launcher, Plasma Gun и BFG 10K может делать фраги разбросом урона, т.е. не попадая снарядом напрямую в игрока. Отсеять подобные фраги, можно, включив настройку Только прямые попадания.
Эта функция ищет, в зависимости от протокола, команды chat, tchat и mm2, с текстом, полностью совпадающим с указанным. Результаты, как и при поиске фрагов, выводятся в отдельную таблицу. По умолчанию, поиск игнорирует цвета текста, то есть, например, при поиске строки gg, в результаты попадёт и строка ^7g^5g, и строка ^5g^7g, причём символы цветов будут исключены. Для поиска строки без игнорирования цветов, нужно выключить соответствующую опцию. Допускается использование шаблонных символов, как и при поиске демок.
Демки могут быть экспортированы в формат XML, в этом виде их содержимое может быть прочитано человеком, или обработано какой-либо программой. Также существует функция импорта, преобразующая демку из формата XML в формат игры.
Для удобства работы внешних программ, в QLDT, существуют ключи консоли для импорта и экспорта XML:
| -i | Импортировать указанную демку из XML |
| -e | Экспортировать указанную демку в XML |
| -o | Имя файла для экспорта или путь для импрота (опционально) |
При их использовании программа будет работать в консоли, и завершится после выполнения операции.
Исправление старых демок из беты QL: просмотр старых демок, записанных на некоторых картах, может вызвать ошибку CM_InlineModel: bad number. Эта функция автоматически обновляет демки, делая их пригодными к просмотру.
Простой текстовый редактор с вкладками, настраиваемой подсветкой синтаксиса для скриптов Quake (cfg, menu, h), автодополнением, и возможностями сортировки и сравнения двух конфигов. Существует в виде отдельной программы и используется в QLDT для редактирования конфигов. Кроме действий, перечисленных в меню Правка, сочетание Shift+Delete может быть использовано для удаления текущей строки.
Есть возможность настроить редактор для использования пользовательских файлов, содержащих списки действий, переменных, команд и клавиш. При включении режима использования пользовательских файлов, они будут автоматически созданы в указанной директории для их дальнейшего изменения. Редактор использует информацию из этих файлов для подсветки синтаксиса, при автодополнении, и при сравнении конфигов.
Функция сравнения конфигов, сравнивает переменные двух указанных конфигов и показывает различия. В случае, если в одном из конфигов не определена переменная, определённая в другом, вместо значения в таблице будет показан прочерк.