Click above to get retro games delivered to your door ever month!

 DibDraw()              FiveWin DIB drawing function
--------------------------------------------------------------------------------

   Syntax:              DibDraw( hDC, hMemBitmap, hPalette, nRow, nCol,
                                 nWidth, nHeight )  --> lSuccess

                        This function draws a DIB (device independent bitmap)
                        on the device context specified by hDC

   Parameters:

   <hDC>                The handle of the device context to use.

   <hMemBitmap>         The handle of the DIB.

   <hPalette>           The handle of the palette associated to the
                        DIB.

   <nRow>, <nCol>       The coordinates in pixels where start drawing.

   <nWidth>, <nHeight>  The dimensions for drawing the DIB.

   Returns:

   <lSuccess>           A logical value indicating if the operation was
                        successful.

   Observations:        When we started building FiveWin we first started
                        working with bitmaps. Later we discovered that the
                        general recommendation was to work with DIBs. So
                        we developed all the necessary functions to work
                        with DIBs. As our own experience increased, we believe
                        that there is a better way (a mixture of both) that was
                        much faster and easier.

                        We did a lot of different tests, and our system
                        was by far the fastest. It was a reason based on
                        speed and ease of use, because we wanted FiveWin to
                        be extremely fast! <g>

                        This later system is the one we currently use in
                        FiveWin, though we do give support for both Bitmaps
                        and DIBs.

                        You don't have to worry at all, just use FiveWin
                        TBitmap Class and place yourself at the
                        xBase & OOP level to get the maximum productivity.

                        Concentrate on your application, don't lose yourself
                        in details!

   Source code:         SOURCE\\WINAPI\\Dib.c

   See also:            DibRead() DibPalette() DibWidth() DibHeight()
                        DibWrite()