Skip to content

Client

Jump to bottom
Noa Aarts edited this page Dec 11, 2024 · 1 revision

How to connect to flurry using a client

Flurry hosts pixelflut on port 7791 by default, once you're connected you automatically use the text protocol, this protocol is the default pixelflut protocol. Some other commands were added to support the extra functionality of flurry:

  • PROTOCOLS: returns the status of all the protocols active and inactive on the server.
  • PROTOCOL <protocol>: changes the tcp connection to use <protocol> instead
  • CANVAS <index>: Switch to editing the canvas at <index> instead (defaults to 0)

The other protocols

The other (non text) protocols are listed below, these are not always supported by the server.

Binary

If it's enabled you can access this protocol by sending PROTOCOL binary over the text protocol.

The protocol has similar functionality to text but all commands, coordinates and colors are encoded in binary to increase the information density.

The commands in this protocol are:

  • 104 (HELP): displays an help message.
  • 115 <canvas: u8> (SIZE): returns the size of the selected canvas using 2 u16 numbers.
  • 32 <canvas: u8> <x: u16> <y: u16> (PX): returns the color of the pixel at the selected location using 3 u8 numbers (r,g,b)
  • 128 <canvas:u8> <x: u16> <y: u16> <r: u8> <g: u8> <b: u8> (PX): sets the color of the pixel to the specified rgb value.
  • 129 <canvas:u8> <x: u16> <y: u16> <r: u8> <g: u8> <b: u8> <a: u8> (PX): blends the current color of the pixel with the new one according to <a>.
  • 130 <canvas:u8> <x: u16> <y: u16> <w: u8> (PX): sets the color of the pixel to the specified grayscale value.

Clone this wiki locally