From 0bd9accb675997b7f99a074a5773682b85e599ca Mon Sep 17 00:00:00 2001
From: Peter Veenstra <qbix79@users.sourceforge.net>
Date: Mon, 27 Mar 2006 19:56:22 +0000
Subject: [PATCH] Video documentation.

Imported-from: https://svn.code.sf.net/p/dosbox/code-0/dosbox/trunk@2560
---
 docs/Makefile.am  |  4 ++--
 docs/README.video | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 2 deletions(-)
 create mode 100644 docs/README.video

diff --git a/docs/Makefile.am b/docs/Makefile.am
index 17738546..7e313172 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -1,7 +1,7 @@
 # Main Makefile for DOSBox
 
-man_MANS = dosbox.1
-EXTRA_DIST = $(man_MANS)
+man_MANS = dosbox.1 
+EXTRA_DIST = $(man_MANS) README.video
 
 
 
diff --git a/docs/README.video b/docs/README.video
new file mode 100644
index 00000000..a79f8028
--- /dev/null
+++ b/docs/README.video
@@ -0,0 +1,32 @@
+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.