Skip to content

Commit 1922ecd

Browse files
committed
Wording edits per cookbook editors 📝
1 parent 793bf14 commit 1922ecd

File tree

1 file changed

+3
-3
lines changed
  • recipe/0560-resources-on-a-timeline

1 file changed

+3
-3
lines changed

recipe/0560-resources-on-a-timeline/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,13 @@ You have a set of images you would like to present sequentially in time, in the
1717

1818
This recipe is very similar to [Composition from Multiple Images][0036], which describes using multiple IIIF resources on a single Canvas. The substantial difference between that recipe and this one is the incorporation of [the `duration` property](https://iiif.io/api/presentation/3.0/#duration) and [`behavior` values](https://iiif.io/api/presentation/3.0/#behavior) for instructing viewers on Canvas sequencing.
1919

20-
If a Canvas has a `duration` property, viewers have to process it, and can be helpful by providing an interactive means of displaying that Canvas for the value of the `duration`. To give a viewer instructions on showing a resource during all or part of that duration, the Canvas can use a media fragment on its `target` value, in the form `#t=`. For details on formats and semantics of this media fragment, see the [W3C Media Fragments section on Temporal Dimension](https://www.w3.org/TR/media-frags/#naming-time). Fragment values can be individually or in the aggregate greater than the `duration` value. See [Rendering Multiple Media Types on a Time-Based Canvas][0489] for a brief explanation of the `timeMode` property and for more on the "t" parameter on a `target`.
20+
If a Canvas has a `duration` property, viewers have to process it, and can be helpful by providing an interactive means of displaying that Canvas for the value of the `duration`. To give a viewer instructions on showing a resource during all or part of that duration, the Canvas can use a media fragment on its `target` value, in the form `#t=`. For details on formats and semantics of this media fragment, see the [W3C Media Fragments section on Temporal Dimension](https://www.w3.org/TR/media-frags/#naming-time). Note that while the Media Fragments specification allows for values other than numbers of seconds, IIIF conventionally uses only whole and/or partial seconds. Fragment values can be individually or in the aggregate greater than the `duration` value. See [Rendering Multiple Media Types on a Time-Based Canvas][0489] for a brief explanation of the `timeMode` property and for more on the "t" parameter on a `target`.
2121

2222
Nothing in the Presentation API 3.0 says anything explicitly about a viewer initiating play upon loading a Canvas with a `duration` property, even with a`start` value. In addition, for browser-based viewers, people may configure their browsers to disable autoplay. Consequently, manifest creators should not assume a resource with `duration` will begin without interaction.
2323

24-
Once the timeline has started, the default action in IIIF is to display a Canvas for the `duration` value and stop, regardless of the individual or aggregate "t" parameter values on the `target`s of the Canvas's descendent `items`. To get the Canvas to repeat the sequential `items` display, the `behavior` value used is `repeat`. This value is applicable only on Collections or Manifests containing Canvases with `duration`. Once the end of the `duration` (the end of the timeline) is reached, this behavior tells the viewer to start over at the beginning. Note that there is no mechanism for repeating a fixed number of times.
24+
Once the timeline has started, the default action in IIIF is to display a Canvas for the `duration` value and stop, regardless of the individual or aggregate "t" parameter values on the `target`s of the Canvas's descendent `items`. To get the annotation sequence to repeat, the `behavior` value is set to `repeat`. This value is applicable only on Collections or Manifests containing Canvases with `duration`. Once the end of the `duration` (the end of the timeline) is reached, this behavior tells the viewer to start over at the beginning. Note that there is no mechanism for repeating a fixed number of times.
2525

26-
Within a Canvas's `items` the parameterized `target` values tell viewers to show each item for the "t" parameter value, not stopping until an appropriate interaction or until and unless it reaches a Canvas with no `behavior` or a Canvas with an explicit `no-auto-advance` behavior. (The default is `no-auto-advance`, so no `behavior` is functionally equivalent to declaring `no-auto-advance`.)
26+
Within a Canvas's annotations, the parameterized `target` values tell viewers to show each item for the "t" parameter value, not stopping until an appropriate interaction or until and unless it reaches a Canvas with no `behavior` or a Canvas with an explicit `no-auto-advance` behavior. (The default is `no-auto-advance`, so no `behavior` is functionally equivalent to declaring `no-auto-advance`.)
2727

2828
## Restrictions
2929

0 commit comments

Comments
 (0)