diff --git a/CHANGELOG .md b/CHANGELOG .md index 9d20ce6..0ba34a1 100644 --- a/CHANGELOG .md +++ b/CHANGELOG .md @@ -8,7 +8,7 @@ Contact Us @ info@3dhop.net -16 March 2018 +4 June 2018 #### TEAM --------- @@ -21,17 +21,21 @@ Marco Potenziani @ marco.potenziani@isti.cnr.it #### CHANGELOG FILE ------------------- -*Version DEVELOPMENT* +*Version 4.2* **Main Changes** * Added GLOBAL LIGHTING control; * Added basic MOBILE DEVICE support; +* Fixed IE browser critical bug; +* Updated NEXUS TEXTURE HANDLING and DATA CACHING systems; +* Updated PLY parser; +* Updated SHADERS SET; +* Updated SCENE CREATION system; +* Updated ZOOM and CENTERING modes and functions; * Updated CAMERA PROJECTION modes and functions; * Updated TOUCH HANDLING; * Updated UI system; -* Updated TEXTURE HANDLING and DATA CACHING systems; -* Updated PLY parser; * Updated PICKING functions; * Updated PLANES SECTIONING TOOL; * Updated TRACKBALL SET; @@ -39,45 +43,14 @@ Marco Potenziani @ marco.potenziani@isti.cnr.it **Files Added/Modified** * Added "HOWTO_10.0_camera_lighting.html" file; +* Added "HOWTO_10.1_camera_lighting.html" file; * Added "logo.png" file; +* Added "corto.js" file; * Added "meco.js" file; -* Updated "index_all_tools.html" file; +* Added "gargo.nxz" model file; +* Removed "gargo.nxs" model file; +* Removed "meshcoder_worker.js" file; +* Updated all "*.html" files; * Updated all "*.js" files; -* Updated "3dhop.css" file; +* Updated all "*.css" files; * Updated "skins" directory; - -*Version 4.1* - -**Main Changes** - -* Fixed "MISSING PATCH" BUG in NEXUS models rendering; -* Fixed "TEXTURE WAKE UP" BUG in NEXUS models rendering; -* Fixed SAFARI browser PATCH for NEXUS models rendering; -* Fixed MINOR issues in TRACKBALL SET; -* Updated NEXUS RENDERING and MEMORY ALLOCATION system; -* Updated and optimized SHADERS SET; -* Updated TRACKBALL PAN SPEED; -* Updated COLOR CODED ID feature; -* Updated MEASUREMENT HANDLER; -* Added STYLESHEET for viewer informative PANELS; -* Added ALL TOOL viewer TEMPLATE; -* Added NEW SHADER for clusters of points/lines; -* Added TOOLBAR COLOR SWITCH function; -* Added POINTSIZE setup in SCENE CONFIG; -* Added mouse RIGHT BUTTON PAN feature; -* Added REPAINT function; -* Added support for TEXTURES and POINT CLOUDS for PLY models; -* Added ORTHOGRAPHIC CAMERA mode and functions; -* Minified spidergl.js file; -* Cleanup code and indentation in various .js files; - -**Files Added/Modified** - -* Added "3DHpanels.css" file; -* Added "index_all_tools.html" file; -* Updated "index.html" file and renamed "index_no_tools.html"; -* Updated "HOWTO_8.1_point_picking.html" file; -* Updated "HOWTO_8.0_measurement_tool.html" file; -* Updated all "*.js" files; -* Updated "3dhop.css" file; -* Updated "docs.html" file; diff --git a/CHANGELOG.txt b/CHANGELOG.txt index 9d20ce6..0ba34a1 100644 --- a/CHANGELOG.txt +++ b/CHANGELOG.txt @@ -8,7 +8,7 @@ Contact Us @ info@3dhop.net -16 March 2018 +4 June 2018 #### TEAM --------- @@ -21,17 +21,21 @@ Marco Potenziani @ marco.potenziani@isti.cnr.it #### CHANGELOG FILE ------------------- -*Version DEVELOPMENT* +*Version 4.2* **Main Changes** * Added GLOBAL LIGHTING control; * Added basic MOBILE DEVICE support; +* Fixed IE browser critical bug; +* Updated NEXUS TEXTURE HANDLING and DATA CACHING systems; +* Updated PLY parser; +* Updated SHADERS SET; +* Updated SCENE CREATION system; +* Updated ZOOM and CENTERING modes and functions; * Updated CAMERA PROJECTION modes and functions; * Updated TOUCH HANDLING; * Updated UI system; -* Updated TEXTURE HANDLING and DATA CACHING systems; -* Updated PLY parser; * Updated PICKING functions; * Updated PLANES SECTIONING TOOL; * Updated TRACKBALL SET; @@ -39,45 +43,14 @@ Marco Potenziani @ marco.potenziani@isti.cnr.it **Files Added/Modified** * Added "HOWTO_10.0_camera_lighting.html" file; +* Added "HOWTO_10.1_camera_lighting.html" file; * Added "logo.png" file; +* Added "corto.js" file; * Added "meco.js" file; -* Updated "index_all_tools.html" file; +* Added "gargo.nxz" model file; +* Removed "gargo.nxs" model file; +* Removed "meshcoder_worker.js" file; +* Updated all "*.html" files; * Updated all "*.js" files; -* Updated "3dhop.css" file; +* Updated all "*.css" files; * Updated "skins" directory; - -*Version 4.1* - -**Main Changes** - -* Fixed "MISSING PATCH" BUG in NEXUS models rendering; -* Fixed "TEXTURE WAKE UP" BUG in NEXUS models rendering; -* Fixed SAFARI browser PATCH for NEXUS models rendering; -* Fixed MINOR issues in TRACKBALL SET; -* Updated NEXUS RENDERING and MEMORY ALLOCATION system; -* Updated and optimized SHADERS SET; -* Updated TRACKBALL PAN SPEED; -* Updated COLOR CODED ID feature; -* Updated MEASUREMENT HANDLER; -* Added STYLESHEET for viewer informative PANELS; -* Added ALL TOOL viewer TEMPLATE; -* Added NEW SHADER for clusters of points/lines; -* Added TOOLBAR COLOR SWITCH function; -* Added POINTSIZE setup in SCENE CONFIG; -* Added mouse RIGHT BUTTON PAN feature; -* Added REPAINT function; -* Added support for TEXTURES and POINT CLOUDS for PLY models; -* Added ORTHOGRAPHIC CAMERA mode and functions; -* Minified spidergl.js file; -* Cleanup code and indentation in various .js files; - -**Files Added/Modified** - -* Added "3DHpanels.css" file; -* Added "index_all_tools.html" file; -* Updated "index.html" file and renamed "index_no_tools.html"; -* Updated "HOWTO_8.1_point_picking.html" file; -* Updated "HOWTO_8.0_measurement_tool.html" file; -* Updated all "*.js" files; -* Updated "3dhop.css" file; -* Updated "docs.html" file; diff --git a/README.md b/README.md index 6c16e15..7af069a 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Contact Us @ info@3dhop.net -16 March 2018 +4 June 2018 #### TEAM --------- diff --git a/README.txt b/README.txt index 6c16e15..7af069a 100644 --- a/README.txt +++ b/README.txt @@ -8,7 +8,7 @@ Contact Us @ info@3dhop.net -16 March 2018 +4 June 2018 #### TEAM --------- diff --git a/documentation/docs.html b/documentation/docs.html index 47742c2..3a181fe 100644 --- a/documentation/docs.html +++ b/documentation/docs.html @@ -14,340 +14,401 @@
- 3DHOP object related native functions: -
-animateToTrackballPosition(position) | - | set a new position for the used trackball and animate the camera from the current point of view to the new setted; | |
Parameters | position | [array] : the spatial coordinates of the trackball (the number of values may varying depending on the used trackball); |
animateToTrackballPosition(position) | - | set a new position for the used trackball and animate the camera from the current point of view to the new setted; | |
Parameters | position | [array] : the spatial coordinates of the trackball (the number of values may varying depending on the used trackball); | |
enableLightTrackball(state) | - | enable or disable the 3D scene trackball interactive lighting control; | |
Parameters | state | [boolean] : true to enable, false to disable (light trackball is disabled by default); | |
enableLightTrackball(state) | - | enable or disable the 3D scene trackball interactive lighting control; | |
Parameters | state | [boolean] : true to enable, false to disable (light trackball is disabled by default). Enabling the interactive light trackball control also enables the scene lighting (if disabled); | |
enableMeasurementTool(state) | - | enable or disable the 3D scene interactive measurement tool; | |
Parameters | state | [boolean] : true to enable, false to disable (measurement tool is disabled by default); | |
enableMeasurementTool(state) | - | enable or disable the 3D scene interactive measurement tool; | |
Parameters | state | [boolean] : true to enable, false to disable (measurement tool is disabled by default); | |
enableOnHover(state) | - | enable or disable the visual effects (spots transparency and mouse cursor changes) related to the movement of the mouse pointer onto a mesh in the 3D scene. | |
Parameters | state | [boolean] : true to enable, false to disable (on hover effects are disabled by default). Visual effects activation could decreases performance on slower systems; | |
enableOnHover(state) | - | enable or disable the visual effects (spots transparency and mouse cursor changes) related to the movement of the mouse pointer onto a mesh in the 3D scene. | |
Parameters | state | [boolean] : true to enable, false to disable (on hover effects are disabled by default). Visual effects activation could decreases performance on slower systems; | |
enablePickpointMode(state) | - | enable or disable the 3D scene interactive point picking mode; | |
Parameters | state | [boolean] : true to enable, false to disable (point picking mode is disabled by default); | |
enablePickpointMode(state) | - | enable or disable the 3D scene interactive point picking mode; | |
Parameters | state | [boolean] : true to enable, false to disable (point picking mode is disabled by default); | |
getClippingRendermode() | return the current rendering setup of the sectioning tool (sectioning planes and edges visibility state, edges size and color values); | ||
Returns | - | [array] : the 4-dimensional array containing the sectioning tool setup values: sectioning planes visibility (true if rendered, false if not), sectioning edges visibility (true if rendered, false if not), sectioning edges size value (express in scene space absolute value), sectioning edges color 3-dimensional array (express in RGB arithmetic notation, from 0 to 1, with any fractional value in between); | |
enableSceneLighting(state) | - | enable or disable the 3D scene lighting system; | |
Parameters | state | [boolean] : true to enable, false to disable (scene lighting is enabled by default). Disabling the scene lighting also disables the interactive light trackball control (if enabled); | |
getClippingX() | return the current operating state of the sectioning plane along the X axis; | ||
Returns | - | [number] : the operating state of the sectioning plane along the X axis: 0 if disabled, 1 if enabled (splitting the 3D scene along the X axis, cutting out the clippable instances on the positive side of the intersection), and -1 also if enabled (again splitting the 3D scene along the X axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
getCameraType() | return the current setup of the virtual camera (projection mode); | ||
Returns | - | [string] : the projection mode name ("perspective" or "orthographic", "perspective" is selected by default); | |
getClippingY() | return the current operating state of the sectioning plane along the Y axis; | ||
Returns | - | [number] : the operating state of the sectioning plane along the Y axis: 0 if disabled, 1 if enabled (splitting the 3D scene along the Y axis, cutting out the clippable instances on the positive side of the intersection), and -1 also if enabled (again splitting the 3D scene along the Y axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
getClippingRendermode() | return the current rendering setup of the sectioning tool (sectioning planes and edges visibility state, edges size and color values); | ||
Returns | - | [array] : the 4-dimensional array containing the sectioning tool setup values: sectioning planes visibility (true if rendered, false if not), sectioning edges visibility (true if rendered, false if not), sectioning edges size value (expressed in scene space absolute value), sectioning edges color 3-dimensional array (expressed in RGB arithmetic notation, from 0 to 1, with any fractional value in between); | |
getClippingZ() | return the current operating state of the sectioning plane along the Z axis; | ||
Returns | - | [number] : the operating state of the sectioning plane along the Z axis: 0 if disabled, 1 if enabled (splitting the 3D scene along the Z axis, cutting out the clippable instances on the positive side of the intersection), and -1 also if enabled (again splitting the 3D scene along the Z axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
getClippingX() | return the current operating state of the sectioning plane along the X axis; | ||
Returns | - | [number] : the operating state of the sectioning plane along the X axis: 0 if disabled, 1 if enabled (splitting the 3D scene along the X axis, cutting out the clippable instances on the positive side of the intersection), and -1 also if enabled (again splitting the 3D scene along the X axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
getTrackballPosition() | return the current position of the used trackball; | ||
Returns | - | [array] : the spatial coordinates of the trackball (the number of values may vary depending on the used trackball); | |
getClippingY() | return the current operating state of the sectioning plane along the Y axis; | ||
Returns | - | [number] : the operating state of the sectioning plane along the Y axis: 0 if disabled, 1 if enabled (splitting the 3D scene along the Y axis, cutting out the clippable instances on the positive side of the intersection), and -1 also if enabled (again splitting the 3D scene along the Y axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
isAnyMeasurementEnabled() | return the activation status of the 3D scene interactive measurement tools (measurement tool and point picking mode); | ||
Returns | - | [boolean] : true if enabled, false if disabled. The function returns true if at least one of all the measurement tool is enabled; | |
getClippingZ() | return the current operating state of the sectioning plane along the Z axis; | ||
Returns | - | [number] : the operating state of the sectioning plane along the Z axis: 0 if disabled, 1 if enabled (splitting the 3D scene along the Z axis, cutting out the clippable instances on the positive side of the intersection), and -1 also if enabled (again splitting the 3D scene along the Z axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
isInstanceVisibilityEnabled(tag) | return the visibility status in the 3D scene of the model instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If tag is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
getTrackballPosition() | return the current position of the used trackball; | ||
Returns | - | [array] : the spatial coordinates of the trackball (the number of values may vary depending on the used trackball); | |
isInstanceVisibilityEnabledByName(name) | return the visibility status in the 3D scene of the model instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If name is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
isAnimate() | return the activation status of the 3D scene camera animation feature; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
isLightTrackballEnabled() | return the activation status of the 3D scene trackball interactive lighting control; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
isAnyMeasurementEnabled() | return the activation status of the 3D scene interactive measurement tools (measurement tool and point picking mode); | ||
Returns | - | [boolean] : true if enabled, false if disabled. The function returns true if at least one of all the measurement tool is enabled; | |
isMeasurementToolEnabled() | return the activation status of the 3D scene interactive measurement tool; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
isInstanceLightingEnabled(tag) | return the lighting activation status in the 3D scene of the model instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the lighting command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if active, false if not active. If tag is "HOP_ALL" the function returns true if at least one of all the instances enables lighting; | |
isPickpointModeEnabled() | return the activation status of the 3D scene interactive point picking mode; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
isInstanceLightingEnabledByName(name) | return the lighting activation status in the 3D scene of the model instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the lighting command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if active, false if not active. If tag is "HOP_ALL" the function returns true if at least one of all the instances enables lighting; | |
isSpotVisibilityEnabled(tag) | return the visibility status in the 3D scene of the hot spot instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If tag is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
isInstanceVisibilityEnabled(tag) | return the visibility status in the 3D scene of the model instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If tag is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
isSpotVisibilityEnabledByName(name) | return the visibility status in the 3D scene of the hot spot instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If name is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
isInstanceVisibilityEnabledByName(name) | return the visibility status in the 3D scene of the model instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If name is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
isOnHoverEnabled() | return the activation status of the visual effects (spots transparency and mouse cursor changes) related to the movement of the mouse pointer onto a mesh in the 3D scene; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
isInstanceSolidColorEnabled(tag) | return the solid color usage status in the 3D scene of the model instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the solid color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if active, false if not active. If tag is "HOP_ALL" the function returns true if at least one of all the instances enables solid colors; | |
repaint() | redraw the 3D scene; | ||
isInstanceSolidColorEnabledByName(name) | return the solid color usage status in the 3D scene of the model instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the solid color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if active, false if not active. If tag is "HOP_ALL" the function returns true if at least one of all the instances enables solid colors; | |
resetClippingXYZ() | - | reset both the position and the operating state of the sectioning planes along the X, Y and Z axes to the initial setting; | |
isInstanceTransparencyEnabled(tag) | return the transparency status in the 3D scene of the model instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if active, false if not active. If tag is "HOP_ALL" the function returns true if at least one of all the instances enables transparency; | |
resetTrackball() | - | reset both the position and light control trackballs to the initial setting; | |
isInstanceTransparencyEnabledByName(name) | return the transparency status in the 3D scene of the model instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if active, false if not active. If tag is "HOP_ALL" the function returns true if at least one of all the instances enables transparency; | |
rotateLight(x, y) | - | rotate the 3D scene light trackball; | |
Parameters | x | [number] : the amount of displacement along the x-axis (accepts values ranging from -0.5 to 0.5); | |
y | [number] : the amount of displacement along the y-axis (accepts values ranging from -0.5 to 0.5); | ||
isLightTrackballEnabled() | return the activation status of the 3D scene trackball interactive lighting control; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
setCameraPerspective() | - | set the camera type to perspective projection mode; | |
isMeasurementToolEnabled() | return the activation status of the 3D scene interactive measurement tool; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
setCameraOrthographic() | - | set the camera type to orthographic projection mode; | |
isPickpointModeEnabled() | return the activation status of the 3D scene interactive point picking mode; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
setCenterModeFirst() | - | set the virtual scene center in the barycenter of its first declared model instance; | |
isSceneLightingEnabled() | return the activation status of the 3D scene lighting system; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
setCenterModeScene() | - | set the virtual scene center in the barycenter of all model instances which compose the scene; | |
isSpotVisibilityEnabled(tag) | return the visibility status in the 3D scene of the hot spot instance specified by tag; | ||
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances ("HOP_ALL is the default tag value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If tag is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
setCenterModeSpecific(name) | - | set the virtual scene center in the barycenter of the specified model instance; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the scene will be centered; | |
isSpotVisibilityEnabledByName(name) | return the visibility status in the 3D scene of the hot spot instance specified by name; | ||
Parameters | name | [string] : the instance name specified in "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances ("HOP_ALL is the default name value"); | |
Returns | - | [boolean] : true if visible, false if not visible. If name is "HOP_ALL" the function returns true if at least one of all the instances is visible; | |
setCenterModeExplicit(point) | - | set the virtual scene center in the specified spatial coordinates; | |
Parameters | point | [array] : the 3-dimensional array containing the point spatial coordinates in vector notation (express in scene space absolute value); | |
isOnHoverEnabled() | return the activation status of the visual effects (spots transparency and mouse cursor changes) related to the movement of the mouse pointer onto a mesh in the 3D scene; | ||
Returns | - | [boolean] : true if enabled, false if disabled; | |
setClippingPointXYZ(x, y, z) | - | set the intersection points of the sectioning planes along the X, Y and Z axes (expressed in normalized value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values ranging to 0 and 1); | |
y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values ranging from 0 to 1); | ||
z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values ranging from 0 to 1); | ||
repaint() | redraw the 3D scene; | ||
setClippingPointXYZabs(x, y, z) | - | set the intersection points of the sectioning planes along the X, Y and Z axes (expressed in scene space absolute value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values expressed in scene space absolute value); | |
y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values expressed in scene space absolute value); | ||
z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values expressed in scene space absolute value); | ||
resetClippingXYZ() | - | reset both the position and the operating state of the sectioning planes along the X, Y and Z axes to the initial setting; | |
setClippingPointX(x) | - | set the intersection point of the sectioning plane along the X, axis (expressed in normalized value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values ranging to 0 and 1); | |
resetTrackball() | - | reset both the position and light control trackballs to the initial setting; | |
setClippingPointXabs(x) | - | set the intersection point of the sectioning plane along the X axis (expressed in scene space absolute value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values expressed in scene space absolute value); | |
rotateLight(x, y) | - | rotate the 3D scene light trackball; | |
Parameters | x | [number] : the amount of displacement along the x-axis (accepts values ranging from -0.5 to 0.5); | |
y | [number] : the amount of displacement along the y-axis (accepts values ranging from -0.5 to 0.5); | ||
setClippingPointY(y) | - | set the intersection point of the sectioning plane along the Y axis (expressed in normalized value); | |
Parameters | y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values ranging from 0 to 1); | |
setCameraPerspective() | - | set the camera type to perspective projection mode; | |
setClippingPointYabs(y) | - | set the intersection point of the sectioning plane along the Y axis (expressed in scene space absolute value); | |
Parameters | y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values expressed in scene space absolute value); | |
setCameraOrthographic() | - | set the camera type to orthographic projection mode; | |
setClippingPointZ(z) | - | set the intersection point of the sectioning plane along the Z axis (expressed in normalized value); | |
Parameters | z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values ranging from 0 to 1); | |
setCenterModeFirst() | - | set the virtual scene center in the barycenter of its first declared model instance; | |
setClippingPointZabs(z) | - | set the intersection point of the sectioning plane along the Z axis (expressed in scene space absolute value); | |
Parameters | z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values expressed in scene space absolute value); | |
setCenterModeScene() | - | set the virtual scene center in the barycenter of all model instances which compose the scene; | |
setClippingRendermode(state, state, *size, *color) | - | customize the rendering setup of the sectioning tool (sectioning planes and edges visibility state, and optionally edges size and color values); | |
Parameters | state | [boolean] : true to render the sectioning planes (if any), false to not render (true by default); | |
state | [boolean] : true to render the sectioning edges (if any), false to not render (false by default); | ||
size | [number] : the size value (express in scene space absolute value) of the sectioning edges (if rendered). Accepts values greater than 0.0. Optional parameter (default sectioning edges size is 0.5); | ||
color | [array] : the 3-dimensional array containing color values of the sectioning edges (if rendered). Accepts values express in RGB arithmetic notation (from 0 to 1, with any fractional value in between). Optional parameter (default sectioning edges color is [0.0, 1.0, 1.0]); | ||
setCenterModeSpecific(name) | - | set the virtual scene center in the barycenter of the specified model instance; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the scene will be centered; | |
setClippingXYZ(state, state, state) | - | set the operating state of the sectioning planes along the X, Y and Z axes; | |
Parameters | state | [number] : the operating state of the X axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the X axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the X axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
state | [number] : the operating state of the Y axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Y axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Y axis, but this time cutting out the clippable instances on the negative side of the intersection); | ||
state | [number] : the operating state of the Z axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Z axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Z axis, but this time cutting out the clippable instances on the negative side of the intersection); | ||
setCenterModeExplicit(point) | - | set the virtual scene center in the specified spatial coordinates; | |
Parameters | point | [array] : the 3-dimensional array containing the point spatial coordinates in vector notation (expressed in scene space absolute value); | |
setClippingX(state) | - | set the operating state of the sectioning plane along the X axis; | |
Parameters | state | [number] : the operating state of the X axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the X axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the X axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
setClippingPointXYZ(x, y, z) | - | set the intersection points of the sectioning planes along the X, Y and Z axes (expressed in normalized value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values ranging to 0 and 1); | |
y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values ranging from 0 to 1); | ||
z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values ranging from 0 to 1); | ||
setClippingY(state) | - | set the operating state of the sectioning plane along the Y axis; | |
Parameters | state | [number] : the operating state of the Y axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Y axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Y axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
setClippingPointXYZabs(x, y, z) | - | set the intersection points of the sectioning planes along the X, Y and Z axes (expressed in scene space absolute value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values expressed in scene space absolute value); | |
y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values expressed in scene space absolute value); | ||
z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values expressed in scene space absolute value); | ||
setClippingZ(state) | - | set the operating state of the sectioning plane along the Z axis; | |
Parameters | state | [number] : the operating state of the Z axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Z axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Z axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
setClippingPointX(x) | - | set the intersection point of the sectioning plane along the X, axis (expressed in normalized value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values ranging to 0 and 1); | |
setInstanceSolidColor(tag, state, redraw, *color) | - | set a solid color for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance solid color, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
color | [array] : the 3-dimensional array containing color values express in RGB arithmetic notation (from 0 to 1, with any fractional value in between). Optional parameter (default solid color is [1.0, 1.0, 1.0]); | ||
setClippingPointXabs(x) | - | set the intersection point of the sectioning plane along the X axis (expressed in scene space absolute value); | |
Parameters | x | [number] : the intersection point between the X sectioning plane and the X axis (accepts values expressed in scene space absolute value); | |
setInstanceSolidColorByName(name, state, redraw, *color) | - | set a solid color for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance solid color, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
color | [array] : the 3-dimensional array containing color values express in RGB arithmetic notation (from 0 to 1, with any fractional value in between). Optional parameter (default solid color is [1.0, 1.0, 1.0]); | ||
setClippingPointY(y) | - | set the intersection point of the sectioning plane along the Y axis (expressed in normalized value); | |
Parameters | y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values ranging from 0 to 1); | |
setInstanceTransparency(tag, state, redraw, *alpha) | - | set the transparency of the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance transparency, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
alpha | [number] : the alpha transparency value, varying from 0 (max transparency) to 1 (min transparency), with any fractional value in between. Optional parameter (default alpha value is 0.5); | ||
setClippingPointYabs(y) | - | set the intersection point of the sectioning plane along the Y axis (expressed in scene space absolute value); | |
Parameters | y | [number] : the intersection point between the Y sectioning plane and the Y axis (accepts values expressed in scene space absolute value); | |
setInstanceTransparencyByName(name, state, redraw, *alpha) | - | set the transparency of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance transparency, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
alpha | [number] : the alpha transparency value, varying from 0 (max transparency) to 1 (min transparency), with any fractional value in between. Optional parameter (default alpha value is 0.5); | ||
setClippingPointZ(z) | - | set the intersection point of the sectioning plane along the Z axis (expressed in normalized value); | |
Parameters | z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values ranging from 0 to 1); | |
setInstanceVisibility(tag, state, redraw) | - | set the visibility in the 3D scene of the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setClippingPointZabs(z) | - | set the intersection point of the sectioning plane along the Z axis (expressed in scene space absolute value); | |
Parameters | z | [number] : the intersection point between the Z sectioning plane and the Z axis (accepts values expressed in scene space absolute value); | |
setInstanceVisibilityByName(name, state, redraw) | - | set the visibility in the 3D scene of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setClippingRendermode(state, state, *size, *color) | - | customize the rendering setup of the sectioning tool (sectioning planes and edges visibility state, and optionally edges size and color values); | |
Parameters | state | [boolean] : true to render the sectioning planes (if any), false to not render (true by default); | |
state | [boolean] : true to render the sectioning edges (if any), false to not render (false by default); | ||
size | [number] : the size value (expressed in scene space absolute value) of the sectioning edges (if rendered). Accepts values greater than 0.0. Optional parameter (default sectioning edges size is 0.5); | ||
color | [array] : the 3-dimensional array containing color values of the sectioning edges (if rendered). Accepts values expressed in RGB arithmetic notation (from 0 to 1, with any fractional value in between). Optional parameter (default sectioning edges color is [0.0, 1.0, 1.0]); | ||
setRadiusModeFirst() | - | scale the virtual scene to fit in the viewer the first declared model instance; | |
setClippingXYZ(state, state, state) | - | set the operating state of the sectioning planes along the X, Y and Z axes; | |
Parameters | state | [number] : the operating state of the X axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the X axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the X axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
state | [number] : the operating state of the Y axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Y axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Y axis, but this time cutting out the clippable instances on the negative side of the intersection); | ||
state | [number] : the operating state of the Z axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Z axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Z axis, but this time cutting out the clippable instances on the negative side of the intersection); | ||
setRadiusModeScene() | - | scale the virtual scene to fit in the viewer all model instances which compose the scene; | |
setClippingX(state) | - | set the operating state of the sectioning plane along the X axis; | |
Parameters | state | [number] : the operating state of the X axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the X axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the X axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
setRadiusModeSpecific(name) | - | scale the virtual scene to fit in the viewer the specified model instance; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the scene will be scaled; | |
setClippingY(state) | - | set the operating state of the sectioning plane along the Y axis; | |
Parameters | state | [number] : the operating state of the Y axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Y axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Y axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
setRadiusModeExplicit(size) | - | scale the virtual scene to fit in the viewer an object with the specified size; | |
Parameters | size | [number] : the size value (express in scene space absolute value) on which the scene will be scaled. Accepts values greater than 0.0; | |
setClippingZ(state) | - | set the operating state of the sectioning plane along the Z axis; | |
Parameters | state | [number] : the operating state of the Z axis sectioning plane. Accepts three values: 0 to disable the related sectioning plane, 1 to enable it (splitting the 3D scene along the Z axis, cutting out the clippable instances on the positive side of the intersection), and -1 also to enable it (again splitting the 3D scene along the Z axis, but this time cutting out the clippable instances on the negative side of the intersection); | |
setScene(options) | - | 3DHOP main method, set the 3D scene; | |
Parameters | options | [multiple values] : all the text fields that define the virtual scene (meshes, modelInstances, spots, trackball, space). Check the how to section for more details; | |
setInstanceLighting(tag, state, redraw) | - | set the lighting for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the lighting command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance lighting, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setSpotVisibility(tag, state, redraw) | - | set the visibility in the 3D scene of the hot spot instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setInstanceLightingByName(name, state, redraw) | - | set the lighting for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the lighting command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance lighting, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setSpotVisibilityByName(name, state, redraw) | - | set the visibility in the 3D scene of the hot spot instance specified by name; | |
Parameters | name | [string] : the instance name specified in "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setInstanceSolidColor(tag, state, redraw, *color) | - | set a solid color for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance solid color, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
color | [array] : the 3-dimensional array containing color values expressed in RGB arithmetic notation (from 0 to 1, with any fractional value in between). Optional parameter (default solid color is [1.0, 1.0, 1.0]); | ||
setTrackballPosition(position) | - | set a new position for the used trackball and redraw the 3D scene with the camera in the new setted point; | |
Parameters | position | [array] : the spatial coordinates of the trackball (the number of values may varying depending on the used trackball); | |
setInstanceSolidColorByName(name, state, redraw, *color) | - | set a solid color for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance solid color, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
color | [array] : the 3-dimensional array containing color values expressed in RGB arithmetic notation (from 0 to 1, with any fractional value in between). Optional parameter (default solid color is [1.0, 1.0, 1.0]); | ||
supportsWebGL() | check if the system supports the WebGL API; | ||
Returns | - | [boolean] : true if supported, false if not supported; | |
setInstanceTransparency(tag, state, redraw, *alpha) | - | set the transparency of the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance transparency, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
alpha | [number] : the alpha transparency value, varying from 0 (max transparency) to 1 (min transparency), with any fractional value in between. Optional parameter (default alpha value is 0.5); | ||
toggleCameraType() | - | toggle the camera type between perspective and orthographic projection modes; | |
setInstanceTransparencyByName(name, state, redraw, *alpha) | - | set the transparency of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to active the instance transparency, false to not active; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
alpha | [number] : the alpha transparency value, varying from 0 (max transparency) to 1 (min transparency), with any fractional value in between. Optional parameter (default alpha value is 0.5); | ||
toggleDebugMode() | - | toggle 3DHOP between normal mode and debug mode; | |
setInstanceVisibility(tag, state, redraw) | - | set the visibility in the 3D scene of the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
toggleInstanceSolidColor(tag, redraw) | - | toggle the solid color usage for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setInstanceVisibilityByName(name, state, redraw) | - | set the visibility in the 3D scene of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
toggleInstanceSolidColorByName(name, redraw) | - | toggle the solid color usage for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setRadiusModeFirst() | - | scale the virtual scene to fit in the viewer the first declared model instance; | |
toggleInstanceTransparency(tag, redraw) | - | toggle the transparency usage for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setRadiusModeScene() | - | scale the virtual scene to fit in the viewer all model instances which compose the scene; | |
toggleInstanceTransparencyByName(name, redraw) | - | toggle the transparency usage for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setRadiusModeSpecific(name) | - | scale the virtual scene to fit in the viewer the specified model instance; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the scene will be scaled; | |
toggleInstanceVisibility(tag, redraw) | - | toggle the visibility in the 3D scene of the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setRadiusModeExplicit(size) | - | scale the virtual scene to fit in the viewer an object with the specified size; | |
Parameters | size | [number] : the size value (expressed in scene space absolute value) on which the scene will be scaled. Accepts values greater than 0.0; | |
toggleInstanceVisibilityByName(name, redraw) | - | toggle the visibility in the 3D scene of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setScene(options) | - | 3DHOP main method, set the 3D scene; | |
Parameters | options | [multiple values] : all the text fields that define the virtual scene (meshes, modelInstances, spots, trackball, space). Check the how to section for more details; | |
toggleSpotVisibility(tag, redraw) | - | toggle the visibility in the 3D scene of the hot spot instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setSpotVisibility(tag, state, redraw) | - | set the visibility in the 3D scene of the hot spot instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
toggleSpotVisibilityByName(name, redraw) | - | toggle the visibility in the 3D scene of the hot spot instance specified by name; | |
Parameters | tag | [string] : the name instance specified in "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
setSpotVisibilityByName(name, state, redraw) | - | set the visibility in the 3D scene of the hot spot instance specified by name; | |
Parameters | name | [string] : the instance name specified in "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
state | [boolean] : true to make the instance visible, false to not make; | ||
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
zoomIn() | - | zoom the camera one step into the 3D scene; | |
setTrackballPosition(position) | - | set a new position for the used trackball and redraw the 3D scene with the camera in the new setted point; | |
Parameters | position | [array] : the spatial coordinates of the trackball (the number of values may varying depending on the used trackball); | |
zoomOut() | - | zoom the camera one step out of the 3D scene; | |
supportsWebGL() | check if the system supports the WebGL API; | ||
Returns | - | [boolean] : true if supported, false if not supported; |
- 3DHOP object related callback functions (activated by specific events): -
-_onEndMeasurement(measure, *point, *point) | - | bind an event handler to be fired when a measurement action ends; | |
Parameters | measure | [number] : the size of the last measurement performed (expressed in scene space absolute value); | -|
point | [array] : the 3-dimensional array containing the spatial coordinates of the first measure point picked (expressed in scene space absolute value). Optional parameter; | -||
point | [array] : the 3-dimensional array containing the spatial coordinates of the last measure point picked (expressed in scene space absolute value). Optional parameter; | ||
toggleDebugMode() | - | toggle 3DHOP between normal mode and debug mode; | |
_onEndPickingPoint(point) | - | bind an event handler to be fired when a point picking action ends; | |
Parameters | point | [array] : the 3-dimensional array containing the spatial coordinates of the last point picked (expressed in scene space absolute value); | |
toggleInstanceLighting(tag, redraw) | - | toggle the lighting in the 3D scene of the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the lighting command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
_onEnterInstance(id) | - | bind an event handler to be fired when the mouse enters an instance; | |
Parameters | id | [string] : the instance name specified in the "modelInstance" field of "setScene"; | |
toggleInstanceLightingByName(name, redraw) | - | toggle the lighting in the 3D scene of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the lighting command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
_onEnterSpot(id) | - | bind an event handler to be fired when the mouse enters a spot; | |
Parameters | id | [string] : the spot name specified in the "spots" field of "setScene"; | |
toggleInstanceSolidColor(tag, redraw) | - | toggle the solid color usage for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
_onLeaveInstance(id) | - | bind an event handler to be fired when the mouse leaves an instance; | |
Parameters | id | [string] : the instance name specified in the "modelInstance" field of "setScene"; | |
toggleInstanceSolidColorByName(name, redraw) | - | toggle the solid color usage for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the color command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
_onLeaveSpot(id) | - | bind an event handler to be fired when the mouse leaves a spot; | |
Parameters | id | [string] : the spot name specified in the "spots" field of "setScene"; | |
toggleInstanceTransparency(tag, redraw) | - | toggle the transparency usage for the model instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
_onPickedInstance(id) | - | bind an event handler to be fired when the mouse clicks an instance; | |
Parameters | id | [string] : the instance name specified in the "modelInstance" field of "setScene"; | |
toggleInstanceTransparencyByName(name, redraw) | - | toggle the transparency usage for the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the transparency command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
_onPickedSpot(id) | - | bind an event handler to be fired when the mouse clicks a spot; | |
Parameters | id | [string] : the spot name specified in the "spots" field of "setScene"; |
- 3DHOP object independent utility functions: -
-colorSwitch() | - | switch between on/off toolbar related color mode button icon; | |
toggleInstanceVisibilityByName(name, redraw) | - | toggle the visibility in the 3D scene of the model instance specified by name; | |
Parameters | name | [string] : the instance name specified in "modelInstance" (in "setScene") that refers the instance of the model on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the models instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
fullscreenSwitch() | - | switch between 3DHOP element fullscreen and normal mode, simultaneously updating the toolbar related button icon; | |
toggleSpotVisibility(tag, redraw) | - | toggle the visibility in the 3D scene of the hot spot instance specified by tag; | |
Parameters | tag | [string] : the tag keyword specified in the "tags" field of "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
hotspotSwitch() | - | switch between on/off toolbar related hotspot button icon; | |
toggleSpotVisibilityByName(name, redraw) | - | toggle the visibility in the 3D scene of the hot spot instance specified by name; | |
Parameters | tag | [string] : the name instance specified in "spots" (in "setScene") that refers the instance of the hot spot on which the visibility command acts. Accepts the constant value "HOP_ALL" too (without quotes) that refers all the hot spots instances; | |
redraw | [boolean] : true to redraw the 3D scene, false to not redraw; | ||
lightSwitch() | - | switch between on/off toolbar related light control button icon; | |
version() | check the 3DHOP version; | ||
Returns | - | [constant] : the constant value that refers to the framework version number (expressed in "version major" dot "version minor" dot "version revision" format); | |
measureSwitch() | - | switch between on/off toolbar related measurement tool button icon; | |
zoomIn() | - | zoom the camera one step into the 3D scene; | |
- | switch between on/off toolbar related measurement tool button icon. This functionality is DEPRECATED, use "measureSwitch()" instead; | ||
zoomOut() | - | zoom the camera one step out of the 3D scene; | |
- | move the 3DHOP measure output box around the screen. This functionality is DEPRECATED, use "moveMeasurementbox(left, top)" instead; | ||
Parameters | right | [number] : measure box right space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : measure box top space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); |
+ 3DHOP object related callback functions (activated by specific events): +
+_onEndMeasurement(measure, *point, *point) | - | bind an event handler to be fired when a measurement action ends; | |
Parameters | measure | [number] : the size of the last measurement performed (expressed in scene space absolute value); | +|
point | [array] : the 3-dimensional array containing the spatial coordinates of the first measure point picked (expressed in scene space absolute value). Optional parameter; | +||
point | [array] : the 3-dimensional array containing the spatial coordinates of the last measure point picked (expressed in scene space absolute value). Optional parameter; | ||
movePickpointbox(left, top) | - | move the 3DHOP point picking output box around the screen; | |
Parameters | left | [number] : point picking box left space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : point picking box top space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
_onEndPickingPoint(point) | - | bind an event handler to be fired when a point picking action ends; | |
Parameters | point | [array] : the 3-dimensional array containing the spatial coordinates of the last point picked (expressed in scene space absolute value); | |
moveSectionsbox(left, top) | - | move the 3DHOP planes section output box around the screen; | |
Parameters | left | [number] : planes section output box left space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : planes section output box top space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
_onEnterInstance(id) | - | bind an event handler to be fired when the mouse enters an instance; | |
Parameters | id | [string] : the instance name specified in the "modelInstance" field of "setScene"; | |
moveToolbar(left, top) | - | move the 3DHOP toolbar around the screen; | |
Parameters | left | [number] : toolbar left space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : toolbar top space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
_onEnterSpot(id) | - | bind an event handler to be fired when the mouse enters a spot; | |
Parameters | id | [string] : the spot name specified in the "spots" field of "setScene"; | |
pickpointSwitch() | - | switch between on/off toolbar related point picking tool button icon; | |
_onLeaveInstance(id) | - | bind an event handler to be fired when the mouse leaves an instance; | |
Parameters | id | [string] : the instance name specified in the "modelInstance" field of "setScene"; | |
resizeCanvas(width, height) | - | change the 3DHOP sizes; | |
Parameters | width | [number] : 3DHOP width value in px (default is full browser). Accepts the CSS width syntax too (enclosed in quotes); | |
height | [number] : 3DHOP height value in px (default is full browser). Accepts the CSS height syntax too (enclosed in quotes); | ||
_onLeaveSpot(id) | - | bind an event handler to be fired when the mouse leaves a spot; | |
Parameters | id | [string] : the spot name specified in the "spots" field of "setScene"; | |
sectiontoolInit() | - | initialize the components in the planes section tool output box; | |
_onPickedInstance(id) | - | bind an event handler to be fired when the mouse clicks an instance; | |
Parameters | id | [string] : the instance name specified in the "modelInstance" field of "setScene"; | |
sectiontoolReset() | - | reset the components in the planes section tool output box; | |
_onPickedSpot(id) | - | bind an event handler to be fired when the mouse clicks a spot; | |
Parameters | id | [string] : the spot name specified in the "spots" field of "setScene"; |
+ 3DHOP object independent utility functions: +
+cameraSwitch() | - | switch between on/off toolbar related camera projection button icon; | |
colorSwitch() | - | switch between on/off toolbar related color mode button icon; | |
fullscreenSwitch() | - | switch between 3DHOP element fullscreen and normal mode, simultaneously updating the toolbar related button icon; | |
hotspotSwitch() | - | switch between on/off toolbar related hotspot button icon; | |
lightSwitch() | - | switch between on/off toolbar related light control button icon. Turning on the light control button icon also turns on the lighting button icon (if present and off); | |
lightingSwitch() | - | switch between on/off toolbar related lighting button icon. Turning off the lighting button icon also turns off the light control button icon (if present and on); | |
measureSwitch() | - | switch between on/off toolbar related measurement tool button icon; | |
- | switch between on/off toolbar related measurement tool button icon. This functionality is DEPRECATED, use "measureSwitch()" instead; | ||
- | move the 3DHOP measure output box around the screen. This functionality is DEPRECATED, use "moveMeasurementbox(left, top)" instead; | ||
Parameters | right | [number] : measure box right space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : measure box top space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
moveMeasurementbox(left, top) | - | move the 3DHOP measure output box around the screen; | |
Parameters | left | [number] : measure box left space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : measure box top space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
movePickpointbox(left, top) | - | move the 3DHOP point picking output box around the screen; | |
Parameters | left | [number] : point picking box left space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : point picking box top space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
moveSectionsbox(left, top) | - | move the 3DHOP planes section output box around the screen; | |
Parameters | left | [number] : planes section output box left space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : planes section output box top space in px (relative to 3DHOP container, due to anchorage default value is related to toolbar position). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
moveToolbar(left, top) | - | move the 3DHOP toolbar around the screen; | |
Parameters | left | [number] : toolbar left space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | |
top | [number] : toolbar top space in px (relative to 3DHOP container, default value is 10). Accepts the CSS positioning syntax too (enclosed in quotes); | ||
pickpointSwitch() | - | switch between on/off toolbar related point picking tool button icon; | |
resizeCanvas(width, height) | - | change the 3DHOP sizes; | |
Parameters | width | [number] : 3DHOP width value in px (default is full browser). Accepts the CSS width syntax too (enclosed in quotes); | |
height | [number] : 3DHOP height value in px (default is full browser). Accepts the CSS height syntax too (enclosed in quotes); | ||
sectiontoolInit() | - | initialize the components in the planes section tool output box; | |
sectiontoolReset() | - | reset the components in the planes section tool output box; | |
sectiontoolSwitch() | - | switch between on/off toolbar related planes section tool button icon; |