From b416bf9f6212bcc68a577efef8c4a0f7e141379c Mon Sep 17 00:00:00 2001 From: Julie Winchester Date: Thu, 12 Mar 2026 11:45:33 -0500 Subject: [PATCH 1/3] Add scope as activating annotation shortcut to model --- source/presentation/4.0/model.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/presentation/4.0/model.md b/source/presentation/4.0/model.md index 041982d0b..838439f23 100644 --- a/source/presentation/4.0/model.md +++ b/source/presentation/4.0/model.md @@ -405,7 +405,7 @@ For Timelines and Canvases, Annotations _MUST NOT_ target spatial or temporal po __Properties__
An Annotation _MUST_ have the following properties: [id](#id), [type](#type), [target](#target), [motivation](#motivation).

An Annotation _SHOULD_ have the following properties: [body](#body).

-An Annotation _MAY_ have the following properties: [label](#label), [metadata](#metadata), [summary](#summary), [provider](#provider), [thumbnail](#thumbnail), [requiredStatement](#requiredStatement), [rights](#rights), [navDate](#navDate), [navPlace](#navPlace), [provides](#provides), [behavior](#behavior), [timeMode](#timeMode), [stylesheet](#stylesheet), [seeAlso](#seeAlso), [service](#service), [homepage](#homepage), [rendering](#rendering), [partOf](#partOf), [canonical](#canonical), and [via](#via).

+An Annotation _MAY_ have the following properties: [label](#label), [metadata](#metadata), [summary](#summary), [provider](#provider), [thumbnail](#thumbnail), [requiredStatement](#requiredStatement), [rights](#rights), [navDate](#navDate), [navPlace](#navPlace), [provides](#provides), [behavior](#behavior), [scope](#scope), [timeMode](#timeMode), [stylesheet](#stylesheet), [seeAlso](#seeAlso), [service](#service), [homepage](#homepage), [rendering](#rendering), [partOf](#partOf), [canonical](#canonical), and [via](#via).

{: .note} @@ -469,7 +469,7 @@ A Textual Body is an embedded resource within an Annotation that carries, as the __Properties__
A Textual Body _MUST_ have the following properties: [type](#type), [value](#value)

-A Textual Body _MAY_ have the following properties: [id](#id), [position](#position), [transform](#transform), [scope](#scope), [styleClass](#styleClass), [height](#height), [width](#width), [duration](#duration), [language](#language), [format](#format), [label](#label), [metadata](#metadata), [summary](#summary), [provider](#provider), [thumbnail](#thumbnail), [requiredStatement](#requiredStatement), [rights](#rights), [behavior](#behavior), [seeAlso](#seeAlso), [service](#service), [homepage](#homepage), [rendering](#rendering), [canonical](#canonical), [via](#via), and [annotations](#annotations).

+A Textual Body _MAY_ have the following properties: [id](#id), [position](#position), [transform](#transform), [styleClass](#styleClass), [height](#height), [width](#width), [duration](#duration), [language](#language), [format](#format), [label](#label), [metadata](#metadata), [summary](#summary), [provider](#provider), [thumbnail](#thumbnail), [requiredStatement](#requiredStatement), [rights](#rights), [behavior](#behavior), [seeAlso](#seeAlso), [service](#service), [homepage](#homepage), [rendering](#rendering), [canonical](#canonical), [via](#via), and [annotations](#annotations).

{: .note} @@ -2472,7 +2472,9 @@ The value _MUST_ be a string, not a number, in order to allow for the "!" charac ### scope {: #scope} -The scope of a Specific Resource is the context in which it should be interpreted, viewed, or used. For the purposes of IIIF, it is a pointer to one or more resources that are intended to be used by the client for the user to view or interact with the resource. In a Scene, this would typically be an instance of a Camera that should be activated and selected to set up the correct viewpoint. This specification does not establish specific expectations for references to other classes. +The scope of an Annotation or Specific Resource is the context in which it should be interpreted, viewed, or used. For the purposes of IIIF, it is a pointer to one or more resources that are intended to be used by the client for the user to view or interact with the resource. + +Clients _MUST_ process `scope` as a short-hand expression of an Annotation with `motivation` "activating" with `action` "show," "enable," and "select," where the `source` of the activating Annotation `body` is the Resource referenced by `scope` and the `target` is the Annotation or Specific Resource for which `scope` is specified. In a Scene, `scope` would typically be applied to a Content Resource or commenting Annotation and would reference a Camera that should be activated and selected to set the correct viewpoint in response to user interaction with that resource. This specification does not establish specific expectations for references to other classes. The value _MUST_ be an array of JSON objects. From 16a308df9696f756d51dfa7a4c9221178c90f219 Mon Sep 17 00:00:00 2001 From: Julie Winchester Date: Thu, 12 Mar 2026 12:50:58 -0500 Subject: [PATCH 2/3] Simplify and reorder language --- source/presentation/4.0/model.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/presentation/4.0/model.md b/source/presentation/4.0/model.md index 838439f23..de65f6577 100644 --- a/source/presentation/4.0/model.md +++ b/source/presentation/4.0/model.md @@ -2474,7 +2474,7 @@ The value _MUST_ be a string, not a number, in order to allow for the "!" charac The scope of an Annotation or Specific Resource is the context in which it should be interpreted, viewed, or used. For the purposes of IIIF, it is a pointer to one or more resources that are intended to be used by the client for the user to view or interact with the resource. -Clients _MUST_ process `scope` as a short-hand expression of an Annotation with `motivation` "activating" with `action` "show," "enable," and "select," where the `source` of the activating Annotation `body` is the Resource referenced by `scope` and the `target` is the Annotation or Specific Resource for which `scope` is specified. In a Scene, `scope` would typically be applied to a Content Resource or commenting Annotation and would reference a Camera that should be activated and selected to set the correct viewpoint in response to user interaction with that resource. This specification does not establish specific expectations for references to other classes. +In a Scene, `scope` would typically be applied to a Content Resource or commenting Annotation and would reference a Camera that should be activated and selected to set the correct viewpoint in response to user interaction with that resource. This specification does not establish specific expectations for references to other classes. Clients _MUST_ process `scope` as a short-hand expression of an Annotation where `motivation` is "activating"; where `action` values are `show`, `enable`, and `select`; where the `source` of the activating Annotation `body` is the Resource referenced by `scope`; and where the `target` is the Annotation or Specific Resource on which `scope` is specified. The value _MUST_ be an array of JSON objects. From 7db8a65eedcd4f91c5623716d4aa4fbc81452582 Mon Sep 17 00:00:00 2001 From: Julie Winchester Date: Thu, 12 Mar 2026 13:16:45 -0500 Subject: [PATCH 3/3] Move sentence --- source/presentation/4.0/model.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/presentation/4.0/model.md b/source/presentation/4.0/model.md index de65f6577..d3498c754 100644 --- a/source/presentation/4.0/model.md +++ b/source/presentation/4.0/model.md @@ -2474,7 +2474,9 @@ The value _MUST_ be a string, not a number, in order to allow for the "!" charac The scope of an Annotation or Specific Resource is the context in which it should be interpreted, viewed, or used. For the purposes of IIIF, it is a pointer to one or more resources that are intended to be used by the client for the user to view or interact with the resource. -In a Scene, `scope` would typically be applied to a Content Resource or commenting Annotation and would reference a Camera that should be activated and selected to set the correct viewpoint in response to user interaction with that resource. This specification does not establish specific expectations for references to other classes. Clients _MUST_ process `scope` as a short-hand expression of an Annotation where `motivation` is "activating"; where `action` values are `show`, `enable`, and `select`; where the `source` of the activating Annotation `body` is the Resource referenced by `scope`; and where the `target` is the Annotation or Specific Resource on which `scope` is specified. +In a Scene, `scope` would typically be applied to a Content Resource or commenting Annotation and would reference a Camera that should be activated and selected to set the correct viewpoint in response to user interaction with that resource. Clients _MUST_ process `scope` as a short-hand expression of an Annotation where `motivation` is "activating"; where `action` values are `show`, `enable`, and `select`; where the `source` of the activating Annotation `body` is the Resource referenced by `scope`; and where the `target` is the Annotation or Specific Resource on which `scope` is specified. + +This specification does not establish specific expectations for references to other classes. The value _MUST_ be an array of JSON objects.