Класс CRenderTarget

Статья
06/16/2023

Оболочка для ID2D1RenderTarget.

Синтаксис

class CRenderTarget : public CObject;

Участники

Открытые конструкторы

Имя	Описание
CRenderTarget::CRenderTarget	Создает объект CRenderTarget.
CRenderTarget::~CRenderTarget	Деструктор Вызывается при уничтожении целевого объекта отрисовки.

Открытые методы

Имя	Описание
CRenderTarget::Attach	Присоединение существующего целевого интерфейса отрисовки к объекту
CRenderTarget::BeginDraw	Инициирует рисование этого целевого объекта отрисовки.
CRenderTarget::Clear	Очищает область рисования до указанного цвета.
CRenderTarget::COLORREF_TO_D2DCOLOR	Преобразует цвета GDI и альфа-значения в объект D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget	Создает новый целевой объект отрисовки растрового изображения для использования во время промежуточного внеэкранного рисования, совместимого с текущим целевым объектом отрисовки.
CRenderTarget::D etarget	Удаляет один или несколько ресурсов
CRenderTarget::D etach	Отсоединяет целевой интерфейс от объекта
CRenderTarget::D rawBitmap	Рисует форматированный текст, описанный указанным объектом IDWriteTextLayout.
CRenderTarget::D rawEllipse	Рисует контур указанного многоточия с помощью указанного стиля штриха.
CRenderTarget::D rawGeometry	Рисует контур указанной геометрии с помощью указанного стиля штриха.
CRenderTarget::D rawGlyphRun	Рисует указанные глифы.
CRenderTarget::D rawLine	Рисует линию между указанными точками с помощью указанного стиля штриха.
CRenderTarget::D rawRectangle	Рисует контур прямоугольника с указанными измерениями и стилем штриха.
CRenderTarget::D rawRoundedRectangle	Рисует контур указанного округленного прямоугольника с помощью указанного стиля штриха.
CRenderTarget::D rawText	Рисует указанный текст с помощью сведений о формате, предоставленных объектом IDWriteTextFormat.
CRenderTarget::D rawTextLayout	Рисует форматированный текст, описанный указанным объектом IDWriteTextLayout.
CRenderTarget::EndDraw	Завершает операции рисования в целевом объекте отрисовки и указывает текущее состояние ошибки и связанные теги.
CRenderTarget::FillEllipse	Красит интерьер указанного многоточия.
CRenderTarget::FillGeometry	Красит интерьер указанной геометрии.
CRenderTarget::FillMesh	Красит интерьер указанной сетки.
CRenderTarget::FillOpacityMask	Применяет маску непрозрачности, описанную указанным растровым изображением, к кисти и использует ее для рисования области целевого объекта отрисовки.
CRenderTarget::FillRectangle	Красит интерьер указанного прямоугольника.
CRenderTarget::FillRoundedRectangle	Красит интерьер указанного округленного прямоугольника.
CRenderTarget::Flush	Выполняет все ожидающие команды рисования.
CRenderTarget::GetAntialiasMode	Извлекает текущий режим защиты от нетекстовых операций рисования.
CRenderTarget::GetDpi	Возвращает точки целевого объекта отрисовки на дюйм (DPI)
CRenderTarget::GetMaximumBitmapSize	Возвращает максимальный размер в единицах, зависящих от устройства (пикселях), любого измерения растрового изображения, поддерживаемого целевым объектом отрисовки.
CRenderTarget::GetPixelFormat	Извлекает формат пикселей и альфа-режим целевого объекта отрисовки
CRenderTarget::GetPixelSize	Возвращает размер целевого объекта отрисовки в пикселях устройства
CRenderTarget::GetRenderTarget	Возвращает интерфейс ID2D1RenderTarget
CRenderTarget::GetSize	Возвращает размер целевого объекта отрисовки в пикселях, независимых от устройства
CRenderTarget::GetTags	Возвращает метку для последующих операций рисования.
CRenderTarget::GetTextAntialiasMode	Возвращает текущий режим защиты для операций рисования текста и глифа.
CRenderTarget::GetTextRenderingParams	Извлекает текущие параметры отрисовки текста целевого объекта отрисовки.
CRenderTarget::GetTransform	Применяет указанное преобразование к целевому объекту отрисовки, заменив существующее преобразование. Все последующие операции рисования происходят в преобразованном пространстве.
CRenderTarget::IsSupported	Указывает, поддерживает ли целевой объект отрисовки указанные свойства.
CRenderTarget::IsValid	Проверка допустимости ресурсов
CRenderTarget::P opAxisAlignedClip	Удаляет последний выровненный по оси клип из целевого объекта отрисовки. После вызова этого метода клип больше не применяется к последующим операциям рисования.
CRenderTarget::P opLayer	Останавливает перенаправление операций рисования на слой, указанный последним вызовом PushLayer.
CRenderTarget::P ushAxisAlignedClip	Удаляет последний выровненный по оси клип из целевого объекта отрисовки. После вызова этого метода клип больше не применяется к последующим операциям рисования.
CRenderTarget::P ushLayer	Добавляет указанный слой в целевой объект отрисовки, чтобы он получал все последующие операции рисования до вызова PopLayer.
CRenderTarget::RestoreDrawingState	Задает состояние рисования целевого объекта отрисовки для указанного объекта ID2D1DrawingStateBlock.
CRenderTarget::SaveDrawingState	Сохраняет текущее состояние рисования в указанном id2D1DrawingStateBlock.
CRenderTarget::SetAntialiasMode	Задает режим защиты целевого объекта отрисовки. Режим защиты применяется ко всем последующим операциям рисования, за исключением операций рисования текста и глифа.
CRenderTarget::SetDpi	Задает точки на дюйм (DPI) целевого объекта отрисовки.
CRenderTarget::SetTags	Указывает метку для последующих операций рисования.
CRenderTarget::SetTextAntialiasMode	Задает режим защиты, используемый для последующих операций рисования текста и глифа.
CRenderTarget::SetTextRenderingParams	Указывает параметры отрисовки текста, применяемые ко всем последующим операциям рисования текста и глифа.
CRenderTarget::SetTransform	Перегружен. Применяет указанное преобразование к целевому объекту отрисовки, заменив существующее преобразование. Все последующие операции рисования происходят в преобразованном пространстве.

