API в разработке приложений Autodesk Inventor. Практическое руководство

 
 
Пайни Дюймовский 
 
 
 
 
 
 
 
API В РАЗРАБОТКЕ ПРИЛОЖЕНИЙ 
AUTODESK INVENTOR  
 
ПРАКТИЧЕСКОЕ РУКОВОДСТВО 
 
Учебное пособие 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Москва    Вологда 
«Инфра-Инженерия» 
2023 

 
Пайни Дюймовский  API в разработке приложений Autodesk Inventor. Практическое руководство 

УДК 004.41 
ББК 32.972 
Д95 
 
 
Рецензенты: 
 
канд. техн. наук, доцент, доцент кафедры автоматики и вычислительной  
техники Вологодского государственного университета И. А. Андрианов;  
технический директор ООО «Лаборатория Поинт» А. А. Федотов 
 
 
 
Пайни Дюймовский 
П16   
API в разработке приложений Autodesk Inventor. Практическое руководство : учебное пособие / Пайни Дюймовский. - Москва ; Вологда : 
Инфра-Инженерия, 2023. - 376 с. : ил., табл. 
ISBN 978-5-9729-1190-5 
 
 
Подробно рассматриваются этапы создания приложения от начала 
проектирования эскиза детали, сборки и до оформления чертежа. В среде 
разработки Visual Basic (VB) показано создание программы-оболочки 
ЕХЕ и наполнение ее рабочими примерами использования API. Рассмотрено модифицирование программы-оболочки для Add-In. 
Для студентов, изучающих информационные технологии. Может 
быть полезно широкому кругу читателей, интересующихся разработкой 
приложений, взаимодействующих с Autodesk Inventor (AI). 
 
УДК 004.41 
ББК 32.972 
 
 
 
 
 
 
 
 
 
 
ISBN 978-5-9729-1190-5 
 
‹ Дюймовский Пайни, 2023  
 
‹ Издательство «Инфра-Инженерия», 2023 
‹ Оформление. Издательство «Инфра-Инженерия», 2023 
 
 
Ϯ



СОДЕРЖАНИЕ 
 
 
Введение 
................................................................................................................... 
5 
 
Глава 1. Создаем скелет оболочки. Настраиваем связь с AI .......................... 
7 
1.1 Установка SDK 
..................................................................................................... 
7 
1.2 Создание проекта программы-оболочки, ее настройка для  
 
взаимодействия с API AI 
..................................................................................... 
7 
 
Глава 2. Создание твердого тела ....................................................................... 
13 
2.1 Создание новой Детали .................................................................................... 
13 
2.2 Создание Эскиза в документе Детали и Сборки 
............................................. 
15 
2.3 Редактирование Эскиза .................................................................................... 
49 
2.4 Изменение ориентации (дислокации) Эскиза 
.................................................. 
58 
2.5 Добавление аннотаций в 3D-модель ............................................................... 
73 
2.6 Создание Сопряжений Ребер, Фасок и Оболочки в 3D-модели .................. 
109 
2.7 «Разбор Дерева» Детали 
................................................................................ 
120 
 
Глава 3. Создание Сборки.................................................................................. 
121 
3.1 Создание новой Сборки .................................................................................. 
121 
3.2 Добавление Деталей в Сборку ....................................................................... 
125 
 
3.2.1 Массив Деталей в Сборке ..................................................................... 
132 
3.3 Зависимости в Сборке 
..................................................................................... 
138 
 
3.3.1 Прокси-объекты 
...................................................................................... 
144 
 
3.3.2 Атрибуты 
................................................................................................. 
171 
 
3.3.3 Ссылочные ключи .................................................................................. 
182 
3.4 Добавление ПодСборки и создание зависимости 
......................................... 
189 
3.5 «Разрезание» Сборки 
...................................................................................... 
201 
3.6 Обход состава Сборки .................................................................................... 
207 
 
3.6.1 «Разрезание» ВСЕХ Деталей в Сборке 
................................................ 
210 
 
Глава 4. Создание Чертежа 
................................................................................ 
221 
4.1 Создание нового Чертежа. 
.............................................................................. 
223 
 
4.1.1 Настройка формата чертежа. 
................................................................ 
225 
4.2 Вставка базового вида модели и проекционных видов. ............................... 
227 
4.3 Простановка размеров на видах .................................................................... 
235 
 
4.3.1 Отображение 3D-аннотаций 
.................................................................. 
235 
 
4.3.2 Извлечение размеров из 3D-модели .................................................... 
237 
 
4.3.3 Извлечение размеров из Эскиза 3D-модели 
........................................ 
245 
 
4.3.4 Создание размеров с использованием геометрических привязок ..... 
248 
4.3.5. Работа с рабочими элементами .......................................................... 
260 
4.4 Создание сечения и выносного вида ............................................................. 
267 
4.5 Создание вида с разрывом, местного разреза и обрезанного 
 
вида. 
................................................................................................................. 
278 
4.6 Чертеж Сборки 
................................................................................................. 
291 
 
