build 7.4.0

Author: linev

build/jsroot.js

@@ -11,7 +11,7 @@ let version_id = '7.4.0';
 
 /** @summary version date
   * @desc Release date in format day/month/year like '14/04/2022' */
-let version_date = '14/06/2023';
+let version_date = '15/06/2023';
 
 /** @summary version id and date
   * @desc Produced by concatenation of {@link version_id} and {@link version_date}
@@ -741,7 +741,13 @@ function parseMulti(json) {
   * Or one can again parse json with {@link parse} function
   * @param {object} obj - JavaScript object to convert
   * @param {number} [spacing] - optional line spacing in JSON
-  * @return {string} produced JSON code */
+  * @return {string} produced JSON code
+  * @example
+  * import { openFile, draw, toJSON } from 'https://root.cern/js/latest/modules/main.mjs';
+  * let file = await openFile('https://root.cern/js/files/hsimple.root');
+  * let obj = await file.readObject('hpxpy;1');
+  * obj.fTitle = 'New histogram title';
+  * let json = toJSON(obj); */
 function toJSON(obj, spacing) {
    if (!isObject(obj)) return '';
 
@@ -1024,7 +1030,7 @@ const prROOT = 'ROOT.', clTObject = 'TObject', clTNamed = 'TNamed', clTString =
   * @desc Supported classes: `TObject`, `TNamed`, `TList`, `TAxis`, `TLine`, `TText`, `TLatex`, `TPad`, `TCanvas`
   * @param {string} typename - ROOT class name
   * @example
-  * import { create } from 'path_to_jsroot/modules/core.mjs';
+  * import { create } from 'https://root.cern/js/latest/modules/core.mjs';
   * let obj = create('TNamed');
   * obj.fName = 'name';
   * obj.fTitle = 'title'; */
@@ -8516,7 +8522,8 @@ function makeTranslate(x,y) {
    return null;
 }
 
-/** @summary Configure special style used for highlight or dragging elements */
+/** @summary Configure special style used for highlight or dragging elements
+  * @private */
 function addHighlightStyle(elem, drag) {
    if (drag)
       elem.style('stroke', 'steelblue')
@@ -65324,7 +65331,7 @@ class StandaloneMenu extends JSRootMenu {
   * @param {object} [handler] - object with handling function, in this case one not need to bind function
   * @param {string} [menuname] - optional menu name
   * @example
-  * import { createMenu } from 'path_to_jsroot/modules/gui/menu.mjs';
+  * import { createMenu } from 'https://root.cern/js/latest/modules/gui/menu.mjs';
   * let menu = await createMenu());
   * menu.add('First', () => console.log('Click first'));
   * let flag = true;
@@ -87482,7 +87489,7 @@ class TGeoPainter extends ObjectPainter {
          exact = false;
       }
 
-      this.findNodeWithVolume(regexp, function(arg) {
+      this.findNodeWithVolume(regexp, arg => {
          setInvisibleAll(arg.node.fVolume, (sign !== '+'));
          return exact ? arg : null; // continue search if not exact expression provided
       });
@@ -87918,11 +87925,10 @@ class TGeoPainter extends ObjectPainter {
                   mesh.getMatrixAt(i, item.matrix0);
                   item.minvert.copy(item.matrix0).invert();
 
-                  let box3 = new Box3().copy(mesh.geometry.boundingBox).applyMatrix4(item.matrix0),
-                      signz = 1; //mesh._flippedMesh ? -1 : 1;
+                  let box3 = new Box3().copy(mesh.geometry.boundingBox).applyMatrix4(item.matrix0);
 
-                  item.vect0 = new Vector3((box3.max.x + box3.min.x) / 2, (box3.max.y + box3.min.y) / 2, signz * (box3.max.z + box3.min.z) / 2);// .applyMatrix4(item.matrix0);
-                  item.vect1 = new Vector3(0,0,0).applyMatrix4(item.minvert);
+                  item.vect0 = new Vector3((box3.max.x + box3.min.x) / 2, (box3.max.y + box3.min.y) / 2, (box3.max.z + box3.min.z) / 2);
+                  item.vect1 = new Vector3(0, 0, 0).applyMatrix4(item.minvert);
                }
             }
 
@@ -88395,14 +88401,14 @@ class TGeoPainter extends ObjectPainter {
                let wireframe = this.accessObjectWireFrame(obj);
 
                if (wireframe !== undefined)
-                  menu.addchk(wireframe, 'Wireframe', n, function(indx) {
+                  menu.addchk(wireframe, 'Wireframe', n, indx => {
                      let m = intersects[indx].object.material;
                      m.wireframe = !m.wireframe;
                      this.render3D();
-                  });
+                  }, 'Toggle wireframe mode for the node');
 
                if (cnt > 1)
-                  menu.add('Manifest', n, function(indx) {
+                  menu.add('Manifest', n, indx => {
 
                      if (this._last_manifest)
                         this._last_manifest.wireframe = !this._last_manifest.wireframe;
@@ -88422,15 +88428,15 @@ class TGeoPainter extends ObjectPainter {
                      this._last_manifest.wireframe = !this._last_manifest.wireframe;
 
                      this.render3D();
-                  });
+                  }, 'Manifest selected node');
 
 
-               menu.add('Focus', n, function(indx) {
+               menu.add('Focus', n, indx => {
                   this.focusCamera(intersects[indx].object);
                });
 
                if (!this._geom_viewer) {
-                  menu.add('Hide', n, function(indx) {
+                  menu.add('Hide', n, indx => {
                      let resolve = this._clones.resolveStack(intersects[indx].object.stack);
                      if (resolve.obj && (resolve.node.kind === kindGeo) && resolve.obj.fVolume) {
                         setGeoBit(resolve.obj.fVolume, geoBITS.kVisThis, false);
@@ -96476,7 +96482,7 @@ class TProxyFile extends TFile {
   * @return {object} - Promise with {@link TFile} instance when file is opened
   * @example
   *
-  * import { openFile } from '/path_to_jsroot/modules/io.mjs';
+  * import { openFile } from 'https://root.cern/js/latest/modules/io.mjs';
   * let f = await openFile('https://root.cern/js/files/hsimple.root');
   * console.log(`Open file ${f.getFileName()}`); */
 function openFile(arg) {
@@ -99578,7 +99584,11 @@ function getDrawSettings(kind, selector) {
    return res;
 }
 
-/** @summary Set default draw option for provided class */
+/** @summary Set default draw option for provided class
+  * @example
+  import { setDefaultDrawOpt } from 'https://root.cern/js/latest/modules/draw.mjs';
+  setDefaultDrawOpt('TH1', 'text');
+  setDefaultDrawOpt('TH2', 'col');  */
 function setDefaultDrawOpt(classname, opt) {
    let handle = getDrawHandle(prROOT + classname, 0);
    if (handle)
@@ -99712,7 +99722,18 @@ async function draw(dom, obj, opt) {
   * @return {Promise} with painter object
   * @desc If drawing was not done before, it will be performed with {@link draw}.
   * Otherwise drawing content will be updated
-  * @public */
+  * @public
+  * @example
+  * import { openFile } from 'https://root.cern/js/latest/modules/io.mjs';
+  * import { draw, redraw } from 'https://root.cern/js/latest/modules/draw.mjs';
+  * let file = await openFile('https://root.cern/js/files/hsimple.root');
+  * let obj = await file.readObject('hpxpy;1');
+  * await draw('drawing', obj, 'colz');
+  * let cnt = 0;
+  * setInterval(() => {
+  *    obj.fTitle = `Next iteration ${cnt++}`;
+  *    redraw('drawing', obj, 'colz');
+  * }, 1000); */
 async function redraw(dom, obj, opt) {
 
    if (!isObject(obj))
@@ -99821,8 +99842,8 @@ function addStreamerInfosForPainter(lst) {
   * import { openFile, makeImage } from 'jsroot';
   * let file = await openFile('https://root.cern/js/files/hsimple.root');
   * let object = await file.readObject('hpxpy;1');
-  * let png64 = await makeImage({ format: 'png', object, option: 'lego2,pal67', width: 1200, height: 800 });
-  * let pngbuf = await makeImage({ format: 'png', as_buffer: true, object, option: 'lego2,pal67', width: 1200, height: 800 }); */
+  * let png64 = await makeImage({ format: 'png', object, option: 'colz', width: 1200, height: 800 });
+  * let pngbuf = await makeImage({ format: 'png', as_buffer: true, object, option: 'colz', width: 1200, height: 800 }); */
 async function makeImage(args) {
    if (!args) args = {};
 
@@ -103859,7 +103880,7 @@ function readStyleFromURL(url) {
   * @param {String} gui_kind - either 'online', 'nobrowser', 'draw'
   * @return {Promise} with {@link HierarchyPainter} instance
   * @example
-  * import { buildGUI } from '/path_to_jsroot/modules/gui.mjs';
+  * import { buildGUI } from 'https://root.cern/js/latest/modules/gui.mjs';
   * buildGUI('guiDiv'); */
 async function buildGUI(gui_element, gui_kind = '') {
    let myDiv = select(isStr(gui_element) ? `#${gui_element}` : gui_element);