TbtkScriptCadViewObject¶

class TbtkShapeDisplayMode¶

Перечисление. Описывает режим отображения фигур 3D-модели.

Warning

Не поддерживается в Application Server

sdmUndefined¶: Отсутствие значения. Может быть возвращён, если получить значение невозможно.

sdmWireFrame¶: Каркасное отображение фигуры (только рёбра)

sdmShaded¶: Полное отображение фигуры (рисуются грани)

class TbtkScriptCadViewObject¶

Класс реализует API управления представлением 3D-модели. Даёт доступ к методам работы с камерой, детализацией модели, управлению режимами отображения модели и её составных частей.

Проекция¶

Warning

Не поддерживается в Application Server

ZoomAll()¶: Метод подбирает размер модели таким образом, чтобы она оказалась вписана в размеры окна просмотрщика

SetProjection(X, Y, Z: Double)¶

Метод выставляет угол обзора камеры. На данный момент поддерживаются только следующие значения координат: -1, 0, 1.

Parameters:

X (Double) – Положение камеры по оси координат X
Y (Double) – Положение камеры по оси координат Y
Z (Double) – Положение камеры по оси координат Z

GetDetected() → array of THandle¶

Массив содержащий фигуру над которой находится мышь, если под мышью нет фигур - пустой массив.

Return type:: array
Returns:: Если мышь над фигурой - массив из этой фигуры, иначе - пустой массив.

Пример операции всплывающего меню¶

<PASCAL>
  detected := Selection.Controller.Cad.GetDetected;
  if Length(detected) > 0 then
    ShowMessage(Selection.Controller.Cad.GetShapeName(detected[0]));
</PASCAL>

В результате выполнения данного кода будет показано сообщение с именем детали на которой было вызвано всплывающее меню.

Фигуры¶

Warning

Не поддерживается в Application Server

GetShapesByNames(Names: array of string) → array of THandle¶

Метод возвращает набор составных частей модели по имени.

Parameters:: Names (array) – Массив имён фигур которые требуется найти и вернуть как результат.
Return type:: array

Пример поиска фигур по имени¶

<PASCAL>
        viewer := Selection.Controller.CAD;
        if not Assigned(viewer) then
                Exit;

        metalware := viewer.GetShapesByNames(['Bolt 8x16', 'Gayka 8']);
        viewer.SetSelected(metalware);
</PASCAL>

В результате выполнения данного примера будут выделены болты и гайки

GetShapeName(Shape: THandle) → string¶

Метод возвращает имя фигуры.

Parameters:: Shape (THandle) – Фигура, чьё имя будет возвращено
Return type:: string

GetShapeSelected(Shape: THandle) → Boolean¶

Метод возвращает состояние выделенности фигуры.

Parameters:: Shape (THandle) – Фигура, чьё состояние выделения будет возвращено
Return type:: Boolean

SetShapesColor(Shapes: array of THandle; Color: TColor)¶

Метод задаёт цвет фигур.

Parameters:

Shapes (array) – Фигуры, которым будет задан цвет.
Color (TColor) – Новый цвет фигур. Не поддерживаются системные цвета (только RGB), кроме clNone. Если передать специальное значение clNone - цвет будет сброшен, просмотрщик будет использовать цвет по умолчанию.

GetShapeColor(Shape: THandle) → TColor¶

Метод возвращает цвет фигуры. Если цвет не задан - возвращается значение clNone

Parameters:: Shape (THandle) – Фигура, чей цвет будет возвращён
Return type:: TColor

SetShapesTransparent(Shapes: array of THandle; Value: Double)¶

Метод задаёт значение прозрачности фигур.

Parameters:

Shapes (array) – Фигуры, которым будет задано значение прозрачности.
Value (Double) – Новое значение прозрачности для фигур из переданного набора. Допускается использование диапазона от 0 до 1, где 0 - непрозрачность, а 1 - полная прозрачность.

GetShapeTransparent(Shape: THandle) → Double¶

Метод возвращает значение прозрачности фигуры.

Parameters:: Shape (THandle) – Фигура, чьё значение прозрачности будет возвращено
Return type:: Double
Returns:: Дробное значение от 0 до 1, где 0 - непрозрачность, а 1 - полная прозрачность (фигура невидима и отображается только каркас).

SetShapesDisplayMode(Shapes: array of THandle; Value: TbtkShapeDisplayMode)¶

Метод устанавливает режим отрисовки фигур.

Parameters:

Shapes (array) – Фигуры, которым будет задан режим отображения.
Value (TbtkShapeDisplayMode) –

GetShapeDisplayMode(Shape: THandle) → TbtkShapeDisplayMode¶

Метод возвращает режим отображения фигуры.

Parameters:: Shape (THandle) – Фигура, чей режим отображения будет возвращён
Return type:: TbtkShapeDisplayMode

SetShapesVisible(Shapes: array of THandle; Value: Boolean)¶

Метод устанавливает видимость фигур.

Parameters:

Shapes (array) – Фигуры, которым будет задана видимость.
Value (Boolean) –

GetShapeVisible(Shape: THandle) → Boolean¶

Метод возвращает видимость фигуры.

Parameters:: Shape (THandle) – Фигура, чья видимость будет возвращена
Return type:: Boolean

Выделение¶

Warning

Не поддерживается в Application Server

GetSelected() → array of THandle¶

Метод возвращает набор выделенных фигур модели.

Return type:: array

SetSelected(Shapes: array of THandle)¶

Метод задаёт текущее выделение в просмотрщике.

Parameters:: Shapes (array) – Фигуры которые будут выделены после выполнения метода

AddSelected(Shapes: array of THandle)¶

Дополнить существующее выделение заданным набором фигур

Parameters:: Shapes (array) – Фигуры которые будут добавлены к существующему выделению. Если какая-либо фигура уже состоит в выделении - с ней ничего не произойдёт.

RemoveSelected(Shapes: array of THandle)¶

Снять выделение с заданного набора фигур

Parameters:: Shapes (array) – Фигуры которые не будут выделенными после выполнения метода. Если какая-либо фигура из набора изначально не выделена - с ней ничего не произойдёт.

ToggleSelected(Shapes: array of THandle)¶

Изменить выделение фигур из набора

Parameters:: Shapes (array) – Все переданные фигуры изменят своё состояние выделения. Кто был выделен - перестанет. Кто нет - станет.

ClearSelected()¶: Метод сбрасывает выделение со всех выделенных фигур.