Not finished!

DSS 3.0, ? апреля 2000
=======================
DSS Copyright (c) 1995-2000 Сергей Сапелин (lrsp.chat.ru)
Compressed with UPX Copyright (c) 1996-1999 Markus Oberhumer & Laszlo Molnar
(http://www.nexus.hu/upx)

Содержание:
0. Введение
  0.0. Что такое DSS
  0.1. Список поддерживаемых звуковых карт
  0.2. Список поддерживаемых форматов файлов
1. Как работать с DSS
  1.0. Установка DSS на ваш компьютер
    1.0.0. Содержимое архива
    1.0.1. Стандартная установка DSS
    1.0.2. Конфигурирование
2. Использование
  2.0. Вызов из командной строки
3. Управление
4. Требования к системе
5. Распространение
6. Благодарности

0. Введение

Небольшая оговорка перед тем, как перейти к описанию DSS:

  Названия программ пишутся заглавными буквами, а имена файлов - прописными
  (т.е. DSS и myfile.wav).

0.0. Что такое DSS

DSS - плеер, рекордер и конвертор в одном флаконе, позволяющий удобно
проигрывать, записывать и конвертировать звуковые файлы в ДОС.

0.1. Список поддерживаемых звуковых карт.

В качестве устройств ввода-вывода звука DSS поддерживает следующие звуковые
карты:
  Sound Blaster series device (воспроизведение, запись):
    SoundBlaster 1.0, 2.0, Pro, 16, а также более старшие модели.
  Windows Sound System CODEC (воспроизведение, запись):
    Microsoft Sound System-совместимые, а также основанные на кодеках
    AD1848, AD1845, AD1847,
    CS4248, CS4231(a), CS4232, CS4236 и совместимых с ними.
  ESS AudioDrive series device (воспроизведение, запись):
    ES688, ES1688, ES1868, ES1869.
  Aztech SoundGalaxy series device (воспроизведение, запись):
    Звуковые карты Aztech серии SoundGalaxy.
  OPTi audio chips (воспроизведение, запись):
    OAK OTI-601D Mozart, OPTi 82C928 MAD16, OPTi 82C929 MAD16 Pro,
    OPTi 82C930, OPTi 82C931, OPTi 82C924.
  Gravis UltraSound Max/PnP (воспроизведение, запись):
    Gravis UltraSound Max, Gravis UltraSound PnP.
  Super High Quality Quiet sound device (воспроизведение, запись):
    Все, что угодно.
  Internal PC speaker (только воспроизведение):
    Internal PC Speaker.
  Covox sound device on LPT: (только воспроизведение):
    Disney Sound Source, Covox on LPT.

0.2. Список поддерживаемых форматов файлов.

Для сохранения/воспроизведения данных используются следующие форматы файлов:
  PCM [.WAV] (чтение, запись).
  CCITT A-law [.WAV] (чтение, запись).
  CCITT mu-law [.WAV] (чтение, запись).
  DVI/IMA ADPCM [.WAV] (чтение, запись).
  Microsoft ADPCM [.WAV] (чтение, запись).
  Microsoft ADPCM (HQ) [.WAV] (чтение, запись).
  MPEG Audio [.MPx] (чтение, запись).
  Direct CD-Audio reading [.CDA] (чтение).
    Дисковод должен поддерживать команду ReadLong для Audio-дисков.
  PCM [.VOC] (чтение).
  General MIDI [.MID] (чтение).

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

1. Как работать с DSS

1.0. Установка DSS на ваш компьютер

Для установки DSS на ваш компьютер необходимо распаковать содержимое архива
и отконфигурировать DSS.

1.0.0. Содержимое архива

В полный комплект поставки входят следующие файлы:

    DSS.EXE      - сама программа.
    DSS.XLT      - таблица перекодирования Win->DOS для чтения
                   русских символов в ID3Tag'ах.
    DSS.TXT      - описание программы.
    HISTORY.TXT  - история изменений.
    REGISTER.TXT - регистрационная форма.

Также возможно присутствие и других файлов, таких как FILE_ID.DIZ и др.

1.0.1. Стандартная установка DSS

Распакуйте содержимое архива в выбранный каталог и отконфигурируйте программу.

1.0.2. Конфигурирование

Для конфигурирования DSS необходимо воспользоваться любым текстовым
редактором для изменения настроек в файле DSS.INI.

2. Использование

2.0. Вызов из командной строки

Общий формат вызова:

    DSS [!файл-список] [исходный файл] [выходной файл] [ключи]

По умолчанию DSS - плеер. При отсутствии имени файла

    DSS

будет запущен файлселектор. В качестве имени файла можно указывать как
конкретное имя файла:

    DSS myfile.wav

, так и маски

    DSS *.mp3

или файл-список:

    DSS !playlist.m3u

Замечание: для указания файла-списка используется символ "!".
Для проигрывания файлов, начинающихся с символа "!", необходимо добавить
к имени файла путь:

    DSS .\!my_file.mp3

    DSS c:\dir\!name.mp3

Для использования DSS в качестве рекордера необходимо указать имя файла и
ключ "/r":

    DSS new_file.wav /r

Для конвертирования из одного формата в другой - два имени файла и ключ "/t":

    DSS file.mp3 file.wav /t

Ключи программы:
  /?         - вызов помощи по ключам программы.

    DSS /?
    показать помощь по клавишам.

  /L[+-]     - повторное воспроизведение файлов.
               "+" - включить, "-" - выключить.
               Отсутствие дополнительного символа переключит значение по
               умолчанию.

    DSS myfile.wav /L+
    играть myfile.wav бесконечно долго.

  /M[n][.m]  - включить соответствующий режим/подрежим после запуска.
               Режимы нумеруются по назначенным клавишам:
               2 (F2) - VU meters, 3 (F3) - Spectrum Analyser и т.д.
               Подрежимы нумеруются с 0.

    DSS myfile.wav /M2.0
    при проигрывании включить VU meters
    DSS myfile.wav /M5
    при проигрывании включить Oscilloscope
    DSS myfile.wav /M.1
    при проигрывании включить второй подрежим текущего режима.

  /A<n>      - установить значение для программного усиления при
               воспроизведении/конвертировании в %.

    DSS infile.wav outfile.wav /T /A200
    усилить infile.wav в 2 раза и записать в outfile.wav

  /AN[+-]    - автоматическая коррекция громкости звучания.
               "+" - включить, "-" - выключить.
               Отсутствие дополнительного символа переключит значение по
               умолчанию.

    DSS myfile.wav /AN+
    играть myfile.wav с коррекцией громкости звучания

  /RND[+-]   - сортировать случайным образом список файлов для проигрывания.
               "+" - включить, "-" - выключить.
               Отсутствие дополнительного символа переключит значение по
               умолчанию.

    DSS !playlist.m3u /RND-
    играть файлы по порядку следования в списке
    DSS *.mp3 /RND+
    играть все .mp3 файлы в каталоге случайным образом

  /T         - включить режим конвертирования
               ! запроса на перезапись существующего файла не производится !

    DSS infile.wav outfile.wav /t
    конвертировать infile.wav в outfile.wav

  /R         - включить режим записи

    DSS newfile.wav /r
    записать файл newfile.wav

  /B         - начать запись сразу после запуска
               используется только совместно с /R

    DSS newfile.wav /r /b
    начать записывать файл newfile.wav сразу после запуска

  /O         - не выводить предупреждение при перезаписи файла
               используется только совместно с /R

    DSS newfile.wav /r /o
    записать файл newfile.wav
    если файл уже существует - перезаписать без вопросов

  /F<n>      - установить частоту дискретизации для записи или
               предельную частоту дискретизации при конвертировании.
               используется совместно с /t или /r

    DSS newfile.wav /r /f22050
    записать файл newfile.wav с частотой дискретизации 22050 Гц
    DSS infile.wav outfile.wav /t /f22050
    конвертировать infile.wav в outfile.wav
    если при этом файл infile.wav имеет бОльшую частоту дискретизации,
    чем 22050, она будет снижена.
    Следует заметить, что снижение производится в 2, 4 или в 8 раз.
    Т.е. 32000=>(граница 22050)=>16000

  /S<n>      - установить разрядность для записи или
               предельную разрядность при конвертировании.
               используется совместно с /t или /r

    DSS newfile.wav /r /s8
    записать файл newfile.wav с разрядностью сэмплов 8 бит
    DSS infile.wav outfile.wav /t /s8
    конвертировать infile.wav в outfile.wav
    если при этом файл infile.wav имеет бОльшую разрядность,
    чем 8, она будет снижена.
    Следует заметить, что снижение производится только с 16 до 8 бит

  /C<n>      - установить число каналов для записи или
               предельное число каналов при конвертировании.
               используется совместно с /t или /r

    DSS newfile.wav /r /c2
    записать файл newfile.wav в Stereo-режиме
    DSS infile.wav outfile.wav /t /c1
    конвертировать infile.wav в outfile.wav
    если при этом файл infile.wav имеет больше 1 канала,
    в outfile.wav будет помещен только один,
    являющийся средним арифметическим от двух исходных

  /I<src>      - установить источник для записи
               источник устанавливается с помощью символов:
                 M - Mic
                 F - FM
                 C - CD Audio
                 L - Line In
                 A - Aux In
                 I - Input Mix
               используется только совместно с /r
             ! Некоторые звуковые устройства не поддерживают запись
             ! с двух и более источников

    DSS newfile.wav /r /iMC
    записать newfile.wav, используя сигнал с входов Mic и CD Audio
    DSS newfile.wav /r /iL
    записать newfile.wav, используя сигнал с линейного входа

  /P<n>      - указать формат записываемого файла
               форматы распределены следующим образом:
                 1 - PCM [.WAV]
                 3 - CCITT A-law [.WAV]
                 4 - CCITT mu-law [.WAV]
                 5 - DVI/IMA ADPCM [.WAV]
                 6 - Microsoft ADPCM [.WAV]
                 8 - MPEG Audio [.MPA]
               5, 6 и 8 форматы не поддерживают исходные данные
               в виде 8-битных сэмплов
               используется совместно с /t или /r

    DSS infile.wav outfile.wav /t /p6
    конвертировать из infile.wav в outfile.wav, причем последний имеет формат
    Microsoft ADPCM

  /UA[+-]   - использование функций драйвера VBEAF.DRV
               "+" - включить, "-" - выключить.
               Отсутствие дополнительного символа переключит значение по
               умолчанию.

    DSS myfile.wav /UA-
    при выводе на экран использовать VESA BIOS вместо VBEAF.DRV

  /UBF[+-]  - использование шрифта BIOS вместо внутреннего
               "+" - включить, "-" - выключить.
               Отсутствие дополнительного символа переключит значение по
               умолчанию.

    DSS myfile.wav /UBF+
    использовать шрифт BIOS 8x16 вместо внутреннего (не руссифицированного)

  /SSD<d>   - передать строку <d> модулю SDEVICE(управление звуковой картой)
    SDEVICE "понимает" следующие ключи:
      /DM   - фальсифицировать блок "возможностей" устройства
              и отключить все Stereo-режимы
      /DS2
      /DS4
      /DS8  - фальсифицировать блок "возможностей" устройства
              и уменьшить максимальную частоту дискретизации в 2,4 и 8 раз.

    Данные ключи бывают полезны для владельцев "медленных" машин, чтобы
    проигрывать, например, MPEG-файлы с понижением частоты.
    Пример: SB Pro: "умеет" 44100 Mono и 22050 Stereo.
            myfile.mp3 - 44100 Stereo

      DSS myfile.mp3 /SSD/DM
      файл будет проигран как 44100 Mono, иначе - 22050 Stereo.

    Пример: зв.устройство может воспроизводить 48000 Гц в любых режимах.
            myfile1.mp3 - 44100 Stereo
            myfile2.mp3 - 22050 Stereo

      DSS myfile1.mp3 /SSD/DS2
      файл будет проигран как 22050 Stereo
      т.е. будет понижена частота и уменьшено время декодирования
      DSS myfile2.mp3 /SSD/DS2
      файл будет проигран как 22050 Stereo частота понижена не будет
      т.к. делится не частота файла, а частота зв.устройства

  /SSF<d>   - передать строку <d> модулю SNDFILE(манипуляции с файлами)
    SNDFILE "понимает" следующие ключи:
      /ST     - играть Mono-файлы как Stereo.
                (работает только в случае, если автоконвертирование в более
                 низкие режимы не требуется и стерео-режим доступен)

    DSS myfile.mp3 /SSF/ST
    файл будет проигран как Stereo

      /L<n>   - указывает слой ;-) для упаковки Audio MPEG
      /SMS    -
      /SMJS   -
      /SMDC   - указывает режим упаковки Stereo-сигнала упаковщику Audio MPEG
                соответственно Stereo, Joint-Stereo, Dual Channel.
      /BR<n>  - указывает битрейт для упаковки Audio MPEG

    DSS infile.wav outfile.mp2 /t /p8 /SSF/L2/SMJS/BR192000
    конвертируется из infile.wav в outfile.mp2 с параметрами:
      Layer-II, 192кбит/с, Joint-Stereo, если исходный файл - Stereo
      Layer-II, 192кбит/с, Mono, если исходный файл - Mono

      /DEC<n> - указывает тип декодера для распаковки MPEG
                (-1 - определить; 0 - 486; 1 - iP; 2 - 3DNow!; 3 - integer)

    DSS infile.mp3 /SSF/DEC2
    проиграть infile.mp3, используя при этом декодер для процессоров с 3DNow!

      /MSADQ<n>-указывает качество при упаковке MS ADPCM (в %)
                (по умолчанию - 100%)

    DSS infile.wav outfile.wav /t /p6 /SSF/MSADQ0
    конвертируется из infile.wav в outfile.wav с высшей скоростью

      /MSEFF  - включить обработку эффектов в синтезаторе
                (требует "a lot of CPU power")
      /MSV<n> - использовать n-голосовую полифонию в синтезаторе
                (значение по умолчанию - 64(максимальное))

    DSS infile.mid /SSF/MSEFF/MSV32
    проиграть infile.mid, обрабатывая эффекты и используя 32-голосую
    полифонию

      /CCDD   - создать файл описания для нового компакт-диска
                путь к файлам создается из переменной окружения DN
                с добавлением CD\
                ("Based on Dos Navigator by RIT Research Labs.")

    DSS Z:\TRACK00.CDA /SSF/CCDD
    проигрываются все треки компакт-диска в дисководе Z:\
    если файл описания компакт-диска отсутствует, он будет создан

  /SVM<d>   - передать строку <d> модулю VMODE(визуализация)
    VMODE "понимает" следующие ключи:
      /SCSH   - выводить в режиме VU meter-ов
                индикатор сдвига между каналами.

