<a name="line-796"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"%1 Would you like to save the changes you made to them?"</span><span class="p">,</span> <span class="n">message</span><span class="p">)</span>
<a name="line-953"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Failed to save some information:"</span><span class="p">),</span>
<a name="line-156"></a> <span class="n">d</span><span class="o">-></span><span class="n">setTodayDigitalizedBtn</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set digitization date to today"</span><span class="p">));</span>
<a name="line-157"></a>
<a name="line-158"></a> <span class="n">d</span><span class="o">-></span><span class="n">dateDigitalizedSel</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the creation date of "</span>
<a name="line-160"></a> <span class="n">d</span><span class="o">-></span><span class="n">timeDigitalizedSel</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the creation time of "</span>
<a name="line-162"></a> <span class="n">d</span><span class="o">-></span><span class="n">zoneDigitalizedSel</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the time zone of "</span>
<a name="line-183"></a> <span class="n">d</span><span class="o">-></span><span class="n">setTodayCreatedBtn</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set creation date to today"</span><span class="p">));</span>
<a name="line-184"></a>
<a name="line-185"></a> <span class="n">d</span><span class="o">-></span><span class="n">dateCreatedSel</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the creation date of "</span>
<a name="line-187"></a> <span class="n">d</span><span class="o">-></span><span class="n">timeCreatedSel</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the creation time of "</span>
<a name="line-189"></a> <span class="n">d</span><span class="o">-></span><span class="n">zoneCreatedSel</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the time zone of "</span>
<a name="line-197"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the full country name referenced by the content."</span><span class="p">));</span>
<a name="line-206"></a> <span class="n">d</span><span class="o">-></span><span class="n">cityEdit</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the city of content origin. "</span>
<a name="line-207"></a> <span class="s">"This field is limited to 32 ASCII characters."</span><span class="p">));</span>
<a name="line-226"></a> <span class="n">d</span><span class="o">-></span><span class="n">provinceEdit</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the Province or State of content origin. "</span>
<a name="line-227"></a> <span class="s">"This field is limited to 32 ASCII characters."</span><span class="p">));</span>
<a name="line-233"></a> <span class="n">d</span><span class="o">-></span><span class="n">countryCB</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Select here country name of content origin."</span><span class="p">));</span>
<a name="line-234"></a> <span class="c1">// Remove 2 last items for the list (separator + Unknown item)</span>
-<a name="line-90"></a> <span class="n">QString</span> <span class="n">tmpPath</span><span class="p">;</span> <span class="c1">// If set, contains a temporary file which must be deleted</span>
-<a name="line-353"></a> <span class="n">State</span> <span class="n">state</span> <span class="o">=</span> <span class="n">d</span><span class="o">-></span><span class="n">state</span><span class="p">;</span> <span class="c1">// Can change in the treatment itself, so we cache it</span>
-<a name="line-522"></a> <span class="n">emit</span> <span class="nf">signalLoginFailed</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Upload to Piwigo version < 2.4 is no longer supported"</span><span class="p">));</span>
-<a name="line-631"></a> <span class="c1">// Originally, first versions of Piwigo 2.4.x returned an invalid XML as the element started with a digit</span>
-<a name="line-632"></a> <span class="c1">// New versions are corrected (starting with _) : This code works with both versions</span>
-<a name="line-696"></a> <span class="n">emit</span> <span class="n">signalAddPhotoFailed</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Upload to Piwigo version < 2.4 is no longer supported"</span><span class="p">));</span>
+<a name="line-241"></a> <span class="n">qCDebug</span><span class="p">(</span><span class="n">DIGIKAM_GENERAL_LOG</span><span class="p">)</span> <span class="o"><<</span> <span class="s">"DNGWriter: Number of Raw color components not supported. Aborted..."</span> <span class="p">;</span>
+<a name="line-257"></a><span class="cm"> qCDebug(DIGIKAM_GENERAL_LOG) << "DNGWriter: Cannot open file to write RAW data. Aborted..." ;</span>
-<a name="line-478"></a> <span class="n">emit</span> <span class="nf">signalAddPhotoFailed</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"File too big to upload"</span><span class="p">));</span>
-<a name="line-490"></a> <span class="n">emit</span> <span class="nf">signalAddPhotoFailed</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"File too big to upload"</span><span class="p">));</span>
-<a name="line-503"></a> <span class="n">emit</span> <span class="nf">signalAddPhotoFailed</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"File too big to upload"</span><span class="p">));</span>
-<a name="line-603"></a><span class="cm"> * The endpoint below allows to get more than just account name (e.g. profile avatar, links to tweets posted, etc.)</span>
-<a name="line-604"></a><span class="cm"> * Look at debug message printed to console for futher ideas and exploitation</span>
-<a name="line-786"></a><span class="cm"> * Currently, we don't parse data of response from addPhotoAppend, since the response is with HTTP 204</span>
-<a name="line-787"></a><span class="cm"> * This is indeed an expected response code, because the response should be with an empty body.</span>
-<a name="line-788"></a><span class="cm"> * However, in order to keep a compatible prototype of parseResponse methodes and reserve for future change,</span>
-<a name="line-789"></a><span class="cm"> * we should keep argument const QByteArray& data.</span>
+<a name="line-970"></a> <span class="n">qCDebug</span><span class="p">(</span><span class="n">DIGIKAM_GENERAL_LOG</span><span class="p">)</span> <span class="o"><<</span> <span class="s">"DNGWriter: Cannot open original RAW file to backup in DNG. Aborted..."</span><span class="p">;</span>
+<a name="line-109"></a> <span class="n">QVERIFY2</span><span class="p">(</span><span class="n">dbChangeGood</span><span class="p">,</span> <span class="s">"Could not set temp album db"</span><span class="p">);</span>
+<a name="line-127"></a> <span class="n">QVERIFY2</span><span class="p">(</span> <span class="n">all</span><span class="p">.</span><span class="n">size</span><span class="p">()</span> <span class="o">==</span> <span class="mi">3</span><span class="p">,</span> <span class="s">"Failed to scan empty directory. We must have one root album, one album, and one trash."</span><span class="p">);</span>
+<a name="line-278"></a> <span class="c1">// root + 2 years + 2 and 3 months per year + (1997 as test year for date ordering with 12 months) = 21</span>
+<a name="line-393"></a> <span class="n">QLatin1String</span><span class="p">(</span><span class="s">" was changed before adding signal was received"</span><span class="p">);</span>
+<a name="line-609"></a> <span class="n">QFAIL</span><span class="p">(</span><span class="s">"Unexpected album returned from model"</span><span class="p">);</span>
-<a name="line-241"></a> <span class="n">qCDebug</span><span class="p">(</span><span class="n">DIGIKAM_GENERAL_LOG</span><span class="p">)</span> <span class="o"><<</span> <span class="s">"DNGWriter: Number of Raw color components not supported. Aborted..."</span> <span class="p">;</span>
-<a name="line-257"></a><span class="cm"> qCDebug(DIGIKAM_GENERAL_LOG) << "DNGWriter: Cannot open file to write RAW data. Aborted..." ;</span>
-<a name="line-970"></a> <span class="n">qCDebug</span><span class="p">(</span><span class="n">DIGIKAM_GENERAL_LOG</span><span class="p">)</span> <span class="o"><<</span> <span class="s">"DNGWriter: Cannot open original RAW file to backup in DNG. Aborted..."</span><span class="p">;</span>
+<a name="line-56"></a><span class="cm"> * @todo Here we save all data types as XMP Strings. Is that okay or do we have to store them as some other type?</span>
-<a name="line-109"></a> <span class="n">QVERIFY2</span><span class="p">(</span><span class="n">dbChangeGood</span><span class="p">,</span> <span class="s">"Could not set temp album db"</span><span class="p">);</span>
-<a name="line-127"></a> <span class="n">QVERIFY2</span><span class="p">(</span> <span class="n">all</span><span class="p">.</span><span class="n">size</span><span class="p">()</span> <span class="o">==</span> <span class="mi">3</span><span class="p">,</span> <span class="s">"Failed to scan empty directory. We must have one root album, one album, and one trash."</span><span class="p">);</span>
-<a name="line-278"></a> <span class="c1">// root + 2 years + 2 and 3 months per year + (1997 as test year for date ordering with 12 months) = 21</span>
-<a name="line-393"></a> <span class="n">QLatin1String</span><span class="p">(</span><span class="s">" was changed before adding signal was received"</span><span class="p">);</span>
-<a name="line-609"></a> <span class="n">QFAIL</span><span class="p">(</span><span class="s">"Unexpected album returned from model"</span><span class="p">);</span>
+<a name="line-886"></a><span class="cm"> * @todo According to the EXIF 2.2 spec, GPSSatellites is a free form field which can either hold only the</span>
+<a name="line-887"></a><span class="cm"> * number of satellites or more details about each satellite used. For now, we just write</span>
+<a name="line-888"></a><span class="cm"> * the number of satellites. Are we using the correct format for the number of satellites here?</span>
+<a name="line-823"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Select a name for the new tag:"</span><span class="p">),</span>
<a name="line-157"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Select here the language of content."</span><span class="p">));</span>
<a name="line-186"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Select here the scene type of the content."</span><span class="p">));</span>
<a name="line-199"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Select here the editorial type of the content."</span><span class="p">));</span>
<a name="line-215"></a> <span class="n">d</span><span class="o">-></span><span class="n">objectAttributeEdit</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set here the editorial attribute description of the content."</span><span class="p">));</span>
<a name="line-216"></a>
<a name="line-217"></a> <span class="n">d</span><span class="o">-></span><span class="n">objectAttributeCB</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Select here the editorial attribute of the content."</span><span class="p">));</span>
-<a name="line-56"></a><span class="cm"> * @todo Here we save all data types as XMP Strings. Is that okay or do we have to store them as some other type?</span>
+<a name="line-41"></a><span class="cm"> * @brief The model that holds data for the tag tree displayed in ReverseGeocodingWidget</span>
+<a name="line-42"></a><span class="cm"> *</span>
+<a name="line-43"></a><span class="cm"> * The RGTagModel class is a wrapper above QAbstractItemModel. It helds data for the tag tree displayed in ReverseGeocodingWidget.</span>
+<a name="line-44"></a><span class="cm"> * The model gets the data from the tag model of host application and displays it in a QTreeView.</span>
+<a name="line-45"></a><span class="cm"> * It stores three type of tags: old tags (the tags that belong to the host's tag model), spacer tags (tags representing address elements</span>
+<a name="line-46"></a><span class="cm"> * or custom tags) and new tags (tags containing data retrieved from backend).</span>
+<a name="line-293"></a><span class="cm"> * Adds a spacer tag.</span>
+<a name="line-294"></a><span class="cm"> * @param parent The index of the parent. If parent == QModelIndex(), then the spacer is added to top-level</span>
+<a name="line-295"></a><span class="cm"> * @param spacerName The name of the spacer. If it's an address element, the address element name will have the form {addressElement}.For example: {Country}, {City}...</span>
+<a name="line-397"></a><span class="cm"> * The function starts to scan the tree starting with currentBranch. When it finds a spacer containing an address element, it</span>
+<a name="line-398"></a><span class="cm"> * looks to see if the address element is found in addressElements list. If it's found, a new tag is added.</span>
+<a name="line-399"></a><span class="cm"> * @param currentBranch The branch from where the scan starts.</span>
+<a name="line-400"></a><span class="cm"> * @param currentRow The row of the current branch.</span>
+<a name="line-401"></a><span class="cm"> * @param addressElements A list containing address elements. Example: {Country}, {City}...</span>
+<a name="line-402"></a><span class="cm"> * @param elementsData A list containing the name of each address element found in elements. Example: France, Paris...</span>
+<a name="line-501"></a><span class="cm"> * Add new tags to tag tree. The function starts to scan the tree from root level. When it finds a spacer containing an address element</span>
+<a name="line-502"></a><span class="cm"> * , it looks to see if the address element is found in elements list. If it's found, a new tag is added.</span>
+<a name="line-503"></a><span class="cm"> * @param elements A list containing address elements. Example: {Country}, {City}...</span>
+<a name="line-504"></a><span class="cm"> * @param resultedData A list containing the name of each address element found in elements. Example: France, Paris...</span>
+<a name="line-505"></a><span class="cm"> * @return A list containing new tags</span>
-<a name="line-886"></a><span class="cm"> * @todo According to the EXIF 2.2 spec, GPSSatellites is a free form field which can either hold only the</span>
-<a name="line-887"></a><span class="cm"> * number of satellites or more details about each satellite used. For now, we just write</span>
-<a name="line-888"></a><span class="cm"> * the number of satellites. Are we using the correct format for the number of satellites here?</span>
+<a name="line-921"></a><span class="cm"> * Deletes all spacers or all new tags below @currentBranch.</span>
+<a name="line-922"></a><span class="cm"> * @param currentBranch The tree branch from where the scan starts.</span>
+<a name="line-923"></a><span class="cm"> * @param currentRow The row of current branch.</span>
+<a name="line-924"></a><span class="cm"> * @param whatShouldRemove The tag type that should to be removed. The options are: spacers or new tags.</span>
+<a name="line-966"></a><span class="cm"> * Deletes all spacers or all new tags.</span>
+<a name="line-967"></a><span class="cm"> * @param currentIndex If whatShouldRemove represents a spacer, the function will remove all spacers below currentIndex.If whatShouldRemove represents a new tag, the function will delete all new tags.</span>
+<a name="line-968"></a><span class="cm"> * @param whatShouldRemove The tag type that should be removed. The options are: spacers or new tags.</span>
+<a name="line-994"></a><span class="cm"> * Readds new tags to tag tree.</span>
+<a name="line-995"></a><span class="cm"> * @param currentBranch The branch from where the scan starts.</span>
+<a name="line-996"></a><span class="cm"> * @param currentRow The row of the currentBranch.</span>
+<a name="line-997"></a><span class="cm"> * @param tagAddressElements A list containing address elements. Example: {Country}, {City}...</span>
+<a name="line-998"></a><span class="cm"> * @param elementsData A list containing the name of each address element found in elements. Example: France, Paris...</span>
+<a name="line-1180"></a><span class="cm"> * Gets the spacers addresses below currentBranch. Address means the path from rootTag to currentBranch.</span>
+<a name="line-1181"></a><span class="cm"> * @param currentBranch The branch from where the search starts.</span>
-<a name="line-41"></a><span class="cm"> * @brief The model that holds data for the tag tree displayed in ReverseGeocodingWidget</span>
-<a name="line-42"></a><span class="cm"> *</span>
-<a name="line-43"></a><span class="cm"> * The RGTagModel class is a wrapper above QAbstractItemModel. It helds data for the tag tree displayed in ReverseGeocodingWidget.</span>
-<a name="line-44"></a><span class="cm"> * The model gets the data from the tag model of host application and displays it in a QTreeView.</span>
-<a name="line-45"></a><span class="cm"> * It stores three type of tags: old tags (the tags that belong to the host's tag model), spacer tags (tags representing address elements</span>
-<a name="line-46"></a><span class="cm"> * or custom tags) and new tags (tags containing data retrieved from backend).</span>
+<a name="line-58"></a><span class="cm"> * @brief Marker model for storing data needed to display markers on the map. The data is retrieved from Digikam's database.</span>
-<a name="line-293"></a><span class="cm"> * Adds a spacer tag.</span>
-<a name="line-294"></a><span class="cm"> * @param parent The index of the parent. If parent == QModelIndex(), then the spacer is added to top-level</span>
-<a name="line-295"></a><span class="cm"> * @param spacerName The name of the spacer. If it's an address element, the address element name will have the form {addressElement}.For example: {Country}, {City}...</span>
-<a name="line-397"></a><span class="cm"> * The function starts to scan the tree starting with currentBranch. When it finds a spacer containing an address element, it</span>
-<a name="line-398"></a><span class="cm"> * looks to see if the address element is found in addressElements list. If it's found, a new tag is added.</span>
-<a name="line-399"></a><span class="cm"> * @param currentBranch The branch from where the scan starts.</span>
-<a name="line-400"></a><span class="cm"> * @param currentRow The row of the current branch.</span>
-<a name="line-401"></a><span class="cm"> * @param addressElements A list containing address elements. Example: {Country}, {City}...</span>
-<a name="line-402"></a><span class="cm"> * @param elementsData A list containing the name of each address element found in elements. Example: France, Paris...</span>
+<a name="line-370"></a><span class="cm"> * @brief This function finds the best representative marker from a tile of markers.</span>
+<a name="line-371"></a><span class="cm"> * @param tileIndex Index of the tile from which the best marker should be found.</span>
+<a name="line-372"></a><span class="cm"> * @param sortKey Sets the criteria for selecting the representative thumbnail, a combination of the SortOptions bits.</span>
+<a name="line-373"></a><span class="cm"> * @return Returns the internally used index of the marker.</span>
+<a name="line-415"></a><span class="cm"> * @brief This function finds the best representative marker from a group of markers. This is needed to display a thumbnail for a marker group.</span>
+<a name="line-416"></a><span class="cm"> * @param indices A list containing markers, obtained by getTileRepresentativeMarker.</span>
+<a name="line-417"></a><span class="cm"> * @param sortKey Sets the criteria for selecting the representative thumbnail, a combination of the SortOptions bits.</span>
+<a name="line-418"></a><span class="cm"> * @return Returns the internally used index of the marker.</span>
-<a name="line-501"></a><span class="cm"> * Add new tags to tag tree. The function starts to scan the tree from root level. When it finds a spacer containing an address element</span>
-<a name="line-502"></a><span class="cm"> * , it looks to see if the address element is found in elements list. If it's found, a new tag is added.</span>
-<a name="line-503"></a><span class="cm"> * @param elements A list containing address elements. Example: {Country}, {City}...</span>
-<a name="line-504"></a><span class="cm"> * @param resultedData A list containing the name of each address element found in elements. Example: France, Paris...</span>
-<a name="line-505"></a><span class="cm"> * @return A list containing new tags</span>
+<a name="line-458"></a><span class="cm"> * @brief This function retrieves the thumbnail for an index.</span>
+<a name="line-459"></a><span class="cm"> * @param index The marker's index.</span>
+<a name="line-460"></a><span class="cm"> * @param size The size of the thumbnail.</span>
+<a name="line-461"></a><span class="cm"> * @return If the thumbnail has been loaded in the ThumbnailLoadThread instance, it is returned.</span>
+<a name="line-462"></a><span class="cm"> * If not, a QPixmap is returned and ThumbnailLoadThread's signal named signalThumbnailLoaded is emitted when the thumbnail becomes available.</span>
+<a name="line-529"></a><span class="cm"> * @brief The marker data is returned from the database in batches. This function takes and unites the batches.</span>
+<a name="line-577"></a><span class="cm"> * @brief Now, all the marker data has been retrieved from the database. Here, the markers are sorted into tiles.</span>
+<a name="line-650"></a><span class="cm"> * @brief Because of a call to pixmapFromRepresentativeIndex, some thumbnails are not yet loaded at the time of requesting.</span>
+<a name="line-651"></a><span class="cm"> * When each thumbnail loads, this slot is called and emits a signal that announces the map that the thumbnail is available.</span>
-<a name="line-921"></a><span class="cm"> * Deletes all spacers or all new tags below @currentBranch.</span>
-<a name="line-922"></a><span class="cm"> * @param currentBranch The tree branch from where the scan starts.</span>
-<a name="line-923"></a><span class="cm"> * @param currentRow The row of current branch.</span>
-<a name="line-924"></a><span class="cm"> * @param whatShouldRemove The tag type that should to be removed. The options are: spacers or new tags.</span>
-<a name="line-966"></a><span class="cm"> * Deletes all spacers or all new tags.</span>
-<a name="line-967"></a><span class="cm"> * @param currentIndex If whatShouldRemove represents a spacer, the function will remove all spacers below currentIndex.If whatShouldRemove represents a new tag, the function will delete all new tags.</span>
-<a name="line-968"></a><span class="cm"> * @param whatShouldRemove The tag type that should be removed. The options are: spacers or new tags.</span>
-<a name="line-994"></a><span class="cm"> * Readds new tags to tag tree.</span>
-<a name="line-995"></a><span class="cm"> * @param currentBranch The branch from where the scan starts.</span>
-<a name="line-996"></a><span class="cm"> * @param currentRow The row of the currentBranch.</span>
-<a name="line-997"></a><span class="cm"> * @param tagAddressElements A list containing address elements. Example: {Country}, {City}...</span>
-<a name="line-998"></a><span class="cm"> * @param elementsData A list containing the name of each address element found in elements. Example: France, Paris...</span>
+<a name="line-1004"></a> <span class="c1">/// @todo Somehow, a delay is necessary before emitting this signal - probably the order in which the filtering</span>
+<a name="line-1005"></a> <span class="c1">/// is propagated to other parts of digikam is wrong or just takes too long</span>
-<a name="line-1180"></a><span class="cm"> * Gets the spacers addresses below currentBranch. Address means the path from rootTag to currentBranch.</span>
-<a name="line-1181"></a><span class="cm"> * @param currentBranch The branch from where the search starts.</span>
+<a name="line-177"></a> <span class="s">"<para>In addition to the pixel content, image files usually "</span>
+<a name="line-178"></a> <span class="s">"contain a variety of metadata. A lot of the parameters you can use "</span>
+<a name="line-179"></a> <span class="s">"in digiKam to manage files, such as rating or comment, can be written "</span>
+<a name="line-180"></a> <span class="s">"to the files' metadata.</para> "</span>
+<a name="line-181"></a> <span class="s">"<para>Storing in metadata allows one to preserve this information "</span>
+<a name="line-182"></a> <span class="s">"when moving or sending the files to different systems.</para>"</span><span class="p">));</span>
+<a name="line-191"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveTagsBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item tags "</span>
+<a name="line-192"></a> <span class="s">"in the XMP and IPTC tags."</span><span class="p">));</span>
+<a name="line-196"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveCommentsBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store item caption and title "</span>
+<a name="line-197"></a> <span class="s">"in the JFIF Comment section, the EXIF tag, the XMP tag, "</span>
+<a name="line-198"></a> <span class="s">"and the IPTC tag."</span><span class="p">));</span>
+<a name="line-202"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveRatingBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item rating "</span>
+<a name="line-203"></a> <span class="s">"in the EXIF tag and the XMP tags."</span><span class="p">));</span>
+<a name="line-207"></a> <span class="n">d</span><span class="o">-></span><span class="n">savePickLabelBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item pick label "</span>
+<a name="line-208"></a> <span class="s">"in the XMP tags."</span><span class="p">));</span>
+<a name="line-212"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveColorLabelBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item color label "</span>
+<a name="line-213"></a> <span class="s">"in the XMP tags."</span><span class="p">));</span>
+<a name="line-217"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveDateTimeBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item date and time "</span>
+<a name="line-218"></a> <span class="s">"in the EXIF, XMP, and IPTC tags."</span><span class="p">));</span>
+<a name="line-222"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveTemplateBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the metadata "</span>
+<a name="line-223"></a> <span class="s">"template in the XMP and the IPTC tags. "</span>
+<a name="line-224"></a> <span class="s">"You can set template values to Template setup page."</span><span class="p">));</span>
+<a name="line-227"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveFaceTags</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store face tags "</span>
+<a name="line-228"></a> <span class="s">"with face rectangles in the XMP tags."</span><span class="p">));</span>
+<a name="line-256"></a> <span class="s">"Instead of synchronizing metadata, just schedule it for synchronization."</span>
+<a name="line-257"></a> <span class="s">"Synchronization can be done later by triggering the apply pending, or at digikam exit"</span><span class="p">));</span>
+<a name="line-282"></a> <span class="n">d</span><span class="o">-></span><span class="n">clearMetadataIfRescanBox</span><span class="o">-></span><span class="n">setText</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@option:check"</span><span class="p">,</span> <span class="s">"&Clean up the metadata from the database when rescan files"</span><span class="p">));</span>
+<a name="line-317"></a> <span class="s">"a standard used by most digital cameras today to store technical "</span>
+<a name="line-318"></a> <span class="s">"information (like aperture and shutter speed) about an image.</p>"</span><span class="p">));</span>
+<a name="line-326"></a> <span class="s">"a new standard used in digital photography, designed to replace IPTC.</p>"</span><span class="p">));</span>
+<a name="line-373"></a> <span class="s">"Rotate files only by changing a flag, not touching the pixel data"</span><span class="p">));</span>
+<a name="line-375"></a> <span class="s">"<para>A file can be rotated in two ways:<nl/> "</span>
+<a name="line-376"></a> <span class="s">"You can change the contents, rearranging the individual pixels of the image data.<nl/> "</span>
+<a name="line-377"></a> <span class="s">"Or you can set a flag that the file is to be rotated before it is shown.</para> "</span>
+<a name="line-378"></a> <span class="s">"<para>Select this option if you always want to set only a flag. "</span>
+<a name="line-379"></a> <span class="s">"This is less obtrusive, but requires support if the file is accessed with another software. "</span>
+<a name="line-380"></a> <span class="s">"Ensure to allow setting the flag in the metadata if you want to share your files "</span>
+<a name="line-386"></a> <span class="s">"<para>A file can be rotated in two ways:<nl/> "</span>
+<a name="line-387"></a> <span class="s">"You can change the contents, rearranging the individual pixels of the image data.<nl/> "</span>
+<a name="line-388"></a> <span class="s">"Or you can set a flag that the file is to be rotated before it is shown.</para> "</span>
+<a name="line-389"></a> <span class="s">"<para>Select this option if you want the file to be rotated by changing the content. "</span>
+<a name="line-390"></a> <span class="s">"This is a lossless operation for JPEG files. For other formats it is a lossy operation, "</span>
+<a name="line-391"></a> <span class="s">"which you need to enable explicitly. "</span>
+<a name="line-392"></a> <span class="s">"It is not support for RAW and other read-only formats, "</span>
+<a name="line-393"></a> <span class="s">"which will be rotated by flag only.</para>"</span><span class="p">));</span>
+<a name="line-396"></a> <span class="s">"Rotate files by changing the pixel data even if the operation will incur quality loss"</span><span class="p">));</span>
+<a name="line-404"></a> <span class="s">"When rotating a file by setting a flag, also change this flag in the file's metadata"</span><span class="p">));</span>
+<a name="line-432"></a> <span class="n">d</span><span class="o">-></span><span class="n">exifSetOrientationBox</span><span class="o">-></span><span class="n">setText</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set orientation tag to normal after rotate/flip."</span><span class="p">));</span>
+<a name="line-497"></a> <span class="n">d</span><span class="o">-></span><span class="n">readFromBalooBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Turn on this option if you want to apply changes to "</span>
+<a name="line-498"></a> <span class="s">"rating, comments and tags made in Baloo to digiKam's metadata storage. "</span>
+<a name="line-499"></a> <span class="s">"Please note that image metadata will not be edited automatically."</span><span class="p">));</span>
+<a name="line-521"></a> <span class="s">"provides the basis to handle all kinds of metadata on the KDE desktop in a generic fashion. "</span>
+<a name="line-522"></a> <span class="s">"It allows you to tag, rate and comment your files in KDE applications like Dolphin.</p> "</span>
+<a name="line-523"></a> <span class="s">"<p>Please set here if you want to synchronize the metadata stored by digiKam desktop-wide with the "</span>
+<a name="line-564"></a> <span class="s">"Turn on this option to read metadata from XMP sidecar files when reading metadata."</span><span class="p">));</span>
+<a name="line-570"></a> <span class="s">"Turn on this option to save, as specified, metadata to XMP sidecar files."</span><span class="p">));</span>
+<a name="line-608"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"<p>Add file types to be recognised as sidecars.</p>"</span>
+<a name="line-886"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"<p><b>Do you really want to enable metadata writing to RAW files?</b></p>"</span>
+<a name="line-887"></a> <span class="s">"<p>DigiKam delegates this task to the Exiv2 library. With different RAW "</span>
+<a name="line-888"></a> <span class="s">"formats, problems are known which can lead to the destruction of RAW "</span>
+<a name="line-889"></a> <span class="s">"files. If you decide to do so, make a backup of your RAW files.</p>"</span>
+<a name="line-890"></a> <span class="s">"<p><b>We strongly recommend not to enable this option.</b></p>"</span><span class="p">),</span>
+<a name="line-903"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"You would rather disable writing metadata to RAW files?"</span><span class="p">),</span>
-<a name="line-823"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Select a name for the new tag:"</span><span class="p">),</span>
-<a name="line-58"></a><span class="cm"> * @brief Marker model for storing data needed to display markers on the map. The data is retrieved from Digikam's database.</span>
-<a name="line-370"></a><span class="cm"> * @brief This function finds the best representative marker from a tile of markers.</span>
-<a name="line-371"></a><span class="cm"> * @param tileIndex Index of the tile from which the best marker should be found.</span>
-<a name="line-372"></a><span class="cm"> * @param sortKey Sets the criteria for selecting the representative thumbnail, a combination of the SortOptions bits.</span>
-<a name="line-373"></a><span class="cm"> * @return Returns the internally used index of the marker.</span>
-<a name="line-415"></a><span class="cm"> * @brief This function finds the best representative marker from a group of markers. This is needed to display a thumbnail for a marker group.</span>
-<a name="line-416"></a><span class="cm"> * @param indices A list containing markers, obtained by getTileRepresentativeMarker.</span>
-<a name="line-417"></a><span class="cm"> * @param sortKey Sets the criteria for selecting the representative thumbnail, a combination of the SortOptions bits.</span>
-<a name="line-418"></a><span class="cm"> * @return Returns the internally used index of the marker.</span>
-<a name="line-458"></a><span class="cm"> * @brief This function retrieves the thumbnail for an index.</span>
-<a name="line-459"></a><span class="cm"> * @param index The marker's index.</span>
-<a name="line-460"></a><span class="cm"> * @param size The size of the thumbnail.</span>
-<a name="line-461"></a><span class="cm"> * @return If the thumbnail has been loaded in the ThumbnailLoadThread instance, it is returned.</span>
-<a name="line-462"></a><span class="cm"> * If not, a QPixmap is returned and ThumbnailLoadThread's signal named signalThumbnailLoaded is emitted when the thumbnail becomes available.</span>
-<a name="line-529"></a><span class="cm"> * @brief The marker data is returned from the database in batches. This function takes and unites the batches.</span>
-<a name="line-577"></a><span class="cm"> * @brief Now, all the marker data has been retrieved from the database. Here, the markers are sorted into tiles.</span>
-<a name="line-650"></a><span class="cm"> * @brief Because of a call to pixmapFromRepresentativeIndex, some thumbnails are not yet loaded at the time of requesting.</span>
-<a name="line-651"></a><span class="cm"> * When each thumbnail loads, this slot is called and emits a signal that announces the map that the thumbnail is available.</span>
-<a name="line-1004"></a> <span class="c1">/// @todo Somehow, a delay is necessary before emitting this signal - probably the order in which the filtering</span>
-<a name="line-1005"></a> <span class="c1">/// is propagated to other parts of digikam is wrong or just takes too long</span>
-<a name="line-177"></a> <span class="s">"<para>In addition to the pixel content, image files usually "</span>
-<a name="line-178"></a> <span class="s">"contain a variety of metadata. A lot of the parameters you can use "</span>
-<a name="line-179"></a> <span class="s">"in digiKam to manage files, such as rating or comment, can be written "</span>
-<a name="line-180"></a> <span class="s">"to the files' metadata.</para> "</span>
-<a name="line-181"></a> <span class="s">"<para>Storing in metadata allows one to preserve this information "</span>
-<a name="line-182"></a> <span class="s">"when moving or sending the files to different systems.</para>"</span><span class="p">));</span>
-<a name="line-191"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveTagsBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item tags "</span>
-<a name="line-192"></a> <span class="s">"in the XMP and IPTC tags."</span><span class="p">));</span>
-<a name="line-196"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveCommentsBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store item caption and title "</span>
-<a name="line-197"></a> <span class="s">"in the JFIF Comment section, the EXIF tag, the XMP tag, "</span>
-<a name="line-198"></a> <span class="s">"and the IPTC tag."</span><span class="p">));</span>
-<a name="line-202"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveRatingBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item rating "</span>
-<a name="line-203"></a> <span class="s">"in the EXIF tag and the XMP tags."</span><span class="p">));</span>
-<a name="line-207"></a> <span class="n">d</span><span class="o">-></span><span class="n">savePickLabelBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item pick label "</span>
-<a name="line-208"></a> <span class="s">"in the XMP tags."</span><span class="p">));</span>
-<a name="line-212"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveColorLabelBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item color label "</span>
-<a name="line-213"></a> <span class="s">"in the XMP tags."</span><span class="p">));</span>
-<a name="line-217"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveDateTimeBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the item date and time "</span>
-<a name="line-218"></a> <span class="s">"in the EXIF, XMP, and IPTC tags."</span><span class="p">));</span>
-<a name="line-222"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveTemplateBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store the metadata "</span>
-<a name="line-223"></a> <span class="s">"template in the XMP and the IPTC tags. "</span>
-<a name="line-224"></a> <span class="s">"You can set template values to Template setup page."</span><span class="p">));</span>
-<a name="line-227"></a> <span class="n">d</span><span class="o">-></span><span class="n">saveFaceTags</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@info:whatsthis"</span><span class="p">,</span> <span class="s">"Turn on this option to store face tags "</span>
-<a name="line-228"></a> <span class="s">"with face rectangles in the XMP tags."</span><span class="p">));</span>
-<a name="line-256"></a> <span class="s">"Instead of synchronizing metadata, just schedule it for synchronization."</span>
-<a name="line-257"></a> <span class="s">"Synchronization can be done later by triggering the apply pending, or at digikam exit"</span><span class="p">));</span>
-<a name="line-282"></a> <span class="n">d</span><span class="o">-></span><span class="n">clearMetadataIfRescanBox</span><span class="o">-></span><span class="n">setText</span><span class="p">(</span><span class="n">i18nc</span><span class="p">(</span><span class="s">"@option:check"</span><span class="p">,</span> <span class="s">"&Clean up the metadata from the database when rescan files"</span><span class="p">));</span>
-<a name="line-317"></a> <span class="s">"a standard used by most digital cameras today to store technical "</span>
-<a name="line-318"></a> <span class="s">"information (like aperture and shutter speed) about an image.</p>"</span><span class="p">));</span>
-<a name="line-326"></a> <span class="s">"a new standard used in digital photography, designed to replace IPTC.</p>"</span><span class="p">));</span>
-<a name="line-373"></a> <span class="s">"Rotate files only by changing a flag, not touching the pixel data"</span><span class="p">));</span>
-<a name="line-375"></a> <span class="s">"<para>A file can be rotated in two ways:<nl/> "</span>
-<a name="line-376"></a> <span class="s">"You can change the contents, rearranging the individual pixels of the image data.<nl/> "</span>
-<a name="line-377"></a> <span class="s">"Or you can set a flag that the file is to be rotated before it is shown.</para> "</span>
-<a name="line-378"></a> <span class="s">"<para>Select this option if you always want to set only a flag. "</span>
-<a name="line-379"></a> <span class="s">"This is less obtrusive, but requires support if the file is accessed with another software. "</span>
-<a name="line-380"></a> <span class="s">"Ensure to allow setting the flag in the metadata if you want to share your files "</span>
-<a name="line-386"></a> <span class="s">"<para>A file can be rotated in two ways:<nl/> "</span>
-<a name="line-387"></a> <span class="s">"You can change the contents, rearranging the individual pixels of the image data.<nl/> "</span>
-<a name="line-388"></a> <span class="s">"Or you can set a flag that the file is to be rotated before it is shown.</para> "</span>
-<a name="line-389"></a> <span class="s">"<para>Select this option if you want the file to be rotated by changing the content. "</span>
-<a name="line-390"></a> <span class="s">"This is a lossless operation for JPEG files. For other formats it is a lossy operation, "</span>
-<a name="line-391"></a> <span class="s">"which you need to enable explicitly. "</span>
-<a name="line-392"></a> <span class="s">"It is not support for RAW and other read-only formats, "</span>
-<a name="line-393"></a> <span class="s">"which will be rotated by flag only.</para>"</span><span class="p">));</span>
-<a name="line-396"></a> <span class="s">"Rotate files by changing the pixel data even if the operation will incur quality loss"</span><span class="p">));</span>
-<a name="line-404"></a> <span class="s">"When rotating a file by setting a flag, also change this flag in the file's metadata"</span><span class="p">));</span>
-<a name="line-432"></a> <span class="n">d</span><span class="o">-></span><span class="n">exifSetOrientationBox</span><span class="o">-></span><span class="n">setText</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Set orientation tag to normal after rotate/flip."</span><span class="p">));</span>
-<a name="line-497"></a> <span class="n">d</span><span class="o">-></span><span class="n">readFromBalooBox</span><span class="o">-></span><span class="n">setWhatsThis</span><span class="p">(</span><span class="n">i18n</span><span class="p">(</span><span class="s">"Turn on this option if you want to apply changes to "</span>
-<a name="line-498"></a> <span class="s">"rating, comments and tags made in Baloo to digiKam's metadata storage. "</span>
-<a name="line-499"></a> <span class="s">"Please note that image metadata will not be edited automatically."</span><span class="p">));</span>
-<a name="line-521"></a> <span class="s">"provides the basis to handle all kinds of metadata on the KDE desktop in a generic fashion. "</span>
-<a name="line-522"></a> <span class="s">"It allows you to tag, rate and comment your files in KDE applications like Dolphin.</p> "</span>
-<a name="line-523"></a> <span class="s">"<p>Please set here if you want to synchronize the metadata stored by digiKam desktop-wide with the "</span>
-<a name="line-564"></a> <span class="s">"Turn on this option to read metadata from XMP sidecar files when reading metadata."</span><span class="p">));</span>
-<a name="line-570"></a> <span class="s">"Turn on this option to save, as specified, metadata to XMP sidecar files."</span><span class="p">));</span>
-<a name="line-608"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"<p>Add file types to be recognised as sidecars.</p>"</span>
-<a name="line-886"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"<p><b>Do you really want to enable metadata writing to RAW files?</b></p>"</span>
-<a name="line-887"></a> <span class="s">"<p>DigiKam delegates this task to the Exiv2 library. With different RAW "</span>
-<a name="line-888"></a> <span class="s">"formats, problems are known which can lead to the destruction of RAW "</span>
-<a name="line-889"></a> <span class="s">"files. If you decide to do so, make a backup of your RAW files.</p>"</span>
-<a name="line-890"></a> <span class="s">"<p><b>We strongly recommend not to enable this option.</b></p>"</span><span class="p">),</span>
-<a name="line-903"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"You would rather disable writing metadata to RAW files?"</span><span class="p">),</span>
<a name="line-688"></a> <span class="n">captionIndex</span> <span class="o">=</span> <span class="n">currIndex</span><span class="p">;</span> <span class="c1">// The line is ended</span>
<a name="line-865"></a> <span class="n">i18n</span><span class="p">(</span><span class="s">"Failed to upload photo into %1. %2</span><span class="se">\n</span><span class="s">Do you want to continue?"</span><span class="p">,</span>