Méthode TextureBrush ::TextureBrush(Image*,WrapMode,REAL,REAL,REAL,REAL) (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] REAL     dstX,
  [in] REAL     dstY,
  [in] REAL     dstWidth,
  [in] REAL     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 : REAL

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

[in] dstY

Type : REAL

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

[in] dstWidth

Type : REAL

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

[in] dstHeight

Type : REAL

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

Valeur de retour

None

Remarques

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