Launch a script

Table of Contents

• Using the GO2cam Javascript Editor
• Command line
• Using several .js at the same time
• API Limitations

Using the GO2cam Javascript Editor

GO2cam is able to execute scripts written in JavaScript langage and stored in **.js** files. JavaScript files can be written out of GO2cam or by using the embedded JavaScript editor.

1. In GO2cam menu click Tools > JavaScript Editor to open the JavaScript editor
2. In the JavaScript editor menu
   • click File > Open to open a .js file
   • click Run to execute the script

‍It it also possible to drag 'n drop a .js file in GO2cam window. The file will be open in the JavaScript editor

[1] Run button to launch the script
[2] Editing area where the script is written
[3] Output area. This area displays error messages when errors occur while executing a script. It can also be used to display information using console.log command

Command line

Launching a script using GO2cam in command line is possible with the token -js 'path_to_my_script.js' It is mandatory to use it combined with token -y 'product_name' to indicate the appropriate product (milling, turning...etc.). The list of GO2cam products is available by running GO2cam in command line with the token -h. Optionaly, it is possible to use the token -blackbox to hide GO2cam graphic interface while the script is running.

Example to run a script for milling

go2cam.exe -js 'd:\myscript.js' -y 'milling'

Example to run a script for turning keeping GO2cam invisible

go2cam.exe -js "d:\monscript.js" -y “turning” -blackbox

Since version 6.11.203 of GO2cam, it is possible to give arguments to the script using - - token. Arguments can be retrieved in script file with variable args. Let's assume that test_args.js contains the following code

if(args.length>0)
{
    let str = 'input arguments: '
    args.forEach( a => str+= a + ', ' )
    GO2SDialogUtil.CreateMessageBox(str)
}

The execution of the following command line will display a message box displaying input arguments

go2cam.exe -y milling -js 'd:\test_args.js' --12 --args2

Using several .js at the same time

Complex scripts can be divided to several .js files. File contents can be imported into a main .js file using GO2SUtil.ImportJS function Get toolbox.js file here: toolbox.js to run the following script.

//import utility functions defined in another file
GO2SUtil.ImportJS('toolbox.js')
 
var p1 = new GO2SXYZ(10,10,0)
var p2 = new GO2SXYZ(10,100,0)
var obl = new GO2SOblong(p1,p2,20)
DiscretizePts(obl) // defined in toolbox.js

When a class is defined in another js file and imported with GO2SUtil.ImportJS, it is mandatory to make it visible globaly through this object using this line after the class definition.

this.MyClass = MyClass;

For exemple, a class Person defined in another js file:

class Person {
  constructor(name, age) {
    this.name = name;
    this.age = age;
  }
 
  greet() {
    console.log(`Hello, my name is ${this.name} and I am ${this.age} years old.`);
  }
}
 
// this line ensures to make the class visible in another js file when being imported
this.Person = Person;

API Limitations

It is not possible to import external libraries