home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 5 / RISCWORLD_VOL5.iso / SOFTWARE / Issue6 / VICE / VICE.ZIP / doc / vice_6 < prev    next >
Encoding:
Text File  |  2005-01-25  |  51.6 KB  |  1,898 lines
  1. <HTML>
  2. <HEAD>
  3. <!-- This HTML file has been created by texi2html 1.52
  4.      from ../vice.texi on 23 January 2005 -->
  5.  
  6. <TITLE>VICE Manual - 6  Settings and resources</TITLE>
  7. </HEAD>
  8. <BODY>
  9. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_5.html">previous</A>, <A HREF="vice_7.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  10. <P><HR><P>
  11.  
  12.  
  13. <H1><A NAME="SEC39" HREF="vice_toc.html#TOC39">6  Settings and resources</A></H1>
  14.  
  15. <P>
  16. In the VICE emulators, all the settings are stored in entities known as
  17. called <EM>resources</EM>.  Each resource has a name and a value which may
  18. be either an integer or a string.  Integer values are often used as
  19. boolean values with the usual convention of using zero for "false"
  20. and any other value for "true".
  21.  
  22. </P>
  23. <P>
  24. Resource values can be changed via the right-button menu (the
  25. <EM>settings</EM> menu), via command-line options or via the <EM>resource
  26. file</EM>.
  27.  
  28. </P>
  29. <P>
  30. The <EM>resource file</EM> is a human-readable file containing resource
  31. values: it is called <TT>`vicerc'</TT> and is stored in the directory 
  32. <TT>`.vice/'</TT> in the user's home
  33. directory.  It is possible to dump the current values of the resources
  34. into that file or load the values stored into that file as the current
  35. values, at any time.  This is achieved with the "Save settings" and
  36. "Load settings" right menu items.  A third menu item, "Restore
  37. Default Settings", can be used to reset all the values to the factory
  38. defaults.
  39.  
  40. </P>
  41. <P>
  42. A special resource, <CODE>SaveResourcesOnExit</CODE>, if set to a non zero
  43. value, causes the emulator to ask you if you want to save the current
  44. (changed) settings before exiting, and can be toggled with the "Save
  45. settings on exit" command from the right-button menu.
  46.  
  47. </P>
  48. <P>
  49. Notice that not all the resources can be changed from the menus; some of
  50. them can only be changed by manually modifying the resource file or by
  51. using command-line options.
  52.  
  53. </P>
  54.  
  55.  
  56.  
  57. <H2><A NAME="SEC40" HREF="vice_toc.html#TOC40">6.1  Format of resource files</A></H2>
  58.  
  59. <P>
  60. A resource file is made up of several sections; sections have the
  61. purpose of separating the resources of a certain emulator from the ones
  62. of the other emulators.  A section starts with the name of an
  63. emulator in brackets (e.g., <SAMP>`[C64]'</SAMP>) and ends when another section
  64. starts or when the file ends.
  65.  
  66. </P>
  67. <P>
  68. Every line in a section has the following format:
  69.  
  70. </P>
  71.  
  72. <PRE>
  73. RESOURCE=VALUE
  74. </PRE>
  75.  
  76. <P>
  77. where <CODE>RESOURCE</CODE> is the name of a resource and <CODE>VALUE</CODE> is its
  78. assigned value.  Resource names are case-sensitive and resource values
  79. are either strings or integers.  Strings must start and end with a
  80. double quote character (<CODE>"</CODE>), while integers must be given in
  81. decimal notation.
  82.  
  83. </P>
  84. <P>
  85. Here is an example of a stripped-down <TT>`.vice/vicerc'</TT> file:
  86.  
  87. </P>
  88.  
  89. <PRE>
  90. [VIC20]
  91. HTMLBrowserCommand="netscape %s"
  92. SaveResourcesOnExit=0
  93. FileSystemDevice8=1
  94. FSDevice8ConvertP00=1
  95. FSDevice8Dir="/home/ettore/cbm/stuff/vic20p00"
  96. FSDevice8SaveP00=1
  97. FSDevice8HideCBMFiles=1
  98. [C64]
  99. HTMLBrowserCommand="netscape %s"
  100. SaveResourcesOnExit=1
  101. FileSystemDevice8=1
  102. FSDevice8ConvertP00=1
  103. FSDevice8Dir="/home/ettore/cbm/stuff/c64p00"
  104. FSDevice8SaveP00=1
  105. FSDevice8HideCBMFiles=1
  106. </PRE>
  107.  
  108. <P>
  109. Notice that, when resource values are saved with "Save settings", the
  110. emulator only modifies its own section, leaving the others unchanged.
  111.  
  112. </P>
  113.  
  114.  
  115. <H2><A NAME="SEC41" HREF="vice_toc.html#TOC41">6.2  Using command-line options to change resources</A></H2>
  116.  
  117. <P>
  118. Resources can also be changed via command-line options.
  119.  
  120. </P>
  121. <P>
  122. Command-line options always override the defaults from <CODE>.vice/vicerc</CODE>,
  123. and their assignments last for the whole session.  So, if you specify a
  124. certain command-line option that changes a certain resource from its
  125. default value and then use "Save Settings", the value specified with
  126. the command-line option will be saved back to the resource file.
  127.  
  128. </P>
  129. <P>
  130. Command-line options can begin with with a minus sign (<SAMP>`-'</SAMP>) or
  131. with a plus sign (<SAMP>`+'</SAMP>).  Options beginning with a minus sign
  132. may require an additional parameter, while the ones beginning with the
  133. plus sign never require one.
  134.  
  135. </P>
  136. <P>
  137. Moreover, options beginning with a plus sign always have a counterpart
  138. with the same name, but with a minus sign; in that case, the option
  139. beginning with a minus sign is used to <EM>enable</EM> a certain
  140. feature, while the one beginning with a plus sign is used to
  141. <EM>disable</EM> the same feature (this is an X11 convention).  For
  142. example, <CODE>-mitshm</CODE> enables support of MITSHM, while <CODE>+mitshm</CODE>
  143. disables it.
  144.  
  145. </P>
  146.  
  147.  
  148.  
  149. <H2><A NAME="SEC42" HREF="vice_toc.html#TOC42">6.3  Performance settings</A></H2>
  150.  
  151. <P>
  152. <A NAME="IDX16"></A>
  153. It is possible to control the emulation speed by using the "Maximum
  154. speed" menu item in the right-button menu.  The default setting is
  155. <CODE>100</CODE>, which causes the emulation to never run faster than the real
  156. machine.  A higher value allows the emulator to run faster, a lower one
  157. may force it to run slower.  The setting "No limit" means to run as
  158. fast as possible, without limiting speed.
  159.  
  160. </P>
  161. <P>
  162. <A NAME="IDX17"></A>
  163. It is also possible to control the emulator's rate of frame update using
  164. the "Refresh rate" setting; the value ranges from "1/1" (update 1/1
  165. of the frames of the real machine, that is 50 frames per second) to
  166. "1/10" (update 1 every 10 frames) and can be changed via the "Refresh
  167. Rate" submenu.  The "Auto" setting means to dynamically adapt the
  168. refresh rate to the current speed of the host machine, making sure the
  169. maximum speed specified by the via "Maxium speed" is always reached if
  170. possible.  In any case, the refresh rate will never be worse than 1/10
  171. if this option is specified.
  172.  
  173. </P>
  174. <P>
  175. Note that you cannot simultaneously specify "Auto" as the refresh rate
  176. and "No limit" as the maximum speed..
  177.  
  178. </P>
  179. <P>
  180. <A NAME="IDX18"></A>
  181. Moreover, a special <EM>warp speed</EM> mode is provided and can be toggled
  182. with the "Enable Warp Mode" menu item.  If this mode is enabled, it
  183. will cause the emulator to disable any speed limit, turn sound emulation
  184. off and use a 1/10 refresh rate, so that it will run at the maximum
  185. possible speed.
  186.  
  187. </P>
  188.  
  189.  
  190.  
  191. <H3><A NAME="SEC43" HREF="vice_toc.html#TOC43">6.3.1  Performance resources</A></H3>
  192.  
  193. <DL COMPACT>
  194.  
  195. <DT><CODE>Speed</CODE>
  196. <DD>
  197. <A NAME="IDX19"></A>
  198.  
  199. Integer specifying the maximum relative speed, as a percentage.  <CODE>0</CODE>
  200. stands for "no limit".
  201.  
  202. <A NAME="IDX20"></A>
  203. <DT><CODE>RefreshRate</CODE>
  204. <DD>
  205. Integer specifying the refresh rate; a value of <CODE>n</CODE> specifies a
  206. refresh rate of 1/<CODE>n</CODE>.  A value of <CODE>0</CODE> enables automatic frame
  207. skipping.
  208.  
  209. <A NAME="IDX21"></A>
  210. <DT><CODE>WarpMode</CODE>
  211. <DD>
  212. Booolean specifying whether "warp mode" is turned on or not.
  213.  
  214. </DL>
  215.  
  216.  
  217.  
  218. <H3><A NAME="SEC44" HREF="vice_toc.html#TOC44">6.3.2  Performance command-line options</A></H3>
  219.  
  220. <DL COMPACT>
  221.  
  222. <DT><CODE>-speed VALUE</CODE>
  223. <DD>
  224. <A NAME="IDX22"></A>
  225.  
  226. Specifies the maximum speed as a percentage.  <CODE>0</CODE> stands for "no
  227. limit".  (Same as setting the <CODE>Speed</CODE> resource.)
  228.  
  229. <A NAME="IDX23"></A>
  230. <DT><CODE>-refresh VALUE</CODE>
  231. <DD>
  232. Specifies refresh rate; a value of <CODE>n</CODE> specifies a refresh rate of
  233. 1/<CODE>n</CODE>.  A value of <CODE>0</CODE> enables automatic frame skipping.
  234. (Same as setting the <CODE>RefreshRate</CODE> resource.)
  235.  
  236. <A NAME="IDX24"></A>
  237. <DT><CODE>-warp</CODE>
  238. <DD>
  239. <DT><CODE>+warp</CODE>
  240. <DD>
  241. Enables/disables warp mode (<CODE>WarpMode=1</CODE>, <CODE>WarpMode=0</CODE>).
  242.  
  243. </DL>
  244.  
  245.  
  246.  
  247. <H2><A NAME="SEC45" HREF="vice_toc.html#TOC45">6.4  Video settings</A></H2>
  248.  
  249. <P>
  250. The following right-button menu items control the video output.
  251. On emulators that include two video chips (like <CODE>x128</CODE>)
  252. all options but XSync exist twice, once for each chip.
  253. XSync is shared between the video chips.
  254.  
  255. </P>
  256.  
  257. <UL>
  258.  
  259. <LI>
  260.  
  261. <A NAME="IDX25"></A>
  262.  
  263. "Video Cache" enables a video cache that can speed up the emulation
  264. when little graphics activity is going on; it is especially useful when
  265. you run the emulator on a networked X terminal as it can reduce the
  266. network bandwidth required.  However, this setting can actually make the
  267. emulator slower when there is little graphics activity and the amount of
  268. work needed to maintain the cache is greater than the amount of work that
  269. would be wasted by not using it (if any).
  270.  
  271. <A NAME="IDX26"></A>
  272. <LI>
  273.  
  274. "Double Size" toggles <EM>double-size mode</EM>, which makes the
  275. emulation window twice as big.  When emulating a 80-column PET, only the
  276. height is doubled, so that the aspect ratio is closer to that of the
  277. real thing.
  278.  
  279. <A NAME="IDX27"></A>
  280. <LI>
  281.  
  282. "Double Scan" toggles <EM>double-scan mode</EM>, which causes the
  283. emulator to draw only odd lines when running in double-size mode (this
  284. saves some CPU time and also makes the emulation window look more like
  285. an old monitor).
  286.  
  287. <A NAME="IDX28"></A>
  288. <A NAME="IDX29"></A>
  289. <LI>
  290.  
  291. `Use XSync()" causes the emulator to call the X11 function
  292. <CODE>XSync()</CODE> before updating the emulation window: this might be
  293. necessary on low-end systems to prevent it from consuming so many system
  294. resources that it becomes impossible for the user to interact with it.
  295.  
  296. </UL>
  297.  
  298.  
  299.  
  300. <H3><A NAME="SEC46" HREF="vice_toc.html#TOC46">6.4.1  Video resources</A></H3>
  301.  
  302. <P>
  303. The following resources affect the screen emulation. The prefix of
  304. some of the resources and commandline options denote the video chip 
  305. the values apply to.
  306.  
  307. </P>
  308. <DL COMPACT>
  309.  
  310. <DT><CODE>VideoCache, CrtcVideoCache</CODE>
  311. <DD>
  312. <A NAME="IDX30"></A>
  313.  <A NAME="IDX31"></A>
  314.  
  315. Boolean specifying whether the video cache is turned on.
  316.  
  317. <A NAME="IDX32"></A>
  318. <A NAME="IDX33"></A>
  319. <DT><CODE>DoubleSize, CrtcDoubleSize</CODE>
  320. <DD>
  321. Boolean specifying whether double-size mode is turned on.
  322.  
  323. <A NAME="IDX34"></A>
  324. <A NAME="IDX35"></A>
  325. <DT><CODE>DoubleScan, CrtcDoubleScan</CODE>
  326. <DD>
  327. Boolean specifying whether double-scan mode is turned on.
  328.  
  329. <A NAME="IDX36"></A>
  330. <DT><CODE>UseXSync</CODE>
  331. <DD>
  332. Boolean specifying whether <CODE>XSync()</CODE> is called after updating the
  333. emulation window.
  334.  
  335. <A NAME="IDX37"></A>
  336. <DT><CODE>MITSHM</CODE>
  337. <DD>
  338. Integer specifying whether VICE should try to use the shared memory
  339. extensions (MITSHM) when starting up.  The shared memory extensions make
  340. things a lot faster but might not be available on your system.  You will
  341. not be able to use these extensions if you are sitting at an X terminal
  342. while running the emulator on a remote machine across a network.  Valid
  343. values are: 0 = do not use MITSHM, 1 = do use MITSHM, -1 = try to
  344. autodetect availability on startup (default).  The last is a simple test
  345. if the emulator runs across a network and if so disables MITSHM (If you
  346. have problems with this test please report it).
  347.  
  348. <A NAME="IDX38"></A>
  349. <DT><CODE>PrivateColormap</CODE>
  350. <DD>
  351. Boolean specifying whether VICE should install a private colormap at
  352. startup.  This makes sense for 8-bit displays that could run out of
  353. colors if other color-hungry applications are running at the same time.
  354.  
  355. <A NAME="IDX39"></A>
  356. <DT><CODE>DisplayDepth</CODE>
  357. <DD>
  358. Integer specifying the depth of the host display.  The value <SAMP>`0'</SAMP>
  359. (the default) causes the emulator to autodetect it.
  360.  
  361. <A NAME="IDX40"></A>
  362. <A NAME="IDX41"></A>
  363. <DT><CODE>PaletteFile, CrtcPaletteFile</CODE>
  364. <DD>
  365. String specifying the name of the palette file being used.  The
  366. <TT>`.vpl'</TT> extension is optional.
  367.  
  368. </DL>
  369.  
  370.  
  371.  
  372. <H3><A NAME="SEC47" HREF="vice_toc.html#TOC47">6.4.2  Video command-line options</A></H3>
  373.  
  374. <DL COMPACT>
  375.  
  376. <DT><CODE>-vcache</CODE>
  377. <DD>
  378. <A NAME="IDX42"></A>
  379.  
  380. <DT><CODE>+vcache</CODE>
  381. <DD>
  382. Enable/disable the video cache (<CODE>VideoCache=1</CODE>, <CODE>VideoCache=0</CODE>).
  383.  
  384. <A NAME="IDX43"></A>
  385. <DT><CODE>-dsize</CODE>
  386. <DD>
  387. <DT><CODE>+dsize</CODE>
  388. <DD>
  389. Enable/disable the double size mode (<CODE>DoubleSize=1</CODE>,
  390. <CODE>DoubleSize=0</CODE>).
  391.  
  392. <A NAME="IDX44"></A>
  393. <DT><CODE>-dscan</CODE>
  394. <DD>
  395. <DT><CODE>+dscan</CODE>
  396. <DD>
  397. Enable/disable the double scan mode (<CODE>DoubleScan=1</CODE>,
  398. <CODE>DoubleScan=0</CODE>).
  399.  
  400. <A NAME="IDX45"></A>
  401. <DT><CODE>-xsync</CODE>
  402. <DD>
  403. <DT><CODE>+xsync</CODE>
  404. <DD>
  405. Enable/disable usage of <CODE>XSync()</CODE> when updating the emulation
  406. window (<CODE>UseXSync=1</CODE>, <CODE>UseXSync=0</CODE>).
  407.  
  408. <A NAME="IDX46"></A>
  409. <DT><CODE>-mitshm</CODE>
  410. <DD>
  411. <DT><CODE>+mitshm</CODE>
  412. <DD>
  413. Enable/disable usage of the MITSHM extensions (<CODE>MITSHM=1</CODE>,
  414. <CODE>MITSHM=0</CODE>).
  415.  
  416. <A NAME="IDX47"></A>
  417. <DT><CODE>-mitshmauto</CODE>
  418. <DD>
  419. Enable autodetection of MITSHM availability (<CODE>MITSHM=-1</CODE>)
  420.  
  421. <A NAME="IDX48"></A>
  422. <DT><CODE>-install</CODE>
  423. <DD>
  424. <DT><CODE>+install</CODE>
  425. <DD>
  426. Enable/disable installation of a private colormap
  427. (<CODE>PrivateColormap=1</CODE>, <CODE>PrivateColormap=0</CODE>).
  428.  
  429. <A NAME="IDX49"></A>
  430. <DT><CODE>-displaydepth DEPTH</CODE>
  431. <DD>
  432. Specify the display depth (<CODE>DisplayDepth</CODE>).
  433.  
  434. <A NAME="IDX50"></A>
  435. <DT><CODE>-palette NAME</CODE>
  436. <DD>
  437. <DT><CODE>-crtcpalette NAME</CODE>
  438. <DD>
  439. Specify <CODE>NAME</CODE> as the palette file (<CODE>PaletteFile</CODE>,<CODE>CrtcPaletteFile</CODE>).
  440.  
  441. </DL>
  442.  
  443.  
  444.  
  445. <H2><A NAME="SEC48" HREF="vice_toc.html#TOC48">6.5  Keyboard settings</A></H2>
  446.  
  447. <P>
  448. It is possible to specify whether the "positional" or "symbolic"
  449. keyboard mapping should be used with the "Keyboard mapping type"
  450. submenu (see section <A HREF="vice_2.html#SEC11">2.6  The keyboard emulation</A> for an explanation of positional
  451. and symbolic mappings).
  452.  
  453. </P>
  454. <P>
  455. The keyboard settings submenu also allows you to:
  456.  
  457. </P>
  458.  
  459. <UL>
  460. <LI>
  461.  
  462. Load custom-made positional and symbolic keymap files
  463. ("Set symbolic keymap file" and "Set positional keymap file").
  464. <LI>
  465.  
  466. Dump the current keymap to a user-defined keymap file ("Dump to keymap
  467. file").
  468. </UL>
  469.  
  470.  
  471.  
  472. <H3><A NAME="SEC49" HREF="vice_toc.html#TOC49">6.5.1  Keyboard resources</A></H3>
  473.  
  474. <DL COMPACT>
  475.  
  476. <DT><CODE>KeymapIndex</CODE>
  477. <DD>
  478. <A NAME="IDX51"></A>
  479.  
  480. Integer identifying which keymap is being used; <CODE>0</CODE> indicates
  481. symbolic mapping, <CODE>1</CODE> positional mapping.  For the PET the even
  482. values represent symbolic mapping, odd positional.  Then add <CODE>0</CODE>
  483. for UK business keyboard or <CODE>2</CODE> for graphics keyboard.
  484.  
  485. <A NAME="IDX52"></A>
  486. <DT><CODE>KeymapSymFile</CODE>
  487. <DD>
  488. String specifying the name of the keymap file for the symbolic mapping
  489. (see section <A HREF="vice_2.html#SEC11">2.6  The keyboard emulation</A>, all but PET and CBM-II).
  490.  
  491. <A NAME="IDX53"></A>
  492. <DT><CODE>KeymapPosFile</CODE>
  493. <DD>
  494. String specifying the name of the keymap file for the positional mapping
  495. (see section <A HREF="vice_2.html#SEC11">2.6  The keyboard emulation</A>, all but PET and CBM-II).
  496.  
  497. <A NAME="IDX54"></A>
  498. <DT><CODE>KeymapBusinessUKSymFile</CODE>
  499. <DD>
  500. <DT><CODE>KeymapBusinessUKPosFile</CODE>
  501. <DD>
  502. String specifying the name of the keymap file for the symbolic 
  503. and positional mapping for the UK business keyboard
  504. (see section <A HREF="vice_2.html#SEC11">2.6  The keyboard emulation</A>, PET and CBM-II).
  505.  
  506. <A NAME="IDX55"></A>
  507. <DT><CODE>KeymapGraphicsSymFile</CODE>
  508. <DD>
  509. <DT><CODE>KeymapGraphicsPosFile</CODE>
  510. <DD>
  511. String specifying the name of the keymap file for the symbolic and 
  512. positional mapping for the graphics keyboard
  513. (see section <A HREF="vice_2.html#SEC11">2.6  The keyboard emulation</A>, PET only).
  514.  
  515. <A NAME="IDX56"></A>
  516. <DT><CODE>KeymapBusinessDESymFile</CODE>
  517. <DD>
  518. <DT><CODE>KeymapBusinessDEPosFile</CODE>
  519. <DD>
  520. String specifying the name of the keymap file for the symbolic 
  521. and positional mapping for the German business keyboard.
  522. (see section <A HREF="vice_2.html#SEC11">2.6  The keyboard emulation</A>, PET only).
  523.  
  524. </DL>
  525.  
  526.  
  527.  
  528. <H3><A NAME="SEC50" HREF="vice_toc.html#TOC50">6.5.2  Keyboard command-line options</A></H3>
  529.  
  530. <DL COMPACT>
  531.  
  532. <DT><CODE>-keymap N</CODE>
  533. <DD>
  534. <A NAME="IDX57"></A>
  535.  
  536. Specifies which keymap is being used; <CODE>0</CODE> indicates symbolic
  537. mapping, <CODE>1</CODE> positional mapping (as for the <CODE>KeymapIndex</CODE>
  538. resource).
  539.  
  540. <A NAME="IDX58"></A>
  541. <DT><CODE>-symkeymap NAME</CODE>
  542. <DD>
  543. Specify <TT>`NAME'</TT> as the symbolic keymap file (<CODE>KeymapSymFile</CODE>).
  544.  
  545. <A NAME="IDX59"></A>
  546. <DT><CODE>-poskeymap NAME</CODE>
  547. <DD>
  548. Specify <TT>`NAME'</TT> as the positional keymap file (<CODE>KeymapPosFile</CODE>).
  549.  
  550. <A NAME="IDX60"></A>
  551. <DT><CODE>-buksymkeymap NAME</CODE>
  552. <DD>
  553. <DT><CODE>-bukposkeymap NAME</CODE>
  554. <DD>
  555. Specify <TT>`NAME'</TT> as the symbolic/positional keymap file for the
  556. UK business keyboard
  557. (<CODE>KeymapBusinessUKSymFile</CODE>, <CODE>KeymapBusinessUKPosFile</CODE>, PET and CBM-II).
  558.  
  559. <A NAME="IDX61"></A>
  560. <DT><CODE>-grsymkeymap NAME</CODE>
  561. <DD>
  562. <DT><CODE>-grposkeymap NAME</CODE>
  563. <DD>
  564. Specify <TT>`NAME'</TT> as the symbolic/positional keymap file for the
  565. graphics keyboard
  566. (<CODE>KeymapGraphicsSymFile</CODE>, <CODE>KeymapGraphicsPosFile</CODE>, PET only).
  567.  
  568. <A NAME="IDX62"></A>
  569. <DT><CODE>-bdesymkeymap NAME</CODE>
  570. <DD>
  571. <DT><CODE>-bdeposkeymap NAME</CODE>
  572. <DD>
  573. Specify <TT>`NAME'</TT> as the symbolic/positional keymap file for the
  574. German business keyboard
  575. (<CODE>KeymapBusinessDESymFile</CODE>, <CODE>KeymapBusinessDEPosFile</CODE>, PET only).
  576.  
  577. </DL>
  578.  
  579.  
  580.  
  581. <H2><A NAME="SEC51" HREF="vice_toc.html#TOC51">6.6  Sound settings</A></H2>
  582.  
  583. <P>
  584. The following menu items control sound output:
  585.  
  586. </P>
  587.  
  588. <UL>
  589.  
  590. <LI>
  591.  
  592. <A NAME="IDX63"></A>
  593.  
  594. "Enable sound playback" turns sound emulation on and off.
  595.  
  596. <A NAME="IDX64"></A>
  597. <A NAME="IDX65"></A>
  598. <LI>
  599.  
  600. "Sound synchronization" specifies the method for syncronizing the
  601. sound playback.  Possible settings are:
  602.  
  603. <UL>
  604. <LI>
  605.  
  606. "Flexible", i.e., the audio renderer flexibly adds/removes samples to
  607. the output to smoothly adapt the playback to slight changes in the speed
  608. of the emulator.
  609. <LI>
  610.  
  611. "Adjusting" works like "flexible", but supports bigger differences
  612. in speed.  For example, if the emulation speed drops down from from 100%
  613. to 50%, audio slows down by the same amount too.
  614. <LI>
  615.  
  616. "Exact", instead, makes the audio renderer output always the same
  617. sounds you would hear from the real thing, without trying to adapt the
  618. ratio; to compensate the tolerances in speed, some extra frames will be
  619. skipped or added.
  620. </UL>
  621.  
  622. <A NAME="IDX66"></A>
  623. <LI>
  624.  
  625. "Sample rate" specifies the sampling frequency, ranging from 8000 to
  626. 48000 Hz (not all the sound cards and/or sound drivers can support all
  627. the frequencies, so actually the nearest candidate will be chosen).
  628.  
  629. <A NAME="IDX67"></A>
  630. <A NAME="IDX68"></A>
  631. <LI>
  632.  
  633. "Buffer size" specifies the size of the audio buffer; the bigger the
  634. buffer, the longer the delay with which sounds are played.  You should
  635. pick the smallest value your machine can handle without problems.
  636.  
  637. <A NAME="IDX69"></A>
  638. <LI>
  639.  
  640. "Sound suspend time", will cause the audio playback to pause for the
  641. specified number of seconds whenever some clicking happens.  If "Keep
  642. going" is selected, no pausing is done.
  643.  
  644. <A NAME="IDX70"></A>
  645. <LI>
  646.  
  647. "Oversample" specifies an oversampling factor, from 1 to 8 times
  648. (warning: this eats CPU cycles!).
  649.  
  650. </UL>
  651.  
  652.  
  653.  
  654. <H3><A NAME="SEC52" HREF="vice_toc.html#TOC52">6.6.1  Sound resources</A></H3>
  655.  
  656. <DL COMPACT>
  657.  
  658. <DT><CODE>Sound</CODE>
  659. <DD>
  660. <A NAME="IDX71"></A>
  661.  
  662. Boolean specifying whether audio emulation is turned on.
  663.  
  664. <A NAME="IDX72"></A>
  665. <DT><CODE>SoundSpeedAdjustment</CODE>
  666. <DD>
  667. Integer specifying what speed adjustment method the audio renderer should
  668. use.  Possible values are:
  669.  
  670. <UL>
  671. <LI>
  672.  
  673. <CODE>0</CODE>: "flexible"
  674. <LI>
  675.  
  676. <CODE>1</CODE>: "adjusting"
  677. <LI>
  678.  
  679. <CODE>2</CODE>: "exact"
  680. </UL>
  681.  
  682. <A NAME="IDX73"></A>
  683. <DT><CODE>SoundSampleRate</CODE>
  684. <DD>
  685. Integer specifying the sampling frequency, ranging from 8000 to 48000 Hz
  686. (not all the sound cards and/or sound drivers can support all the
  687. frequencies, so actually the nearest candidate will be chosen).
  688.  
  689. <A NAME="IDX74"></A>
  690. <DT><CODE>SoundBufferSize</CODE>
  691. <DD>
  692. Integer specifying the size of the audio buffer, in milliseconds.
  693.  
  694. <A NAME="IDX75"></A>
  695. <DT><CODE>SoundSuspendTime</CODE>
  696. <DD>
  697. Integer specifying the pause interval when audio underflows ("clicks")
  698. happen.  <CODE>0</CODE> means no pause is done.
  699.  
  700. <A NAME="IDX76"></A>
  701. <DT><CODE>SoundOversample</CODE>
  702. <DD>
  703. Integer specifying the oversampling factor, ranging from <CODE>0</CODE> (no
  704. oversampling) to <CODE>3</CODE> (8 times oversampling).
  705.  
  706. <A NAME="IDX77"></A>
  707. <DT><CODE>SoundDeviceName</CODE>
  708. <DD>
  709. String specifying the audio driver.
  710.  
  711. Implemented drivers are:
  712.  
  713.  
  714. <UL>
  715. <LI>
  716.  
  717. <CODE>aix</CODE>, for the IBM AIX sound driver.
  718. <LI>
  719.  
  720. <CODE>uss</CODE>, for the Linux/FreeBSD Universal Sound System driver
  721. (<CODE>SoundDeviceArg</CODE> specifies the audio device, <TT>`/dev/dsp'</TT> by
  722. default);
  723. <LI>
  724.  
  725. <CODE>sgi</CODE>, for the Silicon Graphics audio device (<CODE>SoundDeviceArg</CODE>
  726. specifies the audio device, <TT>`/dev/audio'</TT> by default);
  727. <LI>
  728.  
  729. <CODE>sun</CODE>, for the Solaris audio device (unfinished;
  730. <CODE>SoundDeviceArg</CODE> specifies the audio device, <TT>`/dev/audio'</TT> by
  731. default).
  732. <LI>
  733.  
  734. <CODE>hpux</CODE>, for the HP-UX audio device (unfinished;
  735. <CODE>SoundDeviceArg</CODE> specifies the audio device, <TT>`/dev/audio'</TT> by
  736. default).
  737. <LI>
  738.  
  739. <CODE>sdl</CODE>, for the Simple DirectMedia Layer audio driver.
  740. <LI>
  741.  
  742. <CODE>esd</CODE>, for EsounD, the Enlightened Sound Daemon; <CODE>SoundDeviceArg</CODE>
  743. specifies the ESD server (<TT>`host:port'</TT>) to connect, empty by default.
  744. <LI>
  745.  
  746. <CODE>dummy</CODE>, fully emulating the SID, but not actually playing samples.
  747. <LI>
  748.  
  749. <CODE>dump</CODE>, writing all the write accesses to the registers to a file
  750. (specified by <CODE>SoundDeviceArg</CODE>, default value is
  751. <CODE>vicesnd.sid</CODE>);
  752. <LI>
  753.  
  754. <CODE>speed</CODE>, like <CODE>dummy</CODE> but also calculating samples (mainly
  755. used to evaluate the speed of the sample generator);
  756. <LI>
  757.  
  758. <CODE>fs</CODE>, writing samples to a file (specified by
  759. <CODE>SoundDeviceArg</CODE>; default is <TT>`vicesnd.raw'</TT>);
  760. </UL>
  761.  
  762. These drivers will actually be present only if the VICE configuration
  763. script detected the corresponding devices at the time of compilation.
  764.  
  765. <A NAME="IDX78"></A>
  766. <DT><CODE>SoundDeviceArg</CODE>
  767. <DD>
  768. String specifying an additional parameter for the audio driver (see
  769. <CODE>SoundDeviceName</CODE>).
  770.  
  771. </DL>
  772.  
  773.  
  774.  
  775. <H3><A NAME="SEC53" HREF="vice_toc.html#TOC53">6.6.2  Sound command-line options</A></H3>
  776.  
  777. <DL COMPACT>
  778.  
  779. <DT><CODE>-sound</CODE>
  780. <DD>
  781. <A NAME="IDX79"></A>
  782.  
  783. <DT><CODE>+sound</CODE>
  784. <DD>
  785. Turns sound emulation on (<CODE>Sound=1</CODE>) and off (<CODE>Sound=0</CODE>).
  786.  
  787. <A NAME="IDX80"></A>
  788. <DT><CODE>-soundsync N</CODE>
  789. <DD>
  790. Specify <CODE>N</CODE> as the sound speed adjustment method
  791. (<CODE>SoundSpeedAdjustment</CODE>).
  792.  
  793. <A NAME="IDX81"></A>
  794. <DT><CODE>-soundrate RATE</CODE>
  795. <DD>
  796. Specifies the sound playback sample rate (<CODE>SoundSampleRate</CODE>).
  797.  
  798. <A NAME="IDX82"></A>
  799. <DT><CODE>-soundbufsize SIZE</CODE>
  800. <DD>
  801. Specifies the size of the audio buffer in milliseconds
  802. (<CODE>SoundBufferSize</CODE>).
  803.  
  804. <A NAME="IDX83"></A>
  805. <DT><CODE>-sounddev NAME</CODE>
  806. <DD>
  807. Specifies the name of the audio device (<CODE>SoundDeviceName</CODE>).
  808.  
  809. <A NAME="IDX84"></A>
  810. <DT><CODE>-soundarg ARG</CODE>
  811. <DD>
  812. Specifies an additional parameter for the audio device
  813. (<CODE>SoundDeviceArg</CODE>).
  814.  
  815. </DL>
  816.  
  817.  
  818.  
  819. <H2><A NAME="SEC54" HREF="vice_toc.html#TOC54">6.7  Drive settings</A></H2>
  820.  
  821. <P>
  822. These settings are used to control the hardware-level emulation of the
  823. drive.  When hardware-level emulation is turned on, only drives 8 and 9
  824. are being emulated.
  825.  
  826. </P>
  827. <P>
  828. The following settings affect both drives:
  829.  
  830. </P>
  831.  
  832. <UL>
  833.  
  834. <LI>
  835.  
  836. "Enable true drive emulation" enables the (slow) hardware-level
  837. emulation of the drives for maximum compatibility.  This must be turned
  838. on for any of the following settings to have effect.
  839.  
  840. <LI>
  841.  
  842. "Drive sync factor" specifies the speed of the drive's CPU.  This can
  843. be used to help loading certain programs that have trouble with the
  844. default PAL setting (for example, programs designed for NTSC machines).
  845. The ratio is calculated as follows:
  846.  
  847.  
  848. <PRE>
  849. sync_factor = 65536 * clk_drive / clk_machine
  850. </PRE>
  851.  
  852. where <CODE>clk_drive</CODE> and <CODE>clk_machine</CODE> are clock speeds in MHz.
  853. The menu lets you choose between the PAL and NTSC values, and also lets
  854. you specify whatever value you want.  Be careful when changing it,
  855. though, because a wrong value can break things and even corrupt disk
  856. images.
  857.  
  858. </UL>
  859.  
  860. <P>
  861. The following settings, instead, are specific of each drive:
  862.  
  863. </P>
  864.  
  865. <UL>
  866.  
  867. <LI>
  868.  
  869. "Drive model" specifies the model of the drive being emulated.
  870. <STRONG>Warning:</STRONG> This will reset the drive.
  871.  
  872. <LI>
  873.  
  874. "Enable parallel cable" enables emulation of a SpeedDOS parallel
  875. cable; if you switch this option on and replace the original Commodore
  876. ROMs with SpeedDOS-compatible ones, you can speed up loading/saving times.
  877.  
  878. <LI>
  879.  
  880. "Idle method" specifies which method the drive emulation should use to
  881. save CPU cycles in the host CPU.  There are three methods:
  882.  
  883.  
  884. <UL>
  885. <LI>
  886.  
  887. <EM>Skip cycles</EM>: Each time the serial line is accessed by the C64, the
  888. drive executes all the cycles since the last time it ran.  If
  889. the number of elapsed cycles is larger than a certain value, the drive
  890. discards part of them.
  891. <LI>
  892.  
  893. <EM>Trap idle</EM>: The disk drive is still emulated upon serial line
  894. accesses as with the previous option, but it is also always emulated at
  895. the end of each screen frame.  If the drive gets into the DOS idle loop,
  896. only pending interrupts are emulated to save time.
  897. <LI>
  898.  
  899. <EM>No traps</EM>: Like "Trap idle", but without any traps at all.  So
  900. basically the drive works exactly as with the real thing, and nothing is
  901. done to reduce the power needs of the drive emulation.
  902. </UL>
  903.  
  904. The first option ("Skip cycles") is usually best for performance, as
  905. the drive is emulated as little as possible; on the other hand, you may
  906. notice sudden slowdowns (when the drive executes several cycles at once)
  907. and the LED status is never updated (because it would not be possible to
  908. do correctly so).  Moreover, if the drive tries to get in sync with the
  909. computer in some weird way and the computer does not access the serial
  910. line for a long time, it is possible that some cycles are discarded and
  911. the sync is lost.  Notice that this hack will have no effect on
  912. performance if a program continuously reads from the IEC port, as the
  913. drive will have to be fully emulated in any case (some stupid programs
  914. do this, even when they don't actually need to use the drive).
  915.  
  916. <P>
  917.  
  918. The second option ("Trap idle") is usually a bit slower, as at least
  919. interrupts are always emulated, but ensures the LED state is always
  920. updated correctly and always keeps the drive and the computer in sync.
  921. On the other hand, if a program installs a non-standard idle loop in the
  922. drive, the drive CPU has to be emulated even when not necessary and the
  923. global emulation speed is then <EM>much</EM> slower.
  924.  
  925. <LI>
  926.  
  927. "40-track image support" specifies how 40-track ("extended") disk
  928. images should be supported.  There are three possible ways:
  929.  
  930.  
  931. <UL>
  932. <LI>
  933.  
  934. "Never extend" never extends disk images at all (so if a program tries
  935. to write tracks beyond the 35th, it is not allowed to do so);
  936. <LI>
  937.  
  938. "Ask on extend" prompts the user as soon as a program tries to write
  939. tracks beyond the 35th, and the user can then choose whether he wants
  940. the disk image to be extended or not;
  941. <LI>
  942.  
  943. "Extend on access" simply extends the disk image as soon the program
  944. needs it, without prompting the user.
  945. </UL>
  946.  
  947. </UL>
  948.  
  949.  
  950.  
  951. <H3><A NAME="SEC55" HREF="vice_toc.html#TOC55">6.7.1  Drive resources</A></H3>
  952.  
  953. <DL COMPACT>
  954.  
  955. <DT><CODE>DriveTrueEmulation</CODE>
  956. <DD>
  957. <A NAME="IDX85"></A>
  958.  
  959. Boolean controlling whether the "true" drive emulation is turned on.
  960.  
  961. <A NAME="IDX86"></A>
  962. <A NAME="IDX87"></A>
  963. <DT><CODE>Drive8Type</CODE>
  964. <DD>
  965. <DT><CODE>Drive9Type</CODE>
  966. <DD>
  967. Integers specifying the model number for drives 8 and 9.  Possible values 
  968. are <CODE>1541</CODE>, <CODE>1571</CODE>, <CODE>1581</CODE> and <CODE>2031</CODE>.
  969.  
  970. <A NAME="IDX88"></A>
  971. <DT><CODE>Drive8ParallelCable</CODE>
  972. <DD>
  973. <A NAME="IDX89"></A>
  974. <DT><CODE>Drive9ParallelCable</CODE>
  975. <DD>
  976. Booleans controlling whether the SpeedDOS-compatible cable is emulated or
  977. not for drives 8 and 9.
  978.  
  979. <A NAME="IDX90"></A>
  980. <DT><CODE>Drive8ExtendImagePolicy</CODE>
  981. <DD>
  982. <A NAME="IDX91"></A>
  983. <DT><CODE>Drive9ExtendImagePolicy</CODE>
  984. <DD>
  985. Integer specifying the policy for 40-track support for drives 8 and 9.
  986. Possible values are <CODE>0</CODE> (never extend), <CODE>1</CODE> (ask on extend),
  987. <CODE>2</CODE> (extend on access).
  988.  
  989. <A NAME="IDX92"></A>
  990. <DT><CODE>Drive8IdleMethod</CODE>
  991. <DD>
  992. <A NAME="IDX93"></A>
  993. <DT><CODE>Drive9IdleMethod</CODE>
  994. <DD>
  995. Integers specifying the idling method for the drive CPU.  Possible values
  996. are <CODE>0</CODE> (none), <CODE>1</CODE> (skip cycles), <CODE>2</CODE> (trap idle).
  997. See section <A HREF="vice_6.html#SEC54">6.7  Drive settings</A>.
  998.  
  999. <A NAME="IDX94"></A>
  1000. <DT><CODE>DriveSyncFactor</CODE>
  1001. <DD>
  1002. Integer specifying the drive's clock sync factor (see section <A HREF="vice_6.html#SEC54">6.7  Drive settings</A>).  Special values <CODE>-1</CODE> and <CODE>-2</CODE> mean PAL and NTSC,
  1003. respectively.
  1004.  
  1005. <A NAME="IDX95"></A>
  1006. <DT><CODE>DosName1541</CODE>
  1007. <DD>
  1008. <A NAME="IDX96"></A>
  1009. <DT><CODE>DosName1571</CODE>
  1010. <DD>
  1011. <A NAME="IDX97"></A>
  1012. <DT><CODE>DosName1581</CODE>
  1013. <DD>
  1014. <A NAME="IDX98"></A>
  1015. <DT><CODE>DosName2031</CODE>
  1016. <DD>
  1017. Strings specifying the names of the ROM images for the drive emulation.
  1018.  
  1019. </DL>
  1020.  
  1021.  
  1022.  
  1023. <H3><A NAME="SEC56" HREF="vice_toc.html#TOC56">6.7.2  Drive command-line options</A></H3>
  1024.  
  1025. <DL COMPACT>
  1026.  
  1027. <DT><CODE>-truedrive</CODE>
  1028. <DD>
  1029. <A NAME="IDX99"></A>
  1030.  
  1031. <DT><CODE>+truedrive</CODE>
  1032. <DD>
  1033. Turns true drive emulation on (<CODE>DriveTrueEmulation=1</CODE>) and off
  1034. (<CODE>DriveTrueEmulation=0</CODE>), respectively.
  1035.  
  1036. <A NAME="IDX100"></A>
  1037. <DT><CODE>-drive8type TYPE</CODE>
  1038. <DD>
  1039. <DT><CODE>-drive9type TYPE</CODE>
  1040. <DD>
  1041. Specifies the drive types for units 8 and 9, respectively.  Possible
  1042. values for <CODE>TYPE</CODE> are <CODE>1541</CODE>, <CODE>1571</CODE>, <CODE>1581</CODE> and
  1043. <CODE>2031</CODE>.
  1044.  
  1045. <A NAME="IDX101"></A>
  1046. <DT><CODE>-parallel8</CODE>
  1047. <DD>
  1048. <DT><CODE>+parallel8</CODE>
  1049. <DD>
  1050. <DT><CODE>-parallel9</CODE>
  1051. <DD>
  1052. <DT><CODE>+parallel9</CODE>
  1053. <DD>
  1054. Turns emulation of the SpeedDOS-compatible parallel cable for 
  1055. disk unit 8 or 9 on
  1056. (<CODE>DriveXParallelCable=1</CODE>, X=8 or 9) and off 
  1057. (<CODE>DriveXParallelCable=0</CODE>), respectively.
  1058.  
  1059. <A NAME="IDX102"></A>
  1060. <DT><CODE>-drive8idle NUM</CODE>
  1061. <DD>
  1062. <DT><CODE>-drive9idle NUM</CODE>
  1063. <DD>
  1064. Specifies <CODE>NUM</CODE> as the idling method in drives 8 and 9, respectively
  1065. (<CODE>Drive8IdleMethod</CODE>, <CODE>Drive9IdleMethod</CODE>).
  1066.  
  1067. <A NAME="IDX103"></A>
  1068. <DT><CODE>-drive8extend NUM</CODE>
  1069. <DD>
  1070. <DT><CODE>-drive9extend NUM</CODE>
  1071. <DD>
  1072. Specifies <CODE>NUM</CODE> as the track 40 extend policy in drives 8 and 9, 
  1073. respectively
  1074. (<CODE>Drive8ExtendImagePolicy</CODE>, <CODE>Drive9ExtendImagePolicy</CODE>).
  1075.  
  1076. <A NAME="IDX104"></A>
  1077. <DT><CODE>-paldrive</CODE>
  1078. <DD>
  1079. Specifies a PAL sync factor for the drive emulation
  1080. (<CODE>DriveSyncFactor=-1</CODE>).
  1081.  
  1082. <A NAME="IDX105"></A>
  1083. <DT><CODE>-ntscdrive</CODE>
  1084. <DD>
  1085. Specifies an NTSC sync factor for the drive emulation
  1086. (<CODE>DriveSyncFactor=-2</CODE>).
  1087.  
  1088. <A NAME="IDX106"></A>
  1089. <DT><CODE>-drivesync NUM</CODE>
  1090. <DD>
  1091. Specifies a generic sync factor for the drive emulation
  1092. (<CODE>True1541SyncFactor</CODE>).
  1093.  
  1094. <A NAME="IDX107"></A>
  1095. <A NAME="IDX108"></A>
  1096. <A NAME="IDX109"></A>
  1097. <A NAME="IDX110"></A>
  1098. <A NAME="IDX111"></A>
  1099. <DT><CODE>-dos1541</CODE>
  1100. <DD>
  1101. <DT><CODE>-dos1571</CODE>
  1102. <DD>
  1103. <DT><CODE>-dos1581</CODE>
  1104. <DD>
  1105. <DT><CODE>-dos2031</CODE>
  1106. <DD>
  1107. <DT><CODE>-dos2040</CODE>
  1108. <DD>
  1109. <DT><CODE>-dos3040</CODE>
  1110. <DD>
  1111. <DT><CODE>-dos4040</CODE>
  1112. <DD>
  1113. <DT><CODE>-dos1001</CODE>
  1114. <DD>
  1115. Specify the ROM names for the 1541, 1571, 1581, 2031, 2040, 3040, 4040 
  1116. and 1001 emulation respectively.
  1117.  
  1118. </DL>
  1119.  
  1120.  
  1121.  
  1122. <H2><A NAME="SEC57" HREF="vice_toc.html#TOC57">6.8  Peripheral settings</A></H2>
  1123.  
  1124. <P>
  1125. VICE is able to support some special peripherals:
  1126.  
  1127. </P>
  1128.  
  1129. <UL>
  1130. <LI>
  1131.  
  1132. <EM>file system devices</EM>, pseudo-drives accessing the Unix file system;
  1133. <LI>
  1134.  
  1135. printers.
  1136. </UL>
  1137.  
  1138. <P>
  1139. These features depend on some <EM>kernal traps</EM> that replace the
  1140. existing routines in the original Commodore operating system with
  1141. custom-made C routines.
  1142.  
  1143. </P>
  1144.  
  1145.  
  1146.  
  1147. <H3><A NAME="SEC58" HREF="vice_toc.html#TOC58">6.8.1  Settings for file system devices</A></H3>
  1148.  
  1149. <P>
  1150. These settings deal with the drive-like peripherals connected to the bus
  1151. of the emulated machine. 
  1152. The first setting relates to the parallel IEEE488 interface. With 
  1153. this interface a special engine is used to listen to the bus lines 
  1154. to translates them to the filesystem code. Thus the PET will always
  1155. detect a drive for example, but it can also use drives 10 and 11 even
  1156. together with true disk drive emulation. 
  1157.  
  1158. </P>
  1159.  
  1160. <UL>
  1161. <LI>
  1162.  
  1163. "Enable virtual devices", enables the peripheral access via
  1164. the fast disk emulation (either kernal traps or IEEE488 interface). 
  1165. Both, filesystem and disk image access via fast
  1166. drive emulation, are affected.
  1167. </UL>
  1168.  
  1169. <P>
  1170. Four peripherals, numbered from 8 to 11, are
  1171. accessible; each of them provides the following settings:
  1172.  
  1173. </P>
  1174.  
  1175. <UL>
  1176. <LI>
  1177.  
  1178. "File system access", if enabled, allows the device to emulate a drive
  1179. accessing a file system directory; note that when a disk image is
  1180. attached to the same drive, the directory is no longer visible and the
  1181. attached disk is used instead.
  1182. <LI>
  1183.  
  1184. "File system directory" specifies the directory to be accessed by the
  1185. drive.
  1186. <LI>
  1187.  
  1188. "Convert P00 file names", if enabled, allows access to P00 files using
  1189. their built-in name instead of the Unix one.
  1190. <LI>
  1191.  
  1192. "Create P00 files on save", if enabled, creates P00 files (instead of
  1193. raw CBM files) whenever a program creates a file.
  1194. </UL>
  1195.  
  1196. <P>
  1197. Note that, by default, all drives except 11 create P00 files on save,
  1198. while drive 11 creates raw CBM files. Those files come without any header, 
  1199. but also with the filename restrictions given by the operating system
  1200. VICE runs on.
  1201.  
  1202. </P>
  1203.  
  1204.  
  1205.  
  1206. <H4><A NAME="SEC59" HREF="vice_toc.html#TOC59">6.8.1.1  Resources for file system devices</A></H4>
  1207.  
  1208. <DL COMPACT>
  1209.  
  1210. <DT><CODE>FSDevice8ConvertP00</CODE>
  1211. <DD>
  1212. <A NAME="IDX112"></A>
  1213.  
  1214. <A NAME="IDX113"></A>
  1215. <DT><CODE>FSDevice9ConvertP00</CODE>
  1216. <DD>
  1217. <A NAME="IDX114"></A>
  1218. <DT><CODE>FSDevice10ConvertP00</CODE>
  1219. <DD>
  1220. <A NAME="IDX115"></A>
  1221. <DT><CODE>FSDevice11ConvertP00</CODE>
  1222. <DD>
  1223. Booleans specifying whether on-read support for P00 files is enabled on
  1224. drives 8, 9, 10 and 11 respectively (on by default).
  1225.  
  1226. <A NAME="IDX116"></A>
  1227. <DT><CODE>FSDevice8SaveP00</CODE>
  1228. <DD>
  1229. <A NAME="IDX117"></A>
  1230. <DT><CODE>FSDevice9SaveP00</CODE>
  1231. <DD>
  1232. <A NAME="IDX118"></A>
  1233. <DT><CODE>FSDevice10SaveP00</CODE>
  1234. <DD>
  1235. <A NAME="IDX119"></A>
  1236. <DT><CODE>FSDevice11SaveP00</CODE>
  1237. <DD>
  1238. Booleans specifying whether the drives should create P00 files instead
  1239. of plain CBM ones (on by default for drives 8-10, off for 11).
  1240.  
  1241. <A NAME="IDX120"></A>
  1242. <DT><CODE>FSDevice8HideCBMFiles</CODE>
  1243. <DD>
  1244. <A NAME="IDX121"></A>
  1245. <DT><CODE>FSDevice9HideCBMFiles</CODE>
  1246. <DD>
  1247. <A NAME="IDX122"></A>
  1248. <DT><CODE>FSDevice10HideCBMFiles</CODE>
  1249. <DD>
  1250. <A NAME="IDX123"></A>
  1251. <DT><CODE>FSDevice11HideCBMFiles</CODE>
  1252. <DD>
  1253. Booleans specifying whether non-P00 files should be invisible to
  1254. programs running in the emulator (do not hide by default).
  1255.  
  1256. <A NAME="IDX124"></A>
  1257. <DT><CODE>FSDevice8Dir</CODE>
  1258. <DD>
  1259. <A NAME="IDX125"></A>
  1260. <DT><CODE>FSDevice9Dir</CODE>
  1261. <DD>
  1262. <A NAME="IDX126"></A>
  1263. <DT><CODE>FSDevice10Dir</CODE>
  1264. <DD>
  1265. <A NAME="IDX127"></A>
  1266. <DT><CODE>FSDevice11Dir</CODE>
  1267. <DD>
  1268. Strings specifying the directories to which drives 8, 9, 10 and 11
  1269. have access.
  1270.  
  1271. </DL>
  1272.  
  1273.  
  1274.  
  1275. <H4><A NAME="SEC60" HREF="vice_toc.html#TOC60">6.8.1.2  Command-line options for file system devices</A></H4>
  1276.  
  1277. <DL COMPACT>
  1278.  
  1279. <DT><CODE>-fs8 PATH</CODE>
  1280. <DD>
  1281. <A NAME="IDX128"></A>
  1282.  
  1283. <A NAME="IDX129"></A>
  1284. <DT><CODE>-fs9 PATH</CODE>
  1285. <DD>
  1286. <A NAME="IDX130"></A>
  1287. <DT><CODE>-fs10 PATH</CODE>
  1288. <DD>
  1289. <A NAME="IDX131"></A>
  1290. <DT><CODE>-fs11 PATH</CODE>
  1291. <DD>
  1292. Specify the paths for the file system access on drives 8, 9, 10 and 11,
  1293. respectively (<CODE>FSDevice8Dir</CODE>, <CODE>FSDevice9Dir</CODE>,
  1294. <CODE>FSDevice10Dir</CODE> and <CODE>FSDevice11Dir</CODE>).
  1295.  
  1296. </DL>
  1297.  
  1298.  
  1299.  
  1300. <H3><A NAME="SEC61" HREF="vice_toc.html#TOC61">6.8.2  Printer settings</A></H3>
  1301.  
  1302. <P>
  1303. The VICE emulators can emulate printers connected to either the IEC
  1304. buffer or the user port.  Emulation can be achieved by redirecting the
  1305. printer output to a file or by piping it through an external process.
  1306. This is defined by so-called <EM>printer device file names</EM>; a printer
  1307. device file name can be either a simple path, or a command name
  1308. preceeded by a pipe symbol <SAMP>`|'</SAMP>.
  1309.  
  1310. </P>
  1311. <P>
  1312. For example, printer device <SAMP>`filename'</SAMP> will cause the output to be
  1313. appended to the file <TT>`filename'</TT>, while printer device <SAMP>`|lpr'</SAMP>
  1314. will cause the <CODE>lpr</CODE> command to be executed and be fed the printer
  1315. output.  The printer output will not be converted but saved as printed
  1316. by the emulated machine.
  1317.  
  1318. </P>
  1319. <P>
  1320. Up to three printer devices may be specified through the following
  1321. resources:
  1322.  
  1323. </P>
  1324.  
  1325. <UL>
  1326. <LI>
  1327.  
  1328. device 1, whose default value is <CODE>print.dump</CODE>;
  1329. <LI>
  1330.  
  1331. device 2, whose default value is <CODE>|lpr</CODE>.
  1332. <LI>
  1333.  
  1334. device 3, whose default value is <CODE>|petlp -F PS|lpr</CODE>;
  1335. </UL>
  1336.  
  1337. <P>
  1338. So, basically, by default printer device 1 will dump printer
  1339. output to <TT>`print.dump'</TT>; printer device 2 will print it via
  1340. <CODE>lpr</CODE> directly to the printer and device 3 will print it via
  1341. <CODE>petlp</CODE> (a not-yet-complete utility that will produce Postscript
  1342. output from the Commodore printer code) and then to the printer via 
  1343. <CODE>lpr</CODE>.
  1344.  
  1345. </P>
  1346.  
  1347.  
  1348.  
  1349. <H4><A NAME="SEC62" HREF="vice_toc.html#TOC62">6.8.2.1  Printer resources</A></H4>
  1350.  
  1351. <DL COMPACT>
  1352.  
  1353. <DT><CODE>PrDevice1</CODE>
  1354. <DD>
  1355. <A NAME="IDX132"></A>
  1356.  
  1357. <A NAME="IDX133"></A>
  1358. <DT><CODE>PrDevice2</CODE>
  1359. <DD>
  1360. <A NAME="IDX134"></A>
  1361. <DT><CODE>PrDevice3</CODE>
  1362. <DD>
  1363. Strings specifying the printer devices (see section <A HREF="vice_6.html#SEC61">6.8.2  Printer settings</A>).
  1364.  
  1365. <A NAME="IDX135"></A>
  1366. <DT><CODE>Printer4</CODE>
  1367. <DD>
  1368. Boolean specifying if the IEC printer (device 4) is being emulated.
  1369.  
  1370. <A NAME="IDX136"></A>
  1371. <DT><CODE>Printer4Dev</CODE>
  1372. <DD>
  1373. Integer (ranging from 0 to 2, for device 1-3) specifying what printer device 
  1374. (see section <A HREF="vice_6.html#SEC61">6.8.2  Printer settings</A>) the IEC printer is using.
  1375.  
  1376. <A NAME="IDX137"></A>
  1377. <DT><CODE>PrUser</CODE>
  1378. <DD>
  1379. Boolean specifying if the user-port printer is being emulated.
  1380.  
  1381. <A NAME="IDX138"></A>
  1382. <DT><CODE>PrUserDev</CODE>
  1383. <DD>
  1384. Integer (ranging from 0 to 2, for device 1-3) specifying what printer 
  1385. device the user-port printer is using.
  1386.  
  1387. </DL>
  1388.  
  1389.  
  1390.  
  1391. <H4><A NAME="SEC63" HREF="vice_toc.html#TOC63">6.8.2.2  Printer command-line options</A></H4>
  1392.  
  1393. <DL COMPACT>
  1394.  
  1395. <DT><CODE>-prdev1 NAME</CODE>
  1396. <DD>
  1397. <A NAME="IDX139"></A>
  1398.  
  1399. <A NAME="IDX140"></A>
  1400. <DT><CODE>-prdev2 NAME</CODE>
  1401. <DD>
  1402. <A NAME="IDX141"></A>
  1403. <DT><CODE>-prdev3 NAME</CODE>
  1404. <DD>
  1405. Specify <CODE>NAME</CODE> as printer devices 1, 2 and 3, respectively
  1406. (<CODE>PrDevice1</CODE>, <CODE>PrDevice2</CODE> and <CODE>PrDevice3</CODE>).
  1407.  
  1408. <A NAME="IDX142"></A>
  1409. <DT><CODE>-printer4</CODE>
  1410. <DD>
  1411. <DT><CODE>+printer4</CODE>
  1412. <DD>
  1413. Enable/disable emulation of the IEC printer (<CODE>Printer4=1</CODE>,
  1414. <CODE>Printer4=0</CODE>).
  1415.  
  1416. <A NAME="IDX143"></A>
  1417. <DT><CODE>-pr4dev DEV</CODE>
  1418. <DD>
  1419. Specify device for the IEC printer (<CODE>Printer4Dev</CODE>).
  1420.  
  1421. <A NAME="IDX144"></A>
  1422. <DT><CODE>-pruser</CODE>
  1423. <DD>
  1424. <DT><CODE>+pruser</CODE>
  1425. <DD>
  1426. Enable/disable emulation of the IEC printer (<CODE>PrUser=1</CODE>,
  1427. <CODE>PrUser=0</CODE>).
  1428.  
  1429. <A NAME="IDX145"></A>
  1430. <DT><CODE>-pruserdev DEV</CODE>
  1431. <DD>
  1432. Specify device for the IEC printer (<CODE>PrUserDev</CODE>).
  1433.  
  1434. </DL>
  1435.  
  1436.  
  1437.  
  1438. <H3><A NAME="SEC64" HREF="vice_toc.html#TOC64">6.8.3  Disabling kernal traps</A></H3>
  1439.  
  1440. <P>
  1441. If you have compatibility problems, you can completely disable Kernal
  1442. traps with the "Disable kernal traps" option.  This will of course
  1443. disable all the features that depend on it, such as the fast 1541
  1444. emulation (so you will have to turn true 1541 emulation on if you want
  1445. to be able to read or write disk images) and tape support.
  1446.  
  1447. </P>
  1448.  
  1449.  
  1450.  
  1451. <H4><A NAME="SEC65" HREF="vice_toc.html#TOC65">6.8.3.1  Resources to control Kernal traps</A></H4>
  1452.  
  1453. <DL COMPACT>
  1454.  
  1455. <DT><CODE>VirtualDevices</CODE>
  1456. <DD>
  1457. <A NAME="IDX146"></A>
  1458.  
  1459. Boolean specifying whether all the mechanisms for virtual device
  1460. emulation should be enabled. Serial IEC devices use kernal traps, 
  1461. parallel IEEE488 devices use an own IEEE488 engine. Both are switched
  1462. on and off with this resource.
  1463.  
  1464. </DL>
  1465.  
  1466.  
  1467.  
  1468. <H4><A NAME="SEC66" HREF="vice_toc.html#TOC66">6.8.3.2  Command-line options to control Kernal traps</A></H4>
  1469.  
  1470. <DL COMPACT>
  1471.  
  1472. <DT><CODE>-virtualdev</CODE>
  1473. <DD>
  1474. <A NAME="IDX147"></A>
  1475.  
  1476. <DT><CODE>+virtualdev</CODE>
  1477. <DD>
  1478. Enable (<CODE>VirtualDevices=1</CODE>) or disable (<CODE>VirtualDevices=0</CODE>) 
  1479. virtual devices.
  1480.  
  1481. </DL>
  1482.  
  1483.  
  1484.  
  1485. <H2><A NAME="SEC67" HREF="vice_toc.html#TOC67">6.9  RS232 settings</A></H2>
  1486.  
  1487. <P>
  1488. The VICE emulators can emulate the RS232 device most of the machines
  1489. have.  The C64, C128 and VIC20 emulators emulate the userport RS232
  1490. interface at 300 and 1200 baud.  The C64 and C128 can also use the 9600
  1491. baud interface by Daniel Dallmann, using the shift registers of the two
  1492. CIA 6526 chips.  The PET can have a 6551 ACIA RS232 interface when
  1493. running as a SuperPET, and the CBM-II has such an ACIA by default.  The
  1494. C64 and C128 emulators can emulate an ACIA 6551 (also known as Datapump
  1495. for example) as extension at <CODE>$de**</CODE>.
  1496.  
  1497. </P>
  1498. <P>
  1499. Emulation can be achieved by either:
  1500.  
  1501. </P>
  1502.  
  1503. <UL>
  1504. <LI>
  1505.  
  1506. connecting a real UNIX serial device;
  1507. <LI>
  1508.  
  1509. dumping to a file;
  1510. <LI>
  1511.  
  1512. piping through a process.
  1513. </UL>
  1514.  
  1515. <P>
  1516. It is possible to define up to four UNIX serial devices, and then decide
  1517. which interface should be connected to which device.  This is done by
  1518. so-called <EM>rs232 device file names</EM>; an rs232 device file name can
  1519. be either a simple path, or a command name preceeded by a pipe symbol
  1520. <SAMP>`|'</SAMP>.  If the path specifies a special device (e.g. <TT>`/dev/ttyS0'</TT>) it
  1521. is recognized by VICE and the emulator can set the baudrate.
  1522.  
  1523. </P>
  1524. <P>
  1525. For example, rs232 device <SAMP>`filename'</SAMP> will cause the output to be
  1526. written (not appended) to the file <TT>`filename'</TT>, while printer device
  1527. <SAMP>`|lpr'</SAMP> will cause the <CODE>lpr</CODE> command to be executed and be fed
  1528. the rs232 output.  The rs232 output will not be converted but saved as
  1529. sent by the emulated machine.  The same holds true for the rs232 input.
  1530. If the command writes data to the standard output it will be caught by VICE 
  1531. and sent back to the emulator.  Also the data sent by the pseudo device will
  1532. be sent back to VICE.
  1533.  
  1534. </P>
  1535. <P>
  1536. For example you can setup a null-modem cable between two serial ports
  1537. of your PC, setup one port for login and use the other in VICE.  Then you
  1538. can login from your emulator via the RS232 emulation and the null-modem
  1539. cable to your machine again.
  1540.  
  1541. </P>
  1542. <P>
  1543. You can not simply run a shell from VICE, as the shell will notice that
  1544. it does not run on its own pseudo terminal and will thus buffer its
  1545. output.  You need to write some program that opens an own pseudo terminal
  1546. and runs the shell from there (not yet finished).
  1547.  
  1548. </P>
  1549. <P>
  1550. Up to four RS232 devices may be specified through the following
  1551. resources:
  1552.  
  1553. </P>
  1554.  
  1555. <UL>
  1556. <LI>
  1557.  
  1558. device 1, whose default value is <CODE>/dev/ttyS0</CODE>;
  1559. <LI>
  1560.  
  1561. device 2, whose default value is <CODE>/dev/ttyS1</CODE>;
  1562. <LI>
  1563.  
  1564. device 3, whose default value is <CODE>rs232.dump</CODE>;
  1565. <LI>
  1566.  
  1567. device 4, whose default value is <CODE>|lpr</CODE>.
  1568. </UL>
  1569.  
  1570. <P>
  1571. For the first two devices you can change the baudrate the tty device is
  1572. set to by specifying it on the commandline or in the menu.  This
  1573. baudrate is 9600 by default for the latter two, but can be changed only
  1574. by resources (The baudrate is independent from the baudrate the emulator
  1575. actually expects).
  1576.  
  1577. </P>
  1578.  
  1579.  
  1580.  
  1581. <H3><A NAME="SEC68" HREF="vice_toc.html#TOC68">6.9.1  RS232 resources</A></H3>
  1582.  
  1583. <DL COMPACT>
  1584.  
  1585. <DT><CODE>RsDevice1</CODE>
  1586. <DD>
  1587. <A NAME="IDX148"></A>
  1588.  
  1589. <A NAME="IDX149"></A>
  1590. <DT><CODE>RsDevice2</CODE>
  1591. <DD>
  1592. <A NAME="IDX150"></A>
  1593. <DT><CODE>RsDevice3</CODE>
  1594. <DD>
  1595. <A NAME="IDX151"></A>
  1596. <DT><CODE>RsDevice4</CODE>
  1597. <DD>
  1598. Strings specifying the RS232 devices (see section <A HREF="vice_6.html#SEC67">6.9  RS232 settings</A>).
  1599.  
  1600. <A NAME="IDX152"></A>
  1601. <DT><CODE>RsDevice1Baud</CODE>
  1602. <DD>
  1603. <A NAME="IDX153"></A>
  1604. <DT><CODE>RsDevice2Baud</CODE>
  1605. <DD>
  1606. <A NAME="IDX154"></A>
  1607. <DT><CODE>RsDevice3Baud</CODE>
  1608. <DD>
  1609. <A NAME="IDX155"></A>
  1610. <DT><CODE>RsDevice4Baud</CODE>
  1611. <DD>
  1612. Integer specifying the RS232 baudrate devices if the device file points
  1613. to a special device (like <TT>`/dev/ttyS0'</TT>; see section <A HREF="vice_6.html#SEC67">6.9  RS232 settings</A>).
  1614.  
  1615. <A NAME="IDX156"></A>
  1616. <DT><CODE>AciaDE</CODE>
  1617. <DD>
  1618. Boolean specifying whether C64 or C128 should emulate ACIA 6551 in
  1619. I/O 1, at <CODE>$de**</CODE>.
  1620.  
  1621. <A NAME="IDX157"></A>
  1622. <DT><CODE>Acia1Dev</CODE>
  1623. <DD>
  1624. Integer (ranging from 0 to 3, for device 1-4) specifying what RS232 device 
  1625. (see section <A HREF="vice_6.html#SEC67">6.9  RS232 settings</A>) the ACIA is using (all except VIC20).
  1626.  
  1627. <A NAME="IDX158"></A>
  1628. <DT><CODE>Acia1Irq</CODE>
  1629. <DD>
  1630. Integer specifying which interrupt to use. 0 = none, 1 = IRQ, 2 = NMI 
  1631. (C64 and C128 only)
  1632.  
  1633. <A NAME="IDX159"></A>
  1634. <DT><CODE>RsUser</CODE>
  1635. <DD>
  1636. Integer specifying if the user-port RS232 interface is being emulated and 
  1637. at which baudrate it should have for the emulator. 0 = off; > 0 specifies the
  1638. baudrate (C64, C128 and VIC20).
  1639.  
  1640. <A NAME="IDX160"></A>
  1641. <DT><CODE>RsUserDev</CODE>
  1642. <DD>
  1643. Integer (ranging from 0 to 3, for device 1-4) specifying what RS232 device 
  1644. the user-port interface is using (C64, C128 and VIC20).
  1645.  
  1646. </DL>
  1647.  
  1648.  
  1649.  
  1650. <H3><A NAME="SEC69" HREF="vice_toc.html#TOC69">6.9.2  RS232 command-line options</A></H3>
  1651.  
  1652. <DL COMPACT>
  1653.  
  1654. <DT><CODE>-rsdev1 NAME</CODE>
  1655. <DD>
  1656. <A NAME="IDX161"></A>
  1657.  
  1658. <A NAME="IDX162"></A>
  1659. <DT><CODE>-rsdev2 NAME</CODE>
  1660. <DD>
  1661. <A NAME="IDX163"></A>
  1662. <DT><CODE>-rsdev3 NAME</CODE>
  1663. <DD>
  1664. <A NAME="IDX164"></A>
  1665. <DT><CODE>-rsdev4 NAME</CODE>
  1666. <DD>
  1667. Specify <CODE>NAME</CODE> as RS232 devices 1, 2, 3 and 4, respectively
  1668. (<CODE>RsDevice1</CODE>, <CODE>RsDevice2</CODE> <CODE>RsDevice3</CODE> and <CODE>RsDevice4</CODE>).
  1669.  
  1670. <A NAME="IDX165"></A>
  1671. <DT><CODE>-rsdev1 BAUDRATE</CODE>
  1672. <DD>
  1673. <A NAME="IDX166"></A>
  1674. <DT><CODE>-rsdev2 BAUDRATE</CODE>
  1675. <DD>
  1676. <A NAME="IDX167"></A>
  1677. <DT><CODE>-rsdev3 BAUDRATE</CODE>
  1678. <DD>
  1679. <A NAME="IDX168"></A>
  1680. <DT><CODE>-rsdev4 BAUDRATE</CODE>
  1681. <DD>
  1682. Specify <CODE>BAUDRATE</CODE> as baudrate for the RS232 devices if the device name
  1683. specifies a special device (like <TT>`/dev/ttyS0'</TT> for example, 
  1684. see section <A HREF="vice_6.html#SEC67">6.9  RS232 settings</A>;
  1685. <CODE>RsDevice1Baud</CODE>, <CODE>RsDevice2Baud</CODE> <CODE>RsDevice3Baud</CODE> and 
  1686. <CODE>RsDevice4Baud</CODE>).
  1687.  
  1688. <A NAME="IDX169"></A>
  1689. <DT><CODE>-acia1dev</CODE>
  1690. <DD>
  1691. Specify device for the ACIA (<CODE>Acia1Dev</CODE>).
  1692.  
  1693. <A NAME="IDX170"></A>
  1694. <DT><CODE>-rsuser BAUDRATE</CODE>
  1695. <DD>
  1696. Enable (BAUDRATE not 0) or disable (BAUDRATE = 0) emulation of the 
  1697. userport RS232 emulation (<CODE>RsUser</CODE>; C64, C128 and VIC20)
  1698.  
  1699. <A NAME="IDX171"></A>
  1700. <DT><CODE>-rsuserdev DEV</CODE>
  1701. <DD>
  1702. Specify device for the userport RS232 emulation (<CODE>RsUserDev</CODE>; 
  1703. C64, C128 and VIC20).
  1704.  
  1705. </DL>
  1706.  
  1707.  
  1708.  
  1709. <H3><A NAME="SEC70" HREF="vice_toc.html#TOC70">6.9.3  RS232 usage example</A></H3>
  1710.  
  1711. <P>
  1712. Here we give you a simple example how to set up an emulated C64 using
  1713. the modem connected to your PC. The following list shows each step.
  1714.  
  1715. </P>
  1716. <DL COMPACT>
  1717.  
  1718. <DT><CODE>Attach your modem to your PC at a serial port.</CODE>
  1719. <DD>
  1720. Normally you should set it up to use the modem as "/dev/modem".
  1721. <DT><CODE>start VICE</CODE>
  1722. <DD>
  1723. <DT><CODE>Setup VICE to use your modem as "serial device 1"</CODE>
  1724. <DD>
  1725. Go to the RS232 settings menu and change "Serial 1 device" to "/dev/modem" (or the device where you attached your modem to)
  1726. Then go to the RS232 settings menu and change "Serial 1 baudrate" to the baudrate your modem should run at.
  1727.   Watch out, e.g. on Linux there is an additional multiplier
  1728.   to multiply with the baudrate (so e.g. 19200 gives 115200 or so baud)
  1729.   See the "setserial" manpage on Linux for example. 
  1730.   However, most modems should be able to autodetect the speed to 
  1731.   the computer as well.
  1732.  
  1733. <DT><CODE>Select the RS232 emulation your programs use</CODE>
  1734. <DD>
  1735. If you want to use the Userport emulation, go to the RS232 settings and 
  1736.   change "Userport RS232 Device" to 
  1737.   "Serial 1". If you want ACIA emulation (swiftlink or what's it called?)
  1738.   then change "ACIA $DE** device" to "Serial 1".
  1739.  
  1740. <DT><CODE>Enable the emulation</CODE>
  1741. <DD>
  1742.   Go to the RS232 settings and select either "ACIA $DE** emulation"
  1743.   or Userport 300/1200 baud or CIA 9600 baud emulation.
  1744.  
  1745. <DT><CODE>Load your program and start it.</CODE>
  1746. <DD>
  1747. If it is able to detect an
  1748.   RS232 cartridge like swiftlink or so, try to detect the ACIA emulation
  1749.   if enabled. 
  1750.   Otherwise just set the baudrate to either 300, 1200 or 9600 according
  1751.   to what you enabled in the VICE menu for the userport.
  1752.  
  1753. </DL>
  1754.  
  1755.  
  1756.  
  1757. <H2><A NAME="SEC71" HREF="vice_toc.html#TOC71">6.10  Miscellaneous settings</A></H2>
  1758.  
  1759. <P>
  1760. This section lists generic resources that do not fit in the other
  1761. categories.
  1762.  
  1763. </P>
  1764.  
  1765.  
  1766.  
  1767. <H3><A NAME="SEC72" HREF="vice_toc.html#TOC72">6.10.1  Miscellaneous resources</A></H3>
  1768.  
  1769. <DL COMPACT>
  1770.  
  1771. <DT><CODE>Directory</CODE>
  1772. <DD>
  1773. <A NAME="IDX172"></A>
  1774.  
  1775. String specifying the search path for system files.  It is defined as a
  1776. sequence of directory names, separated by colons (<SAMP>`:'</SAMP>), just like
  1777. the <CODE>PATH</CODE> variable in the shell.  The special string <SAMP>`$$'</SAMP>
  1778. stands for the default search path, which is initialized at startup to
  1779. the following value:
  1780.  
  1781.  
  1782. <PRE>
  1783. LIBDIR/EMUID:$HOME/.vice/EMUID:BOOTPATH/EMUID:LIBDIR/DRIVES:$HOME/.vice/DRIVES:BOOTPATH/DRIVES
  1784. </PRE>
  1785.  
  1786. where:
  1787.  
  1788.  
  1789. <UL>
  1790. <LI>
  1791.  
  1792. <CODE>LIBDIR</CODE> is the VICE installation directory (usually
  1793. <TT>`/usr/local/lib/vice'</TT>, <TT>`/usr/lib/vice'</TT> or
  1794. <TT>`/opt/vice/lib'</TT>);
  1795. <LI>
  1796.  
  1797. <CODE>EMUID</CODE> is the emulation identification
  1798. string (<CODE>C64</CODE>, <CODE>C128</CODE>, <CODE>VIC20</CODE> or <CODE>PET</CODE>);
  1799. <LI>
  1800.  
  1801. <CODE>BOOTPATH</CODE> is the directory where the binary lies (usually
  1802. <TT>`/usr/local/bin'</TT>, <TT>`/usr/bin'</TT> or <CODE>/opt/vice/bin</CODE>).
  1803. <LI>
  1804.  
  1805. <CODE>DRIVES</CODE> is the directory called "DRIVES", where the disk drive ROMs are.
  1806. (The disk drive ROMs are used by all emulators, so there is an extra
  1807. directory for them.)
  1808. </UL>
  1809.  
  1810. Notice that the middle entry points to a default location in
  1811. the user's home directory. Here private ROM versions (e.g. 
  1812. speeddos or JiffyDos) can be stored for example.
  1813.  
  1814. See section <A HREF="vice_4.html#SEC23">4  System files</A>. for a description of the method used to load the
  1815. emulator's system files.
  1816.  
  1817. <A NAME="IDX173"></A>
  1818. <DT><CODE>HTMLBrowserCommand</CODE>
  1819. <DD>
  1820. String specifying the command to run the help browser.  The help browser
  1821. can be any HTML browser, and every <SAMP>`%s'</SAMP> in the string is replaced
  1822. with the name of the toplevel file of the VICE documentation.  For
  1823. example, the default value <SAMP>`netscape %s'</SAMP> runs Netscape Navigator.
  1824.  
  1825. <A NAME="IDX174"></A>
  1826. <DT><CODE>SaveResourcesOnExit</CODE>
  1827. <DD>
  1828. Boolean specifying whether the emulator should save changed settings
  1829. before exiting.  If this is enabled, the user will be always prompted
  1830. first, in case the settings have changed.
  1831.  
  1832. <A NAME="IDX175"></A>
  1833. <DT><CODE>DoCoreDump</CODE>
  1834. <DD>
  1835. Boolean specifying whether the emulator should dump core when it gets a
  1836. signal.
  1837.  
  1838. <A NAME="IDX176"></A>
  1839. <DT><CODE>JoyDevice1</CODE>
  1840. <DD>
  1841. <DT><CODE>JoyDevice2</CODE>
  1842. <DD>
  1843. Integer specifying which joystick device the emulator should use for
  1844. joystick emulation for ports 1 and 2, respectively
  1845. (0=None, 1=Numpad, 2=Custom keys, 3=Analog joystick 1, 4=Analog joystick 2,
  1846. 5=Digital joystick 1, 6=Digital joystick 2 on Unix)
  1847. The available joysticks might differ depending on operating system and
  1848. joystick support in the OS (Linux joystick module must be 
  1849. available for example).
  1850.  
  1851. </DL>
  1852.  
  1853.  
  1854.  
  1855. <H3><A NAME="SEC73" HREF="vice_toc.html#TOC73">6.10.2  Miscellaneous command-line options</A></H3>
  1856.  
  1857. <DL COMPACT>
  1858.  
  1859. <DT><CODE>-directory SEARCHPATH</CODE>
  1860. <DD>
  1861. <A NAME="IDX177"></A>
  1862.  
  1863. Specify the system file search path (<CODE>Directory</CODE>).
  1864. <A NAME="IDX178"></A>
  1865. <DT><CODE>-htmlbrowser COMMAND</CODE>
  1866. <DD>
  1867. Specify the command to run the HTML browser for the on-line help
  1868. (<CODE>HTMLBrowserCommand</CODE>).
  1869. <A NAME="IDX179"></A>
  1870. <DT><CODE>-saveres</CODE>
  1871. <DD>
  1872. <DT><CODE>+saveres</CODE>
  1873. <DD>
  1874. Enable/disable automatic saving of settings on exit
  1875. (<CODE>SaveResourcesOnExit=1</CODE>, <CODE>SaveResourcesOnExit=0</CODE>).
  1876.  
  1877. <A NAME="IDX180"></A>
  1878. <DT><CODE>-core</CODE>
  1879. <DD>
  1880. <DT><CODE>+core</CODE>
  1881. <DD>
  1882. Enable/disable generation of core dumps (<CODE>DoCoreDump=1</CODE>,
  1883. <CODE>DoCoreDump=0</CODE>).
  1884.  
  1885. <A NAME="IDX181"></A>
  1886. <DT><CODE>-joydev1</CODE>
  1887. <DD>
  1888. <DT><CODE>-joydev2</CODE>
  1889. <DD>
  1890. Set the device for joystick emulation of port 1 and 2, respectively
  1891. (<CODE>JoyDevice1</CODE>, <CODE>JoyDevice2</CODE>).
  1892. </DL>
  1893.  
  1894. <P><HR><P>
  1895. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_5.html">previous</A>, <A HREF="vice_7.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  1896. </BODY>
  1897. </HTML>
  1898.