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.

    Properties, Triggers & Actions

    Properties

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

    Appearance

    3D Model

    • 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
    • Use model lights: create light sources using the settings defined within the model. If unchecked, a default white light will be added to the scene.
    • Show curtain shadows: makes the container border visible through shading

    3DPropertiesApp.jpg

    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: (Default) the user controls the camera that will orbit around the model (X & Y axis only)
      • Pan: the user controls the camera that will pan in the scene.
    • 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.
    • Interaction mode is chaned: Raised when the Interaction mode property is changed.
    • Viewport is changed: Raised when the viewport has been changed. This trigger raises the following parameters:
      • X: camera angle around the X axis.
      • Y: camera angle around the Y axis.
      • Zoom: zoom percentage for the 3D model.
    • Viewport is reset: Raised when the viewport has been reset.

    The screenshot below illustrates the set of triggers specific to the 3D Model Asset.

    3DModelTrigger.jpg

    Actions

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

    3D Model specific actions:

    • Reset viewport: Resets the viewport to the default state.
    • Set viewport: Set viewport using x,y,z rotation angles and zoom factor.
    • Set interactive mode: Set interaction mode for this 3D model.
    • Set auto-rotation: Set auto-rotation mode for this 3D model.
    • Change 3D Model: Replace the current content with new content located at a specified URI.

    The screenshot below illustrates the set of actions specific to the 3D Model Asset

    3DModelActions.jpg

    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.