.. role:: blue
   :class: blue

.. kernel version: 118061

Auxiliary Converter Methods
===========================
.. _Auxiliary_Converter_Methods_:


A number of auxiliary methods are provided in C3D Converter to obtain information about supported formats and loaded plugins.

**Getting the list of supported formats**

The list of supported formats can be obtained either through the :blue:`IConverter3D` interface or by using a separate API function. The list includes both exchange formats available with the standard [cnv] license and formats provided by plugins.

The following :blue:`IConverter3D` methods are intended for this purpose:

.. code-block:: cpp

   virtual std::vector<c3d::FormatInfo> GetSupportedImportFormats() const;

.. code-block:: cpp

   virtual std::vector<c3d::FormatInfo> GetSupportedImportForeignFormats() const;

The :blue:`GetSupportedImportFormats`\() method returns a list of supported formats, taking into account the license key and the presence of format‑specific converter libraries. If some plugin does not support format listing, then its formats are not included in the result.

The :blue:`GetSupportedImportForeignFormats`\() method returns a list of formats supported for import via :blue:`ImportForeign`\(). The list will be empty if :blue:`LoadForeignReader`\() has not been called or has failed. If some plugin does not support format listing, then its formats are not included in the result.

A separate API function is also provided to obtain the list of supported formats:

.. code-block:: cpp

   CONV_FUNC( std::vector<FormatInfo> ) GetSupportedFormats();

The :blue:`GetSupportedFormats`\() function returns a list of supported formats, taking into account the license key and the presence of format‑specific converter libraries. If some plugin does not support format listing, then its formats are not included in the result.

The :blue:`FormatInfo` structure contains brief information about a format: its name and the list of supported file extensions.

**Getting information about loaded plugins**

To obtain information about loaded and activated plugins, the following function is used:

.. code-block:: cpp

   CONV_FUNC( std::vector<PluginVersionInfo> ) GetLoadedPluginsVersions();

The :blue:`GetLoadedPluginsVersions`\() function returns versions of loaded plugins. The version value is defined by the plugin implementation. If a plugin does not report its version, the string "n/a" is used instead.

The :blue:`PluginVersionInfo` structure contains the full path to the plugin and the plugin version.

Plugin versions differ for different formats. For mechanical formats (*catia*, *creo*, *nx*, *sw*, *se*) and *ifc*, a single plugin version is used, for example 22.0.29.0. Partner plugins for construction formats (*nwd*, *rvt*, *rvm*, *sp*) have their own version numbering schemes, for example 1.4.0.0, since they have been developed independently.