Метод LinearGradientBrush::MultiplyTransform (gdiplusbrush.h)

Статья
03/14/2023

Метод LinearGradientBrush::MultiplyTransform обновляет матрицу преобразования этой кисти с помощью собственного произведения и другой матрицы.

Синтаксис

Status MultiplyTransform(
  [in] const Matrix *matrix,
  [in] MatrixOrder  order
);

Параметры

[in] matrix

Тип: const Matrix*

Указатель на матрицу для умножения на текущую матрицу преобразования кисти.

[in] order

Тип: MatrixOrder

Необязательный элемент. Элемент перечисления MatrixOrder , указывающий порядок умножения. MatrixOrderPrepend указывает, что переданная матрица находится слева, а MatrixOrderAppend указывает, что переданная матрица находится справа. Значение по умолчанию — MatrixOrderPrepend.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .

В одной матрице из 3 ×3 может храниться любая последовательность аффинных преобразований. При наличии нескольких трех матриц ×3, каждая из которых представляет аффинное преобразование, произведением этих матриц будет одна матрица из 3 ×3, представляющая всю последовательность преобразований. Преобразование, представленное этим продуктом, называется составным преобразованием. Например, предположим, что матрица R представляет поворот, а матрица T — перевод. Если matrix M является продуктом RT, то матрица M представляет составное преобразование: сначала повернуть, а затем преобразовать.

Важен порядок умножения матрицы. Как правило, матричный продукт RT не совпадает с матричным продуктом TR. В примере, приведенном в предыдущем абзаце, составное преобразование, представленное RT (сначала повернуть, а затем перевести), не совпадает с составным преобразованием, представленным TR (сначала перевести, а затем повернуть).

Примеры

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

VOID Example_MultTrans(HDC hdc)
{
   Graphics myGraphics(hdc);

   Matrix S(2, 0, 0, 1, 0, 0);   // horizontal doubling
   Matrix T(1, 0, 0, 1, 50, 0);  // horizontal translation of 50 units

   LinearGradientBrush linGrBrush(
      Rect(0, 0, 200, 100),
      Color(255, 255, 0, 0),     // red
      Color(255, 0, 0, 255),     // blue
      LinearGradientModeHorizontal);

   // Fill a large area with the gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 100);

   // Apply the scaling transformation.
   linGrBrush.SetTransform(&S);

   // Fill a large area with the scaled gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 150, 800, 100);

   // Form a composite transformation: first scale, then translate.
   linGrBrush.MultiplyTransform(&T, MatrixOrderAppend);

   // Fill a large area with the scaled and translated gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 300, 800, 100);
}

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusbrush.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll