Работа с API КОМПАС-3D → Урок 1 → Основы
Конструктора и инженеры привыкли работать в КОМПАС, вручную строя чертежи, 3D-модели и сборки. Однако система КОМПАС предоставляет богатый набор функций, позволяющих автоматизировать их работу. При желании весь процесс построения сложного чертежа, 3D-модели или сборки можно свести к нажатию на одну кнопку. Правда для этого придется поработать нам, программистам.
В рамках одной статьи невозможно описать все возможности КОМПАС по автоматизации. Для этого не хватит даже книги. К счастью для нас в комплект поставки КОМПАС входит документация, заголовочные файлы для различных языков программирования и ряд примеров.
Рассказывает Сергей Александрович Норсеев — инженер-программист, АО «ВНИИ «Сигнал», Ковров. Автор книги «Разработка приложений под КОМПАС в Delphi»
Документация и примеры
Документация оформлена в виде одного CHM файла. Он расположен в каталоге SDK каталога КОМПАС. На моем домашнем компьютере, например, полный путь к нему выглядит так: «C:\Program Files\ASCON\KOMPAS-3D v17\SDK\SDK.chm». На рисунке ниже представлено содержимое этого файла.
В этом файле представлено полное описание всех интерфейсов, их свойств и методов. В данной статье мы дадим лишь краткий обзор взаимодействия с КОМПАС посредством COM интерфейсов версии 5.
Дополнительно к документации в комплект поставки КОМПАС входит большое количество примеров программирования под эту систему на разных языках программирования. Они расположены в том же каталоге, что и документация. Открыв каталог «SDK», вы увидите несколько архивов, названия которых соответствуют языкам программирования: «Basic», «C#», «С++» и «Pascal». В них и располагаются примеры. Мы будем использовать язык С++, распакуйте соответствующий архив в любое удобное вам место. В качестве среды используется C++ Builder.
Заголовочные файлы
Перед началом работы нам понадобятся заголовочные файлы. Они находятся в каталоге «SDK\Include\». Нам нужны следующие файлы.
«Ks_TLB.h» и «Ks_TLB.cpp». Они содержат объявления всех основных интерфейсов. Это основные файлы.
«ksConstants.h» и «ldefin2D.h». Это необязательные файлы, задающие различные константы.
После того как эти файлы подключены к нашему проекту, мы можем начать работать.
Подключение к КОМПАСу
Сама система КОМПАС в «API интерфейсов версии 5» описывается интерфейсом KompasObject. Соответствующий ему COM-объект задается строкой «KOMPAS.Application.5». Ниже приводится пример подключения к КОМПАСу.
Тип данных «KompasObjectPtr» задает указатель на интерфейс KompasObject.
В результате работы данной программы на экране появится главное окно программы КОМПАС. В ней не будет открыто ни одного документа.
Для закрытия программы КОМПАС используется метод Quit() интерфейса KompasObject. Одним из самых важных методов интерфейса KompasObject является метод GetParamStruct. Он возвращает указатель на интерфейс параметров объекта того или иного типа. Запрашиваемый тип объекта передается в метод в качестве значения единственного параметра. Всего, согласно документации КОМПАС, через данный метод можно получить 129 интерфейсов параметров для объектов различных типов.
Чертеж и фрагмент
Создание чертежа и фрагмента происходит в два этапа. На первом этапе подготавливаются параметры создаваемого документа. На втором – создается сам документ. Такой двухэтапный подход используется при создании практически всех объектов в системе КОМПАС.
Параметры документа описываются интерфейсом ksDocumentParam. Для получения указателя на него используется метод GetParamStruct интерфейса KompasObject с параметром ko_DocumentParam. Главным свойством этого интерфейса является свойство type, в котором указывается тип описываемого данным интерфейсом документа.
Чертеж и фрагмент описываются интерфейсом ksDocument2D. Получить на него указатель можно с помощью метода Document2D интерфейса KompasObject. Ниже приводится пример программы, создающей новый чертеж.
В результате работы этой программы на экране появится главное окно программы КОМПАС с новым чертежом. Данный чертеж не будет иметь ни рамки, ни основной надписи, так как мы их не настроили.
Для создания фрагмента в поле type интерфейса ksDocumentParam необходимо указать значение lt_DocFragment. Во всем остальном процесс создания нового фрагмента аналогичен процессу создания чертежа.
Спецификация
Создание спецификации похоже на создание чертежа и фрагмента. Здесь тоже используется интерфейс ksDocumentParam. Но есть и ряд отличий. Во-первых, спецификация описывается интерфейсом ksSpcDocument. Указатель на этот интерфейс возвращает метод SpcDocument() интерфейса KompasObject. Во-вторых, в случае создания спецификации необходимо указать полный путь к библиотеке стилей. Если он не указан, то система не создаст спецификацию. Библиотека стилей – это файл «graphic.lyt». Он находится в каталоге Sys\ каталога КОМПАС. Ниже приводится пример программы, создающей спецификацию.
В результате работы этой программы на экране появится окно КОМПАСа с созданной в нем спецификацией.
Деталь и сборка
Деталь и сборка в КОМПАС описываются интерфейсом ksDocument3D. Точнее говоря, этот интерфейс описывает файл, содержащий деталь или сборку. Для получения указателя на интерфейс ksDocument3D используется метод Document3D() интерфейса KompasObject. Ниже приводится пример создания детали.
Отсюда видно, что для создания сборки в приведенном выше примере нужно всего лишь изменить значение второго параметра в методе Create.
В данной статье я показал небольшую часть вершины айсберга под названием «взаимодействие с системой КОМПАС посредством COM интерфейсов». Я лишь показал, как подключаться к КОМПАСУ и как создавать документы всех основных видов (чертеж, фрагмент, спецификация, деталь и сборка). Эти документы создаются без содержимого. О том, как их наполнять будет рассказано в следующих статьях. Следите за новостями блога.
Сергей Норсеев, автор книги «Разработка приложений под КОМПАС в Delphi».
ID — что это такое и зачем вообще нужен
ID — данный термин можно часто встретить на просторах сети интернет и не только. Он является уникальным идентификатором чего-либо или кого-либо.
С помощью айди можно легко отличить один объект от другого, уникализировать его по определенным признакам. Это очень удобно, поэтому он так нередко используется.
Из прошлого материала вы узнали, что делать, если windows не удается завершить форматирование. Сейчас мы рассмотрим, что такое ИД, почему этот термин так часто используется и для чего вообще был придуман.
Что такое ID
ID, идентификатор (айди, ид, identifier) — уникальный признак/атрибут объекта, по которому его можно опознать/отличить от других объектов.
Данный параметр/атрибут особенно распространен в интернете, нередко вы можете увидеть его в тех же социальных сетях, к примеру, совсем недавно мы рассматривали, как работать с ним в материале про то, как узнать id вк.
Уникальным идентификатором может быть — пример:
Также айди вы часто можете видеть в чеках из магазинов, там он пишется, как номер транзакции, в мессенджерах, там ID является номер телефона. Ваш email адрес тоже является уникальным и может использоваться в качестве ID.
Простыми словам — любой уникальный признак, который позволяет отличить один объект от другого может называться Айди.
Айди используется по прямому назначению — чтобы идентифицировать объект быстро и главное точно. Именно для этого он и нужен. Пишется обычно так — id-номер-с-буквами.
Что такое ID пользователя
Айди пользователя — это уникальный набор цифр и букв, который позволяет отличить/идентифицировать его аккаунт от аккаунтов других пользователей.
В социальной сети ВКонтакте идентификатором страницы пользователя является номер, которым по счету он зарегистрировался. Пишется номер сразу после слова — id, к примеру, id1.
В других социальных сетях и форумах, к аккаунту пользователя также присваивается свой ID, по которому этот аккаунт может быть идентифицирован. На многих форумах, в таком качестве выступает просто Email.
В заключение
Как видите, это простое число или сочетание цифр, букв и других символов, которое присваивается к чему или кому либо, той же странице профиля. Что позволяет в дальнейшем ее идентифицировать.
Compass
| Description | |||
|---|---|---|---|
| Check the magnetic direction. | |||
The Compass is an Epic Compass in Unturned 3.
If a Player has it in their inventory, they will see a compass bar on the top of the screen. It will be located below the arena bar if they are in Arena Mode.
It becomes more useful alongside a Chart or GPS because the Compass displays the direction of a waypoint marked with either latter two items. It will also display other waypoints marked by other players in the same group on a multiplayer server, in different colours.
Acquirement:
It can be found at campgrounds on all maps.
Compass
A compass is an item used to point to the world spawn or to a lodestone.
Contents
Obtaining [ ]
Crafting [ ]
Natural generation [ ]
| Item | Structure | Container | Quantity | Chance |
|---|---|---|---|---|
| Java Edition | ||||
| Compass | Shipwreck | Map chest | 1 | 7.7% |
| Stronghold | Library chest | 1 | 10.9% | |
| Village | Cartographer’s chest | 1 | 26.3% | |
| Bedrock Edition | ||||
| Compass | Shipwreck | Map chest | 1 | 7.7% |
| Stronghold | Library chest | 1 | 10.5% | |
| Village | Cartographer’s chest | 1 | 26.3% | |
Trading [ ]
In Java Edition, expert-level librarian villagers have a 50% chance to sell a single compass for 4 emeralds.
In Bedrock Edition, expert-level librarian villagers have a 1 ⁄3 chance to sell a single compass for 4 emeralds.
Usage [ ]
Normally, the compass’ needle points toward the world spawn point. The compass points to spawn when viewed in any way, including as a dropped item, in a player’s hand, in an inventory or the crafting table, or in an item frame. The direction the needle points to is relative to the player who is viewing it.
In the Nether or the End, the compass’ needle spins and points in random directions.
The compass can be used on a lodestone, after which it is named lodestone compass by default and points to that lodestone as long as the compass is in the same dimension as the lodestone, but if the compass is taken to a different dimension, it spins randomly, as a normal compass would in the Nether or the End. If the lodestone is destroyed, it also spins randomly, even if the lodestone is replaced afterward. However, if a lodestone compass is placed in storage, the lodestone can be broken and replaced without the compass losing the attunement, as long as the compass remains in storage while the lodestone is missing.
A lodestone compass appears enchanted in Java Edition, similar to the enchanted golden apple, and has a unique cyan glint in Bedrock Edition.
Using /setworldspawn to change the world spawn also changes where the compass points.
Crafting ingredient [ ]
This variation is called an «empty locator map» in Bedrock Edition, or an «empty map» in Java Edition.
Maps crafted from only paper do not show the location marker; to add it, a compass must be added to the map.
Anvil usage [ ]
Maps crafted with only paper do not show the location marker; to add it, a compass must be added to the map.
Trading [ ]
A single compass can be sold to a journeyman-level cartographer villager for 1 emerald. [ Java Edition only ]
A single compass can be sold to an expert-level cartographer villager for 1 emerald as their sixth trade. [ Bedrock Edition only ]
A compass is also part of the cost of explorer maps:
Enchantments [ ]
A compass can receive the following enchantments:
| Name | Max Level | Method |
|---|---|---|
| Curse of Vanishing | I |
Sounds [ ]
| Sound | Subtitles | Source | Description | Resource location | Translation key | Volume | Pitch | Attenuation distance |
|---|---|---|---|---|---|---|---|---|
| https://minecraft.fandom.com/wiki/File:Lodestone_lock1.ogg https://minecraft.fandom.com/wiki/File:Lodestone_lock2.ogg | Lodestone Compass locks onto Lodestone | ? | Using a compass on a lodestone | item.lodestone_compass.lock | subtitles.item.lodestone_compass.lock | ? | ? | 16 |
Data values [ ]
| Name | Resource location | Form | Translation key |
|---|---|---|---|
| Compass | compass | Item | item.minecraft.compass item.minecraft.lodestone_compass |
| Name | Resource location | Alias ID (BE) | Numeric ID | Form | Translation key |
|---|---|---|---|---|---|
| Compass | compass | None | 345 | Item | item.compass.name |
| Lodestone Compass | lodestone_compass | lodestonecompass | 741 | Item | item.lodestonecompass.name |
Item data [ ]
Advancements [ ]
| Icon | Advancement | In-game description | Parent | Actual requirements (if different) | Resource location |
|---|---|---|---|---|---|
 | Country Lode, Take Me Home | Use a compass on a Lodestone | Hidden in the Depths | — | nether/use_lodestone |