Защищенные методы

Имя	Описание
CRenderTarget::VerifyResource	Проверяет допустимость объекта CD2DResource; создает объект, если он еще не существует.

Открытые операторы

Имя	Описание
CRenderTarget::operator ID2D1RenderTarget*	Возвращает интерфейс ID2D1RenderTarget

Защищенные члены данных

Имя	Описание
CRenderTarget::m_lstResources	Список указателей на объекты CD2DResource.
CRenderTarget::m_pRenderTarget	Указатель на объект ID2D1RenderTarget.
CRenderTarget::m_pTextFormatDefault	Указатель на объект CD2DTextFormat, содержащий текстовый формат по умолчанию.

Иерархия наследования

CObject

CRenderTarget

Требования

Заголовок: afxrendertarget.h

CRenderTarget::~CRenderTarget

Деструктор Вызывается при уничтожении целевого объекта отрисовки.

virtual ~CRenderTarget();

CRenderTarget::Attach

Присоединение существующего целевого интерфейса отрисовки к объекту

void Attach(ID2D1RenderTarget* pRenderTarget);

Параметры

pRenderTarget
Существующий целевой интерфейс отрисовки. Не удается иметь значение NULL

CRenderTarget::BeginDraw

Инициирует рисование этого целевого объекта отрисовки.

void BeginDraw();

CRenderTarget::Clear

Очищает область рисования до указанного цвета.

void Clear(D2D1_COLOR_F color);

Параметры

color
Цвет, к которому очищается область рисования.

CRenderTarget::COLORREF_TO_D2DCOLOR

Преобразует цвета GDI и альфа-значения в объект D2D1_COLOR_F.

static D2D1_COLOR_F COLORREF_TO_D2DCOLOR(
    COLORREF color,
    int nAlpha = 255);

Параметры

color
ЗНАЧЕНИЕ RGB.

nAlpha

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

значение D2D1_COLOR_F.

