DSVideo Encoder Graphical User Interface - MICROSOFT WINDOWS BINARY

0. CONTENTS
-----------
1. What is it?
2. Installation
3. Usage
4. Version history
5. License
6. Credits



1. WHAT IS IT?
--------------
DSVideo Encoder Graphical User Interface is an interface to the command-line
encoder for DSVideo, "a video codec designed for the Nintendo DS, available
from http://dsvideo.recoil.org/".

The source code (c++ / wxwidgets), as well as the newest binaries for this
DSVideo Encoder wrapper can be found at:

  http://projects.zanzer7.net/?dsvideo-gui

The source code is portable between AT LEAST
  Mac OSX, GNU/Linux and Windows 2000/XP.
Binaries for Mac and Linux would be much appreciated.

See 'License' for details about license.



2. INSTALLATION
---------------
To 'install' the DSVideo Encoder GUI, simply place the file 'dsvideo-gui.exe'
(and optionally the XP-style-enabler 'dsvideo-gui.exe.manifest') in the same
directory you have the DSVideo Encoder (dsvideo.exe).



3. USAGE
--------
When you start dsvideo-gui.exe, you should see two windows; a black command
window with white text (the console), and an ordinary windows application
(the user interface). It will be the windows application you will be using.

The INPUT text box holds the path to the video file you want to encode (ie.
convert to .dsv) - click the '...' button next to this text box to open a file
dialog. From this dialog, you can select multiple files by either holding
ctrl or shift, or dragging a selection with the left mouse button.

The OUTPUT text box holds the path where you want the encoded video (ie. the 
.dsv) put - again, click the '...' button for a file dialog. This is optional.

The QUALITY drop down menu lets you choose from three predefined quality
levels. As you might have figured, higher quality means bigger output file.

The 16:9 check box enables/disables letterbox encoding - that is,
preserving aspect ratio at the expense of black borders on the top and bottom
of the video stream, just like you see on DVDs.

The ENCODE button is what you're here for. Click it when you've set your
options (output filename is OPTIONAL - if you don't supply one, the encoder
will simply put it as <input-file>.dsv, in the input file's folder.

The PROGRESS label shows what file number (if more than one) is currently
being encoded, as well as the total number of files.

The PROGRESS bar shows overall batch progress (if more than one file).

The FILENAME label shows the filename of the file currently being encoded.

NOTE: Clicking ENCODE automatically saves your settings (letterbox and quality
for now) to a file called 'dsvideo-gui.ini'. The next time you start
dsvideo-gui.exe, your settings will be enabled by default.

NOTE: Clicking ENCODE without supplying an INPUT file, you'll be presented
with a file dialog, just as if you'd clicked the '...' button next to INPUT.



4. VERSION HISTORY
------------------
1.0 Release Candidate 4
-9th of March 2008
  FEATURES:
  - Batch processing (open/encode multiple files in one go)
  - Batch progress

  CHANGES:
  - "16:9" label moved right of quality drop down menu
  - "Quality" label added
  - "Current file" label added
  - Progress bar added


1.0 Release Candidate 3
-2nd of March 2008
  FIXES:
  - Output file works again (omitting the '-o' flag was never supported)
  
  CHANGES:
  - "Quality" Drop down menu moved to the left, for aesthetic reasons


1.0 Release Candidate 2
-1st of March 2008
  FIXES:
  - Should now find dsvideo.exe in dsvideo-gui.exe's folder
  - Now supports the newest encoder (no -o flag)

  CHANGES:
  - "Letterbox" text changed to "16:9"


1.0 Release Candidate 1
-29th of February 2008
  FEATURES:
  - Browse for input source/output destination
  - Enable/disable Letterbox
  - Low/medium/high quality levels
  - Overwriting of file if it already exists
  
  NOTES:
  - Only tested on Intel Quad Core running Microsoft Windows XP Pro x86-x64
  - Not bug-tested



5. LICENSE
----------
Attribution 3.0 Unported ( http://creativecommons.org/licenses/by/3.0/ )
 zanzer7, 2008

YOU ARE FREE TO:
  Share - to copy, distribute and transmit the work
  Remix - to adapt the work

UNDER THE CONDITION:
  You must attribute the work in the manner specified by the author or
  licensor (but not in any way that suggests that they endorse you or your use
  of the work).

PUT SHORTLY:
  Do what you want with this, but mention me (zanzer7) somewhere, please =)



6. CREDITS
----------
Dominic Ludlam - author of DSVideo
Nick Ludlam    - co-adminstrator of (dsvideo.)recoil.org
Team Cyclops   - creator of CycloDS evolution (a door to NDS homebrew)



Enjoy =)