.. role:: blue
   :class: blue

.. версия ядра: 118061

Плагины C3D Converter
=====================
.. _C3D_Converter_plugins:


Плагины позволяют читать модели из форматов, не поддерживаемых ядром C3D непосредственно, в первую очередь это проприетарные форматы. Технически плагин представляет собой библиотеку, реализующую заданный API и явно загружаемую ядром по запросу от приложения.

Плагин является частью C3D Toolkit и максимально интегрирован с геометрическим ядром. В частности это проявляется в том, что ядро автоматически загружает плагин и активирует его единым ключом, если:

1. Ключ содержит требуемый формат ([nx], [sw], [inv], [cat], [se], [cre], [ifc]),

2. Бинарные файлы плагина располагаются в том же каталоге, что и *c3d.dll*.

Некоторые особенности работы с плагинами:

- Плагины можно обновлять независимо от геометрического ядра C3D.
- В качестве упрощенной схемы с собственными плагинами можно работать через метод :blue:`ImportFromFile`\() (при наличии лицензии и расположении бинарных файлов плагина в том же каталоге, что и *c3d.dll*).
- Если необходимо передавать какие либо настройки в экземпляр менеджера конвертации, который возвращает GetConverter3D, то схема использования плагина 2-х ступенчатая: :blue:`GetConverter3D`\() + :blue:`ImportFromFile`\() (если нужны специфичные объекты обратного вызова для настройки (выбор конфигурации)).
- Если необходимо передавать дополнительные настройки, такие как работа с конфигурациями модели или с метаданными, то необходимо использовать функцию :blue:`GetConverter3D`\() для задания специфичных объектов обратного вызова, после чего вызвать :blue:`ImportFromFile`\().
- Через плагины нельзя читать геометрические модели, используя метод :blue:`ImportFromBuffer`\().
- Для использования сторонних плагинов либо для использования с3d плагинов, расположенных в каталоге, отличном от каталога с *c3d.dll*, используется последовательность вызовов: 
:blue:`GetConverter3D`\() - :blue:`LoadForeignReader`\() - :blue:`ImportForeign`\().

Список поддерживаемых версий c3d plugin:

.. raw:: html

   <style>
   .c3d-plugin-table {
       width: 100%;
       border-collapse: collapse;
       table-layout: fixed;
       margin: 12px 0 18px 0;
   }

   .c3d-plugin-table th,
   .c3d-plugin-table td {
       border: 1px solid #222222;
       padding: 10px 12px;
       vertical-align: top;
       text-align: left;
       line-height: 1.35;
   }

   .c3d-plugin-table th {
       background: #e9e9e9;
       font-weight: bold;
       text-align: center;
   }

   .c3d-plugin-table col:nth-child(1) {
       width: 22%;
   }

   .c3d-plugin-table col:nth-child(2) {
       width: 26%;
   }

   .c3d-plugin-table col:nth-child(3) {
       width: 52%;
   }
   </style>

   <table class="c3d-plugin-table">
       <colgroup>
           <col />
           <col />
           <col />
       </colgroup>
       <thead>
           <tr>
               <th>Формат</th>
               <th>Расширение файла</th>
               <th>Версия</th>
           </tr>
       </thead>
       <tbody>
           <tr>
               <td>NX</td>
               <td><em>*.prt</em></td>
               <td>2004 – 2024</td>
           </tr>
           <tr>
               <td>ProE/Creo</td>
               <td><em>*.prt</em>, <em>*.asm</em></td>
               <td>2002 – 2023<br>
               (Pro/Engineer Wildfire 1.0 – Wildfire 5.0;<br>
               Creo R1.0 – Creo R10.0;<br>
               частично поддерживается чтение Creo R11.0)</td>
           </tr>
           <tr>
               <td>SolidWorks</td>
               <td><em>*.sldprt</em>, <em>*.sldasm</em></td>
               <td>2007 – 2024 (PMI и аннотации поддерживаются для SW 2016 – 2024)</td>
           </tr>
           <tr>
               <td>Inventor</td>
               <td><em>*.ipt</em>, <em>*.iam</em></td>
               <td>2010 – 2024</td>
           </tr>
           <tr>
               <td>Catia V5</td>
               <td><em>*.CATPart</em>, <em>*.CATProduct</em></td>
               <td>2004 (V5 R14) – 2023 (V5-6 R33)</td>
           </tr>
           <tr>
               <td>3D XML</td>
               <td><em>*.3dxml</em></td>
               <td>4.2 – 4.3 (нет файлов версий 4.0, 4.1)</td>
           </tr>
           <tr>
               <td>Solid Edge</td>
               <td><em>*.par</em>, <em>*.asm</em>, <em>*.psm</em></td>
               <td>2009 (ST2) – 2024</td>
           </tr>
           <tr>
               <td>IFC</td>
               <td><em>*.ifc</em></td>
               <td>IFC 2X3, IFC 4, IFC 4X3</td>
           </tr>
       </tbody>
   </table>

Для форматов  nwd, rvt, rvm, sp существуют партнерские плагины, совместимые с c3d_plugin, работа с ними аналогична работе с форматом ifc (см. :ref:`Вспомогательные методы конвертеров <Auxiliary_Converter_Methods>`).