CRenderTarget::CreateCompatibleRenderTarget

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

BOOL CreateCompatibleRenderTarget(
    CBitmapRenderTarget& bitmapTarget,
    CD2DSizeF sizeDesired = CD2DSizeF(0., 0.),
    CD2DSizeU sizePixelDesired = CD2DSizeU(0, 0),
    D2D1_PIXEL_FORMAT* desiredFormat = NULL,
    D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE);

Параметры

bitmapTarget
При возврате этого метода содержит адрес указателя на новый целевой объект отрисовки растрового изображения. Этот параметр передается без инициализации.

sizeDesired
Требуемый размер нового целевого объекта отрисовки в независимых от устройства пикселях, если он должен отличаться от исходного целевого объекта отрисовки или NULL. Дополнительные сведения см. в разделе с примечаниями.

sizePixelDesired
Требуемый размер нового целевого объекта отрисовки в пикселях, если он должен отличаться от исходного целевого объекта отрисовки или NULL. Дополнительные сведения см. в разделе с примечаниями.

DesiredFormat
Требуемый формат пикселей и альфа-режим нового целевого объекта отрисовки или NULL. Если для формата пикселя задано значение DXGI_FORMAT_UNKNOWN или если этот параметр имеет значение NULL, новый целевой объект отрисовки использует тот же формат пикселей, что и исходный целевой объект отрисовки. Если альфа-режим D2D1_ALPHA_MODE_UNKNOWN или этот параметр имеет значение NULL, альфа-режим нового целевого объекта отрисовки по умолчанию используется для D2D1_ALPHA_MODE_PREMULTIPLIED. Сведения о поддерживаемых форматах пикселей см. в разделе "Поддерживаемые форматы пикселей" и "Альфа-режимы".

options
Значение, указывающее, должен ли новый целевой объект отрисовки быть совместимым с GDI.

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

Если метод выполнен успешно, возвращает значение TRUE. В противном случае возвращает значение FALSE.

CRenderTarget::CRenderTarget

Создает объект CRenderTarget.

CRenderTarget();

CRenderTarget::D etarget

Удаляет один или несколько ресурсов

BOOL Destroy(BOOL bDeleteResources = TRUE);

Параметры

bDeleteResources
Если bDeleteResources имеет значение TRUE, все ресурсы, расположенные в m_lstResources, будут автоматически уничтожены.

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

Если метод выполнен успешно, возвращает значение TRUE. В противном случае возвращает значение FALSE

CRenderTarget::D etach

Отсоединяет целевой интерфейс от объекта

ID2D1RenderTarget* Detach ();

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

Указатель на отсоединяемый целевой интерфейс отрисовки.

CRenderTarget::D rawBitmap

Рисует форматированный текст, описанный указанным объектом IDWriteTextLayout.

void DrawBitmap(
    CD2DBitmap* pBitmap,
    const CD2DRectF& rectDest,
    float fOpacity = 1.0,
    D2D1_BITMAP_INTERPOLATION_MODE interpolationMode = D2D1_BITMAP_INTERPOLATION_MODE_LINEAR,
    const CD2DRectF* pRectSrc = NULL);

Параметры

pBitmap
Растровое изображение для отрисовки.

rectDest
Размер и положение в пикселях, независимых от устройства, в пространстве координат целевого объекта отрисовки области, к которой рисуется растровое изображение. Если прямоугольник не является хорошо упорядоченным, ничего не рисуется, но целевой объект отрисовки не вводит состояние ошибки.

Непрозрачность
Значение от 0,0f до 1.0f включительно, указывающее значение непрозрачности для применения к растровой карте; это значение умножается на альфа-значения содержимого растрового изображения.

интерполяцияMode
Режим интерполяции, используемый, если растровое изображение масштабируется или поворачивается операцией рисования.

pRectSrc
Размер и положение в пикселях, независимых от устройства, в пространстве координат растрового изображения, области в растровом рисунке для рисования.

CRenderTarget::D rawEllipse

Рисует контур указанного многоточия с помощью указанного стиля штриха.

void DrawEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Параметры

