
Sram Explorer v2.0
------------------



CONTENT OF THE ZIP:

readme.txt 		: this file
faqs.txt		: if you can't find the information you need in the readme then it's here
changes.txt		: list of all the major changes in this version
SramExplorer.exe: the tools itself
SramExp.exe		: a command line version of Sram explorer
SramReader.dll	: a dll shared by SramExplorer.exe and SramExp.exe that contain all the
				dump access function

WARNING:
Sram Explorer 2 is mean to be use only with pogoshell 2.0, if you still use an early
version of pogoshell, then use Sram Explorer 1.x instead.


INTRODUCTION:

Sram Explorer is a tool to manage your pogoshell savegame on your PC. If you don't use 
pogoshell, then you don't need this tool. It's basically a graphics replacement for 
extract_save with much more features. You can extract your savegame one by one, or use a 
multiselection, you can remove savegames from your dump to free some space (more 
explanation of what I call a dump is in the faqs), and most of all you can add/replace a 
savegame in the dump, then you'll just need to flash it back to your card's Sram.


HOW TO IMPORT AN OLD DUMP:
- open a dump that came from an old version of pogoshell (1.x)
- a dialog box will pop asking you a few things :
- check "Automaticly delete duplicate file" if you want to delete duplicate file, if you
  don't check it, the user if of the second file will be incremented to avoid having two 
  identical file in the same bank
- check "delete .state" if you want to automaticly erase the old configuration file that 
  is not used by pogoshell anymore
- Select "Set all file to user x" to choose to which user the file will be attributed or
  select "Dispatch bank into different user" to attribute file to different user regarding 
  from the bank they came from (ex: file from bank 1 will be attributed to user 1)


HOW TO EXTRACT A SAVEGAME:

- open the dump that contains your savegame(s).
- select the savegame(s) that you want to extract
- click on the extract button. If you select only one file, a dialog box will appear to 
  choose the name of the file to save to on disk. If you select more you'll have to choose 
  the directory to extract all files.
  
Note : Now you can also extract all your savegame with the Extract All command from the 
bank menu.


HOW TO DELETE A SAVEGAME:

- open the dump that contains the savegame(s) you want to delete.
- select the savegame(s) that you want to delete
- click on the delete button. You shouldn't erase system files, if you select some system 
  files to delete, a confirmation message box will appear.
- click on the save button. No modification will be done to your dump untill you save. If 
  you erase a file by mistake, quit without saving. When you save, a .bak is automatically 
  created.
  

HOW TO ADD A FILE:

- open the dump in which you want to add the savegame, or create a new one.
- click on the Add button and pick the file you want to add, a dialog box should appear. 
  You need to do three more things before clicking on Ok.
- choose the name that you savegame will have in pogoshell, by default it's your file name
  shrunk to 32 characters.
- choose the user you want to add the file to, it must a number between 0 and 255
- pick between Crc mode and Gamecode mode, Crc mode is for pogoshell 1.2, 1.3 and 2.0 and 
  Gamecode mode for 1.3 and 2.0, then can either enter the information yourself, or click on 
  "Get From Rom" to let Sram Explorer extract the information from the game rom. (you'll 
  have to do that only once per game, Sram Explorer will remember the information for next
  time you'll add a savegame with the same name)
- Now you can click on Ok, the file should appear in the Sram Explorer now. If a file with 
  the same name or the same ID exist, you will be asked if you want to erase it.
- click on the save button. No modification will be done to your dump until you save. If 
  you made a mistake, just quit without saving. When you save, a .bak is automatically created.
  

HOW TO CHANGE A FILE USER:

- open the dump that contains the savegame(s) you want to modify.
- select the savegame(s) that you want to modify
- click on "file properties..." in the contextual menu
- change the user id in the dialog box that appear, and then click on ok
- click on the save button. No modification will be done to your dump untill you save. If 
  you change the user by mistake, quit without saving. When you save, a .bak is automatically 
  created.


LIMITATIONS/BUGS:

- No real pogobridge support, it seems that you can use it to extract savegames, but please 
  don't flash back a dump on pogobridge. Once again, use it at your own risk, and all reports 
  are of course welcome. If you want to add / remove savegame, you should work with the 
  import/export bank function instead of the whole dump.
- On a more general side, this program had been written with no official documentation 
  of pogoshell and does not pretend to be bug free. It had been tested by me and a few 
  other people on different board, and nobody lost any savegames yet, BUT that doesn't 
  mean that will never happen, consider it as a beta version. 
  So please be careful, always keep a backup of your savegame and dump and use it at your 
  own risk (yeah I like to say that ;) ). I don't take any responsibility if this program 
  makes you lose some very important savegames, nor if it harms your gba, your flashcard,
  your cat or your grandmother, but if it did, just remember it did it for free ;)


THANKS TO:

- Sasq and Herg for their great pogoshell, the original extract_save.exe and sharing their
  source code
- Progman for his heavy testing and help under windows 95/98, and some english correction
- Adv for some other testing and nice bug report
- Anya for some english correction here and here and for the icons
- Armen Hakobyan for his CFolderDialog (www.codeproject.com)
- Michael Walz  for his code snippet to save window position (www.codeproject.com)
- Zafir Anjum for his CSortHeaderCtrl class
- And of course everybody else that tested Sram Explorer


CONTACT:

You can send me a Private Message on the EmuBoard's forum (Lestat) or post a message on 
the board.