◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     The functions in the getpixel family return the pixel value (a
     color index) at a specified location. The getpixel function uses
     the view coordinates (<x>, <y>). The getpixel_w function uses the
     window coordinates (<wx>, <wy>).
 
     For both getpixel and getpixel_w, the ranges of possible pixel
     values and their color translations are determined by the current
     video mode and palette, respectively.
 
     Return Value
 
     If successful, the function returns the color index. If the
     function fails (for example, the point lies outside the clipping
     region, or the program is in text mode), it returns -1.
                                    -♦-