Linking image regions with text regions

The Archetype Text Editor allows you to link marked-up elements from the transcription with corresponding regions from image.

It is strongly recommended to ensure that the encoding and mark up of your text is final before you begin to link its parts to the image. Although the system might cope with some changes in the text the most problematic situation is when you have multiple text regions with the same content (i.e. the exact same sequence of words) and you add or delete some of them. This is likely to upset the order of the links.

The above image shows the Image panel (top) and Text panel (bottom). In the image panel, a rectangle surrounds the region that contains the word 'Romane' (7), its border is blue to indicate that it is currently selected. You can see the matching region in the Text panel below (9).

How do I create a new image region?

1. Go to the text editor for one of your item part or manuscript. Here we assume that you already have an image and a transcription available in the editor and your transcription is already marked-up.
2. Expand the transcription and the image panel (this is usually the panel at the top). You can click the little dark grey vertical bar at the top of the transcription panel to expand the image panel. Then adjust the size of each panel by dragging that vertical bar up or down. Zoom in/out with the +/- buttons (5) in the top left corner of the image panel. Drag the image using the mouse left button.
3. Enter the editing mode in the image panel by moving your mouse over the upper bar of the image panel and clicking the pencil icon (1);
4. Draw a rectangle around a region of interest: a) move your mouse to the top-left corner of the region b) press 'Ctrl' key ('Command' on a Mac) and keep it down during the following steps c) left-click once to specify the corner, a blue dot should appear b) move your mouse to the bottom right corner d) left-click again to specify the opposite corner of your rectangle, a yellow rectangle should appear e) release the 'Ctrl' / 'Command' key;
5. Link an image region with a text region: a) click inside the image region you've created, it's border should turn blue to indicate it is selected (7) b) select the matching text region from the drop down in the top right corner of the image panel (3). Now your region is linked and saved in the database.

Notice that the drop down contains all available regions from the text. Linked regions are black, others are yellow.

How to efficiently create a large number of image regions?

You can repeat step 4 to 5 for each region. An alternative approach is to draw multiple rectangles then assign them to the text regions. The second approach might be faster but you might want to systematically select each rectangle just after creating them to make sure they are saved in the database.

How do I change an image region?

Make sure editing mode is enabled and the image region is selected (by clicking it once, its border should be blue instead of yellow).

• to delete it: press 'delete' key to remove it;
• to move it: drag the rectangle with your mouse;
• to resize it: drag a corner with your mouse;
• to link it to another text-region: just select that region in the drop down (3). That text region will first be dissociated from any previously connected image region, if any;
• to dissociate the image region from the text region: select 'Unspecified' in the drop down;

Please be very careful in editing mode when you select a text region in the drop down. If no image region is selected, it will select the corresponding image region (that's harmless). If an image region is selected, it will reallocate the text region to that image region (make sure this what you want). The number on the left of the drop down (2) indicates how many image regions are currently selected, 0 if none.

To deselect any image region, simply click on any part of the image, outside any existing region. The number should return to 0.

How can I verify the connections between the text and the image?

a) move your mouse over the image region and look at the label in the bar at the bottom of the image panel (8) OR b) click the text-regions in the Text panel (9), the image should zoom in and select the corresponding image region

Both a) and b) works in or outside the editing mode.

Another thing to check is that none of the entries in the drop-down (3) are yellow (apart from 'Unspecified').

When you are not in editing mode you can move your mouse over the toolbar on top of the image panel, move over the eye icon (4) then click the 'Highlight Text Unit'. This will highlight all the image regions. It is preferable to use this than enter edit mode if you want to verify your work as it prevent any risk of making any modification by mistake.

-- Geoffroy Noël, 2019