Structure / content
This section must be completed / corrected to reflect the common elements of the two types of annotations, namely the ones integrated to a manifest and the ones hosted on an annotation server.
Basically an annotation contain the following :
- an id
- a body that can encapsulate content of different types (TextualBody, Image, other?)
- there is always a textual value that can be some HTML, especially to include a link
- a target composed of :
- an item of a manifest
- a spacial frame (a rectangle in the video or image frame, defined by the top left and bottom right corners coordinates)
- a time frame in the case of a video item being annotated (start time and end time)
Formats / types of annotations
Integrated to the manifest
The annotations can be directly included in a manifest.
General structure
A manifest can contain a list of AnnotationPages that contain lists of annotation items.
"annotations":
[
{
"id": "http://localhost:8080/data/demo-content/demo/canvas/1/annotation/1",
"type": "AnnotationPage",
"items": [
{ANNOTATION BLOCK 1.1},
{ANNOTATION BLOCK 1.2},
etc.
]
},
{
"id": "http://localhost:8080/data/demo-content/demo/canvas/1/annotation/2",
"type": "AnnotationPage",
"items": [
{ANNOTATION BLOCK 2.1},
{ANNOTATION BLOCK 2.2},
]
},
{
ANOTHER ANNOTATION PAGE
}
]Content
Id
Motivation comment
Target
Time frame
Spatial frame
Complete example
"annotations": [
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/1/annotation/1",
"type": "AnnotationPage",
"items": [
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/1/1",
"type": "Annotation",
"motivation": "commenting",
"body": {
"type": "TextualBody",
"language": "fr",
"value": "<a href=\"http://am-cb.net/docs/AMCB-HKN-FicheTech.pdf\" target=\"_blank\">Fiche technique</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1"
}
]
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/1/annotation/2",
"type": "AnnotationPage",
"items": [
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/2/1",
"type": "Annotation",
"motivation": "commenting",
"body": {
"type": "TextualBody",
"language": "fr",
"value": "<a href=\"http://localhost:8080/data/demo-content/Hakanai/media/01_HKN-StoryBoard2-Dec2013.pdf\" target=\"_blank\">Storyboard</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1"
}
]
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/1/annotation/3",
"type": "AnnotationPage",
"items": [
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/3/1",
"type": "Annotation",
"motivation": "commenting",
"body": {
"type": "TextualBody",
"language": "fr",
"value": "<a href=\"https://www.am-cb.net/docs/AMCB-HKN-Dossier.pdf\" target=\"_blank\">Dossier de présentation</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1"
}
]
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/1/annotation/4",
"type": "Annotation",
"motivation": "supplementing",
"body": {
"id": "http://localhost:8080/data/demo-content/Hakanai/media/10_HKN-Garges_A2B4243.JPG",
"type": "Image",
"format": "image/jpg",
"value": "<a href=\"http://localhost:8080/data/demo-content/Hakanai/media/10_HKN-Garges_A2B4243.JPG\" target=\"_blank\">Dispositif</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1"
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/1/annotation/5",
"type": "AnnotationPage",
"items": [
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/5/1",
"type": "Annotation",
"motivation": "commenting",
"body": {
"id": "http://localhost:8080/data/demo-content/Hakanai/media/02_HKN-couv.jpg",
"type": "Image",
"format": "image/jpg",
"value": "<a href=\"https://www.am-cb.net/docs/AMCB-HKN-Dossier.pdf\" target=\"_blank\">CARNET : Couverture</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1#xywh=1600,50,301,400&t=5,10"
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/5/2",
"type": "Annotation",
"motivation": "commenting",
"body": {
"id": "http://localhost:8080/data/demo-content/Hakanai/media/06_HKN-2012-10-04.jpg",
"type": "Image",
"format": "image/jpg",
"value": "<a href=\"http://localhost:8080/data/demo-content/Hakanai/media/06_HKN-2012-10-04.jpg\" target=\"_blank\">CARNET : Octobre 2012</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1#xywh=1100,50,818,510&t=10,15"
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/5/3",
"type": "Annotation",
"motivation": "commenting",
"body": {
"id": "http://localhost:8080/data/demo-content/Hakanai/media/07_HKN-2012-10-13.jpg",
"type": "Image",
"format": "image/jpg",
"value": "<a href=\"http://localhost:8080/data/demo-content/Hakanai/media/07_HKN-2012-10-13.jpg\" target=\"_blank\">CARNET : Octobre 2012 (2)</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1#xywh=1100,50,818,510&t=15,20"
}
]
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/1/annotation/6",
"type": "AnnotationPage",
"items": [
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/6/1",
"type": "Annotation",
"motivation": "commenting",
"body": {
"id": "http://localhost:8080/data/demo-content/Hakanai/media/10_HKN-Garges_A2B4243.JPG",
"type": "Image",
"format": "image/jpg"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1#xywh=1100,50,818,510&t=28,40"
},
{
"id": "http://localhost:8080/data/demo-content/Hakanai/canvas/&/annotation/6/2",
"type": "Annotation",
"motivation": "commenting",
"body": {
"type": "TextualBody",
"language": "fr",
"value": "<a href=\"http://localhost:8080/data/demo-content/Hakanai/media/10_HKN-Garges_A2B4243.JPG\" target=\"_blank\">Dispositif</a>"
},
"target": "http://localhost:8080/data/demo-content/Hakanai/canvas/1#xywh=100,50,1700,1000&t=30,34"
}
]
}
]