a guest Jan 16th, 2011 184 Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
  1. ---------------------------------------------------------
  2. ePSXeCutor - frontend for ePSXe - by Pete Bernert
  3. ---------------------------------------------------------
  6. What's new with
  8. - Due to multiple user suggestions: it's now possible to use
  9.   the epsxecutor.exe commandline to start a special config
  10.   without even showing the ePSXeCutor window.
  11.   That means: you can do now for example an epsxecutor shurtcut
  12.   on your desktop, and give a certain config name as cmdline.
  13.   If you now double-click this shortcut, ePSXeCutor will activate
  14.   this config, and start ePSXe with it.
  16.   The syntax is easy: simply add the config name after the .exe,
  17.   for example: epsxecutor.exe Alundra2. Please note: if your config
  18.   name contains space characters, use quotation marks (like:
  19.   epsxecutor.exe "Final Fantasy 9").
  20.   Ah, yes, and there is a special cmd line config name, called
  21.   QUICKSTART. if you do a shortcut like "epsxecutor.exe QUICKSTART",
  22.   ePSXeCutor will look after the game ID of the inserted psx game
  23.   cd, and start activate the config which belongs to this game
  24.   (if there is such a config available, of course).
  26. - There is still Pad plugin support in this version of ePSXeCutor,
  27.   even if ePSXe 1.6.0 doesn't support such plugins yet... maybe
  28.   next time, eh? :)
  31. ---------------------------------------------------------
  33. What's new with (pre-release)?
  35. - First of all, it's a pre-release. In the past, a new ePSXeCutor
  36.   release only happened in union with an ePSXe release. But since
  37.   calb is busy with real life, and the current ePSXeCutor version
  38.   is now on my hard drive for over half a year, I've decided to
  39.   give you an update. This frontend will work fine with ePSXe 1.5.2,
  40.   even if some options (like the pad plugin support) will only work
  41.   with the upcoming next ePSXe version.
  43. - Improved cdrom GameID detection (thanx to Mike "Moose" O'Malley)
  45. - Added pad plugin support. This "" pre-release of ePSXeCutor
  46.   will store the pad plugin selection/configs, but of course the current
  47.   ePSXe version (1.5.2) will ignore it. You'll have to wait for
  48.   the next ePSXe version...
  50. - Due to high user request: free selectable memcard files. You can either
  51.   use the old managed memcard list, or specify two memcards with
  52.   custom file names.
  53.   Please note: if ePSXeCutor doesn't know the memcard file format, it
  54.   will show a "Not formatted" text in the info bar. That doesn't mean
  55.   that the memcard file will not work in ePSXe (since the main emu can
  56.   read more formats than my frontend... yup, I am too lazy to support
  57.   everything).
  59. - "Fast plugin configure" buttons in the "config infos" bar. Very handy.
  61. - Small skin support: you can change the look of every button and
  62.   icon used in ePSXeCutor. Simply place a modified "epsxecutor.bmp"
  63.   file into an epsxe sub-folder called "skins".
  64.   If no skin bitmap exists, the default symbols will be used.
  65.   In this archive I have added two skin files, the old default style one,
  66.   and a nicer looking XP skin.
  67.   Ah, and you can also change the initial splash screen gfx by
  68.   placing a new bitmap called "epsxecutorsplash.bmp" into the "skins"
  69.   directory.
  71. - Last but not least: a game 'quickstart' function. You can now specify
  72.   the CD game ID when you create a new/change an existing game
  73.   configuration. This ID will be used by the 'Quickstart' toolbar
  74.   button/menu item: simply insert a game CD you want to play, and press
  75.   the 'Quickstart' button. ePSXeCutor will automatically read the ID
  76.   from the inserted CD, and search into the configuration list if
  77.   a game config linked with that ID exists. If a config is found, it
  78.   will get selected and started automatically.
  80. ---------------------------------------------------------
  82. What's new with
  84. - Adjusted the epsxe 1.5.2 options / removed epsxe options
  85.   which are not needed anymore
  87. - Added memcard file export... first I wanted to do free selectable
  88.   memcard filenames, but after looking at my source I realized that
  89.   such would mean an hell of changes (many funcs are needing
  90.   the currently used memcard numbers), so I decided to let you
  91.   easily export (and of course import) memcards with any filename
  92.   you want to choose... kinda a compromise ;)
  94. - Changed the memcard formating... should be more compatible
  95.   with the real psx.
  97. ---------------------------------------------------------
  99. What's new with
  101. - Not much :) Added the new ePSXe subchannel options and
  102.   removed the "disable cdr status" option... that's all
  104. ---------------------------------------------------------
  106. What's new with 1.0.5?
  108. - epsxe directory containing spaces (f.e. C:\program files\epsxe)
  109.   supported
  110. - save state size display fixed
  111. - removed obsolete epsxe options (mdec, mdec timing, cdrom
  112.   RT status).
  113.   Note: in epsxe 1.5 you can still control mdecs by command line
  114.   options, but the old registry settings will not work anymore.
  115.   If you are using an older version of epsxe as well, you have
  116.   to turn on mdec videos with an older version of epsxe or
  117.   epsxecutor!
  118. - added epsxe pad config: there's a button in the "Options" screen,
  119.   if you push that, epsxe will get started, and you can configure
  120.   the pads as desired. Quit epsxe afterwards, all your pad
  121.   settings will get saved in the game configuration.
  122. - Biggest change: compatibility info manager (see below for
  123.   details)
  125. ---------------------------------------------------------
  127. What's new with 1.0.4?
  129. - sorting the plugins in the plugin config window
  130.   by name, file or date (just click the list header)
  131. - save state manager
  132. - support for netplay plugins
  134. ---------------------------------------------------------
  136. What's new with 1.0.3?
  138. - dunno... ask calb :)
  140. ---------------------------------------------------------
  142. What's new with 1.0.2?
  144. - the internal ePSXe plugins will now be listed
  145. - full mem card block names
  146. - support for the new cdrom options
  148. ---------------------------------------------------------
  150. What's new with 1.0.1?
  152. - drop down list for the different gamepad types
  153. - selection of country mode (Auto/PAL/NTSC)
  154. - option for starting up the ePSXe GUI
  155. - option for internal cdr... select your cdr drive in epsxe first!
  157. ---------------------------------------------------------
  159. What's ePSXeCutor for?
  161. Well, ePSXe has its own gui, after you have started
  162. the emu you can configure it easily using the menus.
  163. But, of course, some games will need special settings
  164. to start up, or sometimes you will want to turn off
  165. the sound, use different plugins, etc.
  167. So you would have to reconfigure ePSXe a lot of times,
  168. and you would have to keep in mind the settings of a
  169. certain game.
  171. That's how ePSXeCutor will help you:
  172. You can store individual settings for each game, all
  173. game configurations will be stored in the Windows
  174. registry, a simple double-click on a configuration
  175. icon will start ePSXe with the settings you have found
  176. best for that game.
  178. Each game configuration will store:
  179. - plugins used, and the plugin settings
  180. - ePSXe settings (like sound, mdec, cdr usage, command line)
  181. - Selection of memory cards you want to use with that game
  182. - Activated epsxe cheats (patches to make certain games work)
  184. There are some goodies, too, like im/export of configs,
  185. configuration groups (for example rpg games, fighting
  186. games, etc.), user defined config icons, creating/copying
  187. memcard files, a save state file manager, a compatibility
  188. list and so on.
  190. Enjoy!
  192. ---------------------------------------------------------
  193. Installation
  194. ---------------------------------------------------------
  196. Installation is easy:
  198. Copy all 3 files (ePSXeCutor.exe, ePSXeCutorTool.dll and
  199. ePSXeCutorStuff.dll) into your ePSXe directory (that's
  200. the directory which contains the main emu "epsxe.exe").
  202. That's all (ok, you surely want to make some desktop
  203. shortcut icon to ePSXeCutor.exe, right). Oh, yes,
  204. ePSXeCutor is using the MFC dlls... maybe you have to
  205. update them to use it.
  207. If you want to use the compatibility list manager, please
  208. create a new sub-directory "infos" in your epsxe main
  209. directory, and copy the info .txt files into it.
  211. Oh, well, if you don't know how to copy files, but unfortunately
  212. you are able to send mails... DON'T MAIL ME QUESTIONS LIKE
  213. 'how do I copy files?'... ask some cool friend or your parents
  214. instead :)
  216. ---------------------------------------------------------
  217. Usage
  218. ---------------------------------------------------------
  220. If you are familar with PSSwitch, my PSEmu Pro frontend,
  221. you will not have any troubles using ePSXeCutor.
  223. If you don't know PSSwitch (shame on you ;), read on.
  225. After starting ePSXeCutor you will see one sizeable
  226. window. The main part of the window will show you
  227. all config icons you have done so far (yeah, starting
  228. it the first time, the list will be empty).
  229. A simple double click on a game config icon will start
  230. epsxe with the stored config settings.
  232. On the left side (by default) is the group bar, it
  233. will contain a list of game groups, if you want to
  234. make multiple groups to keep you game configs well
  235. ordered. The group bar will always have at least one
  236. entry, called 'All configurations', by selecting this
  237. entry the main window will show all available configs
  238. you have created so far.
  240. On the bottom (by default) is the config info bar,
  241. it will display details of the selected configuration.
  243. Well, on top is the menu and tool bar. Here you can
  244. create/delete/change configurations, change the main
  245. window view, and so on.
  247. OK, now let us create a new configuration.
  249. Create a new configuration
  250. --------------------------
  252. Simply select 'Configurations->New ePSXe configuration..'
  253. or push the first button of the tool bar.
  254. A new dialog window will appear, here you have to
  255. a) enter an unique configuration name
  256. b) choose a bmp file as icon (optional, can be empty)
  257. c) type in some info/comment about the config
  258. d) push 'Configure epsxe' to go to the config window
  260. In the box below some of the current epsxe config settings
  261. will be displayed (plugins, memcards).
  262. After you have done the settings, push 'OK', a new
  263. config will be born :)
  265. Configure ePSXe
  266. --------------------------
  268. Well, beside creating a new configuration, the most
  269. important part of ePSXeCutor is the definition of
  270. the ePSXe emu options and plugins settings.
  272. When you are creating a new config (see above) you
  273. will need to go to the 'change ePSXe configuration'
  274. window (by pushing 'Configure epsxe'), but you can also
  275. change the settings of already existing configs by
  276. right clicking the config icon -> 'Quick configure' or
  277. by selecting 'Quick configure' in the main window menu.
  279. The 'change ePSXe configuration' is divided into four
  280. parts:
  281. - plugins
  282. - memcards
  283. - options
  284. - cheats
  286. In 'Plugins' all available gpu/spu/cdr/pad/net plugins will be
  287. listed. Select a plugin, and push 'Activate'... now
  288. that plugin will be used with the current configuration.
  289. Push 'Configure' to change plugin options. 'Test' will
  290. tell ya if the plugin will work, and 'About' shows some
  291. plugin infos. You can also use a popup-menu by right-
  292. clicking a plugin, though. Also the internal epsxe plugins
  293. (spu/cdr/pad) will be listed, but no configuration windows are
  294. available for the internal plugins.
  296. 'Memcards' let you create, format, copy and choose memcard
  297. files. You should choose two different memcards for
  298. each game configuration. Should be easy to use. Select a
  299. memcard and push 'Set Slot 1', select another and push
  300. 'Set Slot 2'. That's all.
  301. If you have already existing memcard files, you can either
  302. import them, or use them directly with the 'custom memcard'
  303. option.
  305. 'Options' let you set the internal ePSXe thingies...
  306. check out the ePSXe manual to get more infos ;)
  307. Well, with the 'command line' edit you can enter
  308. some special options, for example you can use
  309. ISOs by the command line "-loadbin x:\game\spyro.bin".
  310. For a full list of the command line params, simply start
  311. the ePSXe emu with the commandline "-help" :)
  312. A special option is called "Start ePSXe GUI", by activating
  313. this option the ePSXe window with menus, etc., will be
  314. displayed and you have to start the game manually using
  315. the ePSXe menu.
  316. IMPORTANT: to get videos in your games you have to activate
  317. the "mdec" option!
  319. 'Cheats'... here you can define/import/change cheat
  320. settings and activate them... please note: the 'cheats'
  321. here are no Gameshark, etc cheat codes! It's made for
  322. special patch cheat codes to get some special games to
  323. work (for example "Thousand Arms" will need the cheat
  324. "10023458 = 0000" to work in ePSXe).
  327. Well, that's the main config handling... but there are
  328. some more goodies in ePSXeCutor... lemme explain the
  329. Group handling now.
  331. Creating/using groups
  332. --------------------------
  334. What are groups for? Well, if you have many game configs
  335. you will want to order them.. you can change the config
  336. icon order by dragging a configuration icon to a new
  337. position, but if the config list grows bigger and bigger
  338. you will want to use groups, be assured :)
  339. Groups are displaying just some of the game configs,
  340. the ones that belong to that special group... only
  341. the main group 'All configurations' will show you
  342. all configs.
  344. To create a group just do a right-click in the group bar
  345. and select 'new group'.
  346. In the following window enter an unique group name and
  347. select a suitable group icon. That's all.
  349. When you click on the new group entry in the group bar,
  350. the main window will just display the game configs of
  351. that group. Well, after creating a new group, the list
  352. will be empty, of course.
  354. How to put a config into a group?
  355. a) If you activate a group, and create a new game config,
  356. it will be stored in the 'All configurations' group _and_
  357. the activated one.
  358. b) If you want to store an existing config in a certain
  359. group, select the group entry which contains the config
  360. right now (or select 'All configurations') and drag
  361. the config icon at the group name in the group bar.
  363. Note: you can remove a config from a group by right clicking
  364. the config in that group and selecting 'Remove from
  365. group'... that way the config will only removed from that
  366. group, it will still be available in 'All configurations',
  367. for example. If you choose 'Delete' instead, the config will
  368. be deleted from _all_ groups.
  370. Oki, that's the main group handling... now we'll take a
  371. fast look at some special stuff...
  374. Game Quickstart function
  375. ----------------------------------
  377. You can specify the CD game ID when you create a new/change
  378. an existing game configuration.
  380. This ID will be used by the 'Quickstart' toolbar button/menu item:
  381. simply insert a game CD you want to play, and press the 'Quickstart'
  382. button. ePSXeCutor will automatically read the ID from the inserted
  383. CD, and search into the configuration list, if a game config linked
  384. with that ID exists. If a config is found, it will get selected and
  385. started.
  388. Save State Manager
  389. ----------------------------------
  391. You can use the "F1/2/3" keys in ePSXe to store/choose/load
  392. save state files. Each file will have the game-id as file name,
  393. and take a few MBytes of your harddrive.
  395. The save state manager can be used to backup (export) save
  396. state files, to import them again into the save state directory,
  397. you can give each game save state its own name (it's easier to
  398. search for a certain save state file that way, if you want to give
  399. it to a friend), and you can delete unneeded files.
  401. If the gpu plugin has generated a small save state screen picture,
  402. the pic will be displayed in the manager, too.
  404. Game compatibility infos
  405. ----------------------------------
  407. Sometimes it's hard to get a certain game to run... maybe
  408. special settings in the main emu or one of the plugins are
  409. needed to fix glitches, or to get the game to run at all.
  410. In the "game infos" window you will find a list of tested
  411. games, and (depending on the game) more or less usefull
  412. infos how to get it to run (or maybe the info: doesn't work
  413. at all).
  414. All infos are stored in text files, each game will have its
  415. own file in the "infos" subdirectory (GameID.txt). Look for
  416. emu sites hosting such psx compatibility files to increase
  417. your wonderfull collection of info files... who knows, maybe you
  418. will need infos about a special game soon :)
  419. Of course you can also create your own game info files, simply
  420. enter the unique game ID (can be found in the root directory
  421. of the game CD), or insert the CD in the drive and press
  422. the "Read ID from CD" button (don't forget to select the
  423. proper cd drive letter first). If infos already exist, they will
  424. get displayed, otherwise you can now type in your own
  425. experiences with that game... hit "Save game infos" after you
  426. made changes, and well, if you know an emu site looking for
  427. compatibility info files, why not mail yours to them? :)
  428. Using "Export infos" will save the selected game infos to a
  429. new selectable directory, simply mail this file to the
  430. compatibility site.
  431. "Import infos" will only copy selected files into the "infos"
  432. subdirectory, if you know how to use the Windows Explorer you
  433. can do that yourself, of course ;)
  436. Misc
  437. --------------------------
  439. Well, in the 'View' menu you can hide the bars, if you
  440. don't need 'groups' for example. You can also decide
  441. if you want the game configs displayed as big or small
  442. icons or using a report list, which will display
  443. your game comment in the second column.
  445. The 'Tools' menu contains:
  447. - 'Erase all ePSXeCutor settings', that's kinda an
  448.   uninstall of ePSXeCutor... all game configs and
  449.   entries will be removed from your Windows registry,
  450.   so no trash will be left.
  452. - 'Export/Import configuration': 'Export' stores the
  453.   selected config settings in a windows .reg file,
  454.   'import' will read that file and make a new
  455.   config icon with the stored infos.
  457. - 'Customize ePSXeCutor': Well, you can change some of
  458.   the ePSXeCutor gui in this dialog. You can select your own
  459.   group bar icons, if you like. You can set a background
  460.   picture in the main window. You can change the look
  461.   of the toolbar buttons. And you can select which config
  462.   infos should be displayed in the info bar.
  465. Skin support
  466. --------------------------
  468. You can change the look of every button and icon used in
  469. ePSXeCutor. Simply place a modified "epsxecutor.bmp"
  470. file into an epsxe sub-folder called "skins".
  472. If no skin bitmap exists, the default symbols will be used.
  474. You can get original bitmap and a nice looking XP style skin
  475. from
  477. You can also change the initial splash screen gfx by placing a
  478. new bitmap called "epsxecutorsplash.bmp" into the "skins"
  479. directory.
  481. ---------------------------------------------------------
  482. Final words
  483. ---------------------------------------------------------
  485. If you are having ePSXeCutor problems or suggestions,
  486. you can send a mail to:
  488. And, as always, have fun :)
  490. Pete Bernert  
  495. btw, great job, calb, Galtor and _demo_ :)
RAW Paste Data