home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 July / CMCD0704.ISO / Software / Freeware / Utilitare / VisualBoyAdvance-1.7.2 / README-win.txt < prev    next >
Encoding:
Text File  |  2004-05-22  |  7.8 KB  |  243 lines
  1. Welcome to VisualBoyAdvance version 1.7.2.
  2.  
  3. Compiling the sources
  4. ---------------------
  5.  
  6. See the INSTALL file for compiling instructions. Please note the following
  7. requisites to compile:
  8.  
  9. - GCC must be 3.x or greater in order to compile GBA.cpp with -O2. Earlier
  10.   versions have a problem during optimization that requires an absurd
  11.   ammount of memory and usually ends up crashing the compiler/computer
  12. - On Windows, Microsoft Visual C++ 6 or later is needed. Please note that
  13.   some of the source code will not compile with the shipped header files.
  14.   You will need to install the most recent Platform SDK from Microsoft.
  15.  
  16. Support
  17. -------
  18.  
  19. Please support VisualBoyAdvance by making a donation. You can donate money
  20. using PayPal (www.paypal.com). Use the contact form to find how you can
  21. send donations. Also, it is recommended that you use the VisualBoyAdvance
  22. forum on www.ngemu.com message board.
  23.  
  24. Default keys (can be edited in the Options menu)
  25. ------------------------------------------------
  26.  
  27. Arrow keys - direction
  28. Z          - Button A
  29. X          - Button B
  30. A          - Button L
  31. S          - Button R
  32. Enter      - Start
  33. Backspace  - Select
  34. Speedup    - Space
  35. Capture    - F12
  36.  
  37. You can change the configuration above to use a joystick. Go to
  38. Options->Joypad->Configure... menu.
  39.  
  40. The 1 thorugh 4 joypads allow you to have different settings which can be
  41. easily switched.
  42.  
  43. System requirements
  44. -------------------
  45.  
  46. Fast computer (Pentium III 500 Mhz recommended) and Microsoft DirectX 7 or
  47. greater.
  48.  
  49. Translations
  50. ------------
  51.  
  52. Translations can be done as long as you have Microsoft Visual VC++ on
  53. your computer.
  54.  
  55. If you just want to use a translation, place the translation .DLL on
  56. the same directory as the emulator. From the Options->Language menu,
  57. select Other... and type the three letter (or two) language name from
  58. .DLL. For example, VBA_PTB.DLL: type PTB on the dialog.
  59.  
  60. These translation files are only for VisualBoyAdvance GUI and messages.
  61. Games will not be translated and cannot be translated by the emulator.
  62.  
  63. Skins
  64. -----
  65.  
  66. Skins consist of a bitmap (.bmp), a region file (.rgn), a draw rectangle
  67. on the region and an INI file.
  68.  
  69. Once you have the bitmap, you the region creator which can be found at
  70. the downloads section of emulator website along with a sample skin.
  71. This allows for irregular skins with holes or any shape.
  72.  
  73. Create the INI file like this:
  74. [skin]
  75. image=<relative path from ini to image bitmap>
  76. region=<relative path from ini to image region>
  77. draw=<draw rectangle defined as x,y,width,height separated by commas>
  78. buttons=<number of buttons in the skin> (optional)
  79.  
  80. Then, for each button with n starting a 0:
  81.  
  82. [button-<n>]
  83. normal=<relative path to button normal bitmap>
  84. down=<relative path to button pressed bitmap>
  85. over=<relative path to button hover bitmap - mouse over the button> (optional)
  86. id=<id of button action, menu or emulator joypad button - see below)
  87. rect=<rectangle where the button is to be drawn>
  88. region=<region to create a non rectangular button> (optional)
  89.  
  90. The id member can be one of the values found under Tools->Customize to have an
  91. action button.
  92.  
  93. If the intended use for the button is to open a menu, it can be one of the
  94. following values:
  95.  
  96. MENUFILE    - The File Menu
  97. MENUOPTIONS - The Options Menu
  98. MENUCHEAT   - The Cheat Menu
  99. MENUTOOLS   - The Tools Menu
  100. MENUHELP    - The Help Menu
  101.  
  102. If the intended use for the button is to provide a joypad button, then the
  103. it can be one of the following values:
  104.  
  105. A        - A button
  106. B        - B button
  107. SEL      - SELECT button 
  108. START    - START button
  109. R        - right
  110. L        - left
  111. U        - up
  112. D        - down
  113. BR       - RIGHT button (shoulder)
  114. BL       - LEFT button (shoulder)
  115. SPEED    - speed up button (emulator)
  116. CAPTURE  - screen capture (emulator)
  117. GS       - GS/AR button (cheating)
  118. UR       - up and right combination
  119. UL       - up and left combination
  120. DR       - down and right combination
  121. DL       - down and left combination
  122.  
  123. Example:
  124.  
  125. [skin]
  126. image=gbc.bmp
  127. regions=gbc.rgn
  128. draw=20,20,144,160
  129.  
  130. Skins are only supported in DirectDraw and GDI modes and are also not supported
  131. in fullscreen mode.
  132.  
  133. To avoid scaling problems, please not the following:
  134.  
  135. GBA screen size: 240x160
  136. GBC screen size without border: 160x144
  137. GBC screen size with border: 256x224
  138.  
  139. Not using multiples to these values will cause distortion on the image drawn
  140. by the emulator. This is not a BUG on the emulator and rather a problem of
  141. the skin size.
  142.  
  143. Per game settings
  144. -----------------
  145.  
  146. Version 1.5 introduced the support for per game settings for GBA games. You
  147. can defined the following settings on a per game basis by using an INI file
  148. called vba-over.ini in the same directory as the emulator:
  149.  
  150. rtcEnabled=<0 for false, anything else for true>
  151. flashSize=<65536 or 131072>
  152. saveType=<0 for automatic, 1 for EEPROM, 2 for SRAM, 3 for Flash or 4 for
  153. EEPROM+Sensor>
  154.  
  155. Use the 4 letter game code to separate settings for each game. Example:
  156.  
  157. [ABCD]
  158. rtcEnabled=0
  159. flashSize=65536
  160. saveType=0
  161.  
  162. [ABC2]
  163. rtcEnabled=1
  164. flashSize=131072
  165. saveType=0
  166.  
  167. FAQ
  168. ---
  169.  
  170. See online FAQ for more information: http://vba.ngemu.com/faq.shtml
  171.  
  172. Please don't email about what you think it is problem before consulting
  173. the FAQ.
  174.  
  175. Reporting a crash
  176. -----------------
  177.  
  178. If VisualBoyAdvance crashes, please do the following:
  179.  
  180. 1. Win 95/98/ME: start DrWatson (drwatson.exe) and reproduce the crash.
  181. DrWatson will capture the crash information in a log file (.wlg) file that
  182. needs to be sent to me. Please also open the .wlg file on your machine by
  183. double-clicking and copy the details section into the email. Microsoft
  184. made life harder when you migrate to WinXP (or NT or 2000) by not allowing
  185. DrWatson to read its old file format.
  186.  
  187. 2. Win NT/2000/XP: make sure DrWatson is the default debugger by executing
  188. drwtsn32.exe -i and then recreate the crash. DrWatson will generate a log file
  189. that needs to be sent to me (usually in c:\Documents and Settings\All Users\
  190. Documents\DrWatson). Depending on your system configuration, you may be asked
  191. if you want to generate a log file. If so, please click on yes.
  192.  
  193. LICENSE
  194. -------
  195.  
  196.     VisualBoyAdvance - a Gameboy and GameboyAdvance emulator
  197.     Copyright (C) 1999-2003 Forgotten
  198.     Copyright (C) 2004 Forgotten and the VBA development team
  199.  
  200.     This program is free software; you can redistribute it and/or modify
  201.     it under the terms of the GNU General Public License as published by
  202.     the Free Software Foundation; either version 2 of the License, or
  203.     (at your option) any later version.
  204.  
  205.     This program is distributed in the hope that it will be useful,
  206.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  207.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  208.     GNU General Public License for more details.
  209.  
  210.     You should have received a copy of the GNU General Public License
  211.     along with this program; if not, write to the Free Software
  212.     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  213.  
  214. Special Thanks
  215. --------------
  216.  
  217. PokemonHacker for all his help improving the emulator.
  218. Costis for his help fixing some of the graphics bugs.
  219. Snes9x developers for the great emulator and source code.
  220. Gollum for some help and tips.
  221. Kreed for his great graphic filters.
  222. And all users who kindly reported problems.
  223.  
  224. Contact
  225. -------
  226.  
  227. Please don't email unless you found some bug. Requests will be ignored and
  228. deleted. Also, be descriptive when emailing. You have to tell me what version
  229. of the emulator you are writing about and a good description of the problem.
  230. Remember, there are several interfaces (Windows, SDL and GTK+) and
  231. several systems (Windows, Linux, MacOS X and BeOS).
  232.  
  233. Also, there are still people writing about the old VisualBoy which is no longer
  234. supported. Also remember I am not paid to work on VisualBoyAdvance.
  235.  
  236. This is just a hobby.
  237.  
  238. Forgotten (http://vba.ngemu.com/contact.shtml)
  239. kxu <kxu@users.sourceforge.net>
  240.  
  241. http://vba.ngemu.com
  242. http://sourceforge.net/projects/vba
  243.