cmdline.html 2.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. <html>
  2. <head>
  3. <title>Command-line options</title>
  4. </head>
  5. <body bgcolor="FFFFFF">
  6. <h1>Command-line options</h1>
  7. <p>You can configure many of Logisim's application preferences via command
  8. line options. This can be particularly useful in a laboratory of
  9. single-student computers where you want Logisim to start up the same
  10. for students every time, regardless of how previous students may have
  11. configured the program.</p>
  12. <p>The overall command-line syntax is as follows.</p>
  13. <blockquote><pre>
  14. java -jar <em><b>jarFileName</b></em> <em>[options]</em> <em>[filenames]</em>
  15. </pre></blockquote>
  16. <p>The optional additional files named on the command line will be
  17. opened as separate windows within Logisim.</p>
  18. <p>The following example starts Logisim in its basic configuration.
  19. <blockquote><pre>
  20. java -jar <em><b>jarFileName</b></em> -plain -gates shaped -locale en
  21. </pre></blockquote></p>
  22. <p>Supported options include the following.
  23. <dl>
  24. <dt><tt>-plain</tt></dt>
  25. <dt><tt>-empty</tt></dt>
  26. <dt><tt>-template <b><em>templateFile</em></b></tt></dt>
  27. <dd><p>Configures the template for Logisim to use.</p></dd>
  28. <dt><tt>-gates <em>[<b>shaped</b>|<b>rectangular</b>]</em></tt></dt>
  29. <dd><p>Configures which type of gate to use.</p></dd>
  30. <dt><tt>-locale <em><b>localeIdentifier</b></em></tt></dt>
  31. <dd><p>Configures which translation to use. As of this writing, the
  32. supported locales include:</p>
  33. <center><table>
  34. <tr><th><tt>de</tt></th><td>German</td></tr>
  35. <tr><th><tt>en</tt></th><td>English</td></tr>
  36. <tr><th><tt>es</tt></th><td>Spanish</td></tr>
  37. <tr><th><tt>ru</tt></th><td>Russian</td></tr>
  38. <tr><th><tt>el</tt></th><td>Greek</td></tr>
  39. </table></center></dd>
  40. <dt><tt>-accents <em>[<b>yes</b>|<b>no</b>]</em></tt></dt>
  41. <dd><p>This is only relevant for languages that use characters
  42. outside the 7-bit ASCII character set; this would include
  43. languages using accented characters, and it would not
  44. include English.
  45. If <em>no</em>, characters outside the 7-bit ASCII character
  46. set are replaced with equivalents appropriate to the language;
  47. this would be useful for Java/OS combinations where such characters
  48. are not supported well.</p></dd>
  49. <dt><tt>-clearprops</tt></dt>
  50. <dd><p>Clear all application preferences at startup, so Logisim will act as
  51. if it were being executed on the host system for the first time.</p></dd>
  52. <dt><tt>-nosplash</tt></dt>
  53. <dd><p>Hides the initial Logisim splash screen.</p></dd>
  54. <dt><tt>-help</tt></dt>
  55. <dd><p>Displays a summary of the command line options.</p></dd>
  56. <dt><tt>-version</tt></dt>
  57. <dd><p>Displays the Logisim version number.</p></dd>
  58. </dl></p>
  59. <p><strong>Next:</strong> <em><a href="../index.html">User's Guide</a></em>.</p>
  60. </body>
  61. </html>