4.6.1 Создание сечения и местного разреза на видах 
 
Чертежа Сборки 
...................................................................................... 
292 
 
4.6.2 Создание выносок с номерами позиций 
............................................... 
295 
 
4.6.3 Создание списка Деталей на основе 3D-модели. 
................................ 
315 
 
ϯ


 
Пайни Дюймовский  API в разработке приложений Autodesk Inventor. Практическое руководство 

Глава 5. Создание надстроек Add-In для AI 
.................................................... 
332 
5.1 Создание проекта приложения Add-In ........................................................... 
332 
5.2 Отладка приложения Add-In ........................................................................... 
337 
5.3 Оформление Add-In на основе шаблона ....................................................... 
341 
5.4 Создания дистрибутива приложения Add-In ................................................. 
353 
 
5.4.1 Инсталляция «инструмента» для создания 
 
«Установщика» ....................................................................................... 
353 
 
5.4.2 Создание «Установщика» 
...................................................................... 
357 
 
5.4.3 Запуск созданного «Установщика» ....................................................... 
372 
 
Заключение .......................................................................................................... 
375 
ϰ



 
 
ВВЕДЕНИЕ 
 
 
Изложение настоящей книги будет строиться по следующей схеме:  
В среде разработки Visual Basic (VB) cоздадим программу-оболочку ЕХЕ и будем наполнять ее рабочими примерами использования API. 
Во второй части модифицируем программу-оболочку для Add-In, но созданные 
примеры будут работать точно так же (только в разы быстрее). 
Цель книги не написание учебника по программированию на VB (С и т. п.), их 
написано немало и напишут еще, а максимально детальное знакомство и прикладное (практическое) применение средств API. 
Книга не претендует на освещение всех аспектов применения API, но я постарался включить в нее достаточное количество информации и изложить ее так, чтобы 
вы смогли начать писать собственные приложения сразу, по мере знакомства с тем 
или иным разделом. 
Не буду увеличивать объем книги путем многострочных листингов (только 
фрагменты кода, необходимо и достаточно для понимания). Все рабочие примеры, 
собранные в ModuleBLibrary, можно будет приобрести отдельно, отправив заявку по 
адресу payniinch#gmail.com. 
 
Используемые в книге термины (без претензии на объективность) 
Конструктивный элемент - примитив, созданный из контура, составленного  
из эскизных графических объектов (линия, дуга и т. п.). В качестве синонима для  
эскизный графический объект используется «эскизный объект», «эскизный элемент». 
Твердое тело - совокупность конструктивных элементов, может состоять и из 
одного конструктивного элемента. 
Компонент - синоним 3D-модели. 
3D-модель - общий термин, относится как к Детали, так и к Сборке. 
Объект (Entity) - применяется к любым объектам, которые можно выделить 
средствами пользовательского интерфейса. Это могут быть конструктивные элементы, размеры, грань твердого тела или окружность на Эскизе. 
 
Выделение текстом 
В тексте книги: 
- объекты (объекта Sketch), при объяснении листинга кода (объекты Point2d); 
- коллекции (коллекции .WorkPlanes); 
- свойства, методы и аргументы (метод SketchLines.AddAsTwoPointRectangle, с аргументами oCoordStart1). 
Описание синтаксиса, аргументы: 
StartPoint 
 - Объект, определяющий начальную точку линии. Это может 
быть либо объект Point2d, определяющий точку x-y в …….. 
объекты: 
AddCoincident 
 - Метод, создающий новую зависимость совмещения между 
двумя объектами. Одним из входных объектов должна быть 
точка эскиза. Другим объектом может быть точка …….. 
 
 
ϱ


 
Пайни Дюймовский  API в разработке приложений Autodesk Inventor. Практическое руководство 

Структура «пояснений» 
1. Что делает ȠșȦȢȘ и какого ОБЪЕКТА. 
2. Листинг кода. 
3. «Скрин» синтаксиса  пояснения. 
4. Пояснение листинга (что передаем в аргументы). 
Не могу не сказать теплые слова в адрес тех людей, без которых мне было бы 
намного труднее закончить эту книгу. Прежде всего, это относится к моей жене, которая вынуждена была считаться с тем, что я довольно долго все свободное время 
посвящал работе над книгой. Я выражаю благодарность художнице Марине Грауэрт 
за то, что она любезно согласилась оформить обложку для книги. 
 
ϲ


 
ГЛАВА 1     СОЗДАЕМ СКЕЛЕТ ОБОЛОЧКИ. НАСТРАИВАЕМ СВЯЗЬ С AI 

 
 
