Information Messages

Screen information and configuration messages. More...

Collaboration diagram for Information Messages:

Variables
const char *const	kMsgDInfo
	Client screen information.
const char *const	kMsgDSetOptions
	Set client options.

Detailed Description

Screen information and configuration messages.

Variable Documentation

kMsgDInfo

const char* const kMsgDInfo

extern

Client screen information.

Message Code: "DINF" Direction: Secondary → Primary Format: "DINF%2i%2i%2i%2i%2i%2i%2i" Parameters:

• $1: Left edge coordinate (2 bytes, signed)
• $2: Top edge coordinate (2 bytes, signed)
• $3: Screen width in pixels (2 bytes, unsigned)
• $4: Screen height in pixels (2 bytes, unsigned)
• $5: Warp zone size (2 bytes, obsolete)
• $6: Mouse X position (2 bytes, signed)
• $7: Mouse Y position (2 bytes, signed)

Example:

Screen at (0,0), 1920x1080, mouse at (400,300)

"DINF\x00\x00\x00\x00\x07\x80\x04\x38\x00\x00\x01\x90\x01\x2C"

When to Send:

1. In response to kMsgQInfo query
2. When screen resolution changes
3. During initial connection setup

Resolution Change Protocol: When sending due to resolution change, the secondary should:

1. Send kMsgDInfo with new dimensions
2. Ignore kMsgDMouseMove until receiving kMsgCInfoAck
3. This prevents mouse movement outside the new screen area

See also

kMsgQInfo, kMsgCInfoAck

Since

Protocol version 1.0

kMsgDSetOptions

const char* const kMsgDSetOptions

extern

Set client options.

Message Code: "DSOP" Direction: Primary → Secondary Format: "DSOP%4I" Parameters:

• $1: Option/value pairs (4-byte integer list)

Example:

"DSOP\x00\x00\x00\x02\x00\x00\x00\x01\x00\x00\x00\x01\x00\x00\x00\x02\x00\x00\x00\x00"
2 pairs: option 1 = value 1, option 2 = value 0

Sets configuration options on the client. Options are sent as alternating option ID and value pairs. The client should apply these settings to modify its behavior.

See also

kMsgCResetOptions

Since

Protocol version 1.0