Функция get()

 В начало

 

Данная функция позволяет получить значение свойства 2D или 3D элемента. Набор доступных свойств зависит от типа измеряемого элемента.

 

Синтаксис функции:

get ( "строка1", "строка2" ),

где

строка1 - имя элемента или его идентификатор,

строка2 - название свойства.

 

Все 3D элементы и операции имеют идентификатор и параметр "Имя", значение которых по умолчанию автоматически заполняется системой, но имя, при необходимости, может быть изменено пользователем. 2D элементы по умолчанию имеют только идентификатор, а имя можно задать некоторым из них (2D узлам, линиям изображения) в командах редактирования (например, в ENode или EGraphics) с помощью опции <Ctrl><N>или .

 

Функция get() позволяет в Редакторе Переменных получить определенные значения графических элементов. Элементами, параметры которых можно получить с помощью данной функции являются:

- 2D страницы чертежа;

- линии построения;

- 2D узлы;

- линии изображения;

- тексты;

- фрагменты;

- штриховки;

- 3D элементы построения;

- 3D операции;

- грани, рёбра, циклы.

 

Данная функция автоматически подставляется в выражение переменной, если в команде "PM - Измерить" значение выбранного свойства сохраняется в переменной.

 

Зарезервированные имена параметров, которые вы можете получить:

для 2D страниц чертежа:

“ZONES_STEP_X” - размер одной зоны по оси X (величина шага по оси X);

