CRenderTarget 클래스

아티클
10/12/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 estroy	하나 이상의 리소스를 삭제합니다.
CRenderTarget::D etach	개체에서 렌더링 대상 인터페이스 분리
CRenderTarget::D awBitmap	지정된 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 개체의 유효성을 확인합니다. 는 개체가 아직 없는 경우 개체를 만듭니다.

Public 연산자

이름	설명
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

Return Value

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와 호환되어야 하는지 여부를 지정하는 값입니다.

Return Value

메서드가 성공하면 TRUE를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.

CRenderTarget::CRenderTarget

CRenderTarget 개체를 생성합니다.

CRenderTarget();

CRenderTarget::D estroy

하나 이상의 리소스를 삭제합니다.

BOOL Destroy(BOOL bDeleteResources = TRUE);

매개 변수

bDeleteResources
bDeleteResources가 TRUE이면 m_lstResources 있는 모든 리소스가 자동으로 제거됩니다.

Return Value

메서드가 성공하면 TRUE를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.

CRenderTarget::D etach

개체에서 렌더링 대상 인터페이스 분리

ID2D1RenderTarget* Detach ();

Return Value

분리된 렌더링 대상 인터페이스에 대한 포인터입니다.

CRenderTarget::D awBitmap

지정된 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
비트맵이 그려지는 영역의 크기 및 위치(렌더링 대상의 좌표 공간에서 디바이스 독립적 픽셀)입니다. 사각형이 잘 정렬되지 않은 경우 아무것도 그려지지 않지만 렌더링 대상은 오류 상태로 들어가지 않습니다.

fOpacity
비트맵에 적용할 불투명도 값을 지정하는 0.0f에서 1.0f 사이의 값입니다. 이 값은 비트맵 내용의 알파 값에 곱합니다.

interpolationMode
비트맵의 크기를 조정하거나 그리기 작업으로 회전하는 경우 사용할 보간 모드입니다.

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
지정된 문자 모양을 그리는 데 사용되는 브러시입니다.

measuringMode
문자 모양 메트릭이 서식이 지정될 때 텍스트를 측정하는 데 사용되는 방법을 나타내는 값입니다. 기본값은 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, 텍스트가 픽셀 경계로 스냅되어야 하며 레이아웃 사각형으로 잘려서는 안 됨을 나타냅니다.

measuringMode
문자 모양 메트릭이 서식이 지정될 때 텍스트를 측정하는 데 사용되는 방법을 나타내는 값입니다. 기본값은 DWRITE_MEASURING_MODE_NATURAL.

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();

Return Value

메서드가 성공하면 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 매개 변수)를 지정한 경우 브러시는 x 및 y 확장 모드가 D2D1_EXTEND_MODE_CLAMP 설정된 ID2D1BitmapBrush여야 합니다. 자세한 내용은 주의 섹션을 참조하세요.

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
destinationRectangle에 지정된 렌더링 대상의 영역을 그리는 데 사용되는 브러시입니다.

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;

Return Value

텍스트가 아닌 그리기 작업의 현재 앤티앨리어싱 모드입니다.

CRenderTarget::GetDpi

렌더링 대상의 DPI(인치당 점)를 반환합니다.

CD2DSizeF GetDpi() const;

Return Value

렌더링 대상의 DPI(인치당 점)입니다.

CRenderTarget::GetMaximumBitmapSize

렌더링 대상에서 지원하는 하나의 비트맵 차원의 최대 크기(픽셀)를 가져옵니다.

UINT32 GetMaximumBitmapSize() const;

Return Value

렌더링 대상에서 지원하는 비트맵 차원의 최대 크기(픽셀)입니다.

CRenderTarget::GetPixelFormat

렌더링 대상의 픽셀 형식 및 알파 모드를 검색합니다.

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Return Value

렌더링 대상의 픽셀 형식 및 알파 모드

CRenderTarget::GetPixelSize

렌더링 대상의 크기를 디바이스 픽셀 단위로 반환합니다.

CD2DSizeU GetPixelSize() const;

Return Value

디바이스 픽셀의 렌더링 대상 크기

