Merge pull request #307 from jim-easterbrook/devel

Devel
jim-easterbrook · Dec 23, 2024 · 4916800 · 4916800
2 parents ed935be + 6e02973
commit 4916800
Show file tree

Hide file tree

Showing 20 changed files with 731 additions and 516 deletions.
diff --git a/src/doc/manual/regions.rst b/src/doc/manual/regions.rst
@@ -49,15 +49,19 @@ The entire region can be dragged by clicking within it.
 Positioning the region is made easier if you zoom in by holding down the ``Ctrl`` key while scrolling with the mouse scroll wheel.
 (The zoom can also be adjusted with ``Ctrl-Plus`` and ``Ctrl-Minus`` key combinations.)
 
+After creating a region you can add metadata about the it.
+The ``Region name`` and ``Identifier`` fields are unique labels for the region, but I haven't found a use for them.
+
+The ``Boundary unit`` specifies whether the vertex positions are stored as absolute pixel values or relative proportions of the image width and height.
+Don't use pixel values unless you have some other software that requires them.
+
 .. image:: ../images/screenshot_276.png
 
 The most important metadata for a region is probably its "role_".
 This is chosen from a "controlled vocabulary" defined by the IPTC.
 Photini shows the IPTC names and definitions (as "tooltips") in a drop down menu when you click on the ``Role`` entry.
 You can select one or more roles from the list.
 
-Other, less useful, metadata includes a name and identifier for the region.
-
 .. image:: ../images/screenshot_277.png
 
 The `content type`_ is another controlled vocabulary that allows you to say what's special about the selected area.

diff --git a/src/doc/manual/tags.rst b/src/doc/manual/tags.rst
@@ -51,6 +51,10 @@ You may find this useful when deciding what to write in those fields.
       -
       - Xmp.iptc.ExtDescrAccessibility
       -
+    * - `Person(s) shown`_
+      -
+      - Xmp.iptcExt.PersonInImage
+      -
     * - Rating_
       -
       - Xmp.xmp.Rating
@@ -133,7 +137,7 @@ You may find this useful when deciding what to write in those fields.
       -
     * - `Image Regions`_
       -
-      - Xmp.iptcExt.ImageRegion
+      - Xmp.iptcExt.ImageRegion Xmp.mwg-rs.Regions Xmp.MP.RegionInfo
       -
     * - Latitude_, longitude_
       - Exif.GPSInfo.GPSLatitude Exif.GPSInfo.GPSLatitudeRef Exif.GPSInfo.GPSLongitude Exif.GPSInfo.GPSLongitudeRef
@@ -324,6 +328,8 @@ It is applied to the Date / time Taken, Date / time Digitised and Date / time Mo
     http://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#gps-latitude
 .. _longitude:
     http://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#gps-longitude
+.. _Person(s) shown:
+    http://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#person-shown-in-the-image
 .. _Rating:
     http://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata#image-rating
 .. _Rights\: Usage Terms:

diff --git a/src/lang/ca/LC_MESSAGES/documentation.po b/src/lang/ca/LC_MESSAGES/documentation.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2023.4.1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-19 16:57+0000\n"
+"POT-Creation-Date: 2024-12-20 14:43+0000\n"
 "PO-Revision-Date: 2023-04-19 08:54+0000\n"
 "Last-Translator: Joan <[email protected]>, 2023\n"
 "Language: ca\n"
@@ -1920,6 +1920,19 @@ msgid ""
 " be adjusted with ``Ctrl-Plus`` and ``Ctrl-Minus`` key combinations.)"
 msgstr ""
 
+msgid ""
+"After creating a region you can add metadata about the it. The ``Region "
+"name`` and ``Identifier`` fields are unique labels for the region, but I "
+"haven't found a use for them."
+msgstr ""
+
+msgid ""
+"The ``Boundary unit`` specifies whether the vertex positions are stored as "
+"absolute pixel values or relative proportions of the image width and height."
+" Don't use pixel values unless you have some other software that requires "
+"them."
+msgstr ""
+
 msgid ""
 "The most important metadata for a region is probably its \"role_\". This is "
 "chosen from a \"controlled vocabulary\" defined by the IPTC. Photini shows "
@@ -1928,9 +1941,6 @@ msgid ""
 "list."
 msgstr ""
 
-msgid "Other, less useful, metadata includes a name and identifier for the region."
-msgstr ""
-
 msgid ""
 "The `content type`_ is another controlled vocabulary that allows you to say "
 "what's special about the selected area. The upper part shows the IPTC "
@@ -2071,6 +2081,12 @@ msgstr ""
 msgid "Xmp.iptc.ExtDescrAccessibility"
 msgstr ""
 
+msgid "`Person(s) shown`_"
+msgstr ""
+
+msgid "Xmp.iptcExt.PersonInImage"
+msgstr ""
+
 msgid "Rating_"
 msgstr ""
 
@@ -2238,7 +2254,7 @@ msgstr ""
 msgid "`Image Regions`_"
 msgstr ""
 
-msgid "Xmp.iptcExt.ImageRegion"
+msgid "Xmp.iptcExt.ImageRegion Xmp.mwg-rs.Regions Xmp.MP.RegionInfo"
 msgstr ""
 
 msgid "Latitude_, longitude_"
@@ -5830,3 +5846,11 @@ msgstr ""
 #~ " metadata."
 #~ msgstr ""
 
+#~ msgid ""
+#~ "Other, less useful, metadata includes a "
+#~ "name and identifier for the region."
+#~ msgstr ""
+
+#~ msgid "Xmp.iptcExt.ImageRegion"
+#~ msgstr ""
+
diff --git a/src/lang/cs/LC_MESSAGES/documentation.po b/src/lang/cs/LC_MESSAGES/documentation.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2023.4.1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-19 16:57+0000\n"
+"POT-Creation-Date: 2024-12-20 14:43+0000\n"
 "PO-Revision-Date: 2023-04-19 08:54+0000\n"
 "Last-Translator: fri, 2023\n"
 "Language: cs@qtfiletype\n"
@@ -1917,6 +1917,19 @@ msgid ""
 " be adjusted with ``Ctrl-Plus`` and ``Ctrl-Minus`` key combinations.)"
 msgstr ""
 
+msgid ""
+"After creating a region you can add metadata about the it. The ``Region "
+"name`` and ``Identifier`` fields are unique labels for the region, but I "
+"haven't found a use for them."
+msgstr ""
+
+msgid ""
+"The ``Boundary unit`` specifies whether the vertex positions are stored as "
+"absolute pixel values or relative proportions of the image width and height."
+" Don't use pixel values unless you have some other software that requires "
+"them."
+msgstr ""
+
 msgid ""
 "The most important metadata for a region is probably its \"role_\". This is "
 "chosen from a \"controlled vocabulary\" defined by the IPTC. Photini shows "
@@ -1925,9 +1938,6 @@ msgid ""
 "list."
 msgstr ""
 
-msgid "Other, less useful, metadata includes a name and identifier for the region."
-msgstr ""
-
 msgid ""
 "The `content type`_ is another controlled vocabulary that allows you to say "
 "what's special about the selected area. The upper part shows the IPTC "
@@ -2068,6 +2078,12 @@ msgstr ""
 msgid "Xmp.iptc.ExtDescrAccessibility"
 msgstr ""
 
+msgid "`Person(s) shown`_"
+msgstr ""
+
+msgid "Xmp.iptcExt.PersonInImage"
+msgstr ""
+
 msgid "Rating_"
 msgstr ""
 
@@ -2235,7 +2251,7 @@ msgstr ""
 msgid "`Image Regions`_"
 msgstr ""
 
-msgid "Xmp.iptcExt.ImageRegion"
+msgid "Xmp.iptcExt.ImageRegion Xmp.mwg-rs.Regions Xmp.MP.RegionInfo"
 msgstr ""
 
 msgid "Latitude_, longitude_"
@@ -5799,3 +5815,11 @@ msgstr ""
 #~ " metadata."
 #~ msgstr ""
 
+#~ msgid ""
+#~ "Other, less useful, metadata includes a "
+#~ "name and identifier for the region."
+#~ msgstr ""
+
+#~ msgid "Xmp.iptcExt.ImageRegion"
+#~ msgstr ""
+
diff --git a/src/lang/de/LC_MESSAGES/documentation.po b/src/lang/de/LC_MESSAGES/documentation.po
@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2023.4.1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-19 16:57+0000\n"
+"POT-Creation-Date: 2024-12-20 14:43+0000\n"
 "PO-Revision-Date: 2023-04-19 08:54+0000\n"
 "Last-Translator: Jim Easterbrook <[email protected]>, 2023\n"
 "Language: de\n"
@@ -1914,6 +1914,19 @@ msgid ""
 " be adjusted with ``Ctrl-Plus`` and ``Ctrl-Minus`` key combinations.)"
 msgstr ""
 
