1
0
mirror of https://github.com/rwengine/openrw.git synced 2024-11-22 10:22:52 +01:00
openrw/README.markdown
Daniel Evans e5cc47132f Initial documentation pass
Add a nice doxygen file.
2014-07-09 05:04:48 +01:00

67 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# OpenRW
A project to re-implement gta3.exe, adding support for more platforms and fixing all of the bugs that have piled up.
**REQURIES A LEGITAMATE COPY OF GTA III PC TO RUN**, this project only functions with the original game's data.
## Building
Dependencies:
* Bullet
* GLM (0.9.5+)
* SFML (2.0+)
Options:
* BUILD\_OLD\_TOOLS Builds old, unmaintained tools (datadump & analyzer)
## Running
### rwgame
Implementation of the game itself.
* Options:
* env: OPENRW\_GAME\_PATH, must be set to the folder containing "gta3.exe"
* -w **n**, -h **n** sets initial window size
### rwviewer
File viewer for game data, open the folder containing "gta3.exe" and it will load the data.
Currently only supports viewing instance data, pending some rewriting.
## Documentation
Run Doxygen on the included Doxyfile to generate documentation.
## Things to do
* Make it work on Windows (shouldn't be too difficult for anyone with CMake and C++ experience)
* Write FindSFML and FindGLM scripts for cmake.
* Improve the vehicle dynamics
* Add more views to rwviewer
* Handling data
* Collision data
* Animation scrubbing
* Improve file loading
* One-off loaders should be moved out of GameData into some DATLoader or something.
* Some error mechanism that allows for useful error messages.
## License
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.