GIF Graphic Control Extension User Input Flag

This article explains the binary representation and function of the User Input Flag in the GIF Graphic Control Extension (GCE). It details the byte layout of the Graphic Control Extension under the GIF89a specification, pinpoints the exact bit location of the flag within the packed fields byte, and demonstrates how to decode its binary values to determine animation behavior.

Structure of the Graphic Control Extension

In the GIF89a specification, the Graphic Control Extension contains parameters that modify how the following graphic rendering block is displayed. The block spans 8 bytes with the following structure:

• Byte 1: Extension Introducer (0x21)
• Byte 2: Graphic Control Label (0xF9)
• Byte 3: Block Size (0x04, fixed at 4 data bytes)
• Byte 4: Packed Fields
• Bytes 5–6: Delay Time (unsigned 16-bit integer, in hundredths of a second)
• Byte 7: Transparent Color Index
• Byte 8: Block Terminator (0x00)

The Packed Fields Byte

Byte 4 of the Graphic Control Extension contains the Packed Fields, an 8-bit byte that bundles multiple configuration flags:

• Bits 7–5: Reserved (3 bits)
• Bits 4–2: Disposal Method (3 bits)
• Bit 1: User Input Flag (1 bit)
• Bit 0: Transparent Color Flag (1 bit)

Binary Representation of the User Input Flag

The User Input Flag occupies Bit 1 (the second least significant bit) of the Packed Fields byte. Its binary representation and meanings are:

• 0 (0b0): No user input is expected. The decoder proceeds to the next frame immediately after the specified delay time elapses.
• 1 (0b1): User input (such as a mouse click or key press) is expected before advancing to the next graphic block. If a delay time is also specified, the decoder advances whenever user input occurs or when the timer expires, whichever comes first.

Bitmasking and Extraction

Within the full 8-bit Packed Fields byte, the User Input Flag aligns as:

Bit:    7   6   5   4   3   2   1   0
Field: [ Reserved ] [Disposal] [U] [T]

To isolate the User Input Flag programmatically, apply a bitwise AND operation with the binary mask 00000010 (hexadecimal 0x02), then shift the result one bit to the right:

User Input Flag = (Packed_Byte & 0x02) >> 1

If the extracted bit evaluates to 1, the GIF decoder is signaled to pause rendering until user interaction is registered.