Fonction EngCopyBits (winddi.h)

La fonction EngCopyBits se traduit entre des surfaces raster gérées par l’appareil et des bitmaps de format standard GDI.

Syntaxe

ENGAPI BOOL EngCopyBits(
       SURFOBJ  *psoDest,
       SURFOBJ  *psoSrc,
       CLIPOBJ  *pco,
       XLATEOBJ *pxlo,
  [in] RECTL    *prclDest,
  [in] POINTL   *pptlSrc
);

Paramètres

psoDest

Pointeur vers une structure SURFOBJ qui décrit la surface de destination pour l’opération de copie.

psoSrc

Pointeur vers une structure SURFOBJ qui décrit la surface source de l’opération de copie.

pco

Pointeur vers une structure CLIPOBJ qui limite la zone de la surface de destination qui sera affectée. Ce paramètre peut être NULL.

pxlo

Pointeur vers une structure XLATEOBJ qui définit la traduction d’index de couleur entre les surfaces source et cible.

[in] prclDest

Pointeur vers une structure RECTL qui définit la zone dans le système de coordonnées de la surface de destination qui sera modifiée. Le rectangle est exclusif en bas à droite, ce qui signifie que les bords inférieur et droit de ce rectangle ne font pas partie de la copie.

[in] pptlSrc

Pointeur vers une structure POINTL qui définit le coin supérieur gauche du rectangle source.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit. En cas d’échec, il consigne une erreur et retourne FALSE.

Remarques

Les bitmaps de format standard sont au format à plan unique et au format de pixels packés. Chaque ligne d’analyse est alignée sur une limite de 4 octets. Ces bitmaps ont 1, 4, 8, 16, 24 ou 32 bits par pixel. Consultez la fonction EngCreateBitmap pour obtenir la liste des types de format standard.

GDI appelle cette fonction à partir de ses simulations.

EngCopyBits ne doit pas être appelé avec un rectangle de destination vide, et les deux points du rectangle de destination doivent être bien triés ; autrement dit, le premier point doit représenter le sommet supérieur gauche du rectangle et le second doit représenter le sommet inférieur droit.

Configuration requise

Voir aussi

CLIPOBJ

SURFOBJ

XLATEOBJ