2.2.2.2.1.1.2.22 MultiDrawNineGrid (MULTI_DRAWNINEGRID_ORDER)

  • Article

The MultiDrawNineGrid Primary Drawing Order encodes a single NineGrid drawing command with multiple clipping rectangles.

 Encoding order number: 8 (0x08)
 Negotiation order number: 9 (0x09)
 Number of fields: 7
 Number of field encoding bytes: 1
 Maximum encoded field length: 396 bytes


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

srcLeft (variable)

srcTop (variable)

srcRight (variable)

srcBottom (variable)

bitmapId (optional)

nDeltaEntries (optional)

CodedDeltaList (variable)

...

srcLeft (variable): The left coordinate of the clipping rectangle to be applied to the bitmap stored at the entry given by the bitmapId field. The coordinate is specified by using a Coord Field (section 2.2.2.2.1.1.1.1).

srcTop (variable): The top coordinate of the clipping rectangle to be applied to the bitmap stored at the entry given by the bitmapId field. The coordinate is specified by using a Coord Field (section 2.2.2.2.1.1.1.1).

srcRight (variable): The right coordinate of the clipping rectangle to be applied to the bitmap stored at the entry given by the bitmapId field. The coordinate is specified by using a Coord Field (section 2.2.2.2.1.1.1.1).

srcBottom (variable): The bottom coordinate of the clipping rectangle to be applied to the bitmap stored at the entry given by the bitmapId field. The coordinate is specified by using a Coord Field (section 2.2.2.2.1.1.1.1).

bitmapId (2 bytes): A 16-bit, unsigned integer. The index of the NineGrid Bitmap Cache entry wherein the bitmap and NineGrid transformation information are stored. This value MUST be greater than or equal to 0 and less than the maximum number of entries allowed in the NineGrid Bitmap Cache as specified by the drawNineGridCacheEntries field of the DrawNineGrid Cache Capability Set (section 2.2.1.2). The bitmap and transformation information stored in the cache MUST have already been cached in response to a Create NineGrid Bitmap (section 2.2.2.2.1.3.4) Alternate Secondary Drawing Order.

nDeltaEntries (1 byte): An 8-bit, unsigned integer. The number of bounding rectangles described by the CodedDeltaList field.

CodedDeltaList (variable): A Two-Byte Header Variable Field (section 2.2.2.2.1.1.1.3) structure that encapsulates a Delta-Encoded Rectangles (section 2.2.2.2.1.1.1.5) structure that contains bounding rectangles to use when rendering the order. The number of rectangles described by the Delta-Encoded Rectangles structure is specified by the nDeltaEntries field.