Sdílet prostřednictvím

CRenderTarget – třída

  • Článek

Obálka pro ID2D1RenderTarget.

Syntaxe

class CRenderTarget : public CObject;

Členové

Veřejné konstruktory

Název Popis
CRenderTarget::CRenderTarget Vytvoří CRenderTarget objektu.
CRenderTarget::~CRenderTarget Destruktor. Volá se při zničení cílového objektu vykreslení.

Veřejné metody

Název Popis
CRenderTarget::Attach Připojí existující cílové rozhraní vykreslení k objektu.
CRenderTarget::BeginDraw Zahájí kreslení na tento cíl vykreslení.
CRenderTarget::Clear Vymaže oblast výkresu na zadanou barvu.
CRenderTarget::COLORREF_TO_D2DCOLOR Převede barvu GDI a alfa hodnoty na objekt D2D1_COLOR_F.
CRenderTarget::CreateCompatibleRenderTarget Vytvoří nový cíl vykreslení rastru pro použití při mezilehlém výkresu mimo obrazovku, který je kompatibilní s aktuálním cílem vykreslení .
CRenderTarget::D estroy Odstraní jeden nebo více prostředků.
CRenderTarget::D etach Odpojení cílového rozhraní vykreslení z objektu
CRenderTarget::D rawBitmap Nakreslí formátovaný text popsaný zadaným objektem IDWriteTextLayout.
CRenderTarget::D rawEllipse Nakreslí obrys zadaného elipsy pomocí zadaného stylu tahu.
CRenderTarget::D rawGeometry Nakreslí obrys zadané geometrie pomocí zadaného stylu tahu.
CRenderTarget::D rawGlyphRun Nakreslí zadané glyfy.
CRenderTarget::D rawLine Nakreslí čáru mezi zadanými body pomocí zadaného stylu tahu.
CRenderTarget::D rawRectangle Nakreslí obrys obdélníku se zadanými rozměry a stylem tahů.
CRenderTarget::D rawRoundedRectangle Nakreslí obrys zadaného zaobleného obdélníku pomocí zadaného stylu tahu.
CRenderTarget::D rawText Nakreslí zadaný text pomocí informací o formátu poskytnuté IDWriteTextFormat objektu.
CRenderTarget::D rawTextLayout Nakreslí formátovaný text popsaný zadaným objektem IDWriteTextLayout.
CRenderTarget::EndDraw Ukončí operace kreslení v cíli vykreslení a označuje aktuální stav chyby a přidružené značky.
CRenderTarget::FillEllipse Vykreslí vnitřní část zadané elipsy.
CRenderTarget::FillGeometry Vykreslí interiér zadané geometrie.
CRenderTarget::FillMesh Vykreslí vnitřní část zadané sítě.
CRenderTarget::FillOpacityMask Použije masku neprůhlednosti popsanou zadanou bitmapou na štětec a použije tento štětec k vykreslení oblasti cíle vykreslení.
CRenderTarget::FillRectangle Vykreslí interiér zadaného obdélníku.
CRenderTarget::FillRoundedRectangle Vykreslí interiér zadaného zaobleného obdélníku.
CRenderTarget::Flush Spustí všechny čekající příkazy výkresu.
CRenderTarget::GetAntialiasMode Načte aktuální režim antialiasingu pro netextové operace kreslení.
CRenderTarget::GetDpi Vrátí tečky cíle vykreslení na palec (DPI).
CRenderTarget::GetMaximumBitmapSize Získá maximální velikost v jednotkách závislých na zařízeních (pixely) libovolného rastrového obrázku podporovaného cílem vykreslení.
CRenderTarget::GetPixelFormat Načte formát pixelů a alfa režimu cíle vykreslení.
CRenderTarget::GetPixelSize Vrátí velikost cíle vykreslení v pixelech zařízení.
CRenderTarget::GetRenderTarget Vrátí rozhraní ID2D1RenderTarget.
CRenderTarget::GetSize Vrátí velikost cíle vykreslení v pixelech nezávislých na zařízení.
CRenderTarget::GetTags Získá popisek pro následné operace kreslení.
CRenderTarget::GetTextAntialiasMode Získá aktuální antialiasing režim pro text a glyph kreslení operací.
CRenderTarget::GetTextRenderingParams Načte aktuální možnosti vykreslování textu cíle vykreslení.
CRenderTarget::GetTransform Použije zadanou transformaci na cíl vykreslení a nahradí stávající transformaci. Všechny následné operace kreslení probíhají v transformované oblasti.
CRenderTarget::IsSupported Určuje, zda cíl vykreslení podporuje zadané vlastnosti.
CRenderTarget::IsValid Kontroluje platnost prostředku.
CRenderTarget::P opAxisAlignedClip Odebere poslední klip zarovnaný osou z cíle vykreslení. Po zavolání této metody se klip už nepoužije na následné operace kreslení.
CRenderTarget::P opLayer Zastaví přesměrování operací kreslení na vrstvu určenou posledním voláním PushLayer.
CRenderTarget::P ushAxisAlignedClip Odebere poslední klip zarovnaný osou z cíle vykreslení. Po zavolání této metody se klip už nepoužije na následné operace kreslení.
CRenderTarget::P ushLayer Přidá zadanou vrstvu do cíle vykreslení tak, aby přijímala všechny následné operace kreslení, dokud se nevolá PopLayer.
CRenderTarget::RestoreDrawingState Nastaví stav výkresu cíle vykreslení na zadaný identifikátor ID2D1DrawingStateBlock.
CRenderTarget::SaveDrawingState Uloží aktuální stav výkresu do zadaného ID2D1DrawingStateBlock.
CRenderTarget::SetAntialiasMode Nastaví antialiasingový režim cíle vykreslení. Režim antialiasing platí pro všechny následné operace kreslení, s výjimkou operací kreslení textu a glyf.
CRenderTarget::SetDpi Nastaví tečky na palec (DPI) cíle vykreslení.
CRenderTarget::SetTags Určuje popisek pro následné operace kreslení.
CRenderTarget::SetTextAntialiasMode Určuje režim antialiasingu, který se má použít pro následné operace kreslení textu a glyph.
CRenderTarget::SetTextRenderingParams Určuje možnosti vykreslování textu, které se použijí pro všechny následné operace kreslení textu a glyfů.
CRenderTarget::SetTransform Přetíženo. Použije zadanou transformaci na cíl vykreslení a nahradí stávající transformaci. Všechny následné operace kreslení probíhají v transformované oblasti.

