raAPP Photo ermöglicht die automatische Einlesung von Bildern im .jpg- und Videosequenzen im .mp4-Format. Einlesen bedeutet in raAPP Photo nur die Dateiinformation wie Pfad und Dateiname einlesen, die eigentliche Bild/Videodatei bleibt im Dateiverzeichnis unverändert auf der Festplatte. Eine vorherige Anpassung der Bildgröße auf die Anzeigegröße ist nicht notwendig und wird von raAPP Photo zur Laufzeit durchgeführt. Videosequenzen aus den Formaten .mts und .avi können mit dem Videokonverter in .mp4 mit h.264 Codec umgewandelt werden.

Die eingelesenen Bilder/Videos können wie im klassischen Papierbilderbuch beschrieben und zusätzlich mit Personenangaben versehen werden. Bis zu 4 Personennamen können vordefiniert werden, dadurch ist die Eingabe und Suche z.B.: nach Familienangehörigen sehr schnell und einfach möglich.
Nach allen eingegebenen Informationen kann gesucht werden. Das Suchergebnis kann manuell oder automatisch mit dem Bilderplayer angezeigt werden.

Die Anzeige der Bilder und Videos erfolgt im Browser. Dadurch ist es möglich raAPP Photo im Netzwerk auf verschiedenen Geräten anzuzeigen, z.B.: auf dem TV-Grät.

Die Bilder im Verzeichnis auf dem Datenträger sollten idealerweise sortierbare aufsteigende Buchstaben-Zahlenkombinationen als Dateiname haben. Heutige Digitalkameras liefern das in der Regel.

Zu Sicherungszwecken kann eine Kopie der Datenbank erzeugt werden.

raAPP Photo rufen Sie mit der URL  http://'Webserverroot'/raapp/photo auf.
Beipielsweise in einer lokalen Installation mit http://localhost/raapp/photo
Auf Windows Systemen mit http://localhost:81/raapp/photo.

In der folgenden Beschreibung finden Sie die einzelnen Funktionen und Ihre Bedienung nochmal genauer beschrieben.
Viel Spaß mit raAPP Photo.

Inhaltsverzeichnis:

1. Bedienelemente
2. Dateistruktur für Bilddateien
3. Bilddateien einlesen
4. Bildverzeichnis löschen
5. Inhalte bearbeiten
6. Bilder anzeigen
7. Privat Modus
8. Bilderplayer
9. Bilder suchen
10. Video konvertieren
11. HTML-Seiten erzeugen
12. HTML-Seiten löschen
13. Verwaltung und Konfiguration
14. Systemvoraussetzungen 
15. Installation
     

Bedienelemente:


Dateistruktur für Bild- und Videodateien:

Grundsätzlich ist folgende Verzeichnisstruktur zu verwenden um die Funktion von raAPP Photo sicherzustellen:
        ../Webserverrootverzeichnis/raapp/photo/Verzeichnis1/Verzeichnis2/Bilddatei

Beispiel:

Ihr Webserverrootverzeichnis liegt auf Ihrer Festplatte unter           D:\meinWebserver
Ihr Verzeichnis 1 heist                                                                         Jahr2007
Ihr Verzeichnis 2 heist                                                                        UrlaubSchwarzwald

kopieren sie Ihre Bilddateien unter D:/meinWebserver/raapp/photo/Jahr2007/UrlaubSchwarzwald

Bild- und Videodateien einlesen:

über das Symbol der Startseite starten Sie den Dialog zum einlesen der auf der Festplatte abgespeicherten Bild- und Videoinformationen in die Datenbank.
Bitte geben Sie den kompletten Verzeichnispfad zu den Dateien ein, oder wählen Sie Ihn über die Funktion durchsuchen aus.
Bei Unix-Systemen ist darauf zu achten, daß ausreichende Zugriffsrechte für den Zugriff auf die Dateien durch raAPP Photo vorhanden sind.

Beispiel:    D:/meinWebserver/raapp/photo/Jahr2007/UrlaubSchwarzwald

Standardmäßig wird das durch Digitalkameras in der Bilddatei als EXIF-Information hinterlegte Datum ausgelesen und in der Datenbank gespeichert.
Zusätzlich können Sie Tag.Monat.Jahr auch manuell eingeben. Diese Information wird dann bei jedem Bild voreingestellt.
Es ist auch möglich nur das Jahr oder den Monat und das Jahr einzugeben.

