You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/presentation/4.0/index.md
+76-8Lines changed: 76 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -245,6 +245,8 @@ Example Annotation that positions a model at a point within a Scene:
245
245
246
246
#### URI Fragments
247
247
248
+
(move up, include xywh)
249
+
248
250
The point may instead be defined using a short-hand form of a URI Fragment at the end of the `id` of the Scene as the `target` of the Annotation. The name of the fragment parameter is `xyz` and its value is the x, y and z values separated by commas. Each value can be expressed as either an integer or a floating point number.
249
251
250
252
The annotation above could be expressed as its fragment-based equivalent:
@@ -305,6 +307,10 @@ content state intended to:
305
307
- modify the Container in a particular context (`scope`, storytelling)
306
308
- contribute additional information permanently (rerum **inbox** - move to protocol doc)
307
309
310
+
### Using Content State
311
+
312
+
(not in section 6)
313
+
308
314
### reset
309
315
310
316
"diff", "original state" etc
@@ -314,8 +320,17 @@ behavior: sequence
314
320
315
321
## Selectors
316
322
323
+
preamble - cover all the use cases
324
+
317
325
### SpecificResource
318
326
327
+
(This heading should be more descriptive)
328
+
329
+
fragments/segments/parts of resources
330
+
SvgSelector
331
+
xywh
332
+
333
+
319
334
### PointSelector
320
335
321
336
@@ -493,6 +508,8 @@ Painting a Scene into another while excluding import of several types of resourc
493
508
494
509
## Advanced Association Features
495
510
511
+
(This needs to be sprinkled throughout above - especially as SpecificResource must be introduced early for 3D)
512
+
496
513
### Nesting
497
514
498
515
A Canvas can be painted into a Scene as an Annotation, but the 2D nature of Canvases requires special consideration due to important differences between Canvases and Scenes. A Canvas describes a bounded 2D space with finite `height` and `width` measured in pixels with a pixel origin at the top-left corner of the Canvas, while Scenes describe a boundless 3D space with x, y, and z axes of arbitrary coordinate units and a coordinate origin at the center of the space. It is important to note that in many cases the pixel scale used by a Canvas or a 2D image content resource will not be in proportion to the desired 3D coordinate unit scale in a Scene.
@@ -520,33 +537,77 @@ Example placing top-left at (0, 1, 0); bottom-left at (0, 0, 0); bottom-right at
520
537
```
521
538
522
539
523
-
### Segments
524
-
525
540
### Embedded Content
526
541
542
+
e.g., painting TextualBody on Canvas
543
+
544
+
545
+
### Comment Annotations
546
+
547
+
(move to Annotation section)
548
+
549
+
527
550
### Choice of Alternative Resources
528
551
552
+
(move to Annotation section)
553
+
554
+
529
555
### Non Rectangular Segments
530
556
557
+
SvgSelector - move to SpecificResource too ^^
558
+
559
+
531
560
### Style
532
561
562
+
Move to SpecificResource
563
+
564
+
533
565
### Rotation
534
566
535
-
### Comment Annotations
536
567
537
-
### Hotspot Linking
568
+
### Hotspot Linking and Activation
538
569
539
-
### Activation
570
+
Move to SpecificResource
540
571
541
-
### Using Content State
542
572
543
-
- modify the Container in a particular context (`scope`, storytelling)
544
573
574
+
## Conveying Physical Dimensions
575
+
576
+
(why is this important!?)
577
+
578
+
(move the props to vocab doc)
579
+
580
+
### spatialScale
581
+
582
+
### temporalScale
583
+
584
+
585
+
```
586
+
{
587
+
"spatialScale": {
588
+
"factor": 22.0,
589
+
"units": "m"
590
+
},
591
+
592
+
593
+
// this would be rarely used
594
+
"temporalScale": {
595
+
"factor": 0.00001
596
+
}
597
+
598
+
}
599
+
```
545
600
601
+
`factor` Required A floating point ratio.
602
+
`units` Required A real-world measuring unit. Always seconds for temporalScale. Possible values for spatialScale include: "m", "ft". (is that it?)
546
603
547
-
### Physical Dimension Service
604
+
For a Canvas, it's the physical "size" of each cartesian integer unit.
605
+
For a Scene, it's the physical size of the unit vector.
606
+
For a timeline it's the ratio of time in the recording to time in the real world.
548
607
549
608
609
+
(define props in the Vocabulary doc)
610
+
550
611
551
612
## HTTP Requests and Responses
552
613
@@ -559,6 +620,13 @@ Example placing top-left at (0, 1, 0); bottom-left at (0, 0, 0); bottom-right at
0 commit comments