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

📃 main: update documentation

Browse source
This commit is contained in:
Leon van Kammen 2026-03-19 10:12:45 +01:00
parent a2c95875da
commit 94f17b966d
3 changed files with 14 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
doc/RFC_XR_Fragments.html
View file

@ -197,6 +197,11 @@ XR Fragments exploits the fact that all 3D models already contain such metadata:
<li>externally: progressively enhance a 3D (file) into an experience via <a href="https://en.wikipedia.org/wiki/Sidecar_file">sidecarfiles</a></li> <li>externally: progressively enhance a 3D (file) into an experience via <a href="https://en.wikipedia.org/wiki/Sidecar_file">sidecarfiles</a></li>
</ol> </ol>
<blockquote>
<p>Aspect 1 has been pioneered &amp; implemented by (JanusXR&rsquo;s) James Baicoianu (in <a href="https://github.com/jbaicoianu/janusweb">janusweb</a>) before the spec existed, marking him as a semi-founding father of the spec. Thank you James.
&ldquo;Aspect 1 was pioneered and implemented by JanusXR / James Baicoianu via <a href="https://github.com/jbaicoianu/janusweb">janusweb</a> well before the formal specification was established. As a key architect of these early concepts, James’s work laid the groundwork for the standard we use today. We owe him a great deal of thanks for his early contributions.&rdquo;</p>
</blockquote>
<h1 id="what-does-it-solve">What does it solve</h1> <h1 id="what-does-it-solve">What does it solve</h1>
<p>It solves:</p> <p>It solves:</p>
@ -1554,7 +1559,7 @@ Non-HTML Hypermedia browsers should make browser extensions the right place, to
<ul> <ul>
<li><a href="https://nlnet.nl">NLNET</a></li> <li><a href="https://nlnet.nl">NLNET</a></li>
<li><a href="https://futureoftext.org">Future of Text</a></li> <li><a href="https://futureoftext.org">Future of Text</a></li>
<li><a href="https://visual-meta.info">visual-meta.info</a></li> <li>James Baicoianu <a href="https://github.com/jbaicoianu/janusweb">janusweb</a></li>
<li>Michiel Leenaars</li> <li>Michiel Leenaars</li>
<li>Gerben van der Broeke</li> <li>Gerben van der Broeke</li>
<li>Mauve</li> <li>Mauve</li>
@ -1664,11 +1669,6 @@ Non-HTML Hypermedia browsers should make browser extensions the right place, to
<td>URI Fragment(s) which show/hide object(s) in a scene based on name/tag/property (<code>#cube&amp;-price=&gt;3</code>)</td> <td>URI Fragment(s) which show/hide object(s) in a scene based on name/tag/property (<code>#cube&amp;-price=&gt;3</code>)</td>
</tr> </tr>
<tr>
<td>visual-meta</td>
<td><a href="https://visual.meta.info">visual-meta</a> data appended to text/books/papers which is indirectly visible/editable in XR.</td>
</tr>
<tr> <tr>
<td>requestless metadata</td> <td>requestless metadata</td>
<td>metadata which never spawns new requests (unlike RDF/HTML, which can cause framerate-dropping, hence not used a lot in games)</td> <td>metadata which never spawns new requests (unlike RDF/HTML, which can cause framerate-dropping, hence not used a lot in games)</td>
@ -1703,21 +1703,6 @@ Non-HTML Hypermedia browsers should make browser extensions the right place, to
<td>flat 3D object</td> <td>flat 3D object</td>
<td>a 3D object of which all verticies share a plane</td> <td>a 3D object of which all verticies share a plane</td>
</tr> </tr>
<tr>
<td>BibTeX</td>
<td>simple tagging/citing/referencing standard for plaintext</td>
</tr>
<tr>
<td>BibTag</td>
<td>a BibTeX tag</td>
</tr>
<tr>
<td>(hashtag)bibs</td>
<td>an easy to speak/type/scan tagging SDL (<a href="https://github.com/coderofsalvation/hashtagbibs">see here</a> which expands to BibTex/JSON/XML</td>
</tr>
</tbody> </tbody>
</table> </table>
<h1 id="index-section">Index</h1> <h1 id="index-section">Index</h1>

9
doc/RFC_XR_Fragments.md
View file

@ -175,6 +175,9 @@ XR Fragments utilizes URLs:
3. explicitly: by scanning `href` metadata **inside** 3D scene-files to enable interactions 3. explicitly: by scanning `href` metadata **inside** 3D scene-files to enable interactions
4. externally: progressively enhance a 3D (file) into an experience via [sidecarfiles](https://en.wikipedia.org/wiki/Sidecar_file) 4. externally: progressively enhance a 3D (file) into an experience via [sidecarfiles](https://en.wikipedia.org/wiki/Sidecar_file)
> Aspect 1 has been pioneered & implemented by (JanusXR's) James Baicoianu (in [janusweb](https://github.com/jbaicoianu/janusweb)) before the spec existed, marking him as a semi-founding father of the spec. Thank you James.
"Aspect 1 was pioneered and implemented by JanusXR / James Baicoianu via [janusweb](https://github.com/jbaicoianu/janusweb) well before the formal specification was established. As a key architect of these early concepts, James’s work laid the groundwork for the standard we use today. We owe him a great deal of thanks for his early contributions."
# What does it solve # What does it solve
It solves: It solves:
@ -1095,7 +1098,7 @@ This document has no IANA actions.
* [NLNET](https://nlnet.nl) * [NLNET](https://nlnet.nl)
* [Future of Text](https://futureoftext.org) * [Future of Text](https://futureoftext.org)
* [visual-meta.info](https://visual-meta.info) * James Baicoianu [janusweb](https://github.com/jbaicoianu/janusweb)
* Michiel Leenaars * Michiel Leenaars
* Gerben van der Broeke * Gerben van der Broeke
* Mauve * Mauve
@ -1128,7 +1131,6 @@ This document has no IANA actions.
|src | (HTML-piggybacked) metadata of a 3D object which instances content | |src | (HTML-piggybacked) metadata of a 3D object which instances content |
|href | (HTML-piggybacked) metadata of a 3D object which links to content | |href | (HTML-piggybacked) metadata of a 3D object which links to content |
|filter | URI Fragment(s) which show/hide object(s) in a scene based on name/tag/property (`#cube&-price=>3`) | |filter | URI Fragment(s) which show/hide object(s) in a scene based on name/tag/property (`#cube&-price=>3`) |
|visual-meta | [visual-meta](https://visual.meta.info) data appended to text/books/papers which is indirectly visible/editable in XR. |
|requestless metadata | metadata which never spawns new requests (unlike RDF/HTML, which can cause framerate-dropping, hence not used a lot in games) | |requestless metadata | metadata which never spawns new requests (unlike RDF/HTML, which can cause framerate-dropping, hence not used a lot in games) |
|FPS | frames per second in spatial experiences (games,VR,AR e.g.), should be as high as possible | |FPS | frames per second in spatial experiences (games,VR,AR e.g.), should be as high as possible |
|introspective | inward sensemaking ("I feel this belongs to that") | |introspective | inward sensemaking ("I feel this belongs to that") |
@ -1136,7 +1138,4 @@ This document has no IANA actions.
|`◻` | ascii representation of an 3D object/mesh | |`◻` | ascii representation of an 3D object/mesh |
|(un)obtrusive | obtrusive: wrapping human text/thought in XML/HTML/JSON obfuscates human text into a salad of machine-symbols and words | |(un)obtrusive | obtrusive: wrapping human text/thought in XML/HTML/JSON obfuscates human text into a salad of machine-symbols and words |
|flat 3D object | a 3D object of which all verticies share a plane | |flat 3D object | a 3D object of which all verticies share a plane |
|BibTeX | simple tagging/citing/referencing standard for plaintext |
|BibTag | a BibTeX tag |
|(hashtag)bibs | an easy to speak/type/scan tagging SDL ([see here](https://github.com/coderofsalvation/hashtagbibs) which expands to BibTex/JSON/XML |

26
doc/RFC_XR_Fragments.xml
View file

@ -125,7 +125,9 @@ XR Fragments exploits the fact that all 3D models already contain such metadata:
<li>explicitly: by scanning <tt>href</tt> metadata <strong>inside</strong> 3D scene-files to enable interactions</li> <li>explicitly: by scanning <tt>href</tt> metadata <strong>inside</strong> 3D scene-files to enable interactions</li>
<li>externally: progressively enhance a 3D (file) into an experience via <eref target="https://en.wikipedia.org/wiki/Sidecar_file">sidecarfiles</eref></li> <li>externally: progressively enhance a 3D (file) into an experience via <eref target="https://en.wikipedia.org/wiki/Sidecar_file">sidecarfiles</eref></li>
</ol> </ol>
</section> <blockquote><t>Aspect 1 has been pioneered &amp; implemented by (JanusXR's) James Baicoianu (in <eref target="https://github.com/jbaicoianu/janusweb">janusweb</eref>) before the spec existed, marking him as a semi-founding father of the spec. Thank you James.
&quot;Aspect 1 was pioneered and implemented by JanusXR / James Baicoianu via <eref target="https://github.com/jbaicoianu/janusweb">janusweb</eref> well before the formal specification was established. As a key architect of these early concepts, James’s work laid the groundwork for the standard we use today. We owe him a great deal of thanks for his early contributions.&quot;</t>
</blockquote></section>
<section anchor="what-does-it-solve"><name>What does it solve</name> <section anchor="what-does-it-solve"><name>What does it solve</name>
<t>It solves:</t> <t>It solves:</t>
@ -1300,7 +1302,7 @@ Non-HTML Hypermedia browsers should make browser extensions the right place, to
<ul spacing="compact"> <ul spacing="compact">
<li><eref target="https://nlnet.nl">NLNET</eref></li> <li><eref target="https://nlnet.nl">NLNET</eref></li>
<li><eref target="https://futureoftext.org">Future of Text</eref></li> <li><eref target="https://futureoftext.org">Future of Text</eref></li>
<li><eref target="https://visual-meta.info">visual-meta.info</eref></li> <li>James Baicoianu <eref target="https://github.com/jbaicoianu/janusweb">janusweb</eref></li>
<li>Michiel Leenaars</li> <li>Michiel Leenaars</li>
<li>Gerben van der Broeke</li> <li>Gerben van der Broeke</li>
<li>Mauve</li> <li>Mauve</li>
@ -1408,11 +1410,6 @@ Non-HTML Hypermedia browsers should make browser extensions the right place, to
<td>URI Fragment(s) which show/hide object(s) in a scene based on name/tag/property (<tt>#cube&amp;-price=&gt;3</tt>)</td> <td>URI Fragment(s) which show/hide object(s) in a scene based on name/tag/property (<tt>#cube&amp;-price=&gt;3</tt>)</td>
</tr> </tr>
<tr>
<td>visual-meta</td>
<td><eref target="https://visual.meta.info">visual-meta</eref> data appended to text/books/papers which is indirectly visible/editable in XR.</td>
</tr>
<tr> <tr>
<td>requestless metadata</td> <td>requestless metadata</td>
<td>metadata which never spawns new requests (unlike RDF/HTML, which can cause framerate-dropping, hence not used a lot in games)</td> <td>metadata which never spawns new requests (unlike RDF/HTML, which can cause framerate-dropping, hence not used a lot in games)</td>
@ -1447,21 +1444,6 @@ Non-HTML Hypermedia browsers should make browser extensions the right place, to
<td>flat 3D object</td> <td>flat 3D object</td>
<td>a 3D object of which all verticies share a plane</td> <td>a 3D object of which all verticies share a plane</td>
</tr> </tr>
<tr>
<td>BibTeX</td>
<td>simple tagging/citing/referencing standard for plaintext</td>
</tr>
<tr>
<td>BibTag</td>
<td>a BibTeX tag</td>
</tr>
<tr>
<td>(hashtag)bibs</td>
<td>an easy to speak/type/scan tagging SDL (<eref target="https://github.com/coderofsalvation/hashtagbibs">see here</eref> which expands to BibTex/JSON/XML</td>
</tr>
</tbody> </tbody>
</table></section> </table></section>