Ключи, передаваемые по /SSD, /SSF или /SVM должны писаться _слитно_.
Во всех остальных случаях - раздельно.

Особо стоит отметить чтение такого формата, как PCM [.CDA].
  Для воспроизведения треков с компакт-дисков следует указать:

  DSS X:\trackYY.cda, где  X - имя дисковода для компакт-дисков,
                          YY - _двузначный_ номер трека. 00 - весь диск.

  Соответственно, если воспользоваться возможностью конвертирования, можно
  указать:

  DSS z:\track01.cda c:\track01.wav /t
  и получить копию CD-трека у себя на жестком диске.

3. Управление

Для управления программой можно использовать следующие клавиши:

  Esc           выход/возврат в файлселектор
  Enter         плеер:
                  выход, переход к следующему файлу, возврат в файлселектор
                  выход осуществляется в случае, если программа была запущена
                  с именем файла.
                  переход к следующему файлу в случае, если проигрываются
                  файлы по списку, по маске, помеченые файлы из
                  файл-селектора.
                  возврат в файл-селектор в случае, если файл был запушен из
                  файл-селектора.
                рекордер:
                  останов/запуск записи.
  Up/Down       плеер:
                  увеличение/уменьшение громкости.
                рекордер:
                  увеливение/уменьшение уровня записи.

