Set Up Your Scene

Marmoset Viewer content is created by setting up a scene in Marmoset Toolbag, and then exporting a .mview file. All of the scene data including meshes, materials, textures, lights, camera and post effect settings are saved.

Scene Setup

You can set up your scene by importing your mesh, applying your materials and adjusting your lighting, camera and post effects. If you’re unfamiliar with the scene creation process, watch our Scene Setup tutorial.

Marmoset Viewer is designed to run on a large number of devices, so there are some limitations. Shadow casting lights are limited to 3 (you can use more lights, but only the first 3 will cast shadows), omni lights do not cast shadows, and some shader models, post effects and rendering features are not supported at this time. For a full list of supported features, check out the FAQs on our Viewer support page.

Center Your Camera

One of the great things about Marmoset Viewer is that the camera settings, including position, angle, pivot, field of view, and post effects are transferred to the .mview file. This gives the artist full control over the the camera system, but means that care must be taken ensure the scene is easy to navigate. Specifically, it’s important to make sure that the camera is centered, otherwise it will be difficult to rotate the scene. This can generally be solved by selecting your primary mesh and going to View-> Frame Selected (Ctrl+F). More information on this topic can be seen in the following video tutorial:

Export

To export a .mview file, go to File-> Viewer Export or press Shift+Ctrl+V. To add artist credits and a link to your portfolio, simply fill out the Title, Author and Link fields.

Export From Toolbag

The Texture Quality setting significantly affects file size. Low quality limits the maximum texture size to 1024×1024, High to 2048×2048 and Unreasonable to 4096×4096, each level determining quality of the compression. File size affects download speed, bandwidth use, and performance on lower end devices. On export, your content is compressed to minimize file size; texture content is converted to a standard shading model.

The settings in the HTML tab apply to the .html file which is exported alongside the .mview file. Write HTML determines whether or not the .html file is saved, and should generally be enabled for testing purposes or if you plan on embedding your scene with an iframe tag. If you’re uploading your .mview file to a site like ArtStation, feel free to turn off the Write HTML function and ignore the HTML specific settings.

Auto-Play determines whether or not the scene will be automatically loaded when the page opens, Width and Height set the dimensions of the Marmoset Viewer window, and Full Frame determines whether the window will expand to fill the bounds of the page. Full Frame ignores the Height/Width setting, and should be used if you’re embedding your scene with an iframe tag. Use Page Layout Preset applies formatting to the .html page, and should be turned off if you’re embedding your scene via iframe tag or integrating Marmoset Viewer into an existing site design.

View Locally

Opening Marmoset Viewer (.mview) packages is a breeze with the stand-alone Viewer application. Share your 3D models easily and securely with your co-workers and clients. The Viewer application is free and installs with Toolbag.

Upload to ArtStation

The easiest way to share your Marmoset Viewer artwork is to upload your .mview scene to ArtStation. If you don’t have an ArtStation account, you can sign up for one here, it’s free!

Once you’ve signed into ArtStation, go to your Portfolio page and click Create New Project. From there, you can upload your .mview file by clicking the Marmoset Viewer File button.

After you’ve entered all of your pertinent information like project title, description, software used, and tags, press the Save button, which will give you an option to preview your art, or click Publish to post your art publicly on ArtStation.

Lens on ArtStation

Note: ArtStation has a 15MB file size limit (50MB for Pro members), so you may need to adjust the Texture Quality settings. Geometry count also affects file size; if you would like to load untextured high-poly models, it’s best to keep the poly count under 500,000 triangles. Decimating your mesh in zBrush is a good way to reduce the geometry count of very high resolution meshes.

Embedding on Your Website

Marmoset Viewer content can be added to your website or portfolio as well; however, this will require a bit of HTML knowledge and full FTP access to your web server.

The easiest way to add Marmoset Viewer to your website is with an iframe tag which allows you to link to a separate .html file, in this case a page that contains your Marmoset Viewer scene. When exporting your scene, make sure that .html export is on, and that Full Frame is enabled, to ensure that Marmoset Viewer will fill the space of your iframe.

After you’ve exported your .mview and .html files, upload them to your website via FTP. Then copy the following bit of code into your page, replace yourscene1.html with the url to your .html file, set the height and width, and you’re done.

Copy to Clipboard

Note: Be sure allowfullscreen is set to true, otherwise you will not be able to use the full screen feature.

Creating a Gallery

It’s very easy to create a gallery system by adding thumbnail images that swap out the iframe content when clicked. To start, copy the following bit of code, and replace yourscene1.html with the URL to the scene you want to load by default, and give it a name.

Copy to Clipboard

For the clickable thumbnails, copy the next bit of code and for each line, replace the a href with the URL to the .html file, make sure the target is set to the same name as your iframe, and change the img src to the URL of the thumbnail image.

Copy to Clipboard

That’s all you need to do to create a basic gallery system. If you’re experienced with web development, you can get creative and add extra formatting to further customize the appearance of your site. Click the thumbnail links below to see how the gallery code works.


More Questions?

We’d like to hear from you! We are making an effort work with web developers using Marmoset Viewer, and we’d be happy to help and offer advice should you need it. Please send any questions, concerns, or introductions to us at support@marmoset.co.