3D Portfolio lets artists show off their 3D artwork in real-time wherever they are. Importing your own assets into 3D Portfolio is easy — this guide will help you so that your models look their best.
3D Portfolio supports .obj format. Currently only one mesh per file is supported, so be sure to combine them. 3D Portfolio will automatically triangulate quads, but it is recommended that you triangulate the mesh yourself in whatever software you create it in.
Position and scale the mesh in your 3D software. You can download the guide.obj to get an idea of how big it should be. Currently the polygon limit is 50k tris, but you’ll probably want to aim lower than that.
3D Portfolio currently supports diffuse maps, normal maps, and specular maps in .jpg and .png formats. It will detect them based on naming conventions (case sensitive).
- Diffuse – example.D.png
- Normal – example.N.png
- Specular – example.S.png
Currently, shaders are automatically chosen based on the types of textures you upload. If you only include a diffuse map, it will use a “Vertex Lit” shader. Including a normal will set it to a “Bumped Specular” shader. More control over shader options is planned for the future.
Beware of using large resolution textures — you may experience memory issues in the app depending on your device. It will also increase load times. We recommend 512×512 or lower. If you have fewer assets in your gallery, you might be able to get away with higher resolution textures. Jpg is recommended over png for memory efficiency.
Uploading to 3D Portfolio
To get your assets inside the app, first compress them into a zip file and upload them to your webspace. If you don’t have a place to host your assets, we recommend Dropbox — it’s free and easy to use. Once they’re uploaded to your webspace, we recommend emailing yourself a link to the zip file so you can copy and paste it on your device into the app.
In 3D Portfolio, while viewing your gallery, tap the ‘Edit’ button and then tap the asset you want to update (or tap ‘Add New’ to create a new one) — tap the text box for ‘Asset Zip URL’ and paste the link using the on-screen keyboard. Tap ‘done’ on the keyboard and 3D Portfolio will download and import your assets. This may take several seconds depending on network speeds, mesh complexity, and file sizes. Files are saved locally for quicker loading in the future.
Note: both iOS and Android will cache downloaded data. If you update your asset on your web server, it is recommended that you rename the file so the URL is different. On Android you can flush the cache by force quitting the app, but it seems to persist for some time on iOS.
In the Edit Asset menu, you can change the lighting for the asset. “Enable lighting” checkbox will toggle between fullbright (no shading at all) and one directional light. The two sliders under ‘Light Rotation” change the angle of the light — the top one changes the vertical angle while the bottom slider changes the horizontal angle. The “Fix light to camera” checkbox will toggle between having the light fixed to the model (lit parts are always lit, dark parts are always dark) or having the light fixed to the camera (moving the camera changes what parts of the model are lit). The three color sliders change the color and intensity of the light. For example, all three to the right is white. All three halfway would be gray (less intense white light). Red and green to the right with blue to the left gives you yellow. Because light settings are per-asset, each asset can be shown in it’s best light.
Why do we have to host our assets online?
How do I get a valid dropbox link to my zip file?
What can cause the app to crash?
Still have questions? Feel free to shoot us an email!