Update web help file and other docs
[geeqie.git] / web / help / ExifRotation.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Exif Auto Rotation</title>
6 <link rel="previous" href="Miscellaneous.html" title="Miscellaneous">
7 <link rel="next" href="GuideLicence.html" title="Licence">
8 <link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
9 <style type="text/css">
10
11 html { height: 100%; }
12 body {
13   margin: 0px; padding: 12px;
14   background-color: #f9f9f6;
15   min-height: 100%;
16   direction: ltr;
17 }
18 div, p, pre, blockquote { margin: 0; padding: 0; }
19 p img { vertical-align: middle; }
20 sub { font-size: 0.83em; }
21 sub sub { font-size: 1em; }
22 sup { font-size: 0.83em; }
23 sup sup { font-size: 1em; }
24 table { border-collapse: collapse; }
25 table.table-pgwide { width: 100%; }
26 td { vertical-align: top; }
27 td { padding: 0.2em 0.83em 0.2em 0.83em; }
28 th { padding: 0 0.83em 0 0.83em; }
29 tr.tr-shade {
30   background-color: #f9f9f6;
31 }
32 td.td-colsep { border-right: solid 1px; }
33 td.td-rowsep { border-bottom: solid 1px; }
34 thead { border-top: solid 2px; border-bottom: solid 2px; }
35 tfoot { border-top: solid 2px; border-bottom: solid 2px; }
36 div.body {
37   padding: 1em;
38   max-width: 60em;
39   background-color: #ffffff;
40   border: solid 1px #e0e0df;
41 }
42 div.body-sidebar {
43   margin-right: 13em;
44 }
45 div.division div.division { margin-top: 1.72em; }
46 div.division div.division div.division { margin-top: 1.44em; }
47 div.header {
48   margin: 0;
49   color: #3f3f3f;
50   border-bottom: solid 1px #e0e0df;
51 }
52 h1, h2, h3, h4, h5, h6, h7 {
53   margin: 0; padding: 0;
54   color: #3f3f3f;
55 }
56 h1.title { font-size: 1.72em; }
57 h2.title { font-size: 1.44em; }
58 h3.title { font-size: 1.2em; }
59 h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
60 .block { margin-top: 1em; }
61 .block .block-first { margin-top: 0; }
62 .block-indent {
63   margin-left left: 1.72em;
64   margin-: 1em;
65 }
66 .block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
67 td .block-indent  { margin-left: 0em; margin-right: 0em; }
68 dd .block-indent  { margin-left: 0em; margin-right: 0em; }
69 .block-verbatim { white-space: pre; }
70 div.title {
71   margin-bottom: 0.2em;
72   font-weight: bold;
73   color: #3f3f3f;
74 }
75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
76 div.title-formal .label { font-weight: normal; }
77 a {
78   color: #1f609f;
79   text-decoration: none;
80 }
81 a:hover { text-decoration: underline; }
82 a:visited { color: #9f1f6f; }
83 ul, ol, dl { margin: 0; padding: 0; }
84 li {
85   margin-top: 1em;
86   margin-left: 2.4em;
87   padding: 0;
88 }
89 li.li-first { margin-top: 0; }
90 dt { margin: 1em 0 0 0; }
91 dt.dt-first { margin: 0; }
92 dd {
93   margin-left: 1.72em;
94   margin-top: 0.5em;
95 }
96 dl.dl-compact dt { margin-top: 0; }
97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
98
99
100 ul.linktrail {
101   display: block;
102   margin: 0.2em 0 0 0;
103   text-align: right;
104 }
105 li.linktrail { display: inline; margin: 0; padding: 0; }
106
107 li.linktrail::before {
108   content: '  /  ';
109   color: #3f3f3f;
110 }
111
112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
113
114
115 div.navbar {
116   padding: 0.5em 1em 0.5em 1em;
117   max-width: 60em;
118   background-color: #ffffff;
119   border: solid 1px #e0e0df;
120 }
121 div.navbar-top { margin-bottom: 1em; }
122 div.navbar-bottom { margin-top: 1em; clear: both; }
123 div.navbar img { border: 0; vertical-align: -0.4em; }
124 table.navbar { width: 100%; margin: 0; border: none; }
125 table.navbar td { padding: 0; border: none; }
126 td.navbar-next {
127   text-align: right;
128 }
129 a.navbar-prev::before {
130   
131   content: '◀  ';
132   color: #3f3f3f;
133 }
134 a.navbar-next::after {
135   
136   content: '  ▶';
137   color: #3f3f3f;
138 }
139
140
141 div.sidebar {
142   float: right;
143   padding: 0; margin: 0; width: 12em;
144 }
145 div.sidenav {
146   padding: 0.5em 1em 0 1em;
147   background-color: #ffffff;
148   border: solid 1px #e0e0df;
149 }
150 div.sidenav div.autotoc {
151   background-color: #ffffff;
152   border: none; padding: 0; margin: 0;
153 }
154 div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
155 div.sidenav div.autotoc li { margin-bottom: 0.5em; }
156 div.sidenav div.autotoc div.autotoc div.autotoc {
157   margin-left: 1em;
158   margin-top: 0;
159 }
160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
161
162
163 div.autotoc {
164   
165   display: table;
166   margin-top: 1em;
167   margin-left: 1.72em;
168   padding: 0.5em 1em 0.5em 1em;
169   background-color: #f0f9ff;
170   border: solid 1px #c0c9ff;
171 }
172 div.autotoc ul { margin: 0; padding: 0; }
173 div.autotoc li { list-style-type: none; margin: 0; }
174 div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
175 div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
176 div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
177
178
179 span.bibliolabel {
180   color: #3f3f3f;
181 }
182
183
184 div.admonition {
185   padding: 0.5em 6px 0.5em 6px;
186   border: solid 1px #e0e0df;
187   background-color: #fffff0;
188 }
189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
190   padding-left: 60px;
191   background-position: left top;
192   background-repeat: no-repeat;
193   min-height: 48px;
194 }
195 div.caution-inner { background-image: url("admon-caution.png"); }
196 div.important-inner { background-image: url("admon-important.png"); }
197 div.note-inner { background-image: url("admon-note.png"); }
198 div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
199 div.tip-inner { background-image: url("admon-tip.png"); }
200 div.warning-inner { background-image: url("admon-warning.png"); }
201 div.blockquote {
202   
203   background-image: url('watermark-blockquote-201C.png');
204   background-repeat: no-repeat;
205   background-position: top left;
206   padding: 0.5em;
207   padding-left: 4em;
208 }
209 div.attribution {
210   margin-top: 0.5em;
211   color: #3f3f3f;
212 }
213 div.attribution::before {
214   
215   content: '― ';
216 }
217 div.epigraph {
218   text-align: right;
219   margin-left: 20%;
220   margin-right: 0;
221   color: #3f3f3f;
222 }
223 div.figure, div.informalfigure {
224   
225   display: table;
226   padding: 0.5em;
227   background-color: #f9f9f6;
228   border: solid 1px #e0e0df;
229 }
230 div.figure-inner, div.informalfigure-inner {
231   padding: 0.5em;
232   background-color: #ffffff;
233   border: solid 1px #e0e0df;
234 }
235 div.caption { margin-top: 0.5em; }
236 div.programlisting {
237   padding: 0.5em;
238   
239   background-color: #f9f9f6;
240   border: solid 1px #e0e0df;
241 }
242 div.screen {
243   padding: 0.5em;
244   
245   background-color: #f9f9f6;
246   border: solid 1px #e0e0df;
247 }
248 div.screen .prompt {
249   color: #3f3f3f;
250 }
251 div.screen .userinput {
252   font-weight: bold;
253   color: #3f3f3f;
254 }
255 div.programlisting .userinput {
256   font-weight: bold;
257   color: #3f3f3f;
258 }
259 pre.linenumbering {
260   color: #3f3f3f;
261   margin: 0;
262   padding-right: 1em;
263   float: left;
264   text-align: right;
265 }
266
267
268
269 dl.index dt { margin-top: 0; }
270 dl.index dd { margin-top: 0; margin-bottom: 0; }
271 dl.indexdiv dt { margin-top: 0; }
272 dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
273 dl.setindex dt { margin-top: 0; }
274 dl.setindex dd { margin-top: 0; margin-bottom: 0; }
275 div.list div.title-formal span.title {
276   border-bottom: solid 1px #e0e0df;
277 }
278 div.simplelist {
279   margin-left: 1.72em;
280 }
281 div.simplelist table { margin-left: 0; border: none; }
282 div.simplelist td {
283   padding: 0.5em;
284   border-left: solid 1px #e0e0df;
285 }
286 div.simplelist td.td-first {
287   padding-left: 0;
288   border-left: 0;
289 }
290 div.synopsis {
291   padding: 0.5em;
292   
293   background-color: #f9f9f6;
294   border-top: solid 2px #c0c9ff;
295   border-bottom: solid 2px #c0c9ff;
296 }
297 div.synopsis div.synopsis {
298   padding: 0;
299   border: none;
300 }
301 div.synopsis div.block { margin-top: 0.2em; }
302 div.synopsis div.block-first { margin-top: 0; }
303 div.cmdsynopsis { font-family: monospace; }
304
305 span.accel { text-decoration: underline; }
306 span.acronym { font-family: sans-serif; }
307 span.application { font-style: italic; }
308 span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
309 span.code {
310   font-family: monospace;
311   border: solid 1px #e0e0df;
312   padding-left: 0.2em;
313   padding-right: 0.2em;
314 }
315 pre span.code { border: none; padding: 0; }
316 span.command {
317   font-family: monospace;
318   border: solid 1px #e0e0df;
319   padding-left: 0.2em;
320   padding-right: 0.2em;
321 }
322 pre span.command { border: none; padding: 0; }
323 span.computeroutput { font-family: monospace; }
324
325 span.constant { font-family: monospace; }
326 span.database { font-family: monospace; }
327 span.email { font-family: monospace; }
328 span.emphasis { font-style: italic; }
329 span.emphasis-bold { font-style: normal; font-weight: bold; }
330 span.envar { font-family: monospace; }
331
332 span.filename { font-family: monospace; }
333 span.firstterm { font-style: italic; }
334 span.foreignphrase { font-style: italic; }
335 span.function { font-family: monospace; }
336
337 dt.glossterm span.glossterm { font-style: normal; }
338
339
340 span.glossterm { font-style: italic; }
341
342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
343   font-weight: bold;
344   color: #3f3f3f;
345 }
346 span.keycap {
347   font-weight: bold;
348   color: #3f3f3f;
349 }
350 span.lineannotation { font-style: italic; }
351 span.literal { font-family: monospace; }
352 span.markup  { font-family: monospace; }
353 span.medialabel { font-style: italic; }
354 span.methodname { font-family: monospace; }
355 span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
356 span.option { font-family: monospace; }
357 span.parameter { font-family: monospace; }
358 span.paramdef span.parameter { font-style: italic; }
359 span.prompt { font-family: monospace; }
360 span.property { font-family: monospace; }
361 span.replaceable  { font-style: italic; }
362 span.returnvalue { font-family: monospace; }
363 span.sgmltag { font-family: monospace; }
364 span.structfield, span.structname { font-family: monospace; }
365 span.symbol { font-family: monospace; }
366 span.systemitem { font-family: monospace; }
367 span.token { font-family: monospace; }
368 span.type { font-family: monospace; }
369 span.uri { font-family: monospace; }
370 span.userinput { font-family: monospace; }
371 span.varname { font-family: monospace; }
372 span.wordasword { font-style: italic; }
373
374
375
376 div.footnotes { font-style: italic; font-size: 0.8em; }
377 div.footnote { margin-top: 1.44em; }
378 span.footnote-number { display: inline; padding-right: 0.83em; }
379 span.footnote-number + p { display: inline; }
380 a.footnote { text-decoration: none; font-size: 0.8em; }
381 a.footnote-ref { text-decoration: none; }
382
383 span.co {
384   margin-left: 0.2em; margin-right: 0.2em;
385   padding-left: 0.4em; padding-right: 0.4em;
386   border: solid 1px #000000;
387   -moz-border-radius: 8px;
388   background-color: #000000;
389   color: #FFFFFF;
390   font-size: 8px;
391 }
392 span.co:hover {
393   border-color: #333333;
394   background-color: #333333;
395   color: #FFFFFF;
396 }
397 span.co a { text-decoration: none; }
398 span.co a:hover { text-decoration: none; }
399
400 dt.question { margin-left: 0em; }
401 dt.question div.label { float: left; }
402 dd + dt.question { margin-top: 1em; }
403 dd.answer {
404   margin-top: 1em;
405   margin-left: 2em;
406   margin-right: 1em;
407 }
408 dd.answer div.label { float: left; }
409 </style>
410 </head>
411 <body>
412 <div class="navbar navbar-top"><table class="navbar"><tr>
413 <td class="navbar-prev"><a class="navbar-prev" href="Miscellaneous.html" title="Miscellaneous">Miscellaneous</a></td>
414 <td class="navbar-next"><a class="navbar-next" href="GuideLicence.html" title="Licence">Licence</a></td>
415 </tr></table></div>
416 <div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
417 <li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
418 <li>
419 <a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
420 <li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
421 <li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
422 <li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
423 <li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
424 <li><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
425 <li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
426 <li><a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a></li>
427 <li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
428 <li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
429 <li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
430 <li><a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
431 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
432 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
433 <li>
434 <a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a><div class="autotoc"><ul>
435 <li><a class="xref" href="Imageviewing.html" title="Image viewing">Image viewing</a></li>
436 <li><a class="xref" href="Commandline.html" title="Command line">Command line</a></li>
437 <li><a class="xref" href="Miscellaneous.html" title="Miscellaneous">Miscellaneous</a></li>
438 <li>Exif Auto Rotation</li>
439 </ul></div>
440 </li>
441 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
442 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
443 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
444 </ul></div>
445 </li>
446 </ul></div></div></div>
447 <div class="body body-sidebar"><div class="division section">
448 <a name="ExifRotation"></a><div class="header"><h1 class="section title"><span class="title">Exif Auto Rotation</span></h1></div>
449 <ul class="linktrail">
450 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
451 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
452 </ul>
453 <p class="para block block-first"></p>
454 <div class="autotoc"><ul><li>
455 <span class="label">14.4.1. </span><a class="xref" href="ExifRotation.html#HowdotheExifauto-rotationcommandswork" title="How do the Exif auto-rotation commands work?">How do the Exif auto-rotation commands work?</a>
456 </li></ul></div>
457 <div class="division section">
458 <a name="HowdotheExifauto-rotationcommandswork"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">14.4.1. </span>How do the Exif auto-rotation commands work?</span></h2></div>
459 <p class="para block block-first">
460         Image auto-rotation works in either of two modes, set by
461         <a class="link" href="GuideOptionsMetadata.html#MetadataMiscellaneous" title="Miscellaneous">Write altered image orientation to the metadata</a>
462         option.
463       </p>
464 <p class="para block">
465         <span class="guilabel">Write altered image orientation to the metadata not set</span>
466         <p class="para block"></p>
467         If you change the orientation of an image using any of the available commands, the image will always be displayed in the modified orientation. This new orientation is stored in temporary data structures associated with each image file. When Geeqie closes, these changes will be lost.
468       </p>
469 <div class="admonition block warning block-indent"><div class="warning-inner">
470         <p class="para block block-first">It is not possible to determine if the image as displayed is the original image or one which has been temporarily rotated.</p>
471       </div></div>
472 <p class="para block">
473         If the option
474         <a class="link" href="GuideMainWindowMenus.html#Editmenu" title="Edit menu">Auto rotate image using EXIF information</a>
475         is selected, any images which have Exif orientation data will also be shown rotated. However, any rotation you have selected manually will always over-ride the embedded Exif rotation value.
476       </p>
477 <p class="para block">
478         <span class="guilabel">Write altered image orientation to the metadata set</span>
479         <p class="para block"></p>
480         <p class="para block">If you change the orientation of an image using any of the available commands, this new orientation is stored in a metadata write queue.</p>
481         <p class="para block">
482           If the option
483           <a class="link" href="GuideMainWindowMenus.html#Editmenu" title="Edit menu">Auto rotate image using EXIF information</a>
484           is selected, any images which have Exif orientation data will be shown rotated, including any in the metadata write queue.
485         </p>
486         <p class="para block">
487           However if the option
488           <a class="link" href="GuideMainWindowMenus.html#Editmenu" title="Edit menu">Auto rotate image using EXIF information</a>
489           is not selected, no images will be auto-rotated. If you have manually rotated any images, the metadata write icon on the status bar will alert you to that fact. Clicking the icon will give a list of the modified files.
490         </p>
491       </p>
492 <p class="para block"></p>
493 </div>
494 </div></div>
495 <div class="navbar navbar-bottom"><table class="navbar"><tr>
496 <td class="navbar-prev"><a class="navbar-prev" href="Miscellaneous.html" title="Miscellaneous">Miscellaneous</a></td>
497 <td class="navbar-next"><a class="navbar-next" href="GuideLicence.html" title="Licence">Licence</a></td>
498 </tr></table></div>
499 </body>
500 </html>