Blender Exporter

Introduction

This Blender add-on adds support for MPEG_* glTF extensions to the built-in glTF exporter.

Additional information can be found at: https://5g-mag.github.io/Getting-Started/pages/xr-media-integration-in-5g/

Installing

The add-on is compatible with Blender 3.6 LTS and 4.2 LTS.

1. Get the source code:

git clone https://github.com/5G-MAG/rt-xr-blender-exporter.git

2. Add it to Blender's script directories:

• open Edit > Preferences ...
• on the left of the preferences panel, select the File Paths section. Check documentation for more information.
• find the Script Directories sub-section add the directory where the git repo was cloned to the list (rt-xr-blender-exporter).
• save the preferences

If the add-on isn't showing show up in the add-on list after this step, try reloading the scripts:

• hit the F3 key, type and select reload scripts.

3. Enable the add-on

• open Edit > Preferences ...
• on the left of the preferences panel, select the [Add-ons] section. Check documentation for more information.
• find the 'rt-xr-blender-exporter' add-on under the 'Import-Export' add-ons.
• tick the checkbox to enable the add-on.

Uninstalling

To uninstall, simply undo the installation steps. Make sure to disable only 'Import-Export: rt-xr-blender-exporter'.

/!\ DO NOT remove Blender's built-in glTF add-on: 'Import-Export: glTF 2.0 format' as it would remove support for gltf in blender.

Using

This add-on extends Blender's core gltf exporter. Import is currently not supported.

To use it, follow the usual glTF export procedure: File > Export > glTF 2.0 (.glb/.gltf)

Exporting MPEG_* extension can be enabled or disabled from the export panel directly:

Comprehensive tutorials to add MPEG_* extensions are available at: https://5g-mag.github.io/Getting-Started/pages/xr-media-integration-in-5g/tutorials/creating_test_assets.html

Development

Debugging

The blender debugger for vscode is a great way to debug blender addons and scripts. The glTF-Blender-IO plugin provides a good introduction on using it. The vscode plugin for Blender works well for debugging, it uses debugpy.

Testing

Testing will to use gltf-validator to ensure conformance of the output.

As support for importing is not planned, there is currently no plan to implement round-trip tests.

Limitations

1. Media MUST have a single track. handling media tracks is not possible with Blender API only, third party libraries may be required (especialy to probe codecs). Another option is to add a panel for users to manually configure tracks assuming they know understand the tracks in their media (error prone).
2. The media mime type used in the video export is always 'video/mp4'
3. MPEG_texture_video's format is assumed to be sRGB and is exported as such
4. The bpy.Type.Image(ID) API is missing informations that are needed to implement MPEG_texture_video:
   • there is no way to identify which track of a media is being used, therefore the add-on currently assumes there is only one track per media
   • the framerates involved in decoding a media are not exposed. As Blender renders video textures at the scene's output framerate, currently that value is used to set the timed accessor's suggestedUpdateRate
5. when export fails because of invalid input (eg. stereo audio, invalid attenuation model ...) there is no easy to clear error message. It exports gltf but without the extensions.
6. Import is not supported, see : #1 (comment)

License

Licensed under the License terms and conditions for use, reproduction, and distribution of 5G-MAG Public License v1.0 (the “License”).

You may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.5g-mag.com/license .

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.