Эллипс
Положение и радиус многоточия для рисования в пикселях, независимых от устройства.

pBrush
Кисть, используемая для рисования контура эллипса.

fStrokeWidth
Толщина росчерка эллипса. Росчерк сосредоточен на контуре эллипса.

strokeStyle
Стиль росчерка, применяемого к контуру эллипса, или NULL для рисования твердого росчерка.

CRenderTarget::D rawGeometry

Рисует контур указанной геометрии с помощью указанного стиля штриха.

void DrawGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Параметры

pGeometry
Геометрия для рисования.

pBrush
Кисть, используемая для рисования росчерка геометрии.

fStrokeWidth
Толщина росчерка геометрии. Росчерк находится в центре контура геометрии.

strokeStyle
Стиль росчерка, применяемого к контуру геометрии, или NULL для рисования твердого росчерка.

CRenderTarget::D rawGlyphRun

Рисует указанные глифы.

void DrawGlyphRun(
    const CD2DPointF& ptBaseLineOrigin,
    const DWRITE_GLYPH_RUN& glyphRun,
    CD2DBrush* pForegroundBrush,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

Параметры

ptBaseLineOrigin
Источник в пикселях, независимых от устройства, базовых показателей глифов.

Glyphrun
Глифы для отрисовки.

pForegroundBrush
Кисть, используемая для рисования указанных глифов.

измерениеMode
Значение, указывающее, как метрики глифа используются для измерения текста при форматировании. Значение по умолчанию — DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Рисует линию между указанными точками с помощью указанного стиля штриха.

void DrawLine(
    const CD2DPointF& ptFrom,
    const CD2DPointF& ptTo,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Параметры

ptFrom
Начальная точка строки в пикселях, независимых от устройства.

ptTo
Конечная точка строки в пикселях, независимых от устройства.

pBrush
Кисть, используемая для рисования штриха линии.

fStrokeWidth
Значение больше или равно 0,0f, указывающее ширину штриха. Если этот параметр не указан, по умолчанию используется значение 1.0f. Росчерк находится в центре линии.

strokeStyle
Стиль росчерка для рисования или NULL для рисования сплошной линии.

CRenderTarget::D rawRectangle

Рисует контур прямоугольника с указанными измерениями и стилем штриха.

void DrawRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Параметры

Прямоугольник
Размеры прямоугольника для рисования в независимых от устройства пикселях

pBrush
Кисть, используемая для рисования росчерка прямоугольника

fStrokeWidth
Значение больше или равно 0,0f, указывающее ширину штриха прямоугольника. Росчерк находится в центре контура прямоугольника.

strokeStyle
Стиль росчерка для рисования или NULL для рисования твердого росчерка.

CRenderTarget::D rawRoundedRectangle

Рисует контур указанного округленного прямоугольника с помощью указанного стиля штриха.

void DrawRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

Параметры

rectRounded
Размеры округленного прямоугольника для рисования в пикселях, независимых от устройства.

pBrush
Кисть, используемая для рисования контура округленного прямоугольника.

fStrokeWidth
Ширина округленного прямоугольника. Росчерк находится в центре контура округленного прямоугольника. Значение по умолчанию — 1.0f.

strokeStyle
Стиль росчерка округленного прямоугольника или NULL для рисования твердого росчерка. Значение по умолчанию — NULL.

CRenderTarget::D rawText

Рисует указанный текст с помощью сведений о формате, предоставленных объектом IDWriteTextFormat.

void DrawText(
    const CString& strText,
    const CD2DRectF& rectangle,
    CD2DBrush* pForegroundBrush,
    CD2DTextFormat* textFormat = NULL,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

Параметры

strText
Указатель на массив символов Юникода для рисования.

Прямоугольник
Размер и положение области, в которой рисуется текст.

pForegroundBrush
Кисть, используемая для рисования текста.

textFormat
Объект, описывающий форматирование текста для рисования, например шрифт, размер шрифта и направление потока.

options
Значение, указывающее, следует ли привязать текст к границам пикселя и привязать текст к прямоугольнику макета. Значение по умолчанию — D2D1_DRAW_TEXT_OPTIONS_NONE, указывающее, что текст должен быть прикреплен к границам пикселей, и он не должен быть обрезан прямоугольником макета.

CRenderTarget::D rawTextLayout

Рисует форматированный текст, описанный указанным объектом IDWriteTextLayout.

void DrawTextLayout(
    const CD2DPointF& ptOrigin,
    CD2DTextLayout* textLayout,
    CD2DBrush* pBrushForeground,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE);

Параметры

ptOrigin
Точка, описанная в пикселях, независимых от устройства, где рисуется верхний левый угол текста, описанного textLayout.

textLayout
Форматированный текст для рисования. Любые эффекты рисования, которые не наследуются от ID2D1Resource, игнорируются. Если существуют эффекты рисования, наследуемые от ID2D1Resource, которые не являются кистью, этот метод завершается ошибкой, и целевой объект отрисовки помещается в состояние ошибки.

pBrushForeground
Кисть, используемая для рисования текста в textLayout, которая еще не связана с ней как эффект рисования (указанный методом IDWriteTextLayout::SetDrawingEffect).

CRenderTarget::EndDraw

Завершает операции рисования в целевом объекте отрисовки и указывает текущее состояние ошибки и связанные теги.

HRESULT EndDraw();

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

Если метод завершается успешно, возвращает значение S_OK. В противном случае будет возвращен код ошибки HRESULT.

CRenderTarget::FillEllipse

Красит интерьер указанного многоточия.

void FillEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush);

Параметры

Эллипс
Положение и радиус в пикселях, независимых от устройства, многоточия для рисования.

pBrush
Кисть, используемая для рисования интерьера многоточия.

CRenderTarget::FillGeometry

Красит интерьер указанной геометрии.

void FillGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    CD2DBrush* pOpacityBrush = NULL);

Параметры

pGeometry
Геометрия для рисования.

pBrush
Кисть, используемая для рисования интерьера геометрии.

pOpacityBrush
Маска непрозрачности, применяемая к геометрии; NULL для маски непрозрачности. Если указана маска непрозрачности (параметр opacityBrush), кисть должна быть id2D1BitmapBrush с режимами расширения x и y, установленными для D2D1_EXTEND_MODE_CLAMP. Дополнительные сведения см. в разделе с примечаниями.

CRenderTarget::FillMesh

Красит интерьер указанной сетки.

void FillMesh(
    CD2DMesh* pMesh,
    CD2DBrush* pBrush);

Параметры

pMesh
Сетка для рисования.

pBrush
Кисть, используемая для рисования сетки.

CRenderTarget::FillOpacityMask

Применяет маску непрозрачности, описанную указанным растровым изображением, к кисти и использует ее для рисования области целевого объекта отрисовки.

void FillOpacityMask(
    CD2DBitmap* pOpacityMask,
    CD2DBrush* pBrush,
    D2D1_OPACITY_MASK_CONTENT content,
    const CD2DRectF& rectDest,
    const CD2DRectF& rectSrc);

Параметры

pOpacityMask
Положение и радиус в пикселях, независимых от устройства, многоточия для рисования.

pBrush
Кисть, используемая для рисования области целевого объекта отрисовки, заданного назначениемRectangle.

content
Тип содержимого, который содержит маску непрозрачности. Значение используется для определения цветового пространства, в котором смешается маска непрозрачности.

rectDest
Область целевого объекта отрисовки для рисования в пикселях, независимых от устройства.

rectSrc
Область растрового изображения, используемая в качестве маски непрозрачности, в пикселях, независимых от устройства.

CRenderTarget::FillRectangle

Красит интерьер указанного прямоугольника.

void FillRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush);

