This section describes how to add the area selection editor to an image and speed up task completion with shortcuts. If you just need to insert a picture, read the Inserting images section.
To allow Tolokers to select areas in pictures, use the field.image-annotation component.
{
"view": {
"type": "field.image-annotation",
"data": {
"type": "data.output",
"path": "path"
},
"image": "url"
}
}
The component offers three labeling modes: rectangle, polygon, and point markup. All three modes are available by default. You can choose to use just one or two of them.
{% list tabs %}
-
Rectangles
To allow Tolokers to select areas only with rectangles, add the
rectangle
key to theshapes
property and set its value totrue
.{ "shapes": { "rectangle": true } }
-
Polygons
To allow Tolokers to select areas only with polygons, add the
polygon
key to theshapes
property and set its value totrue
.{ "shapes": { "polygon": true } }
-
Points
To allow Tolokers to select areas only with points, add the
point
key to theshapes
property and set its value totrue
.{ "shapes": { "point": true } }
{% endlist %}
You can allow Tolokers to select objects by type. For example, you may want all cars selected in the picture to be labeled as one type, and all road signs as another.
{
"labels": [{
"label": "Option 1",
"value": "value1"
},
{
"label": "Option 2",
"value": "value2"
}
]
}
For each new object of the labels
property, a button is added to the editor that allows Tolokers to select the corresponding area type. Different values of the value
property let Tolokers label areas with different colors.
To help Tolokers work faster, you can add keyboard shortcuts using the plugin.field.image-annotation.hotkeys component. Shortcuts can be assigned to the up and down arrows (up
,down
), numbers, and Latin letters.
If you install the shortcut plugin without assigning keys, they are assigned automatically.
You can change them as described below. If you don't need some of the shortcuts, leave their value fields empty.
{% list tabs %}
-
Select area types
If you use at least two types of areas in your task, list the shortcuts for them in the array of the
labels
property, separating them with commas. They will be assigned to the area selection buttons in the order they are displayed.{ "type": "plugin.field.image-annotation.hotkeys", "labels": [ "1", "2" ] }
-
Select labeling modes
You can let Tolokers switch between different labeling modes using shortcuts. Add the corresponding key to the
modes
property and assign a shortcut to it:select
: For selecting shapes and points.point
: For selecting areas using points.rectangle
: For selecting areas using rectangles.polygon
: For selecting areas using polygons.
{ "type": "plugin.field.image-annotation.hotkeys", "modes": { "select": "q", "point": "w", "rectangle": "e", "polygon": "r" } }
-
Confirm or cancel area creation
You can set up shortcuts to let Tolokers confirm or cancel area creation. Assign shortcuts to properties:
confirm
: Confirm.cancel
: Cancel.
{ "type": "plugin.field.image-annotation.hotkeys", "confirm": "x", "cancel": "z" }
{% endlist %}
To create a template for area selection tasks, use the following components:
- field.image-annotation: To add the area selection editor.
- plugin.field.image-annotation.hotkeys: To add keyboard shortcuts.
- view.text: To add a description to the task.
- condition.required: To make sure that a Toloker selected at least one area.
- plugin.toloka: To customize the task layout.
{% include contact-support %}