[x3d-public] improved definitions, clarifications to X3D Architecture Clause 3 Terms, definitions, acronyms, and abbreviations

[John Carlson]

I think where I’m stuck is creating statements in C++ SAI.   I don’t know
whether to use createNode for statements, constructors, or there might be a
createStatement in the future.   It would seem if there’s a
createStatement, there should be an abstract Statement class.

At one point, I wondered if statements were even legal in SAI.

I guess I need to further examine the working draft.

Thanks.   No response is necessary.

John

On Thu, Aug 12, 2021 at 7:33 PM Brutzman, Donald (Don) (CIV) <
brutzman at nps.edu> wrote:

> Thanks for thinking about this.  No abstract statements exist in X3D.
>
>
>
> Please look at X3DUOM.  You will find abstract node types, a few abstract
> interfaces, nodes and statements.
>
>
>
> *From:* John Carlson <yottzumm at gmail.com>
> *Sent:* Friday, August 6, 2021 10:54 AM
> *To:* Brutzman, Donald (Don) (CIV) <brutzman at nps.edu>
> *Cc:* x3d-public at web3d.org
> *Subject:* Re: [x3d-public] improved definitions, clarifications to X3D
> Architecture Clause 3 Terms, definitions, acronyms, and abbreviations
>
>
>
> Perhaps abstract statements should be added to X3DUOM if not already there?
>
>
>
> John
>
>
>
> On Fri, Aug 6, 2021 at 12:42 PM Brutzman, Donald (Don) (CIV) <
> brutzman at nps.edu> wrote:
>
> We are considering Mantis 1173 to add a number of definitions and
> clarifications to the X3D Architecture specification.  This was first
> proposed in September 2017.
>
>
>
>    - Mantis 1173: Clause 3 Terms, definitions, acronyms, and
>    abbreviations - Definition of node and statement are insufficient
>    - https://www.web3d.org/member-only/mantis/view.php?id=1173
>
>
>
> Review and any suggested wording improvements are welcome.  Absent objects
> or improvements, we will apply these nonfunctional editorial changes.
>
>
>
> -----------------
> Subject: Abstract specification definitions of node and statement are
> insufficient.
>
> Problem: the abstract specification does not provide clear definitions for
> nodes and statements, resulting in ambiguous distinctions throughout other
> sections.
>
> The current definition for node is vague:
> "3.1.47 node, fundamental component of a scene graph"
>
> Suggested definition, improvements welcome:
> "3.1.47 node, fundamental component of a scene graph that defines
> information regarding animation, display, geometry, graph structure,
> interaction, object metadata, or rendering. Nodes are not statements.
>
> No definition for statement is provided. Suggested:
> "3.1.70.5, statement, fundamental component of a scene graph that defines
> document information, version/profile/component support, routing, and other
> scene-related information. Statements are not nodes.
>
> Existing usage of note:
> "3.1.87 X3D file, set of X3D nodes and statements as defined in this part
> of ISO/IEC 19775"
>
> Further action needed: Core component defines multiple capabilities
> requiring X3D statement support. Recommend that support for all X3D
> statements is included as a requirement in Core component, both in prose
> and in support table. For example: "All X3D statements are defined as part
> of Core component level 1."
>
> Table 7.2 — Core component support levels
>
> http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/core.html#t-Coresupportlevels
> Can add similar table entry "All X3D statements are defined as part of
> Core component level 1."
>
> Correction needed:
> Figure 4.1 — X3D architecture
>
> http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#f-X3DArchitecture
> "The abstract structure of the sequence of statements that form an X3D
> world is specified in 7.2.5 Abstract X3D structure."
> should be modified to read "sequence of nodes and statements that form an
> X3D world"
>
> 7.2.5 Abstract X3D structure
>
> http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/core.html#AbstractX3DStructure
> 7.2.5.1 Organization
> should similarly modify
> "An X3D world is conceptually defined as a sequence of statements
> organized conceptually as a file."
> to say "as a sequence of nodes and statements"
>
> Needed:
> "PROTO instances are nodes."
>
> Suggested:
> "Comments are neither nodes nor statements."
>
> This section should also include a paragraph that lists X3D statements,
> such as
> "X3D statements include X3D, HEAD, PROFILE, COMPONENT, META, UNIT, Scene,
> ROUTE, PROTO declare, EXTERNPROTO delare, PROTO interface, PROTO body,
> field, fieldValue, IS, connect, IMPORT, EXPORT. Syntax and
> explicit/implicit definition for these statements can vary among various
> encodings and language bindings."
>
> Further review of the abstract specification is warranted to see if other
> clarifications and corrections are needed.
>
> Of note is that clear distinction of nodes and statements is also
> necessary for proper specification of the X3D Unified Object Model.
>
> These clarifications are not expected to break any existing X3D model
> content because the existing legacy specification makes no relevant
> restrictions on use of X3D statements. Similarly, these clarifications do
> not require changes (but may inspire improvements) to existing X3D
> implementations.
> -----------------
>
>
>
> all the best, Don
>
> --
>
> Don Brutzman  Naval Postgraduate School, Code USW/Br
> brutzman at nps.edu
>
> Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA   +1.831.656.2149
>
> X3D graphics, virtual worlds, navy robotics
> http://faculty.nps.edu/brutzman
>
>
>
> _______________________________________________
> x3d-public mailing list
> x3d-public at web3d.org
> http://web3d.org/mailman/listinfo/x3d-public_web3d.org
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20210812/da8fa84a/attachment-0001.html>