mirror of
https://github.com/libretro/dosbox-libretro.git
synced 2026-10-17 14:36:01 +00:00
The core is replaced by dosbox-core as of libretro/dosbox-core d38fcb50 (its history is in that repository), with the following on top: - Frontend VFS for mounted drives (libretro/dosbox-core#11): Android content:// and saf:// content works. - Built as dosbox_libretro and called DOSBox, so it installs next to dosbox-core without sharing its options, saves directory or config file. Option keys keep their dosbox_core_ prefix. - ZIP files as content, from DOSBox Pure (Bernhard Schelling): its zipDrive, unionDrive and memoryDrive, and the helpers they share (drive_dbp.cpp). The archive is mounted as C: without being extracted and the game's changes go to <name>.save.zip in the saves directory. DOS_Drive and DOS_File get the few members those drives need, with defaults. - The game in a ZIP is started when there is nothing to choose: the single program in the root, or in the one folder the root holds, leaving setup and install programs aside. - Disk images inside a ZIP: CD images (cue sheets with data and audio tracks, or ISOs) as D:, floppy images as A:, hard disk images as E: and on. Files on emulated drives can be named "$C:\PATH" as in DOSBox Pure; host_stat, fopen_wrap, the CD image reader and the audio track decoder open them through the drive, finding files by their long names. CDs and floppies go to RetroArch's disc control. - A start menu after DOSBox Pure's when a ZIP leaves a choice: it lists the programs on C: and on the mounted images, starts the one picked, can make it start on its own next time (kept in C:\DOSBOX.RUN, in the save file), and comes back when the program exits. Keyboard and gamepad; it can be turned off in the core options. - Automatic gamepad mapping from DOSBox Pure's Keyb2Joypad database (original data by Jemy Murphy and bigjim, used by DOSBox Pure with permission): a game the database knows, as a ZIP or from a directory, gets its keys, mouse and joystick actions on the first gamepad instead of the DOS joystick, with the action names shown in RetroArch. It can be turned off. - The CPU speed from the game's year, from its name or the database, as in DOSBox Pure; it can be turned off. - Roland SC-55 MIDI with Nuked-SC55 (nukeykt), from DOSBox Pure, as a new MIDI driver taking the module's ROMs from the system directory.
Starting with version 0.65, DOSBox allows you to create movies out of screen
output.
To record a movie, you have to press CTRL-ALT-F5.
To stop/end the recording, you have to press CTRL-ALT-F5 again.
To play the recorded movie, you need a movie player which can handle the
ZMBV codec. MS Windows users can find this codec in the start menu entry of
DOSBox. Users of Linux and other OSes should look for a movie player that
uses the ffmpeg libary (you may need to update or ask your distribution to
upgrade).
FAQ:
Q: During the display of the movies the sound is lagging.
A: Check your display properties to see whether your refresh rate is set to
at least 70 hz. Try playing the movie in virtualdub (http://virtualdub.sf.net)
Q: Why does the resulting movie consist of multiple files?
A: Each time the game changes resolution, DOSBox creates a new movie file,
because a movie file can only contain one resolution.
Q: Can I set the cycles higher than my PC can handle during recording?
A: Yes. During recording, the game might play slowly and stuttering, but the
resulting movie should play at the intended speed and have no stuttering.
Q: CTRL-ALT-F5 switches to the console under linux.
A: 1. Start DOSBox like this: dosbox -startmapper
2. Click on Video, click on Add
3. Press the key you want (for example scroll lock or printscreen)
4. Click exit.
5. You can make movies by pressing scroll lock or whichever key you
selected.
Q: The colours are wrong and I'm using 64 bit windows
A: Look here: https://www.vogons.org/viewtopic.php?t=12133