I want to share a workaround we’ve developed to set up a custom Enscape asset library. We’ve been using this workflow for 8 months and it has worked well for us. That said, use this at your own risk because it’s not officially supported by Enscape.
A screenshot of our custom library with 347 assets
To create an Enscape asset you will need:
- A 3d model (.gltf file + .bin + textures )
- Optional: a simplified placeholder (.obj , units in meters)
- Optional: a thumbnail (256x256 jpg)
- Our in-house Asset Generator tool
Enscape uses the open source .gltf format for its assets. We’ve build most of our custom assets in 3ds Max, exporting them to Gltf with the free Babylon Exporter.
However, for this tutorial we will be using the powerful new Blender 2.83, as it’s free, open source and has a built in .gltf exporter.
In this tutorial, we will be using Blender to convert the ‘Kai Lounge Chair’ model into an Enscape asset.
Step 1: Exporting the rendering asset
- Download and install the new Blender 2.83
- Download the blender example file and its textures here.
- Open the blender file and select all the chair parts
- Go the File > Export > Gltf 2.0
- Set the export settings as shown in the screenshot below. Be sure to select “Gltf Separate (+gltf + .bin + textures)”
Gltf export settings
Step 2: exporting the placeholder geometry
The placeholder geometry needs to be exported as a triangulated obj file (units: meters)
- In the Blender file, turn the Enscape Asset collection off and turn the Enscape Placeholder collection on (layers are called 'collections' in Blender).
- Select the simplified geometry
- Go to File > Export > Wavefront (.obj).
- Set the export settings as shown in the screenshot below. Be sure to turn triangulation on.
Obj export settings
Step 3: Thumbnail
The thumbnail should be a .jpg. The asset creator will automatically downssample the image to 256x256px .
You can use Blender to render out a preview (the backdrop, lighting and camera are on the ‘rendering setup’ collection). Or you can render it later in Enscape and update the thumbnail. If you don’t add a thumbnail the asset creator will use a black square instead.
You can download the thumbnail for the Kai chair here.
Step 4: Creating the Enscape asset
Download our ‘Asset Creator’ tool here. Unzip it and run Asset Creator.exe. You should see this:
asset creator tool 1.3 (developed in-house by A+I)
Create a folder for your Enscape asset library (for example: D:\Asset Library ). Make sure that it is accessible to your entire team (local LAN server, google drive, ...).
Load the folder in the asset creator. Hit "new asset" and fill in the form and add all files created in the previous steps.
asset information for the Kai Chair.
Click save.
If the models are too detailed/heavy, the asset creator will warn you with red labels. Notice that in this example, the Outline geometry for the Kai is too detailed (the recommended limit is 500 polygons).
Step 5: Setting up a custom library
The following steps are to enable a custom library and only need to be done once.
- Navigate to %USERPROFILE%\AppData\Local\Enscape
- Open Encape.config with Notepad
- Set the developer line to true: <IsDeveloper>true</IsDeveloper> (if you can’t see this line, add it)
This will enable an extra panel in the Enscape general settings dialog that allows you to add a custom library
On this panel, there are 3 options
- Remote: Enscape will render standard assets only, the asset library panel will show the standard library
- Local: Enscape will render custom assets only, the asset library panel will show the custom library
- Mixed: Enscape will render both standard assets and custom assets, the asset library panel will show the custom library (this is what we use as our default)
Set the panel to mixed and point it to your library location (for example: D:\Asset Library ).
We're done! Reopen the library panel in Enscape. You should see your asset there! If you had trouble following the tutorial, you can download an example of the files here.
Tips
- You might need to turn off your firewall in order to run the Asset Creator tool
- It’s important that none of the texture maps have spaces in their names. Remove the spaces before exporting to gltf
- When creating assets in 3ds max or blender, make sure to apply all transformations and place them at the origin
- If you are using Blender to export to Gltf, make sure to check ‘strip mimetype’ in the Asset Creator
- If you are using 3ds Max: more information on how to install the Babylon plugin can be found here.
- Keep placeholder geometry low poly, especially if you are working in Revit. The asset generator will warn you when you load in an .obj with more than 500 polygons.
Additional tutorials
- How to make cutout maps work with Enscape assets
- I might post additional tutorials later on Gltf material optimizations for Enscape rendering (Enscape does a good job at rendering the default Gltf materials so for most assets it's not strictly necessary). Let me know what you'd be interested in!
Acknowledgments
Special thanks to:
- Anton Cromas for helping to come up with this workaround
- Christian Radowski from Enscape who helped us with advice and tips when we got stuck
- Thomas Willberger from Enscape for encouraging us and allowing us to post this workaround here
I'm sure the Enscape team will release their official custom asset functionality soon, but we hope that this workaround might be helpful to some of you in the mean time.
Let us know if you found this interesting, or whether you're interested in sharing assets.