Graphics Orders

A graphics order is a low-level graphics command that corresponds to a primitive function or attribute. In addition to code and data requirements, each graphics order uses approximately 11 bytes of storage. An application that uses 2000 graphics drawing orders will use around 22KB of memory to store them. The following table describes the four sizes of graphics orders.

Graphics Orders

кФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
ГGraphics Order Size     ГContent                             Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г1 byte                  ГA hexadecimal identifier            Г
Г                        Гcorresponding to a drawing function Г
Г                        Гor attribute function. This         Г
Г                        Гidentifier is also known as the     Г
Г                        Гorder code.                         Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г2 byte                  ГThe order code is in the first byte,Г
Г                        Гand data is in the second byte.     Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГLong                    ГThe order code is in the first byte.Г
Г                        Г                                    Г
Г                        ГThe length value of the actual data,Г
Г                        Гin bytes, is in the second byte.    Г
Г                        Г                                    Г
Г                        ГThe actual data (up to 255 bytes).  Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГVery long               ГA hexadecimal identifier            Г
Г(maximum length of 64KB)Гspecifically for extended orders, isГ
Г                        Гin the first byte.                  Г
Г                        Г                                    Г
Г                        ГThe order code is in the second     Г
Г                        Гbyte.                               Г
Г                        Г                                    Г
Г                        ГA length value that specifies how   Г
Г                        Гmany bytes are used by the          Г
Г                        Гgraphics-order arguments, (high     Г
Г                        Гorder) is in the third byte.        Г
Г                        Г                                    Г
Г                        ГA length value that specifies how   Г
Г                        Гmany bytes are used by the          Г
Г                        Гgraphics-order arguments, (low      Г
Г                        Гorder) is in the fourth byte.       Г
Г                        Г                                    Г
Г                        ГThe actual data.                    Г
РФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

The following example shows a long graphics order that corresponds to GpiLine:

    81 8 100 0 0 0 100 0 0 0

The first number, 81, is the hexadecimal identifier that corresponds to GpiLine. The second number, 8, is the length value that specifies how many bytes are used by the graphics-order arguments. The next eight bytes contain the arguments for GpiLine. In this case, the arguments specify the line's end point at (100,100).


                               Graphics
                               Segment
                                      Г
кФФФФФФФФФФФФФФФФФФФФФФП  кФФ  0x21  ХФФФФФФФФФФ order # ФФП
Г                      Г  Г     0x08  ХФФФФФФФФФФ length    Г
Г ptl.x = 100L;        Г  Г     0x00  Г ФФФФП               Г
Г ptl.y = 100L;        Г  Г     0x00  Г     УФФ      x      Г
Г GpiMove (hps, &ptl); ХФФй     0x10  Г     Г               УФФ  element
Г ptl.x = 200L;        Г        0x00  Г ФФФФй               Г
Г ptl.y = 400L;        Г        0x00  Г ФФФФП               Г
Г GpiMove (hps, &ptl); ХФФП     0x00  Г     УФФ      y      Г
Г                      Г  Г     0x20  Г     Г               Г
РФФФФФФФФФФФФФФФФФФФФФФй  Г     0x00  Г ФФФФй             ФФй
                          РФФ  0x81  ХФФФФФФФФФФ order # ФФП
                                0x08  ХФФФФФФФФФФ length    Г
                                0x00  Г ФФФФП               Г
                                0x00  Г     УФФ      x      Г
                                0x30  Г     Г               УФФ  element
                                0x00  Г ФФФФй               Г
                                0x00  Г ФФФФП               Г
                                0x00  Г     УФФ      y      Г
                                0x40  Г     Г               Г
                                0x00  Г ФФФФй             ФФй
                                      Г

Graphics Orders

The encoding that appears in the Graphics Segments column is a hexadecimal version of the order, length, and parameter information.

In most cases, graphics orders in a segment correspond to a subpicture, which is part of a complete, more complex picture. Your application would combine the individual segments to form the complete picture.

Three drawing modes affect how the operating system stores graphics orders in segments. These modes are described in the following table. The default drawing mode is draw (DM_DRAW). To specify another as the current drawing mode, use GpiSetDrawingMode.

The actual drawing mode is a combination of the drawing mode as set using GpiSetDrawingMode, and the segment status-chained, unchained, or outside of the segment. The actual drawing mode does not affect the storing of orders in segments.

Segment Graphics Drawing Modes

кФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФП
ГDrawing Mode      ГGpiSetDrawingMode ГWhen this mode is set...Г
Г                  ГValue             Г                        Г
УФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
ГDraw              ГDM_DRAW           Гit is not possible to   Г
Г                  Г                  Гstore graphics orders inГ
Г                  Г                  Гa chained segment.      Г
УФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
ГRetain            ГDM_RETAIN         Гyour application can    Г
Г                  Г                  Гstore graphics orders inГ
Г                  Г                  Гchained and unchained   Г
Г                  Г                  Гsegments.               Г
УФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФД
ГDraw-and-retain   ГDM_DRAWANDRETAIN  Гyour application can    Г
Г                  Г                  Гstore graphics orders inГ
Г                  Г                  Гchained and unchained   Г
Г                  Г                  Гsegments.  In this mode,Г
Г                  Г                  Гoutput intended for a   Г
Г                  Г                  Гchained segment is both Г
Г                  Г                  Гdrawn on the device and Г
Г                  Г                  Гstored in a segment.    Г
РФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФй

[Back] [Next]