[x3d-public] X3D minutes, Friday 1 APR 2022: glTF X3D4 video, mantis issues, PointProperties markerType

Sun Apr 3 20:05:22 PDT 2022

Attendees: Anita Havele, Dick Puk, Don Brutzman.  Regrets Nicholas Polys.

1.	Great Webinar presentation by Michalis Kamburelis available on
YouTube.  Essential viewing.

*	Physically Based Rendering (PBR) in #X3D4 using #glTF
*	https://www.youtube.com/watch?v=iQ0s1V37tAw
*	https://www.web3d.org/pbr-x3d4-using-gltf
*	https://github.com/michaliskambi/x3d-tests/wiki/2022-Talk-About-X3D-
PBR-glTF

Thanks to Anita and Nicholas for many behind-the-scenes efforts to make
these webinars work.  More on the way!  8) 

2.	Dick and I continued tackling Mantis issues to address editorial
comments (over many years) that can improve the X3D4 specification.  We
addressed 12 issues this past week.

*	Web3D Consortium Mantis Issue Tracker
*	https://www.web3d.org/member-only/mantis/view_all_bug_page.php

3.	We uncovered a major issue with PointProperties when connecting the
ISO Registry of Graphical Items - no field was provided for markerType!  So
this functionality was intended but apparently overlooked, surprisingly.

Now added to X3D XML Schema, DTD, X3D Unified Object Model (X3DUOM), x3d.py
package, X3D Ontology and X3D Tooltips, everything checks OK.

Details follow.  Request close review by authors and implementers.
Supporting different glyphs as markers for points (and point clouds) seems
like a potentially powerful visualization and communication capability.
Example models welcome.

a.	First excerpt that follows is from mantis.

*	Mantis 1393: 12.4.7 PointProperties missing markertype field
*	https://www.web3d.org/member-only/mantis/view.php?id=1393

Description

12.4.7 PointProperties missing markertype field, matching our approach for
other International Registry for Graphical Items

Ensure consistent reference to [REG]

Also need to shift down Support Levels table, inserting new Table 12.4
Marker types

Add corresponding schema, DTD, tooltip entries

Remove editorial comment for Mantis 1252

Proposed field signature:

  SFInt32 [in,out] markerType 1 [0,infinity)

Likely need similar prose from hatchStyle:

"If a markerType that is not supported is requested, markerType 1 shall be
used."

Discussed whether a corresponding boolean field was appropriate. For
FillProperties and for LineProperties, there is always a a default styling
of rendering the information. For points, there needs to be some value
applied or else no point is visible. Overall visibility is already
controlled by the parent Shape node. Therefore no corresponding boolean
field is appropriate for markerType.

b.	Here are guiding standards documents on markerType.

*	ISO/IEC 9973 International Register of Graphical Items 
*	https://www.iso.org/jtc1/sc24/register 

*	Marker type
*	https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/89165
90/6208440/class_pages/markertype.html

*	Example: Plus sign (identifier 2)
*	https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/89165
90/6208440/diagrams/mar002.html

c.	Here is proposed modification to X3D4.

*	X3D4 Architecture, Shape component, 12.4.7 PointProperties
*	https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1
/Part01/components/shape.html#PointProperties

12.4.7 PointProperties

PointProperties : X3DAppearanceChildNode {
  SFVec3f  [in,out] attenuation           1 0 0 [0,∞)
  SFInt32  [in,out] markerType            1     [0,∞)
  SFNode   [in,out] metadata              NULL  [X3DMetadataObject]
  SFFloat  [in,out] pointSizeMaxValue     1     [0,∞)
  SFFloat  [in,out] pointSizeMinValue     1     [0,∞)
  SFFloat  [in,out] pointSizeScaleFactor  1     [1,∞)
}

The PointProperties node specifies additional properties to be applied to
all point geometry. The colour of the line is specified by the associated
Material node or X3DColorNode color values. […]

