Supported file formats and limits for 3D objects, images, and videos
In Microsoft Dynamics 365 Guides, you can use the PC app to add 3D objects, images, and videos to help operators with steps.
Support file formats
The PC app supports the following file formats for these types of files.
| Media | Supported formats | Best practice |
|---|---|---|
| 3D objects | FBX, GLB, glTF, STL, PLY | Optimize your 3D objects as much as possible, to help maintain optimal performance on HoloLens. For more information, see Convert CAD drawings to use as holograms. |
| Images | PNG, JPG, JPEG, BMP, TIF | |
| Video/audio | MP4, MOV, WMV, ASF, AVI M2TS, MKV | Keep your videos less than two minutes long and focused on one step at a time. |
Step content recommended limits
When authors create guides, each step can have different content associations. Guides measures the totality of all content on a step to estimate performance on HoloLens. If limits are exceeded, HoloLens might exhibit poor performance or be unable to display content on steps. We recommend authors check overall memory usage warnings when authoring on HoloLens.
It is the responsibility of the author to balance content on their steps within available limits.
The following limits are guidelines. Any step containing content which nears the limits of all values might exceed the recommended memory limits for a single step. Higher complexity steps might result in longer load times.
| Statistic | Definition | Recommend limit per step |
|---|---|---|
| Triangles | Number of mesh triangles across all parts in a 3D object | 250,000 |
| Parts | Number of nodes in a 3D object's scene hierarchy | 500 |
| Textures | Number of pixels, in megapixels, across all textures referenced by parts and materials in a 3D object | 48 |
3D object limits
The following 3D object size limits are enforced. Exceeding these limits means content won't load on HoloLens.
| Statistic | Definition | Limit |
|---|---|---|
| Vertices | Number of mesh vertices in a single part of a 3D object | 815,000 per part |
| Texture size | Number of pixels, in megapixels, contained in a single texture | 16 per texture (4096 x 4096 or equivalent) |
More information on 3D objects, images, and videos
The August 10, 2022 release introduced a new setting that improves video transcoding. If the PC app detects a hardware transcoding failure, it automatically uses software transcoding instead. If the software transcoding is successful, the Use hardware video encoding on this device setting is automatically updated to switch off hardware video encoding.
The supported video format resolution is 854 x 480 H.264 MP4 (commonly called "Advanced Video Recording"). Any other formats are transcoded when imported and might result in a larger file size than the original.
The file size limit for a video, image, or 3D object is 128 MB. Transcoding might occur when uploading, which might change the size of the file that needs to be stored. This change can cause the upload to fail if the file is too large.
Dynamics 365 Guides uses meters as the default scale unit. If your 3D object scale is set to millimeters when you export from your CAD solution, the object is converted to meters in Dynamics 365 Guides. For example, if your object is 50 millimeters, it's converted to 50 meters. To ensure size consistency between your CAD solution and Dynamics 365 Guides, make sure to set your object scale unit to meters when you export.
Some glTF files might have dependencies in other folders. During upload, if the app doesn't have permissions to those folders, errors can occur, or 3D objects in the gallery might be broken. When you upload glTF objects, make sure that you have permissions to all dependencies, or that all dependencies are in the same folder.