1. INTRODUCTION
------------

VecX emulates the Vectrex game console on systems
such as Linux and Windows.

Dingux-vectrex is a port on Dingoo of one latest 
version of VecX.

This package is under GPL Copyright, read COPYING
file for more information about it.


2. CONTROL
------------

2.1 - Virtual keyboard

  In the VECTREX emulator window, there are three
different mapping (standard, left trigger, and
right Trigger mappings).  You can toggle between
while playing inside the emulator using the two 
caanoo trigger keys.

    -------------------------------------
    Dingoo        VECTREX            (standard)
  
    A          1
    Y          2
    B          3
    X          4

    Pad        Joystick

    -------------------------------------
    Dingoo        VECTREX   (left trigger)
  
    A          FPS  
    Y          LOAD Snapshot
    B          Swap digital / Analog
    X          SAVE Snapshot
    Left       Render mode
    Right      Render mode

    -------------------------------------
    Dingoo        VECTREX   (right trigger)
  
    A          1
    Y          2
    B          3
    X          Auto-fire
    Left       Dec fire
    Right      Inc fire
  
Press Start+L+R to exit and return to eloader.
Press Select    to enter in emulator main menu.
Press Start     open/close the On-Screen keyboard

  In the main menu

    RTrigger   Reset the emulator

    X   Go Up directory
    A      Valid
    B     Valid
    Y     Go Back to the emulator window

The On-Screen Keyboard of "Danzel" and "Jeff Chen"

Use D-pad to choose one of the 9 squares,
and use A,B,X and Y to
choose one of the 4 letters of the highlighted
square.

Use LTrigger and RTrigger to see other 9 squares
figures.

2. LOADING ROM FILES (.rom or .bin)

If you want to load rom image in your emulator, you
have to put your rom file (with .rom or .bin file
extension) on your Dingoo SD card in the 'roms'
directory. 

Then, while inside emulator, just press SELECT to
enter in the emulator main menu, choose "Load Rom",
and then using the file selector choose one rom
image  file to load in your emulator.


3. LOADING KEY MAPPING FILES

For given games, the default keyboard mapping
between Dingoo Keys and VECTREX keys, is not suitable,
and the game can't be played on Dingux-VECTREX.

To overcome the issue, you can write your own
mapping file. Using notepad for example you can
edit a file with the .kbd extension and put it in
the kbd directory.

For the exact syntax of those mapping files, have a
look on sample files already presents in the kbd
directory (default.kbd etc ...).

After writting such keyboard mapping file, you can
load them using the main menu inside the emulator.

If the keyboard filename is the same as the rom
file then when you load this file, the
corresponding keyboard file is automatically
loaded !

You can now use the Keyboard menu and edit, load
and save your keyboard mapping files inside the
emulator. The Save option save the .kbd file in the
kbd directory using the "Game Name" as filename.
The game name is displayed on the right corner in
the emulator menu.

If you have saved the state of a game, then a
thumbnail image will be displayed in the file
requester while selecting any file (roms, keyboard,
settings) with game name, to help you to recognize
that game later.
  
You can use the virtual keyboard in the file
requester menu to choose the first letter of the
game you search (it might be useful when you have
tons of games in the same folder)

When changing the render mode to rot90 (default)
the key mapping for up/down/left/righ are 
automatically changed to left/right/up/down.
  
  Enjoy,

           Coccijoe

