summaryrefslogtreecommitdiffstats
path: root/doc/kipi-plugins/slideshow.docbook
blob: bb0059ca873fdb922e4b3c5d4b20d4da01eb1574 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
<chapter id="slideshow">
<chapterinfo>

<title>The Advanced Slide Show</title>

<authorgroup>
    <author>
        <firstname>Gilles</firstname><surname>Caulier</surname>
        <affiliation><address><email>caulier_dot_gilles_at_free.fr</email></address></affiliation>
    </author>
    
    <author>
        <firstname>Gerhard</firstname><surname>Kulzer</surname>
        <affiliation><address><email>gerhard_at_kulzer.net</email></address></affiliation>
    </author>
</authorgroup>

<abstract>
<para>
The Kipi <quote>Advanced Slide Show</quote> plugin creates a configurable full screen slideshow of your images.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Kipi</keyword>
</keywordset>
</chapterinfo>

<title>Introduction</title>

<para>
With this Kipi-plugin you create a perfect slide show with 3 mouse clicks.
</para>

<sect1 id="using-plugin-slideshowsettings">
<title>The Settings Dialog</title>

<para>
Upon opening of the plugin from the host application the <emphasis>Advanced Slide Show</emphasis> window will appear asking questions as to how you want to stage your slideshow. You can choose between the selected images and all images in the same album.
</para>

<para>
The <guilabel>Use OpenGL Slideshow Transitions</guilabel> checkbox enables very smooth image transitions using the OpenGL display mode. Be sure to have OpenGL enabled on your graphics card, since otherwise the slideshow will be very slow.
</para>

<para>
The <guilabel>Print Filename</guilabel> checkbox enables the image filename to be displayed in the lower left corner.
</para>

<para>
The <guilabel>Loop</guilabel> checkbox enabled will run the whole show in an endless loop (until manually stopped with 
<keycombo><keycap>Esc</keycap></keycombo>). 
</para>

<para>
The <guilabel>Shuffle Image</guilabel> checkbox enables to display randomly the images (not using the current images collection order). 
</para>

<para>
The <guilabel>Delay Between Images</guilabel> may be set in millisecond steps. 1500 milliseconds correspond to 1.5 seconds and are a good default value. The best timing depends also a bit on your computer power and the transition effect. Try it out before you show it to your friends!
</para>

<para>
There are more than a dozen <guilabel>Transition Effects</guilabel> available which you can choose from. 
The <emphasis>Random</emphasis> selection will change the transition effect with every image.
</para>

<figure>
    <title>The Slideshow Dialog</title>
    <graphic srccredit="The Slideshow Dialog" fileref="slideshow_dialog.png"/>
</figure>

</sect1>

<sect1 id="using-plugin-slideshowinaction">
<title>Slide Show in Action</title>

<para>
During slideshow, user can access to a tool bar on the upper left screen corner. Move the mouse cursor to the top left of the screen for enable it.
</para>

<para>
With this tool bar, user can drive the progress, for pausing/playing slidesow, back to the preview image, go to the next image, and stoping slideshow.
</para>

<para>
On the lower left screen corner you can see the current image file name, the current image id on the slideshow, and the total number of images include in.
</para>

<figure>
    <title>The Advanced Slideshow Plugin in Action</title>
    <graphic srccredit="The Slideshow Plugin in Action" fileref="slideshow.png"/>
</figure>

</sect1>

</chapter>