Difference between revisions of "Reference:Command Line Arguments"

From GeoGebra Manual
Jump to: navigation, search
m
(40 intermediate revisions by 8 users not shown)
Line 1: Line 1:
In order to start GeoGebra from the command line you have to either install GeoGebra using the [http://www.geogebra.org/cms/installers offline installers] or make sure you have all the *.jar files in one directory. You can download them here:
+
In order to start GeoGebra from the command line you have to first install '''GeoGebra Classic 5''' using the [http://www.geogebra.org/download offline installers]  
http://www.geogebra.org/webstart/unpacked/
+
 
 +
If you want to use OpenJDK (rather than the included version) then this is the only one that works out of the box with GeoGebra: https://www.azul.com/downloads/zulu-community/ (download Java 8, JRE + JFX)
  
 
==Usage==
 
==Usage==
When using *.jar files directly
+
When using *.jar files directly (to ensure enough memory is allocated: don't double-click)
 +
 
 +
<code>.\jre\bin\java '''-Xms32m -Xmx1024m''' -Dsun.jnu.encoding=UTF-8 -jar geogebra.jar [OPTIONS] [FILES]</code>
 +
 
 +
or you can try this to disable hardware graphics acceleration if you get glitches
 +
 
 +
<code>.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 '''-Dsun.java2d.d3d=false''' -jar geogebra.jar [OPTIONS] [FILES]</code>
 +
 
 +
 
 +
 
 +
For example to show Help:
 +
 
 +
<code>.\jre\bin\java -jar geogebra.jar --help</code>
 +
 
 +
To load a file:
 +
 
 +
<code>.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 -jar geogebra.jar myfile.ggb</code>
 +
 
 +
To start GeoGebra in a different language:
 +
 
 +
<code>.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 -jar geogebra.jar --language=de_AT</code>
  
<code>java -jar geogebra.jar [OPTION] [FILE]</code>
 
  
 
Usage on Windows (if installed via off-line installer)
 
Usage on Windows (if installed via off-line installer)
  
<code>C:/Program Files/Geogebra/geogebra.exe [OPTION] [FILE]</code>
+
<code>geogebra.exe [OPTIONS] [FILES]</code>
  
 
Usage on Linux (if installed via deb or rpm packages)
 
Usage on Linux (if installed via deb or rpm packages)
  
<code>geogebra [OPTION] [FILE]</code>
+
<code>geogebra [OPTIONS] [FILES]</code>
  
Starts GeoGebra with the specified OPTIONs and opens the given FILE.
+
Starts GeoGebra with the specified OPTIONS and opens the given FILES.
  
 
==Options==
 
==Options==
 +
 +
Please note that there may be other options available which are not listed here. For a full list use the <code>--help</code> option.
 +
 
{|  
 
{|  
 
|-
 
|-
Line 24: Line 47:
 
|-
 
|-
 
|<code>--v</code>
 
|<code>--v</code>
| print version information, e.g. ''GeoGebra 3.9.294.0 21 July 2011 Java 1.6.0_26''
+
| print version information, e.g. ''GeoGebra 4.0.0.0 20 August 2011 Java 1.6.0_26''
 
|-
 
|-
 
|<code>--language=ISO_CODE</code>
 
|<code>--language=ISO_CODE</code>
 
| set language using [[w:List_of_ISO_639-1_codes|locale code]], e.g. en, de_AT
 
| set language using [[w:List_of_ISO_639-1_codes|locale code]], e.g. en, de_AT
 
|-
 
|-
|<code>--antiAliasing=BOOLEAN</code>
+
|<code>--showAlgebraInput=[true|false]</code>
|turn antialiasing on (true) or off (false)
+
|show/hide algebra [[Input Bar]]
 +
|-
 +
|<code>--showAlgebraInputTop=[true|false]</code>
 +
|Show algebra input field at top/bottom
 
|-
 
|-
|<code>--showAlgebraWindow=BOOLEAN</code>
+
|<code>--showAlgebraWindow=[true|false]</code>
 
|show/hide [[Algebra View]]
 
|show/hide [[Algebra View]]
 
|-
 
|-
|<code>--showSpreadsheet=BOOLEAN</code>
+
|<code>--showSpreadsheet=[true|false]</code>
 
|show/hide [[Spreadsheet View]]
 
|show/hide [[Spreadsheet View]]
 
|-
 
|-
|<code>--showCAS=BOOLEAN</code>
+
|<code>--showCAS=[true|false]</code>
 
|show/hide [[CAS View]]
 
|show/hide [[CAS View]]
 
|-
 
|-
|<code>--showAlgebraInput=BOOLEAN</code>
+
|<code>--showSplash=[true|false]</code>
|show/hide algebra [[Input Bar]]
+
|show splash screen on startup
 +
|-
 +
|<code>--enableUndo=[true|false]</code>
 +
|enable/disable Undo
 +
|-
 +
|<code>--fontSize=[number]</code>
 +
|set default font size
 
|-
 
|-
|<code>--showAxes=BOOLEAN</code>
+
|<code>--showAxes=[true|false]</code>
 
|show/hide coordinate axes
 
|show/hide coordinate axes
 
|-
 
|-
|<code>--enableUndo=BOOLEAN</code>
+
|<code>--showGrid=[true|false]</code>
|enable/disable Undo
+
|show/hide coordinate grid
 +
|-
 +
|<code>--settingsFile=FILENAME</code>
 +
|load/save settings from/in a local file (used by the portable version)
 +
|-
 +
|<code>--resetSettings</code>
 +
|resets settings to defaults
 +
|-
 +
|<code>--antiAliasing=[true|false]</code>
 +
|turn antialiasing on (true) or off (false)
 +
|-
 +
|<code>--export=<File></code>
 +
|Exports the Graphics View to SVG/PNG/PDF/EMF/EPS as determined by the extension<br><b>You can specify the resolution with <code>--dpi</code></b>
 +
|-
 +
|<code>--exportAnimation=<File></code>
 +
|Exports the Graphics View to mutiple SVG/PNG/PDF/EMF/EPS files (or one animated GIF) as determined by the extension and specified slider<br><b>You must specify the slider with <code>--slider</code> and you can specify the resolution with <code>--dpi</code></b>
 +
|-
 +
|<code>--dpi=<Integer></code>
 +
| dots per inch, eg 300 (only used in conjunction with <code>--export</code>)
 
|-
 
|-
|<code>--showGrid=BOOLEAN</code>
+
|<code>--loop=[true|false]></code>
|show/hide coordinate grid
+
| whether the animated GIF should repeat (only used in conjunction with <code>--exportAnimation</code>)
 
|-
 
|-
|<code>--showSplash=BOOLEAN</code>
+
|<code>--delay=<Integer></code>
|show splash screen on startup
+
| delay in ms between frames for the animated GIF (only used in conjunction with <code>--exportAnimation</code>)
 
|-
 
|-
|<code>--settingsFile=BOOLEAN</code>
+
|<code>--laf=<system|crossplatform></code>
|Load/save settings from/in a local file
+
|Change the "Look and Feel" of the GUI
 
|-
 
|-
|<code>--CAS=STRING</code>
+
|<code>--versionCheckAllow</code>
|Switches CAS used by GeoGebra. Currently the only supported CAS is MPREDUCE. Support for MAXIMA is experimental and currently abandoned. See [http://www.geogebra.org/trac/wiki/GeoGebraCAS our developers' wiki] for details.
+
|<div style="max-width:40em">allow version check (on/off or true/false for single launch). Note: if this option is not used, then it will check for new version, unless system preferences are set to disable it. This preference has to be created on "geogebra" key, with name "version_check_allow" (e.g. HKEY_LOCAL_MACHINE/Software/JavaSoft/Prefs/geogebra/version_check_allow in Windows registry ; edit the file /Library/Preferences/com.apple.java.util.prefs.plist in mac osx and add string key "version_check_allow" in Root > / > geogebra/), and value "false" if, on the computer, no check for new version is allowed.</div>
 
|}
 
|}
 +
[[Category:Reference|Command Line Arguments]]

Revision as of 14:40, 26 May 2020

In order to start GeoGebra from the command line you have to first install GeoGebra Classic 5 using the offline installers

If you want to use OpenJDK (rather than the included version) then this is the only one that works out of the box with GeoGebra: https://www.azul.com/downloads/zulu-community/ (download Java 8, JRE + JFX)

Usage

When using *.jar files directly (to ensure enough memory is allocated: don't double-click)

.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 -jar geogebra.jar [OPTIONS] [FILES]

or you can try this to disable hardware graphics acceleration if you get glitches

.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 -Dsun.java2d.d3d=false -jar geogebra.jar [OPTIONS] [FILES]


For example to show Help:

.\jre\bin\java -jar geogebra.jar --help

To load a file:

.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 -jar geogebra.jar myfile.ggb

To start GeoGebra in a different language:

.\jre\bin\java -Xms32m -Xmx1024m -Dsun.jnu.encoding=UTF-8 -jar geogebra.jar --language=de_AT


Usage on Windows (if installed via off-line installer)

geogebra.exe [OPTIONS] [FILES]

Usage on Linux (if installed via deb or rpm packages)

geogebra [OPTIONS] [FILES]

Starts GeoGebra with the specified OPTIONS and opens the given FILES.

Options

Please note that there may be other options available which are not listed here. For a full list use the --help option.

--help print help message
--v print version information, e.g. GeoGebra 4.0.0.0 20 August 2011 Java 1.6.0_26
--language=ISO_CODE set language using locale code, e.g. en, de_AT
--showAlgebraInput=[true|false] show/hide algebra Input Bar
--showAlgebraInputTop=[true|false] Show algebra input field at top/bottom
--showAlgebraWindow=[true|false] show/hide Algebra View
--showSpreadsheet=[true|false] show/hide Spreadsheet View
--showCAS=[true|false] show/hide CAS View
--showSplash=[true|false] show splash screen on startup
--enableUndo=[true|false] enable/disable Undo
--fontSize=[number] set default font size
--showAxes=[true|false] show/hide coordinate axes
--showGrid=[true|false] show/hide coordinate grid
--settingsFile=FILENAME load/save settings from/in a local file (used by the portable version)
--resetSettings resets settings to defaults
--antiAliasing=[true|false] turn antialiasing on (true) or off (false)
--export=<File> Exports the Graphics View to SVG/PNG/PDF/EMF/EPS as determined by the extension
You can specify the resolution with --dpi
--exportAnimation=<File> Exports the Graphics View to mutiple SVG/PNG/PDF/EMF/EPS files (or one animated GIF) as determined by the extension and specified slider
You must specify the slider with --slider and you can specify the resolution with --dpi
--dpi=<Integer> dots per inch, eg 300 (only used in conjunction with --export)
--loop=[true|false]> whether the animated GIF should repeat (only used in conjunction with --exportAnimation)
--delay=<Integer> delay in ms between frames for the animated GIF (only used in conjunction with --exportAnimation)
--laf=<system|crossplatform> Change the "Look and Feel" of the GUI
--versionCheckAllow
allow version check (on/off or true/false for single launch). Note: if this option is not used, then it will check for new version, unless system preferences are set to disable it. This preference has to be created on "geogebra" key, with name "version_check_allow" (e.g. HKEY_LOCAL_MACHINE/Software/JavaSoft/Prefs/geogebra/version_check_allow in Windows registry ; edit the file /Library/Preferences/com.apple.java.util.prefs.plist in mac osx and add string key "version_check_allow" in Root > / > geogebra/), and value "false" if, on the computer, no check for new version is allowed.
© 2024 International GeoGebra Institute