ГЛАВА 1  
СОЗДАЕМ СКЕЛЕТ ОБОЛОЧКИ.  
НАСТРАИВАЕМ СВЯЗЬ С AI 
 
 
Предполагается, что у Вас на ПК инсталлирован AI. На момент написания книги 
использовалась версия Autodesk Inventor Professional 2022. 
 
 
1.1 Установка SDK 
Для того, чтобы использовать информацию о возможности AI API «полной ложкой», установим SDK. Установочные файлы SDK обычно находятся в папке: 
³C:\Пользователи\Общие\Общие документы\Autodesk\Inventor 2022\SDK´ 
В этой папке Вы увидите два файла: developertools.msi и usertools.msi. 
Файл developertools.msi устанавливает в Visual Studio шаблоны для создания 
AddIn, также содержит примеры на различных языках программирования, схему 
объектной модели Inventor и пр. Файл usertools.msi содержит дополнительные примеры для программирования. Запустите сначала developertools.msi  (после инсталляции появится папка «DeveloperTools»), потом usertools.msi  (соответственно, 
«UserTools»). 
Я надеюсь, не очень сильно Вас разочарую, но не могу об этом не предупредить: насколько бы Вы не были высокопрофессиональным программистом, Вам 
необходимо хотя бы работать в AI на уровне начального Пользователя, прежде 
чем Вы сможете осмысленно «запрограммить» (а не запустить на выполнение  
код, который что-то делает) то, что вы делаете «врукопашную» в AI. (Эка как завернул -). 
 
 
1.2 Создание проекта программы-оболочки, ее настройка  
для взаимодействия с API AI 
Как я уже говорил, это не учебник по VB, поэтому здесь будет краткое описание 
создания скелета программы-оболочки для тестирования API. Я не буду навязывать 
тот или иной язык программирования и структуру программы, а уж тем более растекаться мыслью по древу, объясняя, что такое переменные, функции, классы и т. п. 
Каждый выберет для себя наиболее знакомый и привычный вариант. 
Если кому-то понравится, то он остановится на предложенном варианте. И так: 
Скрибле-Скрабле-Бумс (или Рекс-Пекс-Фекс). 
За среду разработки возьмем MVSE 2017, создадим новый проект. В этой части 
книги рассматривается способ управления AI простым EXE приложением Windows 
Forms. 
 
ϳ


 
Пайни Дюймовский  API в разработке приложений Autodesk Inventor. Практическое руководство 

 
 
Назначим Имя и место Расположения проекта (на ваш выбор). 
 
 
 
Так вот, основным классом будет Form1 с элементом ComboBox1, для описания 
глобальных переменных создадим модуль ModuleBValue. 
ϴ


 
ГЛАВА 1     СОЗДАЕМ СКЕЛЕТ ОБОЛОЧКИ. НАСТРАИВАЕМ СВЯЗЬ С AI 

 
 
Для работы с Inventor API необходимо добавить в проект ссылку на интерфейсную DDL Инвентора с описанием его API - Autodesk.Inventor.Interop.dll. 
Так же, как и для создания модуля, во вкладке «Проект» находим пункт меню 
«Добавить ссылку…», в нижнем правом углу открывшейся формы нажимаем кнопку 
«Обзор…» и находим, выделяем файл Autodesk.Inventor.Interop.dll и нажимаем кнопку «ОК». Путь к файлу выглядит следующим образом, по крайне мере на моем ПК: 
³C:\Program Files\Autodesk\Inventor 2022\Bin\Public Assemblies´. 
В последующем, когда понадобится, вы будете подключать ссылки по этому же 
алгоритму (правда путь к файлам будет выглядеть иначе -). 
После добавления к проекту сборки ссылки на Autodesk.Inventor.Interop.dll объекты Inventor API становятся доступными к просмотру в Обозревателе объектов. 
Обозреватель отображает иерархические связи между различными объектами. Вместе с навигацией по древовидному списку присутствует и поиск объектов по именам. 
Открыть Обозреватель можно следующим образом: перейти во вкладку «Просмотр», 
пункт меню «Обозреватель объектов». 
 
 
ϵ


 
Пайни Дюймовский  API в разработке приложений Autodesk Inventor. Практическое руководство 

Но мне больше нравится работать с интернет-ресурсом 
(https://help.autodesk.com/view/INVNTOR/2022/ENU/"guid=GUID-902B2746-25C9-41A6953E-C22C28C880AE). 
 
 
 
Теперь мы готовы (я бы сказал находимся в одном шаге -) к использованию  
Inventor API в коде MVSE Visual Basic. 
Продолжим настройку нашего проекта программы-оболочки для работы с AI. 
Добавим в него возможность создавать новый сеанс AI (при завершении работы 
программы сеанс AI также закроется) или подключатся к ранее запущенному сеансу 
AI (после завершении работы программы сеанс AI останется (не мной положено, не 
мной и возьмется -)). 
Добавим в файл .vb класса Form1 над строкой Public Class Form1 несколько пустых строк и на их место вставим несколько строк кода, начинаются с ключевого 
слова Imports. 
Ключевое слово Imports обеспечивает прямой доступ к классам, включенным в 
пространство имен, что избавляет от необходимости вводить полные длинные имена классов в тексте программы. 
 
Imports System 
Imports System.Type 
Imports System.Activator 
Imports System.Runtime.InteropServices 
Imports Inventor 
 
Добавим в класс Form1 следующие переменные: 
 
    Dim _invApp As Inventor.Application 
    Dim _started As Boolean = False 
 
ϭϬ