Changeset 25 for trunk/src/helpers/gpih.c

Timestamp:

Jan 17, 2001, 6:34:55 PM (25 years ago)

Author:

umoeller

Message:

Misc. changes for V0.9.7.

File:

• trunk/src/helpers/gpih.c (modified) (6 diffs)

trunk/src/helpers/gpih.c

@@ -225 +225 @@
  *      This is different from WinFillRect.
  *
+ *      If (lColor != -1), the HPS's current foreground color
+ *      is changed to that color.
+ *
  *      Changes to the HPS:
- *      --  the current (foreground) color is changed to
- *          lBackColor;
- *      --  the current area color is changed to lForeColor;
+ *
  *      --  the current position is moved to the lower left
  *          corner of *prcl.
@@ -234 +235 @@
  *@@changed V0.9.0 [umoeller]: renamed from gpihFillRect
  *@@changed V0.9.0 [umoeller]: modified function prototype to support lControl
+ *@@changed V0.9.7 (2001-01-17) [umoeller]: removed lColor
  */
 
 VOID gpihBox(HPS hps,              // in: presentation space for output
              LONG lControl,        // in: one of DRO_OUTLINE, DRO_FILL, DRO_OUTLINEFILL
-             PRECTL prcl,          // in: rectangle to draw (exclusive)
-             LONG lColor)          // in: color for outline and/or fill
+             PRECTL prcl)          // in: rectangle to draw (exclusive)
 {
     POINTL      ptl;
 
-    GpiSetColor(hps, lColor);
     ptl.x = prcl->xLeft;
     ptl.y = prcl->yBottom;
@@ -263 +263 @@
  *
  *      No PS data is changed.
+ *
+ *@@changed V0.9.7 (2001-01-17) [umoeller]: removed lColor
  */
 
@@ -268 +270 @@
                 LONG x,             // in: x-center of rectangle
                 LONG y,             // in: y-center of rectangle
-                ULONG ulWidth,      // in: rectangle width and height
-                LONG lColor)        // in: color
+                ULONG ulWidth)      // in: rectangle width and height
 {
     POINTL  ptlSave;
-    LONG    lColorSave;
     RECTL   rclTemp;
     ULONG   ulWidth2 = ulWidth / 2;
@@ -280 +280 @@
     rclTemp.yTop    = y + ulWidth2;
 
-    lColorSave = GpiQueryColor(hps);
     GpiQueryCurrentPosition(hps, &ptlSave);
     gpihBox(hps,
             DRO_FILL,
-            &rclTemp,
-            lColor);
+            &rclTemp);
     GpiMove(hps, &ptlSave);
-    GpiSetColor(hps, lColorSave);
 }
 
@@ -746 +743 @@
  *          semaphore is held by the wrapper. Then use only
  *          the wrapper in your code.
+ *
+ *      <B>Font metrics:</B>
+ *
+ *      The important values in the returned FONTMETRICS are
+ *      like this (according to PMREF):
+ *
+ +   ÉÍ ________________________________________________
+ +   º
+ +   º lExternalLeading, according to font designer.
+ +   º  ________________________________________________  Í»
+ +   ÈÍ                                                    º
+ +                                  #       #              º
+ +                                  ##     ##              º lMaxAscender (of entire;
+ +   ÉÍ _______________             # #   # #              º font); this can be > capital
+ +   º                 ####         #  # #  #              º letters because miniscules
+ +   º                #    #        #   #   #              º can exceed that.
+ +   º  lXHeight      #    #        #       #              º
+ +   º                #    #        #       #              º
+ +   º                #    #        #       #              º
+ +   º  _______________#####________#_______#___ baseline Í»
+ +   ÈÍ                    #                               º
+ +                         #                               º lMaxDescender
+ +      ______________ ####______________________________ ͌
+ +
+ *
+ *      In turn, lMaxBaselineExt is lMaxAscender + lMaxDescender.
+ *
+ *      Soooo... to find out about the optimal line spacing, GPIREF
+ *      recommends to use lMaxBaselineExt + lExternalLeading.
  *
  *@@added V0.9.0 [umoeller]