[x3d-public] x3dom bug related to IS/children PROTOs?

John Carlson yottzumm at gmail.com
Sun Nov 22 18:50:03 PST 2020


Wait...7.3.6 *X3DPrototypeInstance*

X3DPrototypeInstance : X3DNode {
  SFNode [in,out] metadata NULL [X3DMetadataObject]

}

ProtoInstance is a Node or a Statement???

For nodes, I use these semantics: USE creates another parent reference, not
another child (see below).  If it doesn't create another child, there's no
room whatever is in name, it should already be populated in the DEF'd node.

I have no clue why this keeps popping up.  Is it because the ProtoDeclare
is in another namespace than the instance?

John

DEF/USE semantics from V4:
https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-WD3/
4.4.3 DEF/USE semantics

Node names are limited in scope to a single X3D file, prototype definition,
or string submitted to either CreateX3DFromString, CreateX3DFromStream, or
CreateX3DFromURL browser service or a construction for SFNodes within a
script. The USE statement does not create a copy of the node. Instead, the
same node is inserted into the scene graph a second time, resulting in the
node having multiple parents (see 4.3.5 Transformation hierarchy
<https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-WD3/Part01/concepts.html#Transformationhierarchy>,
for restrictions on self-referential nodes).

Node names shall be unique in the context within which the associated DEF
keyword occurs.

TODO: describe how, when an external environment exists,

   - Abstract definition of how events can be exchanged between external
   environment and scene graph.
   - Syntax for multiple encoding/language bindings may be defined in
   related specifications, e.g. updates to 19777-1 JavaScript, 19776-1 XML
   Encoding, and (eventually) 19776-5 JSON.
   - For example, HTML5/DOM id attribute can be used for performing event
   callbacks using JavaScript, and thus has a similar role to DEF when events
   are ROUTEd.
   - Editors discussion: examples should not go into an annex, will need to
   go into other file encodings and language bindings.
   - Pending eventual ISO submission and review of those specifications, we
   will need example usage and some specification details publicly available
   to support implementation efforts.



On Sun, Nov 22, 2020 at 8:28 PM John Carlson <yottzumm at gmail.com> wrote:

