Skip to content

first attempt at image composite #2470

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tomcrane wants to merge 1 commit into
base: prezi-4
Choose a base branch
from
+173 −98
Open

first attempt at image composite #2470

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
150 changes: 56 additions & 94 deletions source/presentation/4.0/example/uc07_image_composite.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,98 +11,60 @@
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/1",
"type": "Canvas",
"width": 600,
"height": 300,
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/1/page/1",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/anno1",
"type": "Annotation",
"motivation": [
"painting"
],
"body": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/2",
"type": "Canvas",
"width": 300,
"height": 300,
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/2/page/1",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/anno2",
"type": "Annotation",
"motivation": [
"painting"
],
"body": {
"id": "https://fixtures.iiif.io/images/Glen/generated/canvas_1.jpg",
"type": "Image",
"format": "image/jpeg"
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/2",
"type": "Canvas"
}
}
]
}
]
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/1#xywh=0,0,300,300",
"type": "Canvas"
}
},
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/anno3",
"type": "Annotation",
"motivation": [
"painting"
],
"body": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/3",
"type": "Canvas",
"width": 300,
"height": 300,
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/3/page/1",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07/anno4",
"type": "Annotation",
"motivation": [
"painting"
],
"body": {
"id": "https://fixtures.iiif.io/images/Glen/generated/canvas_2.jpg",
"type": "Image",
"format": "image/jpeg"
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/3",
"type": "Canvas"
}
}
]
}
]
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/1#xywh=300,0,300,300",
"type": "Canvas"
}
}
]
}
]