The markerType field selects a marker type pattern as defined in the
International Register of Graphical Items (see [REG]
<https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01
/references.html#REG> ). If a markerType value that is not supported is
requested, markerType value 1 shall be used. Table 12.4
<https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01
/components/shape.html#t-markerTypes>  specifies the first 26 marker types
as defined in the markerType Section of the International Register of Items
<https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/8916590/6208
440/class_pages/markertype.html> . Examples of each marker type are
available at the International Register of Items.

Table 12.4 - International register of items markerTypes

1

Dot

2

Plus sign

3

Asterisk

4

Circle

5

Diagonal cross

6

Meteorological Station Circle, one okta of cloud

7

Meteorological Station Circle, two oktas of cloud

8

Meteorological Station Circle, three oktas of cloud

9

Meteorological Station Circle, four oktas of cloud

10

Meteorological Station Circle, five oktas of cloud

11

Meteorological Station Circle, six oktas of cloud

12

Meteorological Station Circle, seven oktas of cloud

13

Meteorological Station Circle, eight oktas of cloud

14

Meteorological Station Circle, sky obscured

15

Meteorological Station Circle, sky not observed

16

Meteorological Automatic Station Circle, no cloud

17

Meteorological Automatic Station Circle, one okta of cloud

18

Meteorological Automatic Station Circle, two oktas of cloud

19

Meteorological Automatic Station Circle, three oktas of cloud

20

Meteorological Automatic Station Circle, four oktas of cloud

21

Meteorological Automatic Station Circle, five oktas of cloud

22

Meteorological Automatic Station Circle, six oktas of cloud

23

Meteorological Automatic Station Circle, seven oktas of cloud

24

Meteorological Automatic Station Circle, eight oktas of cloud

25

Meteorological Automatic Station Circle, sky obscured

26

Meteorological Automatic Station Circle, sky not observed

pointSizeScaleFactor is a value determining the nominal point size before
modification by the sizing modifications, as determined by the
pointSizeMinValue, pointSizeMaxValue, and attenuation values discussed
below. The nominal rendered point size is a browser-dependent minimum
renderable point size.

pointSizeMinValue is minimum allowed scaling factor on nominal browser point
scaling. pointSizeMaxValue is maximum allowed scaling factor on nominal
browser point scaling. The provided value for pointSizeMinValue must be less
than or equal to value for pointSizeMaxValue.

When a X3DTextureNode is defined in the same Appearance instance as
PointProperties node, the points of a PointSet shall be displayed as point
sprites using the given texture(s).

TODO reference/bibliography International register of items for markerType.

d.	Here is the added tooltip, for online author reference and also
integration by tools (Python, Java, Turtle).

*	X3D Tooltips PointProperties markertype
*	https://www.web3d.org/x3d/tooltips/X3dTooltips.html#PointProperties.
markerType

<https://www.web3d.org/x3d/content/X3dTooltips.html#PointProperties.markerTy
pe> markerType

[markerType accessType inputOutput
<https://www.web3d.org/x3d/content/X3dTooltips.html#accessType> , type
SFInt32 <https://www.web3d.org/x3d/content/X3dTooltips.html#SFInt32>  CDATA
<https://www.web3d.org/x3d/content/X3dTooltips.html#CDATA>  "1"]
markerType selects a marker display type for points from ISO/IEC 9973
International Register of Graphical Items. 1=Dot , 2=Plus sign, 3=Asterisk,
4=Circle, 5=Diagonal cross, 6=Meteorological Station Circle, one okta of
cloud, 7=Meteorological Station Circle, two oktas of cloud, 8=Meteorological
Station Circle, three oktas of cloud, 9=Meteorological Station Circle, four
oktas of cloud, 10=Meteorological Station Circle, five oktas of cloud,
11=Meteorological Station Circle, six oktas of cloud, 12=Meteorological
Station Circle, seven oktas of cloud, 13=Meteorological Station Circle,
eigth oktas of cloud, 14=Meteorological Station Circle, sky obscured,
15=Meteorological Station Circle, sky not observed, 16=Meteorological
Automatic Station Circle, no cloud, 17=Meteorological Automatic Station
Circle, one okta of cloud, 18=Meteorological Automatic Station Circle, two
oktas of cloud, 19=Meteorological Automatic Station Circle, three oktas of
cloud, 20=Meteorological Automatic Station Circle, four oktas of cloud,
21=Meteorological Automatic Station Circle, five oktas of cloud,
22=Meteorological Automatic Station Circle, six oktas of cloud,
23=Meteorological Automatic Station Circle, seven oktas of cloud,
24=Meteorological Automatic Station Circle, eight oktas of cloud,
25=Meteorological Automatic Station Circle, sky obscured, 26=Meteorological
Automatic Station Circle, sky not observed,
Hint: an ockta is one eighth of the total area of the celestial dome; used
as a measure of cloudiness (one okta means that one eighth of the sky is
obscured, two oktas that one quarter is obscured, and so on).
https://en.wiktionary.org/wiki/okta
Hint: detailed descriptions of markerType values are found at the SO/IEC
9973 International Register of Graphical Items
https://www.iso.org/jtc1/sc24/register at
https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/8916590/62084
40/class_pages/markertype.html

e.	Additional support products.

*	X3D XML Schema documentation
*	https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4
.0.html#Link1B4

*	X3D XML DOCTYPE documentation
*	https://www.web3d.org/specifications/X3dDoctypeDocumentation4.0.html
#PointProperties

f.	Also figured out how to add the full list of these numeric
enumerations in XML Schema and X3DUOM as named simple type,
markerTypeChoices.  Similarly created lists for hatchStyleTypeChoices and
lineTypeChoices.  Implements OK in Turtle, Python and Java.

*	FillProperties hatchStyleTypeChoices 

https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0.html#
LinkB6

*	LineProperties           lineTypeChoices 

https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0.html#
LinkD7 

*	PointProperties  markerTypeChoices

https://www.web3d.org/specifications/X3dSchemaDocumentation4.0/x3d-4.0.html#
LinkD7

So, routine and time-consuming editorial tasks suddenly become fundamentally
valuable.  To me (at least) the cumulative and coherent presentation
capabilities of X3D4 models (with glTF, HTML5, Web Audio) offer significant
expressive power.

Once again: close review is requested of this addition to PointProperties of
markerType.

As ever, all discussion is welcome. Have fun with X3D!   8)

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 https://
faculty.nps.edu/brutzman

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20220404/9e5768d5/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 5353 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20220404/9e5768d5/attachment-0001.p7s>