Skip to content
Navigation Menu
{{ message }}
forked from trinketapp/vpython-glowscript
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathREADME.html
More file actions
108 lines (77 loc) · 9.58 KB
/
Copy pathREADME.html
File metadata and controls
108 lines (77 loc) · 9.58 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
<!DOCTYPE html>
<html>
<head>
<!-- Using GlowScript locally, based on the work of Vesa Lappalainen vesal@jyu.fi -->
<title>GlowScript Offline</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link type="text/css" href="glowscript_libraries/ide.css" rel="stylesheet" />
</head>
<body>
<div style="font-family:Verdana;font-size:13px">
<h4>OBTAINING THE LATEST VERSION OF GLOWSCRIPT OFFLINE</h4>
<p>Based on the work of Vesa Lappalainen of Finland, this package makes it possible to write and run GlowScript programs even when disconnected from the internet. To obtain the latest version of this package, go to the following location and click Download, then unzip the package to any convenient place on your computer:</p>
<p> <a href="https://github.com/vpython/glowscript/blob/master/GlowScriptOffline2.9.zip">https://github.com/vpython/glowscript/blob/master/GlowScriptOffline2.9.zip</a></p>
<h4>CHOICE OF BROWSER</h4>
<p>It is recommended to use the Chrome browser, as it is the only browser that provides detailed information on run-time errors and also makes it possible to use textures and JavaScript libraries. You can use a different browser if these issues are not important to you.</p>
<h4>RUNNING PROGRAMS</h4>
<p>Inside this folder, doubleclick GlowScript.html. This will start up your preferred browser.</p>
<p>As a test, enter box() into the left (edit) pane.</p>
<p>Click Run to run the program. To rotate, zoom, or pan the scene:<br>
Right button drag or Ctrl-drag to rotate the "camera" to view scene.<br>
To zoom, drag with middle button or Alt/Option depressed, or use scroll wheel.<br>
On a two-button mouse, middle is left + right.<br>
Shift-drag to pan left/right and up/down.<br>
Touch screen: pinch/extend to zoom, swipe or two-finger rotate.</p>
<p>You can drag the vertical gray bar (and/or make the window wider or narrower) to arrange the edit and execution regions the way you want them. Make changes to the program and click Run again. If you add a print statement a print area will appear at the right.</p>
<p>You can run or restart your program by pressing Ctrl-1 or Ctrl-2, just as you can at glowscript.org.</p>
<h4>SAVING YOUR CHANGES</h4>
<p>Click Save to save your program. It will be written to your Download folder (browser security rules forbid writing it anywhere else). You will be asked for a name. Suppose you specify "test". If your program is VPython or RapydScript, the Download folder will have a file named test.py, otherwise it will be test.js (JavaScript). If in one session you do multiple saves, your Download folder will have multiple copies: test.py, test(1).py, etc.</p>
<p>If you create or modify a program without saving it and click Choose File (Browse... on Firefox or Edge), you'll see a warning that you might wish to save your work. Similarly, when you attempt to close the browser or the browser tab, if you have modified the current program you'll be warned about saving the file.
<h4>DEMO PROGRAMS INCLUDED</h4>
<p>Click Choose File and navigate to the GlowScriptOffline folder to choose from programs in the Demos folder. Those demo programs that use textures will not display correctly when offline unless you start the package in a special way <a href="#textures">described below</a> in the section "Using Textures or JavaScript Libraries."</p>
<h4>DOCUMENTATION INCLUDED</h4>
<p>The GlowScript documentation is included in the package and is accessible by clicking Help.</p>
<h4>USING THE TEXT EDITOR</h4>
<p>In the text editor, as in the editor at glowscript.org, select one or more lines and press TAB to indent or Shift-TAB to unindent; press Ctrl-/ to toggle commenting of the lines. Pressing TAB with the cursor at the end of the line adds spaces to the end of that line. At the moment, find and replace options are not yet available; you can of course copy the program to a local text editor to use find and replace, then copy it back.</p>
<h4>USING PROGRAMS FROM glowscript.org OR FROM VPYTHON 7</h4>
<p>When you download programs from glowscript.org, they are in the form of .py files whose first line is a statement about importing vpython, like programs created with VPython 7. This first line is understood by the offline package, as is "GlowScript X.Y VPython" or "GlowScript X.Y JavaScript".</p>
<h4>EXPORTING A PROGRAM</h4>
<p>When you click the "Export" button, your program is processed to create code that can be embedded in your own web site, just like using the option "Share or export this program" at glowscript.org. This processed code temporarily replaces your own program code. If you click Save and give the name "test", a file named test.html will be written to your Download folder. Alternatively, press Ctrl-C to copy the code (all of which is preselected for you), then use a text editor to save this code to a local file that should have the extension ".html".</p>
<p>When you are connected to the internet, doubleclicking this html file will start up your default browser and run the program. You can return to editing your orginal program by clicking the "Restore" button. (Notice that there is no need to be able to run the exported html file when disconnected from the internet, because you can run the original program in the offline package.)</p>
<h4>POSSIBLE SLOWDOWN</h4>
<p>If you make a large number of runs, performance may degrade due to an accumulation of "WebGL contexts". However, there is a simple remedy: reload the web page.</p>
<h4>IMPORT ISSUES, AND USING JAVASCRIPT</h4>
<p>By default, if you don't start a program with a statement of the form "GlowScript 2.7 JavaScript" or "GlowScript 2.7 RapydScript", it is assumed that this is a VPython program. You can also start a program with one of these kinds of Python import statements (or include such an import statement after "GlowScript 2.7 VPython"):</p>
<p> from vpython import * # The default; all VPython elements are available<br>
from vpython import canvas, box, sphere, vec # This MUST include canvas<br>
import vpython # A red box: vpython.box(color=vpython.color.red)<br>
import vpython as vp # A red box: vp.box(color=vp.color.red)</p>
<p>If you don't include a GlowScript or import statement, this is the same as specifying "from vpython import *".</p>
<h4><a name="textures"></a>USING TEXTURES OR JAVASCRIPT LIBRARIES</h4>
<p>If you don't use textures or JavaScript libraries (using the get_library function), the instructions given above are adequate. If you do however use textures or JavaScript libraries, you need to follow these instructions:</p>
<p>For highly technical security reasons (CORS, Cross-Origin Resource Sharing), it is not possible to use textures or JavaScript libraries when offline unless you use the Chrome browser and configure Chrome in a special way.</p>
<div style="font-family:Verdana;font-size:13px;color:#c00"><b>First, exit Chrome.</b> Then,</div>
<p> Windows: Doubleclick Windows_launch_chrome.bat in the GlowScriptOffline folder.<br>
<br>
Mac: Doubleclick Mac_launch_chrome.command in the GlowScriptOffline folder.<br>
You may have to go to System Preferences/Security & Privacy and under the<br>
General tab specify that you want to allow it to execute now and in the future.<br>
(You may have to open the folder in a terminal and execute "chmod +x Mac_launch.command".)<br>
You only need to execute the chmod instruction once,<br>
before using Mac_launch_chrome.command for the first time.<br>
<br>
Linux: Open a terminal in the GlowScriptOffline folder.<br>
Execute "chmod +x Linux_launch_chrome"<br>
Execute "./Linux_launch_chrome".<br>
You only need to execute the chmod instruction once,<br>
before using Linux_launch_chrome for the first time.</p>
<p>You will see the warning, "You are using an unsupported command-line flag: --disable-web-security. Stability and security will suffer."</p>
<p> On Mac or Linux, without exiting Chrome, doubleclick GlowScript.html.</p>
<p>If you quit and restart Chrome, its normal security rules will be restored.</p>
<div style="font-family:Verdana;font-size:13px;color:#c00"><b>It is important to exit this unsafe version of Chrome before using it for regular browsing.</b></div>
<p>Suppose you have an image named car.jpg that you want to use as a texture. Create a folder adjacent to the GlowScriptOffLine folder and place car.jpg in it. Suppose you name the new folder Mystuff. To use the texture, in your program say texture="../Mystuff/car.jpg".</p>
<p>To use a library written in JavaScript, place it in your Mystuff folder. Suppose the library is named useful.js. To use it, in your program execute the statement get_library("../Mystuff/useful.js").</p>
<p>The reason for putting the Mystuff folder outside but next to the GlowScriptOnline folder is that whenever you update to a later version of the online package you don't want to lose your Mystuff files.</p>
</div>
</body>
</html>
You can’t perform that action at this time.