=Goal=

The [http://www.web3D.org/x3d X3D Working Group] will participate in the [http://www.w3.org/html/wg HTML Working Group] for the purpose of best integrating X3D with HTML.

This effort has strategic importance for Web3D. We intend to establish a solid foundation for X3D to properly support 3D graphics in HTML5.

=HTML5=

The [http://www.w3.org/html/wg HTML working group] page states:

What is HTML? HTML is the publishing language of the World Wide Web.

The latest editor's draft Hypertext Markup Language (HTML) recommendation states:

[http://dev.w3.org/html5/spec/Overview.html HTML 5] W3C Working Draft
A vocabulary and associated APIs for HTML and XHTML

[http://dev.w3.org/html5/spec/Overview.html#declarative-3d-scenes 13.2 Declarative 3D scenes]
Embedding 3D imagery into XHTML documents is the domain of X3D,
or technologies based on X3D that are namespace-aware.

[http://dev.w3.org/html5/spec/Overview.html#the-object-element 4.8.5 The object element]
The object element can represent an external resource, which, depending on
the type of the resource, will either be treated as an image, as a nested
browsing context, or as an external resource to be processed by a plugin.

[http://dev.w3.org/html5/spec/Overview.html#the-param-element 4.8.6 The param element]
The param element defines parameters for plugins invoked by object elements.

=Technical Tasks=

We are working on the following tasks.
* Ensure that all HTML5 questions and issues relative to X3D are properly considered and answered.
* Document how native X3D in .xml encoding can be best be embedded inside an HTML5 document, typically in a namespace-aware fashion
* Demonstrate X3D+HTML5 examples on the [http://www.web3D.org Web3D Consortium] website
* Examine how X3D pertains to related HTML5 tags (such as object and canvas) that are used for plugin-type content
* Track MIME type issues
* Examine overall interoperability issues: combined X3D and HTML content with one floating over the other
** X3D scene with transparent background floating over HTML document or desktop
** HTML text overlay laid out over an X3D scene as help
* Identify API issues of mutual interest (such as DOM, Ajax and XHR) for further developmental work

=Work Support=

* Maintain this X3D and HTML5 wiki page to track issues and progress
* Identify people in HTML5 working group who want to collaborate with us on these issues
* Report regularly on efforts to [mailto:x3d@web3d.org x3d@web3d.org mailing list] and in our every-other-week X3D working group teleconferences
* Discussions to occur on the [mailto:x3d@web3d.org x3d@web3d.org mailing list] and [mailto:public-html@w3.org public-html@w3.org mailing list]
* Other tasks and efforts as needed

=Participation=

Relevant HTML5 and W3C information:
* [http://www.w3.org/html/wg HTML Working Group] especially [http://www.w3.org/html/wg/#who Membership and Participation]
* [http://www.w3.org World Wide Web Consortium (W3C)]
* [http://www.w3.org/Consortium/Process W3C Process Document]

The following individuals have volunteered to serve as X3D Working Group representatives in the HTML5 Working Group.
* Johannes Behr, [http://instantreality.org Instant Reality], Fraunhofer Research, Darmstadt Germany
* [http://web.nps.navy.mil/~brutzman Don Brutzman], Naval Postgraduate School (Web3D-W3C liaison and W3C Advisory Committee representative), Monterey California USA
* John Stewart, [http://www.crc.ca/FreeWRL FreeWrl], Communications Research Center (CRC) Canada
* Joe Williams, [http://hypermultimedia.com HyperMultiMedia], Santa Rosa California USA

Any other [http://www.web3D.org Web3D Consortium] members who are interested in serving as one of our X3D Working Group representatives is asked to review the HTML working group membership materials, notify the X3D working group that you are interested, and describe what your goals will be.

=Meetings=

Our weekly X3D and HTML5 teleconference is 0800-0900 (pacific time) each Tuesday.

We are requesting membership for Web3D participants in W3C HTML5. Don will report to W3C our list of participants, passwords and access will then be provided.

=Annotated References=

X3D and HTML4
* [http://www.web3d.org/x3d/content/examples/HtmlObjectTagForX3d.html HTML Object Tag for X3D] shows how to place X3D objects within an HTML page
* [http://www.web3d.org/x3d/content/examples/newHtmlPageWithX3dObject.html newHtmlPageWithX3dObject.html] is an example HTML scene with X3D object tag to copy, edit and reuse.
* [http://www.web3d.org/x3d/specifications/ISO-IEC-19775-1.2-X3D-AbstractSpecification/Part01/X3D.html X3D Abstract Specification]
* [http://www.web3d.org/x3d/specifications/ISO-IEC-FCD-19775-2.2-X3D-SceneAccessInterface/Part02/X3D_SAI.html X3D Scene Access Interface (SAI)] Edition 2
** [http://www.web3d.org/x3d/specifications/ISO-IEC-FCD-19775-2.2-X3D-SceneAccessInterface/Part02/servRef.html#importDocument 6.3.13 importDocument] service is a utility request to import a W3C DOM document or document fragment and convert it to an X3D scene.

HTML4 and XHTML
* [http://www.w3.org/TR/html4 HTML 4.01] HyperText Markup Language (HTML)
* [http://www.w3.org/TR/xhtml1/ XHTML] Extensible HyperText Markup Language (XHTML)

HTML5
* [http://dev.w3.org/html5/spec/Overview.html#embedded-content-0 4.8 Embedded content]
** [http://dev.w3.org/html5/spec/Overview.html#the-figure-element 4.8.1 The figure element] represents some flow content, optionally with a caption, which can be moved away from the main flow of the document without affecting the document's meaning.
** [http://dev.w3.org/html5/spec/Overview.html#the-img-element 4.8.2 The img element] represents an image.
** [http://dev.w3.org/html5/spec/Overview.html#the-iframe-element 4.8.3 The iframe element] represents a nested browsing context.
** [http://dev.w3.org/html5/spec/Overview.html#the-embed-element 4.8.4 The embed element] represents an integration point for an external (typically non-HTML) application or interactive content.
** [http://dev.w3.org/html5/spec/Overview.html#the-object-element 4.8.5 The object element] can represent an external resource, which, depending on the type of the resource, will either be treated as an image, as a nested browsing context, or as an external resource to be processed by a plugin.
** [http://dev.w3.org/html5/spec/Overview.html#the-param-element 4.8.6 The param element] defines parameters for plugins invoked by object elements. It does not represent anything on its own.
** [http://dev.w3.org/html5/spec/Overview.html#video 4.8.7 The video element] represents a video or movie.
** [http://dev.w3.org/html5/spec/Overview.html#audio 4.8.8 The audio element] is a media element whose media data is ostensibly audio data.
** [http://dev.w3.org/html5/spec/Overview.html#source 4.8.9 The source element] allows authors to specify multiple media resources for media elements. It does not represent anything on its own.
** [http://dev.w3.org/html5/spec/Overview.html#media-elements 4.8.10 Media elements] are used to present audio data, or video and audio data, to the user.
** [http://dev.w3.org/html5/spec/Overview.html#the-canvas-element 4.8.11 The canvas element] represents a resolution-dependent bitmap canvas, which can be used for rendering graphs, game graphics, or other visual images on the fly.
** [http://dev.w3.org/html5/spec/Overview.html#the-map-element 4.8.12 The map element], in conjunction with any area element descendants, defines an image map. The element represents its children.
** [http://dev.w3.org/html5/spec/Overview.html#the-area-element 4.8.13 The area element] represents either a hyperlink with some text and a corresponding area on an image map, or a dead area on an image map.
** [http://dev.w3.org/html5/spec/Overview.html#the-image-element 4.8.14 Image maps] allows geometric areas on an image to be associated with hyperlinks.
** [http://dev.w3.org/html5/spec/Overview.html#mathml 4.8.15 MathML] from the [http://dev.w3.org/html5/spec/Overview.html#mathml-namespace MathML namespace] falls into the embedded content category for the purposes of the content models in this specification.
** [http://dev.w3.org/html5/spec/Overview.html#svg 4.8.16 SVG] from the [http://dev.w3.org/html5/spec/Overview.html#svg-namespace SVG namespace] falls into the embedded content category for the purposes of the content models in this specification.
** [http://dev.w3.org/html5/spec/Overview.html#dimension-attributes 4.8.17 Dimension attributes]

=API details under discussion=

We have discussed Johannes' message of 25 March 2009 + responses (Subject: Re: Khronos Press Releases etc.) that included an X3DOM-connector.pdf diagram regarding how X3D might work with DOM, HTML etc. Also discussed the thread on Khronos' presumed upcoming work on Canvas3D element, and past work on Ajax3D.

These and other API topics are all technically related, and of interest, but have varying degrees of maturity.

The primary objective of the current effort is to support X3D and HTML5. Further work on DOM and other APIs is likely to evolve and spin off from this central effort.

==X3DOM proposal==

===Basics===

The object element represents external resource like pdf-documents, movies or x3d-worlds. This works nicely for isolated content and applications which are unrelated to the surrounding xhtml-document. If the web-application developer would like to access and manipulate the object content he or she has to deal with object or plugin specific interfaces. e.g. X3D browser should provide a Scene Access Interface (SAI).

The X3DOM model tires to ease the development of applications which needs to modify the X3D world content during runtime by following and respecting some basic xhtml rules:

1) Declarative XML content is part of the DOM tree; Embedded with a separate xml namespace

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<body>
<x3d:x3d xmlns:x3d="http://www.web3d.org/specifications/x3d-3.0.xsd">
<x3d:Scene>
<x3d:Shape><x3d:Box x3d:size="4 4 4" /></x3d:Shape>
</x3d:Scene>
</x3d:x3d>
</body>
</html>

2) The DOM elements can be used to read and manipulate the content

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN","http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<body>
<x3d xmlns=
"http://www.web3d.org/specifications/x3d-3.0.xsd">
<Scene>
<Shape><Box size="4 4 4" /></Shape>
</Scene>
</x3d>
<script type="text/javascript">
// The namespace URIs
var xhtml_ns = "http://www.w3.org/1999/xhtml";
var x3d_ns =
"http://www.web3d.org/specifications/x3d-3.0.xsd";
// Get elements using namespaces
var h1 =
document.getElementsByTagNameNS(xhtml_ns, "h1");
var box =
document.getElementsByTagNameNS(x3d_ns, "Box")[0];
// Edit an attribute of the <Box /> element
alert(box.getAttributeNS(null, "size"));
box.setAttributeNS(null, "size", "2 2 2");
alert(box.getAttributeNS(null, "size"));
</script>
</body>

3) Events can be used to interact with the content

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN", "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<body>
<x3d xmlns=
"http://www.web3d.org/specifications/x3d-3.0.xsd">
<Scene>
<Transform>
<Shape><Box size="4 4 4" />
</Shape>
<TouchSensor id="ts" DEF="ts" />
</Transform>
</Scene>
</x3d>
<script type="text/javascript">
// The namespace URIs
var xhtml_ns = "http://www.w3.org/1999/xhtml";
var x3d_ns = "http://www.web3d.org/specifications/x3d-3.0.xsd";
// Get elements using namespaces
var h1 = document.getElementsByTagNameNS(xhtml_ns, "h1");
var x3d = document.getElementsByTagNameNS(x3d_ns, "x3d")[0];
var ts = x3d.getElementsByTagName("TouchSensor")[0];
alert("ts=" + ts);
ts.addEventListener("touchTime", function() {
alert("clicked");
}, false);
</script>
</body>
</html>

4) The position of the content in the document defines the position of the visible elements

The X3D element should also define the position where the content will be integrated into the html page.
Simular how e.g. SVG or canvas works. A decoupled mechanisms will confuse application developer

===Implementation===

The X3DOM model should be implemented as native browser feature, simular to SVG, in the future. Current test-implementation utilize the object/SAI model internally. In addition test-versions based on the Canvas3D layer exist. Both need a browser-extension right now to synchronize and update the DOM changes

=Future work=

Some topics might become relevant once HTML5 is established as a formal W3C Recommendation. These are not part of our current planned work.

* Publishing [http://www.web3d.org/x3d/specifications X3D Specifications] in HTML5
* Other topics as needed

Script-and-inputOutputField.x3d

Using inputOuput Fields in scripts
<?xml version="1.0" encoding="UTF-8"?>
<X3D profile='Full' >
<Scene DEF='scene'>
<Viewpoint position='20 0 40'/>
<Shape>
<Text DEF='text' string='"Initialize called: FALSE" "readFoo() called: FALSE" "foo value send: FALSE" "foo function called: FALSE" "set_foo function called: FALSE" "foo_changed function called: FALSE"'/>
</Shape>
<Script DEF='s1' directOutput='true'>
<field accessType='initializeOnly' name='text' type='SFNode'>
<Text USE='text'/>
</field>
<field accessType='inputOutput' name='foo' type='SFFloat' value='5'/>
<field accessType='inputOnly' name='readFoo' type='SFTime'/><![CDATA[ecmascript:
//-----------------------------
function initialize (value) {
line = 'Initialized called: TRUE; foo value: ' + foo;
text.string[0] = line;
}
//-----------------------------
function readFoo (value) {
text.string[1] = 'readFoo called: TRUE, value: ' + foo;
}
//-----------------------------
function foo (value) {
text.string[3] = 'foo function called: TRUE; ' + value;
}
//-----------------------------
function set_foo (value) {
text.string[4] = 'set_foo function called: TRUE; ' + value;
}
//-----------------------------
function foo_changed (value) {
text.string[5] = 'foo_changed function called: TRUE; ' + value;
}
]]>
</Script>
<TimeSensor DEF='ts' cycleInterval='3' loop='true'/>
<Script DEF='s2' directOutput='true'>
<field accessType='initializeOnly' name='text' type='SFNode'>
<Text USE='text'/>
</field>
<field accessType='inputOnly' name='fooCatcher' type='SFFloat'/><![CDATA[ecmascript:
//-----------------------
function fooCatcher (value) {
text.string[2] = 'Foo value send: TRUE; value: ' + value;
}
]]>
</Script>
<ROUTE fromNode='ts' fromField='fraction_changed' toNode='s1' toField='set_foo'/>
<ROUTE fromNode='ts' fromField='cycleTime' toNode='s1' toField='readFoo'/>
<ROUTE fromNode='s1' fromField='foo_changed' toNode='s2' toField='fooCatcher'/>
</Scene>
</X3D>

Script-and-inputOutputField.x3d

2008-08-06T21:07:14Z

Jbehr:

Script-and-inputOutputField.x3d

2008-08-06T21:06:53Z

Jbehr:

Script-and-inputOutputField.x3d

2008-08-06T20:57:18Z

Jbehr:

X3D Plugfest

2008-08-06T20:53:53Z

Jbehr: /* Problem Content */

= X3D Plugfest =

The goal of the X3D Plugfest is to foster interoperability between X3D players. This event will bring
content authors, authoring tool vendors and browser implementers together to work on interoperability
issues.

This page will be the navigation home page for the upcoming X3D Plugfest. Content will be
linked from this page for everyone's review.

== Problem Content ==

*[[Viewpoint-binding-0.x3d]]
*[[ViewpointInlineMain.x3d]]
*[[TopLevelTouchSensors.x3d]]
*[[String.x3d]]
*[[GlobalAttenuation.x3d]]
*[[Script-and-inputOutputField.x3d]]

== Working Content ==
*[[MovingBox.x3d]]
*[[CoordMorph.x3d]]

== Issues ==

This is a summary of the issues discovered.

*User Initial Position without a Viewpoint
*Extrusion Implementations
*Node fields on a proto declaration, copy or reference