Параметры

Прямоугольник
Измерение прямоугольника для рисования в пикселях, независимых от устройства.

pBrush
Кисть, используемая для рисования интерьера прямоугольника.

CRenderTarget::FillRoundedRectangle

Красит интерьер указанного округленного прямоугольника.

void FillRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush);

Параметры

rectRounded
Размеры округленного прямоугольника для рисования в независимых пикселях устройства.

pBrush
Кисть, используемая для рисования интерьера округленного прямоугольника.

CRenderTarget::Flush

Выполняет все ожидающие команды рисования.

void Flush(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL);

Параметры

tag1
Содержит тег для операций рисования, вызвавших ошибки или 0, если ошибок не было. Этот параметр передается без инициализации.

tag2
Содержит тег для операций рисования, вызвавших ошибки или 0, если ошибок не было. Этот параметр передается без инициализации.

CRenderTarget::GetAntialiasMode

Извлекает текущий режим защиты от нетекстовых операций рисования.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

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

Текущий режим защиты для операций нетекстового рисования.

CRenderTarget::GetDpi

Возвращает точки целевого объекта отрисовки на дюйм (DPI)

CD2DSizeF GetDpi() const;

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

Точки целевого объекта отрисовки на дюйм (DPI).

CRenderTarget::GetMaximumBitmapSize

