<div dir="ltr">Just looking at IntegerTrigger <a href="http://www.web3d.org/x3d/content/X3dTooltips.html#IntegerTrigger" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#IntegerTri<wbr>gger</a><br>, I see in the tool tips this description:<div><br></div><div><b style="color:rgb(0,0,0);font-family:"Times New Roman";font-size:medium"><font color="navy">"IntegerTrigger converts boolean true or time input events to an integer value"</font></b><br></div><div><br></div><div>1) IntegerTrigger does not accept time input events:</div><div><br></div><div><a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#IntegerTrigger">http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#IntegerTrigger</a></div><div><br></div><div>So why mention time input events ?</div><div><br></div><div>2) Boolean True</div><div><br></div><div>It is correct that IntergerTrigger convert boolean true events. But is also converts boolean false events.</div><div><br></div><div>The last paragraph in 30.4.6 IntegerTrigger explicitly allows for that:</div><div><br></div><div><span style="color:rgb(0,0,0);font-family:Verdana,Arial,Helvetica,sans-serif;font-size:16px">"Upon receiving a set_boolean event .. The value of </span><em style="color:rgb(0,0,0);font-family:Verdana,Arial,Helvetica,sans-serif;font-size:16px">set_boolean</em><span style="color:rgb(0,0,0);font-family:Verdana,Arial,Helvetica,sans-serif;font-size:16px"> shall be ignored."</span><br></div><div><br></div><div>So I believe having set_boolean false also trigger output was a deliberate design decision. After all one could always use BooleanFilter to suppress boolean false event if desired.</div><div><br></div><div>3) set_boolean field description</div><div><br></div><div>Therefore in the tool tip the set_boolean description should read:</div><div>"<span style="background-color:rgb(238,255,238);color:rgb(0,0,0);font-family:"Times New Roman";font-size:medium">If set_boolean input is received, trigger output of integer value."</span></div><div><br></div><div>4) [integerKey] Hint: directly resetting the integerKey field generates a corresponding triggerValue output event.</div><div> </div><div>I also thought first that reset integerKey would generate a corresponding triggerValue output. But it turns out that all browsers only output a corresponding integerKey output event and not a triggerValue output. I think this behaviour is actually more what the event spec. language suggests and lets authors choose if they want to use triggered output after reset or not. So the hint should become:</div><div><br></div><div><div>"directly resetting the integerKey field generates a corresponding integerKey output event."</div><div> </div></div><div>Looking into TimeTrigger next.</div><div><br></div><div>-Andreas</div><div><br></div><div><br></div><div>-Andreas</div><div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Sep 23, 2017 at 2:00 PM, Don Brutzman <span dir="ltr"><<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Made some further improvements to tooltips. Also added toggle_changed outputOnly event description to BooleanToggle.<br>
<br>
When directly changing inputOutput fields, had mistaken identification of output event names in previous posts. Two corrections:<br>
<br>
BooleanToggle<br>
[toggle] Hint: directly resetting the toggle field generates a corresponding toggle_changed output event.<br>
<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#BooleanTog<wbr>gle</a><br>
<br>
IntegerTrigger<br>
[integerKey] Hint: directly resetting the integerKey field generates a corresponding triggerValue output event.<br>
<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#IntegerTrigger" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#IntegerTri<wbr>gger</a><br>
<br>
TimeTrigger<br>
<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#TimeTrigger" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#TimeTrigge<wbr>r</a><br>
<br>
For all three of these (but not for BooleanFilter):<br>
<br>
[set_boolean] Hint: input event set_boolean false has no effect.<br>
<br>
Changed status of prior Mantis issues 519, 520 to indicated current and related.<br>
<a href="http://www.web3d.org/member-only/mantis/view.php?id=519" rel="noreferrer" target="_blank">http://www.web3d.org/member-on<wbr>ly/mantis/view.php?id=519</a><br>
<br>
Also updated diagram notes:<br>
<br>
X3D Event-Utility Node Diagrams<br>
<a href="http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf" rel="noreferrer" target="_blank">http://x3dgraphics.com/example<wbr>s/X3dForWebAuthors/Chapter09-E<wbr>ventUtilitiesScripting/X3dEven<wbr>tUtilityNodeEventDiagrams.pdf</a><br>
<br>
Subject to specification-team review and resolution of Mantis issues, it appears that these are pretty well set now... hope so.<br>
<br>
Further scrutiny remains welcome!<br>
<br>
p.s. Roy, these corrections also pertain to the pending new mantis issues when they get added. I can apply them later if you prefer.<br>
<br>
<br>
On 9/22/2017 5:58 PM, Don Brutzman wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
On 9/22/2017 3:20 PM, Andreas Plesch wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
I agree, IntegerTrigger would also require such a statement.<br>
</blockquote>
<br>
Very good, tooltips updated.<br>
<br>
<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#BooleanTog<wbr>gle</a><br>
toggle: "Persistent state value that gets toggled or reset. Resetting the toggle field generates a corresponding toggle field output event."<br>
<br>
<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#IntegerTrigger" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#IntegerTri<wbr>gger</a><br>
integerKey: "integerKey is value for output when triggered. Resetting the integerKey field generates a corresponding integerKey field output event."<br>
<br>
<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Since I have implemented IntegerTrigger now for x3dom, and recognize its utility for choosing a switch option, it is less obvious to me that resetting its value should always also lead to output of that value.<br>
<br>
The more conservative approach would be to leave this decision to the author. If a new value is provided to the IntegerTrigger node, the same new value can also always be provided to another node.<br>
<br>
But since players currently do forward these inputs as outputs, there may be a event cascade requirement or similar.<br>
</blockquote>
<br>
It is this last case that pertains. See discussion regarding 4.4.8.1 Events below for requirement.<br>
<br>
Since it is required, it is helpful for us to list this in specification and tooltips so that implementations and expectations are all consistent for everyone.<br>
<br>
Spec feedback submissions follow. Again thanks.<br>
<br>
<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
On Sep 20, 2017 10:20 AM, "Don Brutzman" <<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a> <mailto:<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a>>> wrote:<br>
<br>
This is an excellent improvement, we should submit a spec change.<br>
<br>
Am thinking that similar wording should be provided for IntegerTrigger integerKey field, e.g.<br>
<br>
"Resetting the /integerKey/ field generates a<br>
corresponding /integerKey/ field output event."<br>
<br>
<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#IntegerTrigger" rel="noreferrer" target="_blank">http://www.web3d.org/documents<wbr>/specifications/19775-1/V3.3/<wbr>Part01/components/utils.html#I<wbr>ntegerTrigger</a> <<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#IntegerTrigger" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/components/utils.html#I<wbr>ntegerTrigger</a>><br>
<br>
==============================<wbr>================<br>
30.4.6 IntegerTrigger<br>
<br>
IntegerTrigger : X3DTriggerNode {<br>
SFBool [in] set_boolean<br>
SFInt32 [in,out] integerKey -1 (-∞,∞)<br>
SFNode [in,out] metadata NULL [X3DMetadataObject]<br>
SFInt32 [out] triggerValue<br>
}<br>
<br>
IntegerTrigger handles single field Boolean events to set an integer value for the output event. This is useful for connecting environmental events to the Switch node's whichChoice field.<br>
<br>
Upon receiving a set_boolean event, the IntegerTrigger node will generate a triggerValue event with the current value of integerKey. The value of set_boolean shall be ignored.<br>
==============================<wbr>================<br>
<br>
<br>
On 9/18/2017 10:39 AM, Andreas Plesch wrote:<br>
<br>
Sending output fields upon value changes is how the browsers I tested behaved. Although to me the sentence in 4.4.8.1 which addresses this behaviour and begins with "Nodes also define output fields .." is more explanatory than defining and seems to be intended to leave the exact behavior specification to node definitions. Here is suggested wording to help clarify 30.4.3:<br>
<br>
The BooleanToggle can be reset to a specific state by directly setting the value of the inputOutput /toggle/ field. Resetting the /toggle/ field generates a corresponding /toggle/ field output event.<br>
<br>
There is probably a better and/or more concise phrase to add.<br>
<br>
-Andreas<br>
<br>
On Mon, Sep 18, 2017 at 12:46 PM, Brutzman, Donald (Don) (CIV) <<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a> <mailto:<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a>> <mailto:<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a> <mailto:<a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a>>>> wrote:<br>
<br>
Thank you Andreas. Looks like you have identified an ambiguity in the spec<br>
that might benefit from clarification.<br>
<br>
Since the first paragraph specifically identified output events, and the<br>
second paragraph on "reset" did not, my interpretation was that no event was<br>
sent as part of a reset. That informed the tooltips and diagram notes. However, checking event model rules:<br>
<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#Events" rel="noreferrer" target="_blank">http://www.web3d.org/documents<wbr>/specifications/19775-1/V3.3/<wbr>Part01/concepts.html#Events</a> <<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#Events" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/concepts.html#Events</a>><br>
<<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#Events" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/concepts.html#Events</a> <<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/concepts.html#Events" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/concepts.html#Events</a>>><br>
<br>
<br>
4.4.8 Event model<br>
<br>
4.4.8.1 Events<br>
<br>
/Events/ are the primary means of generating behaviors in the X3D run-time<br>
environment. Events are used throughout X3D: driving time-based<br>
animations; handling object picking; detecting user movement and<br>
collision; changing the scene graph hierarchy. The run-time environment<br>
manages the propagation of events through the system according to a<br>
well-defined set of rules.<br>
<br>
Nodes define input fields (/i.e./, fields with inputOutput or inputOnly<br>
access) that trigger behavior. When a given event occurs, the node<br>
receives notification and can potentially change internal state and the<br>
value of one or more of its fields. *Nodes also define output fields<br>
(/i.e./, fields with inputOutput or outputOnly access) that are sent upon<br>
signal state changes or other occurrences within the node.* Events sent to<br>
input fields and events sent by output fields are referred to collectively<br>
in ISO/IEC 19775 as /Events/.<br>
<br>
<br>
The bolded sentence (beginning with "Nodes also define output fields... that<br>
are sent upon signal state changes" ...) indicates that a corresponding<br>
output event should be sent when the value is changed.<br>
<br>
Subject to review, am happy to make the tooltips and diagram notes more<br>
explicit in this matter. We should likely also add words to spec to avoid<br>
indirect ambiguity and explicitly add clarity.<br>
<br>
all the best, Don<br>
</blockquote>
<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
On Sep 16, 2017, at 4:20 PM, Andreas Plesch <<a href="mailto:andreasplesch@gmail.com" target="_blank">andreasplesch@gmail.com</a> <mailto:<a href="mailto:andreasplesch@gmail.com" target="_blank">andreasplesch@gmail.co<wbr>m</a>><br>
<mailto:<a href="mailto:andreasplesch@gmail.com" target="_blank">andreasplesch@gmail.co<wbr>m</a> <mailto:<a href="mailto:andreasplesch@gmail.com" target="_blank">andreasplesch@gmail.co<wbr>m</a>>>> wrote:<br>
<br>
<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/documents<wbr>/specifications/19775-1/V3.3/<wbr>Part01/components/utils.html#B<wbr>ooleanToggle</a> <<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/components/utils.html#B<wbr>ooleanToggle</a>><br>
<<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/components/utils.html#B<wbr>ooleanToggle</a> <<a href="http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/utils.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/document<wbr>s/specifications/19775-1/V3.3/<wbr>Part01/components/utils.html#B<wbr>ooleanToggle</a>>><br>
<br>
<br>
produces a toggle output event after it receives a set_boolean event.<br>
<br>
Does it also produce a toggle output event after it receives a toggle<br>
input event (to reset the toggle field value) ?<br>
<br>
<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/conte<wbr>nt/X3dTooltips.html#BooleanTog<wbr>gle</a> <<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/cont<wbr>ent/X3dTooltips.html#BooleanTo<wbr>ggle</a>><br>
<<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/cont<wbr>ent/X3dTooltips.html#BooleanTo<wbr>ggle</a> <<a href="http://www.web3d.org/x3d/content/X3dTooltips.html#BooleanToggle" rel="noreferrer" target="_blank">http://www.web3d.org/x3d/cont<wbr>ent/X3dTooltips.html#BooleanTo<wbr>ggle</a>>><br>
<br>
does not mention this and the diagram at<br>
<a href="http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf" rel="noreferrer" target="_blank">http://x3dgraphics.com/example<wbr>s/X3dForWebAuthors/Chapter09-E<wbr>ventUtilitiesScripting/X3dEven<wbr>tUtilityNodeEventDiagrams.pdf</a> <<a href="http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf" rel="noreferrer" target="_blank">http://x3dgraphics.com/exampl<wbr>es/X3dForWebAuthors/Chapter09-<wbr>EventUtilitiesScripting/X3dEve<wbr>ntUtilityNodeEventDiagrams.pdf</a><wbr>><br>
<<a href="http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf" rel="noreferrer" target="_blank">http://x3dgraphics.com/exampl<wbr>es/X3dForWebAuthors/Chapter09-<wbr>EventUtilitiesScripting/X3dEve<wbr>ntUtilityNodeEventDiagrams.pdf</a> <<a href="http://x3dgraphics.com/examples/X3dForWebAuthors/Chapter09-EventUtilitiesScripting/X3dEventUtilityNodeEventDiagrams.pdf" rel="noreferrer" target="_blank">http://x3dgraphics.com/exampl<wbr>es/X3dForWebAuthors/Chapter09-<wbr>EventUtilitiesScripting/X3dEve<wbr>ntUtilityNodeEventDiagrams.pdf</a><wbr>>><br>
<br>
also seems silent.<br>
<br>
Not sure if there are examples which reset the internal value of the<br>
toggle field ?<br>
<br>
Andreas<br>
</blockquote>
<br>
all the best, Don<br>
</blockquote>
<br>
<br>
all the best, Don<span class="gmail-HOEnZb"><font color="#888888"><br>
-- <br>
Don Brutzman Naval Postgraduate School, Code USW/Br <a href="mailto:brutzman@nps.edu" target="_blank">brutzman@nps.edu</a><br>
Watkins 270, MOVES Institute, Monterey CA 93943-5000 USA <a href="tel:%2B1.831.656.2149" value="+18316562149" target="_blank">+1.831.656.2149</a><br>
X3D graphics, virtual worlds, navy robotics <a href="http://faculty.nps.edu/brutzman" rel="noreferrer" target="_blank">http://faculty.nps.edu/brutzma<wbr>n</a><br>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Andreas Plesch<br>Waltham, MA 02453</div></div></div>
</div></div></div>