This is a simple scene renderer for point clouds, polygon meshes without any PBR texture and models with PBR textures(TODO) on maxOS(Windows version will be online soon).
On masOS the you can start Coolender with starter.command in the root directory or use terminal as follow:
cd path_to_Coolender_directory
./CoolenderPS: Maybe there's a warning "It's from an unidentified developer "on macOS, the solution is:https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac.
If Coolender runs successfully, you will see the following GUI:
At first, there is nothing in the scene, so it's blank on the screen, but you can turn on the display floor switch with texture as follow. There is a floor in the scene.
After show the floor, it's easy to adjust the camera position.
There are two operate modes in Coolender with pressing Q to switch.
- World of Warcraft style operate mode(default operate mode).
- FPS games style operate mode.
In World of Warcraft style operate mode, you can press WSD and SPACEto move your view postion. Move your mouse with mouse right button pressed to change view angle. Scroll the mouse wheel to change the field of view.
There is another operate mode like FPS games. You can switch to the FPS style mode with pressing Q in World of Warcraft style operate mode.
In FPS games style operate mode, press WSD and SPACEto move your view postion. Move your mouse to change view angle and scroll the mouse wheel to change the field of view.
Coolender divide the displayable models into 3 categories such as point cloud only has vertex information, polygon mesh has vertex , normals and faces information, model not only has vertex , normals and faces information but also with PBR textures(TODO).
PS: Now Coolender can only import .obj format models, if you want use another format like .ply, .fbx, etc. it's better to convert to .obj format. We list some ways to convert to .obj format.
You can import point cloud models from the top menu as follow.
There's some point cloud models in models/pointcloud directory.
We import the models/point_cloud/bird_m2.obj as an example. After import a point cloud, you can see the information from the side bar. You can set some attributes like point size, color et al. of the point cloud in the side bar or delete point cloud from the scene.
It's quite similar to import polygon mesh compere to importing point cloud from the top menu.
We import the models/point_cloud/diablo3_pose.obj as an example. And it's also the same to set some attributes like point cloud.
TODO...
Besides the attribute settings of a single model, Coolender can set some different render type in Scene Settings from side bar.
For example, choose sphere render type for point cloud.
PS: Although, we use instancing with face culling to render point cloud in sphere type, but it's still performance-consuming, if it's a large point cloud with too many points.
Choose a lighting mode to render the polygon mesh.
Dynamic shadow rendering is performance-consuming, especially render a super-resolution shadow mapping for improving shadow quality. Shadow mapping is turn on by default with floor rendering in Coolender, if it's not necessary to render the shadow, you can turn off the floor rendering.
If you want a good shadow rendering, you can adjust the shadow mapping resolution by increasing shadow mapping resolution scale. We use PCF (Percentage-Closer Filtering) to smooth the shadow edges, so if you render a model from a distance, It’s not necessary to set shadow mapping resolution scale too heigh.
Eg. Low shadow mapping resolution scale
Eg. Heigh shadow mapping resolution scale
You can take a screenshot of the scene by click the Screenshot button in the side bar or use shortcut LEFT CTRL + P. The screenshot will be stored in the screenshot directory under the root directory and will be named automatically. You can change the screenshot store directory as you like by clicking Change path in the side bar.
- Using PBR to render the model with PBR textures.
- Windows version.
- Skybox.
- Normals rendering.
- Multiple lights
- Defferred shading.
- SSAO
Coolender enables MSAA with 8 simples each pixel to anti-aliasing by default, but unfortunately, glfw does not support modifying the number of samples at runtime.