"label": {
"fr": [
"f. 033v-034r [Chilpéric Ier tue Galswinthe, se remarie et est assassiné] - reconstitué"
]
},
"width": 14432,
"height": 10624,
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite/canvas/1/annotations",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite/canvas/1/annotations/1",
"type": "Annotation",
"motivation": [ "painting" ],
"body": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b/canvas/1",
"type": "Canvas",
"partOf": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b.json",
"type": "Manifest"
}
]
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a/canvas/1",
"type": "Canvas"
}
},
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite/canvas/1/annotations/2",
"type": "Annotation",
"motivation": [ "painting" ],
"body": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a/canvas/1",
"type": "Canvas",
"partOf": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a.json",
"type": "Manifest"
}
]
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07/canvas/1#xywh=7898,1988,2182,2464",
"type": "Canvas"
}
}
]
}
]
}
]
}
]
}
56 changes: 56 additions & 0 deletions source/presentation/4.0/example/uc07_image_composite_source_a.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
{
"@context": "http://iiif.io/api/presentation/4/context.json",
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a.json",
"type": "Manifest",
"label": {
"en": [ "Miniatures from Grandes Chroniques de France, ca. 1460" ]
},
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a/canvas/1",
"type": "Canvas",
"label": {
"fr": [ "Miniature [Chilpéric Ier tue Galswinthe, se remarie et est assassiné]" ]
},
"width": 2138,
"height": 2414,
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a/canvas/1/annotations",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a/canvas/1/annotations/1",
"type": "Annotation",
"motivation": ["painting"],
"body": {
"id": "https://iiif.io/api/image/3.0/example/reference/899da506920824588764bc12b10fc800-bnf_chateauroux_miniature/full/max/0/default.jpg",
"type": "Image",
"format": "image/jpeg",
"width": 2138,
"height": 2414,
"service": [
{
"id": "https://iiif.io/api/image/3.0/example/reference/899da506920824588764bc12b10fc800-bnf_chateauroux_miniature",
"type": "ImageService3",
"profile": "level1"
}
]
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_a/canvas/1",
"type": "Canvas"
}
}
]
}
],
"annotations": [
{
"id": "https://example.org/annotations/large-body-of-annotations-on-Chilperic-kills-Galswintha-miniature",
"type": "AnnotationPage"
}
]
}
]
}
56 changes: 56 additions & 0 deletions source/presentation/4.0/example/uc07_image_composite_source_b.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
{
"@context": "http://iiif.io/api/presentation/4/context.json",
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b.json",
"type": "Manifest",
"label": {
"en": [ "Folio from Grandes Chroniques de France, ca. 1460" ]
},
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b/canvas/1",
"type": "Canvas",
"label": {
"fr": [ "f. 033v-034r [Chilpéric Ier tue Galswinthe, se remarie et est assassiné]" ]
},
"width": 7216,
"height": 5412,
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b/canvas/1/annotations",
"type": "AnnotationPage",
"items": [
{
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b/canvas/1/annotations/1",
"type": "Annotation",
"motivation": "painting",
"body": {
"id": "https://iiif.io/api/image/3.0/example/reference/899da506920824588764bc12b10fc800-bnf_chateauroux/full/max/0/default.jpg",
"type": "Image",
"format": "image/jpeg",
"width": 7216,
"height": 5412,
"service": [
{
"id": "https://iiif.io/api/image/3.0/example/reference/899da506920824588764bc12b10fc800-bnf_chateauroux",
"type": "ImageService3",
"profile": "level1"
}
]
},
"target": {
"id": "https://iiif.io/api/presentation/4.0/example/uc07_image_composite_source_b/canvas/1",
"type": "Canvas"
}
}
]
}
],
"annotations": [
{
"id": "https://example.org/annotations/large-body-of-annotations-on-Chilperic-kills-Galswintha-folio",
"type": "AnnotationPage"
}
]
}
]
}
9 changes: 5 additions & 4 deletions source/presentation/4.0/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -476,17 +476,18 @@ A Container can be painted into another Container as an Annotation with [`motiva

## Use Case 6: Reconstruction of a Separated Object

Physical objects such as books, or even individual sheets, can be dispersed amongst multiple institutions, each of which digitizes and publishes the parts of the original that they look after. However, in order to reconstruct how a book might have looked in the past at a particular opening, along with all of the other commentary and other digital affordances available via IIIF, it is possible to embed the Canvas representing the left hand page from one organization, and the Canvas representing the right hand page from another organization, into a single larger Canvas representing the spread.
Physical objects such as manuscripts, or even individual folios, can be dispersed amongst multiple institutions, each of which digitizes and publishes the parts of the original that they look after. However, in order to reconstruct how a manuscript might have looked in the past, along with all of the other commentary and other digital affordances available via IIIF, it is possible to reference Canvases from external Manifests.

This example is a Manifest with a Canvas that has two page images displayed side by side. However, instead of painting the images directly as Annotations, each image is painted on to a separate Canvas, and each Canvas is painted into the Manifest Canvas. A practical application of this would be where the single-image Canvases have been created previously and are hosted separately from the Manifest's composite-image Canvas and those Canvases have transcriptions, translations, commentary or other annotations aligned with the image.
This example comprises three Manifests. The first contains a miniature - an illustration from a manuscript that has been cut out at some point, acquired as an independent object by institution A, and digitized. A large number of annotations have accumulated for this miniature, they are referenced from the Canvas in this Manifest. The second Manifest contains a Canvas that represents the page from which the miniature was cut - the image painted onto this Canvas has a hole in it. This Canvas too has accumulated a large body of annotations. While it would be possible in a third Manifest to create a new Canvas and simply paint the two source images onto it, the example here instead references the two Canvases from their source Manifests. A client rendering this reconstruction can bring in any transcriptions, translations, commentary or other annotations aligned with their respective images from both sources, including those made after the reconstruction itself was made.

{% include code_example.html src="uc07_image_composite.json" %}

>
**Key Points**
* The Manifest contains a single Canvas, which has a single Annotation Page, and two painting annotations.
* Each painting annotation defines a Canvas with its own Annotation Page and a single image annotation. Alternately, each painting annotation could reference an external Canvas through a URI.
* The two image Canvases are nested within the Manifest Canvas, causing the images to be displayed side by side.
* Each painting annotation paints a Canvas that is defined in a different Manifest.
* The [`partOf`][prezi-40-model-partOf] property is essential. It allows the client to load the Manifest that contains the Canvases. Sometimes individual Canvases may be available online at the URIs given by their `id` properties, but this is not usually the case.
* Both source Canvases are scaled. The Folio Canvas happens to be the same aspect ration as the new Canvas (but only half its actual width and height). The `target` property for painting the Folio image into the new Canvas therefore simply uses the Canvas `id`, and the client will fill the new Canvas with the source Canvas. The miniature Canvas `target` is a region of the new Canvas, and it is scaled to fit that region.
{: .callout}


Expand Down
Loading