Chráněné metody

Název Popis
CRenderTarget::VerifyResource Ověřuje platnost objektu CD2DResource; vytvoří objekt, pokud ještě neexistuje.

Veřejné operátory

Název Popis
CRenderTarget::operator ID2D1RenderTarget* Vrátí rozhraní ID2D1RenderTarget.

Chráněné datové členy

Název Popis
CRenderTarget::m_lstResources Seznam ukazatelů na objekty CD2DResource.
CRenderTarget::m_pRenderTarget Ukazatel na id2D1RenderTarget objektu.
CRenderTarget::m_pTextFormatDefault Ukazatel na OBJEKT CD2DTextFormat, který obsahuje výchozí textový formát.

Hierarchie dědičnosti

Objekt CObject

CRenderTarget

Požadavky

Hlavička: afxrendertarget.h

CRenderTarget::~CRenderTarget

Destruktor. Volá se při zničení cílového objektu vykreslení.

virtual ~CRenderTarget();

CRenderTarget::Attach

Připojí existující cílové rozhraní vykreslení k objektu.

void Attach(ID2D1RenderTarget* pRenderTarget);

Parametry

pRenderTarget
Existující cílové rozhraní vykreslení Nemůže mít hodnotu NULL.

CRenderTarget::BeginDraw

Zahájí kreslení na tento cíl vykreslení.

void BeginDraw();

CRenderTarget::Clear

Vymaže oblast výkresu na zadanou barvu.

void Clear(D2D1_COLOR_F color);

Parametry

barva
Barva, na kterou je oblast výkresu vymazána.

CRenderTarget::COLORREF_TO_D2DCOLOR

Převede barvu GDI a alfa hodnoty na objekt D2D1_COLOR_F.

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

Parametry

barva
Hodnota RGB.

