CFG Studio 2
============
Creator: Ben "Cerbera" Millard
Website: http://projectcerbera.com/tools/cfgstudio2/
History: 2005-06-13 -> 2007-10-25 -> 2011-11-18 -> 2012-01-26

Edit many of the text data files from GTA2, GTA3, GTAVC and GTASA.

* http://projectcerbera.com/tools/cfgstudio2/



Tutorials
=========
* http://projectcerbera.com/gta/2/tutorials/handling
* http://projectcerbera.com/gta/3/tutorials/handling
* http://projectcerbera.com/gta/vc/tutorials/handling
* http://projectcerbera.com/gta/vc/tutorials/paths
* http://projectcerbera.com/gta/sa/tutorials/handling



Attention
=========
Make backups of your files before using this program!

Do not use this program unless you accept the risks of using incomplete software.

* It may corrupt some formats.
* It removes comments and blank lines when you save a file.
* It seperates values in a minimal way.
* "View" > "Sort By" is risky because some files must stay in the original order.

Leave your comments in the GTA Forums topic:

* http://www.gtaforums.com/index.php?showtopic=196381



Installing
==========
This program DOES NOT need to be in the GTA folder. Put it in any folder you want.

Copy these files to your "C:\windows\system32\" folder:

 1. MSFLXGRD.OCX
 2. mscomctl.ocx
 3. COMDLG32.OCX
 4. COMCTL32.OCX
 5. scrrun.dll

Click "Yes" to replace existing files ONLY if they are actually newer!

These were the most up to date versions of the files available in Visual Basic 6.0 Service Pack 6; it's possible Microsoft will update them in a future version of Windows.

If you don't have a "C:\windows\system32\" folder, copy them to your "C:\windows\system\" folder.

Now you must register the files:

1. Open the "Start" menu and select "Run".
2. Type "regsvr32" but don't press anything else.
3. Drag the "MSFLXGRD.OCX" file from the "system32" folder and drop it on the "Run" window.
4. It will now say something like "regsvr32 C:\windows\system32\MSFLXGRD.OCX".
5. Press "OK" and a second later it should say the file was registered successfully.
6. Do the same for these other files:
   a. mscomctl.ocx
   b. COMDLG32.OCX
   c. COMCTL32.OCX
   d. scrrun.dll
7. Now try using CFG Studio.

If the program still won't work, check the GTA Forums topic for a solution:

* http://www.gtaforums.com/index.php?showtopic=196381

If it still won't work, add a reply saying what happened.


Windows Vista
-------------
If you are using Windows Vista, run this program in Windows XP SP2 compatibility mode.


Windows 7
---------
No known issues with this - it's what I now use.



Uninstall
=========
To remove the program, simply delete it.

IMPORTANT: Do not delete the files you placed in "C:\windows\system32\" or "C:\windows\system\".



Feedback
========

If you have any problems, feature requests or any other comments about CFG Studio 2, please make them in the forum topic:

* http://www.gtaforums.com/index.php?showtopic=196381

If you are not registered at GTA Forums, you can contact me from my website:

* http://projectcerbera.com/me/

I add problems people tell me about to a list. I work through this list when I'm not busy with other projects.



Features
========

Scrolling
---------
* Mousewheel scrolling is supported.

* Horizontal scrolling from tiltwheels is supported if your drivers are up to date or you have something like IntelliPoint.

* You can use "Shift+Mousewheel" to scroll horizontally if you don't have a special horizontal scroller.


Drag-drop support
-----------------
Drag a file from a folder onto the title bar or menu bar.  The cursor will show a plus sign (+) when you can drop the file to open it.


Opening "Unknown" File Formats
------------------------------
* Backup any "Unknown" files before saving over them with this tool!

* When a file format is not recognised the program enters "Edition: Unknown" mode.

* Columns 0-25 are lettered A-Z.  Columns 26-701 are lettered AA-ZZ.  Columns 702 and higher are numbered.

* The program saves unknown file formats using the most generic rules for GTA text data. It shows a warning about this before it saves.


Command-line Support
--------------------
* Manually associate ".cfg" files with this program to make them open with it as default:

  * Right-click a file.
  * Click "Open With" from the menu and then click "Choose Program..."
  * Find "CFG Studio 2" in the list, or click "Browse..." to find it.
  * Click "OK" and that type of file will now be opened by CFG Studio 2.

* Create a shortcut to the program and add the complete file path at the end of the "target" box.

* Use the "Start Menu > Run" dialogue to run CFG Studio with the path to a file.

* No other parameters have an effect.  Only the first valid file path is used.



Testers
=======
Many thanks to everyone who tests this program to report bugs and suggest ways to improve it.

* Jimmy Durango: Bug reports with a lot of support and motivation.)
* Sadistic Machine: Advice on coding.
* Picolini: Detailed bug reports and motivation.



Distribution
============
Please do not put anything I make on your site. Link to the page on my site where you found it.  This makes it a lot easier for people to find the most recent version.