Difference between revisions of "Reference:Command Line Arguments"

From GeoGebra Manual
Jump to: navigation, search
(typo: windows -> Windows)
m
(28 intermediate revisions by 6 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 (to ensure enough memory is allocated: don't double-click)
 
When using *.jar files directly (to ensure enough memory is allocated: don't double-click)
  
<code>java '''-Xmx512m''' -jar geogebra.jar java [OPTION] [FILE]</code>
+
<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>
 +
 
  
 
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 30: Line 52:
 
| 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
 
|-
 
|<code>--showGrid=BOOLEAN</code>
 
 
|show/hide coordinate grid
 
|show/hide coordinate grid
 
|-
 
|-
|<code>--showSplash=BOOLEAN</code>
+
|<code>--settingsFile=FILENAME</code>
|show splash screen on startup
+
|load/save settings from/in a local file (used by the portable version)
|-
 
|<code>--settingsFile=BOOLEAN</code>
 
|load/save settings from/in a local file
 
 
|-
 
|-
 
|<code>--resetSettings</code>
 
|<code>--resetSettings</code>
 
|resets settings to defaults
 
|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>--loop=[true|false]></code>
 +
| whether the animated GIF should repeat (only used in conjunction with <code>--exportAnimation</code>)
 +
|-
 +
|<code>--delay=<Integer></code>
 +
| delay in ms between frames for the animated GIF (only used in conjunction with <code>--exportAnimation</code>)
 +
|-
 +
|<code>--laf=<system|crossplatform></code>
 +
|Change the "Look and Feel" of the GUI
 
|-
 
|-
 
|<code>--versionCheckAllow</code>
 
|<code>--versionCheckAllow</code>
|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), and value "false" if, on the computer, no check for new version is allowed.
+
|<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]]
Please note that this list may be incomplete since the "developers only" options are not intended for all users. To obtain the full list, please simply enter the <code>--help</code> option on command line.
 
 
 
[[fr:Référence:Ligne_Commande]]
 
[[es:Referencia:Argumentos_de_Línea_de_Comandos]]
 
[[it:Riferimenti:Argomenti della riga di comando]]
 

Revision as of 13: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