nAlpha

Návratová hodnota

D2D1_COLOR_F hodnotu.

CRenderTarget::CreateCompatibleRenderTarget

Vytvoří nový cíl vykreslení rastru pro použití při mezilehlém výkresu mimo obrazovku, který je kompatibilní s aktuálním cílem vykreslení .

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

Parametry

bitmapTarget
Pokud tato metoda vrátí, obsahuje adresu ukazatele na nový rastrový vykreslení cíl. Tento parametr se předává neinicializovaný.

sizeDesired
Požadovaná velikost nového cíle vykreslení v pixelech nezávislých na zařízení, pokud by se měla lišit od původního cíle vykreslení, nebo null. Další informace najdete v části Poznámky.

sizePixelDesired
Požadovaná velikost nového cíle vykreslení v pixelech, pokud by se měla lišit od původního cíle vykreslení nebo NULL. Další informace najdete v části Poznámky.

desiredFormat
Požadovaný formát pixelů a alfa režimu nového cíle vykreslení nebo NULL. Pokud je formát pixelu nastavený na DXGI_FORMAT_UNKNOWN nebo pokud má tento parametr hodnotu null, použije nový cíl vykreslení stejný formát pixelů jako původní cíl vykreslení. Pokud je režim alfa D2D1_ALPHA_MODE_UNKNOWN nebo má tento parametr hodnotu NULL, alfa režim nového cíle vykreslení se ve výchozím nastavení D2D1_ALPHA_MODE_PREMULTIPLIED. Informace o podporovaných formátech pixelů naleznete v tématu Podporované formáty pixelů a režimy alfa.

volby
Hodnota, která určuje, zda nový cíl vykreslení musí být kompatibilní s GDI.

Návratová hodnota

Pokud je metoda úspěšná, vrátí hodnotu TRUE. V opačném případě vrátí hodnotu FALSE.

CRenderTarget::CRenderTarget

Vytvoří CRenderTarget objektu.

CRenderTarget();

CRenderTarget::D estroy

Odstraní jeden nebo více prostředků.

BOOL Destroy(BOOL bDeleteResources = TRUE);

Parametry

bDeleteResources
Pokud je hodnota bDeleteResources TRUE, všechny prostředky umístěné v m_lstResources budou automaticky zničeny.

Návratová hodnota

Pokud je metoda úspěšná, vrátí hodnotu TRUE. V opačném případě vrátí hodnotu FALSE.

CRenderTarget::D etach

Odpojení cílového rozhraní vykreslení z objektu

ID2D1RenderTarget* Detach ();

Návratová hodnota

Ukazatel na odpojení cílového rozhraní vykreslení

CRenderTarget::D rawBitmap

Nakreslí formátovaný text popsaný zadaným objektem 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);

Parametry

pBitmap
Rastrový obrázek, který se má vykreslit.

rectDest
Velikost a umístění v pixelech nezávislých na zařízení v souřadnicovém prostoru cíle vykreslení v oblasti, do které je rastrový obrázek nakreslen. Pokud obdélník není správně uspořádaný, nic se nevykreslí, ale cíl vykreslení nezadá chybový stav.

fOpacity
Hodnota mezi 0,0f a 1,0f včetně, která určuje hodnotu neprůhlednosti, která se má použít na rastrový obrázek; tato hodnota se vynásobí s alfa hodnotami obsahu rastrového obrázku.

interpolationMode
Režim interpolace, který se použije, pokud je rastrový obrázek škálován nebo otočen operací kreslení.

pRectSrc
Velikost a umístění v pixelech nezávislých na zařízení v souřadnicovém prostoru rastrového obrázku v oblasti, která se má nakreslit.

CRenderTarget::D rawEllipse

Nakreslí obrys zadaného elipsy pomocí zadaného stylu tahu.

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

Parametry

elipsa
Pozice a poloměr tří teček pro kreslení v pixelech nezávislých na zařízení.

pBrush
Štětec použitý k malování obrysu tří teček.

fStrokeWidth
Tloušťka tří teček. Tah je zacentrován na obrysu tří teček.

strokeStyle
Styl tahu, který se má použít u obrysu tří teček, nebo null pro vykreslení plného tahu.

