Use gdk_rectangle_intersect() in pan-view
[geeqie.git] / doc / docbook / GuideImageMarks.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <section id="GuideImageMarks">\r
3   <title id="titleGuideImageMarks">Marking Images</title>\r
4   <para>Marks are intended as a temporary method of grouping and filtering sets of images.</para>\r
5   <para>\r
6     <link linkend="Keywords" endterm="titleKeywords" />\r
7     are intended as a permanent method of identifying sets of images, and to this end it is possible to link any mark with any keyword.\r
8   </para>\r
9   <para>\r
10     The\r
11     <guimenu>Select</guimenu>\r
12     menu gives access to the marks operations of setting, filtering and intersection.\r
13   </para>\r
14   <para>There are 10 individual marks, any of which can be associated with an image simply by pressing the 0 to 9 keys on the keyboard, where key 0 represents mark 10.</para>\r
15   <para>\r
16     If the\r
17     <guimenu>Show Marks</guimenu>\r
18     menu has been selected, each image will have a set of 10 check-boxes displayed adjacent to it in the file pane in both icon and list mode. In addition a set of 10 check-boxes will be shown at the top of the files pane. Clicking any of these will filter the displayed list.\r
19   </para>\r
20   <para>Moving the mouse over any of the check-boxes at the top of the files pane will show mnemonic text for that mark. The text can be modified by right-clicking on the check box.</para>\r
21   <para>\r
22     If the\r
23     <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
24     is being displayed, the currently set marks for the image are shown. It is not necessary to include an entry into the overlay template for this to happen.\r
25   </para>\r
26   <para>\r
27     A keyword can be associated with a single mark by right-clicking on the keyword in the sidebar panel. When a meta-data write operation for a file is triggered either\r
28     <link linkend="Buttons">manually</link>\r
29     or as defined in\r
30     <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />\r
31     , the keyword data indicated by the current set of mark-to-keyword links will be written.\r
32   </para>\r
33   <para>\r
34     The associations between keywords and marks is preserved when Geeqie is shut down. The current setting of marks can also be optionally saved - the setting is in the\r
35     <link linkend="Behaviour">Behavior tab of Preferences</link>\r
36     .\r
37   </para>\r
38   <para />\r
39   <para />\r
40 </section>\r