Возвращает максимальный размер в единицах, зависящих от устройства (пикселях), любого измерения растрового изображения, поддерживаемого целевым объектом отрисовки.

UINT32 GetMaximumBitmapSize() const;

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

Максимальный размер в пикселях любого измерения растрового изображения, поддерживаемого целевым объектом отрисовки

CRenderTarget::GetPixelFormat

Извлекает формат пикселей и альфа-режим целевого объекта отрисовки

D2D1_PIXEL_FORMAT GetPixelFormat() const;

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

Формат пикселей и альфа-режим целевого объекта отрисовки

CRenderTarget::GetPixelSize

Возвращает размер целевого объекта отрисовки в пикселях устройства

CD2DSizeU GetPixelSize() const;

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

Размер целевого объекта отрисовки в пикселях устройства

CRenderTarget::GetRenderTarget

Возвращает интерфейс ID2D1RenderTarget

ID2D1RenderTarget* GetRenderTarget();

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

Указатель на интерфейс ID2D1RenderTarget или NULL, если объект еще не инициализирован.

CRenderTarget::GetSize

Возвращает размер целевого объекта отрисовки в пикселях, независимых от устройства

CD2DSizeF GetSize() const;

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

Текущий размер целевого объекта отрисовки в пикселях, независимых от устройства

CRenderTarget::GetTags

Возвращает метку для последующих операций рисования.

void GetTags(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL) const;

Параметры

tag1
Содержит первую метку для последующих операций рисования. Этот параметр передается без инициализации. Если задано значение NULL, для этого параметра не извлекается никакое значение.

tag2
Содержит вторую метку для последующих операций рисования. Этот параметр передается без инициализации. Если задано значение NULL, для этого параметра не извлекается никакое значение.

CRenderTarget::GetTextAntialiasMode

Возвращает текущий режим защиты для операций рисования текста и глифа.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

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

Текущий режим защиты для операций рисования текста и глифа.

CRenderTarget::GetTextRenderingParams

Извлекает текущие параметры отрисовки текста целевого объекта отрисовки.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Параметры

textRenderingParams
Когда этот метод возвращается, textRenderingParamscontains адрес указателя на текущие параметры отрисовки текста целевого объекта отрисовки.

CRenderTarget::GetTransform

Возвращает текущее преобразование целевого объекта отрисовки.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Параметры

transform
Когда это возвращается, содержит текущее преобразование целевого объекта отрисовки. Этот параметр передается без инициализации.

CRenderTarget::IsSupported

Указывает, поддерживает ли целевой объект отрисовки указанные свойства.

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Параметры

renderTargetProperties
Свойства целевого объекта отрисовки для тестирования

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

ЗНАЧЕНИЕ TRUE, если указанные свойства целевого объекта отрисовки поддерживаются этим целевым объектом отрисовки; в противном случае значение FALSE

CRenderTarget::IsValid

Проверка допустимости ресурсов

BOOL IsValid() const;

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

ЗНАЧЕНИЕ TRUE, если ресурс действителен; в противном случае ЗНАЧЕНИЕ FALSE.

CRenderTarget::m_lstResources

Список указателей на объекты CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Указатель на объект ID2D1RenderTarget.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Указатель на объект CD2DTextFormat, содержащий текстовый формат по умолчанию.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Возвращает интерфейс ID2D1RenderTarget

