coderofsalvation/xrfragment-haxe
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

doc+spec: added AR selector examples

Browse source
This commit is contained in:
Leon van Kammen 2025-09-24 12:14:57 +02:00
parent cc8890e75d
commit 30e57da895
5 changed files with 154 additions and 138 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
doc/RFC_XR_Fragments.html
View file

@ -841,22 +841,28 @@ Usecases:
<h2 id="de-selectors-and">De/selectors (+ and -)</h2>
<blockquote>
<p>How to show/hide/group material- or object- or animations by name?</p>
</blockquote>
<p>Clicking href-values below will show/hide the targeted material- or animation or object-name (incl. children):</p>
<ul>
<li>href: <code>#-welcome</code> (or <code>#+welcome</code>)</li>
<li><code>#-welcome</code></li>
<li><code>#+welcome</code></li>
<li><code>#-VR*</code></li>
<li><code>https://foo.glb#bar&amp;-welcome</code></li>
</ul>
<p>Clicking href-value above will do:</p>
<ol>
<li>show/hide the target object (and children)</li>
</ol>
<p>Matching logic:</p>
<ul>
<li>href: <code>#https://my.org/foo.glb/#bar&amp;-welcome</code></li>
<li>- and + prefix for exact matches (welcome e.g.)</li>
<li>* postfix for match beginning (VR_skybox VR_skyboxmat e.g.)</li>
</ul>
<blockquote>
<p><strong>NOTE:</strong> the latter shows that (de)selectors can also be with regular <a href="#href">href</a>-values</p>
<p>NOTE: to hide a skybox when importing/loading a 3D file (force AR) is possible by linking to `<code>https://my.org/foo.glb#-skybox</code> or <code>https://my.org/foo.glb#-skyboxmaterial</code></p>
</blockquote>
<h2 id="sharing-object-or-file">Sharing object or file (#|)</h2>

18
doc/RFC_XR_Fragments.md
View file

@ -634,15 +634,23 @@ Usecases:
## De/selectors (+ and -)
* href: `#-welcome` (or `#+welcome`)
> How to show/hide/group material- or object- or animations by name?
Clicking href-value above will do:
Clicking href-values below will show/hide the targeted material- or animation or object-name (incl. children):
1. show/hide the target object (and children)
* `#-welcome`
* `#+welcome`
* `#-VR*`
* `https://foo.glb#bar&-welcome`
Matching logic:
* - and + prefix for exact matches (welcome e.g.)
* \* postfix for match beginning (VR_skybox VR_skyboxmat e.g.)
> NOTE: to hide a skybox when importing/loading a 3D file (force AR) is possible by linking to ``https://my.org/foo.glb#-skybox` or `https://my.org/foo.glb#-skyboxmaterial`
* href: `#https://my.org/foo.glb/#bar&-welcome`
> **NOTE:** the latter shows that (de)selectors can also be with regular [href](#href)-values
## Sharing object or file (#|)

216
doc/RFC_XR_Fragments.txt
View file

@ -3,7 +3,7 @@
Jens & Leon Internet Engineering Task Force L.R. van Kammen
Internet-Draft 20 September 2025
Internet-Draft 24 September 2025
Intended status: Informational
@ -42,7 +42,7 @@ Status of This Memo
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on 24 March 2026.
This Internet-Draft will expire on 28 March 2026.
Copyright Notice
@ -53,7 +53,7 @@ Copyright Notice
van Kammen Expires 24 March 2026 [Page 1]
van Kammen Expires 28 March 2026 [Page 1]
Internet-Draft XR Fragments September 2025
@ -103,13 +103,13 @@ Table of Contents
14.1. UX . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
15. Example: Navigating content href portals . . . . . . . . . . 20
15.1. Walking surfaces . . . . . . . . . . . . . . . . . . . . 21
16. Example: Virtual world rings . . . . . . . . . . . . . . . . 21
16. Example: Virtual world rings . . . . . . . . . . . . . . . . 22
17. Additional scene metadata . . . . . . . . . . . . . . . . . . 22
18. Accessibility interface . . . . . . . . . . . . . . . . . . . 23
18. Accessibility interface . . . . . . . . . . . . . . . . . . . 24
van Kammen Expires 24 March 2026 [Page 2]
van Kammen Expires 28 March 2026 [Page 2]
Internet-Draft XR Fragments September 2025
@ -165,7 +165,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 3]
van Kammen Expires 28 March 2026 [Page 3]
Internet-Draft XR Fragments September 2025
@ -221,7 +221,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 4]
van Kammen Expires 28 March 2026 [Page 4]
Internet-Draft XR Fragments September 2025
@ -277,7 +277,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 5]
van Kammen Expires 28 March 2026 [Page 5]
Internet-Draft XR Fragments September 2025
@ -333,7 +333,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 6]
van Kammen Expires 28 March 2026 [Page 6]
Internet-Draft XR Fragments September 2025
@ -389,7 +389,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 7]
van Kammen Expires 28 March 2026 [Page 7]
Internet-Draft XR Fragments September 2025
@ -445,7 +445,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 8]
van Kammen Expires 28 March 2026 [Page 8]
Internet-Draft XR Fragments September 2025
@ -501,7 +501,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 9]
van Kammen Expires 28 March 2026 [Page 9]
Internet-Draft XR Fragments September 2025
@ -557,7 +557,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 10]
van Kammen Expires 28 March 2026 [Page 10]
Internet-Draft XR Fragments September 2025
@ -613,7 +613,7 @@ myspreadsheet.ods
van Kammen Expires 24 March 2026 [Page 11]
van Kammen Expires 28 March 2026 [Page 11]
Internet-Draft XR Fragments September 2025
@ -669,7 +669,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 12]
van Kammen Expires 28 March 2026 [Page 12]
Internet-Draft XR Fragments September 2025
@ -725,7 +725,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 13]
van Kammen Expires 28 March 2026 [Page 13]
Internet-Draft XR Fragments September 2025
@ -781,7 +781,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 14]
van Kammen Expires 28 March 2026 [Page 14]
Internet-Draft XR Fragments September 2025
@ -837,7 +837,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 15]
van Kammen Expires 28 March 2026 [Page 15]
Internet-Draft XR Fragments September 2025
@ -893,7 +893,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 16]
van Kammen Expires 28 March 2026 [Page 16]
Internet-Draft XR Fragments September 2025
@ -949,7 +949,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 17]
van Kammen Expires 28 March 2026 [Page 17]
Internet-Draft XR Fragments September 2025
@ -974,16 +974,24 @@ Internet-Draft XR Fragments September 2025
12.3. De/selectors (+ and -)
* href: #-welcome (or #+welcome)
| How to show/hide/group material- or object- or animations by name?
Clicking href-value above will do:
Clicking href-values below will show/hide the targeted material- or
animation or object-name (incl. children):
1. show/hide the target object (and children)
* #-welcome
* #+welcome
* #-VR*
* https://foo.glb#bar&-welcome
* href: #https://my.org/foo.glb/#bar&-welcome
Matching logic:
| *NOTE:* the latter shows that (de)selectors can also be with
| regular href (#href)-values
* - and + prefix for exact matches (welcome e.g.)
* * postfix for match beginning (VR_skybox VR_skyboxmat e.g.)
| NOTE: to hide a skybox when importing/loading a 3D file (force AR)
| is possible by linking to `https://my.org/foo.glb#-skybox or
| https://my.org/foo.glb#-skyboxmaterial
12.4. Sharing object or file (#|)
@ -992,6 +1000,16 @@ Internet-Draft XR Fragments September 2025
1. share the (targeted object in the) file to a another application
van Kammen Expires 28 March 2026 [Page 18]
Internet-Draft XR Fragments September 2025
| This URL can be fed straight into Web Share API
| (https://developer.mozilla.org/en-US/docs/Web/API/Web_Share_API)
| or xdg-open (https://www.freedesktop.org/wiki/Software/xdg-utils/)
@ -1001,15 +1019,6 @@ Internet-Draft XR Fragments September 2025
| *NOTE*: sharing is limited to (internal objects) via xrf: scheme-
| only
van Kammen Expires 24 March 2026 [Page 18]
Internet-Draft XR Fragments September 2025
12.5. xrf:// URI scheme
Prefixing the xrf: to href (#href)-values *will prevent* level2
@ -1047,6 +1056,16 @@ Internet-Draft XR Fragments September 2025
The URL-processing-flow for hypermedia browsers goes like this:
van Kammen Expires 28 March 2026 [Page 19]
Internet-Draft XR Fragments September 2025
1. IF scene operators and/or animation operator (t) are present in
the URL then (re)position the camera (to room1) and/or animation-
range (10) accordingly.
@ -1057,15 +1076,6 @@ Internet-Draft XR Fragments September 2025
3. IF a camera-object exists with name cam assume that user(camera)
position
van Kammen Expires 24 March 2026 [Page 19]
Internet-Draft XR Fragments September 2025
14.1. UX
End-users should always have read/write access to:
@ -1100,6 +1110,18 @@ Internet-Draft XR Fragments September 2025
than 5 meter away from the portal/object containing the href (to
prevent accidental navigation e.g.)
van Kammen Expires 28 March 2026 [Page 20]
Internet-Draft XR Fragments September 2025
4. URL navigation should always be reflected in the client URL-bar
(in case of javascript: see [here
(https://github.com/coderofsalvation/xrfragment/blob/dev/src/3rd/
@ -1111,17 +1133,6 @@ Internet-Draft XR Fragments September 2025
(https://github.com/coderofsalvation/xrfragment/blob/dev/example/
aframe/sandbox/index.html#L26-L29) for an example wearable)
van Kammen Expires 24 March 2026 [Page 20]
Internet-Draft XR Fragments September 2025
6. make sure that the ''back-button'' of the ''browser-history''
always refers to the previous position (see [here (https://github
.com/coderofsalvation/xrfragment/blob/main/src/3rd/js/three/xrf/
@ -1159,6 +1170,14 @@ Internet-Draft XR Fragments September 2025
1. materialless (nameless & textureless) mesh-objects (without href
and >0 faces)
van Kammen Expires 28 March 2026 [Page 21]
Internet-Draft XR Fragments September 2025
| optionally the viewer can offer thumbstick, mouse or joystick
| teleport-tools for non-roomscale VR/AR setups.
@ -1171,13 +1190,6 @@ Internet-Draft XR Fragments September 2025
* href: schoolB.edu/projects.gltf#math
* href: university.edu/projects.gltf#math
van Kammen Expires 24 March 2026 [Page 21]
Internet-Draft XR Fragments September 2025
This would teleport users to the math-projects of those universities.
Now consider adding a 'webring index'-button to each file, with this
href-value:
@ -1214,6 +1226,14 @@ Internet-Draft XR Fragments September 2025
extension
(https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/
Khronos/KHR_xmp_json_ld)
van Kammen Expires 28 March 2026 [Page 22]
Internet-Draft XR Fragments September 2025
* Open Graph (https://ogp.me) attributes (og:*: .....)
* Dublin-Core (https://www.dublincore.org/specifications/dublin-
core/application-profile-guidelines/) attributes(dc:*: .....)
@ -1226,14 +1246,6 @@ Internet-Draft XR Fragments September 2025
| the hashtags are clickable XR Fragments (activating the visible-
| links in the XR browser).
van Kammen Expires 24 March 2026 [Page 22]
Internet-Draft XR Fragments September 2025
Individual nodes can be enriched with such metadata, but most
importantly the scene node:
@ -1270,6 +1282,14 @@ Internet-Draft XR Fragments September 2025
| These attributes can be scanned and presented during an href or
| src eye/mouse-over.
van Kammen Expires 28 March 2026 [Page 23]
Internet-Draft XR Fragments September 2025
18. Accessibility interface
The addressibility of XR Fragments allows for unique 3D-to-text
@ -1281,15 +1301,6 @@ Internet-Draft XR Fragments September 2025
persists across application/webpage restarts)
2. Accessibility-mode must contain a text-input for the user to
enter text
van Kammen Expires 24 March 2026 [Page 23]
Internet-Draft XR Fragments September 2025
3. Accessibility-mode must contain a flexible textlog for the user
to read (via screenreader, screen, or TTS e.g.)
4. the textlog contains aria-descriptions, and its narration
@ -1328,6 +1339,13 @@ Internet-Draft XR Fragments September 2025
Therefore a 2-button navigation-interface is the bare minimum
interface:
van Kammen Expires 28 March 2026 [Page 24]
Internet-Draft XR Fragments September 2025
1. objects with href metadata can be cycled via a key (tab on a
keyboard)
2. objects with href metadata can be activated via a key (enter on a
@ -1335,17 +1353,6 @@ Internet-Draft XR Fragments September 2025
3. the TTS reads the href-value (and/or aria-description if
available)
van Kammen Expires 24 March 2026 [Page 24]
Internet-Draft XR Fragments September 2025
18.2. Overlap with fileformat-specific extensions
Some 3D scene-fileformats have support for extensions. What if the
@ -1388,20 +1395,16 @@ Internet-Draft XR Fragments September 2025
3D engines/frameworks, to initialize specific features when loading a
scene/object, in a progressive enhanced way.
Vendor Prefixes allows embedding 3D engines/framework-specific
features a 3D file via metadata:
van Kammen Expires 24 March 2026 [Page 25]
van Kammen Expires 28 March 2026 [Page 25]
Internet-Draft XR Fragments September 2025
Vendor Prefixes allows embedding 3D engines/framework-specific
features a 3D file via metadata:
+===========+===================+==============================+
| what | XR metadata | Lowest common denominator |
+===========+===================+==============================+
@ -1450,10 +1453,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 26]
van Kammen Expires 28 March 2026 [Page 26]
Internet-Draft XR Fragments September 2025
@ -1509,7 +1509,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 27]
van Kammen Expires 28 March 2026 [Page 27]
Internet-Draft XR Fragments September 2025
@ -1565,7 +1565,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 28]
van Kammen Expires 28 March 2026 [Page 28]
Internet-Draft XR Fragments September 2025
@ -1621,7 +1621,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 29]
van Kammen Expires 28 March 2026 [Page 29]
Internet-Draft XR Fragments September 2025
@ -1677,7 +1677,7 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 30]
van Kammen Expires 28 March 2026 [Page 30]
Internet-Draft XR Fragments September 2025
@ -1733,4 +1733,4 @@ Internet-Draft XR Fragments September 2025
van Kammen Expires 24 March 2026 [Page 31]
van Kammen Expires 28 March 2026 [Page 31]

18
doc/RFC_XR_Fragments.xml
View file

@ -679,20 +679,22 @@ Usecases:
</blockquote></section>
<section anchor="de-selectors-and"><name>De/selectors (+ and -)</name>
<blockquote><t>How to show/hide/group material- or object- or animations by name?</t>
</blockquote><t>Clicking href-values below will show/hide the targeted material- or animation or object-name (incl. children):</t>
<ul spacing="compact">
<li>href: <tt>#-welcome</tt> (or <tt>#+welcome</tt>)</li>
<li><tt>#-welcome</tt></li>
<li><tt>#+welcome</tt></li>
<li><tt>#-VR*</tt></li>
<li><tt>https://foo.glb#bar&amp;-welcome</tt></li>
</ul>
<t>Clicking href-value above will do:</t>
<ol spacing="compact">
<li>show/hide the target object (and children)</li>
</ol>
<t>Matching logic:</t>
<ul spacing="compact">
<li>href: <tt>#https://my.org/foo.glb/#bar&amp;-welcome</tt></li>
<li>- and + prefix for exact matches (welcome e.g.)</li>
<li>* postfix for match beginning (VR_skybox VR_skyboxmat e.g.)</li>
</ul>
<blockquote><t><strong>NOTE:</strong> the latter shows that (de)selectors can also be with regular <eref target="#href">href</eref>-values</t>
<blockquote><t>NOTE: to hide a skybox when importing/loading a 3D file (force AR) is possible by linking to `<tt>https://my.org/foo.glb#-skybox</tt> or <tt>https://my.org/foo.glb#-skyboxmaterial</tt></t>
</blockquote></section>
<section anchor="sharing-object-or-file"><name>Sharing object or file (#|)</name>

18
doc/RFC_XR_Macros.txt
View file

@ -3,7 +3,7 @@
Internet Engineering Task Force L.R. van Kammen
Internet-Draft 1 September 2025
Internet-Draft 24 September 2025
Intended status: Informational
@ -38,7 +38,7 @@ Status of This Memo
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on 5 March 2026.
This Internet-Draft will expire on 28 March 2026.
Copyright Notice
@ -53,7 +53,7 @@ Copyright Notice
van Kammen Expires 5 March 2026 [Page 1]
van Kammen Expires 28 March 2026 [Page 1]
Internet-Draft XR Macros September 2025
@ -109,7 +109,7 @@ Table of Contents
van Kammen Expires 5 March 2026 [Page 2]
van Kammen Expires 28 March 2026 [Page 2]
Internet-Draft XR Macros September 2025
@ -165,7 +165,7 @@ Internet-Draft XR Macros September 2025
van Kammen Expires 5 March 2026 [Page 3]
van Kammen Expires 28 March 2026 [Page 3]
Internet-Draft XR Macros September 2025
@ -221,7 +221,7 @@ Internet-Draft XR Macros September 2025
van Kammen Expires 5 March 2026 [Page 4]
van Kammen Expires 28 March 2026 [Page 4]
Internet-Draft XR Macros September 2025
@ -277,7 +277,7 @@ Internet-Draft XR Macros September 2025
van Kammen Expires 5 March 2026 [Page 5]
van Kammen Expires 28 March 2026 [Page 5]
Internet-Draft XR Macros September 2025
@ -333,7 +333,7 @@ click object with (`!clickme`:`!foo|!bar|!flop` e.g.)
van Kammen Expires 5 March 2026 [Page 6]
van Kammen Expires 28 March 2026 [Page 6]
Internet-Draft XR Macros September 2025
@ -389,4 +389,4 @@ Internet-Draft XR Macros September 2025
van Kammen Expires 5 March 2026 [Page 7]
van Kammen Expires 28 March 2026 [Page 7]