Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.19. Графические функции

А.5.19.4. rdsXGDrawBlockPicture – рисование картинки блока

Функция rdsXGDrawBlockPicture рисует по указанным координатам векторную картинку блока, модель которого вызвала эту функцию.

  void RDSCALL rdsXGDrawBlockPicture(
    int X,int Y,   // Координаты картинки
    double Angle,  // Угол поворота
    double Scale,  // Масштабный к-т
    double Zoom,   // Увеличение
    BOOL UseVars   // Использовать переменные
  );

Тип указателя на эту функцию

RDS_VIIDDDB

Параметры

X, Y (int): Горизонтальная (X) и вертикальная (Y) координаты картинки (в этой точке будет находиться начало координат картинки блока со всеми ее элементами.
Angle (double): Угол поворота картинки в радианах. Положительное направление – против часовой стрелки.
Scale (double): Масштабный множитель картинки в долях единицы: 1.0 – исходный размер.
Zoom (double): Увеличение (общий масштаб) картинки в долях единицы (1.0 – масштаб 100%).
UseVars (BOOL): TRUE – при рисовании учитывать связь элементов картинки с переменными блока, FALSE – игнорировать связь с переменными.

Примечания

Эта функция рисует векторную картинку блока, из модели которого она вызвана, размещая ее начало координат в точке (X,Y). Если для блока не задана картинка, вызов функции игнорируется.

Параметр Angle задает угол поворота картинки, параметры Scale и Zoom – ее масштаб: размеры масштабируемых элементов картинки умножаются на произведение Scale и Zoom, а размеры элементов, масштабирование которых запрещено – только на Zoom. Можно считать, что Zoom – это визуальный масштаб (аналогичный масштабу окна подсистемы), а Scale – множитель, используемый для увеличения и уменьшения картинки в каких-то других целях.

Параметр UseVars управляет связью элементов картинки с переменными блока. Если в нем передано FALSE, картинка будет нарисована без учета этих связей, как в режиме редактирования. Если же в нем передано TRUE, то видимость, масштаб, поворот и цвет элементов могут зависеть от значений переменных, как в режимах моделирования и расчета.

После вызова функции rdsXGDrawBlockPicture запомненная текущая точка рисования может измениться.