DataMuseum.dk

top - download

    Length: 6908 (0x1afc)
    Names: »XCreateImage.3X«

└─⟦50656ff4a⟧ Bits:30010538 TX 3.1 Coldstart
    └─⟦bbf173f5c⟧ »0004« 
        └─⟦this⟧ »./usr/man/cat3/XCreateImage.3X« 

Default Hex Dump

0x0000…0020 0a 0a 0a 5f 08 4f 5f 08 6e 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 20 5f 08 4d 5f 08 61 5f 08 6e 5f   ┆   _ O_ n_ l_ i_ n_ e _ M_ a_ n_┆
0x0020…0040 08 75 5f 08 61 5f 08 6c 20 20 20 20 20 20 20 20 20 20 20 4c 69 62 72 61 72 79 20 46 75 6e 63 74   ┆ u_ a_ l           Library Funct┆
0x0040…0060 69 6f 6e 73 20 20 20 20 20 20 20 20 58 43 72 65 61 74 65 49 6d 61 67 65 28 33 58 29 0a 0a 0a 0a   ┆ions        XCreateImage(3X)    ┆
0x0060…0080 4e 08 4e 08 4e 08 4e 41 08 41 08 41 08 41 4d 08 4d 08 4d 08 4d 45 08 45 08 45 08 45 0a 20 20 20   ┆N N N NA A A AM M M ME E E E    ┆
0x0080…00a0 20 20 58 43 72 65 61 74 65 49 6d 61 67 65 2c 20 58 47 65 74 50 69 78 65 6c 2c 20 58 50 75 74 50   ┆  XCreateImage, XGetPixel, XPutP┆
0x00a0…00c0 69 78 65 6c 2c 20 58 53 75 62 49 6d 61 67 65 2c 20 58 41 64 64 50 69 78 65 6c 2c 0a 20 20 20 20   ┆ixel, XSubImage, XAddPixel,     ┆
0x00c0…00e0 20 58 44 65 73 74 72 6f 79 49 6d 61 67 65 20 2d 20 69 6d 61 67 65 20 75 74 69 6c 69 74 69 65 73   ┆ XDestroyImage - image utilities┆
0x00e0…0100 0a 0a 53 08 53 08 53 08 53 59 08 59 08 59 08 59 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 41 08   ┆  S S S SY Y Y YN N N NT T T TA ┆
0x0100…0120 41 08 41 08 41 58 08 58 08 58 08 58 0a 20 20 20 20 20 58 49 6d 61 67 65 20 2a 58 43 72 65 61 74   ┆A A AX X X X      XImage *XCreat┆
0x0120…0140 65 49 6d 61 67 65 28 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 2c 20 5f 08   ┆eImage(_ d_ i_ s_ p_ l_ a_ y, _ ┆
0x0140…0160 76 5f 08 69 5f 08 73 5f 08 75 5f 08 61 5f 08 6c 2c 20 5f 08 64 5f 08 65 5f 08 70 5f 08 74 5f 08   ┆v_ i_ s_ u_ a_ l, _ d_ e_ p_ t_ ┆
0x0160…0180 68 2c 20 5f 08 66 5f 08 6f 5f 08 72 5f 08 6d 5f 08 61 5f 08 74 2c 20 5f 08 6f 5f 08 66 5f 08 66   ┆h, _ f_ o_ r_ m_ a_ t, _ o_ f_ f┆
0x0180…01a0 5f 08 73 5f 08 65 5f 08 74 2c 0a 20 20 20 20 20 5f 08 64 5f 08 61 5f 08 74 5f 08 61 2c 20 5f 08   ┆_ s_ e_ t,      _ d_ a_ t_ a, _ ┆
0x01a0…01c0 77 5f 08 69 5f 08 64 5f 08 74 5f 08 68 2c 20 5f 08 68 5f 08 65 5f 08 69 5f 08 67 5f 08 68 5f 08   ┆w_ i_ d_ t_ h, _ h_ e_ i_ g_ h_ ┆
0x01c0…01e0 74 2c 20 5f 08 62 5f 08 69 5f 08 74 5f 08 6d 5f 08 61 5f 08 70 5f 5f 08 70 5f 08 61 5f 08 64 2c   ┆t, _ b_ i_ t_ m_ a_ p__ p_ a_ d,┆
0x01e0…0200 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5f 08   ┆                              _ ┆
0x0200…0220 62 5f 08 79 5f 08 74 5f 08 65 5f 08 73 5f 5f 08 70 5f 08 65 5f 08 72 5f 5f 08 6c 5f 08 69 5f 08   ┆b_ y_ t_ e_ s__ p_ e_ r__ l_ i_ ┆
0x0220…0240 6e 5f 08 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 44 69 73 70 6c 61 79 20 2a 5f 08 64 5f 08 69   ┆n_ e)            Display *_ d_ i┆
0x0240…0260 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 3b 0a 20 20 20 20 20 20 20 20 20 20 20 56 69 73 75   ┆_ s_ p_ l_ a_ y;            Visu┆
0x0260…0280 61 6c 20 2a 5f 08 76 5f 08 69 5f 08 73 5f 08 75 5f 08 61 5f 08 6c 3b 0a 20 20 20 20 20 20 20 20   ┆al *_ v_ i_ s_ u_ a_ l;         ┆
0x0280…02a0 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 5f 08 64 5f 08 65 5f 08 70 5f 08 74 5f 08 68 3b   ┆   unsigned int _ d_ e_ p_ t_ h;┆
0x02a0…02c0 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 66 5f 08 6f 5f 08 72 5f 08 6d 5f 08 61 5f   ┆            int _ f_ o_ r_ m_ a_┆
0x02c0…02e0 08 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 6f 5f 08 66 5f 08 66 5f 08 73 5f   ┆ t;            int _ o_ f_ f_ s_┆
0x02e0…0300 08 65 5f 08 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 5f 08 64 5f 08 61 5f 08   ┆ e_ t;            char *_ d_ a_ ┆
0x0300…0320 74 5f 08 61 3b 0a 20 20 20 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 5f 08   ┆t_ a;            unsigned int _ ┆
0x0320…0340 77 5f 08 69 5f 08 64 5f 08 74 5f 08 68 3b 0a 20 20 20 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e   ┆w_ i_ d_ t_ h;            unsign┆
0x0340…0360 65 64 20 69 6e 74 20 5f 08 68 5f 08 65 5f 08 69 5f 08 67 5f 08 68 5f 08 74 3b 0a 20 20 20 20 20   ┆ed int _ h_ e_ i_ g_ h_ t;      ┆
0x0360…0380 20 20 20 20 20 20 69 6e 74 20 5f 08 62 5f 08 69 5f 08 74 5f 08 6d 5f 08 61 5f 08 70 5f 5f 08 70   ┆      int _ b_ i_ t_ m_ a_ p__ p┆
0x0380…03a0 5f 08 61 5f 08 64 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 62 5f 08 79 5f 08 74   ┆_ a_ d;            int _ b_ y_ t┆
0x03a0…03c0 5f 08 65 5f 08 73 5f 5f 08 70 5f 08 65 5f 08 72 5f 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 3b 0a 0a   ┆_ e_ s__ p_ e_ r__ l_ i_ n_ e;  ┆
0x03c0…03e0 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 58 47 65 74 50 69 78 65 6c 28 5f 08 78   ┆     unsigned long XGetPixel(_ x┆
0x03e0…0400 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 20 5f 08 78 2c 20 5f 08 79 29 0a 20 20 20 20 20   ┆_ i_ m_ a_ g_ e, _ x, _ y)      ┆
0x0400…0420 20 20 20 20 20 20 58 49 6d 61 67 65 20 2a 5f 08 78 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65   ┆      XImage *_ x_ i_ m_ a_ g_ e┆
0x0420…0440 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 78 3b 0a 20 20 20 20 20 20 20 20 20 20   ┆;            int _ x;           ┆
0x0440…0460 20 69 6e 74 20 5f 08 79 3b 0a 0a 20 20 20 20 20 58 50 75 74 50 69 78 65 6c 28 5f 08 78 5f 08 69   ┆ int _ y;       XPutPixel(_ x_ i┆
0x0460…0480 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 20 5f 08 78 2c 20 5f 08 79 2c 20 5f 08 70 5f 08 69 5f 08   ┆_ m_ a_ g_ e, _ x, _ y, _ p_ i_ ┆
0x0480…04a0 78 5f 08 65 5f 08 6c 29 0a 20 20 20 20 20 20 20 20 20 20 20 58 49 6d 61 67 65 20 2a 5f 08 78 5f   ┆x_ e_ l)            XImage *_ x_┆
0x04a0…04c0 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f   ┆ i_ m_ a_ g_ e;            int _┆
0x04c0…04e0 08 78 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08 79 3b 0a 20 20 20 20 20 20 20 20   ┆ x;            int _ y;         ┆
0x04e0…0500 20 20 20 75 6e 73 69 67 6e 65 64 20 6c 6f 6e 67 20 5f 08 70 5f 08 69 5f 08 78 5f 08 65 5f 08 6c   ┆   unsigned long _ p_ i_ x_ e_ l┆
0x0500…0520 3b 0a 0a 20 20 20 20 20 58 49 6d 61 67 65 20 2a 58 53 75 62 49 6d 61 67 65 28 5f 08 78 5f 08 69   ┆;       XImage *XSubImage(_ x_ i┆
0x0520…0540 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 20 5f 08 78 2c 20 5f 08 79 2c 20 5f 08 73 5f 08 75 5f 08   ┆_ m_ a_ g_ e, _ x, _ y, _ s_ u_ ┆
0x0540…0560 62 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 5f 5f 08 77 5f 08 69 5f 08 64 5f 08 74 5f 08 68   ┆b_ i_ m_ a_ g_ e__ w_ i_ d_ t_ h┆
0x0560…0580 2c 0a 20 20 20 20 20 5f 08 73 5f 08 75 5f 08 62 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 5f   ┆,      _ s_ u_ b_ i_ m_ a_ g_ e_┆
0x0580…05a0 5f 08 68 5f 08 65 5f 08 69 5f 08 67 5f 08 68 5f 08 74 29 0a 20 20 20 20 20 20 20 20 20 20 20 58   ┆_ h_ e_ i_ g_ h_ t)            X┆
0x05a0…05c0 49 6d 61 67 65 20 2a 5f 08 78 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 3b 0a 20 20 20 20 20   ┆Image *_ x_ i_ m_ a_ g_ e;      ┆
0x05c0…05e0 20 20 20 20 20 20 69 6e 74 20 5f 08 78 3b 0a 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 5f 08   ┆      int _ x;            int _ ┆
0x05e0…0600 79 3b 0a 20 20 20 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 5f 08 73 5f 08   ┆y;            unsigned int _ s_ ┆
0x0600…0620 75 5f 08 62 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 5f 5f 08 77 5f 08 69 5f 08 64 5f 08 74   ┆u_ b_ i_ m_ a_ g_ e__ w_ i_ d_ t┆
0x0620…0640 5f 08 68 3b 0a 20 20 20 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 5f 08 73   ┆_ h;            unsigned int _ s┆
0x0640…0660 5f 08 75 5f 08 62 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 5f 5f 08 68 5f 08 65 5f 08 69 5f   ┆_ u_ b_ i_ m_ a_ g_ e__ h_ e_ i_┆
0x0660…0680 08 67 5f 08 68 5f 08 74 3b 0a 0a 20 20 20 20 20 58 41 64 64 50 69 78 65 6c 28 5f 08 78 5f 08 69   ┆ g_ h_ t;       XAddPixel(_ x_ i┆
0x0680…06a0 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 20 5f 08 76 5f 08 61 5f 08 6c 5f 08 75 5f 08 65 29 0a 20   ┆_ m_ a_ g_ e, _ v_ a_ l_ u_ e)  ┆
0x06a0…06c0 20 20 20 20 20 20 20 20 20 20 58 49 6d 61 67 65 20 2a 5f 08 78 5f 08 69 5f 08 6d 5f 08 61 5f 08   ┆          XImage *_ x_ i_ m_ a_ ┆
0x06c0…06e0 67 5f 08 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 6c 6f 6e 67 20 5f 08 76 5f 08 61 5f 08 6c 5f   ┆g_ e;            long _ v_ a_ l_┆
0x06e0…0700 08 75 5f 08 65 3b 0a 0a 20 20 20 20 20 58 44 65 73 74 72 6f 79 49 6d 61 67 65 28 5f 08 78 5f 08   ┆ u_ e;       XDestroyImage(_ x_ ┆
0x0700…0720 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 58 49 6d 61   ┆i_ m_ a_ g_ e)              XIma┆
0x0720…0740 67 65 20 2a 5f 08 78 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 3b 0a 0a 41 08 41 08 41 08 41   ┆ge *_ x_ i_ m_ a_ g_ e;  A A A A┆
0x0740…0760 52 08 52 08 52 08 52 47 08 47 08 47 08 47 55 08 55 08 55 08 55 4d 08 4d 08 4d 08 4d 45 08 45 08   ┆R R R RG G G GU U U UM M M ME E ┆
0x0760…0780 45 08 45 4e 08 4e 08 4e 08 4e 54 08 54 08 54 08 54 53 08 53 08 53 08 53 0a 20 20 20 20 20 5f 08   ┆E EN N N NT T T TS S S S      _ ┆
0x0780…07a0 62 5f 08 69 5f 08 74 5f 08 6d 5f 08 61 5f 08 70 5f 5f 08 70 5f 08 61 5f 08 64 0a 20 20 20 20 20   ┆b_ i_ t_ m_ a_ p__ p_ a_ d      ┆
0x07a0…07c0 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 71 75 61 6e 74 75 6d 20   ┆          Specifies the quantum ┆
0x07c0…07e0 6f 66 20 61 20 73 63 61 6e 6c 69 6e 65 20 28 38 2c 20 31 36 2c 20 6f 72 0a 20 20 20 20 20 20 20   ┆of a scanline (8, 16, or        ┆
0x07e0…0800 20 20 20 20 20 20 20 20 33 32 29 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 74 68   ┆        32).  In other words, th┆
0x0800…0820 65 20 73 74 61 72 74 20 6f 66 20 6f 6e 65 20 73 63 61 6e 6c 69 6e 65 20 69 73 0a 20 20 20 20 20   ┆e start of one scanline is      ┆
0x0820…0840 20 20 20 20 20 20 20 20 20 20 73 65 70 61 72 61 74 65 64 20 69 6e 20 63 6c 69 65 6e 74 20 6d 65   ┆          separated in client me┆
0x0840…0860 6d 6f 72 79 20 66 72 6f 6d 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 0a 20 20 20 20 20   ┆mory from the start of the      ┆
0x0860…0880 20 20 20 20 20 20 20 20 20 20 6e 65 78 74 20 73 63 61 6e 6c 69 6e 65 20 62 79 20 61 6e 20 69 6e   ┆          next scanline by an in┆
0x0880…08a0 74 65 67 65 72 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 74 68 69 73 20 6d 61 6e 79 0a 20 20 20 20   ┆teger multiple of this many     ┆
0x08a0…08c0 20 20 20 20 20 20 20 20 20 20 20 62 69 74 73 2e 0a 0a 20 20 20 20 20 5f 08 62 5f 08 79 5f 08 74   ┆           bits.       _ b_ y_ t┆
0x08c0…08e0 5f 08 65 5f 08 73 5f 5f 08 70 5f 08 65 5f 08 72 5f 5f 08 6c 5f 08 69 5f 08 6e 5f 08 65 0a 20 20   ┆_ e_ s__ p_ e_ r__ l_ i_ n_ e   ┆
0x08e0…0900 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 6e 75 6d 62 65   ┆             Specifies the numbe┆
0x0900…0920 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 63 6c 69 65 6e 74 20 69 6d 61 67 65 0a 20   ┆r of bytes in the client image  ┆
0x0920…0940 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 65 74 77 65 65 6e 20 74 68 65 20 73 74 61 72 74 20   ┆              between the start ┆
0x0940…0960 6f 66 20 6f 6e 65 20 73 63 61 6e 6c 69 6e 65 20 61 6e 64 20 74 68 65 20 73 74 61 72 74 20 6f 66   ┆of one scanline and the start of┆
0x0960…0980 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 6e 65 78 74 2e 0a 0a 20 20 20 20 20   ┆                the next.       ┆
0x0980…09a0 5f 08 64 5f 08 61 5f 08 74 5f 08 61 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 61 20 70 6f   ┆_ d_ a_ t_ a      Specifies a po┆
0x09a0…09c0 69 6e 74 65 72 20 74 6f 20 74 68 65 20 69 6d 61 67 65 20 64 61 74 61 2e 0a 0a 0a 0a 0a 0a 0a 20   ┆inter to the image data.        ┆
0x09c0…09e0 20 20 20 20 5f 08 64 5f 08 65 5f 08 70 5f 08 74 5f 08 68 20 20 20 20 20 53 70 65 63 69 66 69 65   ┆    _ d_ e_ p_ t_ h     Specifie┆
0x09e0…0a00 73 20 74 68 65 20 64 65 70 74 68 20 6f 66 20 74 68 65 20 69 6d 61 67 65 2e 0a 0a 20 20 20 20 20   ┆s the depth of the image.       ┆
0x0a00…0a20 5f 08 64 5f 08 69 5f 08 73 5f 08 70 5f 08 6c 5f 08 61 5f 08 79 20 20 20 53 70 65 63 69 66 69 65   ┆_ d_ i_ s_ p_ l_ a_ y   Specifie┆
0x0a20…0a40 73 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 58 20 73 65 72 76 65 72   ┆s the connection to the X server┆
0x0a40…0a60 2e 0a 0a 20 20 20 20 20 5f 08 66 5f 08 6f 5f 08 72 5f 08 6d 5f 08 61 5f 08 74 20 20 20 20 53 70   ┆.       _ f_ o_ r_ m_ a_ t    Sp┆
0x0a60…0a80 65 63 69 66 69 65 73 20 74 68 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 74 68 65 20 69 6d 61 67 65   ┆ecifies the format for the image┆
0x0a80…0aa0 2e 20 20 59 6f 75 20 63 61 6e 20 70 61 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5f   ┆.  You can pass                _┆
0x0aa0…0ac0 08 58 5f 08 59 5f 08 42 5f 08 69 5f 08 74 5f 08 6d 5f 08 61 5f 08 70 2c 20 5f 08 58 5f 08 59 5f   ┆ X_ Y_ B_ i_ t_ m_ a_ p, _ X_ Y_┆
0x0ac0…0ae0 08 50 5f 08 69 5f 08 78 5f 08 6d 5f 08 61 5f 08 70 2c 20 6f 72 20 5f 08 5a 5f 08 50 5f 08 69 5f   ┆ P_ i_ x_ m_ a_ p, or _ Z_ P_ i_┆
0x0ae0…0b00 08 78 5f 08 6d 5f 08 61 5f 08 70 2e 0a 0a 20 20 20 20 20 5f 08 68 5f 08 65 5f 08 69 5f 08 67 5f   ┆ x_ m_ a_ p.       _ h_ e_ i_ g_┆
0x0b00…0b20 08 68 5f 08 74 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 68 65 69 67 68 74 20 6f 66   ┆ h_ t    Specifies the height of┆
0x0b20…0b40 20 74 68 65 20 69 6d 61 67 65 2c 20 69 6e 20 70 69 78 65 6c 73 2e 0a 0a 20 20 20 20 20 5f 08 6f   ┆ the image, in pixels.       _ o┆
0x0b40…0b60 5f 08 66 5f 08 66 5f 08 73 5f 08 65 5f 08 74 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65   ┆_ f_ f_ s_ e_ t    Specifies the┆
0x0b60…0b80 20 6e 75 6d 62 65 72 20 6f 66 20 70 69 78 65 6c 73 20 74 6f 20 69 67 6e 6f 72 65 20 61 74 20 74   ┆ number of pixels to ignore at t┆
0x0b80…0ba0 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74   ┆he                beginning of t┆
0x0ba0…0bc0 68 65 20 73 63 61 6e 6c 69 6e 65 2e 0a 0a 20 20 20 20 20 5f 08 70 5f 08 69 5f 08 78 5f 08 65 5f   ┆he scanline.       _ p_ i_ x_ e_┆
0x0bc0…0be0 08 6c 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 6e 65 77 20 70 69 78 65 6c 20 76   ┆ l     Specifies the new pixel v┆
0x0be0…0c00 61 6c 75 65 2e 0a 0a 20 20 20 20 20 5f 08 73 5f 08 75 5f 08 62 5f 08 69 5f 08 6d 5f 08 61 5f 08   ┆alue.       _ s_ u_ b_ i_ m_ a_ ┆
0x0c00…0c20 67 5f 08 65 5f 5f 08 68 5f 08 65 5f 08 69 5f 08 67 5f 08 68 5f 08 74 0a 20 20 20 20 20 20 20 20   ┆g_ e__ h_ e_ i_ g_ h_ t         ┆
0x0c20…0c40 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 68 65 69 67 68 74 20 6f 66 20 74   ┆       Specifies the height of t┆
0x0c40…0c60 68 65 20 6e 65 77 20 73 75 62 69 6d 61 67 65 2c 20 69 6e 20 70 69 78 2d 0a 20 20 20 20 20 20 20   ┆he new subimage, in pix-        ┆
0x0c60…0c80 20 20 20 20 20 20 20 20 65 6c 73 2e 0a 0a 20 20 20 20 20 5f 08 73 5f 08 75 5f 08 62 5f 08 69 5f   ┆        els.       _ s_ u_ b_ i_┆
0x0c80…0ca0 08 6d 5f 08 61 5f 08 67 5f 08 65 5f 5f 08 77 5f 08 69 5f 08 64 5f 08 74 5f 08 68 0a 20 20 20 20   ┆ m_ a_ g_ e__ w_ i_ d_ t_ h     ┆
0x0ca0…0cc0 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 77 69 64 74 68 20 6f   ┆           Specifies the width o┆
0x0cc0…0ce0 66 20 74 68 65 20 6e 65 77 20 73 75 62 69 6d 61 67 65 2c 20 69 6e 20 70 69 78 2d 0a 20 20 20 20   ┆f the new subimage, in pix-     ┆
0x0ce0…0d00 20 20 20 20 20 20 20 20 20 20 20 65 6c 73 2e 0a 0a 20 20 20 20 20 5f 08 76 5f 08 61 5f 08 6c 5f   ┆           els.       _ v_ a_ l_┆
0x0d00…0d20 08 75 5f 08 65 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74 68 65 20 63 6f 6e 73 74 61 6e 74   ┆ u_ e     Specifies the constant┆
0x0d20…0d40 20 76 61 6c 75 65 20 74 68 61 74 20 69 73 20 74 6f 20 62 65 20 61 64 64 65 64 2e 0a 0a 20 20 20   ┆ value that is to be added.     ┆
0x0d40…0d60 20 20 5f 08 76 5f 08 69 5f 08 73 5f 08 75 5f 08 61 5f 08 6c 20 20 20 20 53 70 65 63 69 66 69 65   ┆  _ v_ i_ s_ u_ a_ l    Specifie┆
0x0d60…0d80 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 76 69 73 75 61 6c 2e 0a 0a 20 20 20 20   ┆s a pointer to the visual.      ┆
0x0d80…0da0 20 5f 08 77 5f 08 69 5f 08 64 5f 08 74 5f 08 68 20 20 20 20 20 53 70 65 63 69 66 69 65 73 20 74   ┆ _ w_ i_ d_ t_ h     Specifies t┆
0x0da0…0dc0 68 65 20 77 69 64 74 68 20 6f 66 20 74 68 65 20 69 6d 61 67 65 2c 20 69 6e 20 70 69 78 65 6c 73   ┆he width of the image, in pixels┆
0x0dc0…0de0 2e 0a 0a 20 20 20 20 20 5f 08 78 5f 08 69 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 20 20 20 20 53 70   ┆.       _ x_ i_ m_ a_ g_ e    Sp┆
0x0de0…0e00 65 63 69 66 69 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 69 6d 61 67 65 2e 0a   ┆ecifies a pointer to the image. ┆
0x0e00…0e20 0a 20 20 20 20 20 5f 08 78 0a 20 20 20 20 20 5f 08 79 20 20 20 20 20 20 20 20 20 53 70 65 63 69   ┆      _ x      _ y         Speci┆
0x0e20…0e40 66 79 20 74 68 65 20 78 20 61 6e 64 20 79 20 63 6f 6f 72 64 69 6e 61 74 65 73 2e 0a 0a 44 08 44   ┆fy the x and y coordinates.  D D┆
0x0e40…0e60 08 44 08 44 45 08 45 08 45 08 45 53 08 53 08 53 08 53 43 08 43 08 43 08 43 52 08 52 08 52 08 52   ┆ D DE E E ES S S SC C C CR R R R┆
0x0e60…0e80 49 08 49 08 49 08 49 50 08 50 08 50 08 50 54 08 54 08 54 08 54 49 08 49 08 49 08 49 4f 08 4f 08   ┆I I I IP P P PT T T TI I I IO O ┆
0x0e80…0ea0 4f 08 4f 4e 08 4e 08 4e 08 4e 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 43 5f 08 72 5f 08 65   ┆O ON N N N      The _ X_ C_ r_ e┆
0x0ea0…0ec0 5f 08 61 5f 08 74 5f 08 65 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 20 66 75 6e 63 74 69 6f   ┆_ a_ t_ e_ I_ m_ a_ g_ e functio┆
0x0ec0…0ee0 6e 20 61 6c 6c 6f 63 61 74 65 73 20 74 68 65 20 6d 65 6d 6f 72 79 20 6e 65 65 64 65 64 20 66 6f   ┆n allocates the memory needed fo┆
0x0ee0…0f00 72 20 61 6e 0a 20 20 20 20 20 5f 08 58 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 20 73 74 72   ┆r an      _ X_ I_ m_ a_ g_ e str┆
0x0f00…0f20 75 63 74 75 72 65 20 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 64 69 73 70 6c 61 79   ┆ucture for the specified display┆
0x0f20…0f40 20 62 75 74 20 64 6f 65 73 20 6e 6f 74 0a 20 20 20 20 20 61 6c 6c 6f 63 61 74 65 20 73 70 61 63   ┆ but does not      allocate spac┆
0x0f40…0f60 65 20 66 6f 72 20 74 68 65 20 69 6d 61 67 65 20 69 74 73 65 6c 66 2e 20 20 52 61 74 68 65 72 2c   ┆e for the image itself.  Rather,┆
0x0f60…0f80 20 69 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 0a 20 20 20 20 20 74 68 65 20 73 74 72 75 63 74 75   ┆ it initializes      the structu┆
0x0f80…0fa0 72 65 20 62 79 74 65 2d 6f 72 64 65 72 2c 20 62 69 74 2d 6f 72 64 65 72 2c 20 61 6e 64 20 62 69   ┆re byte-order, bit-order, and bi┆
0x0fa0…0fc0 74 6d 61 70 2d 75 6e 69 74 20 76 61 6c 75 65 73 0a 20 20 20 20 20 66 72 6f 6d 20 74 68 65 20 64   ┆tmap-unit values      from the d┆
0x0fc0…0fe0 69 73 70 6c 61 79 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20   ┆isplay and returns a pointer to ┆
0x0fe0…1000 74 68 65 20 5f 08 58 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 20 73 74 72 75 63 2d 0a 20 20   ┆the _ X_ I_ m_ a_ g_ e struc-   ┆
0x1000…1020 20 20 20 74 75 72 65 2e 20 20 54 68 65 20 72 65 64 2c 20 67 72 65 65 6e 2c 20 61 6e 64 20 62 6c   ┆   ture.  The red, green, and bl┆
0x1020…1040 75 65 20 6d 61 73 6b 20 76 61 6c 75 65 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 66 6f 72 0a 20   ┆ue mask values are defined for  ┆
0x1040…1060 20 20 20 20 5a 20 66 6f 72 6d 61 74 20 69 6d 61 67 65 73 20 6f 6e 6c 79 20 61 6e 64 20 61 72 65   ┆    Z format images only and are┆
0x1060…1080 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 74 68 65 20 5f 08 56 5f 08 69 5f 08 73 5f 08 75 5f 08   ┆ derived from the _ V_ i_ s_ u_ ┆
0x1080…10a0 61 5f 08 6c 20 73 74 72 75 63 2d 0a 20 20 20 20 20 74 75 72 65 20 70 61 73 73 65 64 20 69 6e 2e   ┆a_ l struc-      ture passed in.┆
0x10a0…10c0 20 20 4f 74 68 65 72 20 76 61 6c 75 65 73 20 61 6c 73 6f 20 61 72 65 20 70 61 73 73 65 64 20 69   ┆  Other values also are passed i┆
0x10c0…10e0 6e 2e 20 20 54 68 65 0a 20 20 20 20 20 6f 66 66 73 65 74 20 70 65 72 6d 69 74 73 20 74 68 65 20   ┆n.  The      offset permits the ┆
0x10e0…1100 72 61 70 69 64 20 64 69 73 70 6c 61 79 69 6e 67 20 6f 66 20 74 68 65 20 69 6d 61 67 65 20 77 69   ┆rapid displaying of the image wi┆
0x1100…1120 74 68 6f 75 74 0a 20 20 20 20 20 72 65 71 75 69 72 69 6e 67 20 65 61 63 68 20 73 63 61 6e 6c 69   ┆thout      requiring each scanli┆
0x1120…1140 6e 65 20 74 6f 20 62 65 20 73 68 69 66 74 65 64 20 69 6e 74 6f 20 70 6f 73 69 74 69 6f 6e 2e 20   ┆ne to be shifted into position. ┆
0x1140…1160 20 49 66 20 79 6f 75 0a 20 20 20 20 20 70 61 73 73 20 61 20 7a 65 72 6f 20 76 61 6c 75 65 20 69   ┆ If you      pass a zero value i┆
0x1160…1180 6e 20 62 79 74 65 73 5f 70 65 72 5f 6c 69 6e 65 2c 20 58 6c 69 62 20 61 73 73 75 6d 65 73 20 74   ┆n bytes_per_line, Xlib assumes t┆
0x1180…11a0 68 61 74 20 74 68 65 0a 20 20 20 20 20 73 63 61 6e 6c 69 6e 65 73 20 61 72 65 20 63 6f 6e 74 69   ┆hat the      scanlines are conti┆
0x11a0…11c0 67 75 6f 75 73 20 69 6e 20 6d 65 6d 6f 72 79 20 61 6e 64 20 63 61 6c 63 75 6c 61 74 65 73 20 74   ┆guous in memory and calculates t┆
0x11c0…11e0 68 65 20 76 61 6c 75 65 0a 20 20 20 20 20 6f 66 20 62 79 74 65 73 5f 70 65 72 5f 6c 69 6e 65 20   ┆he value      of bytes_per_line ┆
0x11e0…1200 69 74 73 65 6c 66 2e 0a 0a 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 77 68 65 6e 20 74 68 65   ┆itself.       Note that when the┆
0x1200…1220 20 69 6d 61 67 65 20 69 73 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 5f 08 58 5f 08 43 5f 08   ┆ image is created using _ X_ C_ ┆
0x1220…1240 72 5f 08 65 5f 08 61 5f 08 74 5f 08 65 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 0a 20 20   ┆r_ e_ a_ t_ e_ I_ m_ a_ g_ e,   ┆
0x1240…1260 20 20 20 5f 08 58 5f 08 47 5f 08 65 5f 08 74 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 20   ┆   _ X_ G_ e_ t_ I_ m_ a_ g_ e, ┆
0x1260…1280 6f 72 20 5f 08 58 5f 08 53 5f 08 75 5f 08 62 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 2c 20   ┆or _ X_ S_ u_ b_ I_ m_ a_ g_ e, ┆
0x1280…12a0 74 68 65 20 64 65 73 74 72 6f 79 20 70 72 6f 63 65 64 75 72 65 20 74 68 61 74 20 74 68 65 0a 20   ┆the destroy procedure that the  ┆
0x12a0…12c0 20 20 20 20 5f 08 58 5f 08 44 5f 08 65 5f 08 73 5f 08 74 5f 08 72 5f 08 6f 5f 08 79 5f 08 49 5f   ┆    _ X_ D_ e_ s_ t_ r_ o_ y_ I_┆
0x12c0…12e0 08 6d 5f 08 61 5f 08 67 5f 08 65 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 73 20 66 72 65 65 73   ┆ m_ a_ g_ e function calls frees┆
0x12e0…1300 20 62 6f 74 68 20 74 68 65 20 69 6d 61 67 65 20 73 74 72 75 63 74 75 72 65 0a 20 20 20 20 20 61   ┆ both the image structure      a┆
0x1300…1320 6e 64 20 74 68 65 20 64 61 74 61 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 74 68 65 20 69 6d   ┆nd the data pointed to by the im┆
0x1320…1340 61 67 65 20 73 74 72 75 63 74 75 72 65 2e 0a 0a 20 20 20 20 20 54 68 65 20 62 61 73 69 63 20 66   ┆age structure.       The basic f┆
0x1340…1360 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 74 6f 20 67 65 74 20 61 20 70 69 78 65 6c 2c 20 73 65   ┆unctions used to get a pixel, se┆
0x1360…1380 74 20 61 20 70 69 78 65 6c 2c 20 63 72 65 61 74 65 0a 20 20 20 20 20 61 20 73 75 62 69 6d 61 67   ┆t a pixel, create      a subimag┆
0x1380…13a0 65 2c 20 61 6e 64 20 61 64 64 20 61 20 63 6f 6e 73 74 61 6e 74 20 6f 66 66 73 65 74 20 74 6f 20   ┆e, and add a constant offset to ┆
0x13a0…13c0 61 20 5a 20 66 6f 72 6d 61 74 20 69 6d 61 67 65 0a 20 20 20 20 20 61 72 65 20 64 65 66 69 6e 65   ┆a Z format image      are define┆
0x13c0…13e0 64 20 69 6e 20 74 68 65 20 69 6d 61 67 65 20 6f 62 6a 65 63 74 2e 20 20 54 68 65 20 66 75 6e 63   ┆d in the image object.  The func┆
0x13e0…1400 74 69 6f 6e 73 20 69 6e 20 74 68 69 73 20 73 65 63 2d 0a 20 20 20 20 20 74 69 6f 6e 20 61 72 65   ┆tions in this sec-      tion are┆
0x1400…1420 20 72 65 61 6c 6c 79 20 6d 61 63 72 6f 20 69 6e 76 6f 63 61 74 69 6f 6e 73 20 6f 66 20 74 68 65   ┆ really macro invocations of the┆
0x1420…1440 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 0a 20 20 20 20 20 69 6d 61 67 65 20 6f 62 6a   ┆ functions in the      image obj┆
0x1440…1460 65 63 74 20 61 6e 64 20 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 3c 5f 08 58 5f 08 31 5f 08   ┆ect and are defined in <_ X_ 1_ ┆
0x1460…1480 31 2f 5f 08 58 5f 08 75 5f 08 74 5f 08 69 5f 08 6c 2e 5f 08 68 3e 2e 0a 0a 0a 0a 0a 0a 0a 0a 0a   ┆1/_ X_ u_ t_ i_ l._ h>.         ┆
0x1480…14a0 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 47 5f 08 65 5f 08 74 5f 08 50 5f 08 69 5f 08 78 5f 08   ┆     The _ X_ G_ e_ t_ P_ i_ x_ ┆
0x14a0…14c0 65 5f 08 6c 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 73 70 65 63 69 66   ┆e_ l function returns the specif┆
0x14c0…14e0 69 65 64 20 70 69 78 65 6c 20 66 72 6f 6d 20 74 68 65 0a 20 20 20 20 20 6e 61 6d 65 64 20 69 6d   ┆ied pixel from the      named im┆
0x14e0…1500 61 67 65 2e 20 20 54 68 65 20 70 69 78 65 6c 20 76 61 6c 75 65 20 69 73 20 72 65 74 75 72 6e 65   ┆age.  The pixel value is returne┆
0x1500…1520 64 20 69 6e 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 66 6f 72 2d 0a 20 20 20 20 20 6d 61 74 20 28 74   ┆d in normalized for-      mat (t┆
0x1520…1540 68 61 74 20 69 73 2c 20 74 68 65 20 6c 65 61 73 74 2d 73 69 67 6e 69 66 69 63 61 6e 74 20 62 79   ┆hat is, the least-significant by┆
0x1540…1560 74 65 20 6f 66 20 74 68 65 20 6c 6f 6e 67 20 69 73 20 74 68 65 0a 20 20 20 20 20 6c 65 61 73 74   ┆te of the long is the      least┆
0x1560…1580 2d 73 69 67 6e 69 66 69 63 61 6e 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 70 69 78 65 6c 29 2e   ┆-significant byte of the pixel).┆
0x1580…15a0 20 20 54 68 65 20 69 6d 61 67 65 20 6d 75 73 74 20 63 6f 6e 2d 0a 20 20 20 20 20 74 61 69 6e 20   ┆  The image must con-      tain ┆
0x15a0…15c0 74 68 65 20 78 20 61 6e 64 20 79 20 63 6f 6f 72 64 69 6e 61 74 65 73 2e 0a 0a 20 20 20 20 20 54   ┆the x and y coordinates.       T┆
0x15c0…15e0 68 65 20 5f 08 58 5f 08 50 5f 08 75 5f 08 74 5f 08 50 5f 08 69 5f 08 78 5f 08 65 5f 08 6c 20 66   ┆he _ X_ P_ u_ t_ P_ i_ x_ e_ l f┆
0x15e0…1600 75 6e 63 74 69 6f 6e 20 6f 76 65 72 77 72 69 74 65 73 20 74 68 65 20 70 69 78 65 6c 20 69 6e 20   ┆unction overwrites the pixel in ┆
0x1600…1620 74 68 65 20 6e 61 6d 65 64 0a 20 20 20 20 20 69 6d 61 67 65 20 77 69 74 68 20 74 68 65 20 73 70   ┆the named      image with the sp┆
0x1620…1640 65 63 69 66 69 65 64 20 70 69 78 65 6c 20 76 61 6c 75 65 2e 20 20 54 68 65 20 69 6e 70 75 74 20   ┆ecified pixel value.  The input ┆
0x1640…1660 70 69 78 65 6c 20 76 61 6c 75 65 0a 20 20 20 20 20 6d 75 73 74 20 62 65 20 69 6e 20 6e 6f 72 6d   ┆pixel value      must be in norm┆
0x1660…1680 61 6c 69 7a 65 64 20 66 6f 72 6d 61 74 20 28 74 68 61 74 20 69 73 2c 20 74 68 65 20 6c 65 61 73   ┆alized format (that is, the leas┆
0x1680…16a0 74 2d 73 69 67 6e 69 66 69 63 61 6e 74 0a 20 20 20 20 20 62 79 74 65 20 6f 66 20 74 68 65 20 6c   ┆t-significant      byte of the l┆
0x16a0…16c0 6f 6e 67 20 69 73 20 74 68 65 20 6c 65 61 73 74 2d 73 69 67 6e 69 66 69 63 61 6e 74 20 62 79 74   ┆ong is the least-significant byt┆
0x16c0…16e0 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 70 69 78 65 6c 29 2e 20 20 54 68 65 20 69 6d 61 67 65   ┆e of the      pixel).  The image┆
0x16e0…1700 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 78 20 61 6e 64 20 79 20 63 6f 6f 72 64 69   ┆ must contain the x and y coordi┆
0x1700…1720 6e 61 74 65 73 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 53 5f 08 75 5f 08 62 5f 08 49   ┆nates.       The _ X_ S_ u_ b_ I┆
0x1720…1740 5f 08 6d 5f 08 61 5f 08 67 5f 08 65 20 66 75 6e 63 74 69 6f 6e 20 63 72 65 61 74 65 73 20 61 20   ┆_ m_ a_ g_ e function creates a ┆
0x1740…1760 6e 65 77 20 69 6d 61 67 65 20 74 68 61 74 20 69 73 20 61 20 73 75 62 73 65 63 2d 0a 20 20 20 20   ┆new image that is a subsec-     ┆
0x1760…1780 20 74 69 6f 6e 20 6f 66 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6f 6e 65 2e 20 20 49 74 20 61 6c   ┆ tion of an existing one.  It al┆
0x1780…17a0 6c 6f 63 61 74 65 73 20 74 68 65 20 6d 65 6d 6f 72 79 20 6e 65 63 65 73 73 61 72 79 0a 20 20 20   ┆locates the memory necessary    ┆
0x17a0…17c0 20 20 66 6f 72 20 74 68 65 20 6e 65 77 20 5f 08 58 5f 08 49 5f 08 6d 5f 08 61 5f 08 67 5f 08 65   ┆  for the new _ X_ I_ m_ a_ g_ e┆
0x17c0…17e0 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 20 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72   ┆ structure and returns a pointer┆
0x17e0…1800 20 74 6f 20 74 68 65 0a 20 20 20 20 20 6e 65 77 20 69 6d 61 67 65 2e 20 20 54 68 65 20 64 61 74   ┆ to the      new image.  The dat┆
0x1800…1820 61 20 69 73 20 63 6f 70 69 65 64 20 66 72 6f 6d 20 74 68 65 20 73 6f 75 72 63 65 20 69 6d 61 67   ┆a is copied from the source imag┆
0x1820…1840 65 2c 20 61 6e 64 0a 20 20 20 20 20 74 68 65 20 69 6d 61 67 65 20 6d 75 73 74 20 63 6f 6e 74 61   ┆e, and      the image must conta┆
0x1840…1860 69 6e 20 74 68 65 20 72 65 63 74 61 6e 67 6c 65 20 64 65 66 69 6e 65 64 20 62 79 20 78 2c 20 79   ┆in the rectangle defined by x, y┆
0x1860…1880 2c 0a 20 20 20 20 20 73 75 62 69 6d 61 67 65 5f 77 69 64 74 68 2c 20 61 6e 64 20 73 75 62 69 6d   ┆,      subimage_width, and subim┆
0x1880…18a0 61 67 65 5f 68 65 69 67 68 74 2e 0a 0a 20 20 20 20 20 54 68 65 20 5f 08 58 5f 08 41 5f 08 64 5f   ┆age_height.       The _ X_ A_ d_┆
0x18a0…18c0 08 64 5f 08 50 5f 08 69 5f 08 78 5f 08 65 5f 08 6c 20 66 75 6e 63 74 69 6f 6e 20 61 64 64 73 20   ┆ d_ P_ i_ x_ e_ l function adds ┆
0x18c0…18e0 61 20 63 6f 6e 73 74 61 6e 74 20 76 61 6c 75 65 20 74 6f 20 65 76 65 72 79 20 70 69 78 65 6c 0a   ┆a constant value to every pixel ┆
0x18e0…1900 20 20 20 20 20 69 6e 20 61 6e 20 69 6d 61 67 65 2e 20 20 49 74 20 69 73 20 75 73 65 66 75 6c 20   ┆     in an image.  It is useful ┆
0x1900…1920 77 68 65 6e 20 79 6f 75 20 68 61 76 65 20 61 20 62 61 73 65 20 70 69 78 65 6c 20 76 61 6c 75 65   ┆when you have a base pixel value┆
[…truncated at 200 lines…]