CRenderTarget::D rawGeometry

Nakreslí obrys zadané geometrie pomocí zadaného stylu tahu.

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

Parametry

pGeometrie
Geometrie, která se má nakreslit.

pBrush
Štětec použitý k vykreslení tahu geometrie.

fStrokeWidth
Tloušťka tahu geometrie. Tah je na střed na obrysu geometrie.

strokeStyle
Styl tahu, který se má použít u obrysu geometrie, nebo null pro vykreslení plného tahu.

CRenderTarget::D rawGlyphRun

Nakreslí zadané glyfy.

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

Parametry

ptBaseLineOrigin
Původ v pixelech nezávislých na zařízeních podle směrného plánu glyfů.

glyphRun
Glyfy, které se mají vykreslit.

pForegroundBrush
Štětec použitý k malování zadaných glyfů.

měřeníMode
Hodnota, která označuje, jak se metriky glyf používají k měření textu při formátování. Výchozí hodnota je DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawLine

Nakreslí čáru mezi zadanými body pomocí zadaného stylu tahu.

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

Parametry

ptFrom
Počáteční bod čáry v pixelech nezávislých na zařízení.

ptTo
Koncový bod čáry v pixelech nezávislých na zařízení.

pBrush
Štětec použitý k malování tahu čáry.

fStrokeWidth
Hodnota větší nebo rovna 0,0f, která určuje šířku tahu. Pokud tento parametr není zadaný, výchozí hodnota je 1.0f. Tah je zarovnaný na čáru.

strokeStyle
Styl tahu, který chcete malovat, nebo NULL k vykreslení plné čáry.

CRenderTarget::D rawRectangle

Nakreslí obrys obdélníku se zadanými rozměry a stylem tahů.

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

Parametry

obdélník
Rozměry obdélníku, které se mají nakreslit, v pixelech nezávislých na zařízení

pBrush
Štětec použitý k malování tahu obdélníku

fStrokeWidth
Hodnota větší nebo rovna 0,0f, která určuje šířku tahu obdélníku. Tah je na střed na obrysu obdélníku.

strokeStyle
Styl tahu, který chcete malovat, nebo NULL k vykreslení plného tahu.

CRenderTarget::D rawRoundedRectangle

Nakreslí obrys zadaného zaobleného obdélníku pomocí zadaného stylu tahu.

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

Parametry

rectRounded
Rozměry zaobleného obdélníku, které se mají kreslit, v pixelech nezávislých na zařízení.

pBrush
Štětec použitý k malování obrysu zaobleného obdélníku.

fStrokeWidth
Šířka zaobleného obdélníku. Tah je na střed na obrysu zaobleného obdélníku. Výchozí hodnota je 1,0f.

strokeStyle
Styl zaobleného obdélníku nebo NULL pro vykreslení plného tahu. Výchozí hodnota je NULL.

CRenderTarget::D rawText

Nakreslí zadaný text pomocí informací o formátu poskytnuté IDWriteTextFormat objektu.

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

Parametry

strText
Ukazatel na pole znaků Unicode, které se mají nakreslit.

obdélník
Velikost a umístění oblasti, ve které je text nakreslený.

pForegroundBrush
Štětec použitý k malování textu.

TextFormat
Objekt, který popisuje formátování podrobností textu, které se mají nakreslit, například písmo, velikost písma a směr toku.

volby
Hodnota, která označuje, jestli má být text přichycený k ohraničení pixelů a zda má být text oříznut na obdélník rozložení. Výchozí hodnota je D2D1_DRAW_TEXT_OPTIONS_NONE, což označuje, že text by měl být přichycený k ohraničení pixelů a neměl by být oříznut na obdélník rozložení.

měřeníMode
Hodnota, která označuje, jak se metriky glyf používají k měření textu při formátování. Výchozí hodnota je DWRITE_MEASURING_MODE_NATURAL.

CRenderTarget::D rawTextLayout

Nakreslí formátovaný text popsaný zadaným objektem IDWriteTextLayout.

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

Parametry

ptOrigin
Bod popsaný v pixelech nezávislých na zařízení, ve kterém je nakreslený levý horní roh textu popsaného textemLayout.

