3D Model Asset

Table of Contents

    Description

    IntuiFace natively supports 3D models. With this support, users are able to rotate and zoom 3D models using their fingers. In addition, through the use of triggers and actions, you can cause 3D models to rotate and zoom to specific orientations and levels of magnification. Action-initiated rotation and zoom incorporates animation to create an engaging effect.

    3DModel.gif

    To add a 3D model to your experience, either drag it into the active scene from Windows Explorer or import it into the Content Library.

    Note: Under the covers, IntuiFace uses the third-party, open source ThreeJS 3D engine. In our experience, the quality of format support can vary widely within ThreeJS. Try any of the formats listed below but as import quality will vary, be alert to differences and let us know what you see. In addition, test your 3D models in Player on your target devices early and often to ensure you are getting maximum performance.

    Prepping for use of 3D models on Windows PCs

    Composer (and Player for Windows) enables you to configure how aggressively you'd like it to address performance in the 3D Model Asset. Read the article about Composer and Player settings for details.

    In addition, make sure your Windows PC is always updated to the latest video drivers for your graphics card to get the best performance out of the 3D Model asset.

    Supported Formats

    The following list applies to all platforms supported by IntuiFace Composer and Player.

    • Collada ( .dae )
    • Wavefront ( .obj & .mtl )
    • 3ds Max ( .3ds )

    Supported and tested

    • Microsoft XAML 3D ( .xaml )
    • Stereolithography ( .stl )
    • Babylon ( .bablyon )

    Supported but not tested

    If you intend to use such models, let us know how it goes for you through a discussion on our support website.

    • Standard Polygon Library ( .ply )
    • Filmbox ( .fbx )
    • Biovision ( .bvh )
    • Quake II ( .md2 )
    • Assimp JSON ( .json )
    • OpenCTM ( .ctm )
    • Visualization ToolKit ( .vtk )
    • 3D Manufacturing ( .3mf )
    • Additive Manufacturing ( .amf )
    • GL Transmission Format (kronos) ( .gltf )
    • Keyhole Markup Language ( .kmz )
    • MikuMikuDance (game) ( .mmd )
    • Nearly raw raster data ( .nrrd )
    • Point Cloud Library ( .pcd )
    • Packed Raw WebGL Model ( .prwm )
    • Open-source format for Sea3D game engine ( .sea3d )
    • 3D Data Compression ( .draco )

    Unsupported formats

    This list is not exhaustive.

    • 3ds Max ( .ase / .max )
    • Blender ( .blend )
    • PDF including 3D Models ( .pdf )
    • Solidworks ( .smg )
    • Universal 3D ( .u3d )
    • Ogre XML ( .xml )
    • Lightwave ( .lwo / .lws )
    • Cinema 4D ( .c4d )
    • AutoCAD DXF ( .dxf )
    • TrueSpace ( .scn )

    Best practices for textures

    • Texture files located in the root folder of the 3D object will always be loaded.
    • For experience portability purposes, avoid using absolute paths (e.g. C:\...) to reference textures. That said, textures can be referenced within the material file (*.mtl) using a relative file path (ie. relative to the .mtl file).
    • Textures referenced in the material file (*.mtl) with a relative path must be located in the following folder of the IntuiFace project: [Experience Name]/Files/Object3D/[My3DModelFolder]/[TextureFolder].
      • [My3DModelFolder] is the folder IntuiFace created when you added your 3D Model to the experience. It contains your .mtl file
      • [TextureFolder] is a folder you create, referenced with a relative path in your .mtl file. It is in here that you put your texture files.
    • The supported file formats for textures are .jpg, .png, .bmp and .tga.

    Lighting Options

    IntuiFace supports four lighting options for 3D models. These options and their configuration are accessed through the Properties panel. For a description, see the Appearance category in the Properties section below.

    Properties, Triggers & Actions

    Properties

    See our list of common properties for details about properties shared by all asset types.

    Appearance

    Camera

    • X rotation: the initial camera angle around the X axis.
    • Y rotation: the initial camera angle around the Y axis.
    • Auto-rotation: automatically rotates the camera around the Y axis. If checked, a new property becomes available:
      • Auto-rotation speed: speed of the automatic rotation in degrees per second.
    • Zoom level: the initial zoom percentage for the 3D model

    Light Configuration

    • Hemisphere: Sets three light sources:
      • ambient light
      • hemisphere light representing light coming from the sky and the ground
      • directional light that follows the camera
    • Three Points: Sets three light sources:
      • key light that follows the camera
      • fill light that supports the key light, illuminating shadows to reduce strong contrasts
      • back light to define the outlines
    • Camera: Sets a single light source
      • light that follows the camera
    • Model: Sets the light sources defined in the 3D model


    Model Orientation

    • Use default model orientation
      • If deselected, you are presented with options for setting X, Y, and Z offsets from the default model orientation

    Behavior


    Interaction Mode

    • Interaction Mode: defines the interaction mode when the user touches the 3D model. It can be:
      • None: no interaction is allowed.
      • Orbit: camera will move in all three X/Y/Z axes but constraints can be applied to the X/Y axes. For example, use Orbit to prevent users from turning a model upside down.
      • Trackball: camera will move in all three X/Y/Z axes without constraint
      • Pan: camera will pan across the model; the model will not move or rotate.
    • Min X Rotation: defines the minimum angle for the camera angle around the X axis.
    • Max X Rotation: defines the maximum angle for the camera angle around the X axis.
    • Min Y Rotation: defines the minimum angle for the camera angle around the Y axis.
    • Max Y Rotation: defines the maximum angle for the camera angle around the Y axis.
    • Soft move speed: defines the soft move speed when the model is manipulated.

    Zoom

    • Allow zoom: lets users zoom the 3D model.
    • Min zoom: the minimum zoom percentage for the 3D model.
    • Max zoom: the maximum zoom percentage for the 3D model.

    3DPropertiesBehavior.jpg

    Triggers

    See Triggers Overview to get details of common triggersshared by all assets

    3D Model specific triggers:

    • Auto-rotation is changed: Raised when the auto-rotation property is changed. This trigger raises the following read only parameters:
      • Auto-rotate
      • Auto-rotate speed
    • Interaction mode is changed: Raised when the Interaction mode property is changed. This trigger raises the following read only parameters:
      • New interaction mode
      • Old interaction mode
    • Light configuration is changed: Rasied with the light configuration is changed. This trigger raises the following read only parameters:
      • New light configuration
      • Old light configuration
    • Viewport is changed: Raised when the viewport has been changed. This trigger raises the following read only parameters:
      • X: camera angle around the X axis.
      • Y: camera angle around the Y axis.
      • Zoom: zoom percentage
    • Viewport is reset: Raised when the viewport has been reset.

    Actions

    See Actions Overview to get details of common actions shared by all assets

    3D Model specific actions:

    Camera

    • Reset camera: Resets the camera to its original position.
    • Set auto-rotation: Toggles auto-rotation mode and speed.
    • Set camera: Specifies camera position using X/Y rotation angles and a zoom factor.
    • Set interactive mode: Sets the interaction mode.

    Light configuration

    • Set camera light: Changes the light configuration setting to "Camera"
    • Set hemisphere light: Changes the light configuration setting to "Hemisphere"
    • Set model light: Changes the light configuration setting to "Model"
    • Set three points light: Changes the light configuration setting to "Three Points"

    Model

    • Change 3D Model: Replace the current content with new content located at a specified URI.
    • Set model rotation: Displaces the orientation of the model by specified offsets in relation to the default model orientation.

    3D Model Usage Restrictions

    • Limit 3D models in collections to 10k facets. 3D models consume a lot of system resources so a collection filled with very large 3D models could severely impact PC performance.
    • The Container property must be set to Static or Pinnable to enable users to manipulate the 3D model.
    • You can zoom and change the view angle / direction in 3D models but you cannot change the camera position to perform a virtual visit. For virtual visits we recommend the use of videos or Adobe Flash animation.
    • In addition to use of 3D models added to the Content Library, the 3D Model asset can reference a 3D model via an absolute file path. Reference via URL, on the other hand, will not work.
    • Textures referenced with a URL in the material file (*.mtl) will not work. See textures best practices.