CRenderTarget::GetRenderTarget

ID2D1RenderTarget 인터페이스를 반환합니다.

ID2D1RenderTarget* GetRenderTarget();

Return Value

ID2D1RenderTarget 인터페이스에 대한 포인터이거나, 개체가 아직 초기화되지 않은 경우 NULL입니다.

CRenderTarget::GetSize

디바이스 독립적 픽셀로 렌더링 대상의 크기를 반환합니다.

CD2DSizeF GetSize() const;

Return Value

디바이스 독립적 픽셀의 렌더링 대상의 현재 크기

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;

Return Value

텍스트 및 문자 모양 그리기 작업에 대한 현재 앤티앨리어싱 모드입니다.

CRenderTarget::GetTextRenderingParams

렌더링 대상의 현재 텍스트 렌더링 옵션을 검색합니다.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

매개 변수

textRenderingParams
이 메서드가 반환되면 textRenderingParams는 렌더링 대상의 현재 텍스트 렌더링 옵션에 대한 포인터의 주소를 지정합니다.

CRenderTarget::GetTransform

렌더링 대상의 현재 변환을 가져옵니다.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

매개 변수

transform
이 값이 반환되면 렌더링 대상의 현재 변환이 포함됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

CRenderTarget::IsSupported

렌더링 대상이 지정된 속성을 지원하는지 여부를 나타냅니다.

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

매개 변수

renderTargetProperties
테스트할 렌더링 대상 속성

Return Value

지정된 렌더링 대상 속성이 이 렌더링 대상에서 지원되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CRenderTarget::IsValid

리소스 유효성 검사

BOOL IsValid() const;

Return Value

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*();

Return Value

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
렌더링 대상의 horizontal/verticalDPI를 지정하는 0보다 크거나 같은 값입니다.

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 개체에 대한 포인터입니다.

Return Value

TRUE는 유효한 경우 개체입니다. 그렇지 않으면 FALSE입니다.

참고 항목

클래스

다음을 통해 공유

CRenderTarget 클래스

구문

멤버

공용 생성자

공용 메서드

보호된 메서드

Public 연산자

보호된 데이터 멤버

상속 계층 구조

요구 사항

CRenderTarget::~CRenderTarget

CRenderTarget::Attach

매개 변수

CRenderTarget::BeginDraw

CRenderTarget::Clear

매개 변수

CRenderTarget::COLORREF_TO_D2DCOLOR

매개 변수

Return Value

CRenderTarget::CreateCompatibleRenderTarget

매개 변수

Return Value

CRenderTarget::CRenderTarget

CRenderTarget::D estroy

매개 변수

Return Value

CRenderTarget::D etach

Return Value

CRenderTarget::D awBitmap

매개 변수

CRenderTarget::D rawEllipse

매개 변수

CRenderTarget::D rawGeometry

매개 변수

CRenderTarget::D rawGlyphRun

매개 변수

CRenderTarget::D rawLine

매개 변수

CRenderTarget::D rawRectangle

매개 변수

CRenderTarget::D rawRoundedRectangle

매개 변수

CRenderTarget::D rawText

매개 변수

CRenderTarget::D rawTextLayout

매개 변수

CRenderTarget::EndDraw

Return Value

CRenderTarget::FillEllipse

매개 변수

CRenderTarget::FillGeometry

매개 변수

CRenderTarget::FillMesh

매개 변수

CRenderTarget::FillOpacityMask

매개 변수

CRenderTarget::FillRectangle

매개 변수

CRenderTarget::FillRoundedRectangle

매개 변수

CRenderTarget::Flush

매개 변수

CRenderTarget::GetAntialiasMode

Return Value

CRenderTarget::GetDpi

Return Value

CRenderTarget::GetMaximumBitmapSize

Return Value

CRenderTarget::GetPixelFormat

Return Value

CRenderTarget::GetPixelSize

Return Value

CRenderTarget::GetRenderTarget

Return Value

CRenderTarget::GetSize

Return Value

CRenderTarget::GetTags

매개 변수

CRenderTarget::GetTextAntialiasMode