Recipe #0489 Multimedia Canvas

triplingual commented 5 months ago

This PR addresses #489, for making a Canvas that holds image and AV resources

triplingual commented 5 months ago

No known viewer support. Viewers are currently listed to facilitate checking as the recipe progresses.

stephenwf commented 4 months ago

@triplingual Theseus supports this recipe:

https://theseus-viewer.netlify.app/?iiif-content=https://preview.iiif.io/cookbook/0489-multimedia-canvas/recipe/0489-multimedia-canvas/manifest.json

There is also the Fire demo Tom created back in 2016, which feels relevant: https://theseus-viewer.netlify.app/?iiif-content=https://tomcrane.github.io/fire/fire3.json

glenrobson commented 4 months ago

I've had a look at the manifest and I think it is valid despite what the validator says.

I've tried it in the new validator version: https://github.com/IIIF/presentation-validator/pull/155 and it works fine. So I think for now turn off validtion to get it to build.

glenrobson commented 3 months ago

Comments from the Cookbook editors:

Suggested title change:- Teaching with a complex multimedia canvas

Editors thought the existing title "Multimedia Canvas" brought together a combination of image and av like the accompanying canvas rather than the use case of a complex multimedia canvas.

Implementation notes

Would it be possible to expand the implementation note section to talk more about how the annotations are targetd to a manifest using the idea of a timeline and mention selections. Also would be useful to note the order of the annotations in the manifest don’t match what you see in the viewer because of the target time stamps.
Move third paragraph into restrictions “When using timing for showing…”
add a note to this pargraph to mention viewers may allow the user to control the timeline so you can view things after they’ve loaded.

Example

Remove () from last (These final instructions stay visible for approximately 2-1/2 minutes to avoid an immediate return to the initial instructions.)
Link to localhost in the Theseus Viewer temporary link (but note this can be replaced once #501 is merged)

The editors would like to look again before TRC so if it would be possible to have the changes done by Monday I can send it to them for comments.

Thanks

glenrobson commented 3 months ago

Also note we tested enabling the validation and it seems it does now validate. So if you want to merge this pull request: https://github.com/IIIF/cookbook-recipes/pull/531 into this one it should re-enable the validation.

triplingual commented 3 months ago

@glenrobson Could you say a bit more about this one?

add a note to this pargraph to mention viewers may allow the user to control the timeline so you can view things after they’ve loaded

I'm reading it to say that control of the viewer is (may be) in the hands of the person viewing, as with Theseus, so there's no way in this example to prevent someone from jumping around the timeline or pausing the timeline. Another way it's not a drop-in example for teaching, just a general proof-of-concept.

triplingual commented 3 months ago

[x] Change title to Teaching with a complex multimedia canvas
[x] Implementation Notes: Expand to talk more about how the annotations are targeted to a manifest using the idea of a timeline and mention selections
[x] Implementation Notes: Note that the order of the annotations in the manifest don’t match what you see in the viewer because of the target time stamps
[x] Implementation Notes: Move third paragraph into restrictions “When using timing for showing…”
[x] Restrictions: Add a note to this (moved, see above) paragraph to mention viewers may allow the user to control the timeline so you can view things after they’ve loaded.
[x] Example: Remove () from last (These final instructions stay visible for approximately 2-1/2 minutes to avoid an immediate return to the initial instructions.)
[x] Example: Replace Theseus Viewer temporary link

triplingual commented 3 months ago

Not 100% sure I got the bit about timeline and selections, but it's a first pass. I also added a related recipe for a more basic example of time in target and a mention in the Example section about how the timer and picture are ordered in the Manifest to get the timer on top of the picture.

kirschbombe commented 3 months ago

Hi, @triplingual - Re: the comment about "viewers may allow the user to control the timeline", that may have been a miscommunication. I think we were suggesting you add details to the implementation section to highlight the use of the time and fragment selectors to create the canvas timeline, which you've done :) Someone may have suggested something about user controls, but I don't remember. In any case, you do talk about this a bit in the restrictions, which is good.

kirschbombe commented 3 months ago

For the title, if we don't want it to me specifically about teaching, perhaps "Time-based multimedia canvas" - or something that makes it clear that it's not just a canvas of time-based things (A/V), but that the canvas itself is time-based?

triplingual commented 3 months ago

Yeah, the use case / title are a little tricky here. Bringing together multiple kinds of resources/Annotations also lends itself to digital storytelling, kiosks, and more. I'm reflexively accommodating to editing, so I changed the title, but it is worth some thought about what would signal to someone reading the cookbook matrix or TOC that there are a lot of directions to take with what you learn from this recipe.

kirschbombe commented 2 months ago

@triplingual - Title suggestion from the editors " Rendering multiple media types on a time-based Canvas"

IIIF / cookbook-recipes

Recipe #0489 Multimedia Canvas #507

Implementation notes

Example