Introduction

QuickImageComment displays EXIF, IPTC, and XMP properties of digital images (e.g. JPEG and TIFF) and allows to edit them. Especially editing of user comment and artist (author) is supported by using the last entered or predefined values. These attributes are read from the EXIF, IPTC, and XMP properties of the image and are stored there.

Overview of features:

The program also supports various RAW formats. In order to display the images, the Microsoft Camera Codec Pack needs to be installed additionally (http://www.microsoft.com/de-de/download/details.aspx?id=26829). The properties can be viewed and modified without the codec package.

Further processing of the images (e.g. adjusting the contrast and brightness) is not the purpose of this program.

For reading and changing the EXIF, IPTC, and XMP properties the library exiv2 of Andreas Huggel is used. On www.exiv2.org a description of this library can be found as well as extensive information and links to Exif, IPTC and XMP. The formats supported by exiv2 are documented here:

Created with the Personal Edition of HelpNDoc: Easily create CHM Help documents

Installation, Start, De-installation

Preconditions/Limitations:

An installation in the usual sense is not necessary. The zip file can be unpacked into any directory on your computer. Thereafter, the QuickImageComment.exe program or the 64-bit version QuickImageCommentX64.exe can be started. During the first start you will be asked for the language to be used and are offered the possibility, to check the availability of a new version automatically in the future.

After the first start the default settings in Mask "Settings" and Mask "Field definitions"  should be checked and adjusted according to your own needs. These and other settings during the use of the program will be written when exiting in a configuration file in% AppData% (see also User related configuration file).

When the program is started via command line, a folder- or filename can be passed as argument. If a shortcut to the program is added in folder "%Appdata%\Microsoft\Windows\SendTo", folder, images or videos can be opened via entry "Send to" in the context menu of Windows Explorer.

Folders, images or videos can be opened via drag-and-drop.

With some Browser also images from Internet can be opened via Drag-and-Drop. For this purpose they are downloaded into the folder "Downloads". geöffnet werden. This is tested with Google Chrome and Firefox, it does not work with Internet Explorer.

To uninstall the program delete the directory and the configuration file in% AppData%.

The registry is not changed by the program.

Created with the Personal Edition of HelpNDoc: Free CHM Help documentation generator

Main mask

The main mask and its usage are described in the following sections:

Via the menu bar of the main mask, symbols (see Tool bar) and sometimes keyboard shortcuts (see Keyboard shortcuts) following masks with additional functionalities can be opened:

Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle

Layout of mask and adjustments

The main mask is divided into several sections:

The following diagram identifies the areas:

Except for the picture all areas can be shown or hidden individually via the Mask "Adjust view". In the central input area fields for artist and comment can be individually enabled and hidden. In one of these areas image details and map can be displayed. For more details see chapters Display of image details and Recording location on map.

There is also the possibility of using the menu item "View - Image only and input fields" to hide all areas except the central input area. With selecting this menu item a second time the previous view is restored.

The size of the different areas can be adjusted by moving the grey dividing lines, where for each area a minimum size cannot be exceeded. For clarity, the dividing lines are black in the picture below:

Via the menu "View" (or Mask "Adjust view"), the toolbar can be displayed, hidden or displayed next to the menu. The last variant allows the use of symbols, but does not reduce the available height for the mask. However, then the symbols are relatively small.

Using the menu "View", the context menu (right-click in file list), or using the Mask "Adjust view" the file list can be shown in the following variants:

In view "tiles" additional to the file names up to five more freely selectable properties can be displayed in file list. The listed configurable input field properties and the properties displayed in the "Overview" tab can also be chosen free. The selection of properties is done in Mask "Field definitions", group "Display of files in view of "Tiles"", "Change of properties" and "display in tab "Overview"".

Size of thumbnails and spaces in views Thumbnail and Tiles can be adjusted via General configuration file.

Using the Mask "Adjust view" the content of all areas except the one with image and central input fields can be assigned at your choice.

For example, if you do not need the lists of recent and predefined comments and IPTC Keywords, you can hide them and thus have more space for the image and / or the display of the properties in the upper region as well as for the values in the Configurable input area:


Additionally the areas "Folder" and "File list" can be displayed side by side instead of one above the other for a better usage of wide monitors:

The same is possible for the both areas on the right hand side, on top with image, properties and IPTC keywords, on bottom with last and predefined keywords and configurable input area.

In addition, the appearance of the mask can be largely customized itself. For more detail see Mask "Customize mask". These customizations can be removed using the menu item "Tools - Remove adjustments all masks".

Created with the Personal Edition of HelpNDoc: Generate Kindle eBooks with ease

Selection and display of images

Note: In the following description, it is assumed that all areas are displayed (see also Layout of mask and adjustments) and the contents of the fields are not exchanged.

Via the folder list on the upper left hand side a folder is selected. In the area below its images are displayed. If files have been added, deleted or renamed by another program, select menu item "File - Refresh file list" folder and the file list will be updated. The list can also be updated using symbol (see Tool bar) or via a keyboard shortcut (see Keyboard shortcuts). If folders have been added, deleted or renamed by another program or an USB storage device has been added or removed, the folder list can be refreshed using menu item "File - Refresh folder tree".

The files can be filtered. Therefore a textbox is located above the file list. The beginning of the file name of files to be displayed can be entered. With Return key or Ok button next to the text box the filter is activated.

Using the menu "View", the context menu (right-click in file list), or using the Mask "Adjust view" the file list can be shown in the following variants:

The properties shown in the view "Tiles" can be selected in the Mask "Field definitions", group "Display of files in view "Tiles"". The mask can be opened via context menu in file list (in this case directly with selection of group) or via menu.

The column width in the view "List" corresponds to the column width for column "Name" as set in view "Details".

Several grids can be displayed in top of the image, for example to examine the distortion of a lens or to "measure" details. Using entry "Define grid ..." in menu "View" the Mask "Define grid" can be opened to define up to six grids. With the menu item "Image with grid" display of grid is switched on or off. By moving the mouse while holding down the right mouse button over the image, the grid can be moved. If image details are displayed (see Display of image details), the grid will be moved, when the mouse pointer is outside the frame, which marks the detail area. If the mouse pointer is inside the frame while holding the right mouse button, the Details section is moved.

The image selected in the file list is displayed in the middle of the mask in the tab "Single image edit". Via symbols (see Tool bar), the menu "Zoom/Rotate" or shortcut (see Keyboard shortcuts) the magnification can be changed and the image can be rotated. The rotation of the image is only for display, the image file itself is not changed.

The magnification can be selected:

In the settings 1:4 to 8:1 magnification depends on the resolution of the image.

In the "Zoom/Rotate" menu is the option to select a magnification factor. This does not refer to the pixels, but to the size of the image in the available frame. Factor "x 2" means, that the image is displayed twice as large as with "fit" - regardless of the resolution of the image.

In case the image is bigger than the available space, the visible area can be shifted using the scroll bars on bottom and right or by moving the mouse with left button pressed.

Right to the tab "Single image edit" are five tabs in which properties of the image are displayed:

Errors may be reported by the library exiv2 when reading the properties, such as "The memory contains data of image at unknown type".

For the tables in the tabs Exif, IPTC, XMP and Other You can use the context menu (right mouse button) or the Mask "Adjust view" to select one of the following views:

This is the default view. The properties are assigned to different groups. Before each group the group name is displayed in a grey shaded cell. By clicking in the grey line the properties belonging to the group can be shown or hidden.

In this view, the group name does not appear on a separate line but is at the beginning of the tag name, so a little more width is required for viewing. In this view, the columns can be sorted, e.g. by the tag.

In this view, the group name does not appear on a separate line but is at the end of tag name. In this way properties can be sorted regardless of their group. This is useful (especially in case of manufacturer-specific properties) if you do not know in which group a property can be found. In addition, there are properties that are included in different groups - these are then also with each other.

Same as "List with Headings", tag names in English

Same as "Simple list", tag names in English

Same as "Simple list, group at the end", tag names in English.

Hint for language "German":

In the views "List with Headings" and "Simple List" mainly German tag names are displayed. If the meaning of the tag and thus a correct translation was not sure, it was not translated and the original (English) name is displayed. Translations are possible chosen so that tags belonging together are together in the sort.
Example: "Category" and "SuppCategory" were translated as "Kategorie" and "Kategorie zusätzlich", not as "Kategorie" and "zusätzliche Kategorie".
In this way the sorting in display with group at the end has a higher benefit for German than for English.

In the tabs Exif, IPTC and XMP the description of the property (if available) is displayed when the mouse hovers over the first column.

On the far right, the IPTC key words are displayed. IPTC key words can be predefined in the program (Mask "Predefined IPTC key words"). The pre-defined key words are listed here with a checkbox. Additional key words (free text) can be directly assigned to the image. These are entered in the field at the top.

On the bottom right is the configurable input area. Here configurable properties are displayed, which can be changed there too. The properties can be selected in the Mask "Field definitions", group "Change of properties". The mask can be opened via context menu in this area (in this case directly with selection of group) or via menu.

Created with the Personal Edition of HelpNDoc: Free Web Help generator

Selection and display of videos

In addition to the display of images and their properties, frames from video files and their properties can be displayed. The remarks of Selection and display of images also apply to videos. The program basically supports all video file types, which are also supported from the library exiv2 (www.exiv2.org). In the Mask "Settings", the file extensions can be defined, which are displayed in the file list. For them the metadata are displayed.

For videos other properties can be selected than for images to be displayed in tab "Overview" and for display of files in the view "Tile". For this purpose the list for the group of properties in Mask "Field definitions" contains following entries:

The display of frames from the video file depends on the operating system and possibly from installed components. Unfortunately I could not find a solution that works on all (still) popular Windows operating systems. If no frame can be displayed, unfortunately this is not directly shown by a corresponding notice, but shows up in the way, that after a certain delay a black screen will appear. Therefore, in the Mask "Settings" separately it can be defined, for which video file types a frame is displayed. Depending on the video file and computer it can take a long time until a frame is displayed. This may be a reason to avoid the display of frames without having to sacrifice the display of metadata.

It is not the first frame of the video, which is displayed, but a frame after a predetermined time difference from the start. The pre-set can be defined in the Mask "Settings". Below the frame (above the file name), a different frame position can be selected for each video individually.

Changes in the metadata of video files are not possible.

The display of the video itself is not part of the program, but - as long as the respective video type is supported by the system - is possible by double click in the file list. This will open the program that is associated with the appropriate file type.


Created with the Personal Edition of HelpNDoc: Easily create CHM Help documents

Display of image details

The image details can be shown in two ways:

The display of image is useful for:



Bottom left you can see the image section. The visible area of image can be shifted by moving the mouse with left button pressed. Above and on the right graphics represent the brightness profile along the horizontal and vertical centrelines.

In the right part are:

By selecting "variable" the slider below the selection list for setting the magnification factor is enabled.

Various fixed magnifications of 4:1 to 1:5 can be selected directly.

With the "1:3 grid" and "1:5 grid", the pixels of the image are represented by 3x3 or 5x5 pixels. A grid line is placed centrally over the pixels in order to assign the pixels in exactly their values in the graphs.

In the main picture box the displayed detail section is marked by a frame with horizontal and vertical centreline. When the mouse pointer is within the frame, the detail section can be shifted by moving the mouse while holding the right mouse button.

The information for image details is preferably displayed in a region which is in landscape mode. If the area is in portrait mode (taller than wide), the graphics are displayed in the upper part, the other controls are shown below.

Examples of use:

Examination of vignetting:

Testing of colour noise of an image taken with compact camera and ISO-setting:

In the following picture you can clearly see that although the narrow lines on the right hand side can be seen separated, the difference between light and dark line becomes increasingly much smaller:

Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle

Recording location on map

The recording location on map can be shown in two ways:

For display of recording location on a map OpenStreetMap is used. The license conditions of OpenStreetMap have to be considered:
https://www.openstreetmap.org/copyright

In the displayed map section two buttons "+" and "-" are shown in the upper left corner to select the zoom factor.

In case the selected image contains GPS-coordinates, the corresponding map section is displayed and the recording location is marked. The map section can be moved with the mouse. Via moving the marker, a new position can be set, which then can be stored in the image together with the other changed data (e.g. comment).

In case the selected image does not contain GPS-coordinates, the map section around the last used position will be displayed without marker. By using the right mouse button a marker can be set, which also can be moved later.  

Below the map section you find:

The bottom right corner of the map contains links to "Leaflet" (this component is used to display the map) and "OpenStreetMap". After switching to one of these sites, a button "Back" is shown to return to the previous content.

Created with the Personal Edition of HelpNDoc: Full-featured EBook editor

Single image edit

For the editing of single images the tab is "single image edit" has to be selected.

Below the picture are:

The name can be entered directly. When you save the name, it will be entered in a list so that the name later can be selected from the list or is completed after entering the first letter.
If no artist was entered for the image, a default can be used (defined in the Mask "Settings"). If the default is entered, this is indicated by a note behind the combo box.

The label of the input field is dynamic. If in the Mask "Settings" no field (tag) has been configured to store the name, "not configured" is displayed as the label and the input field is not active. If exactly one field is configured to store the name, this field will be displayed. If more than one value is configured, the input field is labelled with "Artist (author)".

The label of the input field is dynamic. If in the Mask "Settings" no field (tag) has been configured to store the name, "not configured" is displayed as the label and the input field is not active. If exactly one field is configured to store the name, this field will be displayed. If more than one value is configured, the input field is labelled with "Comment".

Two lists are available for an easier entry of the comment:

Entries from the two lists can be transferred via the context menu of the list (right mouse button) or via a keyboard shortcut in the text field for comment:

For the assignment of IPTC keywords there are two options in the input area on the far right:

Configurable input area

On the bottom right there is a configurable area in which additional properties can be changed. The configuration is done in the Mask "Field definitions", group "Change of properties". The mask can be opened via context menu in this area (in this case directly with selection of group) or via menu.

On the left hand side of each input field is the description, supplemented by the data type of the field. If multiple values allowed for a property by the program, the text box is displayed with vertical scroll bar. The number of rows displayed is configured in Mask "Field definitions". One row corresponds to one value. Properties, for which only one value is allowed, are displayed in a combo box. This makes it possible to select recently entered values for this property.

For properties of type "date" there is a small button on the right hand side of the input field:

With this button a calendar is opened to select a date. For properties, which can have several values, only the first date can be set via the calendar.


For property "Exif.Image.Orientation" (type: Short), a drop down list shows the valid (numeric) values together with an explanation (e.g. "bottom, left (180° + horiz.flip)"). After saving changes of Exif.Image.Orientation, image will be rotated accordingly.

For Exif properties the program allows only one value. For IPTC and XMP properties it depends on the particular property or the data type. According to the Exif specification, it seems permissible to assign several values to each property and the library exiv2 used in the program allows it too. However, there is (almost) no Exif property for which multiple values are meaningful and also other programs usually do not support it. Therefore, this program allows only one value per Exif property. If multiple values were assigned to an Exif property with another program, these values will be shown as one string in the input box, separated by vertical bar ("|"). This string can then be changed. Only one value is stored then.

Special features are XMP properties of the data type "LangAlt". For them multiple values can be defined, with one value for the default language and one value for each additional language. The mask contains a corresponding number of input boxes for each property. The languages can be selected in the Mask "Settings".

In the following example, the input fields for the XMP property Xmp.dc.title are shown. As a description "XMP title" was configured. The text box directly on the right hand side of this label is used for the value of the default language, below fields for German (Germany) and French (France):

In case in the image a value is defined for a language that is not selected in Mask "Settings", it is displayed additionally and the value for this language can be changed too.

XMP properties of the data type "XmpText" can have very complex values, such as the following value, which was added by Windows Live Photo Gallery as information about people displayed in the image:

/MPRI:Regions[1]/MPReg:Rectangle=0.210938, 0.477372, 0.079102, 0.119708

/MPRI:Regions[1]/MPReg:PersonDisplayName=Max Mustermann

/MPRI:Regions[2]/MPReg:Rectangle=0.498047, 0.421898, 0.084961, 0.125547

/MPRI:Regions[2]/MPReg:PersonDisplayName=Barbara Beispielfrau

/MPRI:Regions[2]/MPReg:PersonEmailDigest=1234567890ABCDEF1234567890ABCDEF12345678

/MPRI:Regions[2]/MPReg:PersonLiveIdCID=1234567890123456789

/MPRI:Regions[2]/MPReg:PersonSourceID=WL:1234567890123456789

This program can not verify the validity of those values. On the other hand, usually you will change such complex values also with the program, with which the values originally were assigned initially. But in this particular example, you could delete the values for individual email Digest, PersonLiveIdCID and PersonSourceID for reasons of data protection before distributing the image. For the same reason you might also just save the first name instead of the full name. In this way not the whole information is lost, who is displayed in the picture.

With the F10 key or double-click in the box, a mask is opened to have a larger and variable input range for long and / or multi-line values. In this screen, also older entries for this property can be selected:

Reset entries

The inputs for artists, comment and IPTC keywords as well as in the configurable input range can be reset by pressing the Esc key and the corresponding values from the image are displayed again. With the menu item "Image - Reset" or the corresponding icon (see Tool bar), all inputs to the image reset.

Restrictions

Some properties can be changed, but cannot be added. This is especially true for vendor-specific EXIF information and for the more complex XMP data structures. If properties could not be added, a message is displayed after saving.

Save changes

The changes can be saved by:

For these menu items, there are also icons in the toolbar (see Tool bar) and keyboard shortcuts (see Keyboard shortcuts).


Created with the Personal Edition of HelpNDoc: Full-featured multi-format Help generator

Multiple images edit

In order to edit several images in one batch the tab "Multi image edit" has to be selected.

To change the properties of several images together, these images first have to be selected.  But you also can add images to the selection later. If all images have same value for one property (e.g. all images have the same artist), this value is also displayed.  If they have different values, the corresponding field is left blank.

On the right hand side in the tab "Multi image edit" a table with the selected images and their current values will be displayed for the chosen properties. The properties can be defined in Mask "Field definitions", group "Table view during multiple editing". The mask can be opened via context menu in the table (in this case directly with selection of group) or via menu. By clicking on the column header the images are sorted by the column. By clicking on a line the corresponding image will be selected and will be displayed when you switch to tab "Single image edit".

The values for properties are input in the appropriate fields as described in Single image edit.

For each property you can decide whether they are to be taken over for all images. For the comment you have following possibilities:

For the IPTC key words you have following possibilities:

For all other values you can define via checkboxes whether the value is taken over or not.

The changes are saved using the menu entry "Image - Save", the corresponding icon (see Tool bar) or the associated keyboard shortcut (see Keyboard shortcuts) saved.

Note:

The tab "Multi image edit" can also be used just to see different properties for a selection of images in one table. That is reason why you can select any property in Mask "Field definitions" and you are not limited to editable properties there.

Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily

Placeholders for properties

In the input fields you can use placeholder for other properties. Possible use cases are:

  1. With Windows Live Photo Gallery people can be recognized in images. The names are stored in an XMP property, which many other programs do not show. You can copy the names of using a placeholder into another property (e.g. Exif.Photo.UserComment) so that they are visible in other programs (e.g. when distributing images to people who do not use the Windows Live Photo Gallery).
  2. When you enter the artist (author), a copyright notice is generated at the same time.
  3. Changes will be logged.
  4. If in the past different properties were used to comment the images, the comments can be copied to one property.

The definition of the placeholders for these use cases is explained further below.

The definition of the holders is done by a simple text entry, which is only checked when saving the image. The spelling of the properties must be exact - in compliance with upper and lower case. When replacing placeholders by values, there is a check if the property is contained in the image or not - but not if the property name in principle is known. Placeholders with misspelled names are replaced by an empty string. There is no message issued, when the property name is not known. Placeholder must use the English tag names.

Hence the urgent recommendation: prove the notation exactly and whenever possible first try it with a test image.

It is possible to define placeholder for properties, in which in turn another placeholder is entered. Up to five levels are supported in this way.

Here the notation for the placeholders:

Placeholder for the current value

The property name is to be put in double braces, e.g.:

{{Iptc.Application2.Caption}}

When saving the image, the placeholder is replaced by the current value of the property in the format "interpreted" (see Mask "Field definitions"). Meaning of "current" is: If the property was changed in the mask, the changed value is used, otherwise the value already stored in the image.

Placeholder for the stored value

The property name with a leading "#" is to be put in double braces, e.g.:

{{#Iptc.Application2.Caption}}

When saving the image, the placeholder is replaced by the value last stored.

Placeholder with substring

After the name of the property, separated by a semicolon, a starting position and optionally after another semicolon, the length of the substring can be given. If a negative value is given as the start position, the starting position is counted from the end of the string.

If Iptc.Application2.Caption has the value "abcdefgh", you get following results for placeholders:

{{Iptc.Application2.Caption;3}} = cdefgh
{{Iptc.Application2.Caption,3,4}} = cdef
{{Iptc.Application2.Caption;-4}} = efgh
{{Iptc.Application2.Caption;-4;2}} = ef

Placeholder with formatting

Unless indicated otherwise, the interpreted value is used. The third statement after the name formatting can be chosen from:

If Exif.Photo.ExposureTime has the value "1/60", you get following results for placeholders:

{{Exif.Photo.ExposureTime}} = 1/60 s
{{Exif.Photo.ExposureTime;;;o}}  = 1/60
{{Exif.Photo.ExposureTime;;;d3}} = 0.017

The specification of the formatting may be combined with substring, but this hardly will be used: Only for numeric data types, the original value differs from the interpreted value and a substring of a numerical value probably is not meaningful.

Placeholder for properties with multiple values

Some properties can have multiple values. This is true for properties of the data types XmpSeq and XmpBag and some IPTC properties. The placeholder is replaced by a string, in which all values are listed, separated by ", ". The third statement after the name can be defined with "s". Then the values are sorted. As a fourth statement after the name you may define a different string for separating the values.

If Xmp.dc.creator has the value "John Doe" and "Barbara Smith", you get following results for placeholders:

{{Xmp.dc.creator}} = John Doe, Barbara Smith
{{Xmp.dc.creator;;;s}} = Barbara Smith, John Doe
{{Xmp.dc.creator;;;s; and }} = Barbara Smith and John Doe

Additionally again, the definition of a substring is possible. This refers to the result of the previous replacements (not to the individual values) and therefore hardly will be used:

{{Xmp.dc.creator;9;14;s; and }} = Smith and John

Placeholder for data type LangAlt - with specific language

The data type LangAlt allows specifying values in multiple languages for one property. The placeholder is replaced by a string, in which all values are listed, separated by ", ". As for properties with multiple values, the string for separating the values can be defined.

If Xmp.dc.description has the value "Description" for the default language (x-default) and for German (de-DE) has the value of "Beschreibung", you get following results for placeholders:

{{Xmp.dc.description}} = Description, de-DE: Beschreibung
{{Xmp.dc.description;;;; / }} = Description / de-DE: Beschreibung

Additionally again, the definition of a substring is possible. This refers to the result of the previous replacements (not to the individual values) and therefore hardly will be used.

You can also specify a specific language. This is done by adding "|" after the name of the property:

{{Xmp.dc.description|x-default}} = Description
{{Xmp.dc.description|de-DE}} = de-DE Beschreibung

By definition of a substring the language definition can be hidden:

{{Xmp.dc.description|de-DE;7}} = Beschreibung

Placeholder for the current date and time

With the placeholder {{Date}} or {{Datum}} and {{Time}} or {{Uhrzeit}} the current date and the current time can be inserted.

Placeholder definitions for initially listed use cases
  1. Persons recognized by Windows Live Photo Gallery:
    Windows Live Photo Gallery writes the names of the persons and other data (position in the image, if applicable Windows Live ID) into Xmp.MP.RegionInfo. In order to obtain the names the following placeholder has to be used:
    {{Xmp.MP.RegionInfo/MPRI:Regions[]/MPReg:PersonDisplayName}}
    The order results from the order in which Windows Live Photo Gallery writes the values into Xmp.MP.RegionInfo. This may not necessarily be from left to right. Therefore, it may be useful generally to sort the names in order to have a clear order:
    {{Xmp.MP.RegionInfo/MPRI:Regions[]/MPReg:PersonDisplayName;;;s}}
  2. Copyright notice:
    If you enter Your name in Exif.Image.Author, you can create a following placeholder to create a copyright notice:
    Copyright {{Date;;4} {{Exif.Image.Artist}}
    When You want to add a copyright notice for older images, you can take the year from the date of recording:
    Copyright {{Exif.Photo.DateTimeOriginal;;4}} {{Exif.Image.Artist}}
  3. Logging of changes:
    With the following definition the date, time and name is added to an existing entry in Exif.Image.ImageHistory:
    {{#Exif.Image.ImageHistory}}; {{Date}} {{Time}} John Doe
    If this is applied several times, it gives a list showing who has applied changes when.
  4. Collecting Comments:
    There are some properties that are usable to enter a comment for an image. When various properties such as Exif.Image.ImageDescription, Exif.Photo.UserComment, Iptc.Application2.Caption, Xmp.dc.description and Xmp.dc.title were used in several images, their values can be copied to Exif.Photo.UserComment using following placeholder:
    {{Exif.Image.ImageDescription}}{{#Exif.Photo.UserComment}}{{Iptc.Application2.Caption}}{{Xmp.dc.description}}{{Xmp.dc.title}}
    In front of Exif.Photo.UserComment a "#" is added. As the complete placeholder definition is entered in the field for Exif.Photo.UserComment, the placeholder for Exif.Photo.UserComment has to refer to the last saved value for Exif.Photo.UserComment.
    The placeholders are specified without delimiters, as it is assumed in this example that only one of the properties is filled. If multiple properties may be filled, a separator should be added:
    {{Exif.Image.ImageDescription}}, {{#Exif.Photo.UserComment}}, {{Iptc.Application2.Caption}}, {{Xmp.dc.description}}, {{Xmp.dc.title}}le
    Then it may happen that nothing is between the delimiters, because the properties are not defined. A manual rework then cannot be avoided.

Created with the Personal Edition of HelpNDoc: Easily create EPub books

Other features

Menu "File"

Open ...

Opens an input mask to open folders or files via entering the full name (i.e. including complete path). Also URLs can be entered, the respective file will then be downloaded into folder "Downloads".

Select all

All images displayed in the file list are selected, e.g. to rename them.

Refresh folder tree

The directory tree is updated; necessary if a folder was added, renamed or deleted folder or if USB storage devices are added or removed.

Refresh file list

The file list is updated; necessary if files have been added, renamed or deleted by another program.

Rename files

Opens Mask "Rename files"

Compare files

Opens Mask "Compare files"

Change recording date/time

Opens Mask "Change recording date and time"

Remove meta data

Opens Mask "Remove meta data"

Export: selected properties of images in folder

Writes selected properties of all the images contained in one directory, including subdirectories, into a file. The file contains a header with the name of the exported properties and for each image one line with the values. The columns are separated by tabs, so that the file easily can be opened with Excel or another spreadsheet calculation program.

Use Mask "Field definitions" (group: "Export of properties in text file") to define, which properties are exported.

Export: all properties of selected images

Writes all properties of the selected images into files; for each image one text file with all properties (meta-data) of the image is created.

Set file date to date image generated

The file properties "Created at" and "Modified at" can be set to the date/time when image was generated. The date when image was generated is read from Exif.Photo.DateTimeOriginal. The property can be changed in General configuration file.

Exit

Exit the program

Menu "Image"

Save

Save the changes in the image

First

Save the changes in the current image and switch to the first image

Previous

Save the changes in the current image and switch to the previous image

Next

Save the changes in the current image and switch to the next image

Last

Save the changes in the current image and switch to the last image

Reset

Changes in current image made since the last save are reset

Delete

Delete the selected image files, if it applies with associated files (see Mask "Settings", setting "rename and delete also for following file extensions")

Menu Tools

Settings

Opens Mask "Settings"

Field definitions

Opens Mask "Field definitions"

Predefined comments

Opens Mask "Predefined comments"

Predefined IPTC key words

Opens Mask "Predefined IPTC key words"

Image in own window

An addition window is opened, in which only the image is displayed. If a second screen is available, it can be used to display the picture there at its maximum size.

Image details in own window

An addition window is opened to show the image details (see Display of image details).

Hint: only possible, if image details are not yet displayed in main mask; useful if two monitors are available.

Map in own window

An addition window is opened to show a map (see Recording location on map).

Hint: only possible, if map is not yet displayed in main mask; useful if two monitors are available.

Customize mask

Opens Mask "Customize mask"

Remove all mask adjustments

Removes all adjustments in all masks, which were defined using Mask "Customize mask" and set to default values again.

Language

For selection of language (Deutsch, English)

Storage location for user settings

Opens a mask to display and change the storage location for user settings:


%Appdata%:

If several users are created on the computer, each user has his own settings.

Settings are kept during upgrade on newer program version.

Program folder can be write-protected.


Program folder:

Recommended for portable usage on USB-stick: the settings are on USB-stick too, no settings will be stored on other computer.

When upgrading to a newer program version, settings need to be copied manually or program files in currently used folder have to be overwritten.

Menu ?

List shortcut keys

Lists all shortcut keys for all masks

About ...

Displays mask with program information (version, etc.)

Check for new version ...

Opens Mask "Check for new version"

Webpage

Direct access to the website www.quickimagecomment.de: Homepage with recent messages, tutorials, contact form and download area

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Free PDF documentation generator

Tool bar

Via the menu "View" the tool bar can be displayed or hidden or displayed in the same row as the menu. The last option allows using the symbols without reducing the usable height of the main mask. However, then the symbols are rather small.

List of symbols:

Refresh file list

Opens Mask "Rename files"

Opens Mask "Change recording date and time"

Save

Save image and switch to first image

Save image and switch to previous image

Save image and switch to next image

Save image and switch to last image

Reset of changes since last save

Delete image files, if it applies with associated files (see Mask "Settings", setting "rename and delete also for following file extensions")

Zoom - fit (whole image is displayed)

Zoom - 1:4 (show image with scale 1:4)

Zoom - 1:2 (show image with scale 1:2)

Zoom - 1:1 (show image with scale 1:1)

Rotate image to the left (only for display, no change in image)

Rotate image to the right (only for display, no change in image)

Opens Mask "Adjust view"

Opens Mask "Settings"

Opens Mask "Field definitions"

Opens Mask "Predefined comments" to enter and change predefined comments

Opens Mask "Predefined IPTC key words" to enter and change predefined IPTC key words

Created with the Personal Edition of HelpNDoc: Full-featured EBook editor

Keyboard shortcuts

The following general shortcut keys are defined:

F2

Opens Mask "Rename files"

F5

Refresh file list

F6

Show image and central input fields only

F7

Rotate image to the left (only for display, no change in image)

F8

Rotate image to the right (only for display, no change in image)

F11

Save image and switch to previous image

F12

Save image and switch to next image

Ctrl-1

Zoom - 1:1 (show image with scale 1:1)

Ctrl-2

Zoom - 1:2 (show image with scale 1:2)

Strg-4

Zoom - 1:4 (show image with scale 1:4)

Ctrl-Shift-2

Zoom - 2:1 (show image with scale 2:1)

Ctrl-Shift-4

Zoom - 4:1 (show image with scale 4:1)

Ctrl-Shift-8

Zoom - 8:1 (show image with scale 8:1)

Ctrl-E

Opens Mask "Settings"

Ctrl-F

Zoom - fit (whole image is displayed)

Ctrl-I

Opens Mask "Predefined IPTC key words" to enter and change predefined IPTC key words

Ctrl-K

Opens Mask "Predefined comments" to enter and change predefined comments

Ctrl-L

Delete image file

Ctrl-S

Save

These shortcut keys can be modified and new can be defined, see Mask "Customize mask". The current settings are displayed using menu entry "? - List shortcut keys".

Additionally in special areas some shortcut keys are defined, which cannot be changed.

In the lists for last and predefined comments:

Return key

Transfer (overwriting the text field for comment)

Space bar

Append with space

Comma

Append with comma

Semicolon

Append with semicolon

In all input fields for properties:

Esc

Reset input and show again the value saved in the image file

In input fields of configurable input are:

F10

Open a mask with larger and variable input field

In the input field for comment:

Return key

Save and show next image (if configured)

In the input field for file filter above the file list:

Return key

Refresh the file list using the filter

Created with the Personal Edition of HelpNDoc: Easily create Web Help sites

Footer

In the footer are displayed:


Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator

Mask "Adjust view"

In this mask the view of the main mask can be adjusted. The main task of this mask is to define the mapping of the various contents (folder list, file list, ...) to the display areas and to show or hide the display areas.

Example: If you do not need the lists of recent and predefined comments, you can use the area to the left of the configurable input area to show the IPTC key words and thus you have a bit more space for the image and / or the display of the properties.

Additionally following adjustments are possible:

In each panel is a selection list to select the content for these display area. The content will possibly be exchanged, i.e. (starting from the setting shown in the picture) after selecting "Files" rather than "Folder" in the list on the top left, in the display area below "Folder" will be displayed instead of "Files.

The checkbox allows hiding the display area when the corresponding content is not needed. This gives you more space for the other contents and the display is more clearly laid out.

For the central input area the selection list allows to specify whether the input fields for artists and comment (individually, both, none) are displayed.

The main mask is separated in two areas, on the left hand side with Folder on top and Files on bottom, on the rights hand side with Image, Properties and IPTC key words on top and Comment lists and Configurable edit area on bottom. For both areas the horizontal split (top and bottom) can changed to a vertical split (left and right) with the black check boxes. In this way wide monitors can be used more efficient.

The user defined settings can be saved with a name and activated again via the drop down list.

Command buttons:

Standard

Mapping of content to display areas according standard (like right after installation)

Only image and central input fields

Only the picture and the central input fields for artists and comment will be displayed

Optimized for read-only

Only the content is shown, which are usually interesting to see the pictures and read the properties; Contents normally needed to change data (central input area, IPTC key words, comment lists, configurable input range) are hidden.

Display image details

Similar to "Optimized for read-only "; additionally, image details are displayed (see Display of image details)

Display map

Similar to "Optimized for read-only "; additionally, a map is displayed (see Recording location on map)

Save

Saves the user defined settings with the name displayed in the drop down list

Delete

Deletes the user defined settings with the name displayed in the drop down list

Save as ...

Saves the user defined settings with a new name

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Close

Close mask

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator

Mask "Settings"

In this mask the most important settings for the program can be changed. Further adjustments are described in Mask "Adjust view", Mask "Field definitions", Mask "Predefined comments", Mask "Predefined IPTC key words", Mask "Customize mask" and Adjustment and configuration.

The following table describes the various settings:

Keep backup from image file

File before saving remains as a backup file with the extension ..._ bak (e.g. for .jpg-file as .jpg_bak).

Before you save, a backup file is always generated regardless of this setting. If this option is not enabled, the backup file is deleted after the file is saved. If during saving a fatal error occurs, which leads to a program abort, the backup file is retained, even if this option is not enabled.

In field comment: Save with Return and show next image

When the focus is in the text field for comment, with return key the image is saved and the next one is displayed.

In field comment: with cursor down switch to list of recent comments

With the key "cursor down" focus moves into the list of recent comments so that you directly can select an appropriate comment.

In case of error or conspicuity in meta data: bar in list "Overview"


In case an error or a conspicuity is detected in the meta data, a bar (standard colour: red) appears in the list "Overview" on the left. A conspicuity can be:

  • If for artists or comment several properties were elected for saving and these properties have different values (e.g. Exif.Image.ImageDescription contains something else than in Exif.Photo.UserComment and in both - according to the configuration - the comment should be contained
  • For one of the properties for artists and comment there are several entries in the image.
  • Error while reading meta data by exiv2 can be reported, e.g. "The memory contains data of image at unknown type"

In case of error or conspicuity in meta data: show message box

In case an error or conspicuity is detected in the meta data, a message box is shown.

Navigation with tab to split bar

The tab key can be uses also to navigate to the split bars (grey bars between areas). Thus You can adjust the size of the areas with the keyboard.

Single Edit: if no artist entered, use:

If an image is displayed in single image edit, for which no artist is entered yet, the name given here is displayed by default (with a note behind the combo box for artists).

Maximum number of recent user comments, which are saved

When saving images, the comments are saved in a list (last entries as first) so that you can use them for the following pictures again. When you exit the program, the maximum specified number of entries is stored in the configuration file, so that they are available again when you start the program the next time.

Maximum number of values for "artist", which are saved

When saving images, the entries for artist are saved in a list (last entries as first) so that you can use them for the following pictures again. When you exit the program, the maximum specified number of entries is stored in the configuration file, so that they are available again when you start the program the next time.

Maximum number of values per configurable input field, which …

When saving images, the entries for fields in configurable input area are saved in a list (last entries as first) so that you can use them for the following pictures again. When you exit the program, the maximum specified number of entries for each input field is stored in the configuration file, so that they are available again when you start the program the next time.

This setting is also valid for the maximum number of GPS positions, which are saved for the search list in map display.

At mouse double click in list box of predefined comments

Here you can set the action that is executed after a double click on an item in the list box of predefined comments. Possibilities are:

  • Overwrite
  • Append with space
  • Append with comma
  • Append with semicolon

At inserting: check, if text ends with one of the following characters:

In the case of multiple image editing comment can inserted before the existing one. You can get it checked that there is a separator in between. Valid delimiters can be defined here. If the text to be inserted does not end with one of these characters, a warning is issued and you can decide whether the text is still pasted, and images are stored in this way.

At appending: check, if text starts with one of the following characters:

In the case of multiple image editing comment can appended after the existing one. You can get it checked that there is a separator in between. Valid delimiters can be defined here. If the text to be appended does not start with one of these characters, a warning is issued and you can decide whether the text is still pasted, and images are stored in this way.

rename and delete also for following file extensions
consider from files (separated by ";"):

Some programs create additional files for image files that have the same name but a different file extension (e.g. image.xyz related to image.jpg). Here such file extensions ("xyz") can be given so that these additional files are also renamed or deleted when renaming or deleting the image file.

Settings for caching:

Maximum number of images, which are buffered for display

In order to speed up the display of previous or next images, they can be read in advance from disk. This setting defines how many images are read into the buffer. In contrast to the buffer configured via the subsequent setting, in the buffer configured here, the images are read completely and therefore this buffer consumes more memory.

Settings for caching:

Maximum number of images, which are buffered for file list

In order to speed up scrolling in file list, thumbnail images or properties of images can be read in advance from disk. This setting defines how many images are read into the buffer.

Settings for caching:

Maximum used main memory (above no further caching)

Apart from the two previous settings via the number of images read into buffers you can also define the maximum memory used for caching. This setting applies to both buffer areas together. For this setting consider the total available main memory.

Note: In the footer of the main mask the main memory currently used by the program is displayed.

Save comment in

The contents of the text field for comment on the main mask can be saved in:

  • Exif-Tag "Exif.Image.ImageDescription (character encoding is ASCII)
  • Exif-Tag "Exif.Photo.UserComment
  • IPTC-Tag "Iptc.Application2.Caption"
  • XMP-Tag "Xmp.dc.description" (with language code lang=x-default)
  • XMP-Tag "Xmp.dc.title" (with language code lang=x-default)
  • Field "JPEG comment", called by some programs "Image Comment"

Artist (author) save in

The contents of the text field for artist (author) On the main mask can be saved in:

  • Exif-Tag "Exif.Image.Artist"
  • IPTC-Tag "Iptc.Application2.Writer"
  • XMP-Tag "Xmp.dc.creator"

Languages
(for XMP data type Lang-Alt)

The XMP data type lang-Alt allows defining values in different languages for a tag. Here you can select for which languages an input field is always displayed in the configurable input area.

The languages to select from are defined in the general configuration file. For more information, see General configuration file.

Video: File extensions - display properties (separated by ";"):

Video files with specified file extensions will be displayed in the file list and their metadata are read.

Video: File extensions - display a frame (separated by ";"):

For video files with the specified file extensions, a frame is displayed.

Video: Frame Position [s]

Defines the position of the displayed frame in seconds from the start of the video

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

OK

Save changes and close mask

Cancel

Close mask without saving changes

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Free help authoring tool

Mask "Field definitions"

At various places of this program field (or tag) information is displayed. In this mask you select which fields are displayed in these places. For some places you also can select the display format.

This mask and its use are described in the following sections:

Please consider Hints on special properties and Hints on data types too.

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

OK

Save changes and close mask

Cancel

Close mask without saving changes

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Easily create PDF Help documents

Layout of mask

The mask is roughly divided into two parts.

In the upper part is a list of the available meta-data with tag name, data type, and description:

Above the list on the left there are the possibilities

Near to it - in the middle - there is a selection list to jump directly to the beginning of a group of properties. Besides EXIF, IPTC and XMP (each with sub-groups), there are three groups:

On the right hand side is a text box and two buttons (backward, forward) to search for tags, e.g. to search for all tags containing "time" in the name or description.

If a tag is been selected in the list and an image is displayed in the main mask, the value of the tag will appear below the list, once in the original form and in addition in an interpreted form. "Exif.Photo.FNumber" for examples is displayed originally as "45/10", interpreted as "4.5".

In the lower part field definitions are displayed and can be changed:

On the left hand side is a selection list of groups of field definitions and below the list of corresponding entries. On the right hand side of this list are command buttons to:

On the right hand side the definition of the selected item in the list is displayed and can be changed there. Below the fields for definition - if an image is displayed on the main mask - the value of this definition is displayed.

For field definitions of the group "Change of properties " additionally the display of the input field can be customized:

Created with the Personal Edition of HelpNDoc: Free Kindle producer

Create new field definition

First select the group, for which you want to create the field definition. This is done with the list on the left between the tag list and list of field definitions (Initial value: "Display in tab "Overview" - Image).

The groups are:

Select a tag in the list on top. You may use the selection list for groups of properties (top centre) or the search functionality to find the tag wanted.

The Selected tag is used as Meta data 1.

More details in Change field definition.

Created with the Personal Edition of HelpNDoc: Free Kindle producer

Change field definition

The details on the item are displayed on the right hand side.

For datatypes "Rational" and "SRational" additionally:

For date values additionally:

Note referring to the options, in which both the interpreted value and the original value is displayed:
If the interpreted value is identical to the original value, only one value is displayed.

If previously an image has been selected in the main window, the resulting value for that image is displayed in below these fields.

The definition can combine two Meta data, e.g. to show the image size, which is given by two values in the EXIF data, in one value ("2560 x 1920").

Created with the Personal Edition of HelpNDoc: What is a Help Authoring tool?

Define Input Check

The Mask "Field definitions" has three buttons to create, edit and delete input check configurations for the selected field. For technical reasons input check configurations are available only for fields allowing only one value. The buttons are disabled for fields allowing multiple values.

The input check configuration allows to specify a list of valid values, e.g. for the tag, in order to assure that only defined categories are used. After pressing "Create" or "Edit" following mask opens:

In the text box in the middle the valid values can be entered, each line is one value.

Below this text box is the check box "allow other values". When this is checked, also other values can be entered in the configurable input area of main mask. When this is done, user is asked if the value shall be added to this list of valid values. In this way in exceptional cases an "invalid" value can be entered, but more important, this is an easy way to add new valid values. If the check box is not checked, only one the value of the list can be selected.

Command buttons:

Sort

Sorts the entries in the text box

Customize mask

Customize the mask, more details in Mask: "Customize mask".

OK

Save the settings and close mask

Cancel

Close mask without saving settings

Help

Displays the help for this mask



Created with the Personal Edition of HelpNDoc: Easily create HTML Help documents

Hints on special properties

Define

Properties of the group "Define" are defined via the General configuration file. Based on existing tags new tags can be defined by extracting single strings. This can be used to reformat the values of tags (e.g. to another date format).

ExifEasy

Some information can be stored both in the general Exif properties as well as in manufacturer-specific properties. Other information is stored only in the manufacturer-specific properties. Properties of the group "ExifEasy" allow it to access these values without referring to a specific camera manufacturer. If the values are determined, the various properties assigned to it are searched.

Two examples:

ExifEasy.LensName

Some makers store the lens name directly, others store a a lens-Id. exiv2 translates these lens-Ids to lens names based on a mapping included in the program itself. However there are Ids, which are not yet included in the built in mapping, and some IDs are not unique. For these Ids the mapping kann be defined in exiv2.ini.

File

In group "File" file properties (such as file size, modified date) are summarized.

Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator

Hints on data types

Exif, IPTC and XMP use different data types. For some data types, the following hints should be considered:

IPTC - Character Encoding

IPTC tags are written in UTF-16 format in little-endian byte order. It seems most of the programs can read this encoding. IPTC tags can be read in UTF-8 format, provided in Iptc.Envelope.CharacterSet the identifier for UTF-8 according to IPTC specification is entered.
Note: because of this special meaning Iptc.Envelope.CharacterSet cannot be selected as changeable property.

Comment (Exif)

This type is used only for Exif.Image.ImageDescription. Before the value itself the character encoding is defined. In this program, ASCII is used (charset="ascii"). The character encoding is only visible in the display format "original" (see Change field definition).

Date (IPTC)

The format is: YYYY-MM-DD

Example: 2012-04-28

LangAlt (XMP)

With this data type values can be specified in different languages. One value is for the default language (x-default).

ReadOnly

Values of this data type cannot be changed. Basically, it consists of two groups:

Time (IPTC)

The format is HH:MM:SS+hh:mm where hh:mm is the time zone correction relative to UTC. The indication of seconds and time zone correction are optional. They may be added when leaving the input field.

Examples: 14:23:02+02:00   14:23:00   14:23

Undefined

This data type is usually used for binary data. Values of this data type are displayed as a sequence of bytes in decimal form and therefore are barely legible. These values cannot be changed by the program.

XmpText

The name suggests that any text can be entered. However, there are some tags that according specification should contain only numeric values (e.g. Xmp.photoshop.Urgency, valid range 1 - 8). Among some other tags of this type complete data structures are stored, for example, as follows:

Xmp.iptcExt.LocationCreated

Xmp.iptcExt.LocationCreated[1]

Xmp.iptcExt.LocationCreated[1]/Iptc4xmpExt:CountryName

Xmp.iptcExt.LocationCreated[1]/Iptc4xmpExt:ProvinceState

Xmp.iptcExt.LocationCreated[1]/Iptc4xmpExt:City XmpText

Xmp.iptcExt.LocationCreated[1]/Iptc4xmpExt:Sublocation


The following example is taken from an image, where person's markings were added with Windows Live Photo Gallery:

Xmp.MP.RegionInfo

Xmp.MP.RegionInfo/MPRI:Regions

Xmp.MP.RegionInfo/MPRI:Regions[1]

Xmp.MP.RegionInfo/MPRI:Regions[1]/MPReg:Rectangle

Xmp.MP.RegionInfo/MPRI:Regions[1]/MPReg:PersonDisplayName

Xmp.MP.RegionInfo/MPRI:Regions[1]/MPReg:PersonEmailDigest

Xmp.MP.RegionInfo/MPRI:Regions[1]/MPReg:PersonLiveIdCID

Xmp.MP.RegionInfo/MPRI:Regions[1]/MPReg:PersonSourceID

XmpText is therefore a very flexibly usable data type. Therefore, I cannot guarantee that this program covers all occurring ways of using the data type XmpText.

Numeric data types - general

The values of numeric data types may be change. Examples for these values are shutter speed, aperture and resolution. For these examples, and for the vast majority (if not all) numerical values, it is not useful to change them after the capture. For some tags (e.g. Exif.Image.ExifTag = pointer to EXIF IFD) additionally, there is the risk that an incorrect value leads to the fact that the metadata no longer be readable at all.

As a change hardly makes sense and can possibly lead to problems, a warning is issued when a Meta date with a numeric data type is selected for the list of changeable properties. This approach aims to avoid the problems caused by incorrect inputs. However, in principle you can change numerical data.

Byte

Integer value, range: 0 to 255

SByte

Integer value, range: -128 to 127  

Short

Integer value, range: 0 to 65535

SShort

Integer value, range: -32768 to 32767  

Long

Integer value, range: 0 to 4294967295

SLong

Integer value, range: -2147483648 to 2147483647

Float

Decimal number: enter a dot as a decimal separator, e.g. 123.456

The value is often not stored exactly as it is typed. E.g. entering 2.4 results in 2.40000009536743 

Double

Decimal number: enter a dot as a decimal separator, e.g. 123.456

Rational

Rational number (fraction), numerator and denominator are of type Long, separated by slash. Example: 12/100

SRational

Rational number (fraction), numerator and denominator are of type Slong, separated by slash. Example: -12/100

Created with the Personal Edition of HelpNDoc: Create iPhone web-based documentation

Mask "Define grid"

With this mask you can define grids, which are laid over the image.

Up to six grids can be defined. It is also possible to display several grids one over the other.

For each grid you can define:

The line types are:

For the line type "with scale" can be defined additionally:

For the line type "dashed" can be specified additionally:

For the line type "cross hairs" can be defined additionally:

The values are given in pixels on the image.

If "Apply grid changes immediately (Attention: results in waiting times for refreshing image)" is checked, any change of grid is applied directly. Depending on the detail level of the grid, this can cause longer waiting times for refreshing the image.

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Apply grid

The grids checked in "Show" are laid over the image.

Apply and Close

The grids checked in "Show" are laid over the image and the mask is closed.

Cancel

Close mask without saving changes

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Create HTML Help, DOC, PDF and print manuals from 1 single source

Mask "Change recording date and time"

With this mask you can be modify recording date and time. First, date and time can be changed for all images. For this select grouping "all" in the drop down on top left. But you can also make change only for a selection of images so that the time is synchronized with the time with other images retroactively.  

Examples:

The second, more complex case is described now in more detail:

First you have to mark the images in the main mask, whose recording date and time is to be changed. Then open this mask (via menu or toolbar). The selected images (here a sequence in which an excavator lifts his bucket) are displayed:

On the top left is a selection list, which allows select groups the images. Images of the chosen group are highlighted in grey. The default setting for the group is a manufacturer and model of camera. This setting can be adjusted by selecting "other grouping" in the selection list (or by opening the Mask "Field definitions" via menu and selecting group "Grouping during changing recording date/time ").

On the top right are input controls to shift the recording time for the selected images.

You can now by comparing the clocks in the different cameras the correction or you successively move to the correct value. After each change of the correction values the images are sorted accordingly, while no corrected time is stored in the images yet.

In this particular example, the recording times for the images taken with the COOLPIX P300 are put back by one minute:

Now, the images appear in a plausible chronological order. By pressing the command button "Start", the corrected recording time is written to the image files and the mask is closed.

Notes:

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Start

Change date and time and then close the mask.

Cancel

Close mask without changing date and time

Help

Displays the help for this mask


Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework

Mask "Rename files"

With this mask you can rename files.

First you have to select the images to be renamed in the main mask. Then open this mask via menu or toolbar.

The mask is roughly divided into four input area:

In eleven lines you can be chose fields from which the file name is composed. For each line you have:

With two command buttons the sequence of rows can be changed.

Here it is defined:

Certain characters such as ":" must not occur in the file name. If any of these characters appears in the content of a field, it is replaced with the character below. If not for all the characters a replacement character is defined, the last replacement character is used.
Directly below this field the file name is displayed, which is the result of these settings for the first file selected to rename.

Hints to the settings in the example:

With the settings shown in the screenshot files are renamed as follows:

The rows of three, four and five are not active.

If the line one is disabled and the lines three to five enabled, you get an example how you could rename test images to check the noise behaviour:

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Start

Rename files and then close the mask.

Cancel

Save settings and close mask without renaming files

Help

Displays the help for this mask


Created with the Personal Edition of HelpNDoc: Free help authoring tool

Mask "Compare files"

With this mask you can compare Meta data of several files.

First you have to select the images to be compared in the main mask. Then open this mask via menu or toolbar. The files are compared and the different Meta data are displayed. Meta data that have the same value in all images are not displayed.

By clicking on one of the headers (e.g. Exif.Image.DateTime) you can sort the images according the values in this column. When the mouse pointer hovers over the column heading, the description of the property is displayed (if available).

Options for display are:

Initially the data are displayed in interpreted format, e.g. "Exif.Photo.FNumber" is shown interpreted as "4.5". Using the checkbox on top left you can switch to "Original format". "Exif.Photo.FNumber" is then displayed as "45/10".

This option is usable only if language is not set to English. For languages others than English a translation of the tag names may be available. If translations are available initially the names of the properties are displayed in the selected display language. When this checkbox is checked always English names are displayed.
Note for German translations: If the meaning of the tag and therefore the correct translation was not sure, the translation was omitted and the original (English) name is displayed.

With the checkbox "Show thumbnails", the display of thumbnails can be switched on and off.

Some values are rather uninteresting for comparison, e.g. "Exif.Image.ExifTag" in the screen shot above. In order not to compare these values any longer, click on a value in the column and then the command button "Not further comparison of marked values". You can also select several columns with Ctrl or a region with Shift and click in order to remove them together from the comparison. It is important to click the values and not on the header, because by clicking the column header the sort order is changed.

The chosen columns are stored in the settings.

This button opens the Mask "Field definitions" and selects the group "Exceptions during comparing files". Here you can delete the columns (so that they are no longer excluded from comparison) or chose other properties from the list of properties in order to exclude them from the comparison.

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Close

Close the mask.

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Write EPub books for the iPad

Mask "Remove meta data"

With this mask you can remove Meta data (properties).

There are limitations resulting from dependencies of single Meta data. Following limitations are considered in the program:

Dependencies can also lead to the fact that individual properties are not deleted, even though they are not defined as exceptions. I noticed so far:

Other special situations are possible, which can lead to the fact that properties are not removed as expected or exceptions are ignored. New settings in this screen (or corresponding configurations in Mask "Field definitions") therefore should be first tried with copies of the images.

The mask allows two different approaches to remove Meta data:

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Start

Start removing meta data

Cancel

Close mask without removing meta data

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Easily create Help documents

Mask "Image Details"

With this mask, image details can be shown. This is also possible via adjustment (Mask "Adjust view") in one of the areas of the main mask. However, with this mask more space is available, which is especially useful if a second monitor is available.

For each selected image one window is shown. This allows to compare image details of several images, e.g. to find the image with best sharpness. The last opened window is superior to the other windows. This means:

Further details are described in Display of image details.

Command buttons in lower part of the mask:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Close

Close mask

Other windows equal

Transfer the settings of superior window to secondary windows

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Create cross-platform Qt Help files

Mask "Map"

With this mask, recording location can be shown on a map and associated data can be changed. This is also possible via adjustment (Mask "Adjust view") in one of the areas of the main mask. However, with this mask more space is available, which is especially useful if a second monitor is available.

Further details are described in Recording location on map.

Command buttons in lower part of the mask:

Customize mask

Customize the mask, more details in Mask: "Customize mask".

Close

Close mask

Help

Displays the help for this mask

Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily

Mask "Predefined comments"

In this mask you can predefine comments that are then displayed on the main screen in the list "Predefined comments". These comments can be divided into categories. According to these categories the list "Predefined comments" in the main mask can be filtered.

Lines with "#" at the beginning define a category, all other lines are comments to the category above.

In the following example, two categories are defined: "Places" and "persons":

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask"

OK

Save changes and close mask

Cancel

Close mask without saving changes

Help

Displays the help for this mask


Created with the Personal Edition of HelpNDoc: Free EPub producer

Mask "Predefined IPTC key words"

In this mask you can define IPTC key words that are displayed in the main mask in the area "IPTC key words" with check box.

Each row defines an IPTC key word, spaces in the key word will be accepted.

Command buttons:

Customize mask

Customize the mask, more details in Mask: "Customize mask"

OK

Save changes and close mask

Cancel

Close mask without saving changes

Help

Displays the help for this mask


Created with the Personal Edition of HelpNDoc: Create iPhone web-based documentation

Mask "Customize mask"

With this mask you can customize following properties of a mask:

In the advanced settings (show and hide using menu "Tools - Advanced settings") you can customize additionally:


Created with the Personal Edition of HelpNDoc: Produce electronic books easily

Select controls and adjust

In the left part of the screen is a tree with all the controls of the mask. After starting the mask you the control is selected, in which had the focus. Another control can now be been selected in the tree or by setting the focus on a control in the mask to be customized (e.g. the main mask).

Some controls (e.g. labels, i.e. fixed text) can be not selected in mask to customize. These are then accessible only via the tree.

With the checkbox "Multiple selection" above the tree you can chose, whether several controls can be selected in the tree at the same time.

Another possibility selection is using the menu "Selection" to select all controls or all controls of a certain type (e.g. System.Windows.Forms.Label = fixed text).

The selected controls are displayed in the mask to customize with a red frame. The colour of the frame can be changed using the menu entry "Tools - Border colour for marking".

In the area to the right you may change settings for the selected controls. With the command buttons "Reset" you restore the original values (i.e. the state of delivery).

Foreground and Background colour:

With several command buttons you can directly assign a colour. With the command button "Others ...", any other colour can be selected. If you want to use this colour more often, you can assign them to one of the command buttons using the menu entry "Tools - Customize mask". Another window will open, in order to customize the customization mask itself. There you can change the background colour for the command buttons.

Background image and font

With the command buttons "Select ..." a mask to select a picture or font is opened.

Shortcut key

To assign a shortcut key to a control, you have to set the focus into the text box and then press the desired key combination. An editing of the text box is not possible. With the back key, the delete key or the esc key the assignment is deleted.

Created with the Personal Edition of HelpNDoc: Free Kindle producer

Extended settings and other extras

Advanced Settings

The advanced settings are displayed or hidden using menu "Tools - Advanced settings".

The advanced settings allow users to change the mask layout fundamentally:

Note: While the Zoom setting can have a practical use (enlarge to improve legibility, downsizing to display more information), the other settings are more likely not relevant in practice.

Border colour for marking

The selected controls are displayed in the mask to customize with a red frame. The colour of the frame can be changed using the menu entry "Tools - Border colour for marking".

Customize mask

Using the menu entry "Tools - Customize mask" you can also customize the customization mask itself.

Reset all settings

With the menu entry "Tools - Reset all settings" you can reset all settings of that mask back to their original values (factory setting).

List shortcut keys

With the menu entry "Tools - List shortcut keys" all shortcut keys assigned in the mask are listed.

Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle

Saving and loading of settings

The settings that are made using this mask are stored in a separate configuration file. The name of this file is stored in the general configuration file (see General configuration file).

In the File menu you have the following options:

Load settings - overwrite

Via a separate mask, a configuration file is opened. The existing settings are deleted and the settings in the file to be loaded.

Load settings - supplement

Via a separate mask, a configuration file is opened. The existing settings are not deleted. The settings from the file are loaded. If there is an existing setting and the file contains a different value, the existing value is overwritten.

Save settings

The changed settings are stored in the configuration file. If there is no associated configuration file, the menu item is not selectable (grey). Otherwise, the file name of the configuration file is also displayed in the menu entry.

Save settings as ...

The settings are stored in a configuration file. Name and location to are given in a mask.

Close

Close the mask.

If settings have been made, but these are not yet stored, you will be ask when quitting the program, if they should be saved or not.

The configuration file is a simple text file and can be edited with a text editor. But this carries the risk that errors are made that make the file unreadable for the program.

In the program directory some sample files are included (FormCustomization-xxx.ini). Their purpose is just to illustrate, which customizations are possible. Use in practice is not intended.

Created with the Personal Edition of HelpNDoc: Free CHM Help documentation generator

Mask "Check for new version"

The program can check if a new version is available. With this mask you can start this check and can configure if and in which time interval the check is performed automatically at program start.

The mask contains (from top to bottom);

Created with the Personal Edition of HelpNDoc: Easily create iPhone documentation

Adjustment and configuration

There are several ways to customize or configure the program.

How to adjust the main mask is described in Layout of mask and adjustments.

Several masks are available to adjust different settings:

Further adjustments can be done in the configuration files:

This chapter also contains information about configuration files to support different languages:

Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator

User related configuration file

The settings made in the program (via the various masks for configuration) and further information such as the recently displayed folder, size of masks, etc. are stored in a configuration file. Default setting:

Here %APPDATA% is an environment variable and has depending on the operating system normally following value:

Vista and Windows 7, 8, 10

C:\Users\{username}\AppData\Roaming

Windows XP

C:\Documents and Settings\{username}\Application Data

This folder is hidden by default. The easiest way to view the content when the folder is hidden and/or you do not exactly know where it is: Enter %APPDATA% in the field on top of the File Explorer.

The storage location for user settings can be changed via menu entry "Tools - Storage location for user settings":

If several users are created on the computer, each user has his own settings.

Settings are kept during upgrade on newer program version.

Program folder can be write-protected.

Recommended for portable usage on USB-stick: the settings are on USB-stick too, no settings will be stored on other computer.

When upgrading to a newer program version, settings need to be copied manually or program files in currently used folder have to be overwritten.

When you start the program, the settings are read from the configuration file and are saved when you quit. This configuration file is a simple text file and therefore in principle can be edited with an editor. But this carries the risk that errors are made that make the file unreadable for the program.

In the following cases editing with an editor can be useful:

Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator

General configuration file

The program package includes a general configuration file, which is located in the program directory:

In this file contains you can make additional settings. However, it must be noted that with a new version of the program also a modified or enhanced configuration file is supplied. So it is better, if you copy the file into the folder% APPDATA% (see instructions in User related configuration file), there delete all rows that are not to be changed and adjust only the remaining settings and/or add further settings. Settings of the general configuration file in %APPDATA% have priority over the settings of the file in the program directory.

The following settings can be adjusted or amended by the user:

Define new tags

Based on existing tags you can define new tags by extracting individual strings. This can be used to reformat the values of tags.  

Syntax:

Define:<name of the new tag>=<name of existing tags>|<prefix>|<Start1>-<Finish1>||<Start2> - <time2>| ...

Descri:<name of the new tag>:<Description of the new tag>

Example 1:

Define:PhotoDateOriginal_YYYYMMDD=Exif.Photo.DateTimeOriginal||1-4||6-7||9-10|

Descri:PhotoDateOriginal_YYYYMMDD:The date when the original image data was generated in format YYYYMMDD

Here the colons are removed from the Exif-tag Photo.DateTimeOriginal. The value of the tag is e.g. "2012:03:21". The new tag consists of the first four characters (the year), the sixth and seventh (month) and finally the ninth and tenth (day), which results in "20120321".

Example 2:

Define:PhotoDateOriginal_YYYYMMDD=Exif.Photo.DateTimeOriginal|a|1-4|-|6-7|-|9-10|

Descri:PhotoDateOriginal_YYYYMMDD:The date when the original image data was generated in format aYYYY-MM-DD

Here in the Exif-tag Photo.DateTimeOriginal colons are replaced by hyphens and "a" is added as prefix. "2013:03:21" is changed to "a2012-03-21".

Date/time formats

For date values five different date formats can be defined. The definition consists of a name, which is displayed in the selection list for display formats in Mask "Field definitions", and the format specification itself.

Syntax:

DateFormat1_Name:<Format-Name>

DateFormat1_Spec:<Format-Specification>

In the format specification following placeholders can be used:

d

The day of the month, from 1 through 31.

dd

The day of the month, from 01 through 31.

ddd

The abbreviated name of the day of the week.

dddd

The full name of the day of the week.

h

The hour, using a 12-hour clock from 1 to 12.

hh

The hour, using a 12-hour clock from 01 to 12.

H

The hour, using a 24-hour clock from 0 to 23.

HH

The hour, using a 24-hour clock from 00 to 23.

m

The minute, from 0 through 59.

mm

The minute, from 00 through 59.

M

The month, from 1 through 12.

MM

The month, from 01 through 12.

MMM

The abbreviated name of the month.

MMMM

The full name of the month.

s

The second, from 0 through 59.

ss

The second, from 00 through 59.

t

The first character of the AM/PM designator.

tt

The AM/PM designator.

y

The year, from 0 to 99.

yy

The year, from 00 to 99.

yyy

The year, with a minimum of three digits.

yyyy

The year, with four digits.

yyyyy

The year, with five digits.

Further hints see: https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.71).aspx

Example:

DateFormat1_Name:<weekday short> DD.MM.YYYY HH:mm:ss

DateFormat1_Spec:ddd dd.MM.yyyy HH:mm:ss

Define alternative values

Some tags have only a code as value which is hard to understand. The vast majority of these are converted to a text by the underlying library exiv2, but you can define your own additionally mapping table.  

Syntax:

value:<name of the tag>: <value> = <translation>  

Example:

Value: Exif.Photo.Saturation: 0 = normal

Here for the Exif tag Photo.Saturation "normal" displayed as interpreted value if the original value is 0.

The supplied configuration file contains a mapping table with the most important Exif tags, where the lines are commented. The values are taken from the Exif specification and differ sometimes from the translation in the library exiv2. This table can be activated by removing the semicolon at the beginning of the line (and possibly translate the texts into your preferred language).

Language definitions for XMP.Datentyp LangAlt

The XMP data type long-Alt allows for a tag to store values in different languages. In the Mask "Settings" you can select, for which languages an input field is always displayed in the configurable input area. Which languages are offered in Mask "Settings" can be defined.

Syntax:

XmpLangAlt#:<Sprach-Definition> <Sprach-Beschreibung>
where # is a number from 1 to 5.  

Example:

XmpLangAlt1:de-DE Deutsch (Deutschland)

The valid values for the language definition are included as comments in the general configuration file. The language description can be adapted.

File modification date when saving

In the default configuration, the file modification date is updated when saving. With the entry

KeepFileModifiedTime:yes

the old file modification date is kept when saving the file. The modification date then shows the last change, which was executed with another program, e.g. a program with which the picture itself was changed and not just the Meta data.

Tag which holds date when image was generated

According Exif specification "Exif.Photo.DateTimeOriginal" ist the tag provided in a digital camera for recording date and time. If for Mask "Change recording date and time" and "Set file date to date image generated" another tag shall be used, following line has to be adjusted:

TagDateImageGenerated:Exif.Photo.DateTimeOriginal

Definitions for views "Thumbnail" and "Tile"

Display in views Thumbnail and Tile can be adjusted, all values in pixel:

Example:

ThumbNailSize:100

TileDescWidth:150

TileVerticalSpace:5

LargeIconHorizontalSpace:10

LargeIconVerticalSpace:20

All other settings in the general configuration file are used for testing purposes and should not be changed.


Created with the Personal Edition of HelpNDoc: Easily create iPhone documentation

TagLookup-file

The program package includes a lookup file for German, which is located in the program directory: QIC_TagLookup_Deutsch.ini. This file is used when the language is set to "German".

In this file translations for tag names and descriptions can be entered and changed. However, it must be noted that with a new version of the program also a modified or enhanced lookup file is supplied. So it is better, if you copy the file into the folder% APPDATA% (see instructions in User related configuration file), there delete all rows that are not to be changed and adjust only the remaining entries and/or add further entries. Settings of the lookup file in %APPDATA% have priority over the settings of the file in the program directory.

Syntax for translation of a tag name:

META_KEY:<original tag name>=<translated tag name>

Example:

META_KEY:Define.FileCreated_ExifFormat=Define.Datei erzeugt (Exif-Format)

Note: in translations you may not add additional points (e.g. for abbreviations), because the point is used as a delimiter for the grouping.

For example, the tag "Exif.Fujifilm.MaxApertureAtMaxFocal" is translated as "Exif.Fujifilm.Max Blende bei max Brennweite" and thus is displayed as "Max Blende bei max Brennweite" under the heading "Exif.Fujifilm". If it would be translated as "Exif.Fujifilm.Max. Blende bei max. Brennweite", it would be displayed as "Brennweite" under the heading "Exif.Fujifilm.Max. Blende bei max.".

Syntax for a replacement tag description:

META_DESC:<original tag description>=<translated tag description>

Example:

META_DESC:Define.FileCreated_ExifFormat=Datum/Uhrzeit, wann die Datei im Exif-Datum/Uhrzeit-Format Exif erstellt wurde (JJJJ:MM:DD hh:mm:ss)


Created with the Personal Edition of HelpNDoc: Free PDF documentation generator

Language files

Quick Image Comment is multilingual. The basic version is German, the tag names and descriptions are in English, because they are provided by the library exiv2 (which is in English).

The following language files are supplied with the program:

QIC_TagLookup_Deutsch.cfg

(Incomplete) translation of tag names and descriptions to German, see also TagLookup-file

QIC_Language_Deutsch.cfg

List with German texts, which are used by the program dynamically, such as error messages

QIC_Language_English.cfg

List with English texts, which are used by the program dynamically, such as error messages, as well as English translations of static text in the masks (labels)

These files can be changed (at own risk).

In principle new languages can be supported without program changes if an appropriate QIC_Language_xxx.cfg is created. Program changes are only necessary if it is not possible to keep the translations so short that they fit into the available space. A corresponding QIC_TagLookup_xxx.cfg is not required. If it does not exist (or is incomplete as the German) English names and descriptions are used.


Created with the Personal Edition of HelpNDoc: Easily create Qt Help files

exiv2.ini

Starting with version 0.26 exiv2 optionally uses an initialisation file named exiv2.ini. QuickImageComment looks for this file in the location of the general configuration file.


Some makers define a lens-Id. For display of ExifEasy.LensName exiv2 translates these lens-Ids to lens names based on a mapping included in the program itself. However there are Ids, which are not yet included in the built in mapping, and some IDs are not unique. For these Ids the mapping kann be defined in exiv2.ini. Here an example:



# comment


[canon]

110=Samyang 35mm F1.4 AS UMC

247=Samyang 14mm f/2.8 AE ED AS IF UMC


[nikon]

146=a nikon lens


[pentax]

3 255 0 0=a pentax lens


[minolta]

255=a sony lens


[olympus]

None=something


In case for an Id there is an entry in the integrated mapping table as well as in exiv2.ini, the entry from exiv2.ini is used.

Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator

Licenses

QuickImageComment is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. For Details see GNU General Public License (GPL).

License details of used sources and components:

Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator

GNU General Public License (GPL)

GNU GENERAL PUBLIC LICENSE

Version 3, 29 June 2007

Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Preamble

The GNU General Public License is a free, copyleft license for software and other kinds of works.

The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.

To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.

For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.

Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.

For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.

Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.

Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.

The precise terms and conditions for copying, distribution and modification follow.

TERMS AND CONDITIONS

0. Definitions.

“This License” refers to version 3 of the GNU General Public License.

“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.

“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.

To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.

A “covered work” means either the unmodified Program or a work based on the Program.

To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.

To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.

An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.

1. Source Code.

The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.

A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.

The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.

The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.

The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.

The Corresponding Source for a work in source code form is that same work.

2. Basic Permissions.

All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.

You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.

Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.

3. Protecting Users' Legal Rights From Anti-Circumvention Law.

No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.

When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.

4. Conveying Verbatim Copies.

You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.

You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.

5. Conveying Modified Source Versions.

You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:

a) The work must carry prominent notices stating that you modified it, and giving a relevant date.

b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.

c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.

d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.

A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.

6. Conveying Non-Source Forms.

You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:

a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.

b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.

c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.

d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.

e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.

A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.

A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.

“Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.

If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).

The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.

Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.

7. Additional Terms.

“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.

When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.

Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:

a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or

b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or

c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or

d) Limiting the use for publicity purposes of names of licensors or authors of the material; or

e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or

f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.

All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.

If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.

Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.

8. Termination.

You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).

However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.

Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.

Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.

9. Acceptance Not Required for Having Copies.

You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.

10. Automatic Licensing of Downstream Recipients.

Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.

An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.

You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.

11. Patents.

A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.

A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.

Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.

In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.

If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.

If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.

A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.

Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.

12. No Surrender of Others' Freedom.

If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.

13. Use with the GNU Affero General Public License.

Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.

14. Revised Versions of this License.

The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.

If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.

Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.

15. Disclaimer of Warranty.

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

16. Limitation of Liability.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

17. Interpretation of Sections 15 and 16.

If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.

Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily

OpenStreetMap

Source: www.openstreetmap.org


OpenStreetMap® is open data, licensed under the Open Data Commons Open Database License (ODbL) by the OpenStreetMap Foundation (OSMF).

You are free to copy, distribute, transmit and adapt our data, as long as you credit OpenStreetMap and its contributors. If you alter or build upon our data, you may distribute the result only under the same licence. The full legal code explains your rights and responsibilities.

The cartography in our map tiles, and our documentation, are licensed under the Creative Commons Attribution-ShareAlike 2.0 license (CC BY-SA).


Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework

Leaflet

Source: http://leafletjs.com/


Copyright (c) 2010-2016, Vladimir Agafonkin

Copyright (c) 2010-2011, CloudMade

All rights reserved.


Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:


  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.


  1. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily

Newtonsoft Json.NET

Source: http://leafletjs.com/


Copyright (c) 2007 James Newton-King

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator