Difference between revisions of "How to create image reference regions"

From Gramps
Jump to: navigation, search
m (Reference regions)
m
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Languages}}
+
{{Languages|How_to_create_image_reference_regions}}
 +
{{stub}}
 
How to create image reference regions.
 
How to create image reference regions.
  
 
==Reference regions==
 
==Reference regions==
 +
 
Image reference regions can be used to select or highlight portions of images.  It is relatively easy to establish reference regions by following these steps:
 
Image reference regions can be used to select or highlight portions of images.  It is relatively easy to establish reference regions by following these steps:
  
Line 8: Line 10:
 
* By whichever method is easiest, access the database object/record where the image is used. Typically, this would be a person, place, event, or citation/source.
 
* By whichever method is easiest, access the database object/record where the image is used. Typically, this would be a person, place, event, or citation/source.
 
* Go to the {{man label|gallery}} tab for that record. Edit an existing image, or add a new one.
 
* Go to the {{man label|gallery}} tab for that record. Edit an existing image, or add a new one.
<br clear=right>
+
{{-}}
 +
[[Image:Media region selection41.png||right|thumb|Image selection into Gramps 4.1]]
 +
[[File:MediaReferenceEditor-dialog-expanded-example-50.png||left|thumb|[[Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_media_object_references|Media Reference Editor]] on Gramps 5.0]]
 
[[Image:Image region 3.png|thumb|Media Reference Editor]]
 
[[Image:Image region 3.png|thumb|Media Reference Editor]]
[[Image:Media region selection41.png|571px|Image selection into Gramps 4.1]]
+
* Once you are in the {{man label|[[Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Media_Reference_Editor_dialog|Media Reference Editor]]}}, there are several methods for selecting reference regions:
* Once you are in the {{man label|Media Reference Editor}}, there are several methods for selecting reference regions:
 
 
*# The edit fields can be changed manually to select a region.  Regions are selected as a percentage of the image.  0%, 0%, 100%, 100%, means a region covers the entire image.
 
*# The edit fields can be changed manually to select a region.  Regions are selected as a percentage of the image.  0%, 0%, 100%, 100%, means a region covers the entire image.
 
*# The spinbuttons can be used in a manner similar to the entryfields, to select a region as a percentage of the image.
 
*# The spinbuttons can be used in a manner similar to the entryfields, to select a region as a percentage of the image.
*# In GRAMPS 3.1.0 and newer, you can click-and-drag in the {{man label|Preview}} pane to select a region.  Every time you click-and-drag, a smaller region can be selected.  If you {{Man key press|CTRL}} +click the {{man label|Preview}} pane, the region reverts back to 0%, 0%, 100%, 100%.
+
*# In Gramps 3.1.0 and newer, you can click-and-drag in the {{man label|Preview}} pane to select a region.  Every time you click-and-drag, a smaller region can be selected.  If you {{Man key press|CTRL}} +click the {{man label|Preview}} pane, the region reverts back to 0%, 0%, 100%, 100%.
<br clear=right>
+
{{-}}
 
[[Image:Image region 4.png|thumb|Creating a new reference region]]
 
[[Image:Image region 4.png|thumb|Creating a new reference region]]
 
*Once you have a reference region defined, click {{man button|OK}} into the Editor, and repeat these steps as necessary for all other people in the image.
 
*Once you have a reference region defined, click {{man button|OK}} into the Editor, and repeat these steps as necessary for all other people in the image.
 +
{{-}}
 +
 +
==Narrative Web==
  
<br clear=right>
+
[[File:NarrativeWeb-Media-tab-ImageReferenceRegions-example-50.png|thumb|Narrative Web gallery example]]
  
==Narrative Web==
+
Starting with Gramps 3.1.0, image reference regions are also displayed in the [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_7#Page_Generation|Narrative Web HTML pages created with Gramps]].  There are no special options necessary in Narrative Web for this feature, other than the existence of reference regions for 1 or more images.  Narrative Web displays reference regions for people and place objects only.
[[Image:Image region 1.png|thumb|Narrative Web gallery example]]
 
Starting with GRAMPS 3.1.0, image reference regions are also displayed in the Narrative Web HTML pages created with GRAMPS.  There are no special options necessary in Narrative Web for this feature, other than the existence of reference regions for 1 or more images.  Narrative Web displays reference regions for people and place objects only.
 
  
 
[[Category:How do I...]]
 
[[Category:How do I...]]

Latest revision as of 14:09, 31 March 2021

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


How to create image reference regions.

Reference regions

Image reference regions can be used to select or highlight portions of images. It is relatively easy to establish reference regions by following these steps:

Editing an image in the Gallery tab
  • By whichever method is easiest, access the database object/record where the image is used. Typically, this would be a person, place, event, or citation/source.
  • Go to the gallery tab for that record. Edit an existing image, or add a new one.


Image selection into Gramps 4.1
Media Reference Editor
  • Once you are in the Media Reference Editor, there are several methods for selecting reference regions:
    1. The edit fields can be changed manually to select a region. Regions are selected as a percentage of the image. 0%, 0%, 100%, 100%, means a region covers the entire image.
    2. The spinbuttons can be used in a manner similar to the entryfields, to select a region as a percentage of the image.
    3. In Gramps 3.1.0 and newer, you can click-and-drag in the Preview pane to select a region. Every time you click-and-drag, a smaller region can be selected. If you CTRL +click the Preview pane, the region reverts back to 0%, 0%, 100%, 100%.


Creating a new reference region
  • Once you have a reference region defined, click OK into the Editor, and repeat these steps as necessary for all other people in the image.


Narrative Web

Narrative Web gallery example

Starting with Gramps 3.1.0, image reference regions are also displayed in the Narrative Web HTML pages created with Gramps. There are no special options necessary in Narrative Web for this feature, other than the existence of reference regions for 1 or more images. Narrative Web displays reference regions for people and place objects only.