Ignore:
Timestamp:
Feb 17, 2001, 3:03:14 PM (25 years ago)
Author:
umoeller
Message:

Updates to XML.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/helpers/gpih.c

    r29 r38  
    55 *
    66 *      Usage: All PM programs.
    7  *
    8  *      A word about GPI rectangles: In general, graphics operations
    9  *      involving device coordinates (such as regions, bit maps and
    10  *      bit blts, and window management) use inclusive-exclusive
    11  *      rectangles.  All other graphics operations, such as GPI
    12  *      functions that define paths, use inclusive-inclusive rectangles.
    13  *
    14  *      This can be a problem with mixing Win and Gpi functions. For
    15  *      example, WinQueryWindowRect returns an inclusive-exclusive
    16  *      rectangle (so that the xRight value is the same as the window
    17  *      width -- tested V0.9.7 (2000-12-20) [umoeller]).
    18  *
    19  *      WinFillRect expects an inclusive-exclusive rectangle, so it
    20  *      will work with a rectangle from WinQueryWindowRect directly.
    21  *
    22  *      By contrast, the GpiBox expects an inclusive-inclusive rectangle.
    237 *
    248 *      Function prefixes (new with V0.81):
    … …  
    8771 */
    8872
     73/*
     74 *@@gloss: GPI_rectangles GPI rectangles
     75 *      OS/2 PM (and GPI) uses two types of rectangles. This is rarely
     76 *      mentioned in the documentation, so a word is in order here.
     77 *
     78 *      In general, graphics operations
     79 *      involving device coordinates (such as regions, bit maps and
     80 *      bit blts, and window management) use inclusive-exclusive
     81 *      rectangles.  All other graphics operations, such as GPI
     82 *      functions that define paths, use inclusive-inclusive rectangles.
     83 *
     84 *      This can be a problem with mixing Win and Gpi functions. For
     85 *      example, WinQueryWindowRect returns an inclusive-exclusive
     86 *      rectangle (so that the xRight value is the same as the window
     87 *      width -- tested V0.9.7 (2000-12-20) [umoeller]).
     88 *
     89 *      WinFillRect expects an inclusive-exclusive rectangle, so it
     90 *      will work with a rectangle from WinQueryWindowRect directly.
     91 *
     92 *      By contrast, the GpiBox expects an inclusive-inclusive rectangle.
     93 */
     94
    8995/* ******************************************************************
    9096 *
    … …  
    187193 *
    188194 *      The specified rectangle is inclusive, that is, the top
    189  *      right corner specifies the top right pixel to be drawn.
     195 *      right corner specifies the top right pixel to be drawn
     196 *      (see @GPI_rectangles).
    190197 *
    191198 *      This sets the current position to the bottom left corner
    … …  
    223230 *      The specified rectangle is inclusive, that is, the top
    224231 *      right corner specifies the top right pixel to be drawn.
    225  *      This is different from WinFillRect.
     232 *      This is different from WinFillRect
     233 *      (see @GPI_rectangles).
    226234 *
    227235 *      If (lColor != -1), the HPS's current foreground color
    … …  
    294302 *      The specified rectangle is inclusive, that is, the top
    295303 *      right corner specifies the top right pixel to be drawn.
    296  *      This is different from WinFillRect.
     304 *      This is different from WinFillRect
     305 *      (see @GPI_rectangles).
    297306 *
    298307 *      If usWidth > 1, the additional pixels will be drawn towards
    … …  
    341350 *      The specified rectangle is inclusive, that is, the top
    342351 *      right corner specifies the top right pixel to be drawn.
    343  *      This is different from WinFillRect.
     352 *      This is different from WinFillRect
     353 *      (see @GPI_rectangles).
    344354 *
    345355 *      If usWidth > 1, the additional pixels will be drawn towards
Note: See TracChangeset for help on using the changeset viewer.