Следующие клавиши действуют только в режиме плеера:
  Ctrl-PgUp     увеличить усиление на 12.5%
                  (если выключено автоматическое регулирование)
  Ctrl-PgDn     уменьшить усиление на 12.5%
                  (если выключено автоматическое регулирование)
  Ctrl-Home     установить усиление на 100%
                  (если выключено автоматическое регулирование)
  Ctrl-End      установить усиление в соответствии
                с текущим значением аккумулятора
                  (если выключено автоматическое регулирование)
  Ctrl-Del      сброс аккумулятора
                  (если выключено автоматическое регулирование)
  Ctrl-Ins      переключение автоматической регулировки усиления

  Left/Right    перемотка назад/вперед на 10 сек
  Shift-Left    перемотка назад на 1 сек
  Shift-Right   перемотка вперед на 1 сек
  Ctrl-Left     перемотка назад на 1 мин
  Ctrl-Right    перемотка вперед на 1 мин
  BackSpace     перемотка на начало файла
    Если перемотка выходит за границы файла, производится переход к
    началу(при включенном зацикливании) иначе переход к следующему/выход
    Перемотка на начало файла по сути является перемоткой "за конец" файла,
    и, следовательно, приведет к выходу из плеера при отключенном режиме
    зацикливания.

  L             переключить зацикливание
  N             переход к следующему файлу (эквивалентно Enter)
  P             переход к предыдущему файлу либо в начало текущего,
                если в начале списка