History [ ]
Issues [ ]
Issues relating to «Compass» are maintained on the bug tracker. Report issues there.
Gallery [ ]
Purchasing a compass from a librarian villager.
ID-карта для мигранта
Будущее уже наступило. Для того, чтобы контролировать сроки пребывания иностранцев в РФ и быстро получать данные об иностранцах, была введена в пользование электронная карта мигранта, или ID-карта. Инициатор проекта – Ассоциация содействия международной трудовой миграции по Санкт-Петербургу и Ленинградской области и Сбербанк.
ID карта для мигрантов в России
ID-карта – это пластиковая карта с чипом, которая совмещает в себе банковскую карту и электронную карту мигранта. Эта пластиковая карта содержит следующие данные:
Карта не заменяет патент. Иностранец оформляет и электронную карту, и патент на работу. Она упрощает иностранцу контроль за оплатой патента и саму оплату.
Примечание редакции: об оплате патента с помощью айди читайте в статье «ID мигранта при оплате патента».
Преимущества ID-карты мигранта
ID-карта позволяет за несколько секунд получить основную информацию об иностранном гражданине работодателю и контролирующим органам. Но это еще не все возможности электронной карты мигранта.
ID-карта это еще и банковская карта, на которую иностранец сможет получать зарплату и переводить деньги близким с пониженной комиссией. Также это делает систему расчета работодателя с иностранцем прозрачной – в истории финансов видны данные о поступлениях и расходах.
Приложение «Единый миграционный центр» и ID-карта
Также для иностранцев работает приложение «Единый миграционный центр». В нем иностранец может:
Примечание редакции: подробнее о приложении «Единый миграционный центр» читайте в статье «Будущее рядом».
ID-карта вобрала в себя возможности этого приложения. При помощи карты иностранец также может платить за патент по своему ID-номеру и контролировать дату следующего платежа.
Где получить ID карту
ID-карты пока можно оформить только в Санкт-Петербурге. И сделать это можно через нашу компанию, поскольку мы принимаем активное участие в их тестировании.
Примечание редакции: о первых выданных электронных картах читайте в статье «Первые электронные карты мигранта выданы в Петербурге».
Пока ID-карты есть далеко не у всех иностранцев, работодателям необходимо контролировать сроки въезда и выезда иностранца в РФ и быть в курсе миграционного законодательства. Чтобы облегчить себе работу, можно обратиться к миграционным специалистам.
