Skip to content

Commit cbc3029

Browse files
committed
Removed missed instance of CreativeWork
1 parent 3b7267b commit cbc3029

File tree

1 file changed

+37
-22
lines changed

1 file changed

+37
-22
lines changed

docs/manifest/writing/assertions-actions.md

Lines changed: 37 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ The following table summarizes some of the most important standard assertions.
4646
| Assertion | Label | Description |
4747
|-----------|-------|-------------|
4848
| [Content bindings](#content-bindings) | `c2pa.hash.*`, `c2pa.soft-binding`, etc. | Uniquely identify portions of an asset and bind the assertion to it, for example using cryptographic hashes. |
49-
| [Actions](#actions) | `c2pa.actions` | Creation, edits, and other actions on an asset, such as cropping, color or contrast adjustment, and so on. |
49+
| [Actions](#actions) (v2) | `c2pa.actions.v2` | Creation, edits, and other actions on an asset, such as cropping, color or contrast adjustment, and so on. |
5050

5151
:::note
5252
The CAI SDK handles assertions for thumbnails, content bindings, and ingredients, so normally you don't need to think about them.
@@ -93,13 +93,19 @@ Update assertions
9393

9494
## Actions
9595

96-
An action is an assertion that provides information about creation, edits, and other things that have occurred to an asset. In the manifest, an `actions` assertion is an array of [AssertionDefinition](../json-ref/manifest-def.mdx#assertiondefinition) objects. For example:
96+
An action is an assertion that provides information about creation, edits, and other things that have occurred to an asset. In the manifest, an `actions` assertion is an array of [AssertionDefinition](../json-ref/manifest-def.mdx#assertiondefinition) objects.
97+
98+
:::important
99+
Every manifest has to start with either an `c2pa.opened` or `c2pa.created` action, which has to be the first action in the manifest. Each of these actions need to have an associated ingredient.
100+
:::
101+
102+
For example:
97103

98104
```json
99105
...
100106
"assertions": [
101107
{
102-
"label": "c2pa.actions",
108+
"label": "c2pa.actions.v2",
103109
"data": {
104110
"actions": [
105111
{
@@ -131,7 +137,8 @@ The [C2PA Technical Specification](https://c2pa.org/specifications/specification
131137
V1 actions are fully specified in the `actions` array. However, a v2 action may either be fully specified in an element of the `actions` array or it may be derived from an element in the `templates` array with the same action name.
132138

133139
<div class="review-comment">
134-
The CAI APIs can read all v2 actions and write most v2 actions. What v2 actions can it NOT write?
140+
The CAI APIs can read all v2 actions and write **most** v2 actions.
141+
What v2 actions can it NOT write? We should document that.
135142
</div>
136143

137144
### Action names
@@ -140,7 +147,7 @@ The value of the `action` property must be either one of the pre-defined [standa
140147

141148
For the complete list of standard actions, see the [C2PA Technical Specification](https://c2pa.org/specifications/specifications/2.2/specs/C2PA_Specification.html#_actions).
142149

143-
### Digital source type
150+
### Digital source type
144151

145152
Use the `digitalSourceType` property to specify how an asset was created or modified, for example "digital capture", "digitized from negative," or "trained algorithmic media."
146153

@@ -181,7 +188,7 @@ For other possible values of `digitalSourceType`, see [Digital source type](#dig
181188
"assertions": [
182189
...
183190
{
184-
"label": "c2pa.actions",
191+
"label": "c2pa.actions.v2",
185192
"data": {
186193
"actions": [
187194
{
@@ -280,27 +287,37 @@ For example, the following action identifies that the `c2pa.opened` action was p
280287
```json
281288
"ingredients": [
282289
{
283-
"title": "test.jpeg",
290+
"title": "crater-lake.jpeg",
284291
"format": "image/jpeg",
285-
"instance_id": "xmp.iid:3250038a-22ca-459b-8392-de275f8b155c",
286-
"relationship": "parentOf"
292+
"instance_id": "xmp.iid:7f136ee1-6e84-4d80-9de3-e1180ef2b690",
293+
"relationship": "parentOf",
294+
"label": "c2pa.ingredient.v3"
287295
}
288296
],
289297
"assertions": [
290298
{
291-
"label": "c2pa.actions",
299+
"label": "c2pa.actions.v2",
292300
"data": {
293301
"actions": [
294-
{
295-
"action": "c2pa.opened",
296-
"parameters": {
297-
"ingredientIds": [
298-
"ingredientIds": [
299-
"xmp.iid:3250038a-22ca-459b-8392-de275f8b155c"
300-
],
301-
}
302-
},
303-
...
302+
{
303+
"action": "c2pa.opened",
304+
"parameters": {
305+
"org.cai.ingredientIds": [
306+
"xmp.iid:7f136ee1-6e84-4d80-9de3-e1180ef2b690"
307+
],
308+
"ingredients": [
309+
{
310+
"url": "self#jumbf=c2pa.assertions/c2pa.ingredient.v3",
311+
"hash": "yb/F7GBepYRyaFM16gzj6t84CKDTnBxhnLqYjnB0iX0="
312+
}
313+
]
314+
}
315+
},
316+
...
317+
]
318+
}
319+
}
320+
]
304321
```
305322

306323
## CAWG metadata assertions
@@ -313,7 +330,6 @@ Metadata assertions must include one or more `@context` properties in the `data`
313330

314331
| Assertion | Label | Description |
315332
|-----------|-------|-------------|
316-
| [Creative work](#creative-work-assertion) | `stds.schema-org.CreativeWork` | Indicates the asset is the product of creative effort. |
317333
| [Exif information](#exif-assertion) | `stds.exif` | Camera information such as maker, lens stored in Exchangeable image file format (Exif). |
318334
| [IPTC photo and video metadata](#iptc-metadata) | `stds.iptc` | Properties from the IPTC Photo and Video Metadata Standards, describing for example ownership, rights, and other metadata about a image or video asset. |
319335
| [Training and data mining](#do-not-train-assertion) | `cawg.training-mining` | Whether the creator/owner of an asset grants permission to use it for data mining or AI/ML training. NOTE: Previously, this assertion's label was `c2pa.training-mining`. |
@@ -420,7 +436,6 @@ Assertions with the `cawg.training-mining` label provide information about wheth
420436
Training and data mining assertions formerly had `c2pa.*` labels. See [Legacy training and data mining assertion](../reading/legacy.md#legacy-training-and-data-mining-assertion) for more information.
421437
:::
422438

423-
424439
| Entry Key | Whether permission is granted... | Possible values of `use` property |
425440
|-----------|-------------|-------------|
426441
| `cawg.data_mining` | To extract text or data from the asset for purposes of determining "patterns, trends and correlations," including images containing text, where the text could be extracted via OCR. | `allowed`,<br/> `notAllowed`,<br/>or `constrained` |

0 commit comments

Comments
 (0)