Клавиши управления визуализацией(режим плеера и рекордера):

  F1            Вызвать помощь по клавишам
  F2            VU meters
  F3            Spectrum Analyser
  F4            Psychedelic Lights
  F5            Oscilloscope
  F6            Phase Graph
  F7            Voice Print
  F8            Oscilloscope Flowers

Клавиши управления в режиме помощи по клавишам:
  Esc/F1        покинуть помощь
  Up/Down       перемещение по линии
  PgUp/PgDn     перемещение по странице

Клавиши управления в режиме VU meter keys:
  F2            переключение подрежима:
                  линейный/логарифмический/уровень мощности
  Shift-F2      сброс индикаторов перегрузки

Клавиши управления в режиме Spectrum analyser keys:
  F3            переключение подрежима:
                  64/128/256 полос в тексте, 128 полос в графике, пламя
  Shift-F3      переключение цветовой схемы
  PgUp/PgDn     смещение частоты анализатора
  Home          установить частоту анализатора на ~5512 Гц
  End           установить максимальную частоту анализатора

Клавиши управления в режиме Psyhodelic lights keys:
  Q/q           увеличить/уменьшить яркость низких частот
  W/w           увеличить/уменьшить яркость средних частот
  E/e           увеличить/уменьшить яркость высоких частот
  A/a           увеличить/уменьшить яркость всех частот
  S             сохранить насторойки
  D             восстановить настройки

