kompas3d-mcp/docs/Kompas3D_SDK/interfaces/kscircularcopydefinition.md

title, type, api, domain, tags, sources

title	type	api	domain	tags	sources
Копия элементов детали по концентрической сетке (Интерфейсы ksCircularCopyDefinition, ICopyCircularDefinition)	interface	api7	2d	interface api7 2d kscircularcopydefinition	kscircularcopydefinition.html

*API интерфейсов. Версия 5 > Документ-модель (Интерфейсы - ksDocument3D, IDocument3D )  > Компонент сборки (деталь или подсборка). Интерфейсы ksPart и IPart  > Объект модели (Интерфейсы ksEntity и IEntity)  > Интерфейсы ksEntity и iEntity - Интерфейс элемента модели (оси, плоскости, формообразующего элемента)  > Интерфейсы копирования *

Копия элементов детали по концентрической сетке (Интерфейсы ksCircularCopyDefinition, ICopyCircularDefinition)

Интерфейс операции копирования по окружности.

ksCircularCopyDefinition	- интерфейс Automation
ICopyCircularDefinition	- интерфейс COM
Примечание:
Данный интерфейс можно получить, используя метод интерфейса элемента модели ksEntity::GetDefinition или IEntity::GetDefinition.

count1 - Количество копий в радиальном направлении

Тип данных: long Синтаксис Automation:

count1 = iCopyCirc.count1    Получить свойство(* )
iCopyCirc.count1 = count1    Установить свойство (* )
count1 = iCopyCirc.GetCount1()    Получить свойство (**)
iCopyCirc.SetCount1(count1)    Установить свойство (**)

count2 - Количество копий в кольцевом направлении

Тип данных: long Синтаксис Automation:

count2 = iCopyCirc.count2    Получить свойство(* )
iCopyCirc.count2 = count2    Установить свойство (* )
count2 = iCopyCirc.GetCount2()    Получить свойство (**)
iCopyCirc.SetCount2(count2)    Установить свойство (**)

DeletedCollection - Получить массив индексов удаленных копий

Синтаксис Automation:

LPDISPATCH DeletedCollection();

Синтаксис COM:

LPDELETEDCOPYCOLLECTION DeletedCollection();
Возвращаемое значение:
указатель на интерфейс ksDeletedCopyCollection или IDeletedCopyCollection    - в случае успешного завершения,
NULL    - в случае неудачи.

Примечание: Интерфейс применяется для массивов компонентов и операций копирования, для получения информации о удаленных копиях, а также управления составом удаленных копий. Информация о удаленной копии выдается в виде индексов копии в узоре копирования. В общем случае это два индекса по ортогональным осям в плоскости узора. Для копий по кривой используется один индекс (первый). Значения индексов начинаются с 1.

factor1 - Признак полного шага в радиальном направлении

Тип данных: BOOL Значения свойства:

TRUE	- свойство step1 устанавливает расстояние между крайними элементами массива в радиальном направлении,
FALSE	- свойство step1 устанавливает расстояние между соседними элементами массива в радиальном направлении.
Синтаксис Automation:

factor1 = iCopyCirc.factor1    Получить свойство(* )
iCopyCirc.factor1 = factor1    Установить свойство (* )
factor1 = iCopyCirc.GetFactor1()    Получить свойство (**)
iCopyCirc.SetFactor1(factor1)    Установить свойство (**)

factor2 - Признак полного шага в кольцевом направлении

Тип данных: BOOL Значения свойства:

TRUE	- свойство step2 устанавливает расстояние между крайними элементами массива в кольцевом направлении,
FALSE	- свойство step2 устанавливает расстояние между соседними элементами массива в кольцевом направлении.
Синтаксис Automation:

factor2 = iCopyCirc.factor2    Получить свойство(* )
iCopyCirc.factor2 = factor2    Установить свойство (* )
factor2 = iCopyCirc.GetFactor2()    Получить свойство (**)
iCopyCirc.SetFactor2(factor2)    Установить свойство (**)

