.. include:: <xhtml1-special.txt>

.. role:: raw-html(raw)
    :format: html
    
.. |supported| image:: ../_assets/images/green_circle.png
   
.. |na| image:: ../_assets/images/grey_circle.png
   
.. |unsupported| image:: ../_assets/images/red_circle.png
   
.. |partialsupport| image:: ../_assets/images/gray_green_circle.png

======================
Supported File Formats
======================

The HOOPS/MVO file I/O architecture comes with a variety of input/output handlers that support many commonly used 3D, 2D, raster, and video formats. The file formats listed below can be imported or exported by HOOPS Visualize.

.. only:: standard

	For users with a HOOPS Exchange license, a number of additional formats are accessible via Visualize's "HIO_Exchange" component. Please see the `file formats table <https://docs.techsoft3d.com/exchange/latest/build/overview.html>`_ in the `HOOPS Exchange documentation <https://docs.techsoft3d.com/exchange/latest/build/overview.html>`_ for a complete listing.

| |supported| = supported
| |partialsupport| = partially supported
| |unsupported| = functionality provided as-is


3D Formats
==========		

.. only:: not spatial

	.. csv-table::
		:header: "File Format", "Import", "Export", "Third party package", "Platforms", 
		
		"DWG", |supported|, |unsupported|, ":doc:`RealDWG </prog_guide/hio/HIO_RealDWGIntegration>` or `HOOPS Exchange <https://docs.techsoft3d.com/exchange/latest>`_", "Windows"
		"DGN \*", |supported|, |unsupported|, "DGN Direct", "Windows"
		"HSF", |supported|, |supported|, "n/a", "All"
		"HMF", |supported|, |supported|, "n/a", "All"
		"U3D", |supported|, |unsupported|, "Windows"
		"PRC", |supported|, |supported|, "HOOPS Exchange", "Windows"
		"PDF (2D/3D)", |unsupported|, |supported|, "2D supported is native, 3D PDF requires HOOPS Exchange", "Windows, Linux"
		"OBJ", |supported|, |supported|, "n/a", "All"
		"PLY", |supported|, |supported|, "n/a", "All"
		"SKP", |supported|, |unsupported|, "SketchUp", "Windows"
		"STL", |supported|, |supported|, "n/a", "All"
		"PTS, PTX, XYZ", |supported|, |unsupported|, "n/a", "All"
		"Microstation **", |supported|, |unsupported|, "Microstation plug-in", "Windows"
		"3ds Max \*\*", |supported|, |unsupported|, "3ds Max plug-in", "Windows"
		"VRML \*\*\*", |partialsupport|, |unsupported|, "n/a", "All"
		"OpenInventor \*\*\*", |partialsupport|, |unsupported|, "n/a", "All"

.. only:: spatial

	.. csv-table::
		:header: "File Format", "Import", "Export", "Third Party Package", "Platforms", 
		
		"DWG", |supported|, |unsupported|, ":doc:`RealDWG </prog_guide/hio/HIO_RealDWGIntegration>`", "Windows"
		"DGN \*", |supported|, |unsupported|, "DGN Direct", "Windows"
		"HSF", |supported|, |supported|, "n/a", "All"
		"HMF", |supported|, |supported|, "n/a", "All"
		"PDF (2D)", |unsupported|, |supported|, "2D supported is native", "Windows, Linux"
		"OBJ", |supported|, |supported|, "n/a", "All"
		"PLY", |supported|, |supported|, "n/a", "All"
		"SKP", |supported|, |unsupported|, "SketchUp", "Windows"
		"STL", |supported|, |supported|, "n/a", "All"
		"PTS, PTX, XYZ", |supported|, |unsupported|", "n/a", "All"
		"Microstation **", |supported|, |unsupported|, "Microstation plug-in", "Windows"
		"3ds Max \*\*", |supported|, |unsupported|, "3ds Max plug-in", "Windows"
		"VRML \*\*\*", |partialsupport|, |unsupported|, "n/a", "All"
		"OpenInventor \*\*\*", |partialsupport|, |unsupported|, "n/a", "All"
	

Please see the library compatibility table in the :doc:`Release Notes </general/release_notes/index>` for the required versions of third-party packages.

\* For DGN, HOOPS provides basic capabilities to directly import DGN's CAD and wireframe information. To import fully rendered 3D information, a plugin can be used in Microstation to export an HSF file that can be read by HOOPS.

\*\* Tech Soft 3D provides plug-ins for importing 3ds Max as well as Microstation's DGN formats. These plugins are available on the `Developer Zone <http://developer.techsoft3d.com/hoops/hoops-visualize/>`_.

\*\*\* The importers for these formats are no longer supported and the functionality is provided as-is. Developers who wish to use these formats and address any issues are free to refer to the MVO HIO-importer source code and modify it as they see fit.


2D Formats
==========

.. csv-table::
	:header: "File Format", "Import", "Export", "Supported Platforms"
	
	"PDF", |unsupported|, |supported|, "All"
	"Postscript", |unsupported|, |supported|, "All"
	"HPGL2", |unsupported|, |supported|, "All"
	"CGM", |unsupported|, |supported|, "All"
	

Raster Formats
==============

HOOPS Visualize provides import capabilities via integration with the ImageMagick libraries. For export, Visualize handles these formats natively. Any format supported by ImageMagick can be used in HOOPS Visualize. Below is a list of the major raster formats supported by HOOPS Visualize.

.. csv-table::
	:header: "File Format", "Import", "Export", "Supported Platforms"
	
	"PNG", |supported|, |supported|, "All"
	"JPEG", |supported|, |supported|, "All"
	"GIF", |supported|, |supported|, "All"
	"BMP", |supported|, |supported|, "All"
	"TIFF", |supported|, |supported|, "All"
	
	
Video Formats
=============

HOOPS/MVO currently exports to one video format.

.. csv-table::
	:header: "File Format", "Import", "Export", "Supported Platforms"

	"AVI (animation)", |unsupported|, |supported|, "Windows"
	