[Pictureviewer2.git] / README.md

## Pictureviewer 

Pictureviewer is a javascript to make use of a web browser to view pictures in the sequence they were taken. Titels can be added to the display. Also other elements can be shown, such as headers, text, videos or PDF-documents.

This is version 2 of this program.

### Files

* SoPi: This script creates the file PictureList.txt. It sorts the pictures by the time they were taken (analysing the EXIF data) or if this is missing by the date of the file. An examplary file is *PictureList_Template.txt.
* PictureList_Template: examplary file of PictureList
* PictureList.txt: not included, generated by SoPi. This file contains the list of pictures etc. including titles.
* Pictureviewer.html: html file to use in a web browser to see the pictures. 
* Pictureviewer.css: css file for the pictures etc.
* Fotos: directory were the pictures are stored by default
    * ENDE.bmp: it is a good idea to have an ending picture. This one is just black
* LICENSE: GNU GPL V3
* README.md: this file 

### usage of Pictureviewer.html

* keys:
    * HOME/POS1: jump to first picture
    * ENDE: jump to last picture 
    * "a" or "r": reload picture 
    * "v", "n", "PageDown", "ArrowDown": next picture
    * "b", "z", "PageUp", "ArrowUp": back one picture
    * "0".."9": see below
    * "g": go to the picture which number was entered before
    * "+": go ahead the number of pictures entered before
    * "-": go backward the number of pictures entered before
    * "x": close window
  
* mouse actions:
    * click in the left part of the image: go back 1 picture
    * click in the right part of the image: show next picture 
    * hover with the mouse over the image to show the title 
  
### hints

Usefull add-ins to the browser are

* EXIF viewer: to view details of the picture
* image zoomer: to zoom in
Commit	Line	Data
7bb60213	1	## Pictureviewer
	2
	3	Pictureviewer is a javascript to make use of a web browser to view pictures in the sequence they were taken. Titels can be added to the display. Also other elements can be shown, such as headers, text, videos or PDF-documents.
	4
	5	This is version 2 of this program.
	6
	7	### Files
	8
	9	* SoPi: This script creates the file PictureList.txt. It sorts the pictures by the time they were taken (analysing the EXIF data) or if this is missing by the date of the file. An examplary file is *PictureList_Template.txt.
	10	* PictureList_Template: examplary file of PictureList
	11	* PictureList.txt: not included, generated by SoPi. This file contains the list of pictures etc. including titles.
	12	* Pictureviewer.html: html file to use in a web browser to see the pictures.
	13	* Pictureviewer.css: css file for the pictures etc.
	14	* Fotos: directory were the pictures are stored by default
	15	* ENDE.bmp: it is a good idea to have an ending picture. This one is just black
	16	* LICENSE: GNU GPL V3
	17	* README.md: this file
	18
	19	### usage of Pictureviewer.html
	20
	21	* keys:
	22	* HOME/POS1: jump to first picture
	23	* ENDE: jump to last picture
	24	* "a" or "r": reload picture
	25	* "v", "n", "PageDown", "ArrowDown": next picture
	26	* "b", "z", "PageUp", "ArrowUp": back one picture
	27	* "0".."9": see below
	28	* "g": go to the picture which number was entered before
	29	* "+": go ahead the number of pictures entered before
	30	* "-": go backward the number of pictures entered before
	31	* "x": close window
	32
	33	* mouse actions:
	34	* click in the left part of the image: go back 1 picture
	35	* click in the right part of the image: show next picture
	36	* hover with the mouse over the image to show the title
	37
	38	### hints
	39
	40	Usefull add-ins to the browser are
	41
	42	* EXIF viewer: to view details of the picture
	43	* image zoomer: to zoom in