TextLayout
Formátovaný text, který chcete nakreslit. Všechny efekty výkresu, které nedědí z ID2D1Resource, se ignorují. Pokud existují efekty kreslení, které dědí z ID2D1Resource, které nejsou štětce, tato metoda selže a cíl vykreslení se umístí do chybového stavu.

pBrushForeground
Štětec použitý k malování libovolného textu v objektu textLayout, který k němu ještě nemá přidružený štětec jako kreslicí efekt (určený metodou IDWriteTextLayout::SetDrawingEffect).

volby
Hodnota, která označuje, jestli má být text přichycený k ohraničení pixelů a zda má být text oříznut na obdélník rozložení. Výchozí hodnota je D2D1_DRAW_TEXT_OPTIONS_NONE, což označuje, že text by měl být přichycený k ohraničení pixelů a neměl by být oříznut na obdélník rozložení.

CRenderTarget::EndDraw

Ukončí operace kreslení v cíli vykreslení a označuje aktuální stav chyby a přidružené značky.

HRESULT EndDraw();

Návratová hodnota

Pokud je metoda úspěšná, vrátí S_OK. V opačném případě vrátí kód chyby HRESULT.

CRenderTarget::FillEllipse

Vykreslí vnitřní část zadané elipsy.

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

Parametry

elipsa
Pozice a poloměr v pixelech nezávislých na zařízeních se třemi tečkami, které se mají nakreslit.

pBrush
Štětec použitý k malování interiéru tří teček.

CRenderTarget::FillGeometry

Vykreslí interiér zadané geometrie.

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

Parametry

pGeometrie
Geometrie, která se má nakreslit.

pBrush
Štětec použitý k malování interiéru geometrie.

pOpacityBrush
Neprůhledná maska, která se použije na geometrii; NULL pro žádnou neprůhlednou masku. Pokud je zadána neprůhledná maska (parametr opacityBrush), musí být štětec ID2D1BitmapBrush, který má režimy rozšíření x a y nastavené na D2D1_EXTEND_MODE_CLAMP. Další informace najdete v části Poznámky.

CRenderTarget::FillMesh

Vykreslí vnitřní část zadané sítě.

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

Parametry

pMesh
Síť, která se má malovat.

pBrush
Štětec použitý k malování mřížky.

CRenderTarget::FillOpacityMask

Použije masku neprůhlednosti popsanou zadanou bitmapou na štětec a použije tento štětec k vykreslení oblasti cíle vykreslení.

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

Parametry

pOpacityMask
Pozice a poloměr v pixelech nezávislých na zařízeních se třemi tečkami, které se mají nakreslit.

pBrush
Štětec použitý k vykreslení oblasti cíle vykreslení určeného destinationRectangle.

obsah
Typ obsahu, který maska neprůhlednosti obsahuje. Hodnota se používá k určení barevného prostoru, ve kterém je maska neprůhlednosti kombinována.

rectDest
Oblast cíle vykreslení, která se má vykreslit, v pixelech nezávislých na zařízeních.

rectSrc
Oblast rastrového obrázku, která se má použít jako neprůhledná maska v pixelech nezávislých na zařízení.

CRenderTarget::FillRectangle

Vykreslí interiér zadaného obdélníku.

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

Parametry

obdélník
Rozměr obdélníku, který se má malovat, v pixelech nezávislých na zařízení.

pBrush
Štětec použitý k malování interiéru obdélníku.

CRenderTarget::FillRoundedRectangle

Vykreslí interiér zadaného zaobleného obdélníku.

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

Parametry

rectRounded
Rozměry zaobleného obdélníku, které se mají malovat, v nezávislých pixelech zařízení.

pBrush
Štětec použitý k malování interiéru zaobleného obdélníku.

CRenderTarget::Flush

Spustí všechny čekající příkazy výkresu.

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

Parametry

tag1
Obsahuje značku pro operace kreslení, které způsobily chyby nebo 0, pokud nedošlo k žádným chybám. Tento parametr se předává neinicializovaný.

tag2
Obsahuje značku pro operace kreslení, které způsobily chyby nebo 0, pokud nedošlo k žádným chybám. Tento parametr se předává neinicializovaný.

