DOSBox для пользователей

Ключи командной строки

Обзор ключей, которые вы можете задать при запуске DOSBox. Хотя в большинстве случаев проще использовать вместо них конфигурационный файл DOSBox. См. раздел "конфигурационный файл"

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

• Windows: откройте cmd.exe или command.com или отредактируйте ярлык для dosbox.exe
  
• Linux: используйте консоль
  
• MAC OS X: запустите terminal.app и перейдите в: /applications/dosbox.app/contents/macos/dosbox
  

Ключи доступны во всех операционных системах, если в их описании не сказано иначе:

dosbox [директория_или_программа] [-exit] [-c команда] [-fullscreen] [-userconf] [-conf файл_конфигурации] [-lang языковой_файл] [-machine тип_машины] [-noconsole] [-startmapper] [-noautoexec] [-securemode] [-scaler метод_масштабирования | -forcescaler метод_масштабирования] [-version] [-socket номер_сокета]

директория_или_программа
Если это директория, она будет смонтирована как диск C:.
Если это исполняемый файл, будет смонтирована директория в которой находится этот файл как диск C:, и этот файл будет запущен.

-exit
DOSBox закроется, когда DOS приложение "директория_или_программа" закончит работу.

-c команда
Выполняет определенные команды до запуска "директория_или_программа". Может быть выполнено несколько команд. Каждая команда должна начинаться с параметра "-c". Команда может быть: внутренней программой, DOS командой или исполняемым файлом на смонтированном диске.

-fullscreen
Запускает DOSBox в полноэкранном режиме.

-userconf
Запускает DOSBox с конфигурационным файлом из профиля пользователя. Может использоваться совместно с множественными параметрами "-conf файл_конфигурации", но -userconf всегда загружается перед ними.

-conf файл_конфигурации
Запускает DOSBox с настройками, назначенными в файле конфигурации. Может быть несколько "-conf файл_конфигурации". Смотрите раздел "конфигурационный файл" для подробностей.

-lang языковой_файл
Запускает DOSBox, используя язык, определенный в языковом файле. См. подробнее в разделе "Языковой файл".

-machine тип_машины
Задает DOSBox эмулировать конкретный тип машины. Доступны для выбора:
hercules, cga, ega, pcjr, tandy, svga_s3 (по-умолчанию), а также дополнительные svga карты, перечисленные в комментариях к конфигурационному файлу DOSBox. svga_s3 также включает эмуляцию vesa.
Для некоторых видео эффектов VGA нужно указать тип vgaonly. помните, что это отключит возможности svga и может быть заметно медленнее из-за большей точности эмуляции.
Тип машины влияет на эмулируемую видео карту и доступные звуковые карты.

-noconsole (Только Windows)
Запускает DOSBox без окна состояния. Вывод будет перенаправлен в stdout.txt и stderr.txt

-startmapper
Войти в режим назначения клавиш непосредственно при старте. Полезно для тех, у кого проблемы с клавиатурой.

-noautoexec
Пропустить секцию [autoexec] загруженного конфигурационного файла(ов).

-securemode
То же, что и -noautoexec, но добавляет "config.com -securemode" в конец AUTOEXEC.BAT (который, в свою очередь, запрещает любые изменения в монтируемых дисках внутри DOSBox).

-scaler метод_масштабирования
Использует метод масштабирования (scaler) определенный параметром "метод_масштабирования".

-forcescaler метод_масштабирования
Подобен параметру -scaler, но пытается принудительно применить указанный метод масштабирования, даже если он может не подойти по размеру окна (то-есть, превышает его).

-version
Вывести информацию о версии и выйти. Полезно для оболочек.

-editconf программа
Запускает указанную программу, передав ей конфигурационный файл в качестве первого параметра. Вы можете задать эту команду несколько раз. В этом случае вторая программа будет запущена, если первая не запустится.

-opencaptures программа
Запускает указанную программу, передав ей путь к папке скриншотов в качестве первого параметра.

-printconf
Выводит расположение конфигурационного файла по умолчанию.

-eraseconf
-resetconf
Удаляет конфигурационный файл по умолчанию.

-erasemapper
-resetmapper
Удаляет файл переназначения клавиш, используемый конфигурацией по-умолчанию.

-socket номер_сокета
Передает номер сокета модулю эмуляции нуль-модема. См. раздел "Сетевая игра через прямое кабельное подключение"


Замечание:
Если имя/команда/конфигурационный файл/языковой файл содержит пробелы внутри, пишите все имя/команда/конфигурационный файл/языковой файл в кавычках ("команда или имя файла"). Если вам необходимо использовать кавычки внутри кавычек (обычно в параметре -c и монтировании):

Пользователи Windows и OS/2 могут писать одинарные кавычки внутри двойных. Остальные - комбинации со слешем (\) внутри двойных кавычек.

Windows:

-c "mount c 'c:\program files\'"

Linux:

-c "mount c \"/tmp/name with space\""

Достаточно необычный пример, просто для демонстрации (Windows):

dosbox D:\folder\file.exe -c "MOUNT Y H:\MyFolder"

Будет смонтирована D:\folder как C:\ и запущен file.exe. Но до этого будет смонтирована H:\MyFolder как диск Y.

В Windows вы также можете перетащить папки/файлы на исполняемый файл dosbox.

Внутренние программы

DOSBox поддерживает большинство команд DOS имеющихся в command.com. Для получения списка внутренних команд введите HELP в командной строке. Также в дополнение к ним, доступны следующие команды:

MOUNT

MOUNT [Буква_эмулируемого_диска] [Реальный_диск_или_директория] [-t тип] [-aspi] [-ioctl] [-noioctl] [-usecd номер] [-size геометрия_диска] [-label имя_диска] [-freesize объём_свободного_места]
MOUNT -cd
MOUNT -u Буква_эмулируемого_диска
Программа для монтирования локальных директорий как дисков внутри DOSBox.

Буква_эмулируемого_диска
Буква диска внутри dosbox (например, C).

Реальный_диск_или_директория
Локальная директория, которую вы хотите видеть внутри dosbox.

-t тип
Тип монтируемой директории. Поддерживаются: dir (по-умолчанию, если тип не указан), floppy, cdrom.

