RSMView 4.0.1b
==============

** Please read the Instructions down below, 
** so you don't go around asking people for 
** answers already written here.


Introduction
============
This is a modification of the original RSMView by <I don't know 
his name> based on source code freely available on the YARE forums 
(www.project-yare.com).

It allows you to view the Ragnarok map and model files in 3D 
flying-cam view.


Disclaimer
==========
By using this software you agree to yadda yadda yadda.
Don't sue me, this is free.


System Requirements:
====================
 You will need the following to use RSMView decently:

- GeForce 2 32MB or better video card with OpenGL support
- 128MB RAM
- Pentium III class CPU
- Ragnarok Online installation CD
- 1.4GB free space*

 I'm using:

- Voodoo3 2000 16MB 
- 128MB RAM
- Pentium II 400MHz

 And believe me, its painfully slow, but it works... at 
 0.01 frames per second...

 Recommended:

- GeForce 4 128MB 
- 256MB RAM
- Pentium VI 1.8GHz

A mouse and a keyboard would be handy too... ;)

* Note: Don't forget that 1.4GB extra space on your hard disk. 
        This extra space means with Ragnarok Online already 
	installed. (Ragnarok takes around 536MB)


Instructions:
=============
1. Make sure you have Ragnarok installed.
2. Copy the GrfExtract utility included with this program into
   your Ragnarok folder

   e.g.: C:\Program Files\Gravity\RagnarokOnline\

3. Run the GrfExtract utility.  It should extract the data.grf
   file in your Ragnarok folder into a new folder called "data"

   e.g.: C:\Program Files\Gravity\RagnarokOnline\data

4. This may take a while (1.4GB...) Go grab something to eat.

5. Copy RSMView and RSMViewGUI into a folder.

6. Run RSMViewGUI.  It will show a text box with the path to
   Ragnarok.  Make sure it is correct!

7. Click on Load, and browse for RSW/GND files in the data
   folder, RSM files will be in the data\model folder.
   Never mind the weird characters. They're in Korean.

8. Loading may take a while, and the app will switch to full screen.
   This is normal. Wait for the screen to update.  In case you end up
   with a white screen or some strange texture the camera might be
   inside a building or pointing at empty space.  Move the mouse around
   until you see something.  Controls a la Counterstrike.

The data folder contains all the files needed by Ragnarok and has 
lots of eye candy.  Bitmaps and and wav files abound!  The avatar 
graphics are encoded and found in the data\sprite folder, and can 
be viewed using my Ragnarok SpriteViewer. (also based on somebody 
else's code, and improved upon... see the trend?)

You can modify the contents of these folders and alter Ragnarok
(change loading screens, add new servers, etc...) at your own risk!

Kafra pictures are also stored here.  Just do a search on "kafra".

Controls
========

Mouse movement - look around / adjust camera angle

W or Cursor Up	  - Move forward
S or Cursor Down  - Move back
A or Cursor Left  - Pan left
D or Cursor Right - Pan right

F1 - Fullscreen on/off (will reload all the objects again...)
F2 - Fog on/off
F3 - Reset camera (when you find yourself lost...)

ESC - Close/exit app

Features
================
Original RSMView
================
- Can view RSM (single model) files, RSW (complete world) files, 
  GND (ground only) files.
- OpenGL API (for all you GeForce 4 users out there... :)
- Rotate and Zoom objects


Modifications
==============
RSMView 4.0.1b
==============
- Fixed default Ragnarok folder
- Free camera (allows you to go anywhere and look anywhere)
- Fog 
- Speed optimizations (don't draw all objects/tiles, buggy)
- Full screen at 640x480x16




Help!
=====

- I keep getting a KERNEL32.DLL error everytime I run RSMVIEW!!!

I got this error only when my Ragnarok path is incorrect.  Make sure
your Ragnarok path in RSMViewGUI points to the folder where Ragnarok
is installed.   

Was data.grf extracted successfully?  RSMView needs the data folder
to get all its (decompressed) files such as the models and textures.


To Do
=====
- Fix camera bugs
- Add lighting
- Add shadows
- Possibly port to Voodoo Glide API...


Acknowledgements
================

I'd like to thank the guy who wrote the original RSMViewer.
The code is all his, I just modified it to make it more user friendly.

Thanks also to Ben Humphrey, for his excellent OpenGL Camera class which
is used in this app, and for various tutorials on OpenGL.

Of course, a big applaud to Gravity for bringing out this wonderfully
detailed, textured 3D world which we all would love to live in
(as online characters) and of course the unique multiplayer gameplay 
that millions of Ragnarok fans enjoy, breathe, and talk about during
classes and/or examinations.


Notice
======
I am also coding a RSM/RSW to 3DS converter.  I have it up and running,
just a few more tweaks to the material/texture mapping exporting, but I
found out that my 3DStudio Max 3.1 can't even import textures from 3DS
files, even ones it generates itself.

I don't know if this is an unimplemented feature in 3DS. It seems to be 
that way.

If anyone knows a way to import the 3DS material and texture info into Max
or if its implemented properly in higher versions, please let me know.

For anyone interested in using the RSM to 3DS converter, let me know.

Cheers,

Ender
saintender.geo@yahoo.com

