[[Vorlage(Getestet, bionic, focal)]]

{{{#!vorlage Wissen
[:Packprogramme: Archive entpacken]
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:Programme_starten: Starten von Programmen]
[:Editor: Einen Editor verwenden]
}}}
[[Inhaltsverzeichnis(1)]]

[[Bild(pypong-icon.png, 48, align=left)]]
[bitbucket:donclark/pypong-clock:Pypong-Clock] {en} ist eine Vollbild-Uhr, geschrieben in Python, im Stile des Spieleklassikers [wikipedia:Pong:] von [wikipedia:Atari:]. Ursprünglich wurde das Programm für den Raspberry Pi entwickelt, es sollte sich aber auch auf anderen Computern problemlos verwenden lassen. Die Uhr ist schnell erklärt: Zu jeder vollen Stunde gewinnt die linke Seite, nach jeder verstrichenen Minute die rechte.

= Installation =
Das Programm ist kein Bestandteil der offiziellen Paketquellen. Es muss daher manuell installiert werden.

== Manuell ==
Der Quelltext des Programms muss bei [bitbucket:donclark/pypong-clock:Bitbucket] {dl} heruntergeladen werden - dies lässt sich am einfachsten mit folgendem Git-Befehl bewerkstelligen:  
{{{#!vorlage Befehl
git clone https://bitbucket.org/donclark/pypong-clock.git
}}}

Alternativ kann das Quelltext-Archiv auch per Browser heruntergeladen und danach entpackt [1] werden. 

Außerdem benötigt man das Python-Modul [http://www.pygame.org/ Pygame] {en}, das durch die Installation [2] des folgenden Pakets hinzugefügt werden kann:

{{{#!vorlage Paketinstallation
python-pygame, universe
}}} 

== Ubuntu 20.04 ==
Pypong-Clock basiert auf Python 2, welches unter Ubuntu 20.04 ([:Focal_Fossa:]) standardmäßig nicht mehr mitgeliefert wird. Es kann aber durch folgenden Befehl nachinstalliert werden:
{{{#!vorlage Paketinstallation
python2, universe
}}} 

= Verwendung =
[[Vorlage(Bildunterschrift, pong.png, 175, "Pypong-Clock", right)]]
Wurde alles korrekt vorbereitet, öffnet man ein Terminalfenster [3] und  wechselt in das beim Entpacken entstandene Verzeichnis. Nun startet [4] man das Programm durch den Befehl:

{{{#!vorlage Befehl
python2 pypong-clock.py
}}}
Es gilt zu beachten, dass der Spielstand (Uhrzeit) bei 00:00 beginnt und so lange hochgezählt wird, bis er mit der Systemzeit übereinstimmt, was evtl. ein paar Minuten dauern kann. Erst danach kann die Uhrzeit abgelesen werden. Beendet wird die Uhr durch das Drücken einer beliebigen Taste. 

== Programmstart ==
Um das Programm komfortabel durch einen [:ln:Symlink] starten zu können, muss es ausführbar gemacht werden:

{{{#!vorlage Befehl
chmod +x pypong-clock.py
}}}
Dann kann man sich einen Symlink z.B. im Ordner '''~/bin''' im [:Homeverzeichnis:] anlegen:

{{{#!vorlage Befehl
mkdir ~/bin
ln -s /PFAD/ZU/pypong-clock.py ~/bin/pypong
}}}
Nun über den Aufruf von `pypong` die Uhr starten. 

== Aussehen ==
Das Programm kann durch Editieren [5] der Datei '''pypong-clock.py'''  an die eigenen Bedürfnisse angepasst werden. Hier lässt sich beispielsweise die Auflösung des eigenen Bildschirms angeben oder die RGB-Farbe des Spielfeldes. Alle belegbaren Variablen findet man im [https://bitbucket.org/donclark/pypong-clock/wiki/Useful%20Settings%20to%20Control%20the%20Display Wiki der Projektseite] {en}. Folgende Tabelle bietet einige Beispiele.

{{{#!vorlage Tabelle
<-2 rowclass="titel"> Beispiele
+++
<rowclass="kopf" >Belegte Variablen
Funktion
+++
`RESOLUTION = (1024, 600)`
Bildschirmauflösung
+++
`WHITE = (255, 255, 255)`
RGB-Vordergrundfarbe
+++
`BLACK = (0, 0, 0)`
RGB-Spielfeldfarbe 
+++
`PADDLE_HEIGHT = 60`
Höhe des Torwarts in Pixeln
+++
`PADDLE_WIDTH = 14`
Breite des Torwarts in Pixeln
+++
`BALL_WIDTH = 28`
Breite des Spielballs
+++
`BALL_HEIGHT = 28`
Höhe des Spielballs
}}}

= Links =
 * [bitbucket:donclark/pypong-clock:Projektseite] {en}
 * [http://www.raspberrypi.org/archives/4473 Vorstellung auf raspberrypi.org] {en}
 * [youtube:c4_0Fo_beaU:Pypong-Clock auf einem Raspberry Pi] - Video
 * [:Easter_Eggs:] {Übersicht} Übersichtsartikel

#tag: Shell, Gimmick