To use this project for physics simulation using PhysX physics engine you need to have these libraries:
- Assimp https://github.com/assimp/assimp
- Glew 2.1.0 https://glew.sourceforge.net/
- GLFW 3.3.8 https://www.glfw.org/
- GLM https://github.com/g-truc/glm
- PhysX 4.1 https://github.com/NVIDIAGameWorks/PhysX
- SOIL https://github.com/Pikachuxxxx/SOIL
- spdlog https://github.com/gabime/spdlog
- Visual Studio 2022 Currently this project is configured for running in "Release" mode in Visual Studio 2022, but it is possible to be run in "Debug" mode. Debug mode is much slower, but offers great debugging options such as mesh validation and for even more debugging options you can download PhysX Visual Debugger program (https://developer.nvidia.com/physx-visual-debugger). Also in the "logs" folder in project are logged files with performance data of the application on system and in the title name of the window is also shown current Frames per Second.
All libraries need to be compiled and put in the same folder called "Knihovny". This folder need to be in the same parent folder where the "GamePhysics" project is. Then it should work directly without more changes. For PhysX version 4.1 and Visual Studio 2022 there needs to be implemented these small changes listed here: https://github.com/NVIDIAGameWorks/PhysX/pull/577/files. For MD and MDd run there also need to be the library flag changed, which is explained here: NVIDIAGameWorks/PhysX#115 and NVIDIAGameWorks/PhysX#135.
If you want for rigid bodies to be accelerated on GPU instead of CPU there need to be changed the flag in Scene.hpp file. The flag is called "cudaON" and needs to be set to true.
Models can be changed simply. Any new model needs to be put to the folder listed in this path "GamePhysics/GamePhysics/Models". Each model needs to be type of Wavefront OBJ (it contains two files, one with .obj and second one ending with .mtl). If the model does not have a texture file and uses the material for colours, then the default texture "white_tex.png" is used. If the model has a texture, then the texture needs to be in the folder in this path "GamePhysics/GamePhysics/Textures". The texture needs to be in this image format: BMP, PNG, JPG, TGA, DDS, PSD, HDR. More details about support of images for SOIL can be found in this repository: https://github.com/Pikachuxxxx/SOIL.
When the model is in correct directory, then it can be loaded in the Scene.cpp in constructor of this class after skybox model and before camera is added. The code is following:
this->drawable_object.emplace_back(DrawableObject(ModelsLoader::get(model_name), ShaderInstances::phong(), TextureManager::getOrEmplace("model_name", "Textures/white_tex.png"), drawable_object.size(), true, actor_type));.
Parameter "model_name" is the name of the model, so if we have model named example.obj with material in example.mtl, then the "model_name" is gonna be "example". Default for light is Phong reflection model, but it is possible to change it to: constant, phong_no_textures and phong_norm. I recommend to use the default setting for best visualization. If it is desired to use different texture then the "white_tex.png" needs to be changed to the name of the image file with texture like "example.png". "actor_type" is for what type of the actor in the physics is this model gonna be. This parameter is type of int, and number 0 is for static actor, number 1 for dynamic collisionable actor and number 2 is for kinematic actor (which is currently also the character controller).
Lightning can be changed easily. There is multiple light modes: ambient light, point light, directional light, spotlight. Ambient light is already activated and I recommend to leave it like this. Point light can be added with this method in Scene.cpp constructor bellow models inicialization emplaceLight(const glm::vec3 color, const glm::vec3 pos, const gl::Light type). The light type would be "gl::Light::Point". Directional light has example in the constructor. Spotlight is also already implemented as a flashlight which is activated by key E during simulation.
The game is controlled by keyboard keys WASD and arrow keys for movement similar to many games. Looking through camera is done through mouse, where left button of the mouse needs to be pressed for camera movement. Character can jump using Space key. Key F is for shooting collisionable balls. Physics visualization and simulation is ended when the window containing the simulation is closed.