Bei erfolgreichem Einlesevorgang wird die Summe der Eingelesenen Bilder angezeigt.
Mit gelangen Sie wieder zurück zur Startseite.

Es ist jederzeit möglich zusätzliche Bilder in einem bereits bestehenden Verzeichnis zuzufügen.
Dies wird automatisch vom System erkannt.

Verzeichnis löschen:

über das Symbol der Startseite starten Sie den Dialog zum löschen der Bild- und Videoinformationen aus der Datenbank.
Navigieren Sie mit durch das Verzeichnis 1 und wählen Sie das zu löschende Verzeichnis mit aus.
Anschließend können Sie löschen oder abbrechen.

Das Verzeichnis auf der Festplatte mit den Bildern und Videos bleibt erhalten.

Inhalte bearbeiten:

Starten Sie den Bearbeitungsmodus mit auf der Startseite

Verzeichnisebene2 bearbeiten:
Navigieren Sie mit durch das Verzeichnis 1  zum Verzeichnis 2.
Starten Sie den Bearbeitungsmodus mit
Sie haben die Möglichkeit den Verzeichnisname sowie den Zeitraum zu bearbeiten.

Mit gelangen Sie wieder zurück zum Verzeichnis.

Bildinformation bearbeiten:
Navigieren Sie mit durch das Verzeichnis 1 und Verzeichnis 2 zu den Bilddateien.
Navigieren Sie zum gewünschten Bild und fügen Sie Ihre Informationen in die Formularfelder ein.
Anschliesend durch drücken der ändern-Taste die Daten übernehmen.

Personen können durch Eingabe eines Namens gesucht werden, bekannte Personen werden in einer Auswahlliste zur Übernahme in das Personenfeld angebten. Bei manueller Eingabe bitte die Personen durch ',' trennen.

Beispiel: Vorname1 Nachname, Vorname2 Nachname, usw.

Mit wird das Bild in das Export-Verzeichnis exportiert.

Mit und können Sie das Bild jeweils um 90 Grad  in die entsprechende Richtung drehen.

Mit und kann die Anzeigenreihenfolge der Bilder eingestellt werden.

Zusätzlich steht Ihnen die Funktion Bild Löschen zur Verfügung.
Dabei besteht die Möglichkeit die Bildinformationen komplett aus der Datenbank zu löschen.
Fals gewünscht wird auch die Bilddatei auf der Festplatte gelöscht.

Bilder und Videos anzeigen:

Starten Sie den Anzeigemodus mit auf der Startseite und navigieren Sie bis zum entsprechenden Bildverzeichnis.
Mit den Navigationsbuttons können Sie zum gewünschten Bild/Video Navigieren.

    zum ersten Bild
    ein Bild zurück
    ein Bild weiter
    zum letzten Bild

Die in der Datenbank gespeicherten Textinformationen werden Ihnen am rechten Rand angezeigt.

Bei der Anzeige von Bildern kann über einen Klick auf die Bildfläche oben rechts das Bild auf die ganze Seite expandiert werden. Über Klick auf die Bildfläche oben links wieder auf Normalgröße eingestellt werden. Ebenso ist die Navigation ein Bild weiter oder ein Bild zurück über die Bildflächen mitte links und rechts möglich. Bildfläche rechts und links unten Navigieren jeweils zum ersten oder letzten Bild.

    zur Kartenansicht

Bei der Anzeige von Bildern mit integrierten Geodaten wird der Button zum Umschalten auf die Kartenansicht angeboten.
Die Karte wird angezeigt der Aufnahmeort durch einen Marker dargestellt.
Mit wird die Kartenansicht verlassen und das Bild angezeigt

Privat Modus:

Der Privatmodus kann über die Buttons und ein und ausgeschaltet werden.
Es werden nur Bilder angezeigt die nicht als privat in der Datenbank gekennzeichnet sind.

Die Eigenschaft privat ist für jedes Bild im Bearbeitungsmodus festzulegen.

Bilderplayer:

