PufferConnect

PufferConnect är en gloapp som låter en Pufferfish-enhet visa innehåll från ett externt insignal – och skicka touch-information till ett externt utdata. Den har inget gränssnitt; all konfiguration görs i en XML-fil.

Installation och start

På globen

1. Koppla dig till globen med webbläsaren och öppna PufferConsole.
2. Välj Advanced/Application Manager.
3. Tryck Upload och välj filen PufferConnect_X.X.zip (där X.X är versionsnumret).
4. Starta appen genom att trycka PufferConnect på konsolens startsida.
5. För autostart vid uppstart: sätt PufferConnect som Startup Application i Settings/Setup.

På utvecklings-PC

1. Packa upp PufferConnect_X.X.zip till en lämplig mapp.
2. Kör appen via tools\SideViewDeveloperMode.vbs i installationsmappen.

Konfiguration

Konfigurationsfilen ligger på globen:

C:\PufferConsole\resources\PufferConnect\ConnectConfiguration.xml

Så här redigeras den:

1. Se till att PufferConnect har startats minst en gång (vid start skapas filen om den saknas).
2. Koppla dig till globen via VNC (se PufferConsole).
3. Öppna ConnectConfiguration.xml i en textredigerare.
4. Starta om PufferConnect efter ändringar – annars gäller de inte.

Konfigurationsalternativ

Alternativ	Beskrivning
oscTxPort, oscTXAddress	Port och adress som OSC-meddelanden (rotation + touch) skickas till. Adressen kan vara samma PC (127.0.0.1) eller en annan.
inputType	Grundläggande inmatningstyp: camera, spout eller ndi.
cameraNumber	Vid camera: kameraindex relativt alla kameror på PC:n. Den rektangulära bildströmen dras ut över sfären.
spoutStream	Vid spout: Spout-ström som visas (dras ut över sfären). Bör vara 4096×2048 px, eller i alla fall 2:1-bildförhållande. Strömmen måste komma från den lokala PC:n.
ndiStream	Vid ndi: NDI-ström som visas (dras ut över sfären). Bör vara 4096×2048 px, eller i alla fall 2:1-bildförhållande.
verticalLock	true = globen kan roteras vänster/höger men inte upp/ner via touch.
horizontalLock	true = globen kan roteras upp/ner men inte vänster/höger. Båda satta stoppar touch-rotation helt.
rotationForwarding	true = OSC-meddelande skickas varje gång rotationen ändras (vid touch).
touchForwarding	true = OSC-meddelande skickas när globen röras.

OSC: Rotation

Adress: "Rotation" – skickas när sfärens rotation ändras.

Parameter	Typ	Område	Kommentar
lune	string	Lune 0, Lune 1 eller Lune 2	Vilken lune som rörts (alltid Lune 0)
x, y, z	float	–	Lunens aktuella rotation

OSC: Touch

Adress: "Touch" – för varje finger på globen skickas ett Begin-meddelande, en serie Update-meddelanden och ett End-meddelande. cursorID identifierar sekvensen; flera fingrar kan vara aktiva samtidigt.

Parameter	Typ	Område	Kommentar
eventType	string	Begin, Update eller End	–
cursorID	int	–	Unik ID för denna Begin–Update–End-sekvens
latitude	float	−90 till +90	Absolut position på sfären
longitude	float	−180 till +180	Absolut position på sfären
lune	string	Lune 0, Lune 1 eller Lune 2	Vilken lune som rörts
adjustedLatitude	float	−90 till +90	Position inom lunen med hänsyn till aktuell rotation
adjustedLongitude	float	−180 till +180	Position inom lunen med hänsyn till aktuell rotation

Stöd

För ytterligare hjälp: tech@pufferfishdisplays.com (PufferConnect User Guide v1.1).