APPNOTE: PW0775: DIB Self-Study Module

• Microsoft Windows Software Development Kit (SDK) for Windows version 3.1

SUMMARY

This application note is a self-study module created by Microsoft Technical Support Worldwide Training to help software engineers develop expertise in Windows device-independent bitmaps (DIBs).

To obtain this application note (PW0775),"Device-Independent Bitmap Self-Study Module," call Microsoft Technical Support.

This application note is also available in the Microsoft Software Library:

Download PW0775.EXE, a file archived using the PKware file-compression utility, from the Microsoft Software Library (MSL) on the following services:

• Microsoft Download Service (MSDL)

        Dial (206) 936-6735 to connect to MSDL
        Download PW0775.EXE (size: 799981 bytes) 
  

• Internet (anonymous FTP)

        ftp ftp.microsoft.com
        Change to the \softlib\mslfiles directory
        Get PW0775.EXE (size: 799981 bytes) 
  

MORE INFORMATION

       Microsoft(R) Technical Support Application Note (Text File)
       PW0775: DEVICE INDEPENDENT BITMAP (DIB) SELF-STUDY MODULE

                                                   Revision Date: 4/94
                                                       1 Disk Included

| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY     |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an Application |
| Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER      |
| EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED      |
| WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR       |
| PURPOSE. The user assumes the entire risk as to the accuracy and    |
| the use of this Application Note. This Application Note may be      |
| copied and distributed subject to the following conditions:  1) All |
| text must be copied without modification and all pages must be      |
| included;  2) If software is included, all files on the disk(s)     |
| must be copied without modification (the MS-DOS(R)  utility         |
| diskcopy is appropriate for this purpose);  3) All components of    |
| this Application Note must be distributed together;  and  4) This   |
| Application Note may not be distributed for profit.                 |
|                                                                     |
| Copyright (C) 1993-1994 Microsoft Corporation. All Rights Reserved. |
| Microsoft and MS-DOS are registered trademarks and Windows is a     |
| trademark of Microsoft Corporation.                                 |
|---------------------------------------------------------------------|

ABOUT THIS COURSE

This self-study course is one of a series of courses developed by Microsoft Technical Support Worldwide Training to help software engineers develop expertise in areas of Windows that they have not previously explored. The course focuses on common programming errors, common troubleshooting scenarios, documentation errors, and Windows issues, in addition to common application programming techniques. This course was designed and the technical content supplied by engineers who provide developers with Windows programming support. The information included here has been determined by these specialists to be what you need to know about this topic in order to successfully implement it into your application.

WHAT YOU WILL LEARN

After completing this course, you will:

• Understand the motivation for using Device Independent Bitmaps (DIBs).
• Have a working knowledge of the DIB-related data structures and data types.
• Be able to implement and trouble shoot code that:

      - Reads and/or writes DIB files
      - Displays DIBs on graphical devices
      - Converts DIBs to Device Dependent Bitmaps (DDBs), DDBs to
        DIBs, and DIBs to other DIB formats
  

• Be able to describe the common problems encountered by Windows developers as they attempt to implement DIB-handling code.

INSTALLING THE SELF-STUDY MODULE

First, copy PW0775.EXE to the directory that the course is to be installed. Change to that directory and enter the following command:

   PW0775

   class -d

Directory Structure

The directory structure that is created has a LABS subdirectory and a TRAINING subdirectory. The TRAINING subdirectory contains a help file for the self-study course, a compiled version of the sample code, and a .DLL (dynamic-link library) for the Print All feature. The LABS subdirectory contains a subdirectory for each of the labs used in this course. In each of the individual lab subdirectories there is a DONECODE and a BASECODE subdirectory. The BASECODE subdirectory contains the code for the lab; the student modifies this code to get the desired results. The DONECODE directory contains the code for the solutions to the lab.

Getting Started

Once you have successfully installed the self-study module, run Windows and bring up the File Manager. Go to the TRAINING subdirectory in the directory that you installed the self-study module in and double-click the DIBS.HLP file. This will run the Windows Help engine and load the self-study module. You are now ready to begin the course.

Print All Feature

This self-study course has the option to "Print All" (a choice from the File menu). This menu selection prints the entire contents of the .HLP file containing the course.

NOTE: Due to design limitations of the Help engine, there is no way to abort this feature and all hardware input will be disabled while printing all. In addition, you cannot "print to file" using this feature; the print job MUST go directly to the printer.