TABLE OF CONTENTS
You will not be able to add 3D Objects unless the functionality has been enabled for your organization. Contact your Driftscape representative if you wish to add 3D Objects to your plan.
Customers can associate a 3D Object with a Place, an Event or a Tour…but not with Tour Stops.
3D objects are added as media items to a POI (Point of Interest). Only add one 3D object to any POI (if you add more than one, only the first 3D object is used).
Add a 3D Object as a Media Item
Within your Organization within a particular POI, add a new media item under ‘EDIT MEDIA’:
If you do not see the ‘Object’ option available under ‘Media Type,’ contact your Driftscape representative to add this paid service to your plan.
Use the ‘Choose File’ button to select the associated 3D object file.
It must be less than 20mb in size. We limit the size to prevent speed delays in AR Mode (larger objects will consume too much processing ability and negatively impact the user experience).
We recommend using only USDZ files. Apple/iOS only supports limited features of USD in its ARKit functionality. You may send your USDZ file to us prior to usage and we can test it.
Make sure the ‘Is Enabled?’ setting is active [circle underneath will be filled in) . You can turn this off if you are just testing or experiencing issues, in which case the default automatically generated 3D sprite is used instead.
Settings for 3D Objects
There are a variety of settings you can change with 3D objects to help enhance the user experience.
‘Rotation X/Y/Z’: These specify a rotation from the scene origin for the object. Normally, you should place the object such that it is resting on the Y/X plane, facing the negative Y Axis. You can use these settings to rotate the object if changing the source file is not possible. The rotations are specified in a clockwise direction looking down the axis to the origin, in degrees.
‘Is compass facing?’: Normally, when the object is initially populated into the AR mode scene it will be placed oriented and facing the user. However, you may want to have the object facing a specific compass direction if the object is meant to be relative to the landscape at its location.
‘Compass facing angle’: Use this setting to set the angle in degrees from North, going clockwise. This setting is ignored unless the ‘Is compass facing?’ option is enabled.
‘Scale’: This setting is helpful to get the object to appear at the right size in the AR mode scene. The default (set to 1) means that the object is displayed at the scale defined in the object. For example, if the object bounding box is 2 meters high, the object is placed in the scene at that height. You may need to increase the scale or decrease it for the object. For example: if an object is defined as 100m tall, you are not likely to want that since the object will fill the whole camera view anywhere near the object! In such a case, you may set the scale to 0.01 (for example) to make it 1 meter tall. Do not set this to zero or a value less than zero.
‘Height change’: This value is used to adjust the vertical position of the object (the Z axis in the model definition). For example: if the center of the object is defined at the origin, you may want to add a positive adjustment of ½ of the height, so it is ‘resting’ on the X/Y plane. This transformation is applied after the object rotation above, if any.
‘Is planar?’: The default behavior for 3D objects is that they simply replace the generated sprite, placed at the same position (at the height of the phone). You can enable this setting to have the object only placed in the scene when a suitable nearby horizontal surface is detected. When the surface is detected, then the object will be anchored on the center of the detected surface. The default 3D sprite is not replaced until a surface near to the POI is detected (such as the floor, or a table top).
‘Object placement distance’: This setting is ignored unless Is planar is enabled. Since iOS typically only detects surfaces that are within a few meters of the user, a very large object (like a building) may be placed too close to the viewer. Set this value to a distance meters that the object is moved farther away from the phone before it is placed on the detected surface. The default is zero, which is suitable for small objects, for example 50cm or less.
‘Object presentation distance’: This setting is always used, and represents the distance from the user at which the default 3D sprite is replaced with the 3D object. For example: 50 meters would mean that when the user is 50 meters or less away from the POI, then the default sprite is replaced with the 3D object. Generally, you should not set this to more than 200 meters, unless the object is very large (like a ship in a harbor). Given inherent inaccuracy with GPS functionality, it’s recommended to not set this to less than 3 meters.
3D Object Resources
For more information, please visit:
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article