Back to Logisim Evolution

Command-line options

src/main/resources/doc/en/html/guide/prefs/pref-cmdline.html

4.1.03.0 KB
Original Source

Command-line options

You can configure many of Logisim's application preferences via command line options. This can be particularly useful in a laboratory of single-student computers where you want Logisim to start up the same for students every time, regardless of how previous students may have configured the program.

The overall command-line syntax is as follows.

java -jar_ **jarFileName** __[options]__[filenames]_

The optional additional files named on the command line will be opened as separate windows within Logisim.

The following example starts Logisim in its basic configuration.

java -jar_ **jarFileName**  **-plain -gates shaped -locale en** _

Supported options include the following.

-plain-empty-template templateFile

Configures the template for Logisim to use.

-gates [shaped | rectangular]

Configures which type of gate to use.

-locale _ localeIdentifier _

Configures which translation to use. As of this writing, the supported locales include:

| de German | | el Greek | | en English | | es Spanish | | fr French | | pt Portugais | | ru Russian | | it Italian | | nl Dutch | | jp Japanese |

-accents [yes | no]

This is only relevant for languages that use characters outside the 7-bit ASCII character set; this would include languages using accented characters, and it would not include English. If no, characters outside the 7-bit ASCII character set are replaced with equivalents appropriate to the language; this would be useful for Java/OS combinations where such characters are not supported well.

-clearprops

Clear all application preferences at startup, so Logisim will act as if it were being executed on the host system for the first time.

-nosplash

Hides the initial Logisim splash screen.

-help

Displays a summary of the command line options.

-version

Displays the Logisim version number.

-analyze

Displays the combinatorial analysis menus.

-load _ filename _

Load an image in RAM (works only with -tty)

-sub _ file1 file2 _

load the file by replacing the library file (file1) with the library file (file2). More information in Substituting libraries

-tty [table | speed | tty | halt | stats]

Run without GUI. More information in Other verification

-testvector _ circuitname vectorfile projectfile _

Run the circuitname tests in projectfile based on vectors in vectorfile. More information in Window Text Vector

-geom _ WxH | WxH+X+Y _

Opens Logisim with a window dimensioned according to the parameters W (width) and H (height) or with the upper left corner positioned according to the parameters X,Y.
Example: -geom 600x400+100+100

Undocumented Options

-test-circuit testCircuitPathInput -test-fpga-implementation inputpath Circuitimapfile cicuitimpname cicuitimpboard -test-circ-gen testCircPathInput testCircPathOutput -questa_[yes | no]_

Next: User's Guide.