Starten Sie den Bilderplayer mit
Mit dem Bilderplayer können Sie ganze Verzeichnisse oder über die Suchfunktion ermittelte Bilddateien automatisch abspielen.

    schneller anzeigen
    langsamer anzeigen

Der Bilderplayer läuft unendlich und kann über oder beendet werden.

Bilder suchen

Starten Sie die Suchfunktion mit
Mit wird eine alphabetische Liste aller in der Datenbank enthaltenen Personen angezeit.
Mit wird die Liste nach Vornamen sortiert.
Mit wird die Liste nach Nachnamen sortiert.

Durch anklicken eines Namens werden alle zugehörigen Bilder angezeigt

Das Suchformular bietet vielfältige Möglichkeiten zur Suche.

Formularfeld	Beschreibung
Suchwort für Verzeichnis	hier können Sie eine Suchwort für die Verzeichnisebene2 eingeben das Suchwort kann auch nur Teile des Begriffes enthalten Beispiel: Urlau    findet das Verzeichnis Urlaub
Tag	Beispiel: 5 oder 05
Monat	Beispiel: 6 oder 06
Jahr	Beispiel: 2007 oder 07
Personen	folgende Suchbegriffe sind möglich: 'Name' findet alle Bilder bei denen Name enthalten ist 'Name1 und Name1' findet alle Bilder bei denen sowohl Name1 als auch Name 2 vorhanden ist 'Name1 oder Name2' findet alle Bilder bei denen Name1 oder Name 2 vorhanden ist Das Ganze kann auch mit mehreren Namen kombiniert werden 'Name1 und Name2 und Name3 ...'
Bildbeschreibung	gleiche Vorgehensweise wie bei weitere Personen

Alle Felder bei denen keine Suchbedingung eingefügt werden kann gilt automatisch die Suchbedingung und.

Beispiele:

Sie suchen Urlaubsbilder mit Ihrem Freund Klaus Muster:
    als Suchwort für Verzeichnis geben Sie Urlaub ein, bei Personen auswählen Klaus Muster

Sie suchen Bilder aus dem Jahr 2007 bei dem Name1 oder Name 2 enthalten ist:
    im Feld Jahr geben Sie 2007 ein bei Personen Name 1 auswählen Button oder drücken und Name 2 wählen

Am besten Sie probieren die Möglichkeiten aus.
Bedenken Sie, je mehr Einschränkungen Sie im Suchformular vornehmen, desto weniger Bilder bzw. keine Bilder werden gefunden.

Videos konvertieren:

Starten Sie die Videokonertierung mit auf der Startseite.
Nach Auswahl der Videodatei kann im Formular die Anzeigegröße sowie das Zielformat ausgewählt werden.
Als Zielformat steht .mp4, .flv, .avi, .wmv zur Verfügung.
Standardzielformat ist .mp4 als Container mit h.264 Videocodec und AAC Audio Codec.
Die Darstellung von Videos ist abhängig von den Fähigkeiten des verwendeten Browsers. Die beste Browser-Kompatibilitätet wird mit dem Standardzielformat erreicht.
Je nach Leistung des verwendeten Rechners kann eine Konvertierung sehr lange dauern.
Die Konvertierung erfolgt durch ffmpeg. Die ffmpeg Parameter können in der Verwaltung individuell angepasst werden.

Verwaltung und Konfiguration:

Starten Sie die Verwaltung und Konfiguration mit auf der Startseite.

Wurde bei der Installation die Funktion Benutzerlogin mit Passwort ausgewählt wird Ihnen im Submenü über den Button die Möglichkeit angeboten Benutzer zu verwalten. Es könen die Benutzerarten Admin, Benutzer und eingeschränkter Benutzer angelegt werden. Die vergebenen Passwörter werden in der Datenbank verschlüsselt abgelegt. Bei der Installation wird automatisch ein Benutzer mit dem Benutzernamen kontakt@raapp.de und dem Passwort 12345 angelegt. Es wird empfohlen nach der Installation einen oder mehrere eigene Admin Benutzer anzulegen und dann den Benutzer kontakt@raapp.de zu löschen.