operator ID2D1RenderTarget*();

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

Указатель на интерфейс ID2D1RenderTarget или NULL, если объект еще не инициализирован.

CRenderTarget::P opAxisAlignedClip

Удаляет последний выровненный по оси клип из целевого объекта отрисовки. После вызова этого метода клип больше не применяется к последующим операциям рисования.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Останавливает перенаправление операций рисования на слой, указанный последним вызовом PushLayer.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

void PushAxisAlignedClip(
    const CD2DRectF& rectClip,
    D2D1_ANTIALIAS_MODE mode = D2D1_ANTIALIAS_MODE_PER_PRIMITIVE);

Параметры

rectClip
Размер и положение области вырезки в пикселях, независимых от устройства.

mode
Режим защиты, используемый для рисования краев прямоугольников клипа с границами подпикселя, а также для смешивания клипа с содержимым сцены. Смешивание выполняется один раз при вызове метода PopAxisAlignedClip и не применяется к каждому примитиву в слое.

CRenderTarget::P ushLayer

Добавляет указанный слой в целевой объект отрисовки, чтобы он получал все последующие операции рисования до вызова PopLayer.

void PushLayer(
    const D2D1_LAYER_PARAMETERS& layerParameters,
    CD2DLayer& layer);

Параметры

layerParameters
Границы содержимого, геометрическая маска, непрозрачность, маска непрозрачности и параметры защиты от слоя.

Слой
Слой, получающий последующие операции рисования.

CRenderTarget::RestoreDrawingState

Задает состояние рисования целевого объекта отрисовки для указанного объекта ID2D1DrawingStateBlock.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Параметры

drawingStateBlock
Новое состояние рисования целевого объекта отрисовки.

CRenderTarget::SaveDrawingState

Сохраняет текущее состояние рисования в указанном id2D1DrawingStateBlock.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Параметры

drawingStateBlock
При возврате этого метода содержит текущее состояние рисования целевого объекта отрисовки. Этот параметр необходимо инициализировать перед передачей в метод.

CRenderTarget::SetAntialiasMode

Задает режим защиты целевого объекта отрисовки. Режим защиты применяется ко всем последующим операциям рисования, за исключением операций рисования текста и глифа.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Параметры

antialiasMode
Режим защиты для будущих операций рисования.

CRenderTarget::SetDpi

Задает точки на дюйм (DPI) целевого объекта отрисовки.

void SetDpi(const CD2DSizeF& sizeDPI);

Параметры

sizeDPI
Значение больше или равно нулю, указывающее горизонтальное или вертикальное значение целевого объекта отрисовки.

CRenderTarget::SetTags

Указывает метку для последующих операций рисования.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Параметры

tag1
Метка, применяемая к последующим операциям рисования.

tag2
Метка, применяемая к последующим операциям рисования.

CRenderTarget::SetTextAntialiasMode

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

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Параметры

textAntialiasMode
Режим защиты, используемый для последующих операций рисования текста и глифа.

CRenderTarget::SetTextRenderingParams

Указывает параметры отрисовки текста, применяемые ко всем последующим операциям рисования текста и глифа.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Параметры

textRenderingParams
Параметры отрисовки текста, применяемые ко всем последующим операциям рисования текста и глифа; Значение NULL для очистки текущих параметров отрисовки текста.

CRenderTarget::SetTransform

Применяет указанное преобразование к целевому объекту отрисовки, заменив существующее преобразование. Все последующие операции рисования происходят в преобразованном пространстве.

void SetTransform(const D2D1_MATRIX_3X2_F* transform);
void SetTransform(const D2D1_MATRIX_3X2_F& transform);

Параметры

transform
Преобразование, применяемое к целевому объекту отрисовки.

CRenderTarget::VerifyResource

Проверяет допустимость объекта CD2DResource; создает объект, если он еще не существует.

BOOL VerifyResource(CD2DResource* pResource);

Параметры

pResource
Указатель на объект CD2DResource.

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

ЗНАЧЕНИЕ TRUE — это объект, если допустимый; в противном случае ЗНАЧЕНИЕ FALSE.

См. также

Классы