Клавиши управления в режиме Oscilloscope keys:
  F5            переключение подрежима:
                  малый/большой осциллоскоп
  Shift-F5      переключение подрежима:
                  точки/линии

Клавиши управления в режиме Phase graphs keys:
  F6            переключение подрежима:
                  фазовый/стерео-разностный
  PgUp/PgDn     увеличить/уменьшить масштаб
  Home          установить масштаб по умолчанию

Клавиши управления в режиме Voice print keys:
  F7            переключение подрежима:
                  спектральный/волновой
  Shift-F7      переключение цветовой схемы
  PgUp/PgDn     смещение частоты анализатора (в спектральном виде)
  Home          установить частоту анализатора на ~5512 Гц
                  (в спектральном виде)
  End           установить максимальную частоту анализатора
                  (в спектральном виде)
    Все изменения в спектральном виде изменяют аналогичные параметры в
    Spectrum Analyser'e.

Клавиши управления в режиме Oscilloscope flowers keys:
  F8            переключение подрежима:
                  точки/линии

Клавиши управления файл-селектором:
  Esc           выход/возврат в плеер
  Enter         сменить каталог/запустить файл на проигрывание
  Ctrl-Enter    запустить помеченные/загрузить файл-список/
                проиграть внутренний список
  Ctrl-Ins      добавить файл во внутренний список
  Ctrl-Del      удалить файл из внутреннего списка
  Ctrl-Home     очистить внутренний список
  Space/Insert  пометить/снять отметку с текущего файла
  Tab           краткий/полный режим отображения
  Alt+<буква>   переход на другой диск
  Ctrl-Left     переход на предыдущий диск
  Ctrl-Right    переход на следующий диск
  Up/Down/
  Left/Right/
  PgUp/PgDn/
  Home/End      перемещение указателя
  F1            вызов справки по файлселектору
  <буква>       быстрый поиск
  Ctrl-R        перечитать каталог
  Ctrl-PgUp     перейти в предыдущий каталог
  Ctrl-PgDn     перейти в следующий каталог
  Ctrl-\        перейти в корневой каталог
  Ctrl-F        показывать только поддерживаемые типы файлов
  Ctrl-S        сканировать только поддерживаемые типы файлов
  F8/Del        удаление файла\пустого каталога
  Shift-F9      сохранить текущие установки

