
****************************************************

Содержание:

1) Базовая информация

2) Системные требования

3) Настройка плагина

4) Советы

5) Известные проблемы

6) Лицензия

7) Контакты

****************************************************

1) Базовая информация

Blade_Arma_CDR_Plugin – cdrom плагин, часть проекта rbpse, портирован на 
систему PSEmuPro. (эмуляторы ePSXe, SSSPSX, PSXeven, PCSX, AdriPSX и другие.)

Введение:

Пффф, пожалуй стоит написать пару слов о cdr плагине. Вообще это не совсем 
нормальный плагин, плагин эмулятора это - часть кода отвечающая за эмуляцию 
какой-либо подсистемы консоли, вынесенная в динамическую библиотеку. Например 
gpu плагин получает доступ к обоим портам/дма/памяти графической подсистемы и 
полностью отвечает за выводимую картинку. Cdr плагин же в данном случае 
является всего лишь библиотекой упрощающей чтение сектора/проигрывание CD-DA 
музыки для эмулятора. Т.е. никакие "пляски с бубном" в отношении cdr плагина в 
интерфейсе psemupro не позволят улучшить эмуляцию, эта задача полностью лежит 
на эмуляторе. Из сказанного выше можно вывести цель, которая преследовалась при 
написании плагина, это:
• Удобство выбора CD, лично мне более интересны образы, а не виртуальные 
устройства cdrom созданные с помощью других программ. Плагин позволяет указать 
устройства чтения cd и каталоги содержащие образы, после чего автоматически 
создаётся список со всеми найденными cd. Для запуска игры понадобится лишь 
дважды кликнув мышкой. Для упрощения поиска реализован фильтр, набрав в котором 
часть названия игры получаем список с совпадениями в названии.
• Проигрывание CDDA музыки.
• Использование субканальных данных в форматах sub/sbi/m3s.
• Применение PPF.

Поддерживаемые форматы образов:
«cue/bin», «ccd/img», «mds/mdf», «toc/bin».

Инсталляция:

Распаковываем архив cdrBlade.7z в каталог с эмулятором.

Загружаем gtk-runtime для работы гуи:
Windows: http://sourceforge.net/projects/gtk-win/
Linux: из репозитория вашего дистрибутива.

Загружаем OpenAL для проигрывания CDDA музыки:
Windows: http://connect.creativelabs.com/openal/Downloads/oalinst.zip
Linux: из репозитория вашего дистрибутива.

Устанавливаем,
перезагружаемся.

Выбираем плагин в эмуляторе.

Если есть желание установить всё ручками, то надо знать следующее:
CDR плагин «cdrBlade.so»/«cdrBlade.dll» должен находится в каталоге с плагинами 
(«./plugins»). GUI для настройки плагина «cdrBladeGui»/«cdrBladeGui.exe» и файл 
настройки «cdrBlade.ini» должны находится в каталоге с настройками 
(«./configs»).

****************************************************

2) Системные требования

Программные:

– ОС Linux, ядро 2.6 или выше / ОС Windows 2000 или выше.
– Gtk 2.16 или выше для гуи на gtk.
– OpenAL.

Аппаратные:

– CD-привод.
– OpenAL совместимая звуковая карта.

****************************************************

3) Настройка плагина

ЗАКЛАДКА «SETTINGS»

ЗАКЛАДКА «CD SELECTION»

«Recently opened ->»
Список с недавно используемыми cd.

«Edit CD-ROM's list / cd images directory list»
Вызвать диалог редактирования списка cd устройств и списка каталогов с образами 
cd/demo.

«Update»
Произвести повторный поиск образов. (Если образы были добавлены в то время, 
когда диалог настройки плагина уже был запущен.)

«Get ID»
Получить ID диска в виде XXXX-XXXXX.
(SLUS-00330, SLPS-01300 и т.д.)

«Calc md5»
Вычислить контрольную сумму cd.

«Filter»
Строка вводимая с клавиатуры. Позволяет отбросить все образы, названия которых 
не содержат в себе побуквенного совпадения с фильтром.

ЗАКЛАДКА «CD-ROM PROPERTIES»

«Play CDXA music»
Воспроизводить CDXA музыку.

«CDXA volume level»
(Может принимать значения в пределах: 0 - 100.)

«Play CDDA music»
Воспроизводить CDDA музыку.

«CDDA volume level»
(Может принимать значения в пределах: 0 - 100.)

«Enable PPF sector patching»
Включить патчинг секторов, если найден ppf имеющий то же название что и образ.

«Read subchannels data»
Считывать субканальные данные с диска. Следует обязательно включать если игра 
имеет защиту от копирования.