“ZONES_STEP_Y” - размер одной зоны по оси Y (величина шага по оси Y_;

“ZONES_OFFSET_X” - смещение разбиваемой на зоны области относительно точки (0,0) - по оси X;

“ZONES_OFFSET_Y” - смещение разбиваемой на зоны области относительно точки (0,0) - по оси Y;

“ZONES_COUNT_X” - количество зон по оси X;

“ZONES_COUNT_Y” - количество зон по оси Y.

Параметры разбивки страницы чертежа на зоны задаются в команде “ST: Задать параметры документа”, на закладке “Зоны”.

 

для узлов:

“X” – X-координата узла;

“Y” – Y-координата узла;

 

для линий построения:

прямых:

"X", "Y" - координаты первой точки, через которую проходит линия построения – прямая;

"P1", "P2" - координаты второй точки, через которую проходит линия построения – прямая;

окружностей и эллипсов:

"LENGTH" – длина окружности;

"P1" – радиус окружности (данная характеристика присутствует только у окружностей);

"X", "Y" – координаты центра окружности;

сплайнов, 2D путей, функций и эквидистант:

"LENGTH" – длина элемента;

для узлов

"X", "Y" - координаты узла.

 

для линий изображения:

отрезков:

"LENGTH" - длина отрезка;

"START_X", "START_Y" – координаты начальной точки отрезка

"END_X", "END_Y" – координаты конечной точки отрезка;

построенных на основе окружностей:

"LENGTH" - длина дуги окружности;

"CENTER_X", "CENTER_Y" – координаты центра окружности;

"ANGLE" - угол дуги линии изображения;

"RADIUS" – радиус окружности;

построенных на основе эллипсов, сплайнов, 2D путей, эквидистант и функций:

"LENGTH" – длина элемента

для линий изображения, построенных как дуга окружности или эллипса, часть сплайна, 2D пути, эквидистанты или функции, добавляются следующие характеристики:

"START_X", "START_Y" – координаты начальной точки дуги;

"END_X", "END_Y" – координаты конечной точки дуги;

 

для текстов

"WIDTH" - высота текста.

"HEIGHT" - ширина текста

"X", "Y" – координаты X и Y точки привязки текста;

“TEXT” – содержимое текста.

 

для фрагментов

В качестве "строки1" выступает имя или идентификатор фрагмента, в качестве "строки2" - имя переменной фрагмента. Функция возвращает значение переменной.

Кроме того, для 2D фрагментов доступны параметры:

“BoundBoxLeft” – левая граница охватывающего прямоугольника (координата X);

“BoundBoxRight” – правая граница охватывающего прямоугольника (координата X);

“BoundBoxTop” – верхняя граница охватывающего прямоугольника (координата Y);

“BoundBoxBottom” –нижняя граница охватывающего прямоугольника (координата Y);

“BoundBoxCenterX” – координата X центра охватывающего прямоугольника фрагмента;

“BoundBoxCenterY” – координата Y центра охватывающего прямоугольника фрагмента.

 

для размеров:

“FIT” – посадка размера;

“LOWER_DEVIATION” – нижнее значение допуска;

“UPPER_DEVIATION” – верхнее значение допуска;

“TEXT_BEFORE” – текст перед (размерным числом);

“TEXT_AFTER” – текст после (размерного числа);

“TEXT_UNDER” – текст под (размерным числом);

“TOLERANCE” – допуск размера;

“VALUE” – значение размера;

 

для надписей:

“INSCR_TEXT” – текст надписи;

“INSCR_TEXT_UNDER” – текст под полкой надписи;

“TEXT_ON_LEADER” – текст на стрелке;

“TEXT_UNDER_LEADER” – текст под стрелкой;

 

для 2D коннекторов – в качестве характеристик коннектора возвращаются значения коннектора.

 

для штриховок

"AREA" - площадь штриховки.

"XMASS" - Х-координата центра масс.

"YMASS" - У-координата центра масс.

"PERIMETER" - периметр штриховки.

“XAREAMOMENT” – Компонента Ix момента инерции;

“YAREAMOMENT” - Компонента Iу момента инерции;

“PRODUCTAREAMOMENT” - Центробежный момент инерции;

“XINERTIARADIUSVALUE” - Радиус инерции X;

“YINERTIARADIUSVALUE” - Радиус инерции Y;

“XAREAMOMENTMAINVALUE” - Компонента Ix главного момента инерции относительно центра масс;

“YAREAMOMENTMAINVALUE” - Компонента Iу главного момента инерции относительно центра масс;

“MAINAXESROTATIONVALUE” - Угол поворота главных осей инерции.

 

Для 3D элементов системы можно получать свойства следующих объектов:

для операций:

"Area" – площадь поверхности;

"Mass" – масса тела (учитывается плотность материала);

"Xmass", "Ymass", "Zmass" - X,Y,Z-координаты центра масс;

"IX", "IY", "IZ" – Моменты инерции относительно осей X, Y, Z;

"IXY", "IYZ", "IZX" – Значение инерции относительно плоскостей XY, YZ, ZX;

"Volume" – объём;

"Density" - плотность.

для операции “Наложение материала” добавляется свойство:

“MaterialArea” – общая площадь граней, на которые назначен материал;

для 3D массивов операций, Тел и элементов построения любых видов добавляется свойство:

“CopyCount” – фактическое количество копий в массиве (с учётом ограничений и исключений);

для 3D узлов:

"POINTX", "POINTY", "POINTZ" - X, Y, Z-координаты 3D узла;

для 3D профиля:

"Area" - площадь поверхности 3D профиля;

"Perimeter" - периметр замкнутого 3D профиля или длина разомкнутого;

для 3D пути:

"Perimeter" – длина 3D пути;

для грани:

"Area" - площадь поверхности;

"Perimeter" - периметр грани;

для плоской грани добавляются свойства:

"LocationX", "LocationY", "LocationZ" – X, Y, Z-координаты начальной точки плоскости грани;

"NormalX", "NormalY", "NormalZ" – X, Y, Z-компоненты нормали плоскости грани;

"RefDirectionX", "RefDirectionY", "RefDirectionZ" – X, Y, Z-компоненты вектора плоскости (вектор плоскости определяет направление оси X плоскости грани);

для цилиндрической грани добавляются свойства:

"Radius" - радиус цилиндра;

“Diameter” – диаметр цилиндра;

"CenterX", "CenterY", "CenterZ" – X, Y, Z-координаты центра;

"AXISX", "AXISY", "AXISZ" – X, Y, Z-компоненты оси цилиндра;

для тороидальной грани добавляются свойства:

"MaxRadius", "MinRadius" -  максимальный и минимальный радиусы тора;

"CenterX", "CenterY", "CenterZ" – X, Y, Z-координаты центра тора;

"AxisX", "AxisY", "AxisZ" – X, Y, Z-компоненты оси тора;

для сферической грани добавляются характеристики:

“Radius” – радиус сферы;

“Diameter” – диаметр сферы;

“CenterX”, “CenterY”, “CenterZ” – X, Y, Z-координаты центра сферы;

для ребра:

"Perimeter" – длина ребра;

"StartX", "StartY", "StartZ" – X, Y, Z-координаты начальной точки;

"EndX", "EndY", "EndZ" – X, Y, Z-координаты конечной точки;

для прямого ребра добавляются свойства:

"VECTORX", "VECTORY", "VECTORZ" – X, Y, Z-компоненты направления отрезка;

для ребра по окружности или по дуге окружности:

"Radius" – радиус окружности;

“Diameter” – диаметр окружности;

"CenterX", "CenterY", "CenterZ" – X, Y, Z-компонента центра окружности;

"AxisX", "AxisY", "AxisZ" – X, Y, Z-компоненты нормали к плоскости окружности;

"StartAngle" – начальный угол дуги окружности;

"EndAngle" – конечный угол дуги окружности;

для эллиптического ребра добавляются свойства:

"MajorRadius" – радиус большой полуоси эллипса;

"MinorRadius" – радиус малой полуоси эллипса;

"CenterX", "CenterY", "CenterZ" – X, Y, Z-компонента центра эллипса;

"AxisX", "AxisY", "AxisZ" – X, Y, Z-компоненты нормали к плоскости эллипса;

"MaxDirectionX", "MaxDirectionY", "MaxDirectionZ" – X, Y, Z-компонента большой полуоси эллипса;

"MinDirectionX", "MinDirectionY", "MinDirectionZ" – X, Y, Z-компонента малой полуоси эллипса;

"StartAngle" – начальный угол дуги эллипса;

"EndAngle" – конечный угол дуги эллипса;

для цикла:

"Perimeter" – периметр цикла.

для 3D коннекторов – в качестве характеристик коннектора возвращаются значения коннектора.

 

Имена параметров могут задаваться как заглавными, так и строчными буквами.  Если имя элемента или его свойство задано неверно, то функция возвращает значение 0.

 

Примеры.

Для узла, имеющего имя NODE_1, для того,чтобы получить значение его X-координаты необходимо осуществить следующий вызов функции get():

get ( "NODE_1", "X" )

Функция возвратит значение X-координаты узла с именем NODE_1.

 

get("0x9000001","PERIMETER")

Функция возвратит длину периметра контура штриховки, имеющей идентификатор 0x9000001.

 

get("3D фрагмент_11","volume")

Функция возвратит объём тела 3D фрагмента с именем 3D фрагмент_11.

 

Несколько простых применений функции get():

Вычисление периметра любого контура, состоящего из линий изображения.

Определение расстояния между двумя узлами.

Определение координат любой точки, которые трудно рассчитать.

 

Смотри: Функции работы с переменными