-size геометрия_диска (только для опытных пользователей)
Устанавливает геометрию диска, где геометрия диска задается по форме bps,spc,tcl,fcl:
bps: байт в секторе, по-умолчанию 512 для HDD дисков и 2048 для CD-ROM дисков
spc: секторов в кластере, обычно между 1 и 127
tcl: всего кластеров, между 1 и 65534
fcl: всего свободно кластеров, между 1 и tcl

-freesize объём_свободного_места
Устанавливает величину свободного места доступного на диске. для жёстких дисков указывается в мегабайтах, для дискет в килобайтах. Это упрощенный вариант параметра -size.

-label имя_диска
Устанавливает указанное имя диска. Необходимо некоторым системам, если имя диска не читается корректно (полезно, когда программа не может найти свой CD-ROM).
Если не указано имя и не включена поддержка на низком уровне (не указаны -usecd # и/или -aspi параметры или указано -noioctl):
Для Windows: имя берется с "реального диска". Для Linux: Имя ставится как NO_LABEL.

Если вы укажете имя, это имя будет сохраняться, пока диск смонтирован. Оно не будет обновляться!!

-aspi
Указывает использовать aspi layer. Доступно только если монтируется cdrom под Windows с ASPI-Layer.

-ioctl (автоматический выбор интерфейса CD-аудио)
-ioctl_dx (используется цифровое извлечение аудио для CD-аудио)
-ioctl_dio (используется ioctl для CD-аудио)
-ioctl_mci (используется MCI для CD-аудио)
Указывает использовать ioctl команды. Доступно только если монтируется CD-ROM под Windows, который поддерживает их (Win2000/XP/NT).
Варианты различаются только способом работы с CD-аудио, предпочтительно использовать -ioctl_dio (наименьшая загрузка процессора), но это может работать не на всех системах, тогда следует использовать -ioctl_dx или -ioctl_mci.

-noioctl
Указывает использовать SDL CD-ROM layer. Работает на всех системах.

-usecd номер
Указывает использовать SDL поддержку CD-ROM для диска под указанным номером. Используйте, если при использовании SDL интерфейса монтируется неверный CD-ROM диск (или вообще не монтируется).
Доступно на всех системах, под Windows нужно указать параметр -noioctl чтобы задействовать -usecd.

Номер привода можно узнать при помощи команды "MOUNT -cd".

-cd
Отображает все CD-ROM диски, обнаруженные SDL, и их номера.
См. выше описание параметра -usecd.

-u
Удаляет смонтированный диск. Не работает для Z:\.

Замечание: Возможно смонтировать локальную директорию, как CD-ROM, но аппаратная поддержка в этом случае отсутствует.


Собственно MOUNT позволяет вам соединить реальную аппаратную часть с DOSBox'овой эмуляцией PC. Так MOUNT C C:\GAMES говорит DOSBox использовать директорию C:\GAMES как диск C: в DOSBox. MOUNT C E:\SomeFolde говорит DOSBox использовать директорию E:\SomeFolder как диск C: in DOSBox.

Монтирование всего диска C командой MOUNT C C:\ не рекомендуется! То же относится и к другим дискам, кроме CD-ROM (так как это устройства "только для чтения").
В противном случае при возникновении ошибки в DOSBox, вы можете потерять все ваши файлы. Также никогда не монтируйте папки "Windows" или "Program Files" (и их подпапки) в системах Windows Vista/7, так как DOSBox в таком случае может работать некорректно (или прекратить корректную работу в дальнейшем). Рекомендуется положить все ваши приложения/игры в простую папку (например, c:\dosgames) и монтировать ее.

Вы должны всегда устанавливать ваши игры внутри DOSBox. И, если ваша игра расположена на CD, вы должны (после установки!) смонтировать папку как жёсткий диск и CD как устройство CD-ROM.
Жёсткий диск всегда должен монтироваться как C. CD-ROM всегда должен монтироваться как D. Дисковод (для гибких дисков) всегда должен монтироваться как a (или b).

Простые примеры команды MOUNT (Windows):
1. Чтобы смонтировать папку как жёсткий диск:

mount c d:\dosgames

2. Чтобы смонтировать устройство CD-ROM E как устройство CD-ROM D в DOSBox:

mount d e:\ -t cdrom

3. Чтобы смонтировать устройство a: как дискету:

mount a a:\ -t floppy

Расширенные примеры команды (Windows):
4. Чтобы смонтировать жёсткий диск с ~870 Мб свободного места (простая версия):

mount c d:\dosgames -freesize 870

5. Чтобы смонтировать устройство с ~870 Мб свободного места (полное управление):

mount c d:\dosgames -size 512,127,16513,13500

6. Чтобы смонтировать c:\dosgames\floppy как дискету:

mount a c:\dosgames\floppy -t floppy

Прочие примеры команды MOUNT:
7. Чтобы смонтировать устройство CD-ROM /media/cdrom как устройство CD-ROM D в DOSBox:

mount d /media/cdrom -t cdrom -usecd 0

8. Чтобы смонтировать /home/user/dosgames как диск C в DOSBox:

mount c /home/user/dosgames

9. Чтобы смонтировать директорию, из которой был запущен DOSBox как диск C в DOSBox:

mount c .

(Обратите внимание на ".", что означает директорию в которой был запущен DOSBox, не используйте её на Windows Vista/7, если вы установили DOSBox в папку "Program Files")

Если вы хотите смонтировать образ CD или дискеты, смотрите описание команды IMGMOUNT.

MOUNT также может работать с образами, но для этого требуется использование сторонних программ, например (обе бесплатны):
- Daemon Tools Lite (для образов CD),
- Virtual Floppy Drive (для образов дискет).
Хотя использование IMGMOUNT даёт лучшую совместимость.

MEM

Программа для отображения величины свободной памяти.

VER

VER set major_version [minor_version]
Отображает текущую версию DOSBox и сообщаемую программам версию DOS (при вызове без параметров).
Вы можете изменить сообщаемую версию DOS при помощи параметра "set", например "VER set 6 22" заставит DOSBox сообщать версию DOS 6.22.

CONFIG

CONFIG -writeconf файл
CONFIG -writelang файл
CONFIG -securemode
CONFIG -set секция параметр=значение
CONFIG -get секция параметр

CONFIG может быть использован, чтобы менять или узнавать различные настройки для DOSBox во время работы. Она может сохранить текущие настройки и языковые строки на диск. Информация обо всех возможных секциях и параметрах может быть найдена в разделе "конфигурационный файл".

-writeconf файл
Записать текущие конфигурационные настройки в файл в указанном месте. "файл" располагается на реальном диске, а не на смонтированном диске в DOSBox.
Конфигурационный файл управляет различными настройками DOSBox: Размер эмулируемой памяти, эмулируемые звуковые карты и другие вещи.
Он позволяет получить доступ к AUTOEXEC.BAT. См. раздел "Конфигурационный файл".

-writelang файл
Записать текущие языковые настройки в файл в указанном месте. "файл" располагается на реальном диске, а не на смонтированном диске в DOSBox.
Языковой файл определяет все видимые сообщения внутренних команд и внутренней системы DOS. См. раздел "Языковой файл".

-securemode
Переключает DOSBox в "защищённый" режим. В этом режиме внутренние команды MOUNT, IMGMOUNT и BOOT не работают. Также в этом режиме нельзя создать новый конфигурационный файл или языковой.
Предупреждение: отменить этот режим можно только перезапустив DOSBox.

-set секция параметр=значение
CONFIG попытается установить параметру новое значение. На данный момент CONFIG может не сообщать, выполнилась ли команда успешно или нет.

-get секция параметр
Текущее значение параметра выводится и сохраняется в переменной окружения %CONFIG%. Она может быть использована при работе с пакетными файлами (bat).

И "-set" и "-get" работают из пакетных файлов и могут быть использованы для установки своих собственных настроек для каждой игры. Хотя может оказаться проще использовать раздельные конфигурационные файлы для каждой игры.

Примеры:
1. Для создания конфигурационного файла в директории c:\dosgames:

config -writeconf c:\dosgames\dosbox.conf

2. Для установки числа инструкций CPU на 10000:

config -set "cpu cycles=10000"

3. Для отключения эмуляции ems памяти:

config -set "dos ems=off"

4. Для проверки, какое ядро cpu используется:

config -get "cpu core"

LOADFIX

LOADFIX [-size килобайты] [программа | программа -параметр]
LOADFIX -f
Программа для сокращения количества доступной обычной памяти. Полезна для старых программ, которые не понимают большое количество свободной памяти.

-size килобайты
Число килобайт, которые будут "съедены", по-умолчанию = 64kb

-f
Освободить всю предыдущую сокращенную память

Примеры:
1. Чтобы запустить mm2.exe и сократить 64kb памяти (mm2 будет доступно на 64 kb меньше):

loadfix mm2

2. Чтобы запустить mm2.exe и сократить 32kb памяти:

loadfix -32 mm2

3. Чтобы удалить все предыдущие сокращения:

loadfix -f

RESCAN

Заставляет DOSBox перепроверить структуру директории. Полезно, если вы что-то изменили на смонтированном диске вне DOSBox (сочетание клавиш CTRL+F4 сделает то же самое).

MIXER

mixer [канал левый:правый] [/NOSHOW] [/LISTMIDI]
Позволяет изменять уровень громкости каналов звуковых устройств, эмулируемых в DOSBox. Команда, введённая без аргументов, просто выводит текущую громкость каналов, не изменяя их.

канал
Может быть одним из следующих: MASTER, DISNEY, SPKR, GUS, SB, FM, CDAUDIO.
CDAUDIO доступно, только если задействован интерфейс CD-ROM с поддержкой управления громкостью (образ CD-диска, ioctl_dx).

левый:правый
Уровень громкости левого и правого канала звукового устройства в процентах или в децибелах (если перед цифрами напечатаны D+\-). Примеры: mixer fm 106:86, mixer fm d+0.50:-1.30.

/NOSHOW
DOSBox не будет выводить текущую громкость каналов, если вы задали громкость хотя бы одному из них.

/LISTMIDI
В Windows показывает список доступных midi устройств на вашем PC. Для выбора устройства, отличного от установленного по умолчанию в Windows midi-mapper, измените строку "midiconfig=" в секции [midi] в конфигурационном файле на "midiconfig=id" , где "id" - номер устройства, полученный по списку LISTMIDI. Например, midiconfig=2

В Linux этот параметр не работает, но вы можете добиться аналогичных результатов, введя в консоли 'pmidi -l'. Затем измените строку 'midiconfig=' на 'midiconfig=port', где 'port' - порт устройства, указанный в результатах 'pmidi -l', например, midiconfig=128:0

IMGMOUNT

IMGMOUNT [буква_эмулируемого_диска] [образ_диска] [-t тип_образа] [-fs файловая_система] [-size геометрия_образа]
IMGMOUNT [буква_эмулируемого_диска] [образ_диска образ_диска_2 образ_диска_3] [-t cdrom] [-fs iso]
Утилита для монтирования образов дискет, CD, жёстких дисков.

буква_эмулируемого_диска
Буква диска внутри dosbox (например, C).

образ_диска
Расположение файла образа для монтирования в DOSBox. Может быть на смонтированном диске внутри DOSBox или реальном диске. Можно также монтировать образы дисков CD-ROM (ISO или CUE/BIN или CUE/IMG). Если хотите иметь возможность переключать CD, укажите все образы в виде последовательности (см. следующий пункт).
Предпочтительным типом образов дисков CD-ROM является пара CUE/BIN или CUE/IMG, так как она может содержать аудио дорожки в отличие от образов ISO (которые содержат только данные). Для монтирования пары CUE/BIN всегда указывайте файл CUE.

образ_диска образ_диска_2 образ_диска_3
Расположение файлов образов для монтирования в DOSBox. Указывать несколько файлов образов можно только для образов дисков CD-ROM. Они могут быть переключены в любое время сочетанием CTRL+F4. Это требуется для игр на нескольких дисках требующих смены диска во время игры.

CD-ROM образы могут быть смонтированы напрямую. Они не обязательно должны быть на смонтированном диске.

-t тип_образа
Следующие типы являются допустимыми:
floppy: Указание на образ дискеты. DOSBox автоматически определит геометрию диска ( 360K, 1.2MB, 720K, 1.44MB, и т.д.).
cdrom: Указание на ISO образ диска CD-ROM. Геометрия определится автоматически. Поддерживаются образы форматов iso, cue/bin и cue/img.
hdd: Указание на образ жесткого диска. Для этого должна быть указана точная CHS геометрия.

-fs файловая_система
Следующие форматы файловой системы допустимы:
iso: Указывает на ISO 9660 CD-ROM формат.
fat: Указывает на то, что диск использует файловую систему FAT. DOSBox попытается смонтировать этот образ как диск в DOSBox и сделать файлы доступными внутри DOSBox.
none: DOSBox не будет пытаться прочитать файловую систему на диске. Это полезно если его необходимо отформатировать или загрузить диск, используя BOOT команду.

При использовании "none" файловой системы лучше указать номер диска (2 или 3, где 2 = master, 3 = slave) чем букву диска.
Для примера, чтобы смонтировать образ в 70MB как slave диск, необходимо набрать:

imgmount 3 d:\test.img -size 512,63,16,142 -fs none

Сравните это с монтированием для чтения диска внутри DOSBox, что будет выглядеть как:

iimgmount e d:\test.img -size 512,63,16,142

-size геометрия_образа
Цилиндры, головки и сектора диска.
Необходимо указывать при монтировании образов жестких дисков.


Примеры, как монтировать образы CD-ROM (в Linux):

imgmount d /tmp/cdimage1.cue /tmp/cdimage2.cue -t cdrom

mount c /tmp
imgmount d c:\cdimage1.cue c:\cdimage2.cue -t cdrom

(в Windows):

imgmount d f:\img\CD1.cue f:\img\CD2.cue f:\img\CD3.cue -t cdrom

imgmount d "g:\img\7th Guest CD1.cue" "g:\img\7th Guest CD2.cue" -t cdrom

Не забывайте, что вы можете также монтировать образы командой MOUNT, но с использованием сторонних программ, например (обе бесплатны):
- Daemon Tools Lite (для образов CD),
- Virtual Floppy Drive (для образов дискет).
Хотя использование IMGMOUNT даёт лучшую совместимость.

BOOT

BOOT [образ_диска1.img образ_диска2.img .. образ_диска№.img] [-l метка_диска]
BOOT [cart.jrc] (только PCjr)
Boot запустит floppy образы или образы жесткого диска независимо от эмуляции операционной системы предложенной DOSBox. Это позволит вам запускать загрузочные дискеты или загружать другие операционные системы в DOSBox.
Если эмулируемая система PCjr (machine=pcjr), загрузочная команда может быть использована для загрузки картриджей PCjr (.jrc).

образ_диска1.img образ_диска2.img .. образ_диска№
Может быть любое число floppy образов, которое хотите смонтировать после того, как DOSBox загрузит заданную букву диска. Чтобы переключаться между образами нажимайте CTRL+F4. Нажатие заменит текущий диск следующим в списке. Когда будет сменен последний диск, список начнет прокручиваться сначала.

-l метка_диска
Этот параметр позволяет определить диск, с которого необходимо грузиться. По-умолчанию это диск A, floppy диск. Можно также загрузиться с образа жесткого диска, смонтированного как мастер указанием "-l C" без кавычек, или как slave указанием "-l D"

cart.jrc (только PCjr)
Когда включена эмуляция PCjr, можно загружать картриджи командой BOOT. Поддержка пока ограничена.

IPX

Вам нужно разрешить IPX сеть в конфигурационном файле DOSBox.

Все что связано с IPX сетью управляется через внутреннюю программу DOSBox IPXNET. Для помощи по IPX сети внутри DOSBox напишите "IPXNET HELP" (без кавычек) и программа выведет список команд и необходимую документацию.

Как и в реальной сети, одна система должна быть сервером. Чтобы выставить это, нужно написать "IPXNET STARTSERVER" (без кавычек) внутри DOSBox. Серверная DOSBox сессия автоматически добавит себя в виртуальную сеть IPX. Для всех остальных компьютеров чтобы стать частью виртуальной сети IPX необходимо по очереди написать "IPXNET CONNECT <имя главного компьютера или его IP>". Для примера, если ваш сервер на bob.dosbox.com, вы должны написать "IPXNET CONNECT bob.dosbox.com" на каждой системе, которая не является сервером.

Для игр, которым требуется Netbios, необходим файл с именем NETBIOS.EXE из Novell. Установите соединение IPX, как объяснено выше, затем запустите "netbios.exe".

Далее идет перечисление IPXNET команд:

IPXNET CONNECT
Открывает соединение к IPX tunnelling server запущенном на другой сессии DOSBox. Параметр "address" определяет IP адрес или имя хоста серверного компьютера. Можно также определить для использования порт UDP. По-умолчанию IPXNET использует порт 213, назначенный IANA порт для IPX tunnelling, для этого соединения.

IPXNET DISCONNECT
Закрывает соединение к IPX tunnelling server.

IPXNET STARTSERVER <ПОРТ>
Запускает IPX tunneling server в этой сессии DOSBox. По-умолчанию, сервер будет принимать соединение на порту UPD 213, хотя это может быть изменено. Когда сервер запущен, DOSBox автоматически запустит клиентское соединение к IPX tunnelling server.

IPXNET STOPSERVER
Останавливает IPX tunnelling server запущенный в этой сессии DOSBox. Позаботьтесь, чтобы все остальные соединения были завершены, остановка сервера может вызвать блокировку на остальных машинах, все еще использующих IPX tunnelling server.

IPXNET PING
Передает запрос о пинге IPX tunnelled network. В ответ все остальные соединенные компьютеры отреагируют на пинг и сообщат время, когда они получили и послали сообщение о пинге.

IPXNET STATUS
Сообщает текущее состояние данной сессии IPX tunnelling network в DOSBox. Для списка компьютеров, подключенных к сети используйте команду IPXNET PING.

KEYB

KEYB [keyboardlayoutcode [codepage [codepagefile]]]
Изменить раскладку клавиатуры. Для подробной информации о раскладках клавиатуры смотрите раздел "Клавиатурная раскладка".

[keyboardlayoutcode] это строка, состоящая из пяти или менее символов, например, PL214 (Польская пишущая машинка) или PL457 (Польская, программирование).
Она указывает, какая раскладка будет использована.
Список встроенных в DOSBox раскладок приведён в http://vogons.zetafleet.com/viewtopic.php?t=21824

[codepage] это число указывает на кодовую страницу (codepage), которая будет использована. Клавиатурная раскладка должна обеспечивать поддержку указанной кодовой страницы, иначе загрузка раскладки не выполнится.
Если не указана кодовая страница, подходящая страница для запрашиваемой раскладки будет выбрана автоматически.

[codepagefile] файл, который может быть использован для загрузки кодовых страниц, не встроенных в DOSBox. Нужен только если DOSBox не находит кодовую страницу. Если файл кодовой страницы не указан, но вы поместите все десять файлов ega.cpx (взятые из FreeDOS) в папку программы DOSBox, подходящий файл кодовой страницы для пары keyboardlayoutcode/codepage будет загружен автоматически.

Примеры:
1. Чтобы загрузить польскую машинописную раскладку (автоматически использует кодовую страницу 852):

keyb pl214

2. Чтобы загрузить одну из русских раскладок с кодовой страницей 866:

keyb ru441 866

Чтобы печатать русские символы нажмите ALT+RIGHT-SHIFT.
3. Чтобы загрузить одну из французских раскладок с кодовой страницей 850 (где кодовая страница определена в файле EGACPI.DAT):

keyb fr189 850 EGACPI.DAT

4. Чтобы загрузить кодовую страницу 858 (без клавиатурной раскладкой):

keyb none 858

Может быть использовано, чтобы изменить кодовую страницу для утилиты FreeDOS keyb2.
5. Чтобы вывести текущую кодовую страницу и, если загружена, клавиатурную раскладку:

keyb

Для получения большей информации используйте /? параметр командной строки с программами.

Специальные клавиши

ALT+ENTER Переключить на полный экран и обратно.
ALT+PAUSE Приостановить эмуляцию (для продолжения работы еще раз нажмите ALT+PAUSE).
CTRL+F1 Запустить настройщик клавиш.
CTRL+F4 Сменить смонтированный образ диска (CD или дискеты). Обновить кэш директории для всех дисков
CTRL+ALT+F5 Старт/Стоп создания ролика с экрана. (захват видео и запись в avi)
CTRL+F5 Сохранить скриншот. (в формате PNG)
CTRL+F6 Старт/Стоп записи звука в wave файл.
CTRL+ALT+F7 Старт/Стоп записи OPL команд. (в формате DRO)
CTRL+ALT+F8 Старт/Стоп записи MIDI команд.
CTRL+F7 Уменьшить пропуск кадров.
CTRL+F8 Увеличить пропуск кадров.
CTRL+F9 Закрыть DOSBox.
CTRL+F10 Захватить/Отпустить мышь.
CTRL+F11 Замедлить эмуляцию (уменьшить число инструкций DOSBox).
CTRL+F12 Ускорить эмуляцию (увеличить число инструкций DOSBox).
ALT+F12 Убрать ограничение скорости (турбо кнопка/ускорение).
F11, ALT+F11 (machine=cga) смена оттенка в режимах вывода NTSC.
F11 (machine=hercules) переключения цвета между янтарным, зелёным и белым.

Это клавиши по-умолчанию. Вы можете поменять их в настройщике клавиатуры. (См. раздел "Переназначение клавиш")


В MAC OS можете попробовать задействовать cmd(applekey) вместе с Ctrl, если комбинация не работает, например, cmd+ctrl+F1, но некоторые клавиши всё равно придётся переназначить (как и в Linux).

Сохраненные/Записанные файлы могут быть найдены в:

• Windows: "Меню кнопки Windows/Пуск"->"Программы"->DOSBox-0.74->Extras
  
• Linux: ~/.dosbox/capture
  
• MAC OS X: "~/Library/Preferences/capture"
  

Это может быть изменено в конфигурационном файле DOSBox.

Джойстик/геймпад

Стандартный порт джойстика в DOS поддерживает до 4 осей и 4 кнопок.
Для большего их количества нужны специальные настройки.

Чтобы заставить DOSBox использовать другой тип эмулируемого джойстика/геймпада, используется параметр "joysticktype=" в разделе [joystick] конфигурационного файла DOSBox.

none - отключает поддержку джойстика.
auto - (по-умолчанию) автоматически определяет подключен один или два джойстика: если один - использует значение '4axis', если два - использует значение '2axis'.
2axis - Если подключены два джойстика, каждый из них эмулирует джойстик с двумя осями и двумя кнопками. Если подключен только один, он эмулирует джойстик только с двумя осями и двумя кнопками.
4axis - поддерживает только первый джойстик, эмулирует джойстик с четырьмя осями и четырьмя кнопками или геймпад с двумя осями и шестью кнопками.
4axis_2 - поддерживает только второй джойстик.
fcs - поддерживает только первый джойстик, эмулирует ThrustMaster Flight Control System, с тремя осями, четырьмя кнопками и "шапочкой".
ch - поддерживает только первый джойстик, эмулирует CH Flightstick, с четырьмя осями, шестью кнопками и "шапочкой", но вы не можете одновременно нажимать несколько кнопок.

Также вам придётся правильно настроить джойстик в самой игре.


Важно помнить, что если вы сохранили файл переназначения клавиш при отключенном джойстике или с подключенным другим джойстиком, ваши установки могут работать неправильно или вообще не работать, пока вы не сбросите настройки переназначения.
Если джойстик правильно работает вне DOSBox, но не настраивается внутри DOSBox, попробуйте другие значение свойства 'timed' в конфигурационном файле DOSBox.

Переназначение клавиш

Вы можете запустить программу переназначения клавиш DOSBox при помощи комбинации клавиш CTRL+F1 (см. раздел "Специальные клавиши") либо указав параметр -startmapper (см. раздел "Ключи командной строки") при запуске DOSBox. Пред вами появится виртуальная клавиатура и виртуальный джойстик.

Эти виртуальные устройства связываются с клавишами и событиями, о которых DOSBox будет сообщать DOS приложениям. Если вы нажмете на изображенную кнопку мышкой, вы увидите в нижнем левом углу, с каким событием она ассоциирована (EVENT) и с какими событиями связана.

EVENT: Клавиша или ось/кнопка/шапочка джойстика, которую DOSBox будет передавать эмулируемым приложениям. (Событие, которое произойдёт в игре, например, выстрел/прыжок/ходьба)
BIND: Клавиша на вашей реальной клавиатуре или ось/кнопка/шапочка вашего реального джойстика (какую передает SDL), которая соединена с результирующим событием (EVENT).
mod1/2/3: Модификаторы. Это клавиши, которые вам необходимо зажимать при нажатии выбранной кнопки (BIND). mod1 = CTRL, mod2 = ALT и mod3 = Shift. Обычно применяется только если вы хотите поменять специальные кнопки DOSBox.
Add: Добавить новую ПРИВЯЗКУ к этому СОБЫТИЮ (EVENT). Просто добавляет кнопку с вашей клавиатуры или событие с джойстика (нажатие кнопки, движение оси/шапочки) , которые будет производить СОБЫТИЕ в DOSBox.
Del: Удалить ПРИВЯЗКУ к СОБЫТИЮ. Если результирующее СОБЫТИЕ не имеет ПРИВЯЗКИ, это событие вызвать невозможно (нет способа напечатать символ или использовать соответствующее действие джойстика).
Next: Проматывание списка привязок, которые соответствуют данному СОБЫТИЮ.


Пример:
В1. Вы хотите при нажатии X на клавиатуре нажимать Z в DOSBox.
О. Кликните на Z на виртуальной клавиатуре. Кликните "Add". Теперь нажмите X на вашей клавиатуре.

В2. Если вы кликните "Next" несколько раз вы увидите, что Z на вашей клавиатуре "нажимает" Z и в DOSBox.
О. Выберите Z снова и кликайте "Next", пока не дойдете до Z в графе BIND. Теперь кликните "Del".

В3. Если вы продолжите испытания в DOSBox вы заметите, что нажатие X производит появление ZX.
О. X на вашей клавиатуре все еще сопоставлен X! Кликните X на виртуальной клавиатуре и нажимайте "Next" пока не найдете X в графе BIND. Кликните "Del".


Примеры переназначения для джойстика:
У вас подключенный джойстик, он отлично работает под DOSBox, и вы хотите поиграть с джойстиком в игры без его поддержки (положим, игра управляется стрелками на клавиатуре):
1. Запустите mapper (переназначение клавиш), затем кликните на изображение клавиши "стрелка влево". EVENT должен быть key_left. Теперь кликните на Add и подвиньте ваш джойстик в соответствующем направлении, это должно добавить событие в BIND.
2. Повторите описанное выше для трех остальных направлений, дополнительно могут быть также назначены кнопки джойстика (огонь/прыжок).
3. Кликните на Save, затем на Exit и протестируйте в какой-либо игре.

Вы хотите поменять ось-y джойстика, потому что некоторые авиасимуляторы используют инверсное перемещение по вертикали, которое вы не любите, и перенастроить это в игре невозможно:
1. Запустите mapper (переназначение клавиш) и кликните на Y- в первом поле джойстика. EVENT должно быть jaxis_0_1-.
2. Кликните на Del, чтобы удалить текущую привязку, затем кликните Add и подвиньте джойстик вниз. Должна появится новая привязка.
3. Повторите для Y+, сохраните назначение и проверьте в какой-нибудь игре.


Если вы хотите переназначить какие-либо события на d-pad/шапочку, вы должны сменить "joysticktype=auto" на "joysticktype=fcs" в конфигурационном файле. Возможно в следующей версии DOSBox это будет улучшено.


Если вы изменили раскладку по-умолчанию, вы можете сохранить результат нажатием на "Save". DOSBox сохранит раскладку в файл, заданную в конфигурационном файле DOSBox (параметр mapperfile=). При старте DOSBox загрузит вашу раскладку, если это указанно в конфигурационном файле.

Клавиатурная раскладка

Для переключения на другую клавиатурную раскладку может быть использован пункт "keyboardlayout" в секции [dos] конфигурационного файла DOSBox или внутренняя программа DOSBox keyb.com (см. раздел "Внутренние программы"). Оба метода принимают языковые коды определенные в DOS (смотрите ниже), но только при использовании keyb.com можно указывать кодовую страницу.

Значение по умолчанию keyboardlayout=auto в настоящий момент работает только под Windows, язык выбирается на основании языка операционной системы, но клавиатурная раскладка не проверяется.

Переключение раскладки
DOSBox поддерживает некоторое количество клавиатурных раскладок по-умолчанию, для переключения на них нужно задать идентификатор раскладки (например, keyboardlayout=PL214 в конфигурационном файле DOSBox, или напечатать "keyb PL214" в командной строке). Перечень всех встроенных в DOSBox раскладок приведён в: http://vogons.zetafleet.com/viewtopic.php?t=21824

Некоторые клавиатурные раскладки (для примера GK319 codepage 869 и RU441 codepage 808) поддерживают спаренные раскладки, которые можно переключать нажатием LeftALT+RightSHIFT для включения одной раскладки и LeftALT+LeftSHIFT для второй. Некоторые раскладки (например, LT456 с кодовой страницей 771) имеют поддержу трёх раскладок, третью можно включить нажатием LeftALT+LeftCTRL.

Поддерживаемые внешние файлы
Поддерживаются файлы FreeDOS .kl (файлы раскладок утилиты FreeDOS keyb2) и библиотеки FreeDOS keyboard.sys/keybrd2.sys/keybrd3.sys, состоящие из всех доступных файлов .kl.
Смотрите http://www.freedos.org/ для предварительно скомпилированных раскладок, если встроенные DOSBox раскладки не работают по какой-то причине, или обновлены, или стали доступны новые раскладки.

И .CPI (совместимые с MSDOS файлы кодовых страниц) и .CPX (сжатые UPX файлы кодовых страниц FreeDOS) могут быть использованы. Некоторые кодовые страницы включены в DOSBox, так что обычно не нужно беспокоится о внешних файлах раскладок. Если вам нужен другой файл кодовой страницы, скопируйте его в директорию конфигурационного файла DOSBox, чтобы он был доступным в DOSBox.
Если вы поместите все десять файлов ega.cpx (взятых из FreeDOS) в папку программы DOSBox, подходящий для клавиатурной раскладки и кодовой страницы файл будет загружен автоматически.

Дополнительные раскладки могут быть добавлены помещением соответствующих файлов .kl в директорию конфигурационного файла DOSBox и использованием первой части имени файла как языкового кода.
Пример: Для файла UZ.KL (клавиатурная раскладка для Узбекистана) определите "keyboardlayout=uz" в конфигурационным файле.
Интеграция пакетов клавиатурных раскладок (вроде keybrd2.sys) работает идентично.

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

Сетевая игра через прямое кабельное подключение

DOSBox может эмулировать прямое кабельное подключение (nullmodem) через локальную сеть и интернет. Оно может быть сконфигурировано через секцию [serialports] в конфигурационном файле DOSBox.

Чтобы создать nullmodem соединение, одна сторона должна стать сервером, а вторая - клиентом.

Сервер должен быть настроен в конфигурационном файле DOSBox таким образом:
serial1=nullmodem

Клиент:
serial1=nullmodem server:<IP или имя сервера>

Теперь запустите игру и выберите nullmodem / serial cable / already connected как режим multiplayer на порте COM1. Поставьте одинаковую скорость передачи (baudrate) на обоих компьютерах.

Дополнительные параметры, которые могут быть определены для управления действиями соединения nullmodem. Вот эти параметры:

• port: - номер порта TCP. По-умолчанию: 23
  
• rxdelay: - как долго (в миллисекундах) задерживать полученные данные, если интерфейс не готов. Увеличьте эту величину, если вы обнаружили увеличивающийся список ошибок в окне состояния DOSBox. По-умолчанию: 100
  
• txdelay: - как долго собирать данные перед отправкой пакета. По-умолчанию: 12
  

(уменьшает объем служебной информации)

• server: - Этот nullmodem будет клиентом, соединяющимся с указанным сервером.
  

(Без аргумента server: будет сервером.)

• transparent:1 - Посылает только последовательные данные, без RTS/DTR установления связи. Используйте это, когда соединяетесь с чем-то иным нежели nullmodem.
  
• telnet:1 - Интерпретировать данные Telnet с удаленной стороны. Автоматически выставляет transparent.
  
• usedtr:1 - Соединение не будет установлено, пока DTR не будет выставлен DOS программой. Полезно для модемных терминалов. Автоматически выставляет transparent.
  
• inhsocket:1 - Использовать сокет, задаваемый DOSBox командной строкой. Автоматически выставляет transparent.
  

(Наследуемый сокет: Используется для игры в старые DOS игры (так называемые door games) на новом софте BBS.)

Пример: Создать сервер, прослушивающий TCP порт 5000. serial1=nullmodem port:5000 rxdelay:1000

Как ускорить/замедлить DOSBox

DOSBox эмулирует CPU, звуковую и графическую карты, и другие устройства PC в одно и то же время. Скорость эмулируемых приложений DOS зависит от того, сколько инструкций может быть сэмулировано, что является настраиваемым параметром (число инструкций).

Инструкции (циклы) CPU (ускорение/замедление)
По-умолчанию (cycles=auto) DOSBox пытается определить, нужно ли запускать игру с максимально возможным количеством эмулируемых инструкций (cycles=max, иногда это приводит к слишком быстрой или нестабильной работе игры) или же использовать фиксированное число инструкций (cycles=max, иногда это приводит к слишком медленной или слишком быстрой работе игры). Но вы всегда можете указать другое значение в конфигурационном файле DOSBox.

Вы можете заставить DOSBox работать медленнее или быстрее, указав фиксированное значение инструкций в конфигурационном файле. Если, к примеру, указать cycles=10000, то в заголовке окна DOSBox будет отображено "Cpu Speed: fixed 10000 cycles". В этом режиме вы можете дополнительно уменьшить число инструкций, нажимая CTRL+F11 (можете уменьшать,сколько хотите) или увеличить, нажимая CTRL+F12, при этом вы ограничены только производительностью одного ядра процессора в вашем компьютере.
Вы можете посмотреть сколько свободных ресурсов есть у вашего процессора, заглянув в Диспетчер задач в Windows 2000/XP/Vista/7 или в Системный монитор в Windows 95/98/ME.
Когда достигнута 100% загрузка одного из ядер процессора, невозможно далее ускорять работу DOSBox (она будет только замедляться), если только не уменьшить нагрузку создаваемую другими (не эмуляцией процессора) частями DOSBox. DOSBox может использовать только одно ядро вашего процессора, так что если у вас четырехъядерный процессор, DOSBox не сможет задействовать ресурсы остальных трёх.

Вы также можете заставить DOSBox работать быстро, указав cycles=max в конфигурационном файле. В заголовке окна DOSBox появится надпись "Cpu Speed: max 100% cycles". Теперь вы не должны отслеживать сколько свободных ресурсов есть у вашего процессора, так как DOSBox всегда будет использовать 100% ресурсов одного из ядер. В этом режиме вы можете уменьшить объём загрузки ядра процессора, нажав CTRL+F11, или увеличить, нажав CTRL+F12.

Ядра CPU (ускорение)
В x86 архитектурах вы можете попробовать установить использование динамически перекомпилируемого ядра (поставьте core=dynamic в конфигурационном файле DOSBox).
Это обычно дает лучшие результаты, если автоопределение (core=auto) не срабатывает.
Этот тип лучше всего сопровождать cycles=max. Но вы также можете попробовать указать высокое значение числа инструкций (к примеру, 20000 и больше).
Обратите внимание, что могут быть игры, которые хуже работают (или слетают) с динамическим ядром (поэтому чаще сохраняйте игру), или не работают с ним совсем!

Эмуляция графики
VGA эмуляция самая требовательная часть DOSBox с точки зрения загрузки CPU. увеличьте число пропускаемых кадров (увеличивая по одному) нажатием CRTL+F8. Загрузка вашего CPU должна уменьшиться, если выставлен режим фиксированного числа инструкций и вы сможете увеличить число инструкций, нажимая CTRL+F12.
Повторяйте это, пока игра не заработает с приемлемой скоростью. Пожалуйста, помните, что это компромисс: вы теряете в плавности картинки, но получаете скорость.

Эмуляция звука
Вы можете также попробовать отключить звук через setup игры, чтобы еще уменьшить нагрузку на ваш CPU. Установка nosound=true в конфигурационном файле НЕ отключает эмуляцию звуковых устройств, будет отключен только вывод звука.

Также попробуйте закрыть все программы кроме DOSBox, чтобы высвободить как можно больше ресурсов для DOSBox.

Гибкая настройка числа инструкций:
Настройки cycles=auto и cycles=max могут быть параметризованы, чтобы иметь различные значения при старте.
Синтаксис:
cycles=auto ["по-умолчанию для realmode"] ["по-умолчанию для protected mode"%] [limit "лимит инструкций"]
cycles=max ["по-умолчанию для protected mode"%] [limit "лимит инструкций"]
Пример:
cycles=auto 5000 80% limit 20000
будут использованы cycles=5000 для real mode игр, пониженные до 80% CPU для protected mode игр с лимитом числа инструкций 20000

Решение проблем

Общий совет:
Просматривайте сообщения в окне состояния DOSBox. Смотри раздел "Окно состояния DOSBox".

DOSBox вылетает сразу после старта:
- используйте разные значения для параметра output= в конфигурационном файле DOSBox
- попробуйте обновить вашу графическую карту и DirectX
- (Linux) установите переменную среды SDL_AUDIODRIVER в значение alsa или oss.

Запуск определенных игр приводит к закрытию DOSBox, вылету с неким сообщением или зависанию:
- проверьте с начальной установкой DOSBox (немодифицированным конфигурационным файлом)
- попробуйте с отключенным звуком (используйте настроечную программу, которая идет с игрой, в дополнение вы можете выставить sbtype=none и gus=false в конфигурационном файле DOSBox)
- поменяйте некоторые записи в конфигурационном файле DOSBox, главным образом попробуйте:
core=normal
фиксированное число инструкций (для примера cycles=10000)
ems=false
xms=false
или комбинации приведенных настроек, а также установку параметра machine, указывающего эмулируемую видеокарту и функциональность:
machine=vesa_nolfb
или
machine=vgaonly
- используйте loadfix перед запуском игры

Игра вылетает в командную строку DOSBox с некоторым сообщением об ошибке:
- прочтите сообщение об ошибке и попробуйте опознать ошибку
- попробуйте решения из секций выше
- монтируйте различные пути, если игра требовательна к местоположению, например, если вы используете "mount d d:\oldgames\game" попробуйте "mount c d:\oldgames\game" и "mount c d:\oldgames"
- если игра требует использование CD-ROM, убедитесь, что вы используете "-t cdrom", когда монтируете, и попробуйте различные дополнительные параметры (ioctl, usecd и label, смотрите соответствующий раздел)
- проверьте права на файлы игры (уберите атрибуты "только чтение", добавьте права на запись и т.д.)
- попробуйте переустановить игру внутри DOSBox

Окно состояния DOSBox

Окно состояния DOSBox содержит много полезной информации о текущей настройке, ваших действиях в DOSBox, возникающих ошибках и многое другое.
Если у вас возникают какие-либо проблемы, просмотрите эти сведения.

Чтобы увидеть окно состояния DOSBox:

• Windows: Окно состояния открывается вместе с основным окном DOSBox.
  
• Linux: Возможно, понадобится запустить DOSBox из консоли, чтобы увидеть окно состояния.
  
• MAC OS X: Щёлкните правой кнопкой на DOSBox.app, выберите "Show Package Contents"->войдите в "Contents"->войдите в "MacOS"->запустите "DOSBox"
  

Конфигурационный файл

Конфигурационный файл автоматически создаётся при первом запуске DOSBox. Этот файл может быть найден в:

• Windows: "Меню кнопки Пуск/Windows"->"Программы"->DOSBox-0.74->Options
  
• Linux: ~/.dosbox/dosbox-0.74.conf
  
• MAC OS X: "~/Library/Preferences/DOSBox 0.74 Preferences"
  

Этот файл разделён на несколько секций. Каждая секция начинается со строки [имя секции]. Установки представляют из себя строки вида "параметр=значение", где "значение" можно изменять для настройки DOSBox. Символы # и % отмечают (начинают) строки-комментарии.

Дополнительный конфигурационный файл может быть сгенерирован программой CONFIG.COM, расположенной на внутреннем диске DOSBox Z: Смотри раздел "Внутренние программы" для поиска сведений по использованию CONFIG.COM. Вы можете запустить DOSBox с параметром -conf для загрузки сгенерированного файла и использования его установок.

DOSBox загрузит файлы, указанные с параметром -conf. Если не указан ни один, DOSBox попытается загрузить файл "dosbox.conf" в текущей директории. Если такого файла нет, DOSBox загрузит конфигурационный файл из профиля пользователя. Если такого файла нет он будет создан.

Важно!: В Windows Vista/7 конфигурационный файл не будет правильно работать, если он размещён в папках "Windows" или "Program Files" или их подпапках или напрямую в C:\ , поэтому наилучшее место для дополнительного конфигурационного файла - это, к примеру, C:\oldgames

Описание секций, параметров и их значений, конфигурационного файла DOSBox - dosbox.conf, смотрите в отдельной статье Dosbox.conf.

Языковой файл

Языковой файл может быть сгенерирован с помощью программы CONFIG.COM, расположенной на внутреннем диске DOSBox Z: Смотри раздел "Внутренние программы" для поиска сведений по использованию CONFIG.COM. Прочитайте языковой файл и вы, надо надеяться, поймете как его менять. Запустите DOSBox с параметром -lang чтобы переключится на использование вашего нового языкового файла или вы можете настроить имя файла в конфигурационном файле в секции [dosbox]. В параметре language= укажите имя файла.

См. также

• DOSBox в вопросах и ответах (наиболее часто задаваемые вопросы по программе)
• DOSBox для знатоков (дополнительные руководства)
• Dosbox.conf (описание файла настроек программы)

DOSBox

в вопросах и ответах

для пользователей

для знатоков

примеры запуска игр