+msgid ""
+"After creating a region you can add metadata about the it. The ``Region "
+"name`` and ``Identifier`` fields are unique labels for the region, but I "
+"haven't found a use for them."
+msgstr ""
+
+msgid ""
+"The ``Boundary unit`` specifies whether the vertex positions are stored as "
+"absolute pixel values or relative proportions of the image width and height."
+" Don't use pixel values unless you have some other software that requires "
+"them."
+msgstr ""
+
 msgid ""
 "The most important metadata for a region is probably its \"role_\". This is "
 "chosen from a \"controlled vocabulary\" defined by the IPTC. Photini shows "
@@ -1922,9 +1935,6 @@ msgid ""
 "list."
 msgstr ""
 
-msgid "Other, less useful, metadata includes a name and identifier for the region."
-msgstr ""
-
 msgid ""
 "The `content type`_ is another controlled vocabulary that allows you to say "
 "what's special about the selected area. The upper part shows the IPTC "
@@ -2065,6 +2075,12 @@ msgstr ""
 msgid "Xmp.iptc.ExtDescrAccessibility"
 msgstr ""
 
+msgid "`Person(s) shown`_"
+msgstr ""
+
+msgid "Xmp.iptcExt.PersonInImage"
+msgstr ""
+
 msgid "Rating_"
 msgstr ""
 
@@ -2232,7 +2248,7 @@ msgstr ""
 msgid "`Image Regions`_"
 msgstr ""
 
-msgid "Xmp.iptcExt.ImageRegion"
+msgid "Xmp.iptcExt.ImageRegion Xmp.mwg-rs.Regions Xmp.MP.RegionInfo"
 msgstr ""
 
 msgid "Latitude_, longitude_"
@@ -5827,3 +5843,11 @@ msgstr ""
 #~ " metadata."
 #~ msgstr ""
 
+#~ msgid ""
+#~ "Other, less useful, metadata includes a "
+#~ "name and identifier for the region."
+#~ msgstr ""
+
+#~ msgid "Xmp.iptcExt.ImageRegion"
+#~ msgstr ""
+
diff --git a/src/lang/es/LC_MESSAGES/documentation.po b/src/lang/es/LC_MESSAGES/documentation.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2023.4.1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-19 16:57+0000\n"
+"POT-Creation-Date: 2024-12-20 14:43+0000\n"
 "PO-Revision-Date: 2023-04-19 08:54+0000\n"
 "Last-Translator: Jim Easterbrook <[email protected]>, 2023\n"
 "Language: es@qtfiletype\n"
@@ -1910,6 +1910,19 @@ msgid ""
 " be adjusted with ``Ctrl-Plus`` and ``Ctrl-Minus`` key combinations.)"
 msgstr ""
 
+msgid ""
+"After creating a region you can add metadata about the it. The ``Region "
+"name`` and ``Identifier`` fields are unique labels for the region, but I "
+"haven't found a use for them."
+msgstr ""
+
+msgid ""
+"The ``Boundary unit`` specifies whether the vertex positions are stored as "
+"absolute pixel values or relative proportions of the image width and height."
+" Don't use pixel values unless you have some other software that requires "
+"them."
+msgstr ""
+
 msgid ""
 "The most important metadata for a region is probably its \"role_\". This is "
 "chosen from a \"controlled vocabulary\" defined by the IPTC. Photini shows "
@@ -1918,9 +1931,6 @@ msgid ""
 "list."
 msgstr ""
 
-msgid "Other, less useful, metadata includes a name and identifier for the region."
-msgstr ""
-
 msgid ""
 "The `content type`_ is another controlled vocabulary that allows you to say "
 "what's special about the selected area. The upper part shows the IPTC "
@@ -2061,6 +2071,12 @@ msgstr ""
 msgid "Xmp.iptc.ExtDescrAccessibility"
 msgstr ""
 
+msgid "`Person(s) shown`_"
+msgstr ""
+
+msgid "Xmp.iptcExt.PersonInImage"
+msgstr ""
+
 msgid "Rating_"
 msgstr ""
 
@@ -2228,7 +2244,7 @@ msgstr ""
 msgid "`Image Regions`_"
 msgstr ""
 
-msgid "Xmp.iptcExt.ImageRegion"
+msgid "Xmp.iptcExt.ImageRegion Xmp.mwg-rs.Regions Xmp.MP.RegionInfo"
 msgstr ""
 
 msgid "Latitude_, longitude_"
@@ -5814,3 +5830,11 @@ msgstr ""
 #~ " metadata."
 #~ msgstr ""
 
+#~ msgid ""
+#~ "Other, less useful, metadata includes a "
+#~ "name and identifier for the region."
+#~ msgstr ""
+
+#~ msgid "Xmp.iptcExt.ImageRegion"
+#~ msgstr ""
+