CRenderTarget 클래스

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 메서드에 의해 지정됨).

options
텍스트를 픽셀 경계에 맞추기 위한지 여부와 텍스트를 레이아웃 사각형으로 잘릴지 여부를 나타내는 값입니다. 기본값은 D2D1_DRAW_TEXT_OPTIONS_NONE, 텍스트가 픽셀 경계로 스냅되어야 하며 레이아웃 사각형으로 잘려서는 안 됨을 나타냅니다.

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

매개 변수

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

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

매개 변수

변환
렌더링 대상에 적용할 변환입니다.

CRenderTarget::VerifyResource

CD2DResource 개체의 유효성을 확인합니다. 는 개체가 아직 없는 경우 개체를 만듭니다.

BOOL VerifyResource(CD2DResource* pResource);

매개 변수

pResource
CD2DResource 개체에 대한 포인터입니다.

Return Value

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

참고 항목

클래스