home *** CD-ROM | disk | FTP | other *** search
/ Microsoftware Monthly 19…2 Programming Power Tools / MASO9512.ISO / cpptutor / cpptutor.arj / READ.ME < prev    next >
Encoding:
Text File  |  1993-12-02  |  18.4 KB  |  522 lines
  1. 1. INTRODUCTION
  2. ---------------
  3.  
  4. This is the READ.ME file for EXPERIENCE C++.  It contains
  5. the following items:
  6.  
  7. 1. Details on getting started with EXPERIENCE C++.
  8. 2. Details on the hardware and software requirements for
  9.    running EXPERIENCE C++.
  10. 2. Instructions for installing the audio support manually.
  11. 3. Information about possible problems with audio installation
  12.    and audio errors.
  13.  
  14.  
  15. 2. GETTING STARTED
  16. ------------------
  17.  
  18. EXPERIENCE C++ is a multimedia tutorial on the C++ programming
  19. language.  You can use it either in closed-caption mode (the
  20. text appears in windows on the screen), or, if you have
  21. installed an appropriate sound card, in audio mode (you
  22. hear the spoken text, music, and other sounds).
  23.  
  24. 2.1  CLOSED-CAPTION MODE
  25. ------------------------
  26.  
  27. You do not have to perform any installation to use EXPERIENCE
  28. C++ in closed-caption mode.  All you have to do is:
  29.  
  30.  1. Check that your system satisfies the requirements listed
  31.     below under HARDWARE REQUIREMENTS and SOFTWARE REQUIREMENTS.
  32.     Note that you do not need a sound card to use EXPERIENCE
  33.     C++ in closed-caption mode.
  34.  
  35.  2. On a DOS command line, in either native DOS or a DOS session
  36.     in OS/2, make your CD drive your current drive and enter the
  37.     following command to start the book:
  38.  
  39.       CSTART
  40.  
  41. 2.2 AUDIO MODE
  42. --------------
  43.  
  44. To use EXPERIENCE C++ in audio mode:
  45.  
  46.  1. Check that your system satisfies the requirements listed
  47.     below under HARDWARE REQUIREMENTS and SOFTWARE REQUIREMENTS.
  48.     Specifically, your system has to have one of the sound
  49.     cards listed under HARDWARE REQUIREMENTS installed.
  50.  
  51.  2. From an OS/2 command line or a native DOS command line,
  52.     make the CD drive your current drive and enter:
  53.  
  54.       INSTALL
  55.  
  56.     This begins an installation procedure that asks you
  57.     some questions, including the type of sound card
  58.     you have installed on your system.
  59.     DO NOT RUN INSTALL FROM A DOS SESSION IN OS/2.
  60.  
  61.  3. If you have run INSTALL in OS/2, an EXPERIENCE C++ icon
  62.     should appear on your desktop.  Click on this icon to
  63.     start the book.
  64.  
  65.     If you have run INSTALL in native DOS, reboot your
  66.     system, make the CD drive your current drive, and
  67.     enter the following command to start the book:
  68.  
  69.       START
  70.  
  71.  
  72.  
  73. 2.3 MANUAL INSTALLATION OF AUDIO SUPPORT
  74. ----------------------------------------
  75.  
  76. Depending on the type of audio card that you are using and
  77. how it was installed, you may prefer to install the audio
  78. support for EXPERIENCE C++ manually.  See MANUAL INSTALLATION
  79. OF DEVICE DRIVERS FOR AUDIO below for details.
  80.  
  81. 2.4 OTHER COMMANDS TO START EXPERIENCE C++
  82. ------------------------------------------
  83.  
  84. In addition to CSTART and START, there are other commands that
  85. you can use to start the book.  Use one of the following
  86. commands to start the book on a system that has a mouse:
  87.  
  88.     START  - Plays the introduction followed by the body of
  89.              the book in audio mode.
  90.     CSTART - Plays the introduction followed by the body of
  91.              the book in caption mode.
  92.     MENU   - Plays the body of the book without the introduction
  93.              in audio mode.
  94.     CMENU  - Plays the body of the book without the introduction
  95.              in caption mode.
  96.  
  97. Use one of the following commands to start the book on
  98. a system that does not have a mouse:
  99.  
  100.     KSTART - Plays the introduction followed by the body of
  101.              the book in audio mode.
  102.     CKSTART- Plays the introduction followed by the body of
  103.              the book in caption mode.
  104.     KMENU  - Plays the body of the book without the introduction
  105.              in audio mode.
  106.     CKMENU - Plays the body of the book without the introduction
  107.              in caption mode.
  108.  
  109. NOTE: you must use the manual installation procedure if you want to use
  110.       EXPERIENCE C++ without a mouse.
  111.  
  112. 3. HARDWARE REQUIREMENTS
  113. ------------------------
  114.  
  115. The minimum requirements for running EXPERIENCE C++ are:
  116.  
  117.    Any IBM Personal System/1 or IBM Personal System/2
  118.    model, or 100% compatible, with the following minimum
  119.    configuration:
  120.    - Intel386 SX - compatible or higher based personal computer
  121.    - 2MB memory
  122.      500K of program memory available
  123.      800K of available extended or expanded RAM.  Use the DOS
  124.      command MEM to list the memory characteristics of your
  125.      machine.
  126.    - IBM VGA display adapter, or compatible, color or mono
  127.    - A DOS or OS/2 compatible CD-ROM drive
  128.    Optional items:
  129.    - IBM Mouse, or compatible
  130.    - One of these audio cards
  131.        Digispeech DS-201A
  132.        IBM Audio Capture/Playback Adapter
  133.        IBM Audio Capture/Playback Adapter/A
  134.        IBM PS/1 Audio/Joystick Adapter
  135.        SoundBlaster 1.0, 2.0, or compatible
  136.        SoundBlaster PRO (also Pro OPL/3)
  137.  
  138.  
  139. 4. SOFTWARE REQUIREMENTS
  140. ------------------------
  141.  
  142. The minimum requirements for running EXPERIENCE C++ are:
  143.  
  144.     - DOS 5.0 (or higher) installed
  145.       or
  146.     - OS/2 2.0 (or higher) installed
  147.     - Sufficient DOS environment space to create one DOS
  148.       environment variable (only required for caption-only mode)
  149.  
  150.  
  151. 5. MANUAL INSTALLATION OF DEVICE DRIVERS FOR AUDIO
  152. --------------------------------------------------
  153.  
  154. EXPERIENCE C++ makes extensive use of audio.  In order to hear
  155. the audio, an appropriate audio card and device driver must be
  156. installed.  You can use the command INSTALL from an OS/2 command
  157. line or a native DOS command line to install the driver.  If you
  158. wish to install the device driver manually (to avoid automatic
  159. changes to your CONFIG.SYS file, for example), you can follow
  160. the instructions below.
  161.  
  162. The audio device driver files are found in the directory
  163. \LLHOME\AUDIODD on the EXPERIENCE C++ CD:
  164.  
  165.          DRIVER:            AUDIO CARD:
  166.  
  167.        DIGISP.SYS      Digispeech DS-201A
  168.        ACPAK12.SYS     IBM Audio Capture/Playback Adapter
  169.                        IBM Audio Capture/Playback Adapter/A
  170.        PS1K12.SYS      IBM PS1 Audio/Joystick Adapter
  171.        SNDBK12.SYS     SoundBlaster 1.0, 2.0, and compatibles
  172.        SBWD.SYS        SoundBlaster 1.0, 2.0 **
  173.        SBPWD.SYS       SoundBlaster PRO (also Pro OPL/3) **
  174.  
  175.        **          Named adapter only - NOT compatibles.
  176.  
  177. If you have one of the cards listed above installed in your
  178. machine, follow these steps.  Then, when you start the book using
  179. the command START, you will hear the audio portion of the book.
  180.  
  181.   1. From the list above, select the device driver file that
  182.      corresponds with your audio card.
  183.  
  184.   1. Copy the appropriate device driver to a directory of your
  185.      choice on your hard disk.  These instructions assume you
  186.      copy it to the directory C:\LLHOME\AUDIODD.
  187.  
  188.   2. If you are going to be using the book in native DOS, follow
  189.      the instructions below under MANUAL INSTALLATION OF AUDIO
  190.      DEVICE DRIVERS FOR DOS. If you are going to be using the
  191.      book in a full-screen DOS session in OS/2, follow the
  192.      instructions below under MANUAL INSTALLATION OF AUDIO
  193.      DEVICE DRIVERS FOR OS/2.
  194.  
  195. 5.1  MANUAL INSTALLATION OF AUDIO DEVICE DRIVERS FOR DOS
  196. -------------------------------------------------------
  197.  
  198. After you have copied the appropriate audio device driver
  199. from the CD, edit the CONFIG.SYS file on your boot disk
  200. to include the following statement:
  201.  
  202. DEVICE=dir\device.SYS [audio] [dma] [int] [ioaddr] [bufsize]
  203. where:
  204.  
  205.      dir        =   the fully qualified name of the directory
  206.                     that you copied the device driver into
  207.      device.SYS =   one of the audio device drivers listed above
  208.  
  209.      audio, dma, int, ioaddr, and bufsize are options for the
  210.      device drivers.  If you do not specify a value for these
  211.      options, they keep their default values:
  212.  
  213.            OPTION                   DEFAULT
  214.  
  215.            audio                      1
  216.            dma                        1
  217.            int                        7
  218.            ioaddr                    220
  219.            bufsize                    4
  220.  
  221.      The options that you can specify depend on the type of audio
  222.      device you have.  The following list shows the options that
  223.      you can specify for each card.
  224.  
  225.     IBM Audio Capture/Playback Adapter, one option:
  226.  
  227.       audio      =   AUDIO device number
  228.  
  229.     SoundBlaster 1.0, 2.0 or compatible, four options:
  230.  
  231.      audio      =   AUDIO device number
  232.      int        =   interrupt level (IRQ) used by the SB card
  233.      ioaddr     =   I/O address used by the SB card
  234.      bufsize    =   I/O buffer size in kilobytes
  235.  
  236.     SoundBlaster PRO or PRO OPL/3, five options:
  237.  
  238.      audio      =   AUDIO device number
  239.      dma        =   DMA channel used by the SB card
  240.      int        =   interrupt level (IRQ) used by the SB card
  241.      ioaddr     =   i/o address used by the SB card
  242.      bufsize    =   i/o buffer size in kilobytes
  243.  
  244.     NOTE: THE AUDIO DEVICE DRIVERS FOR THE SOUNDBLASTER AND
  245.           SOUNDBLASTER COMPATIBLE CARDS DO NOT SUPPORT AN
  246.           IRQ HIGHER THAN 7.
  247.  
  248. The IBM PS/1 Audio/Joystick Adapter and the Digispeech DS-201A
  249. Adapter do not have any options for their device drivers.
  250.  
  251. After you have made any necessary changes to your CONFIG.SYS file,
  252. you must reboot your computer before they take effect.
  253.  
  254. After you have completed this installation procedure, make the
  255. CD drive your current drive and enter START to start the book.
  256.  
  257. 5.2  EXAMPLES OF AUDIO DEVICE DRIVERS FOR DOS
  258. ---------------------------------------------
  259.  
  260. The following is a list of some sample DEVICE= statements that
  261. you might want to include in your CONFIG.SYS file.  These
  262. samples assume that the appropriate device driver file from
  263. the CD was copied to the directory C:\LLHOME\AUDIODD.  Since
  264. these sample DEVICE= statements do not specify any options,
  265. the default values for the options are used.
  266.  
  267. Digispeech DS-201A:
  268.           DEVICE=C:\LLHOME\AUDIODD\DIGISP.SYS
  269.  
  270. IBM Audio Capture/Playback Adapter:
  271. IBM Audio Capture/Playback Adapter/A:
  272.           DEVICE=\LLHOME\AUDIODD\ACPAK12.SYS
  273.  
  274. IBM PS/1 Audio/Joystick Adapter:
  275.           DEVICE=\LLHOME\AUDIODD\PS1K12.SYS
  276.  
  277. Sound Blaster:
  278.   SoundBlaster 1.0, 2.0, and compatibles:
  279.           DEVICE=\LLHOME\AUDIODD\SNDBK12.SYS
  280.  
  281.   SoundBlaster 1.0, 2.0            (Not compatibles):
  282.           DEVICE=\LLHOME\AUDIODD\SBWD.SYS
  283.  
  284.   SoundBlaster PRO (also Pro OPL/3)(Not compatibles):
  285.           DEVICE=\LLHOME\AUDIODD\SBPWD.SYS
  286.  
  287.  
  288. The following are examples of device driver statements show the
  289. use of the options:
  290.  
  291.        DEVICE=C:\LLHOME\AUDIODD\ACPAK12.SYS 2
  292.  
  293. This assumes that the IBM Audio Capture/Playback Adapter is
  294. audio device 2 (AUDIO2$).
  295.  
  296.        DEVICE=C:\SBPWD.SYS 1 2 7 220 8
  297.  
  298. This assumes that the Sound Blaster Pro OPL/3 card is set at
  299. DMA=2, IRQ=5, I/O=220, buffer size of 8k, and addressed as device
  300. AUDIO1$.
  301.  
  302.        DEVICE=C:\SBWD.SYS 1 5 220 4
  303.  
  304. This assumes that the Sound Blaster card is set at IRQ=5, I/O=220,
  305. buffer size of 4k, and addressed as device AUDIO1$.  Notice that
  306. the DMA channel parameter is missing.  This is because DMA channel
  307. is fixed at 1 for non-SB PRO cards.
  308.  
  309.  
  310. 5.3 MANUAL INSTALLATION OF AUDIO DEVICE DRIVERS FOR OS/2
  311. --------------------------------------------------------
  312.  
  313. 1. Make a copy of the DOS full-screen icon.  Note you must
  314.    specify a new name for the icon.
  315.  
  316. 2. Click on this icon with the right mouse button to get the icon
  317.    menu.
  318.  
  319. 3. Select OPEN, and select SETTINGS from the OPEN menu.
  320.  
  321. 4. The SETTINGS folder for the icon appears.  Select the
  322.    SESSION page.
  323.  
  324. 5. On the SESSION page, select DOS SETTINGS.  A list of the
  325.    DOS settings for the icon appears.
  326.  
  327. 6. Select DOS_DEVICE from the list of DOS settings.  In the
  328.    value box that appears, put the complete file name of
  329.    audio device driver file that you copied from the CD.
  330.    For example, if you are using an IBM Audio Capture/Playback
  331.    Adapter, and you copied the device driver file to the
  332.    directory D:\LLHOME\AUDIODD, you would put the following
  333.    in the value box for DOS_DEVICE:
  334.  
  335.        D:\LLHOME\AUDIODD\ACPAK12.SYS
  336.  
  337. 7. Select INT_DURING_IO from the list of DOS settings and set
  338.    it to ON.
  339.  
  340. 8. Click on SAVE, and close the SETTINGS folder.
  341.  
  342. When this icon is opened, the resulting DOS full screen session
  343. will have audio support.
  344.  
  345. To start the book after completing this installation procedure:
  346.  
  347. 1. Open the icon you created.
  348.  
  349. 2. Make the CD drive your current drive.
  350.  
  351. 3. Enter START.
  352.  
  353. Only ONE of these sessions can be opened at a time because
  354. the audio card cannot be shared.
  355.  
  356. Do not run EXPERIENCE C++ in a window.  If you do, the colors
  357. will be incorrect and the performance will be severely degraded
  358. compared to a full-screen session.
  359.  
  360.  
  361. 6. AUDIO PROBLEMS
  362. -----------------
  363.  
  364. 6.1 INSTALLATION PROBLEMS
  365. -------------------------
  366.  
  367. If you complete the installation procedures and you find that
  368. there are problems with the audio, you many want to investigate
  369. the following symptoms and possible solutions:
  370.  
  371.  
  372.    *** SYMPTOM ***                 *** POSSIBLE SOLUTION ***
  373.  
  374. SOUNDBLASTER AND SOUNDBLASTER COMPATIBLE CARDS:
  375.  
  376. Scratchy sound                  - increase the buffer size
  377.                                   (last option specified with
  378.                                   the device driver file)
  379. No sound                        - check that the IRQ level option
  380.                                   is set to the IRQ level of your
  381.                                   card
  382.                                 - if your card is a genuine
  383.                                   SoundBlaster card, try the
  384.                                   SoundBlaster compatible device
  385.                                   driver file
  386. Audio getting chopped off       - increase the buffer size
  387.                                   (last option specified with
  388.                                   the device driver file)
  389.  
  390. DIGISPEECH CARDS:
  391.  
  392. No sound in DOS session         - depending on your configuration,
  393. under OS/2                        the Digispeech 201/A sound card
  394.                                   may not work in a DOS session
  395.                                   under OS/2.  Try installing it
  396.                                   in native DOS.
  397.  
  398. ALL CARDS:
  399.  
  400. System Error message appears    - you may get this kind of error
  401. when EXPERIENCE C++ started       if you have more than one
  402. in a full-screen DOS session      audio-enabled DOS session open
  403. from an OS/2 icon                 at the same time.  Try closing
  404.                                   one of the DOS sessions.
  405.  
  406. No audio in native DOS          - if you have another audio device
  407.                                   driver specified in your
  408.                                   CONFIG.SYS file before the
  409.                                   driver for EXPERIENCE C++, you
  410.                                   may not get any audio.  Edit
  411.                                   your CONFIG.SYS file, put REM
  412.                                   at the beginning of the DEVICE=
  413.                                   lines for other audio device
  414.                                   drivers, and reboot.
  415.  
  416. Audio getting cut off           - if you are using the book in
  417.                                   a full-screen DOS session under
  418.                                   OS/2, ensure that the DOS
  419.                                   settings for the session
  420.                                   include INT_DURING_IO=YES.
  421.                                   Also see AUDIO DATA OVERRUN
  422.                                   below.
  423.  
  424. 6.2 POSSIBLE AUDIO ERRORS
  425.  
  426. -------------------------
  427.  
  428. Audio errors can occur due to insufficient memory, a missing
  429. device driver or slow disk access. If an error occurs when audio
  430. is first played you will get one of the following errors.
  431.  
  432. E 01 SOUND OPEN error
  433. E 02 SOUND CREATE error
  434. E 03 DEVICE OPEN error
  435. E 04 XMIT ALLOC error
  436. E 05 REC ALLOC error
  437. E 06 DSP OPEN error
  438. E 07 DSP LENGTH error
  439. E 08 AUDIO DEVICE error
  440. E 09 IOCTL FUNC INVAL error
  441. E 10 IOCTL NO FREE HANDLE error
  442. E 11 IOCTL ACCESS DENIED error
  443. E 12 IOCTL INVALID HANDLE error
  444. E 13 IOCTL INVALID DATA error
  445. E 14 IOCTL INVALID DRIVE error
  446. E 15 IOCTL OTHER error
  447. E 16 INIT NO PLAY error
  448. E 17 INIT NO RECORD error
  449. E 18 INIT NO PLAY RECORD error
  450. E 19 INIT INVALID REQUEST error
  451. E 20 INIT CONFLICT error
  452. E 21 INIT OVERLOADED error
  453. E 22 INIT INVALID INPUT LIST error
  454. E 23 INIT INVALID OUTPUT LIST error
  455. E 24 INIT OTHER error
  456. E 25 AUDIO CONTROL error
  457.  
  458. The most common error is E 03 which means an audio device driver
  459. was not found. This must be installed as described above.
  460. EXPERIENCE C++ will run in closed-caption mode when no audio
  461. device driver is found. To run in closed-caption mode and avoid
  462. the error occurring, start EXPERIENCE C++ with one of the
  463. closed-caption commands such as CSTART.
  464.  
  465. AUDIO DATA OVERRUN
  466.  
  467. An AUDIO DATA OVERRUN error indicates that the data throughput
  468. required for audio could not be accommodated by the host CPU and
  469. disk drive.  On a PC running DOS this should not occur, but in
  470. running OS/2 this can happen due to other tasks consuming too much
  471. of the system resources.  The result is that audio files cannot
  472. be re-accessed in time to keep the audio playing, and the audio
  473. is cut off. Ending some of the other programs
  474. to relieve the CPU and disk load can help eliminate this problem.
  475.  
  476. OUT OF ENVIRONMENT SPACE
  477.  
  478. When starting EXPERIENCE C++ in caption-only mode, an environment
  479. variable (SET TMAUDIO=NO) is set in DOS.  If no environment space
  480. is left in your system you will get an "Out of Environment space"
  481. error. Use the DOS SHELL command in the CONFIG.SYS to increase the
  482. size of the environment space.
  483.  
  484. OUT OF MEMORY
  485.  
  486. If your system has insufficient available memory to run EXPERIENCE
  487. C++, look to removing TSR programs, loading device drivers in high
  488. memory and other such techniques as described in your DOS or OS/2
  489. documentation.
  490.  
  491.  
  492. 7. TRADEMARKS AND SERVICE MARKS
  493. -------------------------------
  494.  
  495. The following terms used in this file are trademarks
  496. or service marks of IBM Corporation in the United States
  497. or other countries:
  498.  
  499.    IBM
  500.    LinkWay
  501.    LinkWay Live!
  502.    Operating System/2
  503.    OS/2
  504.    Personal System/1
  505.    Personal System/2
  506.    PS/1
  507.    PS/2
  508.  
  509. The following terms in this file are trademarks or
  510. registered trademarks of the indicated companies:
  511.  
  512.    Borland        Borland International Inc.
  513.    Digispeech     Digispeech Inc.
  514.    Intel          Intel Corporation
  515.    Microsoft      Microsoft Corporation
  516.    Prosonus       Prosonus Corporation
  517.    SoundBlaster   Creative Labs, Inc. and Brown-Wagh Publishing
  518.    Turbo C++      Borland International Inc.
  519.    Visual C++     Microsoft Corporation
  520.  
  521.  
  522.