Skip to content

Commit 7398e18

Browse files
committed
placeholder sections in prezi4 incl. physical dimensions
1 parent 71bbd34 commit 7398e18

File tree

1 file changed

+76
-8
lines changed

1 file changed

+76
-8
lines changed

source/presentation/4.0/index.md

Lines changed: 76 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -245,6 +245,8 @@ Example Annotation that positions a model at a point within a Scene:
245245

246246
#### URI Fragments
247247

248+
(move up, include xywh)
249+
248250
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.
249251

250252
The annotation above could be expressed as its fragment-based equivalent:
@@ -305,6 +307,10 @@ content state intended to:
305307
- modify the Container in a particular context (`scope`, storytelling)
306308
- contribute additional information permanently (rerum **inbox** - move to protocol doc)
307309

310+
### Using Content State
311+
312+
(not in section 6)
313+
308314
### reset
309315

310316
"diff", "original state" etc
@@ -314,8 +320,17 @@ behavior: sequence
314320

315321
## Selectors
316322

323+
preamble - cover all the use cases
324+
317325
### SpecificResource
318326

327+
(This heading should be more descriptive)
328+
329+
fragments/segments/parts of resources
330+
SvgSelector
331+
xywh
332+
333+
319334
### PointSelector
320335

321336

@@ -493,6 +508,8 @@ Painting a Scene into another while excluding import of several types of resourc
493508

494509
## Advanced Association Features
495510

511+
(This needs to be sprinkled throughout above - especially as SpecificResource must be introduced early for 3D)
512+
496513
### Nesting
497514

498515
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
520537
```
521538

522539

523-
### Segments
524-
525540
### Embedded Content
526541

542+
e.g., painting TextualBody on Canvas
543+
544+
545+
### Comment Annotations
546+
547+
(move to Annotation section)
548+
549+
527550
### Choice of Alternative Resources
528551

552+
(move to Annotation section)
553+
554+
529555
### Non Rectangular Segments
530556

557+
SvgSelector - move to SpecificResource too ^^
558+
559+
531560
### Style
532561

562+
Move to SpecificResource
563+
564+
533565
### Rotation
534566

535-
### Comment Annotations
536567

537-
### Hotspot Linking
568+
### Hotspot Linking and Activation
538569

539-
### Activation
570+
Move to SpecificResource
540571

541-
### Using Content State
542572

543-
- modify the Container in a particular context (`scope`, storytelling)
544573

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+
```
545600

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?)
546603

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.
548607

549608

609+
(define props in the Vocabulary doc)
610+
550611

551612
## HTTP Requests and Responses
552613

@@ -559,6 +620,13 @@ Example placing top-left at (0, 1, 0); bottom-left at (0, 0, 0); bottom-right at
559620
### Authentication
560621

561622

623+
## Accessibility
624+
625+
(new section)
626+
627+
`provides`
628+
629+
562630
## Appendices
563631

564632
### Summary of Property Requirements

0 commit comments

Comments
 (0)