CDC::PlgBlt

Makale
02/26/2013

Kaynak aygıt içeriğini belirtilen dörtgenden bit blok transfer renk veri bitleri belirli aygıt kapsamında belirtilen Paralelogram gerçekleştirir.

BOOL PlgBlt(
   LPPOINT lpPoint,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   int nWidth,
   int nHeight,
   CBitmap& maskBitmap,
   int xMask,
   int yMask 
);

Parametreler

lpPoint
Üç hedef Paralelogram köşelerini tanımlayan mantıksal alan üç puan noktaları bir dizi.Kaynak dikdörtgenin sol üst köşesinde bu dizi, bu dizi ikinci nokta için sağ üst köşedeki ve üçüncü noktası için sol alt köşesinde ilk noktayı eşleştirilir.Kaynak dikdörtgenin sağ alt köşesinde Paralelogram örtülü dördüncü noktasına eşleştirilmiş.
pSrcDC
Kaynak aygıt içeriğini tanımlar.
xSrc
Kaynak dikdörtgenin sol üst köşesindeki mantıksal birimler cinsinden x koordinatını belirtir.
ySrc
Kaynak dikdörtgenin sol üst köşesindeki mantıksal birimler cinsinden y koordinatı belirtir.
nWidth
Kaynak dikdörtgenin mantıksal birimler cinsinden genişliğini belirtir.
nHeight
Kaynak dikdörtgenin mantıksal birimler cinsinden yüksekliğini belirtir.
maskBitmap
Kaynak dikdörtgenin renkleri maskelemek için kullanılan isteğe bağlı bir tek renkli bitmap tanımlar.
xMask
Tek renkli bitmap sol üst köşesinin x koordinatını belirtir.
yMask
Tek renkli bitmap sol üst köşesinin y koordinatı belirtir.

Dönüş Değeri

Sıfır olmayan bir değer işlevi başarılı olursa; Aksi halde 0.

Notlar

Belirli bir bit maskesi tanıtıcısı geçerli bir tek renkli bitmap tanımlarsa renk verilerini kaynak dikdörtgen bit maskesi için bu bit eşlemi fonksiyonunu kullanır.

İlk üç düşünerek dördüncü Tepe (d) paralelkenarın tanımlanan noktaları (a, b ve c) olarak vektörler ve bilişim d = b + c - a.

Bit maskesi varsa, kaynak piksel rengi hedef kopyalanacağı maskesindeki 1 değerini gösterir.Maskede 0 değeri, hedef rengindeki değiştirilmemesi olduğunu gösterir.

Maske dikdörtgen kaynak ve hedef dikdörtgenler'den küçük ise, işlev maskesi desen çoğaltır.

Kaynak aygıt içeriğini ölçekleme, çeviri ve yansıtma dönüştürmeleri izin verilir; Ancak, döndürme ve yamultma dönüştürmeleri değildir.Tek renkli bitmap maskesi bitmap değilse bir hata oluşur.Hedef aygıt içeriğini uzatma modunu gerekli olması durumunda uzatma veya piksel sıkıştırmak belirlemek için kullanılır.Bir Gelişmiş Meta dosyası kaydettiğiniz zaman, kaynak aygıt içeriğini Gelişmiş Meta dosyası aygıt içeriğini tanımlayan bir hata ortaya çıkar.

Hedef koordinatları hedef aygıtı bağlama göre dönüştürülür; Kaynak koordinatları kaynak aygıtı bağlama göre dönüştürülür.Kaynak dönüşümü döndürme veya Yamultma varsa, bir hata döndürdü.Hedef ve kaynak dikdörtgenlerin aynı renk biçimi yoksa PlgBlt hedef dikdörtgen eşleştirmek için kaynak dikdörtgen dönüştürür.Destekleyen tüm aygıtları PlgBlt.Daha fazla bilgi için bkz: açıklama RC_BITBLT raster yeteneği, CDC::GetDeviceCaps üye işlevi.

Kaynak ve hedef aygıt bağlamları uyumsuz aygıtları temsil ediyorsa, PlgBlt bir hata döndürür.