>
> https://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#DEFL_USESemantics
> (for nodes, not statements).  DEF's with the same value can appear in more
> than one namespace.
>
> For nodes, what happens if you have a different name in the USE node
> referencing the DEF'd node?
>
> I think the answer is, additional fields can be used in statements, but
> not nodes.
>
> Now the question is, how should the JSON Schema react to this
> information?  This was not handled for the most part in the hand generated
> schema, I'm not even sure it was handled by XML schema or X3DUOM, so we're
> only talking about the generated JSON schema, as appears here:
>
> https://www.web3d.org/specifications/x3d-4.0-JSONSchema.json (not 3.3!)
>
> John
>
>
> On Sun, Nov 22, 2020 at 8:15 PM John Carlson <yottzumm at gmail.com> wrote:
>
>>
>>
>> ---------- Forwarded message ---------
>> From: John Carlson <yottzumm at gmail.com>
>> Date: Sun, Nov 22, 2020 at 8:10 PM
>> Subject: Re: x3dom bug related to IS/children PROTOs?
>> To: Andreas Plesch <andreasplesch at gmail.com>
>>
>>
>> I'll just pretend we zoomed back from 2020->2015 virtually (in the mind).
>>
>> Can we agree, that in most cases (nodes), USE is the only field allowed
>> when USE appears?
>>
>> If not, I've got to change all my JSON schema generating code.
>>
>> Maybe we'll decide on another JSON schema based on the XML schema, since
>> XML Spy can now generate a JSON schema from an XML schema last I heard.
>>
>> Let's just break all my coding for the last 5 years!  Whee!
>>
>> I would need to know all the nodes/statements where additional fields are
>> allowed when USE appears.  I think there's only two cases.
>>
>> Or is this a thing in X3D4?
>>
>> It seems like USE has two different semantics, whether you're using it on
>> a node or not?  I know in one case, it's intended to add another parent to
>> a node (not statement I guess), but perhaps that's a X3D3 thing?
>>
>> John
>>
>> On Sun, Nov 22, 2020 at 7:51 PM Andreas Plesch <andreasplesch at gmail.com>
>> wrote:
>>
>>> I think the spec. does not have an opinion on this, see x3d-public and
>>> other players. Cheers, -Andreas
>>>
>>> On Sun, Nov 22, 2020 at 8:47 PM John Carlson <yottzumm at gmail.com> wrote:
>>>
>>>> Note that X3DOM should now probably flag ProtoInstances with both name
>>>> and USE with a warning that the code is now non-compliant or deprecated. I
>>>> believe the spec says that USE and name together are only allowed in
>>>> certain nodes (I think Metadata and perhaps one other comes to mind).
>>>>
>>>> That's the best I have right now.  See previous discussion on mailing
>>>> list regarding extra fields including name along with USE.
>>>>
>>>> Also, if you use JSON schema, it should catch JSON examples as
>>>> non-compliant if they contain both name and USE.  This works in JSON,
>>>> because containerFields are not used in JSON.
>>>>
>>>> And yes, this may have all changed under my nose!
>>>>
>>>> John
>>>>
>>>>
>>>> On Sun, Nov 22, 2020 at 7:19 PM Andreas Plesch <andreasplesch at gmail.com>
>>>> wrote:
>>>>
>>>>> Yes, the Diamond files have the diamond shape in the ProtoDeclaration.
>>>>>
>>>>> I added guards for nonimplemented but expected, standard fields (such
>>>>> as addChildren) to ProtoDeclaration.js, and allowed USE ProtoInstances by
>>>>> looking for DEFs in the dom (before parsing, at the initial step of
>>>>> translation to the concise x3dom syntax).
>>>>>
>>>>> These changes should help with making these older HAnim protos work
>>>>> better.
>>>>>
>>>>> -Andreas
>>>>>
>>>>> On Sun, Nov 22, 2020 at 4:43 PM John Carlson <yottzumm at gmail.com>
>>>>> wrote:
>>>>>
>>>>>>
>>>>>> I see one Shape (in a proto?), but I didn’t look for geometry.   I
>>>>>> believe there is satisfactory appearance.   I believe I only checked one
>>>>>> LOA4 file.   I am not sure about converted files.
>>>>>>
>>>>>> I will look into this in more detail later today.  I believe at least
>>>>>> the Diamond files should have shapes.
>>>>>>
>>>>>> John
>>>>>>
>>>>>> On Sun, Nov 22, 2020 at 9:35 AM Andreas Plesch <
>>>>>> andreasplesch at gmail.com> wrote:
>>>>>>
>>>>>>> Yes this is Proto related, due to the "addChildren" and
>>>>>>> "removeChildren" fields not being available in x3dom for grouping nodes.
>>>>>>> And those are not available because x3dom cannot route node type fields.
>>>>>>>
>>>>>>> Although the Protos define the addChildren field it is actually
>>>>>>> never used in the examples, so they are not actually necessary. You could
>>>>>>> just remove them.
>>>>>>>
>>>>>>> The examples use an old Proto implementation of HAnim. The native
>>>>>>> implementation is also available, without Protos.
>>>>>>>
>>>>>>> Perhaps it would make sense to add noop stubs for add/removeChildren
>>>>>>> fields in X3DGroupingNode.js, or add a guard for the Proto field type.
>>>>>>>
>>>>>>> I notice that hanimloa4.html does not have any geometry to render,
>>>>>>> only the joint structure.
>>>>>>>
>>>>>>
>>>>>
>>>>> --
>>>>> Andreas Plesch
>>>>> Waltham, MA 02453
>>>>>
>>>>
>>>
>>> --
>>> Andreas Plesch
>>> Waltham, MA 02453
>>>
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20201122/e31cf96c/attachment.html>


More information about the x3d-public mailing list