Die Konfiguration der Basisparameter ist im Submenü über erreichbar.
Die Konfigurationsparamter sind mit Defaultwerten vorbelegt und können individuell angepasst werden.
Insgesamt können 4 Namen vordefiniert werden. Zusätzlich sollte zu jedem Namen ein Bild im Format .jpg hinterlegt werden.

Mit können Änderungen abgespeichert werden.
Mit können die Default-Werte wieder geladen werden.

Eine Kopie der Datenbank kann über das Submenü mit gestartet werden.
Die Kopie befindet sich anschließend im Verzeichenis ../meinwebserver/raapp/db_export und kann über die Import Funktion wieder eingelesen werden.

Prüfen auf Update bietet fals verfügbar die automatische Installation des Update an.
Die Scriptdateien der aktuellen Installation werden vor dem Update in das Verzeichnis ../meinwebserver/raapp/photo/bin/update gesichert.

Sollte das automatische Update aus welchen Grüden auch immer scheitern, kann das Update jederzeit auch manuell durchgeführt werden.

manuelles Update:
Für den manuellen Update wird das raAPP Photo Standardpaket genutzt, das unter https://www.raapp.de/photo_downl.php zum download zur Verfügung steht.
Ein manuelles Update wird durch einfaches kopieren der Dateien in das Verzeichnis ../meinwebserver/raapp/photo durchgeführt.
Nachdem die Dateien kopiert sind im Browser die URL ../meinwebserver/raapp/photo/bin/verwaltung.php?sw=11 aufrufen um das Update zu finalisieren.

!!! Achtung !!! Das Update auf Version 3.1 ist grundsätzlich manuell durchzuführen, da der Updateprozess völlig neu entwickelt wurde.

Systemvoraussetzungen:

Apache Webserver
MySQL- oder MariaDB- Datenbank
PHP5 oder PHP7

Die Videokonvertierung basiert auf FFmpeg http://www.FFmpeg.org

Installation:

Installation Ready to Run Paket für Windows

Download Paket entpacken und Inhalt in das Wurzelverzeichnis der Festplatte kopieren. Im Dateimanager in das Verzeichnis xampp wechseln und die Datei xampp_control.exe mit rechter Maustauste als Administrator starten. Beim erstmaligen Start von XAMPP meldet sich die Windows Firewall. Hier bitte den Zugriff über das Netzwerk erlauben. Im XAMPP Controlcenter Apache und mysql starten. Browser starten und raAPP photo mit http://localhost:81/raapp/photo aufrufen und nutzen.

Installation Standardpaket

Der einfachste Weg eine Datenbank und einen Apache Server unter Windows zu installieren ist die XAMPP Distribution von Apachefriends zu verwenden. Download hier
Die Videokonvertierung erfordert unter Windows die COM-Klasse in PHP. In Datei xampp/php/php.ini prüfen ob die Zeile "extension=php_com_dotnet.dll" enthalten ist, fals nicht einfach mit dem Windows Standard Editor das Statement am Ende der Datei ergänzen.

Für Linux Systeme empfehlen wir auf die durch die Distributionen bereitgestellten Pakete für Apache und Mysql zurückzugreifen.

Die Installation von Apache Webserver, PHP und Datenbank ist identisch zur Installation von raAPP Kasse Server und kann dort im Manual für die Plattformen Windows und Ubuntu nachgelesen werden.
Die Videotutorials gibt es hier für Windows für Ubuntu .
Zur Verwaltung der Datenbank empfehlen wir phpMyAdmin, das in der XAMPP Distribution bereits enthalten ist, Installation unter Ubuntu einfach unter raAPP Kasse Server nachlesen.

Fals noch nicht vorhanden eine Datenbank mit dem Namen raapp mittels phpMyAdmin anlegen.

Anschließend im Apache root-Verzeichnis einen Ordner raapp anlegen und die Dateien aus dem raAPP Photo Paket in den Ordner kopieren. Auch hier ist der Installationsvorgang analog raAPP Kasse Server und kann dort für die jeweilige Plattform nachgelesen werden. Nachdem die Dateien kopiert sind das Bilderbuch mittels der URL http://localhost/raapp/photo starten.

Nach Eingabe einiger Parameter erfolgt eine automatische Installation bei der die Datenbanktabellen angelegt werden, anschließend steht raAPP Photo zur Benutzung bereit.

© www.raAPP.de 2018