4. Требования к системе

Процессор: 386 с сопроцессором.
Клавиатура: 101/102-key AT keyboard.
Видеокарта: VGA с цветным монитором.
Память: 4Mb.

5. Распространение

!! Это важно !!

Программа постоянно совершенствуется и доводится, поэтому она может не
работать так(работать не так), как описано в этой документации. С другой
стороны, документация не всегда может отражать существующее положение вещей с
программой. Просьба, при обнаружении каких-либо ошибок или несоответствий,
сообщать об этом автору программы (см.ниже).

DSS относится к классу свободнораспространяемого программного обеспечения
(freeware). Это означает, что вы можете:

  1) Пользоваться программой абсолютно бесплатно.

  2) Копировать программу кому бы то ни было, не спрашивая чьего-либо
  разрешения.

  3) Высказать автору свою признательность за написание DSS'а, передав ему
  любым, доступным для вас, способом, любую, доступную для вас сумму, которая
  будет принята с благодарностью. Должны предупредить, что подобный шаг с
  вашей стороны не обязывает автора к чему бы то ни было и расценивается
  только как благотворительность.

В то же время вы не должны:

  1) Менять что-либо в сообщениях программы или в этом файле.

  2) Использовать программу с целью наживы без дележа с её создателем.

  3) Предъявлять автору какие-либо претензии. Вы вольны пользоваться или
  не пользоваться этой программой. Её создатель не несёт никакой
  ответственности за последствия её работы.

6. Благодарности

Вадиму Очкину за ценные советы,
Алексею Елизарову за детектор формата бесформатных файлов,
Сергею Чехута, Андрею Белову, Арсению Никифорову, ДимаСу Щербина и
Сергею Вишнякову за тестирование и помощь в отлове багов,
Владимиру Оленину за предоставленную документацию по звуковым картам,
сестре Иринке за постоянную моральную поддержку, а также
Васе Ефимову за '"Колокольчик", батон "Нарезного" и 4.5 рубля чистой прибыли'.

Сегрей Сапелин (программа, документация):
  д.т.: (095) 501-8101 доб.3-18
  FIDO: 2:5020/1844.33 aka 2:5020/1375.33 aka 2:5020/1036.33
  E-Mail: sergey_sapelin@mtu-net.ru; lrsp@chat.ru
  WWW: http://lrsp.chat.ru/