«Speed limitation»
Ограничение скорости вращения CD-ROM'а.
(Может принимать значения в пределах: 0 – 32, 0 – выключено.)

«Try again on error»
Количество повторных чтений, если произошла ошибка чтения CD-диска.
(Может принимать значения в пределах: 0 - 16.)

«Spindown time»
FIXME

«Caching strategy»
Включение/выключение работы кэша.
Disabled – кэширование выключено.
Read one sector at a time – чтение одного сектора за раз. Используется для 
увеличения скорости за счёт сохранения прочитанных секторов в оперативной 
памяти. Практически обязательно должно использоваться для устройства CD-ROM. 
Если игра запущена с образа, смысл в использовании кэширования заметно меньше.

«Сache size»
Размер кэша.
(Параметр измеряется секторами, от 10 до 100000, один сектор равен 2448-ми 
байтам.)

ЗАКЛАДКА «MISC»

Hot keys:

«Config dialog»
Установить кнопку для вызова диалога конфигурации плагина во время игры.
(По умолчанию: 'Ctrl+Alt+С'.)

«Show status»
Установить кнопку для включения/выключения отображения статуса плагина во время 
игры.

«Toggle CDXA»
Установить кнопку для включения/выключения проигрывания CDXA музыки.

«Toggle CDDA»
Установить кнопку для включения/выключения проигрывания CDDA музыки.

«Decrease CDXA volume»
Установить кнопку для ослабления громкости CDXA музыки.

«Increase CDXA volume»
Установить кнопку для усиления громкости CDXA музыки.

«Decrease CDDA volume»
Установить кнопку для ослабления громкости CDDA музыки.

«Increase CDDA volume»
Установить кнопку для усиления громкости CDDA музыки.

«Open cover»
Установить кнопку для открытия крышки CD-ROM во время игры.

«Close cover»
Установить кнопку для закрытия крышки CD-ROM во время игры.

«CD swapping»
Установить кнопку для смены CD.
Последовательно выполняется:
- открытие крышки.
- вызов диалога для выбора диска.
- закрытие крышки.

Other:

«Show status»
Отображать статус плагина при старте.

«Cover opened»
Открыть крышку CD-ROM при старте.

«Call dialog on emu start»
FIXME

«Enable logging»
Включить запись отладочной информации в файл (cdrBlade.log).

«Save dialog parameters»
Сохранять размер и положения диалога при выходе. (Если выключено, диалог будет 
отображён в центре экрана с размером по умолчанию.)

«Save the settings on exit»
Сохранять изменения таких параметров как - громкость звука, состояние крышки 
CD-ROM, отображение информации и т.д. при выходе.

****************************************************

4) Советы

Субканальные данные в формате «sbi» для защищённых игр можно взять тут:
http://redump.org/discs/page/all/libcrypt/2/

Для образов («bin», «img») с играми, состоящими из нескольких треков (например, 
с CDDA музыкой), для корректной работы НЕОБХОДИМЫ файлы разметки («cue», 
«ccd»). Файл образ, файл разметки, файл с субканальными данными должны иметь 
одинаковые названия.
(«Final Fantasy 9.img», «Final Fantasy 9.ccd», «Final Fantasy 9.sub»)

Образ формата «toc/bin» создаётся с помощью программы readcd/readom.
Получение идентификаторов cdrom:
  readcd -scanbus
Снятие образа:
  readcd dev=x,x,x -clone -noerror retries=4 f=~/cdimage.bin
Файл разметки получит название «cdimage.toc». Данные и данные субканалов 
сохранятся в «cdimage.bun».

****************************************************

5) Известные проблемы

«iso» – это образ диска в формате mode1/xa, размер сектора 2048 байт, не 
следует путать его с mode2/xa, где размер сектора 2352 байта, такие образы 
следует переименовать в «bin», а заодно неплохо бы к нему найти файл разметки 
«cue», а лучший вариант переименовать его в «img», найти к нему файл разметки 
«ccd» и субканальные данные «sub». :)

Не все устройства CD-ROM поддерживают ограничение скорости вращения диска.

****************************************************

6) Лицензия

This program is freeware and cannot be sold. Also this program cannot be 
distributed without written permission. This program cannot be used for any 
commercial purposes. You may not reverse engineer, decompile, or disassemble 
the enclosed software. Authors are not responsible for any damages that this 
program may cause, and are also not responsible for anything this plugin will 
be used for.

****************************************************

7) Контакты

http://forum.emu-russia.net
irc://irc.newnet.net:6667/emu-russia
mailto:edgbla@yandex.ru

****************************************************
