... |
... |
@@ -34,7 +34,7 @@ |
34
|
34
|
/* pixel mode constants */
|
35
|
35
|
typedef enum grPixelMode
|
36
|
36
|
{
|
37
|
|
- gr_pixel_mode_none = 0,
|
|
37
|
+ gr_pixel_mode_none = 0, /* driver inquiry mode */
|
38
|
38
|
gr_pixel_mode_mono, /* monochrome bitmaps */
|
39
|
39
|
gr_pixel_mode_pal4, /* 4-bit paletted - 16 colors */
|
40
|
40
|
gr_pixel_mode_pal8, /* 8-bit paletted - 256 colors */
|
... |
... |
@@ -221,7 +221,8 @@ |
221
|
221
|
* bitmap with fewer levels of grays, as this would much probably
|
222
|
222
|
* give unpleasant results..
|
223
|
223
|
*
|
224
|
|
- * This function performs clipping.
|
|
224
|
+ * This function performs clipping. This function does not implement
|
|
225
|
+ * gamma correction.
|
225
|
226
|
*
|
226
|
227
|
**********************************************************************/
|
227
|
228
|
|
... |
... |
@@ -378,7 +379,7 @@ |
378
|
379
|
* "device chain"
|
379
|
380
|
*
|
380
|
381
|
* <Fields>
|
381
|
|
- * name :: ASCII name of the device, e.g. "x11", "os2pm", etc..
|
|
382
|
+ * name :: ASCII name of the device, e.g. "x11", "win32", etc..
|
382
|
383
|
* device :: handle to the device descriptor.
|
383
|
384
|
* next :: next element in chain
|
384
|
385
|
*
|
... |
... |
@@ -467,17 +468,9 @@ |
467
|
468
|
* error code. 0 means success. invalid device name otherwise
|
468
|
469
|
*
|
469
|
470
|
* <Note>
|
470
|
|
- * All drivers are _required_ to support at least the following
|
471
|
|
- * pixel formats :
|
472
|
|
- *
|
473
|
|
- * - gr_pixel_mode_mono : i.e. monochrome bitmaps
|
474
|
|
- * - gr_pixel_mode_gray : with any number of gray levels between
|
475
|
|
- * 2 and 256.
|
476
|
|
- *
|
477
|
|
- * the pixel modes do not provide the number of grays in the case
|
478
|
|
- * of "gray" devices. You should try to create a surface with the
|
479
|
|
- * maximal number (256, that is) and see the value returned in
|
480
|
|
- * the bitmap descriptor.
|
|
471
|
+ * This feature is not implemented in the common drivers. Use
|
|
472
|
+ * grNewSurface with gr_pixel_mode.none instead to let the driver
|
|
473
|
+ * set the mode.
|
481
|
474
|
*
|
482
|
475
|
**********************************************************************/
|
483
|
476
|
|
... |
... |
@@ -510,15 +503,11 @@ |
510
|
503
|
* handle to the corresponding surface object. 0 in case of error
|
511
|
504
|
*
|
512
|
505
|
* <Note>
|
513
|
|
- * If the requsted mode is gr_pixel_mode_mono, the driver can choose
|
514
|
|
- * a mode that is convenient for the driver.
|
|
506
|
+ * If the requsted mode is gr_pixel_mode_none, the driver chooses
|
|
507
|
+ * a mode that is convenient for the device.
|
515
|
508
|
*
|
516
|
509
|
* All drivers are _required_ to support at least the following
|
517
|
|
- * pixel formats :
|
518
|
|
- *
|
519
|
|
- * - gr_pixel_mode_mono : i.e. monochrome bitmaps
|
520
|
|
- * - gr_pixel_mode_gray : with any number of gray levels between
|
521
|
|
- * 2 and 256.
|
|
510
|
+ * pixel formats: gray, rgb555, rgb565, rgb24, or rgb32.
|
522
|
511
|
*
|
523
|
512
|
* This function might change the bitmap descriptor's fields. For
|
524
|
513
|
* example, when displaying a full-screen surface, the bitmap's
|
... |
... |
@@ -604,9 +593,8 @@ |
604
|
593
|
* as 8-bit (gray) bitmaps, or for individual color channels in various
|
605
|
594
|
* LCD arrangements.
|
606
|
595
|
*
|
607
|
|
- * It also handles mono and BGRA bitmaps as special cases.
|
608
|
|
- *
|
609
|
|
- * This function performs clipping.
|
|
596
|
+ * This function performs clipping. It also handles mono and BGRA
|
|
597
|
+ * bitmaps without ganna correction.
|
610
|
598
|
*
|
611
|
599
|
**********************************************************************/
|
612
|
600
|
|