Méthode TextureBrush::TextureBrush(Image*,WrapMode,INT,INT,INT,INT) (gdiplusbrush.h)

Crée un objet TextureBrush basé sur une image, un mode d’habillage et un ensemble défini de coordonnées.

Syntaxe

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode,
  [in] INT      dstX,
  [in] INT      dstY,
  [in] INT      dstWidth,
  [in] INT      dstHeight
);

Paramètres

[in] image

Type : Image*

Pointeur vers un objet Image qui contient la bitmap de l’image à utiliser.

[in] wrapMode

Type : WrapMode

Élément de l’énumération WrapMode qui spécifie comment les copies répétées d’une image sont utilisées pour mettre en mosaïque une zone lorsqu’elle est peinte avec ce pinceau de texture.

[in] dstX

Type : INT

Coordonnée la plus à gauche de la partie image à utiliser par ce pinceau.

[in] dstY

Type : INT

Coordonnée la plus haute de la partie image à utiliser par ce pinceau.

[in] dstWidth

Type : INT

Largeur du pinceau et largeur de la partie image à utiliser par le pinceau.

[in] dstHeight

Type : INT

Hauteur du pinceau et hauteur de la partie image à utiliser par le pinceau.

Valeur de retour

None

Notes

Les paramètres dstX, dstY, dstWidth et dstHeight spécifient un rectangle. La taille du pinceau est définie par dstWidth et dstHeight. Les paramètres dstX et dstY n’ont aucun effet sur la taille ou la position du pinceau : le pinceau est toujours orienté vers (0, 0). Les paramètres dstX, dstY, dstWidth et dstHeight définissent la partie de l’image à utiliser par le pinceau.

Par exemple, supposons que vous ayez une image stockée dans un objet Image et dont la taille est de 256 ×512 pixels (largeur ×height). Ensuite, vous créez un objet TextureBrush basé sur cette image comme suit :

TextureBrush(&someImage, WrapModeTile, 12, 50, 100, 150)

Le pinceau aura une largeur de 100 unités et une hauteur de 150 unités. Le pinceau utilise une partie rectangulaire de l’image. Cette partie commence au pixel avec des coordonnées (12, 50). La largeur et la hauteur de la partie sont de 100 et 150, respectivement, mesurées à partir du pixel de départ.

Supposons maintenant que vous créez un autre objet TextureBrush basé sur la même image et que vous spécifiez un rectangle différent :

TextureBrush(&someImage, WrapModeTile, 0, 0, 256, 512)

La largeur et la hauteur du pinceau sont respectivement égales à 256 et 512. Le pinceau utilise l’image entière au lieu d’une partie de celle-ci, car le rectangle spécifie un pixel de départ aux coordonnées (0, 0) et aux dimensions identiques à celles de l’image.

Configuration requise

Voir aussi

Pinceaux et formes remplies

Image

TextureBrush

TextureBrush::GetWrapMode

TextureBrush::SetWrapMode

Utilisation d'un pinceau pour remplir des formes

WrapMode