Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Een wrapper voor ID2D1RenderTarget.
Syntaxis
class CRenderTarget : public CObject;
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CRenderTarget::CRenderTarget | Maakt een CRenderTarget-object. |
| CRenderTarget::~CRenderTarget | De destructor. Aangeroepen wanneer een renderdoelobject wordt vernietigd. |
Openbare methoden
| Naam | Description |
|---|---|
| CRenderTarget::Attach | Bestaande renderdoelinterface koppelen aan het object |
| CRenderTarget::BeginDraw | Hiermee wordt een tekening gestart op dit renderdoel. |
| CRenderTarget::Clear | Hiermee wordt het tekengebied gewist naar de opgegeven kleur. |
| CRenderTarget::COLORREF_TO_D2DCOLOR | Converteert GDI-kleur- en alfawaarden naar het D2D1_COLOR_F-object. |
| CRenderTarget::CreateCompatibleRenderTarget | Hiermee maakt u een nieuw bitmapweergavedoel voor gebruik tijdens een tussenliggende offscreen-tekening die compatibel is met het huidige renderdoel. |
| CRenderTarget::D estroy | Hiermee verwijdert u een of meer resources |
| CRenderTarget::D etach | De doelinterface van het object loskoppelen |
| CRenderTarget::D rawBitmap | Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object. |
| CRenderTarget::D rawEllipse | Hiermee tekent u de omtrek van het opgegeven beletselteken met behulp van de opgegeven lijnstijl. |
| CRenderTarget::D rawGeometry | Hiermee tekent u de omtrek van de opgegeven geometrie met behulp van de opgegeven lijnstijl. |
| CRenderTarget::D rawGlyphRun | Hiermee tekent u de opgegeven glyphs. |
| CRenderTarget::D rawLine | Hiermee tekent u een lijn tussen de opgegeven punten met behulp van de opgegeven lijnstijl. |
| CRenderTarget::D rawRectangle | Hiermee tekent u het overzicht van een rechthoek met de opgegeven dimensies en lijnstijl. |
| CRenderTarget::D rawRoundedRectangle | Hiermee tekent u het overzicht van de opgegeven afgeronde rechthoek met behulp van de opgegeven lijnstijl. |
| CRenderTarget::D rawText | Hiermee tekent u de opgegeven tekst met behulp van de indelingsgegevens van een IDWriteTextFormat-object. |
| CRenderTarget::D rawTextLayout | Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object. |
| CRenderTarget::EndDraw | Hiermee worden tekenbewerkingen op het renderdoel beëindigd en wordt de huidige foutstatus en de bijbehorende tags aangegeven. |
| CRenderTarget::FillEllipse | Schildert het interieur van het opgegeven beletselteken. |
| CRenderTarget::FillGeometry | Schildert het interieur van de opgegeven geometrie. |
| CRenderTarget::FillMesh | Schildert het interieur van de opgegeven mesh. |
| CRenderTarget::FillOpacityMask | Past het dekkingsmasker dat wordt beschreven door de opgegeven bitmap toe op een borstel en gebruikt die borstel om een gebied van het renderdoel te schilderen. |
| CRenderTarget::FillRectangle | Schildert het interieur van de opgegeven rechthoek. |
| CRenderTarget::FillRoundedRectangle | Schildert het interieur van de opgegeven afgeronde rechthoek. |
| CRenderTarget::Flush | Hiermee worden alle tekenopdrachten uitgevoerd die in behandeling zijn. |
| CRenderTarget::GetAntialiasMode | Hiermee haalt u de huidige antialiasingmodus op voor niet-teksttekeningsbewerkingen. |
| CRenderTarget::GetDpi | Retourneert de dots per inch van het renderdoel (DPI) |
| CRenderTarget::GetMaximumBitmapSize | Hiermee haalt u de maximale grootte, in apparaatafhankelijke eenheden (pixels), op van een bitmapdimensie die wordt ondersteund door het renderdoel |
| CRenderTarget::Get PixelFormat | Haalt de pixelindeling en de alfamodus van het renderdoel op |
| CRenderTarget::Get PixelSize | Retourneert de grootte van het renderdoel in pixels van het apparaat |
| CRenderTarget::GetRenderTarget | Retourneert ID2D1RenderTarget-interface |
| CRenderTarget::GetSize | Retourneert de grootte van het renderdoel in apparaatonafhankelijke pixels |
| CRenderTarget::GetTags | Hiermee haalt u het label op voor volgende tekenbewerkingen. |
| CRenderTarget::GetTextAntialiasMode | Hiermee haalt u de huidige antialiasingmodus op voor tekst- en glyph-tekenbewerkingen. |
| CRenderTarget::GetTextRenderingParams | Hiermee haalt u de huidige opties voor tekstweergave van het renderdoel op. |
| CRenderTarget::GetTransform | Hiermee past u de opgegeven transformatie toe op het renderdoel en vervangt u de bestaande transformatie. Alle volgende tekenbewerkingen vinden plaats in de getransformeerde ruimte. |
| CRenderTarget::IsSupported | Geeft aan of het renderdoel de opgegeven eigenschappen ondersteunt |
| CRenderTarget::IsValid | Controleert de geldigheid van resources |
| CRenderTarget::P opAxisAlignedClip | Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen. |
| CRenderTarget::P opLayer | Stopt met het omleiden van tekenbewerkingen naar de laag die is opgegeven door de laatste PushLayer-aanroep. |
| CRenderTarget::P ushAxisAlignedClip | Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen. |
| CRenderTarget::P ushLayer | Hiermee voegt u de opgegeven laag toe aan het renderdoel, zodat alle volgende tekenbewerkingen worden ontvangen totdat PopLayer wordt aangeroepen. |
| CRenderTarget::RestoreDrawingState | Hiermee stelt u de tekenstatus van het renderdoel in op die van de opgegeven ID2D1DrawingStateBlock. |
| CRenderTarget::SaveDrawingState | Hiermee wordt de huidige tekenstatus opgeslagen in het opgegeven ID2D1DrawingStateBlock. |
| CRenderTarget::SetAntialiasMode | Hiermee stelt u de antialiasingmodus van het renderdoel in. De antialiasingmodus is van toepassing op alle volgende tekenbewerkingen, met uitzondering van tekst- en glyph-tekenbewerkingen. |
| CRenderTarget::SetDpi | Hiermee stelt u de dots per inch (DPI) van het renderdoel in. |
| CRenderTarget::SetTags | Hiermee geeft u een label op voor volgende tekenbewerkingen. |
| CRenderTarget::SetTextAntialiasMode | Hiermee geeft u de antialiasingmodus op die moet worden gebruikt voor volgende tekst- en glyph-tekenbewerkingen. |
| CRenderTarget::SetTextRenderingParams | Hiermee geeft u opties voor tekstweergave op die moeten worden toegepast op alle volgende tekst- en glyph-tekenbewerkingen. |
| CRenderTarget::SetTransform | Overbelast. Hiermee past u de opgegeven transformatie toe op het renderdoel en vervangt u de bestaande transformatie. Alle volgende tekenbewerkingen vinden plaats in de getransformeerde ruimte. |
Beveiligde methoden
| Naam | Description |
|---|---|
| CRenderTarget::VerifyResource | Controleert de geldigheid van het CD2DResource-object; maakt het object als het nog niet bestaat. |
Openbare operators
| Naam | Description |
|---|---|
| CRenderTarget::operator ID2D1RenderTarget* | Retourneert ID2D1RenderTarget-interface |
Beveiligde gegevensleden
| Naam | Description |
|---|---|
| CRenderTarget::m_lstResources | Een lijst met aanwijzers naar CD2DResource-objecten. |
| CRenderTarget::m_pRenderTarget | Een aanwijzer naar een ID2D1RenderTarget-object. |
| CRenderTarget::m_pTextFormatDefault | Een aanwijzer naar CD2DTextFormat-object dat een standaardtekstindeling bevat. |
Overnamehiërarchie
Requirements
Header: afxrendertarget.h
CRenderTarget::~CRenderTarget
De destructor. Aangeroepen wanneer een renderdoelobject wordt vernietigd.
virtual ~CRenderTarget();
CRenderTarget::Attach
Bestaande renderdoelinterface koppelen aan het object
void Attach(ID2D1RenderTarget* pRenderTarget);
Parameterwaarden
pRenderTarget
Bestaande renderdoelinterface. Kan niet NULL zijn
CRenderTarget::BeginDraw
Hiermee wordt een tekening gestart op dit renderdoel.
void BeginDraw();
CRenderTarget::Clear
Hiermee wordt het tekengebied gewist naar de opgegeven kleur.
void Clear(D2D1_COLOR_F color);
Parameterwaarden
kleur
De kleur waarop het tekengebied is gewist.
CRenderTarget::COLORREF_TO_D2DCOLOR
Converteert GDI-kleur- en alfawaarden naar het D2D1_COLOR_F-object.
static D2D1_COLOR_F COLORREF_TO_D2DCOLOR(
COLORREF color,
int nAlpha = 255);
Parameterwaarden
kleur
RGB-waarde.
nAlpha
Retourwaarde
D2D1_COLOR_F waarde.
CRenderTarget::CreateCompatibleRenderTarget
Hiermee maakt u een nieuw bitmapweergavedoel voor gebruik tijdens een tussenliggende offscreen-tekening die compatibel is met het huidige renderdoel.
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);
Parameterwaarden
bitmapTarget
Wanneer deze methode wordt geretourneerd, bevat het adres van een aanwijzer naar een nieuw bitmapweergavedoel. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
gewenste grootte
De gewenste grootte van het nieuwe renderdoel in apparaatonafhankelijke pixels als deze anders moet zijn dan het oorspronkelijke renderdoel, of NULL. Zie de sectie Opmerkingen voor meer informatie.
size PixelDesired
De gewenste grootte van het nieuwe renderdoel in pixels als dit anders moet zijn dan het oorspronkelijke renderdoel, of NULL. Zie de sectie Opmerkingen voor meer informatie.
desiredFormat
De gewenste pixelindeling en alfamodus van het nieuwe renderdoel of NULL. Als de pixelindeling is ingesteld op DXGI_FORMAT_UNKNOWN of als deze parameter null is, gebruikt het nieuwe renderdoel dezelfde pixelindeling als het oorspronkelijke renderdoel. Als de alfamodus is D2D1_ALPHA_MODE_UNKNOWN of deze parameter NULL is, wordt de alfamodus van het nieuwe renderdoel standaard ingesteld op D2D1_ALPHA_MODE_PREMULTIPLIED. Zie Ondersteunde pixelindelingen en alfamodi voor meer informatie over ondersteunde pixelindelingen.
Opties
Een waarde die aangeeft of het nieuwe renderdoel compatibel moet zijn met GDI.
Retourwaarde
Als de methode slaagt, wordt TRUE geretourneerd. Anders wordt FALSE geretourneerd.
CRenderTarget::CRenderTarget
Maakt een CRenderTarget-object.
CRenderTarget();
CRenderTarget::D estroy
Hiermee verwijdert u een of meer resources
BOOL Destroy(BOOL bDeleteResources = TRUE);
Parameterwaarden
bDeleteResources
Als bDeleteResources TRUE is, worden alle resources in m_lstResources automatisch vernietigd.
Retourwaarde
Als de methode slaagt, wordt TRUE geretourneerd. Anders wordt ONWAAR geretourneerd
CRenderTarget::D etach
De doelinterface van het object loskoppelen
ID2D1RenderTarget* Detach ();
Retourwaarde
Aanwijzer om de doelinterface te ontkoppelen.
CRenderTarget::D rawBitmap
Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object.
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);
Parameterwaarden
pBitmap
De bitmap die moet worden weergegeven.
rectDest
De grootte en positie, in apparaatonafhankelijke pixels in de coördinaatruimte van het renderdoel, van het gebied waarnaar de bitmap wordt getekend. Als de rechthoek niet goed is gerangschikt, wordt er niets getekend, maar het renderdoel voert geen foutstatus in.
fOpacity
Een waarde tussen 0,0f en 1,0f, inclusief, die een ondoorzichtigheidswaarde aangeeft die moet worden toegepast op de bitmap; deze waarde wordt vermenigvuldigd met de alfawaarden van de inhoud van de bitmap.
interpolationMode
De interpolatiemodus die moet worden gebruikt als de bitmap wordt geschaald of gedraaid door de tekenbewerking.
pRectSrc
De grootte en positie, in apparaatonafhankelijke pixels in de coördinaatruimte van de bitmap, van het gebied binnen de bitmap om te tekenen.
CRenderTarget::D rawEllipse
Hiermee tekent u de omtrek van het opgegeven beletselteken met behulp van de opgegeven lijnstijl.
void DrawEllipse(
const CD2DEllipse& ellipse,
CD2DBrush* pBrush,
FLOAT fStrokeWidth = 1.0,
ID2D1StrokeStyle* strokeStyle = NULL);
Parameterwaarden
Ellips
De positie en straal van het beletselteken om te tekenen, in apparaatonafhankelijke pixels.
pBrush
De kwast die wordt gebruikt om de omtrek van het beletselteken te schilderen.
fStrokeWidth
De dikte van de lijn van het beletselteken. De lijn is gecentreerd op het beletselteken.
strokeStyle
De stijl van de lijn die moet worden toegepast op de omtrek van het beletselteken of NULL om een ononderbroken lijn te schilderen.
CRenderTarget::D rawGeometry
Hiermee tekent u de omtrek van de opgegeven geometrie met behulp van de opgegeven lijnstijl.
void DrawGeometry(
CD2DGeometry* pGeometry,
CD2DBrush* pBrush,
FLOAT fStrokeWidth = 1.0,
ID2D1StrokeStyle* strokeStyle = NULL);
Parameterwaarden
pGeometry
De geometrie die moet worden getekend.
pBrush
De kwast die wordt gebruikt om de meetlijn van de geometrie te schilderen.
fStrokeWidth
De dikte van de geometriestreek. De lijn is gecentreerd op het omtrek van de geometrie.
strokeStyle
De stijl van de lijn die moet worden toegepast op het kader van de geometrie of NULL om een ononderbroken lijn te schilderen.
CRenderTarget::D rawGlyphRun
Hiermee tekent u de opgegeven glyphs.
void DrawGlyphRun(
const CD2DPointF& ptBaseLineOrigin,
const DWRITE_GLYPH_RUN& glyphRun,
CD2DBrush* pForegroundBrush,
DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);
Parameterwaarden
ptBaseLineOrigin
De oorsprong, in apparaatonafhankelijke pixels, van de basislijn van de glyphs.
glyphRun
De te renderen glyphs.
pForegroundBrush
De borstel die wordt gebruikt om de opgegeven glyphs te schilderen.
measuringMode
Een waarde die aangeeft hoe glyph-metrische gegevens worden gebruikt om tekst te meten wanneer deze is opgemaakt. De standaardwaarde is DWRITE_MEASURING_MODE_NATURAL.
CRenderTarget::D rawLine
Hiermee tekent u een lijn tussen de opgegeven punten met behulp van de opgegeven lijnstijl.
void DrawLine(
const CD2DPointF& ptFrom,
const CD2DPointF& ptTo,
CD2DBrush* pBrush,
FLOAT fStrokeWidth = 1.0,
ID2D1StrokeStyle* strokeStyle = NULL);
Parameterwaarden
ptFrom
Het beginpunt van de lijn, in apparaatonafhankelijke pixels.
ptTo
Het eindpunt van de lijn, in apparaatonafhankelijke pixels.
pBrush
Het penseel dat wordt gebruikt om de lijnstreek te schilderen.
fStrokeWidth
Een waarde groter dan of gelijk aan 0,0f die de breedte van de lijn aangeeft. Als deze parameter niet is opgegeven, wordt deze standaard ingesteld op 1.0f. De lijn is gecentreerd op de lijn.
strokeStyle
De stijl van lijn om te schilderen of NULL om een ononderbroken lijn te schilderen.
CRenderTarget::D rawRectangle
Hiermee tekent u het overzicht van een rechthoek met de opgegeven dimensies en lijnstijl.
void DrawRectangle(
const CD2DRectF& rectangle,
CD2DBrush* pBrush,
FLOAT fStrokeWidth = 1.0,
ID2D1StrokeStyle* strokeStyle = NULL);
Parameterwaarden
Rechthoek
De afmetingen van de rechthoek om te tekenen, in apparaatonafhankelijke pixels
pBrush
Het penseel dat wordt gebruikt om de lijn van de rechthoek te schilderen
fStrokeWidth
Een waarde groter dan of gelijk aan 0,0f die de breedte van de lijn van de rechthoek aangeeft. De lijn is gecentreerd op het kader van de rechthoek.
strokeStyle
De stijl van pennenstreken om te schilderen of NULL om een ononderbroken lijn te schilderen.
CRenderTarget::D rawRoundedRectangle
Hiermee tekent u het overzicht van de opgegeven afgeronde rechthoek met behulp van de opgegeven lijnstijl.
void DrawRoundedRectangle(
const CD2DRoundedRect& rectRounded,
CD2DBrush* pBrush,
FLOAT fStrokeWidth = 1.0,
ID2D1StrokeStyle* strokeStyle = NULL);
Parameterwaarden
rectRounded
De afmetingen van de afgeronde rechthoek om te tekenen, in apparaatonafhankelijke pixels.
pBrush
Het penseel dat wordt gebruikt om de omtrek van de afgeronde rechthoek te schilderen.
fStrokeWidth
De breedte van de afgeronde rechthoek. De lijn is gecentreerd op de omtrek van de afgeronde rechthoek. De standaardwaarde is 1,0f.
strokeStyle
De stijl van de afgeronde rechthoek of NULL om een ononderbroken lijn te schilderen. De standaardwaarde is NULL.
CRenderTarget::D rawText
Hiermee tekent u de opgegeven tekst met behulp van de indelingsgegevens van een IDWriteTextFormat-object.
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);
Parameterwaarden
strText
Een aanwijzer naar een matrix met Unicode-tekens die u wilt tekenen.
Rechthoek
De grootte en positie van het gebied waarin de tekst wordt getekend.
pForegroundBrush
De kwast die wordt gebruikt om de tekst te schilderen.
Textformat
Een object waarin de opmaakdetails van de tekst worden beschreven die moeten worden getekend, zoals het lettertype, de tekengrootte en de stroomrichting.
Opties
Een waarde die aangeeft of de tekst moet worden uitgelijnd op pixelgrenzen en of de tekst moet worden geknipt naar de rechthoek van de indeling. De standaardwaarde is D2D1_DRAW_TEXT_OPTIONS_NONE, wat aangeeft dat tekst moet worden uitgelijnd op pixelgrenzen en dat deze niet mag worden geknipt naar de rechthoek van de indeling.
measuringMode
Een waarde die aangeeft hoe glyph-metrische gegevens worden gebruikt om tekst te meten wanneer deze is opgemaakt. De standaardwaarde is DWRITE_MEASURING_MODE_NATURAL.
CRenderTarget::D rawTextLayout
Hiermee tekent u de opgemaakte tekst die wordt beschreven door het opgegeven IDWriteTextLayout-object.
void DrawTextLayout(
const CD2DPointF& ptOrigin,
CD2DTextLayout* textLayout,
CD2DBrush* pBrushForeground,
D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE);
Parameterwaarden
ptOrigin
Het punt, beschreven in apparaatonafhankelijke pixels, waar de linkerbovenhoek van de tekst die wordt beschreven door textLayout wordt getekend.
textLayout
De opgemaakte tekst die moet worden getekend. Tekeneffecten die niet overnemen van ID2D1Resource, worden genegeerd. Als er tekeneffecten zijn die overnemen van ID2D1Resource die geen borstels zijn, mislukt deze methode en krijgt het renderdoel een foutstatus.
pBrushVoorgrond
Het penseel dat wordt gebruikt voor het schilderen van tekst in textLayout waaraan nog geen penseel is gekoppeld als tekeneffect (opgegeven door de methode IDWriteTextLayout::SetDrawingEffect).
Opties
Een waarde die aangeeft of de tekst moet worden uitgelijnd op pixelgrenzen en of de tekst moet worden geknipt naar de rechthoek van de indeling. De standaardwaarde is D2D1_DRAW_TEXT_OPTIONS_NONE, wat aangeeft dat tekst moet worden uitgelijnd op pixelgrenzen en dat deze niet mag worden geknipt naar de rechthoek van de indeling.
CRenderTarget::EndDraw
Hiermee worden tekenbewerkingen op het renderdoel beëindigd en wordt de huidige foutstatus en de bijbehorende tags aangegeven.
HRESULT EndDraw();
Retourwaarde
Als de methode slaagt, wordt S_OK geretourneerd. Anders wordt een HRESULT-foutcode geretourneerd.
CRenderTarget::FillEllipse
Schildert het interieur van het opgegeven beletselteken.
void FillEllipse(
const CD2DEllipse& ellipse,
CD2DBrush* pBrush);
Parameterwaarden
Ellips
De positie en radius, in apparaatonafhankelijke pixels, van het beletselteken om te schilderen.
pBrush
De borstel die wordt gebruikt om het interieur van het beletselteken te schilderen.
CRenderTarget::FillGeometry
Schildert het interieur van de opgegeven geometrie.
void FillGeometry(
CD2DGeometry* pGeometry,
CD2DBrush* pBrush,
CD2DBrush* pOpacityBrush = NULL);
Parameterwaarden
pGeometry
De geometrie om te schilderen.
pBrush
De kwast die gebruikt werd om het interieur van de geometrie te schilderen.
pOpacityBrush
Het dekkingsmasker dat moet worden toegepast op de geometrie; NULL voor geen dekkingsmasker. Als een dekkingsmasker (de parameter opacityBrush) is opgegeven, moet brush een ID2D1BitmapBrush zijn die de x- en y-uitbreidingsmodi heeft ingesteld op D2D1_EXTEND_MODE_CLAMP. Zie de sectie Opmerkingen voor meer informatie.
CRenderTarget::FillMesh
Schildert het interieur van de opgegeven mesh.
void FillMesh(
CD2DMesh* pMesh,
CD2DBrush* pBrush);
Parameterwaarden
pMesh
De mesh om te schilderen.
pBrush
De kwast die gebruikt werd om de mesh te schilderen.
CRenderTarget::FillOpacityMask
Past het dekkingsmasker dat wordt beschreven door de opgegeven bitmap toe op een borstel en gebruikt die borstel om een gebied van het renderdoel te schilderen.
void FillOpacityMask(
CD2DBitmap* pOpacityMask,
CD2DBrush* pBrush,
D2D1_OPACITY_MASK_CONTENT content,
const CD2DRectF& rectDest,
const CD2DRectF& rectSrc);
Parameterwaarden
pOpacityMask
De positie en radius, in apparaatonafhankelijke pixels, van het beletselteken om te schilderen.
pBrush
Het penseel dat wordt gebruikt om het gebied van het renderdoel te schilderen dat is opgegeven door destinationRectangle.
inhoud
Het type inhoud dat het dekkingsmasker bevat. De waarde wordt gebruikt om de kleurruimte te bepalen waarin het dekkingsmasker wordt gemengd.
rectDest
Het gebied van het renderdoel om te schilderen, in apparaatonafhankelijke pixels.
rectSrc
Het gebied van de bitmap dat moet worden gebruikt als het dekkingsmasker, in apparaatonafhankelijke pixels.
CRenderTarget::FillRectangle
Schildert het interieur van de opgegeven rechthoek.
void FillRectangle(
const CD2DRectF& rectangle,
CD2DBrush* pBrush);
Parameterwaarden
Rechthoek
De dimensie van de rechthoek om te schilderen, in apparaatonafhankelijke pixels.
pBrush
De borstel die wordt gebruikt om het interieur van de rechthoek te schilderen.
CRenderTarget::FillRoundedRectangle
Schildert het interieur van de opgegeven afgeronde rechthoek.
void FillRoundedRectangle(
const CD2DRoundedRect& rectRounded,
CD2DBrush* pBrush);
Parameterwaarden
rectRounded
De afmetingen van de afgeronde rechthoek om te schilderen, in apparaatonafhankelijke pixels.
pBrush
De borstel die wordt gebruikt om het interieur van de afgeronde rechthoek te schilderen.
CRenderTarget::Flush
Hiermee worden alle tekenopdrachten uitgevoerd die in behandeling zijn.
void Flush(
D2D1_TAG* tag1 = NULL,
D2D1_TAG* tag2 = NULL);
Parameterwaarden
tag1
Bevat de tag voor tekenbewerkingen die fouten hebben veroorzaakt of 0 als er geen fouten zijn. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
tag2
Bevat de tag voor tekenbewerkingen die fouten hebben veroorzaakt of 0 als er geen fouten zijn. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
CRenderTarget::GetAntialiasMode
Hiermee haalt u de huidige antialiasingmodus op voor niet-teksttekeningsbewerkingen.
D2D1_ANTIALIAS_MODE GetAntialiasMode() const;
Retourwaarde
Huidige antialiasingmodus voor tekenbewerkingen zonder tekst.
CRenderTarget::GetDpi
Retourneert de dots per inch van het renderdoel (DPI)
CD2DSizeF GetDpi() const;
Retourwaarde
De dots per inch (DPI) van het renderdoel.
CRenderTarget::GetMaximumBitmapSize
Hiermee haalt u de maximale grootte, in apparaatafhankelijke eenheden (pixels), op van een bitmapdimensie die wordt ondersteund door het renderdoel
UINT32 GetMaximumBitmapSize() const;
Retourwaarde
De maximale grootte, in pixels, van een bitmapdimensie die wordt ondersteund door het renderdoel
CRenderTarget::Get PixelFormat
Haalt de pixelindeling en de alfamodus van het renderdoel op
D2D1_PIXEL_FORMAT GetPixelFormat() const;
Retourwaarde
De pixelindeling en de alfamodus van het renderdoel
CRenderTarget::Get PixelSize
Retourneert de grootte van het renderdoel in pixels van het apparaat
CD2DSizeU GetPixelSize() const;
Retourwaarde
De grootte van het renderdoel in pixels van het apparaat
CRenderTarget::GetRenderTarget
Retourneert ID2D1RenderTarget-interface
ID2D1RenderTarget* GetRenderTarget();
Retourwaarde
Aanwijzer naar een ID2D1RenderTarget-interface of NULL als het object nog niet is geïnitialiseerd.
CRenderTarget::GetSize
Retourneert de grootte van het renderdoel in apparaatonafhankelijke pixels
CD2DSizeF GetSize() const;
Retourwaarde
De huidige grootte van het renderdoel in apparaatonafhankelijke pixels
CRenderTarget::GetTags
Hiermee haalt u het label op voor volgende tekenbewerkingen.
void GetTags(
D2D1_TAG* tag1 = NULL,
D2D1_TAG* tag2 = NULL) const;
Parameterwaarden
tag1
Bevat het eerste label voor volgende tekenbewerkingen. Deze parameter wordt niet-geïnitialiseerd doorgegeven. Als NULL is opgegeven, wordt er geen waarde opgehaald voor deze parameter.
tag2
Bevat het tweede label voor volgende tekenbewerkingen. Deze parameter wordt niet-geïnitialiseerd doorgegeven. Als NULL is opgegeven, wordt er geen waarde opgehaald voor deze parameter.
CRenderTarget::GetTextAntialiasMode
Hiermee haalt u de huidige antialiasingmodus op voor tekst- en glyph-tekenbewerkingen.
D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;
Retourwaarde
Huidige antialiasingmodus voor tekst- en glyph-tekenbewerkingen.
CRenderTarget::GetTextRenderingParams
Hiermee haalt u de huidige opties voor tekstweergave van het renderdoel op.
void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);
Parameterwaarden
textRenderingParams
Wanneer deze methode wordt geretourneerd, bevat textRenderingParams het adres van een aanwijzer naar de huidige weergaveopties van het renderdoel.
CRenderTarget::GetTransform
Hiermee haalt u de huidige transformatie van het renderdoel op.
void GetTransform(D2D1_MATRIX_3X2_F* transform);
Parameterwaarden
transformeren
Wanneer dit wordt geretourneerd, bevat deze de huidige transformatie van het renderdoel. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
CRenderTarget::IsSupported
Geeft aan of het renderdoel de opgegeven eigenschappen ondersteunt
BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;
Parameterwaarden
renderTargetProperties
De doeleigenschappen weergeven die moeten worden getest
Retourwaarde
TRUE als de opgegeven eigenschappen van het renderdoel worden ondersteund door dit renderdoel; anders, ONWAAR
CRenderTarget::IsValid
Controleert de geldigheid van resources
BOOL IsValid() const;
Retourwaarde
WAAR als de resource geldig is; anders ONWAAR.
CRenderTarget::m_lstResources
Een lijst met aanwijzers naar CD2DResource-objecten.
CObList m_lstResources;
CRenderTarget::m_pRenderTarget
Een aanwijzer naar een ID2D1RenderTarget-object.
ID2D1RenderTarget* m_pRenderTarget;
CRenderTarget::m_pTextFormatDefault
Een aanwijzer naar CD2DTextFormat-object dat een standaardtekstindeling bevat.
CD2DTextFormat* m_pTextFormatDefault;
CRenderTarget::operator ID2D1RenderTarget*
Retourneert ID2D1RenderTarget-interface
operator ID2D1RenderTarget*();
Retourwaarde
Aanwijzer naar een ID2D1RenderTarget-interface of NULL als het object nog niet is geïnitialiseerd.
CRenderTarget::P opAxisAlignedClip
Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen.
void PopAxisAlignedClip();
CRenderTarget::P opLayer
Stopt met het omleiden van tekenbewerkingen naar de laag die is opgegeven door de laatste PushLayer-aanroep.
void PopLayer();
CRenderTarget::P ushAxisAlignedClip
Hiermee verwijdert u de laatste uitgelijnde clip uit het renderdoel. Nadat deze methode is aangeroepen, wordt de clip niet meer toegepast op volgende tekenbewerkingen.
void PushAxisAlignedClip(
const CD2DRectF& rectClip,
D2D1_ANTIALIAS_MODE mode = D2D1_ANTIALIAS_MODE_PER_PRIMITIVE);
Parameterwaarden
rectClip
De grootte en positie van het knipgebied, in apparaatonafhankelijke pixels.
mode
De antialiasingmodus die wordt gebruikt voor het tekenen van de randen van cliprechthoeken met sub pixelgrenzen en om de clip te combineren met de inhoud van de scène. De blending wordt eenmaal uitgevoerd wanneer de methode PopAxisAlignedClip wordt aangeroepen en is niet van toepassing op elke primitieve binnen de laag.
CRenderTarget::P ushLayer
Hiermee voegt u de opgegeven laag toe aan het renderdoel, zodat alle volgende tekenbewerkingen worden ontvangen totdat PopLayer wordt aangeroepen.
void PushLayer(
const D2D1_LAYER_PARAMETERS& layerParameters,
CD2DLayer& layer);
Parameterwaarden
layerParameters
De inhoudsgrenzen, geometrisch masker, dekking, dekkingsmasker en antialiasingopties voor de laag.
Laag
De laag die volgende tekenbewerkingen ontvangt.
CRenderTarget::RestoreDrawingState
Hiermee stelt u de tekenstatus van het renderdoel in op die van de opgegeven ID2D1DrawingStateBlock.
void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);
Parameterwaarden
drawingStateBlock
De nieuwe tekenstatus van het renderdoel.
CRenderTarget::SaveDrawingState
Hiermee wordt de huidige tekenstatus opgeslagen in het opgegeven ID2D1DrawingStateBlock.
void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;
Parameterwaarden
drawingStateBlock
Wanneer deze methode wordt geretourneerd, bevat deze de huidige tekenstatus van het renderdoel. Deze parameter moet worden geïnitialiseerd voordat deze wordt doorgegeven aan de methode.
CRenderTarget::SetAntialiasMode
Hiermee stelt u de antialiasingmodus van het renderdoel in. De antialiasingmodus is van toepassing op alle volgende tekenbewerkingen, met uitzondering van tekst- en glyph-tekenbewerkingen.
void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);
Parameterwaarden
antialiasMode
De antialiasingmodus voor toekomstige tekenbewerkingen.
CRenderTarget::SetDpi
Hiermee stelt u de dots per inch (DPI) van het renderdoel in.
void SetDpi(const CD2DSizeF& sizeDPI);
Parameterwaarden
sizeDPI
Een waarde groter dan of gelijk aan nul die de horizontale/verticale DPI van het renderdoel aangeeft.
CRenderTarget::SetTags
Hiermee geeft u een label op voor volgende tekenbewerkingen.
void SetTags(
D2D1_TAG tag1,
D2D1_TAG tag2);
Parameterwaarden
tag1
Een label dat moet worden toegepast op volgende tekenbewerkingen.
tag2
Een label dat moet worden toegepast op volgende tekenbewerkingen.
CRenderTarget::SetTextAntialiasMode
Hiermee geeft u de antialiasingmodus op die moet worden gebruikt voor volgende tekst- en glyph-tekenbewerkingen.
void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);
Parameterwaarden
textAntialiasMode
De antialiasingmodus die moet worden gebruikt voor volgende tekst- en glyph-tekenbewerkingen.
CRenderTarget::SetTextRenderingParams
Hiermee geeft u opties voor tekstweergave op die moeten worden toegepast op alle volgende tekst- en glyph-tekenbewerkingen.
void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);
Parameterwaarden
textRenderingParams
De opties voor tekstweergave die moeten worden toegepast op alle volgende tekst- en glyph-tekenbewerkingen; NULL om de huidige opties voor tekstweergave te wissen.
CRenderTarget::SetTransform
Hiermee past u de opgegeven transformatie toe op het renderdoel en vervangt u de bestaande transformatie. Alle volgende tekenbewerkingen vinden plaats in de getransformeerde ruimte.
void SetTransform(const D2D1_MATRIX_3X2_F* transform);
void SetTransform(const D2D1_MATRIX_3X2_F& transform);
Parameterwaarden
transformeren
De transformatie die moet worden toegepast op het renderdoel.
CRenderTarget::VerifyResource
Controleert de geldigheid van het CD2DResource-object; maakt het object als het nog niet bestaat.
BOOL VerifyResource(CD2DResource* pResource);
Parameterwaarden
pResource
Aanwijzer naar CD2DResource-object.
Retourwaarde
TRUE is object indien geldig; anders ONWAAR.