|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| gdi32.lib
| Header File
| wingdi.h
| Unicode
| No
| Platform Notes
| Windows 95: int == 16 bits
|
|
|
SetDIBitsToDevice
The SetDIBitsToDevice function sets the pixels in the specified rectangle on the device that is
associated with the destination device context using color data from a
device-independent bitmap (DIB).
int SetDIBitsToDevice(
HDC hdc,
| // handle of device context
| int XDest,
| // x-coordinate of upper-left corner of dest. rect.
| int YDest,
| // y-coordinate of upper-left corner of dest. rect.
| DWORD dwWidth,
| // source rectangle width
| DWORD dwHeight,
| // source rectangle height
| int XSrc,
| // x-coordinate of lower-left corner of source rect.
| int YSrc,
| // y-coordinate of lower-left corner of source rect.
| UINT uStartScan,
| // first scan line in array
| UINT cScanLines,
| // number of scan lines
| CONST VOID *lpvBits,
| // address of array with DIB bits
| CONST BITMAPINFO *lpbmi,
| // address of structure with bitmap info.
| UINT fuColorUse
| // RGB or palette indices
| );
|
|
Parameters
hdc
Identifies the device context.
XDest
Specifies the x-coordinate, in logical units, of the upper-left corner of the
destination rectangle.
YDest
Specifies the y-coordinate, in logical units, of the upper-left corner of the
destination rectangle.
dwWidth
Specifies the width, in logical units, of the DIB.
dwHeight
Specifies the height, in logical units, of the DIB.
XSrc
Specifies the x-coordinate, in logical units, of the lower-left corner of the
DIB.
YSrc
Specifies the y-coordinate, in logical units, of the lower-left corner of the
DIB.
uStartScan
Specifies the starting scan line in the DIB.
cScanLines
Specifies the number of DIB scan lines contained in the array pointed to by
the lpvBits parameter.
lpvBits
Points to DIB color data stored as an array of bytes.
lpbmi
Points to a BITMAPINFO structure that contains information about the DIB.
fuColorUse
Specifies whether the bmiColors member of the BITMAPINFO structure contains explicit red, green, blue (RGB) values or indices into a
palette. The fuColorUse parameter must be one of the following values:
Value
| Meaning
| DIB_PAL_COLORS
| The color table consists of an array of 16-bit indices into the currently
selected logical palette.
| DIB_RGB_COLORS
| The color table contains literal RGB values.
|
Return Values
If the function succeeds, the return value is the number of scan lines set.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
Optimal bitmap drawing speed is obtained when the bitmap bits are indices into
the system palette.
Applications can retrieve the system palette colors and indices by calling the GetSystemPaletteEntries function. After the colors and indices are retrieved, the application can
create the DIB. For more information about the system palette, see Colors.
The origin of a bottom-up DIB is the lower-left corner of the bitmap; the
origin of a top-down DIB is the upper-left corner.
To reduce the amount of memory required to set bits from a large
device-independent bitmap on a device surface, an application can band the output by
repeatedly calling SetDIBitsToDevice, placing a different portion of the bitmap into the lpvBits array each time. The values of the uStartScan and cScanLines parameters identify the portion of the bitmap contained in the lpvBits array.
The SetDIBitsToDevice function returns an error if it is called by a process that is running in the
background while a full-screen MS-DOS session runs in the foreground.
See Also
BITMAPINFO, GetSystemPaletteEntries, SetDIBits, StretchDIBits
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
