summaryrefslogtreecommitdiff
path: root/help/C/index.docbook
blob: 9f07def603b18eeefd0c521a55efc424af989220 (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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
<?xml version="1.0" encoding="utf-8"?>
<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->
<?db.chunk.max_depth 2?>
<article xmlns="http://docbook.org/ns/docbook"
         xmlns:db="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         version="5.0" xml:id="index" xml:lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <info>
    <title>Image Viewer Manual</title>

    <copyright>
      <year>2019</year>
      <holder>MATE Documentation Project</holder>
    </copyright>
    <copyright> 
      <year>2006</year> 
      <year>2007</year>
      <holder>GNOME Documentation Project</holder>
    </copyright>
    <copyright> 
      <year>2002</year> 
      <year>2003</year> 
      <year>2004</year> 
      <holder>Sun Microsystems</holder> 
    </copyright> 
    <copyright> 
      <year>2000</year> 
      <holder>Eliot Landrum</holder> 
    </copyright>
    <copyright> 
      <year>2000</year> 
      <holder>The Free Software Foundation</holder> 
    </copyright>	 

<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher role="maintainer"> 
      <publishername> MATE Documentation Project </publishername> 
    </publisher> 
    <publisher>
      <publishername> GNOME Documentation Project </publishername>
    </publisher>

   <xi:include href="legal.xml"/>
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

   <authorgroup>
       <author>
           <orgname>MATE Documentation Project</orgname>
           <affiliation>
               <orgname>MATE Desktop</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Jens</firstname>
               <surname>Finke</surname>
           </personname>
           <affiliation>
               <orgname>GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Angela</firstname>
               <surname>Boyle</surname>
           </personname>
           <affiliation>
               <orgname>GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Stuart</firstname>
               <surname>Ellis</surname>
           </personname>
           <affiliation>
               <orgname>GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Sun</firstname>
               <surname>GNOME Documentation Team</surname>
           </personname>
           <affiliation>
               <orgname>Sun Microsystems</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Eliot</firstname>
               <surname>Landrum</surname>
           </personname>
           <affiliation>
               <orgname>GNOME Documentation Project</orgname>
           </affiliation>
       </author>
       <author>
           <personname>
               <firstname>Federico</firstname>
               <surname>Mena Quintero</surname>
           </personname>
           <affiliation>
               <orgname>GNOME Documentation Project</orgname>
           </affiliation>
       </author>	
   </authorgroup>
 
    <revhistory>
    <revision> 
		<revnumber>2.9</revnumber>
		<date>July 2015</date>
		<revdescription> 
	  		<para role="author">MATE Documentation Project</para>
	  		<para role="publisher">MATE Documentation Project</para>
		</revdescription> 
    </revision> 
    <revision>
		<revnumber>2.8</revnumber>
		<date>February 2007</date>
		<revdescription>
		    <para role="author">GNOME Documentation Project</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision>
		<revnumber>2.7</revnumber>
		<date>February 2004</date>
		<revdescription>
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription>
    </revision>
    <revision> 
		<revnumber>2.6</revnumber>
		<date>November 2003</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>2.5</revnumber>
		<date>September 2003</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>2.4</revnumber>
		<date>January 2003</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>2.3</revnumber>
		<date>October 2002</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>2.2</revnumber>
		<date>August 2002</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision>
    <revision> 
		<revnumber>2.1</revnumber>
		<date>July 2002</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision> 
    <revision> 
		<revnumber>2.0</revnumber>
		<date>May 2002</date> 
		<revdescription> 
		    <para role="author">Sun GNOME Documentation Team</para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
    </revision> 
    <revision> 
		<revnumber>1.0</revnumber>
		<date>2000</date> 
		<revdescription> 
		    <para role="author">Eliot Landrum
	    		  <email>eliot@landrum.cx</email>
		    </para>
		    <para role="author">Federico Mena Quintero
	    		  <email>federico@gnu.org</email>
		    </para>
		    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
      </revision> 
    </revhistory> 
    <releaseinfo>This manual describes version 1.22 of Image Viewer.
    </releaseinfo>
  </info>

  <indexterm>
    <primary>Eye of MATE</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->

<!-- ============= Introduction ============================== -->
<section xml:id="eom-introduction"><info><title>Introduction</title></info>
  
  <para>The <application>Eye of MATE Image Viewer</application>
  application enables you to view single image files, as well as large image collections.
  </para>

  <section xml:id="eom-tostartapp"><info><title>Starting Image Viewer</title></info>
    
    <para>You can start <application>Image Viewer</application> in the following ways:</para>
    <itemizedlist>
      <listitem>
        <para>Open an image file in <application>Caja</application>.</para>
      </listitem>
      <listitem>
	<para>Choose <menuchoice><guimenu>Graphics</guimenu>
	<guimenuitem>Image Viewer</guimenuitem></menuchoice>
	from the <guimenu>Applications</guimenu> menu.</para>
      </listitem>
      <listitem>
	<para>Run <command>eom</command> at the prompt in a terminal
	such as <application>mate-terminal</application>, or from the
	<application>Run Application</application> dialog.</para>
      </listitem>
    </itemizedlist>
  </section>

  <section xml:id="eom-closeapp"><info><title>Closing Image Viewer</title></info>
    
    <para>To close the current <application>Image Viewer</application> window choose <menuchoice><guimenu>Image</guimenu>
    <guimenuitem>Close</guimenuitem></menuchoice>, or press
    <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>.</para>
  </section>

  <section xml:id="eom-filetypes"><info><title>Supported File Types</title></info>
    
    <para><application>Image Viewer</application> supports a variety of image file formats. The following image formats can be opened:</para>
		<itemizedlist>
			<listitem><para>ANI - Animation</para>
			</listitem>
			<listitem><para>BMP - Windows Bitmap</para>
			</listitem>
			<listitem><para>GIF - Graphics Interchange Format</para>
			</listitem>
			<listitem><para>ICO - Windows Icon</para>
			</listitem>
			<listitem><para>JPEG - Joint Photographic Experts Group</para>
			</listitem>
			<listitem><para>PCX - PC Paintbrush </para>
			</listitem>
			<listitem><para>PNG - Portable Network Graphics </para>
			</listitem>
			<listitem><para>PNM - Portable Anymap from the PPM Toolkit</para>
			</listitem>
			<listitem><para>RAS - Sun Raster </para>
			</listitem>
			<listitem><para>SVG - Scalable Vector Graphics </para>
			</listitem>
			<listitem><para>TGA - Targa</para>
			</listitem>
			<listitem><para>TIFF - Tagged Image File Format</para>
			</listitem>
			<listitem><para>WBMP - Wireless Bitmap</para>
			</listitem>
			<listitem><para>XBM - X Bitmap</para>
			</listitem>
			<listitem><para>XPM - X Pixmap</para>
			</listitem>
		</itemizedlist>

  <para><application>Image Viewer</application> supports the following formats for saving:</para>
		<itemizedlist>
			<listitem><para>BMP - Windows Bitmap</para>
			</listitem>
			<listitem><para>ICO - Windows Icon</para>
			</listitem>
			<listitem><para>JPEG - Joint Photographic Experts Group</para>
			</listitem>
			<listitem><para>PNG - Portable Network Graphics </para>
			</listitem>
		</itemizedlist>
		<para><application>Image Viewer</application> may be able to open and save other image formats, depending on your system configuration and other installed software.</para>
  </section>

  <section xml:id="eom-features"><info><title>Image Viewer Features</title></info>
    
    <para><application>Image Viewer</application> has a variety of features to help you view your images.
    You can zoom in and out or view the image full screen. Regardless of
    your zoom level, <application>Image Viewer</application> uses a low amount of memory. You can also
    rotate and flip the image you are viewing.</para>

    <para>The collection view allows the viewing and editing of large
    image collections. In this view image operations can be applied
    to all selected images at once. </para>

    <para><application>Image Viewer</application> has special support for digital camera pictures and
    displays EXIF metadata recorded with the image. This feature
    requires <systemitem class="library">libexif</systemitem> to be
    installed on your system. All modifications made in JPEG images 
    are lossless. That is, saving rotated and flipped JPEG images 
    will not recompress the image. Beside this all available metadata 
    (like EXIF) will be preserved and updated accordingly. </para>
  </section>
</section>

<!--============== When You Start ===========-->
<section xml:id="eom-whenyoustart"><info><title>Getting Started</title></info>
  
  <para>When you start <application>Image Viewer</application>, the following window is displayed:</para>
  <figure xml:id="mainwindow-fig"><info><title>Image Viewer Start Up Window</title></info>
		
		<screenshot>
		  <mediaobject>
		    <imageobject>
		      <imagedata fileref="figures/eom_start_window.png" format="PNG"/>
		    </imageobject>
		    <textobject>
		      <phrase>Shows <application>Image Viewer</application> main window. Contains titlebar, menubar, toolbar, and display area. Menubar contains File, Edit, View, and Help menus.</phrase>
		    </textobject>
		  </mediaobject>
		</screenshot>
  </figure>
  <para>The <application>Image Viewer</application> window contains the following elements:</para>
  <variablelist>
	<varlistentry>
  	  <term>Menubar</term>
 	  <listitem>
	    <para>The menus on the menubar contain all the commands that you need to work with images in <application>Image Viewer</application>.</para>
	  </listitem>
 	</varlistentry>
	<varlistentry>
	  <term>Toolbar</term>
	  <listitem>
	    <para>The toolbar contains a subset of the commands that you can access from the menubar. To show or hide the toolbar, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Toolbar</guimenuitem></menuchoice>.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Display area</term>
	  <listitem>
 	    <para>The display area shows the image file.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Statusbar</term>
	  <listitem>
	    <para>The statusbar provides information about the image. To show or hide the statusbar, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Statusbar</guimenuitem></menuchoice>.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Image Collection</term>
	  <listitem>
	    <para>The image collection shows you all supported images in the current working directory. It shows up once an image has been loaded. To show or hide the collection, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Image Collection</guimenuitem></menuchoice> or press <keycap>F9</keycap>.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Image Information Pane</term>
	  <listitem>
	    <para>The image information pane provides further information about the current image, for example EXIF metadata (if available). It shows up after an image has been loaded. To show or hide the image information pane, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Image Information</guimenuitem></menuchoice> or press <keycombo><keycap>Ctrl</keycap><keycap>I</keycap></keycombo>.</para>
	  </listitem>
	</varlistentry>
  </variablelist>
  <para>Most actions in <application>Image Viewer</application> can be performed several ways.  For example,
  you can open a file in the following ways:</para>
  <itemizedlist>
    <listitem><para>Drag an image file into the <application>Image Viewer</application> window from another
    application or window.</para></listitem>
    <listitem><para>Double-click on an image file in the file manager
    or other application.</para></listitem>
    <listitem><para>Choose <menuchoice><guimenu>Image</guimenu>
    <guimenuitem>Open</guimenuitem></menuchoice> and select an image file
    in the <application>Load Image</application> dialog.</para></listitem>
    <listitem><para>Press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap>
    </keycombo> and select an image file in the <application>Load
    Image</application> dialog.</para></listitem>
  </itemizedlist>
</section>


<!-- ============= Viewing Images ============================== -->
<section xml:id="eom-view"><info><title>Viewing Images</title></info>
	

	<!--=========== To Open an Image ============================= -->
	<section xml:id="eom-open-image"><info><title>Opening an Image</title></info>
		
                <para>To open an image, perform the following steps:</para>
                <orderedlist inheritnum="ignore" continuation="restarts">
                  <listitem>
                    <para>
                      Choose <menuchoice> <guimenu>Image</guimenu><guimenuitem>Open</guimenuitem> </menuchoice>, or press <keycombo> <keycap>Ctrl</keycap><keycap>O</keycap> </keycombo>.  </para>
                  </listitem>
                  <listitem>
                    <para>
                      In the <guilabel>Open Image</guilabel> dialog, select the file you want to open.
                    </para>
                  </listitem>
                  <listitem>
                    <para>
                      Click <guibutton>Open</guibutton>. <application>Image Viewer</application> displays the name of the image file in the titlebar of the window.
                    </para>
                  </listitem>
                </orderedlist>
                <para> 
	          To open another image, choose <menuchoice> <guimenu>Image</guimenu><guimenuitem>Open</guimenuitem> </menuchoice> again. <application>Image Viewer</application> opens each image in a new window.
                </para>
	</section>

	<!--=========== To View the Images in a Directory ==================== -->
	<section xml:id="eom-open-folder"><info><title>Viewing the Images in a Folder</title></info>
		
		<para>To view all images in a folder, perform the following steps:</para>
                <orderedlist inheritnum="ignore" continuation="restarts">
                  <listitem>
                    <para>
                      Open one of the images in the folder (see <xref linkend="eom-open-image"/>).  </para>
                  </listitem>
                  <listitem>
                    <para>
                      Open the image collection by choosing <menuchoice><guimenu>View</guimenu><guimenuitem>Image Collection</guimenuitem></menuchoice> or pressing <keycap>F9</keycap>.
                    </para>
                  </listitem>
		</orderedlist>
	     <para>The collection shows thumbnails of all supported images in the folder. You can browse the images by clicking on an image in the collection, by choosing the appropriate option in the <guimenu>Go</guimenu> menu or by pressing <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo> or <keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo>.</para>
             <para>To view all the directory images in fullscreen, choose <menuchoice> <guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem> </menuchoice> or press <keycap>F11</keycap>. To view them as a slide show, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Slideshow</guimenuitem></menuchoice> or press <keycap>F5</keycap>. To return to the collection view, press the <keycap>Esc</keycap> key, or <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>. For more information about how to customize the slide show, see <xref linkend="eom-prefs-slideshow"/>.
                    </para>
	</section>

	<!--============ To Scroll an Image ======================= -->
	<section xml:id="eom-scroll-image"><info><title>Scrolling an Image</title></info>
		
		<para>To scroll around an image that is larger than the image window or full screen view, you can use the following methods:</para>
		<itemizedlist>
			<listitem><para>Use the arrow keys on the keyboard.</para>
			</listitem>
			<listitem><para>Drag the image to move it in the window. (This means you drag the image in the opposite direction you want to scroll in: to scroll down the image, drag it upwards in the window.)</para>
			</listitem>
			<listitem><para>Use the scrollbars on the window.</para>
			</listitem>
		</itemizedlist>
	</section>

	<!--=========== To Zoom In and Out ==================== -->
	<section xml:id="eom-zoom"><info><title>Zooming</title></info>
		
		<para>You can zoom in or out of the image in the following ways:</para>
			<itemizedlist>
				<listitem><para>Use the <mousebutton>scroll wheel</mousebutton> on your mouse. Scrolling down zooms out; scrolling up zooms in.</para></listitem>
 			  <listitem><para>Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom In</guimenuitem></menuchoice> or <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom Out</guimenuitem></menuchoice>.
 			    To restore the image to its original size, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Normal Size</guimenuitem></menuchoice>.
 			    To make the image fit in the window, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Best Fit</guimenuitem></menuchoice>.</para></listitem>				
 				<listitem><para>Use the zoom buttons in the toolbar.
 			 <guilabel>Normal</guilabel> will restore the picture to its original unscaled size.
 			 <guilabel>Fit</guilabel> will resize the image so it will fit in the window if it is too large.</para></listitem>

				<listitem><para>Use the keyboard. To zoom in, <keycombo> <keycap>Ctrl</keycap><keycap>+</keycap> </keycombo> or <keycap>+</keycap>. To zoom out, <keycombo> <keycap>Ctrl</keycap><keycap>-</keycap> </keycombo> or <keycap>-</keycap>. To go back to the normal size, <keycombo> <keycap>Ctrl</keycap><keycap>0</keycap> </keycombo> or <keycap>1</keycap>. To scale the image to fit the window, press <keycap>F</keycap>.</para></listitem>
			</itemizedlist>
			<para>When an image is zoomed to fit the window, resizing the window will also change the zoom level, so the image still fits the window.</para>
	</section>

	<!--=========== To View Image Fullscreen ==================== -->
	<section xml:id="eom-fullscreen"><info><title>Viewing an Image Full Screen/Slideshow</title></info>
		
		<para>To show the image using the entire screen,  choose <menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen</guimenuitem></menuchoice>.</para>
		<para>No panels, window frames, or menubars are visible when an image is shown like this. To return to the normal view, press <keycap>Esc</keycap>, or <keycap>F11</keycap>, or <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>.</para>
		<para>You can zoom or scroll around the image in the same way as when it is shown in a window, using the mouse or the keyboard.</para>
		<para>If you have multiple images in your collection you can press <keycap>Space</keycap> or use the right/down cursor keys to advance to the next image. The previous image can be reached by pressing <keycap>Backspace</keycap> or using the left/up cursor keys.</para>
	<para>In this case you can also use the slideshow mode, where <application>Image Viewer</application> automatically switches to the next image in your collection. You can start a slideshow by choosing <menuchoice><guimenu>View</guimenu><guimenuitem>Slideshow</guimenuitem></menuchoice> or by pressing <keycap>F5</keycap>. The slideshow can be paused/continued by pressing <keycap>P</keycap>. To stop the slideshow, press the <keycap>Esc</keycap> or <keycap>F5</keycap> key, or <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>. For more information about how to customize the slide show, see <xref linkend="eom-prefs-slideshow"/>. </para>
	</section>
</section>


<!-- ============= Manipulating Images ============================== -->
<section xml:id="eom-manipulate"><info><title>Manipulating Images</title></info>
	

	<para>All image manipulations apply to all selected images at once. The modifications are done
	in memory and alter the original files on disk only when the images are saved with the save function (see <xref linkend="eom-save-image"/>).
	</para>

	<!--============ To Flip an Image ======================= -->
	<section xml:id="eom-flip"><info><title>Flipping an Image</title></info>
		
		<para>To flip an image along the horizontal axis of the image, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Flip Horizontal</guimenuitem>
		</menuchoice>.</para>
		<para>To flip an image along the vertical axis of the image, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Flip Vertical</guimenuitem>
		</menuchoice>.</para>
	</section>

	<!--============ To Rotate an Image ======================= -->
	<section xml:id="eom-rotate"><info><title>Rotating an Image</title></info>
		
		<para>To rotate an image 90 degrees in a clockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate Clockwise</guimenuitem>
		</menuchoice>.</para>
		<para>To rotate an image 90 degrees in an anticlockwise direction, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Rotate Counterclockwise</guimenuitem>
		</menuchoice>.</para>
	</section>

	<!--============ To Undo an Action ======================= -->
	<section xml:id="eom-undo"><info><title>Undoing an Action</title></info>
		
		<para>To undo a flip or rotate action, choose 
		<menuchoice>
		<guimenu>Edit</guimenu>
		<guimenuitem>Undo</guimenuitem>
		</menuchoice> or press 
		<keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>
		.</para>
	</section>

	<!--============ To Delete An Image ======================== -->
	<section xml:id="eom-delete-image"><info><title>Deleting an Image</title></info>
		
		<para>To move an image to the Trash, choose
			<menuchoice>
			<guimenu>Edit</guimenu>
			<guimenuitem>Move to Trash</guimenuitem>
			</menuchoice>.
			This moves the file to the Trash folder. Multiple images can also be moved to the trash in the same way: select them all first.</para>
	    <para>To restore an image from the Trash, open the Trash folder in <application>Caja</application> file manager and move the image file to another folder. To delete the image permanently, empty the Trash. To find out more about using the Trash, see the <link xlink:href="help:mate-user-guide/caja-trash">Desktop User Guide</link>.</para>
				
			<note><para>You can also use the <keycap>Del</keycap> key to move an image to the Trash, in which case you will be asked for confirmation.</para></note>
			
	</section>
</section> 

<!-- ============= Saving Images ============================== -->
<section xml:id="eom-save-rename"><info><title>Saving Images</title></info>
	

	<para>
	<application>Image Viewer</application> always tries to choose the save method with the least impact to the image data. For example, if an otherwise unmodified image is saved under a different name in the same format, the file is simply copied. If <systemitem class="library">libjpeg</systemitem> is available on the system all JPEG image modifications are done without loss of image information.
	</para>

<!--============ To Save an Image ======================= -->
	<section xml:id="eom-save-image"><info><title>Saving an Image</title></info>
		
		<para>To save an image, choose 
			<menuchoice>
			<guimenu>Image</guimenu>
			<guimenuitem>Save</guimenuitem>
			</menuchoice>.
		The image will be saved under the same name and file type. Therefore, unmodified images needn't be saved.</para>
	</section>

	<!--============ To Save As an Image ======================= -->
	<section xml:id="eom-save-as-image"><info><title>Saving an Image under a Different Name</title></info>
		
		<para>To save an image under a different name, or convert it to a different file type, choose
			<menuchoice>
			<guimenu>Image</guimenu>
			<guimenuitem>Save As</guimenuitem>
			</menuchoice>.</para>
		<para>Specify the filename in the <guilabel>Name</guilabel> field in the <guilabel>Save Image</guilabel> dialog, then click <guibutton>Save</guibutton>. The file is saved in the current folder by default. <application>Image Viewer</application> tries to determine the file type from the given filename suffix. If the image should be saved in another folder or the file type detection failed, expand the dialog by clicking on <guilabel>Browse for other folders</guilabel>. This allows further folder navigation and the specification of the file type from the drop down box.</para>
		<para>You can save multiple images at once: see the next section.</para>
	</section>    

	<!--============ To Save As an Image ======================= -->
	<section xml:id="eom-save-as-multiple"><info><title>Saving Multiple Images</title></info>
		
		<para>Saving multiple images at once allows you to convert several images to a different format, or give them similar filenames.</para>
		<para>To save multiple images, select the images and choose 
			<menuchoice>
			<guimenu>Image</guimenu>
			<guimenuitem>Save As</guimenuitem>
			</menuchoice>. 		
		The following window is displayed:</para>
  		<figure xml:id="saveas-dialog-fig"><info><title>Save As dialog for multiple images</title></info>
			
			<screenshot>
			  <mediaobject>
			    <imageobject>
			      <imagedata fileref="figures/eom_save_as_window.png" format="PNG"/>
			    </imageobject>
			    <textobject>
			      <phrase>Shows Eye of MATE <guilabel>Save As</guilabel> dialog when saving multiple images.</phrase>
			    </textobject>
			  </mediaobject>
			</screenshot>
  		</figure>
		<para>The folder in which the images will be saved is specified by the <guilabel>Destination folder</guilabel> drop-down box. Initially the folder is set to the current folder. Select <guilabel>Other...</guilabel> from the drop-down list to open a standard open folder dialog for browsing the filesystem. The resulting filename for each image is specified by <guilabel>Filename format</guilabel>. The filename schema is constructed by simple
		characters and special tags. The following special tags are available: </para>
		<itemizedlist>
			<listitem><para><guilabel>Filename (%f)</guilabel> - Original filename without the fileformat suffix.</para>
			</listitem>
			<listitem><para><guilabel>Counter (%n)</guilabel> - Auto-incremented number (starts at specified counter start).</para>
			</listitem>			
		</itemizedlist>	
		<para>Everything but these special tags are considered normal text.</para>
		<para>The image format is determined by the drop-down box after the schema definition. Select a specific image format or use the 
		<guilabel>as is</guilabel> option to state that the same format as the original file should be used.</para>
	
		<para>The <guilabel>Options</guilabel> section allows to remove all space characters by underscores in the resulting filename if <guilabel>Replace spaces with underscores</guilabel> is checked. The <guilabel>Start counter at</guilabel> spin box determines at which number the counter starts if you use the %n tag for the file format specification.</para>
		<para>The <guilabel>File Name Preview</guilabel> section of the dialog shows the resulting file name according to the above settings for an example filename from the selected images.
		</para>
	</section>



</section>

<section xml:id="eom-print"><info><title>Printing Images</title></info>
	
	<section xml:id="eom-print-pagesettings"><info><title>Setting your Page Settings</title></info>
		
		<para>Before printing you need to set the page settings you would like to use. To do that choose <menuchoice><guimenu>Image</guimenu><guimenuitem>Page Setup</guimenuitem></menuchoice>.</para>
		<para>In the <guilabel>Page Setup</guilabel> dialog you can now choose paper size and orientation. If possible, configure your printer to have the page borders set correctly.</para>
	</section>

	<section xml:id="eom-print-image"><info><title>Printing an Image</title></info>
		
		<para>To print an image, perform the following steps:</para>
		<orderedlist inheritnum="ignore" continuation="restarts">
			<listitem>
				<para>Select <menuchoice><guimenu>Image</guimenu><guimenuitem>Print</guimenuitem></menuchoice></para>
			</listitem>
			<listitem>
				<para>In the <guilabel>Print</guilabel> dialog, select the printer you want to use from the list.</para>
			</listitem>
			<listitem>
				<para>Click <guilabel>Print</guilabel>. <application>Image Viewer</application> starts printing now.</para>
			</listitem>
		</orderedlist>
		<para>Images that are too large for the page are automatically scaled down to fit the page. Images that are smaller than the page are centered on it.</para>
		<important>
			<para>Please note that <application>Image Viewer</application> is currently lacking progress reporting while printing. During that time the user interface might become unresponsive for a short time.</para>
		</important>
	</section>

	<section xml:id="eom-print-settings"><info><title>Arranging an Image on the Page</title></info>
		
		<para>Maybe you don't want your image centered or want it scaled down even further. To do that you need to open the <guilabel>Print</guilabel> dialog (see <xref linkend="eom-print-image"/>) and then select the <guilabel>Image Settings</guilabel> tab which offers you the following options:</para>
		<itemizedlist>
			<listitem>
				<para>The options in the <guilabel>Position</guilabel> section allow you to change the images position on the page.</para>
			</listitem>
			<listitem>
				<para>It is also possible to position the image on the page by dragging it around in the <guilabel>Preview</guilabel> field.</para>
			</listitem>
			<listitem>
				<para>The options in the <guilabel>Size</guilabel> section allow you to scale your image to your liking. Scaling is limited by either the image size or by the page size, depending on what condition is met first.</para>
			</listitem>
			<listitem>
				<para>The <guilabel>Unit</guilabel> option allows you to change the metric unit which is used by the options on the <guilabel>Image Settings</guilabel> tab. When you change this option the other fields values are converted accordingly.</para>
			</listitem>
		</itemizedlist>
	</section>
		
</section>
<section xml:id="eom-toolbareditor"><info><title>Personalizing The Toolbar</title></info>
	
	<para>Image Viewer's default toolbar contains only a basic set of items to keep it simple. But you can modify the toolbar if you prefer a different set.</para>
	<section xml:id="eom-toolbareditor-use"><info><title>Modifying the Toolbar</title></info>
		
		<para>If you want to modify the toolbar you need to open the toolbar editor by going to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Toolbar</guimenuitem></menuchoice>. The following window will pop up:</para>
		<figure xml:id="toolbar-editor-fig"><info><title>The toolbar editor window</title></info>
			
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata fileref="figures/eom_toolbar_editor_window.png" format="PNG"/>
					</imageobject>
					<textobject>
						<phrase>Shows Eye of MATE toolbar editor window.</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
		</figure>
		<para>It contains the items that are not in the toolbar and the separator item. You can now edit the toolbar:</para>
		<itemizedlist>
			<listitem>
				<para>To add new items to the toolbar, drag them from the toolbar editor to the toolbar.</para>
			</listitem>
			<listitem>
				<para>To remove items from the toolbar, drag them from the toolbar to the toolbar editor.</para>
			</listitem>
			<listitem>
				<para>To rearrange items on the toolbar, drag them to their new position on the toolbar.</para>
			</listitem>
		</itemizedlist>
		<para>When you have finished editing the toolbar, click the <guibutton>Close</guibutton> button in the toolbar editor window. This will close the toolbar editor and make your modified toolbar active.</para>
		</section>
		<section xml:id="eom-toolbareditor-reset"><info><title>Resetting the Toolbar</title></info>
			
			<para>To revert your changes to the toolbar and return to the default layout, perform the following steps:</para>
			<orderedlist inheritnum="ignore" continuation="restarts">
				<listitem>
					<para>Open the toolbar editor (see <xref linkend="eom-toolbareditor-use"/>).</para>
				</listitem>
				<listitem>
					<para>Click the <guibutton>Reset to Default</guibutton> button.</para>
				</listitem>
				<listitem>
					<para>Click the <guibutton>Close</guibutton> button to close the toolbar editor. The toolbar has been reset to the default layout now.</para>
				</listitem>
			</orderedlist>
		</section>
</section>
<section xml:id="eom-prefs"><info><title>Preferences</title></info>
	
	<para>Preferences can be changed by going to <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. You will be able to change the options for image viewing and slide shows. The changes apply to all open windows instantly.</para>

	<!--============ Image View ======================= -->
  <section xml:id="eom-prefs-image"><info><title>Image View</title></info>
         
	<variablelist>
	<varlistentry>
		<term><guilabel>Image Enhancements</guilabel></term>
		<listitem>
		<para>Select the <guilabel>Smooth images when zoomed</guilabel> option to enable image smoothing when you change the image's zoom factor. If you select this option, your images will be smoothed to improve their display quality while viewing them with <application>Image Viewer</application>.</para>
                <para>If you select the <guilabel>Automatic orientation</guilabel> option, your images will be rotated on loading according to their metadata. For example portraits are automatically rotated upright. Note that this function requires a correctly set orientation tag in the image's metadata and thus does not work with all images. The rotation is not saved until you save the rotated image (see <xref linkend="eom-save-rename"/>).</para>
		</listitem>
	</varlistentry>

	<varlistentry>
		<term><guilabel>Transparent Parts</guilabel></term>
		<listitem>
		<para>Select one of the following options to determine how <application>Image Viewer</application> displays transparent parts of an image:</para>
		<itemizedlist>
			<listitem><para><guilabel>As check pattern</guilabel> </para>
			<para>Displays any transparent parts of the image in a check pattern.</para>
			</listitem>
			<listitem><para><guilabel>As custom color</guilabel> </para>
			<para>Displays any transparent parts of the image in a solid color that you specify. Click on the color selector button to select a color. </para>
			</listitem>
			<listitem><para><guimenuitem>As background</guimenuitem> </para>
			<para>Displays any transparent parts of the image in the background color of the <application>Image Viewer</application> application. </para>
			</listitem>
		</itemizedlist>
		</listitem>
	</varlistentry>		
	</variablelist>
  </section>
		
	<!--============ Slide Show ==================-->                                                                                               
  <section xml:id="eom-prefs-slideshow"><info><title>Slideshow</title></info>
         
	<variablelist>
	<varlistentry>
		<term><guilabel>Image Zoom</guilabel></term>
		<listitem>
		<para>Select the <guilabel>Expand images to fit screen</guilabel> option to enlarge images to fit the screen during the slide show. If you do not select this option, images that are smaller than the screen size are not resized to fit the screen.</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term><guilabel>Sequence</guilabel></term>
		<listitem>
		<para>Select the <guilabel>Loop sequence</guilabel> option to cycle endlessly through the list of images during the slide show. If you do not select this option, the slide show returns to the collection view after the last image is displayed.
</para>
		<para>Use the <guilabel>Switch image after ... seconds</guilabel> spin box to specify how long each image is displayed during the slide show. If you set this value to zero, the auto advance function is disabled and only manual browsing is available (see <xref linkend="eom-fullscreen"/>).
</para>
		</listitem>
	</varlistentry>		
	</variablelist>
  </section>
</section>
</article>