libetherpix

1) EtherPix library

2) 

3) EtherPix is a large scale display architecture that is driven using UDP/IP.

4) It consists of single pixels that are connected to chains. A number of those
5) pixel chains is then connected to a so called distributor module that
6) receives data over ethernet and distributes it to the pixel chains.
7) 
8) The protocol used on UDP is MCUF (microcontroller unit frame, see
9) http://wiki.blinkenarea.org/index.php/MicroControllerUnitFrame). However,

10) as EtherPix displays can have more than 65536 pixels, multiple MCUF packets

11) are sent for one frame - a single MCUF frame to every distributor.
12) The coordinates of the pixels in the MCUF packets do not correspond to pixel
13) locations, but to pixel addresses. The y coordinate is the number of the
14) output of the distributor and the x coordinate is the number of the pixel
15) in the chain. The number of channels is always 3 (RGB) and the maximum value
16) is always 255 (8 bit per channel).
17) 

18) This library can be used to send the required UDP packets to the EtherPix

19) display to make it show images and/or videos.
20) As the libarary has to know how the pixels are wired and where there are
21) located (i.e. which pixel in the source image they represent), a rather
22) complex config file is needed. Examples of config files can be found in
23) "examples/config" and example code showing how to use the library is
24) located in "examples/src".
25)