1.8.4. TbtkScriptCadViewObject¶

class TbtkShapeDisplayMode¶

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

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

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

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

class TbtkScriptCadViewObject¶

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

1.8.4.1. Проекция¶

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>

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

1.8.4.2. Фигуры¶

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

1.8.4.3. Выделение¶

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()¶: Метод сбрасывает выделение со всех выделенных фигур.