Next: Exit (0xaa), Previous: Registers available (0x83), Up: Commands [Contents][Index]

#### 13.4.21 Display Get (0x84)

Gets the current screen in a requested bit format.

Command body:

byte 0: USE VIC-II?

  Must be included, but ignored for all but the C128. If true, (0x01) the screen returned will be from the VIC-II. If false (0x00), it will be from the VDC.

byte 1: Format

  0x00: Indexed, 8 bit
  0x01: RGB, 24 bit
  0x02: BGR, 24 bit
  0x03: RGBA, 32 bit
  0x04: BGRA, 32 bit

Response type:

0x84: MON_RESPONSE_DISPLAY_GET

Response body:

The length-at-the-beginning format of this object is similar to other response types, except for being four bytes. Also the display buffer length is contained inside another object instead of before the buffer.

4 bytes: Length of the fields before the display buffer
  4 bytes: Length of fields before reserved area
    4 bytes: Length of display buffer = (&buffer)
    2 bytes: Debug width of display buffer (uncropped)

      The largest width the screen gets.

    2 bytes: Debug height of display buffer (uncropped)

      The largest height the screen gets.

    2 bytes: X offset

      X offset to the inner part of the screen.

    2 bytes: Y offset

      Y offset to the inner part of the screen.

    2 bytes: Width of the inner part of the screen.
    2 bytes: Height of the inner part of the screen.
    1 byte: Bits per pixel of display buffer, 8, 24 or 32
  4 bytes: Length of the reserved area = (&reserved)
    (*reserved) bytes: Reserved TGA area
(*buffer) bytes: Display buffer data

Next: Exit (0xaa), Previous: Registers available (0x83), Up: Commands [Contents][Index]