How to configure

The plugin can be configured through the ApeOgre21RenderPlugin.json file.

ApeOgre21RenderPlugin.json

You can set various configurations here. The RenderSystem option can be set as DX11 or OGL. In the renderWindos options you can specify the number of windows and their parameters like name, resolution, misc parameters, viewports, etc.

The apeOgre21RenderPlugin answers the following event groups:

  • NODE

  • LIGHT

  • CMAERA

  • GEOMERTY_FILE

  • GEOMETRY_INDEXEDFACESET

  • GEOMETRY_INDEXEDLINESET

  • MATERIAL_FILE

    • MATERIAL_FILE_SETASSKYBOX

    • MATERIAL_FILE_TEXTURE

    • MATERIAL_FILE_GPUPARAMETERS

  • MATERIAL_PBS

The GEOMETRY_FILE event group is responsible for loading object from .mesh files.

You can call these events from your own plugins in ApertusVR. To create your own plugin use this guide:

Configuring glTF:

If you are using .glTF files you have addicional configuring options in apeAssimpAssetLoaderPlugin.json at ..\ApertusVR\samples\MyScene\configs\myconfig\apeAssimpAssetLoaderPlugin.json.

To load .glTF files:

  1. Open apeAssimpAssetLoaderPlugin.json at ..\ApertusVR\samples\MyScene\configs\myconfig\apeAssimpAssetLoaderPlugin.json.

  2. Add your glTF files to "assets" in the following format:

{
"file": "/plugins/assimpAssetLoader/resources/MyFile.gltf",
"mergeAndExportMeshes": false,
"scale": [ 10, 10, 10 ],
"position": [ 0, 0, 0 ],
"orientation": [ 1, 0, 0, 0 ],
"regenerateNormals": false,
"rootNodeName": "MyFile"
}

You can set the scale, position, orientation to your liking.

To add more than one file:

{
"file": "/plugins/assimpAssetLoader/resources/MyFile.gltf",
"mergeAndExportMeshes": false,
"scale": [ 10, 10, 10 ],
"position": [ 0, 0, 0 ],
"orientation": [ 1, 0, 0, 0 ],
"regenerateNormals": false,
"rootNodeName": "MyFile"
},
{
"file": "/plugins/assimpAssetLoader/resources/MyFile2.gltf",
"mergeAndExportMeshes": false,
"scale": [ 10, 10, 10 ],
"position": [ 0, 50, 0 ],
"orientation": [ 1, 0, 0, 0 ],
"regenerateNormals": false,
"rootNodeName": "MyFile2"
}

In the end the apeAssimpAssetLoaderPlugin.json should look like the following:

{
"assets": [
{
"file": "/plugins/assimpAssetLoader/resources/MyFile.gltf",
"mergeAndExportMeshes": false,
"scale": [ 10, 10, 10 ],
"position": [ 0, 0, 0 ],
"orientation": [ 1, 0, 0, 0 ],
"regenerateNormals": false,
"rootNodeName": "MyFile"
},
{
"file": "/plugins/assimpAssetLoader/resources/MyFile2.gltf",
"mergeAndExportMeshes": false,
"scale": [ 10, 10, 10 ],
"position": [ 0, 50, 0 ],
"orientation": [ 1, 0, 0, 0 ],
"regenerateNormals": false,
"rootNodeName": "MyFile2"
}
]
}