Getting started
Installing the addon
The MaxWhwere Blender Exporter addon can be downloaded here. The downloaded io_b2mw.zip
can be installed the same way as any other blender addon. The whole .zip
file should be used, without extracting it.
If you are not familiar with the addon installing process, please refer to this page of the blender user manual.
Clearing the old version
If a previous version of the addon was installed to Blender and it was later removed to install the new one, sometimes the previous addon is not removed correctly by Blender's addon manager. If there is some unexplained behavior shown by the addon, that is probably the reason. In this case, after uninstalling the addon again, you should run the MaxWhere Blender Exporter's clearing script which can be found in the .zip
file of the addon under the name of b2mw_clear.bat
.
Creating, exporting, and testing your first MaxWhere space
This section will show you the step-by-step process of creating your first MaxWhere space in Blender, as well as exporting it to and testing it in MaxWhere, by a very simple example.
Creating the Blender scene to be exported
Let us create a new file in Blender. In a new default Blender file, the Scene Collection contains a Camera, a Point Light, and a Cube mesh object.
The default Blender cube comes with its default texture map and material. For our simple example that will be sufficient.
- For advanced mesh preparation for MaxWhere see Meshes;
- for material prepapration see Texture maps and material settings;
- for information about exporting lights to MaxWhere see Adding lights;
- for information about exporting cameras to MaxWhere see Adding cameras;
- for setting additional information through scen properties see Scene properties.
Let us add a webtable to the scene. Choose Add->MaxWhere->Webtable at the 3D Viewport header menu.
The "Webtable" operator panel appears. If you expand the dialog:
- The Align, Location X/Y/Z, and Rotation X/Y/Z values will not have any effect on the webtable.
- You can choose a preset size and resolution, but by default the resolution is calculated automatically (autoresolution option) and you can resize the webtable in object mode.
Click on Webtable_1 in the Outliner. The operator panel disappears.
Fort detailed information on webtable creation and handling in Blender please refer to this page.
Open the 3d Viewport Sidebar and move the webtable to (-2, -1, 1) and rotate it around X and Z axes, each 90°.
Now that we have an adequate scene, let us export it.
Exporting the Blender scene
For saving your Blender scene as a MaxWhere space select File->Export-> Maxwhere(.jsx, .json, .mesh, .obj, .material).
Default settings fit most cases, as well as our example. Choose a name and location to save for your MaxWhere space and press the Export MaxWhere button. A folder will be saved with the chosen name. In this example, we choose the name simple_test
.
The exported simple_test
folder has the following structure:
The exported mesh elements, textures, etc. are in the resources folder.
Loading the result into MaxWhere
The resulting structure can be loaded in MaxWhere for debugging. After starting MaxWhere, in the 3d Browser press Shift+Ctrl+Alt+D and choose the exported folder to load.
The exported scene is opened in MaxWhere.
As we said, this is a pretty simple example, meant for merely demonstrating the scene creation and export process. For detailed settings and advanced export options please browse our documentation pages.