How to use

Before you can use the plugin you must do the following steps (we assume you already have a working ApertusVR on your computer, if you do not, check out our guide here):

1. Open Cmake and check in the followings: APE_PLUGIN_Ogre21Render, APE_PLUGIN_PhotorealisticScene.

2. Make sure to uncheck the following: APE_PLUGIN_OgreRender.

3. (Optional) If you want to examine the sample using this plugin check in: APE_SAMPLES_PhotorealisticScene.

4. Press Configure then Generate.

To use the plugin you can make your own sample or use an existing one. To create an empty sample skeleton in ApertusVR you can use the following guide:

Creating a sample

When you have your sample you can add the plugin by the following steps:

1. Open your sample's config folder at: ..\ApertusVR\samples\MyScene

2. Open your config where you want to use the plugin.

3. Here you must find a CMakeLists.txt (..\ApertusVR\samples\MyScene\configs\myconfig\CMakeLists.txt)

4. Open CMakeLists.txt.

5. In the set property you must add the followings : apeOgre21RenderPlugin.json. You should already have the followings if not you must add them: apeOisUserInputPlugin.json, apeCore.json.

6. Save your changes and close the file.

7. Open apeCore.json at ..\ApertusVR\samples\MyScene\configs\myconfig\apeCore.json

8. Add the followings to the "plugins" attribute: "apeOgre21RenderPlugin", "apeOisUserInputPlugin", "apePhotorealisticScenePlugin".

9. Save your changes and close the file.

10. Open CMake and click Generate.

..\ApertusVR\samples\MyScene\configs\myconfig\CMakeLists.txt

..\ApertusVR\samples\MyScene\configs\myconfig\apeCore.json

Now you have a sample that uses our Photorealistic Render Plugin. You can use your own plugin to populate your scene with PBS objects. To create your own plugin check out the following guide:

Creating a plugin

For more information read the How to configure tab.

glTF format:

To use glTF files in your project you must do the followin steps alongside with the earlier mentioned:

1. Open CMake and check in: APE_PLUGIN_AssimpAssetLoader.

2. Click Generate.

3. Open CMakeLists.txt at ..\ApertusVR\samples\MyScene\configs\myconfig\CMakeLists.txt

4. In the set property add the following: apeAssimpAssetLoaderPlugin.json.

5. Save the changes and close the file.

6. Open apeCore.json at ..\ApertusVR\samples\MyScene\configs\myconfig\apeCore.json

7. Add the following to the "plugins" attribute: "apeAssimpAssetLoaderPlugin".

8. Add the following to the "resourceLocations" attribute: "/plugins/assimpAssetLoader/resources"

9. Save your changes and close the file.

10. Open CMake and click Generate.

Important: You can not use mpSceneMakerMacro->makeModel() function while using apeAssimpAssetLoaderPlugin in your plugin and sample

..\ApertusVR\samples\MyScene\configs\myconfig\CMakeLists.txt

..\ApertusVR\samples\MyScene\configs\myconfig\apeCore.json

Makes sure to copy all your glTF model's files to: ..\ApertusVR\plugins\assimpAssetLoader\resources. Or you can add its location to ..\ApertusVR\samples\MyScene\configs\myconfig\apeCore.json under the "resourceLocations" attribute. To load a .glTF file into your scene you must edit the apeAssimpAssetLoaderPlugin.json file at ..\ApertusVR\samples\MyScene\configs\myconfig\apeAssimpAssetLoaderPlugin.json. More information about editing apeAssimpAssetLoaderPlugin.json can be found under the How to configure tab.