CRenderTarget::GetAntialiasMode

Načte aktuální režim antialiasingu pro netextové operace kreslení.

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

Návratová hodnota

Aktuální antialiasingový režim pro netextové operace kreslení.

CRenderTarget::GetDpi

Vrátí tečky cíle vykreslení na palec (DPI).

CD2DSizeF GetDpi() const;

Návratová hodnota

Tečky cíle vykreslení na palec (DPI).

CRenderTarget::GetMaximumBitmapSize

Získá maximální velikost v jednotkách závislých na zařízeních (pixely) libovolného rastrového obrázku podporovaného cílem vykreslení.

UINT32 GetMaximumBitmapSize() const;

Návratová hodnota

Maximální velikost v pixelech libovolného rastrového obrázku podporovaného cílem vykreslení

CRenderTarget::GetPixelFormat

Načte formát pixelů a alfa režimu cíle vykreslení.

D2D1_PIXEL_FORMAT GetPixelFormat() const;

Návratová hodnota

Formát pixelu a alfa režimu cíle vykreslení

CRenderTarget::GetPixelSize

Vrátí velikost cíle vykreslení v pixelech zařízení.

CD2DSizeU GetPixelSize() const;

Návratová hodnota

Velikost cíle vykreslení v pixelech zařízení

CRenderTarget::GetRenderTarget

Vrátí rozhraní ID2D1RenderTarget.

ID2D1RenderTarget* GetRenderTarget();

Návratová hodnota

Ukazatel na rozhraní ID2D1RenderTarget nebo NULL, pokud objekt ještě není inicializován.

CRenderTarget::GetSize

Vrátí velikost cíle vykreslení v pixelech nezávislých na zařízení.

CD2DSizeF GetSize() const;

Návratová hodnota

Aktuální velikost cíle vykreslení v pixelech nezávislých na zařízení

CRenderTarget::GetTags

Získá popisek pro následné operace kreslení.

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

Parametry

tag1
Obsahuje první popisek pro následné operace kreslení. Tento parametr se předává neinicializovaný. Pokud je zadána hodnota NULL, pro tento parametr se nenačte žádná hodnota.

tag2
Obsahuje druhý popisek pro následné operace kreslení. Tento parametr se předává neinicializovaný. Pokud je zadána hodnota NULL, pro tento parametr se nenačte žádná hodnota.

CRenderTarget::GetTextAntialiasMode

Získá aktuální antialiasing režim pro text a glyph kreslení operací.

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

Návratová hodnota

Aktuální režim antialiasingu pro operace kreslení textu a glyph.

CRenderTarget::GetTextRenderingParams

Načte aktuální možnosti vykreslování textu cíle vykreslení.

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

Parametry

textRenderingParams
Když tato metoda vrátí, textRenderingParamscontains adresa ukazatele na aktuální možnosti vykreslení textu cíle vykreslení.

CRenderTarget::GetTransform

Získá aktuální transformaci cíle vykreslení.

void GetTransform(D2D1_MATRIX_3X2_F* transform);

Parametry

transformovat
Pokud se tato funkce vrátí, obsahuje aktuální transformaci cíle vykreslení. Tento parametr se předává neinicializovaný.

CRenderTarget::IsSupported

Určuje, zda cíl vykreslení podporuje zadané vlastnosti.

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

Parametry

renderTargetProperties
Vykreslení cílových vlastností k otestování

Návratová hodnota

TRUE, pokud jsou zadané vlastnosti cíle vykreslení podporovány tímto cílem vykreslení; jinak, NEPRAVDA

CRenderTarget::IsValid

Kontroluje platnost prostředku.

BOOL IsValid() const;

Návratová hodnota

TRUE, pokud je prostředek platný; jinak NEPRAVDA.

CRenderTarget::m_lstResources

Seznam ukazatelů na objekty CD2DResource.

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

Ukazatel na id2D1RenderTarget objektu.

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

Ukazatel na OBJEKT CD2DTextFormat, který obsahuje výchozí textový formát.

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

Vrátí rozhraní ID2D1RenderTarget.

operator ID2D1RenderTarget*();

