Article ID: 168743 - Last Review: November 21, 2006 - Revision: 4.4

Using HALFTONE Stretching with COLORADJUSTMENT

View products that this article applies to.
System TipThis article applies to a different operating system than the one you are using. Article content that may not be relevant to you is disabled.
This article was previously published under Q168743
Expand all | Collapse all

SUMMARY

This sample demonstrates how to use the HALFTONE stretch mode and some of the effects that can be generated by using it.

The following file is available for download from the Microsoft Download Center:
Halftone.exe (http://download.microsoft.com/download/platformsdk/sample29/1/w97/en-us/halftone.exe)
For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:
119591  (http://support.microsoft.com/kb/119591/EN-US/ ) How to Obtain Microsoft Support Files from Online Services
Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

The following files are a contained in Halftone.exe:
  • Palette.h Palette.C - Contains all of the functions relating to creating and manipulating Windows palettes.
  • DIB.h DIB.c - Contains all of the code for loading and converting DIBs and DDBs.
  • HALFTONE.h HALFTONE.c - Contains the UI and the code demonstrating halftone stretching and COLORADJUSTMENT.

MORE INFORMATION

In many cases it is necessary to display bitmaps or DIBs that have a greater bit depth than your current display mode. To account for this, GDI has to remap the colors your bitmap uses into the colors that are available. This remapping process can be slow and often produces unsatisfactory results. A simple way to produce high quality representations of your original image is to ask GDI to dither the image into the palette selected into the target DC. To get GDI to dither the image you need to use the SetStretchBltMode() API and specify the target DC and the HALFTONE flag. Now, when you want to display your bitmap into the target DC, all you have to do is use StretchBlt() or StretchDIBits() rather than BitBlt() or SetDIBits(). For example: 
   SetStretchBltMode(hdcTarget, HALFTONE);
   StretchBlt(hdcTarget, 0,0,dwWidth,dwHeight,

                   hdcSource, 0,0,dwWidth,dwHeight, SRCCOPY);
When you use the HALFTONE stretch mode, it is possible to apply a filter that alters the way GDI processes the color information from the source image. This makes it possible to not only lighten or darken the image but also apply more complex image filters. To specify a filter you use the SetColorAdjustment() API and pass it the target DC and a pointer to a COLORADJUSTMENT record. The COLORADJUSTMENT structure defines the color adjustment values used by the StretchBlt() and StretchDIBits() functions when the stretch mode is HALFTONE. For example: 
   SetColorAdjustment(hdcTarget, &caFilter);
After you build the sample, run it, and then load a .bmp file. Once the file is loaded, you can use "adjust the halftone properties" and see the effects on the bitmap.
APPLIES TO
  • Microsoft Win32 Application Programming Interface, when used with:
    • Microsoft Windows NT Server 3.5
    • Microsoft Windows NT Server 3.51
    • Microsoft Windows NT Server 4.0 Standard Edition
    • Microsoft Windows NT Workstation 3.5
    • Microsoft Windows NT Workstation 3.51
    • Microsoft Windows NT Workstation 4.0 Developer Edition
Back to the top
Keywords: 
kbdownload kbfile kbinfo kbprogramming KB168743