geomArray - Признак использования геометрического копирования

Тип данных: BOOL Значения свойства:

TRUE	- использовать геометрическое копирование. Содержимое операций источников (грани, ребра) копируется без пересчета. В простых случаях операция ускоряется, но возможны ошибки при копировании скруглений и фасок на криволинейных поверхностях,
FALSE	- при копировании все операции-источники строятся заново, т.е. производится полноценный расчет.
Синтаксис Automation:

geomArray = iCircularCopyDefinition.geomArray    Получить свойство(* )
iCircularCopyDefinition.geomArray = geomArray    Установить свойство (* )
iCircularCopyDefinition.GetGeomArray()    Получить свойство (**)
iCircularCopyDefinition.SetGeomArray( geomArray)    Установить свойство (**)

GetAxis - Получить ось копирования

Синтаксис Automation:

LPDISPATCH GetAxis();

Синтаксис COM:

LPENTITY GetAxis();
Возвращаемое значение:
- указатель на интерфейс оси ksEntity или IEntity.

GetCopyParamAlongDir - Получить параметры копирования

Синтаксис Automation:

BOOL GetCopyParamAlongDir (long* count,
double* step,
BOOL* factor,
BOOL dir);

Синтаксис COM:

BOOL GetCopyParamAlongDir (long* count,
double* step,
BOOL* factor,
BOOL dir)
Выходные параметры:
count    - количество копий,
step    - шаг,
factor    - признак полного шага,
dir    - направление копирования.
Возвращаемое значение:
TRUE    - в случае успешного завершения.

GetOperationArray - Получить указатель на массив элементов для копирования

Синтаксис Automation:

LPDISPATCH GetOperationArray();

Синтаксис COM:

LPENTITYCOLLECTION GetOperationArray();
Возвращаемое значение:
- указатель на интерфейс динамического массива элементов, подлежащих копированию ksEntityCollection или IEntityCollection.

inverce - Признак направления копирования

Тип данных: BOOL Значения свойства:

TRUE	- обратное направление,
FALSE	- прямое направление.
Синтаксис Automation:

inverce = iCopyCirc.inverce    Получить свойство(* )
iCopyCirc.inverce = inverce    Установить свойство (* )
inverce = iCopyCirc.GetInverce()    Получить свойство (**)
iCopyCirc.SetInverce(inverce)    Установить свойство (**)

SetAxis - Установить ось копирования

Синтаксис Automation:

BOOL SetAxis(LPDISPATCH axis);

Синтаксис COM:

BOOL SetAxis(LPENTITY axis);
Входной параметр:
axis    - указатель на интерфейс оси ksEntity или IEntity.
Возвращаемое значение:
TRUE    - в случае успешного завершения.

SetCopyParamAlongDir - Установить параметры копирования

Синтаксис Automation:

BOOL SetCopyParamAlongDir (long count,
double step,
BOOL factor,
BOOL dir);

Синтаксис COM:

BOOL SetCopyParamAlongDir (long count,
double step,
BOOL factor,
BOOL dir)
Входные параметры:
count    - количество копий,
step    - шаг,
factor    - признак полного шага,
dir    - направление копирования.
Возвращаемое значение:
TRUE    - в случае успешного завершения.

step1 - Шаг копирования в радиальном направлении

Тип данных: double Синтаксис Automation:

step1 = iCopyCirc.step1    Получить свойство(* )
iCopyCirc.step1 = stept1    Установить свойство (* )
step1 = iCopyCirc.GetStep1()    Получить свойство (**)
iCopyCirc.SetStep1(step1)    Установить свойство (**)

step2 - Шаг в кольцевом направлении

Тип данных: long Синтаксис Automation:

step2 = iCopyCirc.step2    Получить свойство(* )
iCopyCirc.step2 = stept2    Установить свойство (* )
step2 = iCopyCirc.GetStep2()    Получить свойство (**)
iCopyCirc.SetStep2(step2)    Установить свойство (**)