Návratová hodnota

Ukazatel na rozhraní ID2D1RenderTarget nebo NULL, pokud objekt ještě není inicializován.

CRenderTarget::P opAxisAlignedClip

Odebere poslední klip zarovnaný osou z cíle vykreslení. Po zavolání této metody se klip už nepoužije na následné operace kreslení.

void PopAxisAlignedClip();

CRenderTarget::P opLayer

Zastaví přesměrování operací kreslení na vrstvu určenou posledním voláním PushLayer.

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

Odebere poslední klip zarovnaný osou z cíle vykreslení. Po zavolání této metody se klip už nepoužije na následné operace kreslení.

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

Parametry

rectClip
Velikost a umístění oblasti výřezu v pixelech nezávislých na zařízení.

režim
Antialiasing režim, který se používá k kreslení okrajů klip obdélníků, které mají subpixel hranice, a prolnutí klipu s obsahem scény. Blending se provádí jednou, když je volána Metoda PopAxisAlignedClip, a nevztahuje se na každou primitivu v rámci vrstvy.

CRenderTarget::P ushLayer

Přidá zadanou vrstvu do cíle vykreslení tak, aby přijímala všechny následné operace kreslení, dokud se nevolá PopLayer.

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

Parametry

layerParameters
Hranice obsahu, geometrická maska, neprůhlednost, maska neprůhlednosti a možnosti antialiasingu pro vrstvu.

vrstva
Vrstva, která přijímá následné operace kreslení.

CRenderTarget::RestoreDrawingState

Nastaví stav výkresu cíle vykreslení na zadaný identifikátor ID2D1DrawingStateBlock.

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

Parametry

drawingStateBlock
Nový stav výkresu cíle vykreslení.

CRenderTarget::SaveDrawingState

Uloží aktuální stav výkresu do zadaného ID2D1DrawingStateBlock.

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

Parametry

drawingStateBlock
Pokud tato metoda vrátí, obsahuje aktuální stav výkresu cíle vykreslení. Tento parametr musí být inicializován před jeho předáním metodě.

CRenderTarget::SetAntialiasMode

Nastaví antialiasingový režim cíle vykreslení. Režim antialiasing platí pro všechny následné operace kreslení, s výjimkou operací kreslení textu a glyf.

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

Parametry

antialiasMode
Antialiasing režim pro budoucí operace kreslení.

CRenderTarget::SetDpi

Nastaví tečky na palec (DPI) cíle vykreslení.

void SetDpi(const CD2DSizeF& sizeDPI);

Parametry

sizeDPI
Hodnota větší nebo rovna nule, která určuje vodorovný nebo svislý ukazatel výkonu cíle vykreslení.

CRenderTarget::SetTags

Určuje popisek pro následné operace kreslení.

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

Parametry

tag1
Popisek, který se použije pro následné operace kreslení.

tag2
Popisek, který se použije pro následné operace kreslení.

CRenderTarget::SetTextAntialiasMode

Určuje režim antialiasingu, který se má použít pro následné operace kreslení textu a glyph.

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

Parametry

textAntialiasMode
Režim antialiasingu, který se použije pro následné operace kreslení textu a piktogramu.

CRenderTarget::SetTextRenderingParams

Určuje možnosti vykreslování textu, které se použijí pro všechny následné operace kreslení textu a glyfů.

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

Parametry

textRenderingParams
Možnosti vykreslování textu, které se použijí pro všechny následné operace kreslení textu a glyf; Null pro vymazání aktuálních možností vykreslování textu.

CRenderTarget::SetTransform

Použije zadanou transformaci na cíl vykreslení a nahradí stávající transformaci. Všechny následné operace kreslení probíhají v transformované oblasti.

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

Parametry

transformovat
Transformace, která se použije na cíl vykreslení.

CRenderTarget::VerifyResource

Ověřuje platnost objektu CD2DResource; vytvoří objekt, pokud ještě neexistuje.

BOOL VerifyResource(CD2DResource* pResource);

Parametry

pResource
Ukazatel na objekt CD2DResource.

Návratová hodnota

PRAVDA je objekt, pokud je platný; jinak NEPRAVDA.

Viz také

Třídy