home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO030C.ZIP / PC-VCO22.ZIP / PC-VCO.DOC < prev    next >
Text File  |  1991-07-25  |  57KB  |  2,013 lines
  1. PC-VCO: IBM PC Visual Conferencing
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.              ----------------------------------
  24.              PC-VCO: IBM PC Visual Conferencing
  25.              ----------------------------------
  26.               Communications Accessory
  27.              ----------------------------------
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.     PC-VCO is distributed freely and may be copied by anyone for any
  36.     number of machines.  The author offers PC-VCO as "shareware".  If
  37.     the program is found to be useful or entertaining, a registration
  38.     of $50.00 is requested.  If response warrants, PC-VCO will be
  39.     enhanced and extended.    The author may be reached at:
  40.  
  41.  
  42.                  CABER Software
  43.                  R. (Scott) McGinnis
  44.                  P.O. Box 3607 Mdse Mart
  45.                  Chicago, IL 60654-0607
  46.  
  47.                  PLINK, GEnie id: TARTAN
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 2.2: 880705
  61.  
  62. PC-VCO: IBM PC Visual Conferencing
  63.  
  64.  
  65.  
  66.     PC-VCO version 2.2 is copyright 1988 CABER Software (R.  Scott
  67.     McGinnis).  All rights are reserved world wide, excepting redistri-
  68.     bution under the ShareWare concept.  PC-VCO is distributed freely
  69.     and may be copied by anyone for any number of machines, under the
  70.     ShareWare concept.
  71.  
  72.  
  73.     PC-VCO is distributed as ShareWare.  You may use PC-VCO without
  74.     charge for the purposes of evaluating it's usefulness to your
  75.     purposes.  It is suggested that this evaluation period be limited to
  76.     a few days of actual use.  If you find PC-VCO to be worth continued
  77.     use, then you are asked to pay for it.    The payment is called a
  78.     "registration fee".  Complete the included registration form and
  79.     mail it with your payment.
  80.  
  81.  
  82.     Registration of PC-VCO includes the communications program COM-AND,
  83.     all published accessory programs (which currently are CCHESS,
  84.     CBRIDGE, and CCOLOR), and several utilities (VCOLIB, VOICE, unPACKIT
  85.     and unSTUFIT).    COM-AND, accessories and utilities are published
  86.     separately.  One registration covers any and all of these programs.
  87.  
  88.  
  89.     By registering your copy of PC-VCO (or any ShareWare product), you
  90.     are promoting and supporting the convenient distribution method and
  91.     free evaluation policy that brought you this copy of PC-VCO.
  92.  
  93.  
  94.     If you have received this copy from a Users' Group, "Software
  95.     Library" or "SIG", and have paid a small fee (usually $3 to $10),
  96.     you have NOT acquired a registration or continued right to use
  97.     PC-VCO.  This fee was for the convenience of obtaining the diskette
  98.     with PC-VCO on it.  The fee does NOT apply to the registration fee.
  99.  
  100.  
  101.     You may NOT distribute PC-VCO or it's documentation in connection
  102.     with ANY commercial venture, product, publication or service without
  103.     written approval.  PC-VCO may not be disassembled or modified
  104.     without express written consent.
  105.  
  106.  
  107.     PC-VCO is supplied "as-is" with no warranties expressed or implied.
  108.     Neither CABER software nor the author will be liable for any damages
  109.     or lost revenues incurred through the use of this program or any of
  110.     its accessories and utilities beyond the registration price paid.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. Version 2.2; 880705
  122.  
  123. PC-VCO: IBM PC Visual Conferencing
  124.  
  125.  
  126.                  Table of Contents
  127.                  -----------------
  128.  
  129. I.    Introduction  .............................................. page 1
  130.  
  131. II.    Running the program  ....................................... page 3
  132.  
  133. III.    VCO Display  ............................................... page 6
  134.  
  135. IV.    Services supported ......................................... page 7
  136.  
  137. V.    PC-VCO Commands using COM-AND .............................. page 11
  138.  
  139. VI.    PC-VCO Commands Standalone ................................. page 13
  140.  
  141. VII.    PC-VCO Main Menu ........................................... page 14
  142.  
  143. VIII.    Newly Supported Systems .................................... page 16
  144.  
  145. IX.    Manual ICON Clean-up ....................................... page 17
  146.  
  147. X.    Program Configuration (Alt-S, and Alt-P) ................... page 18
  148.  
  149. XI.    Miscellaneous Functions .................................... page 21
  150.  
  151. XII.    Program Requirements ....................................... page 22
  152.  
  153. XIII.    Program and Author Information    ............................ page 23
  154.  
  155.  
  156.  
  157.                 Appendices
  158.                 ----------
  159.  
  160.  
  161. A.    Switches and Parameters .................................... page 24
  162.  
  163. B.    Speech Drivers ............................................. page 27
  164.  
  165. C.    Exception file ............................................. page 29
  166.  
  167. D.    Files ...................................................... page 30
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Version 2.2: 880705
  183.  
  184. PC-VCO: IBM PC Visual Conferencing                     Page   1
  185.  
  186.  
  187. I.    Introduction
  188.  
  189.  
  190.     A. What is PC-VCO?
  191.  
  192.  
  193.        PC-VCO for the IBM PC is an accessory program, intended to be
  194.        used with a 'base' communications program.  PC-VCO is integrated
  195.        into the included program 'COM-AND'.  However, PC-VCO may be used
  196.        with any comm program supporting a 'DOS gateway' that does not
  197.        break an established comm link.
  198.  
  199.  
  200.        PC-VCO, used with network conferencing services such as People-
  201.        Link's PARTY, CompuServe's CB and GEnie's RTC conferencing,
  202.        provides a way to 'see' and 'hear' people talking.
  203.  
  204.  
  205.        The idea for PC-VCO was derived from the VCO system, and its
  206.        predecessor/ancestor VMCO, developed for the MacIntosh computer.
  207.        The VCO programs (PC and MacIntosh) allow you to see the people
  208.        you communicate with on-line, using the graphic capabilities of
  209.        the personal computer, and to hear conversation with speech
  210.        synthesis.
  211.  
  212.  
  213.     B. MacIntosh VCO and VMCO
  214.  
  215.  
  216.        VCO was originally developed by Harry Chesley.  It was followed
  217.        by VMCO (which is CIS specific), written by Bob Perez independent
  218.        to the development of VCO.  The current (MacIntosh) version of
  219.        VCO is almost an exact duplicate of Harry Chesley's original -
  220.        the original source code was converted by Mike Cohen and made to
  221.        accept multiple service formats.  [Note:  Mike Cohen's VCO uses
  222.        VMCO formatted files.  Harry Chesley's VCO files differ.  PC-VCO
  223.        can accommodate either.  PC-VCO in VCO mode can talk to either,
  224.        according to your choice.]
  225.  
  226.  
  227.        The MacIntosh VCO allows one to see the people talking on-line
  228.        through graphic Icons.  The Icons are provided to the VCO program
  229.        as 'Resource files' and are built using a 'Resource Editor'.
  230.        Each VCO user must have a resource file for every potential other
  231.        speaker.  Charlie Brown and Snoopy Icons are used if no 'Faces'
  232.        are available.  A range of expressions, from 'normal' to bored to
  233.        surprised make VCO conferences lively.  Each participant controls
  234.        the expression displayed to all other participants.
  235.  
  236.  
  237.        The MacIntosh VCO allows the user to hear the people talking on-
  238.        line.  This is done through built-in digital to analog
  239.        conversion, and a text-to-speech processor.    Each VCO user
  240.        specifies the pitch of their voice, and the rate with which they
  241.        speak.  Sound effects are possible and used heavily, of course.
  242.  
  243. Version 2.2: 880705
  244.  
  245. PC-VCO: IBM PC Visual Conferencing                     Page   2
  246.  
  247.  
  248. I.    Introduction (continued)
  249.  
  250.  
  251.     C. This program
  252.  
  253.  
  254.        PC-VCO Version 2.2 executes VCO mode in CGA hi-res graphics mode,
  255.        Hercules graphics mode, or EGA graphics mode.  It displays faces
  256.        extracted from MacIntosh resource files.  A face librarian
  257.        (VCOLIB) has been included to maintain a library of faces and to
  258.        create face files for other PC-VCO and MacIntosh users.
  259.  
  260.  
  261.        Version 2.2 of PC-VCO interfaces both to a public domain resident
  262.        speech driver (whose pitch and speaking rate cannot be set), and
  263.        its own voice driver (which allows some variances in speaking rate
  264.        and pitch).    The voice quality of either is what might be expected
  265.        without digital-to-analog conversion.  However, the interface is
  266.        proven, and future versions will improve the interface.
  267.  
  268.  
  269.        PC-VCO may be copied freely and distributed to anyone for any
  270.        number of machines.    The author offers PC-VCO as "shareware".  If
  271.        the program is found to be useful or entertaining, a registration
  272.        is asked.  PC-VCO will be extended and enhanced if response
  273.        warrants.
  274.  
  275.  
  276.     D. This document
  277.  
  278.  
  279.        This document describes the features of PC-VCO.   It will not
  280.        attempt to describe all the features of COM-AND (which are
  281.        available within PC-VCO if used), or any other communications
  282.        program used.  From time-to-time the assumption will be made
  283.        that COM-AND is used as the communications program, to high-
  284.        light the interaction between PC-VCO and COM-AND.
  285.  
  286.  
  287.        Please do not take it that COM-AND is the only comm program
  288.        possible to use.  Refer to the documentation provided with your
  289.        favorite comm program for a full discussion of its function and
  290.        features.   They won't be available in PC-VCO, however.
  291.  
  292.  
  293.        Appendices here will provide details for very interested readers.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304. Version 2.2: 880705
  305.  
  306. PC-VCO: IBM PC Visual Conferencing                     Page   3
  307.  
  308.  
  309. II.    Running the program
  310.  
  311.  
  312.     PC-VCO is an accessory program, and may be entered in one of three
  313.     ways: (1) it may be invoked through the accessory menu of the comm
  314.     program COM-AND, (2) PC-VCO may be loaded itself (in which case it
  315.     will need to be able to load COM-AND) and (3) it may be loaded
  316.     'piggyback' (intended for use with the DOS gateway of other
  317.     communications programs.  Each method is useful and will be
  318.     discussed separately.
  319.  
  320.  
  321.     A. Loading through COM-AND
  322.  
  323.  
  324.        COM-AND is invoked at the DOS prompt with the command:
  325.  
  326.        ------------------------------------------------------
  327.        "d>" COM-AND <options>
  328.  
  329.        Where "d>" is the DOS prompt, and
  330.          <options> is (<parm> (<parm> ...))
  331.          where <parm> is either a switch or a parameter
  332.  
  333.        Refer to Appendix A of the COM-AND document for a discussion
  334.        of switches and parameters.
  335.        ------------------------------------------------------
  336.  
  337.  
  338.        Once COM-AND has been loaded, the usual sequence would be to dial
  339.        a network service using COM-AND's dialing directory or script
  340.        language.  When connection has been established, logon achieved,
  341.        and a conference area entered, then PC-VCO may be selected using
  342.        the F1 Accessories menu.
  343.  
  344.  
  345.        COM-AND defines an 'accessory' as:
  346.  
  347.        o       A name which is displayed in the menu (as you like)
  348.        o       A subdirectory for use during the accessory (optional)
  349.        o       A script file to be performed (optional)
  350.        o       A program to be loaded - along with parameters (optional)
  351.  
  352.        COM-AND was supplied with several accessory menu entries set to
  353.        load PC-VCO, to serve as an example.  Once loaded, PC-VCO is an
  354.        independent program, using the comm link established by COM-AND,
  355.        and also many of the COM-AND functions.  PC-VCO is 'integrated'
  356.        into COM-AND.
  357.  
  358.  
  359.        Note that settings (echo/blank line suppression/logging etc) made
  360.        in COM-AND carry over to the accessory when it is loaded, and
  361.        settings made in the accessory carry over to COM-AND when the
  362.        accessory terminates.
  363.  
  364.  
  365. Version 2.2: 880705
  366.  
  367. PC-VCO: IBM PC Visual Conferencing                     Page   4
  368.  
  369.  
  370. II.    Running the program (continued)
  371.  
  372.  
  373.     B. Loading PC-VCO directly
  374.  
  375.  
  376.        PC-VCO may be invoked at the DOS prompt with the command:
  377.  
  378.        ------------------------------------------------------
  379.        "d>" PC-VCO <options>
  380.  
  381.        Where "d>" is the DOS prompt, and
  382.          <options> is (<parm> (<parm> ...))
  383.          where <parm> is either a switch or a parameter
  384.  
  385.        Refer to Appendix A of this document for a full description of
  386.        switches and parameters.
  387.        ------------------------------------------------------
  388.  
  389.  
  390.        When PC-VCO is run from the DOS prompt without the '/P' switch,
  391.        it looks for the COM-AND program on the current subdirectory (or
  392.        in the subdirectory indicated by a 'COM-AND=' environment
  393.        variable).  PC-VCO will not run (without the '/P' switch) unless
  394.        it can find COM-AND.  PC-VCO loads COM-AND and execution proceeds
  395.        on the CRT (COM-AND side) of the program.
  396.  
  397.  
  398.        Again, the usual sequence would be to dial a network service
  399.        using COM-AND's dialing directory or script language.  When
  400.        connection has been established, logon achieved, and a conference
  401.        area entered, then PC-VCO may be invoked using the F1 key.
  402.  
  403.  
  404.        Loaded this way, the F1 key simply serves to switch between the
  405.        two sides of the program (PC-VCO and COM-AND).  No menu of
  406.        additional accessories is available.  All other features of
  407.        COM-AND are available, however.
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426. Version 2.2: 880705
  427.  
  428. PC-VCO: IBM PC Visual Conferencing                     Page   5
  429.  
  430.  
  431. II.    Running the program (continued)
  432.  
  433.  
  434.     C. Loading PC-VCO Piggyback
  435.  
  436.  
  437.        PC-VCO may be run piggyback as follows:
  438.  
  439.        ------------------------------------------------------
  440.        "d>" PC-VCO /P COMx <speed> <other options>
  441.  
  442.        where COMx = COM1, COM2, COM3 or COM4 and
  443.           <speed> = 300, 1200, 2400, 4800, 9600
  444.  
  445.        Refer to Appendix A of this document for a full description
  446.        of other options.
  447.        ------------------------------------------------------
  448.  
  449.        For example:
  450.  
  451.            C> PC-VCO /P COM1 2400
  452.  
  453.  
  454.        Used in this manner, PC-VCO 'picks-up' a comm line already
  455.        opened and in use by another program.  The 'COMx' and '<speed>'
  456.        parameters are not strictly necessary; however, their use is
  457.        recommended unless you ALWAYS use the same comm port and line-
  458.        speed on all systems where ever you go.
  459.  
  460.  
  461.        Note that Alt-X terminates PC-VCO and simply returns you to
  462.        DOS when PC-VCO is loaded piggyback.  Alt-X terminates both
  463.        PC-VCO and COM-AND when the program set is run without /P.
  464.  
  465.  
  466.        Once back at the DOS prompt, you must return to the comm program
  467.        you originally gatewayed - type 'EXIT' at the DOS prompt if your
  468.        gateway was originally to COMMAND.COM.  Refer to the documenta-
  469.        tion provided with your comm program on the appropriate means of
  470.        returning from a gateway.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487. Version 2.2: 880705
  488.  
  489. PC-VCO: IBM PC Visual Conferencing                     Page   6
  490.  
  491.  
  492. III.    VCO Display
  493.  
  494.  
  495.     When the screen is placed into graphic (VCO) mode, the screen is
  496.     divided into several areas.  The top line carries the program
  497.     version and release number, the current 'expression mode' and the
  498.     VCO Main menu.    The next eight lines (of text if we were in text
  499.     mode) carries Icons for 10 (potential) people (faces).
  500.  
  501.  
  502.     Initially the Icons are displayed as empty chairs.  A large (double
  503.     wide ICON) box beneath the 10 empty chairs will be the speaker's
  504.     box.  [This does not appear if the program was run with the /M
  505.     switch.]  The Icon of the current Speaker will be displayed here.
  506.     The conversation scrolls in the region to the right of the Speaker's
  507.     box (the bottom line of the text area being reserved for program
  508.     use).
  509.  
  510.  
  511.     Beneath this activity are Icons for 10 more people.  [These do not
  512.     appear if the program was run with the /S switch - the space is made
  513.     available for more text lines.]  Icons are used in simple sequential
  514.     order, as new people speak.  Icons which are 'in use' may be deleted
  515.     - say, if the individual has left the area.  Under certain
  516.     conditions, PC-VCO will delete an ICON itself.
  517.  
  518.  
  519.     In conversation, when a speaker is identified (through the ID or
  520.     handle - see following), one of several things may happen:
  521.  
  522.     . If we've never seen the ID before, and we have an empty chair:
  523.  
  524.        The first empty chair Icon is replaced by an Icon representing
  525.        the new speaker with a 'normal' expression.  The Icon is also
  526.        displayed in the Speaker's box (reversed - we've never seen the
  527.        person before).  Notice the difference between speaking and
  528.        sitting ICONS.
  529.  
  530.     . If we've never seen the ID before, and we have no empty chair:
  531.  
  532.        An Icon representing the Speaker with a 'Normal' expression is
  533.        displayed in the Speaker's box.
  534.  
  535.     . If we've seen the ID before:
  536.  
  537.        The Icon of the speaker is displayed in the speaker's box (not
  538.        reversed - we've seen 'em before) and the Icon above or below is
  539.        reversed.
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548. Version 2.2: 880705
  549.  
  550. PC-VCO: IBM PC Visual Conferencing                     Page   7
  551.  
  552.  
  553. IV.    Services supported
  554.  
  555.  
  556.     PC-VCO is encoded to work with several network services and multi-
  557.     user systems.  PC-VCO parses every incoming line for an ID.
  558.     PC-VCO's parser is 'automatic', in that you don't have to tell it
  559.     which system to parse.
  560.  
  561.  
  562.     The ID or handle parse begins after a carriage return from the
  563.     network.  The Icon display is updated as soon as an ID is identi-
  564.     fied.  The text is displayed in any case.  If no ID is identified,
  565.     no ICON is changed.  Blank lines (extra carriage returns issued by
  566.     the network) are not displayed by PC-VCO because of the limited text
  567.     area (7 lines on a CGA with 'small table off).
  568.  
  569.  
  570.     VCO internal commands (such as expression changes) exchanged amongst
  571.     VCO attendees are not displayed as text of a conversation.  PC-VCO
  572.     does not know if a text line is empty or not until the entire line
  573.     is received.  PC-VCO erases an empty text line (visible as an ID
  574.     followed by no text or followed by just a VCO command) and reuses
  575.     the line when end-of-line (carriage return) is received.
  576.  
  577.  
  578.     The PC-VCO parser is only designed to deal with text issued within
  579.     the conversational area of one of the systems.    The parser is
  580.     self-adjusting ...  all of the supported formats will be taken as
  581.     conversation.  [The automatic nature of the parser DOES produce
  582.     some false hits now and then.  I've included some 'ignore'
  583.     templates in the parser table for just that purpose.]
  584.  
  585.  
  586.     The VCO side is not altogether appropriate for other uses, such as
  587.     reading your mail.  For other uses, switch to the alpha side (F1 if
  588.     you used COM-AND).
  589.  
  590.  
  591.     The following pages describe templates for IDs and handles as dis-
  592.     played on various systems (handles are assumed names which replace
  593.     or add to an ID).  I have also included some notes on each system
  594.     and its use with PC-VCO.
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609. Version 2.2: 880705
  610.  
  611. PC-VCO: IBM PC Visual Conferencing                     Page   8
  612.  
  613.  
  614. IV.    Services supported (continued)
  615.  
  616.  
  617.     A. PLINK IDs and handles:
  618.  
  619.           "(" <ID> ") "          an initial "*" identifies handles
  620.  
  621.        Example:  (TARTAN) This is how a line would look on PLINK
  622.  
  623.  
  624.        PLINK does not report (to all in conference) when a customer
  625.        exits.  Therefore PLINK users use "-OFF-" as their last statement
  626.        to 'clear' their ICON on other screens, as a courtesy.  PC-VCO
  627.        recognizes "-OFF-" as an indication that the customer's ICON is
  628.        to be deleted.
  629.  
  630.        PC-VCO is best used with echo off (the system doesn't echo what
  631.        you type).  You turn echo off with the command /NOECHO.  The key-
  632.        board buffer (controls pull-down) allows you to see your typing
  633.        locally if you need.
  634.  
  635.  
  636.     B. GEnie IDs and handles:
  637.  
  638.           "<" [Handle] <ID> "> "
  639.  
  640.        Example:  <[Scott] TARTAN> This is how a line would look on GEnie
  641.  
  642.  
  643.        GEnie reports to all present the exit or termination of another
  644.        customer.  PC-VCO recognizes the report, and automatically
  645.        deletes the ICON.
  646.  
  647.        PC-VCO is best used with echo off (the system doesn't echo what
  648.        you type).  GEnie does not normally echo entered characters.  If
  649.        you are echoing characters locally (alt-E) turn it off.  Use the
  650.        keyboard buffer to see your typing.
  651.  
  652.  
  653.     C. SOURCE IDs and aliases:
  654.  
  655.            <ID/alias> ": "    -or-   [nn] <ID/alias> ": "
  656.  
  657.        Example:  [22] TARTAN:  This is how a line would look on SOURCE
  658.  
  659.  
  660.        The SOURCE reports to all attending the exit or termination of
  661.        another customer.  PC-VCO recognizes the report, and automati-
  662.        cally deletes the ICON.
  663.  
  664.        PC-VCO is best used with echo off (the system doesn't echo what
  665.        you type).  The SOURCE allows you to turn off echo by exiting the
  666.        SIG (entering command mode), setting half duplex (-> TERM -HALF)
  667.        and reentering the SIG.
  668.  
  669.  
  670. Version 2.2: 880705
  671.  
  672. PC-VCO: IBM PC Visual Conferencing                     Page   9
  673.  
  674.  
  675. IV.    Services supported (continued)
  676.  
  677.  
  678.     D. CIS handles:
  679.  
  680.           "(" <Band> , <ID> ") "
  681.                where <Band> ::= (A!B)(N!NN)","
  682.  
  683.        Example:  (A1,TARTAN) This is how a line would look on CIS
  684.  
  685.  
  686.        CIS does not report (to all in conference) when a customer exits.
  687.        Therefore CIS users use "-OFF-" (or other methods) as their last
  688.        statement to 'clear' their ICON on other screens, as a courtesy.
  689.        PC-VCO recognizes "-OFF-" as an indication that the customer's
  690.        ICON is to be deleted.
  691.  
  692.        PC-VCO is best used with echo off (the system doesn't echo what
  693.        you type).  You turn echo off with the command /NOECHO.  The key-
  694.        board buffer (controls pull-down) allows you to see your typing
  695.        locally if you need.
  696.  
  697.  
  698.     E. Delphi IDs and handles:
  699.  
  700.           <ID> "> "     where an initial "." identifies handles
  701.  
  702.        Example:  TARTAN> This is how a line would look on Delphi
  703.  
  704.  
  705.        Delphi does not report (to all in conference) when a customer
  706.        exits.  Therefore Delphi users use "-OFF-" (or other methods) as
  707.        their last statement to 'clear' their ICON on other screens, as a
  708.        courtesy.  PC-VCO recognizes "-OFF-" as an indication that the
  709.        customer's ICON is to be deleted.
  710.  
  711.        PC-VCO is best used with echo off (the system doesn't echo what
  712.        you type).  I recommend requesting help from an experienced
  713.        Delphi user to do this.
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731. Version 2.2: 880705
  732.  
  733. PC-VCO: IBM PC Visual Conferencing                     Page  10
  734.  
  735.  
  736. IV.    Services supported (continued)
  737.  
  738.  
  739.     F. TBBS IDs:
  740.  
  741.           "(" <node> ":" <ID> ") "
  742.  
  743.        Example:  (9:  Scott McGinnis) This is how tbbs looks
  744.  
  745.  
  746.        TBBS does not report (to all in conference) when a customer
  747.        exits.  Therefore TBBS users use "-OFF-" (or other methods) as
  748.        their last statement to 'clear' their ICON on other screens, as a
  749.        courtesy.  PC-VCO recognizes "-OFF-" as an indication that the
  750.        customer's ICON is to be deleted.
  751.  
  752.        TBBS is still new to me; TBBS BBS's are multiuser (up to 16 lines
  753.        to a BBS), and provide a very comfortable conferencing facility.
  754.        I haven't discovered yet how to turn local echo off.  PC-VCO is
  755.        best used with echo off - if there is no such facility, I am sure
  756.        one will be added, just to keep the reading easy.
  757.  
  758.  
  759.     G. PROTOCALL IDs and handles:
  760.  
  761.            "<" nn.nn <ID> ">"
  762.  
  763.        Example:  <04.21 TARTAN> This is how PROTOCALL looks
  764.  
  765.  
  766.        PROTOCALL reports to all attending the exit or termination of
  767.        another customer and various materializations and dematerializ-
  768.        ations.  PC-VCO recognizes the report, and automatically deletes
  769.        the ICON.
  770.  
  771.        PC-VCO is best used with echo off (the system doesn't echo what
  772.        you type).  You toggle echo off with the command /ECHO.  The
  773.        keyboard buffer (controls pull-down) allows you to see your
  774.        typing locally if you need.
  775.  
  776.  
  777.        I know that PROTOCALL is no more.  However, the parser still
  778.        parses its format.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792. Version 2.2: 880705
  793.  
  794. PC-VCO: IBM PC Visual Conferencing                     Page  11
  795.  
  796.  
  797. V.    PC-VCO Commands using COM-AND
  798.  
  799.  
  800.     When PC-VCO is loaded with COM-AND the following Alt'd keys are
  801.     available:
  802.  
  803.     F1    Switch between text (CRT) and graphic (VCO) modes.  The
  804.         switch always clears the table of Icons and IDs, so a switch
  805.         from VCO to CRT and back will always clear a clutter.
  806.  
  807.     F10    Help screen.  All currently implemented commands are
  808.         summarized on this screen.  Any command may be executed
  809.         directly while this screen is displayed.
  810.  
  811.     Alt-F10 DOS Gateway.  If there is sufficient memory available, and
  812.         if the environment variable "COMSPEC" identifies a valid
  813.         .COM or .EXE file, PC-VCO will load the program and execute
  814.         it.  This normally is used to load a second copy of
  815.         COMMAND.COM for full access to DOS while a communication
  816.         session is in progress.
  817.  
  818.     Ctl-End Send a Break.  This sends a true 'break' signal.
  819.  
  820.     Alt-B    Redisplay (backscreen).  The speed of the display may be
  821.         controlled using Cntl-PgDn (slower) or Cntl-PgUp (faster).
  822.  
  823.     Alt-C    Clear the screen.
  824.  
  825.     Alt-D    Dialing directory.  The Dialing directory and file is
  826.         identical to that used by Procomm (version 2.x), to allow
  827.         files to be shared between the two programs.
  828.  
  829.     Alt-E    Toggle echo (full/half duplex).  This function is also
  830.         invoked through the dialing directory (echo on).
  831.  
  832.     Alt-F    File directory.  A mask is required - just as DOS DIR
  833.         command.
  834.  
  835.     Alt-G    Toggle blank line suppression.    PC-VCO will suppress blank
  836.         lines on the CRT side if you wish.  This can be made a
  837.         program default through the Alt-O options menu.
  838.  
  839.     Alt-H    Hang-up.  Hang-up the phone.
  840.  
  841.     Alt-I    Program information.  Author information.  Propaganda.
  842.  
  843.     Alt-L    Toggle CGA/EGA modes (if you have an EGA).
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. Version 2.2: 880705
  854.  
  855. PC-VCO: IBM PC Visual Conferencing                     Page  12
  856.  
  857.  
  858. V.    PC-VCO Commands using COM-AND (continued)
  859.  
  860.  
  861.     Alt-M    Define a macro for Alt-0 through Alt-9.  The Macro defin-
  862.         ition file is identical to that used by Procomm (version
  863.         2.x), allowing Macros to be shared between the two.
  864.  
  865.         Note: Although this menu can be used from either COM-AND or
  866.         accessory, macros are defined through COM-AND and changes
  867.         will be made on the COM-AND side.
  868.  
  869.     Alt-O    Options.  Set controlling flags for COM-AND.
  870.  
  871.         Note: Although this menu can be used from either COM-AND or
  872.         accessory, it really only effects COM-AND settings.
  873.  
  874.     Alt-P    Comm Parameters.  Set baud rate, parity, number of data
  875.         and stop bits for use when COM-AND is initially loaded.
  876.         These settings are overridden by run-time switches.
  877.         Whatever the current setting, the dialing directory
  878.         overrides when it is used.
  879.  
  880.         Note: Although this menu can be used from either COM-AND or
  881.         accessory, it really only effects COM-AND settings.  Each
  882.         accessory has an Alt-P function as well accessible only when
  883.         the accessory is loaded with the '/P' switch.
  884.  
  885.     Alt-R    Redial the last number dialed.    The program will redial the
  886.         last number dialed number until the function is terminated
  887.         (with ESC), or connection is made.
  888.  
  889.     Alt-S    Setup.    Define initial program values, such as Modem initial-
  890.         ization, the Modem Hangup sequence, and file names.
  891.  
  892.         Note: Although this menu can be used from either COM-AND or
  893.         accessory, it really only effects COM-AND settings.  Each
  894.         accessory has an Alt-S function as well which may or may not
  895.         be accessible when COM-AND is loaded.
  896.  
  897.     Alt-T    Elapsed time.  The time the program was loaded, and the time
  898.         the last call (Alt-C or Alt-R) was placed are displayed.
  899.         The elapsed time since the latest time is also displayed.
  900.  
  901.     Alt-X    Exit the program.  The program may or may not hangup the
  902.         phone, depending on the modem.    Note: COM-AND is also
  903.         terminated, no matter how you loaded PC-VCO and COM-AND.
  904.  
  905.     Alt-Z    Toggle parity mask.  The high bit mask is used only for text
  906.         received and displayed - it has no effect on XMODEM
  907.         transfers.
  908.  
  909.     Alt-0/9 Send a Macro.  A string of characters defined through the
  910.         Alt-M command described above is transmitted.
  911.  
  912.  
  913.  
  914. Version 2.2: 880705
  915.  
  916. PC-VCO: IBM PC Visual Conferencing                     Page  13
  917.  
  918.  
  919. VI.    PC-VCO Commands Standalone
  920.  
  921.  
  922.     When PC-VCO is loaded standalone (piggyback, /P) only the following
  923.     Alt'd keys are active:
  924.  
  925.     Alt-C    Screen Clear.  Clear the text area.
  926.  
  927.     Alt-L    Toggle between CGA and EGA modes (if you have an EGA).
  928.  
  929.     Alt-S    Setup.    This menu allows setting a defaults used by PC-VCO.
  930.         It is also available through the 'Controls' pull-down.
  931.  
  932.     Alt-P    Set Comm Parms.  This menu provides a way to change default
  933.         communications parameters used by PC-VCO ONLY when it is run
  934.         piggyback.  It is therefore only available when PC-VCO is
  935.         run piggyback.
  936.  
  937.     Alt-X    Exit the program.  In this case (piggyback) only PC-VCO is
  938.         terminated.  You are returned to DOS.
  939.  
  940.  
  941.     When used in this manner, the pull-down menues are still available,
  942.     of course.  Transcripting is the only function obtained through a
  943.     pull-down that is inhibited when PC-VCO is run piggyback.
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975. Version 2.2: 880705
  976.  
  977. PC-VCO: IBM PC Visual Conferencing                     Page  14
  978.  
  979.  
  980. VII.    PC-VCO Main Menu
  981.  
  982.  
  983.     On the top line of the display in VCO mode there is a menu of key-
  984.     words.    A keyword is selected (with the cursor keys or a mouse),
  985.     and a submenu pulled-down (with the return or right mouse button).
  986.     Submenu items are selected (again, with the cursor keys or a
  987.     mouse), and executed (with the return, space bar, or left mouse
  988.     button).  The keywords are:
  989.  
  990.     Controls    Select certain control functions.  Controls are:
  991.  
  992.             .  Playback:  Play a transcript
  993.             .  Turn Transcript logging on and off.
  994.             .  Turn keyboard display on and off.
  995.             .  Turn transcript hold on and off.
  996.             .  Change expression set (PLINK/CIS, GEnie/STC/Delphi)
  997.             .  Turn Speaker's Box on and off.
  998.             .  Turn Small Table on and off.
  999.             .  Invoke PC-VCO's Setup menu
  1000.  
  1001.     Sounds        Issue 'sound' commands to the conference (and to
  1002.             yourself, unless you've disabled 'bounceback').
  1003.             The current selections are clunky... they'll get
  1004.             better as time goes on.  You can also enable and
  1005.             disable received sounds (Quiet mode) here.
  1006.  
  1007.     Speech        Turn the speech driver on (two modes) and off.
  1008.             SPEECH.COM must be loaded prior to PC-VCO.
  1009.             VOICE.EXE will be loaded on demand if available.
  1010.  
  1011.             .  Explicit speech means: only specific command
  1012.                forms are voiced (e.g. "{GRUNT").
  1013.             .  Implicit speech means: All received text is
  1014.                voiced.
  1015.  
  1016.     Faces        Issue 'expression' commands to the conference.  This
  1017.             causes the Icon displayed for your ID to be changed
  1018.             on your screen, and on any other screen receiving
  1019.             your command.
  1020.  
  1021.  
  1022.     Top-line menu items are selected with the Cursor right/left keys or
  1023.     right and left motion with the mouse.  When the cursor key is
  1024.     depressed, the next menu item (in a circular manner) is highlighted.
  1025.     The highlighted keyword is 'selected'.
  1026.  
  1027.  
  1028.     A submenu is pulled-down with the Cursor-down key (or End, or PgDn,
  1029.     or the left mouse button).  A submenu item is selected from a
  1030.     pull-down when it is highlighted by pressing the Cursor-down/up keys
  1031.     keys repetitively.  When the Cursor key is depressed, the next submenu
  1032.     item (again in a circular manner) is highlighted.  The highlighted
  1033.     keyword is 'selected'.
  1034.  
  1035.  
  1036. Version 2.2: 880705
  1037.  
  1038. PC-VCO: IBM PC Visual Conferencing                     Page  15
  1039.  
  1040.  
  1041. VII.    PC-VCO Main Menu (continued)
  1042.  
  1043.  
  1044.     A selected submenu item is executed with a Carriage Return.  That's
  1045.     the key with the silly arrow.  When a submenu item is executed, the
  1046.     pull-down is released (it goes back up?).  Hitting the Space-bar or
  1047.     the left mouse button will also execute the selected item.  A
  1048.     pull-down is released without executing any item with any of the
  1049.     following keys:  ESC, Home, PgUp, or right mouse button.
  1050.  
  1051.  
  1052.     There are three forms of VCO in use on Macintosh computers.  The
  1053.     three programs use two different file formats for face files.
  1054.     PC-VCO can accommodate both file formats.  It can speak to all the
  1055.     MacIntosh programs over a network (one type at a time, of course).
  1056.  
  1057.  
  1058.     VCO, as written by Harry Chesley is currently in use on Delphi and
  1059.     GEnie.    This is the original VCO program.  The face file defined for
  1060.     Harry Chesley's program is not the format PC-VCO was originally
  1061.     written to accommodate. However, Version 2.2 of PC-VCO will accept
  1062.     Chesley formatted face files, and switch expression sets at will.
  1063.  
  1064.  
  1065.     VMCO was written independent of, but with knowledge of Harry
  1066.     Chesley's VCO by Bob Perez.  VMCO defined a slightly different face
  1067.     file format.  VMCO is currently in use on CIS.    PC-VCO has always
  1068.     been compatible with VMCO.  However, it is not the program PC-VCO
  1069.     was written to match.
  1070.  
  1071.  
  1072.     Harry Chesley's original VCO was modified by Mike Cohen to parse
  1073.     PLINK ID's.  The VMCO face file format was used for this version.
  1074.     This is the version of VCO that PC-VCO was coded to match.
  1075.  
  1076.  
  1077.     On the top line of the VCO screen, the expression set currently in
  1078.     use is displayed (either 'PLINK/VCO' or 'GEnie/STC/Delphi').  The
  1079.     mode may be dynamically changed through the 'Controls' pull-down.
  1080.     The mode in effect when the program is loaded defaults to PLINK/CIS,
  1081.     but the default may be permanently changed through the Alt-O
  1082.     (Options) Menu (see below), or through a run-time switch (see
  1083.     Appendix A).
  1084.  
  1085.  
  1086.     Understand, please, that different expression sets are defined by
  1087.     the face file.    All users (Macintosh especially) must be using
  1088.     compatible sets for expressions to be exchanged meaningfully.  VMCO
  1089.     and Mike Cohen's VCO use different expression commands from Harry
  1090.     Chesley's VCO.  PC-VCO can talk to one group or the other.  But not
  1091.     both at the same time.    Users of Harry Chesley's VCO cannot talk to
  1092.     users of Mike Cohen's VCO, or to users of VMCO (and exchange
  1093.     expressions).
  1094.  
  1095.  
  1096.  
  1097. Version 2.2: 880705
  1098.  
  1099. PC-VCO: IBM PC Visual Conferencing                     Page  16
  1100.  
  1101.  
  1102. VIII.    Newly Supported Systems
  1103.  
  1104.  
  1105.     With the release of Version 1.0 PC-VCO, several systems are
  1106.     supported that are not mentioned above (or in VCOLIB).    PC-VCO
  1107.     Version 2.1 supports TBBS, and PROTOCALL services as well as PLINK,
  1108.     GEnie, SOURCE, CIS, and Delphi, but neither the Main Menu of PC-VCO
  1109.     nor the VCOLIB output command prompt mentions the two new services.
  1110.     There is a reason...
  1111.  
  1112.  
  1113.     MacIntosh VCO/VMCO users actually use THREE resource file formats.
  1114.     [The above discussion might lead one to suspect that there are two,
  1115.     but there are actually three.]    VCOLIB recognizes all three on
  1116.     input, and can output a file in any of the forms.
  1117.  
  1118.  
  1119.     Online, there are two differing sets of control sequences (one for
  1120.     PLINK/CIS and another for GEnie/Delphi).  PC-VCO requires users to
  1121.     switch to the set appropriate for the system.  MacIntosh users
  1122.     cannot do the same.  [There are three programs, after all.]
  1123.  
  1124.  
  1125.     Users on the newly supported services must decide which MacIntosh
  1126.     user community with which they wish to be compatible.  All three
  1127.     have MacIntosh as well as IBM PC users.  Harry Chesley has provided
  1128.     (or will provide) a version of his VCO modified for SOURCE users.
  1129.     For PROTOCALL and TBBS users no clear choice is available (now).
  1130.  
  1131.  
  1132.     Users on each system where PC-VCO is used must decide which form
  1133.     (Chesley (GEnie/Delphi), Perez (CIS), or Cohen (PLINK/CIS/Delphi)
  1134.     they wish to 'standardize'.  Most of the decision depends upon
  1135.     whether MacIntosh users are to be included easily.  When a decision
  1136.     is reached on each of the above systems by the user community, I
  1137.     will add the appropriate main Menu legend and prompt to the VCOLIB
  1138.     OUTPUT command.
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158. Version 2.2: 880705
  1159.  
  1160. PC-VCO: IBM PC Visual Conferencing                     Page  17
  1161.  
  1162.  
  1163. IX.    Manual ICON Clean-up
  1164.  
  1165.  
  1166.     Other keys that are active on the VCO screen alone are:
  1167.  
  1168.  
  1169.     DEL    Select an Icon for removal.  Press the DEL key, and an 'X'
  1170.         covers the next Icon around the table.    Move the 'X' to the
  1171.         Icon to be deleted (e.g. the speaker has left).  The Icon
  1172.         is then deleted with the INS key.
  1173.  
  1174.     INS    Delete the selected Icon.  The Icon is replaced with the
  1175.         empty chair Icon, and the ID of the person represented
  1176.         is removed from the program's tables.  If no Icon is
  1177.         selected, the program beeps.
  1178.  
  1179.  
  1180.     PC-VCO implements an autodelete function that automatically removes
  1181.     ICONs of people that have left the conversation.  VCO users on
  1182.     PLINK and CIS enter "-OFF-" alone on a line to signal that they are
  1183.     leaving.  GEnie users rely on the system reporting that "<ID> has
  1184.     left." or that "<ID> disconnected.".  PC-VCO recognizes these
  1185.     strings, and automatically deletes the appropriate ICON.
  1186.  
  1187.  
  1188.     Special keys (i.e. non-ASCII) will be implemented as control keys
  1189.     as requirements and experience dictate.  Unimplemented keys beep.
  1190.  
  1191.     -----------------------------------------------------------------
  1192.     Note also functions defined above under "Commands using COM-AND".
  1193.     -----------------------------------------------------------------
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219. Version 2.2: 880705
  1220.  
  1221. PC-VCO: IBM PC Visual Conferencing                     Page  18
  1222.  
  1223.  
  1224. X.    Program Configuration (Alt-S, and Alt-P)
  1225.  
  1226.  
  1227.     A. Setup Screen (Alt-S)
  1228.  
  1229.        1. Files
  1230.  
  1231.           . Face library
  1232.  
  1233.         The face library is built and maintained through the VCOLIB
  1234.         face librarian program.  MacIntosh resource files are added
  1235.         to this file to add faces to the VCO side of this program.
  1236.         This file defines the set of faces 'known' to the VCO side.
  1237.  
  1238.           . Exception file
  1239.  
  1240.         The exception file name is used when voice is turned on.  If
  1241.         it does not exist, none will be created.  You can create one
  1242.         by following the rules in Appendix D of this document.
  1243.         Something towards an exception file is provided in the
  1244.         release ARC.
  1245.  
  1246.        2. Timings and Values
  1247.  
  1248.           . Millisecond loop
  1249.  
  1250.         The millisecond loop value gives the number of LOOP instruc-
  1251.         tions required to wait for one millisecond.  This type of
  1252.         timing function is used in PC-VCO in several places: 1) to
  1253.         to pace displays such as playback, and 2) for tone
  1254.         generation.  260 is suggested for 4.77 Mhz clocks.  432 is
  1255.         recommended for 8Mhz clocks.  PC-VCO will attempt to
  1256.         calculate the correct value if you set it smaller than 10.
  1257.  
  1258.           . Break delay
  1259.  
  1260.         As noted above, the break delay is controlled through the
  1261.         Millisecond loop value.  This value "break delay"
  1262.         specifies the number of "milliseconds" the comm line is
  1263.         held when a break is issued (Cntl-END).
  1264.  
  1265.        3. Flags
  1266.  
  1267.           . Small Table
  1268.  
  1269.         Version 2.2 of PC-VCO provides two basic screens: a 20 ICON
  1270.         mode (with 7 lines of text on a CGA) and a 10 ICON mode
  1271.         (with 15 lines of text on a CGA).  The 10 ICON mode I've
  1272.         dubbed 'Small table'.  You can turn it off and on for the
  1273.         next time you use this program.
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280. Version 2.2: 880705
  1281.  
  1282. PC-VCO: IBM PC Visual Conferencing                     Page  19
  1283.  
  1284.  
  1285. X.    Program Configuration (continued)
  1286.  
  1287.  
  1288.     A. Setup Screen (Alt-S) (continued)
  1289.  
  1290.        3. Flags (continued)
  1291.  
  1292.           . Use GEnie/Delphi
  1293.  
  1294.         This flag determines which on-line command mode PC-VCO will
  1295.         by default use (as discussed above).  The mode can be
  1296.         changed on-line with the 'Controls' pull-down.
  1297.  
  1298.           . Quiet Mode
  1299.  
  1300.         For gentler souls, sound effects can be inhibited by default
  1301.         through this selection.
  1302.  
  1303.           . Speaker box
  1304.  
  1305.         'Maug mode' mentioned above, does not use the speaker's box.
  1306.         The advantage of this usage is that there is more text on a
  1307.         line.  You can select the default you wish to have here, and
  1308.         change it on-line as you wish.
  1309.  
  1310.           . Initial advert
  1311.  
  1312.         I have to advertise.  You have to hate it.  That's life.
  1313.         Even though I've named my company after a big stick, I don't
  1314.         have to beat you to death with it.  Turn off the advert
  1315.         after you've seen it.  Just before you register...
  1316.         This only effects standalone usage.
  1317.  
  1318.           . Exit Query
  1319.  
  1320.         Some people disdain the query "do you really and truly mean
  1321.         it" when they type Alt-X.  Some feel it mandatory.  PC-VCO
  1322.         is distributed with exit query disabled.  You may enable it,
  1323.         if you're so inclined.  This only effects standalone usage.
  1324.  
  1325.           . Allow EGA
  1326.  
  1327.         You can disable automatic selection of EGA mode (for what
  1328.         ever reason, say, it doesn't work on your EGA board) when
  1329.         PC-VCO is loaded with this setting.  Alt-L toggling between
  1330.         EGA and CGA modes is not affected by this setting.
  1331.  
  1332.  
  1333.        4. Save
  1334.  
  1335.           You may change values for one execution of PC-VCO, or you
  1336.           may change them for all subsequent executions of PC-VCO.    If
  1337.           you save values, the values you've saved will be used the
  1338.           next time you run PC-VCO.
  1339.  
  1340.  
  1341. Version 2.2: 880705
  1342.  
  1343. PC-VCO: IBM PC Visual Conferencing                     Page  20
  1344.  
  1345.  
  1346. X.    Program Configuration (continued)
  1347.  
  1348.  
  1349.     B. Communications Parameters (Alt-P)
  1350.  
  1351.        1. Rate + Parity + Data bits + Stop Bits
  1352.  
  1353.           Baud rate, parity, number of data bits and number of stop bits
  1354.           are specified in combination through the first 10 selections
  1355.           on the Alt-P window.  These selections are the only way you
  1356.           may specify baud rate.  Other parameters (parity, data bits,
  1357.           and stop bits) may be set individually (below).
  1358.  
  1359.           Do not change the current setting after you've connected to a
  1360.           service.    Make your setting here before you use PC-VCO
  1361.           on-line.
  1362.  
  1363.        2. Parity, Data bits and Stop bits
  1364.  
  1365.           Individual settings for parity, number of data bits and number
  1366.           of stop bits comprise the next 7 items of this menu.  You also
  1367.           set these values when you create a dialing directory entry.
  1368.  
  1369.           Again - do not change the current setting after you've
  1370.           connected to a service.  The settings on this screen are
  1371.           effective only when PC-VCO is run standalone.  Changing a
  1372.           setting here could disconnect you.
  1373.  
  1374.        3. COM ports
  1375.  
  1376.           The last four items on this menu are the candidates for COM
  1377.           ports.  Select the appropriate port for your modem.  This item
  1378.           is usually selected once, and then left alone.
  1379.  
  1380.        4. Save
  1381.  
  1382.           You save the current settings for the next execution of PC-VCO
  1383.           through the "Save" selection.  Settings are saved to disk.
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Version 2.2: 880705
  1403.  
  1404. PC-VCO: IBM PC Visual Conferencing                     Page  21
  1405.  
  1406.  
  1407. XI.    Miscellaneous Functions
  1408.  
  1409.  
  1410.     A. Disk logging [transcripting] (Controls pull-down)
  1411.  
  1412.        You may transcript what you receive to a disk (or PRN) with the
  1413.        "Disk logging" function, if you loaded COM-AND with PC-VCO.  The
  1414.        transcript will be marked with the date and time it began and
  1415.        ended if transcript marking is set on through COM-AND's Alt-O
  1416.        screen.
  1417.  
  1418.  
  1419.        COM-AND keeps the last 4096 characters received in a buffer for
  1420.        backscreen (or redisplay).    When you turn transcripting on, you
  1421.        will be asked if the backscreen is to be recorded first.  If you
  1422.        respond "Y", the backscreen will be written to the transcript
  1423.        file before the "BEGIN" mark.
  1424.  
  1425.  
  1426.     B. Keyboard display (Controls pull-down)
  1427.  
  1428.        Some talk systems are more friendly when what you type is not
  1429.        mixed in with what you receive.  Turning echo off (if the system
  1430.        echoes key-entry) can be accomplished in a number of ways (note
  1431.        that this is different from program echo above).
  1432.  
  1433.  
  1434.        However - all of a sudden you have a new problem - you don't see
  1435.        what you're typing!  Keyboard display in PC-VCO is one attempt to
  1436.        solve this problem.    What you type will be displayed on the
  1437.        status line when keyboard display is turned on.  You can turn it
  1438.        on permanently through this selection.
  1439.  
  1440.  
  1441.        Keyboard display may be set on permanently in COM-AND through the
  1442.        Alt-O options window.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463. Version 2.2: 880705
  1464.  
  1465. PC-VCO: IBM PC Visual Conferencing                     Page  22
  1466.  
  1467.  
  1468. XII.    Program Requirements
  1469.  
  1470.  
  1471.     This program can only function on an IBM PC or DOS compatible
  1472.     machine.  PC-VCO does direct to screen buffer fetches and stores;
  1473.     so compatibility is an important issue.
  1474.  
  1475.  
  1476.     PC-VCO supports CGA, EGA and Hercules.    PC-VCO uses a Microsoft
  1477.     Mouse if one is available (not well, but If I receive comments it'll
  1478.     certainly get better).
  1479.  
  1480.  
  1481.     PC-VCO disk I/O is done through the 'Handle' oriented I/O routines
  1482.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  1483.  
  1484.  
  1485.     PC-VCO (Version 2.2) requires 117K for itself.    So you need 192.  To
  1486.     take advantage of the DOS Gateway (use another comm program) or to
  1487.     use COM-AND, you'll need at least 384K, more like 512K.
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524. Version 2.2: 880705
  1525.  
  1526. PC-VCO: IBM PC Visual Conferencing                     Page  23
  1527.  
  1528.  
  1529. XIII.    Program and Author Information
  1530.  
  1531.  
  1532.     This program was written using Microsoft Macro-Assembler.  The
  1533.     author likes assembler.  Assembly language is an entirely appro-
  1534.     priate vehicle for some of the program, and a not-inappropriate
  1535.     vehicle for the rest of it.  Everything, in moderation...
  1536.  
  1537.  
  1538.     The author of this program is R.  Scott McGinnis of Chicago,
  1539.     Illinois.  PLINK and GEnie ID:    TARTAN.  Comment and suggestions
  1540.     (and criticism in moderation) are welcomed:
  1541.  
  1542.              CABER Software
  1543.              R. (Scott) McGinnis
  1544.              P.O. Box 3607 Mdse Mart
  1545.              Chicago, IL 60654-0607
  1546.  
  1547.  
  1548.     Credit for information on the VCO must be given to Kelly Major and
  1549.     Mike Cohen.  Credit for help on graphic displays and conversions
  1550.     must be given to Mark Lewis.  All three I've met through People-
  1551.     Link.  Colleagues once upon a time at 'the office', Bruce Clemens,
  1552.     Joe Noonan, Milton Treshansky, and Al Paluszek have helped immea-
  1553.     surably with technical comments, suggestions, jeers and support.
  1554.     My wife, Elizabeth, supported me whole-heartedly in this effort.
  1555.  
  1556.  
  1557.     This program (Version 2.2) may be distributed freely with the caveat
  1558.     that the Author information displayed at program termination is not
  1559.     removed.  If the program is found entertaining or useful, a regis-
  1560.     tration of $50.00 is requested.  Should response warrant it, I will
  1561.     continue to develop and support this product.
  1562.  
  1563.  
  1564.     Most of the hardware names and software names in this document are
  1565.     trademarks or trade names of specific manufacturers.
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585. Version 2.2: 880705
  1586.  
  1587. PC-VCO: IBM PC Visual Conferencing                     Page  24
  1588.  
  1589.  
  1590. A.    Switches and parameters
  1591.  
  1592.  
  1593.     Program Switches:
  1594.  
  1595.     /1  'PLINK/CIS': Expressions sent and received are compatible with
  1596.         VCO (by Mike Cohen) as used on PLINK, and VMCO (by Bob Perez)
  1597.         as used on CIS.  This is the default for distributed copies.
  1598.  
  1599.     /2  'GEnie/STC/Delphi': Expressions sent and received are compatible
  1600.         with VCO (by Harry Chesley) as used on Delphi and GEnie.  You
  1601.         may make this the permanent default with the Alt-O menu.
  1602.  
  1603.     /C 'CGA only':  You may specify a CGA display only with this switch.
  1604.         EGA and Hercules displays are inhibited.  The default for PC-VCO
  1605.         is to automatically adjust to Hercules, EGA or CGA.
  1606.  
  1607.     /E 'EGA':  You may specify an EGA admissible with this switch.
  1608.         This is the default.
  1609.  
  1610.     /F  'Library file':  You may specify a particular face library file
  1611.         name (for example /FPLINK.FLB) on the run command.    This
  1612.         overrides the default value set through Alt-S.
  1613.  
  1614.     /G  'Force Hercules':  You may force Hercules mode even if PC-VCO
  1615.         doesn't think you have a Hercules board.  However - use this
  1616.         switch cautiously.
  1617.  
  1618.     /H 'Hercules':  You may specify a Hercules admissible with this
  1619.         switch.  This is the default.
  1620.  
  1621.     /M  'Maug' mode.  The graphic display does not use a Speaker's box
  1622.         and thus allows a full 80 columns for text display.
  1623.  
  1624.     /P  'Piggyback':  PC-VCO will open the COM port in such a manner as
  1625.         to retain another program's already opened line.  When PC-VCO is
  1626.         exited, the previous state is restored.  This is for use with
  1627.         other communications programs having a DOS Gateway (e.g.
  1628.         Procomm).
  1629.  
  1630.     /Q  'Quiet mode': You may turn quiet mode with this run-time switch.
  1631.  
  1632.     /S  'Small table':  This switch causes the program to use the 10
  1633.         ICON screen display as opposed to the default 20 ICON mode.
  1634.  
  1635.     /V  'Voice on': PC-VCO may be loaded with voice turned on (implicit
  1636.         mode) with the /V switch.  SPEECH.COM must be loaded before
  1637.         PC-VCO is run with the /V switch;  VOICE.EXE does not have to be
  1638.         pre-loaded (but may be if you feel more comfortable).
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646. Version 2.2: 880705                           Appendices
  1647.  
  1648. PC-VCO: IBM PC Visual Conferencing                     Page  25
  1649.  
  1650.  
  1651. A.    Switches and Parameters (continued)
  1652.  
  1653.  
  1654.     Program switches (continued):
  1655.  
  1656.         Voice in PC-VCO now has two 'ON' modes:  explicit and implicit.
  1657.         Implicit speech is voicing everything (that the poor speech
  1658.         driver can handle).  Explicit speech must be signalled with a
  1659.         '~{', '~[', '{', or '['.  The word following the signal must
  1660.         occur in the exception file.
  1661.  
  1662.     /VE 'Voice on, explicit':  The /VE switch turns on the voice inter-
  1663.         face, and sets the voice mode 'explicit' (above).  The speech
  1664.         driver must be loaded before PC-VCO is executed.
  1665.  
  1666.     /VI 'Voice on, implicit':  The /VI switch turns on the voice inter-
  1667.         face, and sets the voice mode 'implicit' (above).  The speech
  1668.         driver must be loaded before PC-VCO is executed.
  1669.  
  1670.     /V0 'SPEECH.COM':  The /V0 forces PC-VCO to expect SPEECH.COM as
  1671.         the voice driver.
  1672.  
  1673.     /V1 'VOICE.EXE':  The /V1 forces PC-VCO to expect VOICE.EXE as
  1674.         the voice driver.
  1675.  
  1676.     /X  'Debug mode': This switch enables certain resident debugging
  1677.         keys.  I do not recommend you use it.  I document it only for
  1678.         the VERY curious.
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707. Version 2.2: 880705                           Appendices
  1708.  
  1709. PC-VCO: IBM PC Visual Conferencing                     Page  26
  1710.  
  1711.  
  1712. A.    Switches and Parameters (continued)
  1713.  
  1714.  
  1715.     Program parameters:
  1716.  
  1717.        COM1     PC-VCO uses the COM1 port
  1718.        COM2     PC-VCO uses the COM2 port
  1719.        COM3     PC-VCO uses the COM3 port
  1720.        COM4     PC-VCO uses the COM4 port
  1721.  
  1722.        300        PC-VCO uses port at 300 baud
  1723.        1200     PC-VCO uses port at 1200 baud
  1724.        2400     PC-VCO uses port at 2400 baud
  1725.        4800     PC-VCO uses port at 4800 baud
  1726.        9600     PC-VCO uses port at 9600 baud
  1727.  
  1728.        EVEN     PC-VCO uses port with even parity
  1729.        ODD        PC-VCO uses port with odd parity
  1730.        NONE     PC-VCO uses port with no parity
  1731.  
  1732.        DATA7    PC-VCO transmits/receives 7 data bits
  1733.        DATA8    PC-VCO transmits/receives 8 data bits
  1734.  
  1735.        STOP1    PC-VCO uses and expects 1 stop bit
  1736.        STOP2    PC-VCO uses and expects 2 stop bits
  1737.  
  1738.  
  1739.     Program switches require no delimiters.  Parameters when contiguous
  1740.     must be preceded by a blank.  For example:
  1741.  
  1742.     A> PC-VCO 1200        Run the program for 1200 baud communications
  1743.     A> PC-VCO /P1200    Piggyback, 1200 baud
  1744.     A> PC-VCO /P 1200    Piggyback, 1200 baud
  1745.  
  1746.  
  1747.     Program defaults are:
  1748.  
  1749.     A> PC-VCO COM2 300 EVEN DATA7 STOP1
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768. Version 2.2: 880705                           Appendices
  1769.  
  1770. PC-VCO: IBM PC Visual Conferencing                     Page  27
  1771.  
  1772.  
  1773. B.    Speech drivers
  1774.  
  1775.  
  1776.     The speech function of PC-VCO is supplied by a resident speech
  1777.     driver.  This version of PC-VCO interfaces two speech drivers,
  1778.     VOICE.EXE (created for PC-VCO) and SPEECH.COM (the original
  1779.     interface, believed to be public domain).  PC-VCO only implements
  1780.     an interface to the driver.  Text-to-phoneme conversion is
  1781.     performed in PC-VCO.
  1782.  
  1783.  
  1784.     1. VOICE.EXE
  1785.  
  1786.  
  1787.        PC-VCO interfaces its own speech driver (VOICE.EXE) beginning
  1788.        with version 2.2.  VOICE.EXE was created to support PC-VCO, and
  1789.        provides the following advantages over SPEECH.COM:
  1790.  
  1791.        o    VOICE.EXE is not CPU speed dependant
  1792.        o    VOICE.EXE will run with any version of MS-DOS after 2.0
  1793.        o    VOICE.EXE implements a broader 'arpabet' (the phoneme set)
  1794.         compatible with the MacIntosh/Amiga arpabet
  1795.        o    VOICE.EXE permits a limited variance of speech pitch and
  1796.         speaking rate
  1797.        o    VOICE.EXE may be loaded 'on top' of PC-VCO and deleted after
  1798.         use (and it may be used TSR as well!)
  1799.  
  1800.  
  1801.        VOICE.EXE may be used with PC-VCO in one of two ways.
  1802.  
  1803.        (a) Place VOICE.EXE on the subdirectory from which you execute
  1804.            PC-VCO.    When you enable voice (SPEECH pull-down, or /V in the
  1805.            run command), PC-VCO will load VOICE.EXE automatically.    When
  1806.            PC-VCO terminates, it terminates VOICE.EXE as well.
  1807.  
  1808.      -or-  (b) Load VOICE.EXE before loading PC-VCO (and before loading ANY
  1809.            communications program, if you use PC-VCO with a comm program).
  1810.            Loaded manually, VOICE.EXE becomes a terminate-and-stay-resi-
  1811.            dent utility.  It takes up space until you next boot.
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829. Version 2.2: 880705                           Appendices
  1830.  
  1831. PC-VCO: IBM PC Visual Conferencing                     Page  28
  1832.  
  1833.  
  1834. B.    Speech drivers (continued)
  1835.  
  1836.  
  1837.     2. SPEECH.COM
  1838.  
  1839.        The resident speech driver SPEECH.COM and associated programs (SAY
  1840.        and READ) were found on a public domain Bulletin Board in Chicago.
  1841.        The author's name is not contained in the documentation, and no
  1842.        statement is made as to its ownership or copyright.
  1843.  
  1844.  
  1845.        The author IS identified within the executable object files (as
  1846.        Andy McGuire...  I incorrectly referred to Douglas Sisco in
  1847.        earlier documents).    I have attempted to find anyone who knows of
  1848.        Andy McGuire, with no success to date.  SPEECH.COM is not
  1849.        included in this release (nor has it has been in any - its not
  1850.        mine to give).  It is available on most services as SPEECH.ARC.
  1851.  
  1852.  
  1853.        The current speech driver (by Andy McGuire) will not function
  1854.        with DOS 3.xx (so its document states), without patching.
  1855.        The driver is limited to a 4.77 Mhz clock as well.  I published
  1856.        a patch for SPEECH.COM...  but that patch is mostly ineffective
  1857.        above 8Mhz.
  1858.  
  1859.  
  1860.        To use SPEECH.COM, load SPEECH.COM before PC-VCO (and before the
  1861.        base comm program, if used).  Rename VOICE.EXE on the default
  1862.        subdirectory to something else (or use the /V0 switch in PC-VCO's
  1863.        run command).
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890. Version 2.2: 880705                           Appendices
  1891.  
  1892. PC-VCO: IBM PC Visual Conferencing                     Page  29
  1893.  
  1894.  
  1895. C.    Exception File
  1896.  
  1897.  
  1898.     The exception file distributed with PC-VCO is virtually that used
  1899.     by the MacIntosh VCO.  The exception file is a simple text file,
  1900.     each line of which has the syntax:
  1901.  
  1902.          "[" <keyword> "]"  "=" <translation>
  1903.  
  1904.  
  1905.     There are three types of keyword in the current exception file:
  1906.  
  1907.     .  Keywords without a special delimiter (e.g. [6] which gives a
  1908.        pronunciation for numeric 6)
  1909.  
  1910.     .  Keywords with the initial delimiter "{".  MacIntosh documentation
  1911.        states that these are to be displayed but not spoken.  Why are
  1912.        they in the exception file?    Beats me.
  1913.  
  1914.     .  Keywords with the initial delimiter "[" (in addition to the
  1915.        initial bracket).  MacIntosh documentation states that these are
  1916.        to be voiced, and not displayed.
  1917.  
  1918.  
  1919.     PC-VCO follows these rules, more or less.  The exception file as
  1920.     prepared for the MacIntosh MacTalk is compatible with the VOICE.EXE
  1921.     speech driver the 'old' exception file supplied with this release is
  1922.     compatible with SPEECH.COM).  Some changes have been made, but not
  1923.     alot.  Perhaps some brave soul will pitch in.
  1924.  
  1925.  
  1926.     On the other hand, the exception file does provide pronunciation
  1927.     for tokens that otherwise would be skipped by the present speech
  1928.     driver (e.g. simple numerics).
  1929.  
  1930.  
  1931.     Please note that this version of PC-VCO was distributed with two
  1932.     exception files:
  1933.  
  1934.         PC-VCO.EXC    - Exception file for VOICE.EXE speech driver
  1935.         OPC-VCO.EXC    - Exception file for SPEECH.COM speech driver
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951. Version 2.2: 880705                           Appendices
  1952.  
  1953. PC-VCO: IBM PC Visual Conferencing                     Page  30
  1954.  
  1955.  
  1956. D.    Files
  1957.  
  1958.  
  1959.     Program files:    PC-VCO expects the following files on the
  1960.     default drive (and subdirectory)
  1961.  
  1962.     PC-VCO.DFT    Parameter save area (Alt-S and Alt-P)
  1963.  
  1964.     PC-VCO will create this file if it is not found.  PC-VCO will auto-
  1965.     matically update the .DFT file if the program version number is
  1966.     different from the .DFT file version number.  When PC-VCO is
  1967.     loaded, the old file format will be loaded.  A new file will then
  1968.     be created to replace the old file.
  1969.  
  1970.  
  1971.     When a new major (e.g.    1.0, 2.0, ...) is released or when you move
  1972.     PC-VCO from one machine to another the previous .DFT file probably
  1973.     should be purged (and recreated by PC-VCO).
  1974.  
  1975.  
  1976.     PC-VCO also uses (if available) the following files:
  1977.  
  1978.     PC-VCO.EXC    Exception file for VOICE.EXE speech processing
  1979.     OPC-VCO.EXE    Exception file for SPEECH.COM speech processing
  1980.     PC-VCO.FLB    Face library
  1981.     VOICE.EXE    Speech driver
  1982.  
  1983.     Each of the PC-VCO.* files may be named through the ALT-S (Setup)
  1984.     Menu.  PC-VCO currently implements the rule for file names:  If the
  1985.     given file name carries a drive spec (i.e.  C:) or path (sub-
  1986.     directory), the name is taken 'as is'.  If neither condition holds,
  1987.     the default drive and subdirectory are added to the file name.
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012. Version 2.2: 880705                           Appendices
  2013.