home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO029C.ZIP / PC-VCO22.ZIP / VCOLIB.DOC < prev    next >
Text File  |  1991-07-25  |  34KB  |  1,220 lines
  1. VCOLIB: PC-VCO Face Librarian
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.              ----------------------------------
  22.              PC-VCO: IBM PC Visual Conferencing
  23.              ----------------------------------
  24.               Face Library Maintenance
  25.              ----------------------------------
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.     VCOLIB is distributed freely and may be copied by anyone for any
  34.     number of machines.  The author offers VCOLIB as "shareware".  If
  35.     the program is found to be useful or entertaining, a registration
  36.     of $50.00 is requested.  If response warrants, PC-VCO/VCOLIB will
  37.     be enhanced and extended.  The author may be reached at:
  38.  
  39.  
  40.                  CABER Software
  41.                  R. (Scott) McGinnis
  42.                  P.O. Box 3607 Mdse Mart
  43.                  Chicago, IL 60654-0607
  44.  
  45.                  PLINK, GEnie id: TARTAN
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 2.2: 880705
  61.  
  62. VCOLIB: PC-VCO Face Librarian
  63.  
  64.  
  65.  
  66.     VCOLIB version 2.2 is copyright 1988 CABER Software (R.  Scott
  67.     McGinnis) as a part of the PC-VCO communications accessory.  All
  68.     rights are reserved world wide, excepting redistribution under the
  69.     ShareWare concept.  PC-VCO is distributed freely and may be copied
  70.     by anyone for any number of machines, under the 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. VCOLIB: PC-VCO Face Librarian
  124.  
  125.  
  126.                  Table of Contents
  127.                  -----------------
  128.  
  129.  
  130.  
  131. I.    Introduction  ................................................. page 1
  132.  
  133. II.    Running the program  .......................................... page 2
  134.  
  135. III.    VCOLIB Command Summary ........................................ page 3
  136.  
  137. IV.    Creating a Face File .......................................... page 4
  138.  
  139. V.    The Graphic Editor ............................................ page 5
  140.  
  141. VI.    Sharing your Face Files ....................................... page 7
  142.  
  143. VII.    Program Requirements .......................................... page 8
  144.  
  145. VIII.    Program and Author Information    ............................... page 9
  146.  
  147.  
  148.  
  149.  
  150.                 Appendices
  151.                 ----------
  152.  
  153.  
  154. A.    Face File Contents ............................................ page 10
  155.  
  156. B.    File formats .................................................. page 11
  157.  
  158. C.    Harry Chesley's VCO ........................................... page 13
  159.  
  160. D.    Newly supported systems ....................................... page 14
  161.  
  162. E.    PACKIT and STUFFIT files ...................................... page 15
  163.  
  164. F.    Command examples .............................................. page 16
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Version 2.2: 880705
  183.  
  184. VCOLIB: PC-VCO Face Librarian                         Page   1
  185.  
  186.  
  187. I.    Introduction
  188.  
  189.  
  190.     VCOLIB Version 2.2 creates and maintains a library file of Icons
  191.     used by PC-VCO.  Icons may be extracted from MacIntosh resource
  192.     files or may be created using a graphics editor (in VCOLIB).  Icons
  193.     created on the IBM PC may be output to a resource-type file, and
  194.     uploaded for MacIntosh or IBM PC VCO friends.
  195.  
  196.  
  197.     PC-VCO is a communication program for use on IBM PCs and network
  198.     conferencing facilities such as People/Link's PARTY, CompuServe's
  199.     CB simulator, and Delphi's conference areas.  The idea for PC-VCO
  200.     was derived from the VCO system, and its predecessor VMCO,
  201.     developed on the MacIntosh computer.  The VCO programs (PC and
  202.     MacIntosh) allow you to see the people you communicate with
  203.     on-line, using the graphic capabilities of the personal computer.
  204.  
  205.  
  206.     VCO was originally developed by Harry Chesley.    It was followed by
  207.     VMCO (which is CIS specific), written by Bob Perez independent to
  208.     the development of VCO.  The current (MacIntosh) version of VCO is
  209.     almost an exact duplicate of Harry Chesley's original - the
  210.     original source code was converted by Mike Cohen and made to accept
  211.     several service formats.
  212.  
  213.  
  214.     The MacIntosh VCO allows the user to see the people talking on-
  215.     line through graphic Icons.  These are provided to the MacIntosh
  216.     VCO through 'Resource files' and are built using a 'Resource
  217.     Editor'.  A MacIntosh VCO user must have a resource file for every
  218.     speaker.  Charlie Brown and Snoopy Icons are used when a speaker is
  219.     unknown.  The face library created and maintained by VCOLIB serves
  220.     the same purpose on the IBM PC (for PC-VCO).  VCOLIB also serves as
  221.     a Resource Editor, on the IBM PC.
  222.  
  223.  
  224.     PC-VCO/VCOLIB may be copied freely and distributed to anyone for
  225.     any machine.  The author offers this as "shareware".  If the
  226.     program is found to be useful or entertaining, a registration is
  227.     asked.    PC-VCO/VCOLIB will be extended and enhanced if response
  228.     warrants.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. Version 2.2: 880705
  244.  
  245. VCOLIB: PC-VCO Face Librarian                         Page   2
  246.  
  247.  
  248. II.    Running the program
  249.  
  250.  
  251.     VCOLIB may be used in two ways: (1) menu mode, where a menu of
  252.     commands is presented, and (2) command mode, where VCOLIB is
  253.     instructed at run time which functions are to be performed.
  254.  
  255.  
  256.     For menu mode, VCOLIB may be invoked at the DOS prompt:
  257.  
  258.     ------------------------------------------------------
  259.     "d>" VCOLIB
  260.  
  261.     Where "d>" is the DOS prompt
  262.     ------------------------------------------------------
  263.  
  264.  
  265.     For command mode, VCOLIB may be invoked at the DOS prompt:
  266.  
  267.     ------------------------------------------------------
  268.     "d>" VCOLIB <options>
  269.  
  270.     Where "d>" is the DOS prompt, and
  271.           <options> is: (<cmd> <Lib-File> (<parm> (,<parm> ...)))
  272.           where <parm>     is either an ID or a MacIntosh Face-file name,
  273.             <Lib-file> is the library file name to be used,
  274.           and   <cmd>      is one of: A,R,O,M,D,U,V,C, or L.
  275.  
  276.     Note: Invoke VCOLIB with no commands to obtain a menu of services
  277.           (i.e. a HELP summary).
  278.     ------------------------------------------------------
  279.  
  280.     VCOLIB commands are summarized on the next page.  In menu mode,
  281.     a menu number serves the same purpose as the <cmd> letter used
  282.     in command mode.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304. Version 2.2: 880705
  305.  
  306. VCOLIB: PC-VCO Face Librarian                         Page   3
  307.  
  308.  
  309. III.    VCOLIB Command Summary.
  310.  
  311.  
  312.     Command    Parameter Description
  313.     ---------  --------- --------------------------------------------------
  314.     (A)dd       Mac-File  Add Mac-File(s) to Lib-File.  You are given
  315.                  the opportunity to rename the entry from the ID
  316.                  specified in the Mac-File.  You may (C)hange or
  317.                  (A)ccept the ID as given.    Duplicate IDs are
  318.                  not allowed in the Library.
  319.  
  320.     (R)eplace  ID         Replace an ID in Lib-File.  You are prompted for
  321.                  the MacIntosh face file to be used.  If the
  322.                  face file carries the same ID, the replace is
  323.                  performed with no comment.  If they differ, you
  324.                  are queried.  Duplicate IDs are not allowed in
  325.                  the Library.
  326.  
  327.     (D)elete   ID         Delete an ID from Lib-File.  The indicated entry
  328.                  is marked deleted, and will be discarded upon
  329.                  the next ADD.
  330.  
  331.     (U)ndelete ID         Mark deleted entry not deleted.  If an entry
  332.                  marked deleted has not been re-used, it may be
  333.                  put back into service with this command.
  334.  
  335.     (M)odify   ID         Modify ID, name, rate of speech and pitch of
  336.                  an entry.    Further, any Icon in the entry may be
  337.                  modified through a simple graphics editor.
  338.  
  339.     (C)opy       ID         Copy an entry to a new entry in Lib File. You
  340.                  are prompted for an ID to name the new entry.
  341.                  The new ID may not duplicate an existing ID in
  342.                  the Lib-file.
  343.  
  344.     (O)utput   ID         Build a resource file of MacIntosh compatible
  345.                  format.  You will be prompted for a file name.
  346.  
  347.     (V)iew      (ID)         View the contents of Lib-File.  If you specify
  348.                  an ID, and it exists in Lib-file, it is
  349.                  displayed.  You will be prompted for other IDs
  350.                  in any case.
  351.  
  352.     (L)ist      (none)     List entries in Lib-File.    Output may be re-
  353.                  directed to a printer.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Version 2.2: 880705
  366.  
  367. VCOLIB: PC-VCO Face Librarian                         Page   4
  368.  
  369.  
  370. IV.    Creating a Face File
  371.  
  372.  
  373.     You can create a face file through the simple expedient of COPYing
  374.     a current face (naming the new entry), and then MODIFYing the new
  375.     entry.    The COPY command creates a new Library entry using an
  376.     existing entry.  The MODIFY command works on an existing entry,
  377.     allowing the ID, NAME, and Icons of the entry to be changed.
  378.  
  379.  
  380.     After the ID and NAME have been changed, you will be asked if the
  381.     Icons are to be edited.  If you respond "Yes", VCOLIB will try to
  382.     switch to graphics mode (if your PC does not have a CGA or
  383.     Hercules, the attempt will fail), and you will be asked which Icon
  384.     is to be modified.  Select the ICON number you wish to modify.
  385.  
  386.  
  387.     After choosing an ICON, you will be asked which ICON to use as a
  388.     base for the edit.  You may start the edit session with any of the
  389.     displayed Icons.  The result of the edit will overlay the ICON you
  390.     initially selected to modify - it will not change the ICON you've
  391.     chosen as a base.  Once you have specified which ICON is to be
  392.     modified, and which ICON you will use as a starting point, you
  393.     enter the graphic editor (see below:  "V.  The Graphic Editor").
  394.  
  395.  
  396.     The editor displays the ICON as it appears on the PC-VCO screen to
  397.     the right, and displays a magnified ICON (4x) with a cursor
  398.     (initially in the top left corner) to the left.  Changes to pixels
  399.     are reflected in both pictures simultaneously.    Cursor keys are
  400.     used to position the cursor.  The INSert and DELete keys turn the
  401.     pixel at the cursor on and off.
  402.  
  403.  
  404.     A carriage return finishes the edit and updates the face entry.
  405.     An ESCape cancels the edit without modification to any ICONs.
  406.  
  407.  
  408.     Once an entry has been created in the library, it is immediately
  409.     usable by PC-VCO.  When a speaker using the entry's ID is
  410.     recognized, normal expression faces are displayed (Icons 260 and
  411.     360).  However, to be seen by other VCO users, the entry must be
  412.     OUTPUT to a file (on your PC) and the file uploaded to a BBS or
  413.     service (see below:  "VI.  Sharing your face file").
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426. Version 2.2: 880705
  427.  
  428. VCOLIB: PC-VCO Face Librarian                         Page   5
  429.  
  430.  
  431. V.    The Graphic Editor
  432.  
  433.  
  434.     You enter the graphic editor through the modify command.  To enter
  435.     the graphics editor, you must answer 'yes' to the question "do you
  436.     wish to modify any ICONs, you must select an ICON to be updated,
  437.     and you must select an ICON with which to start.
  438.  
  439.  
  440.     The editor displays the ICON as it appears on the PC-VCO screen to
  441.     the right, and displays a magnified ICON (4x) with a cursor
  442.     (initially in the top left corner) to the left.  Changes to pixels
  443.     are reflected in both pictures simultaneously.
  444.  
  445.  
  446.     In the graphics editor, the following keys are active:
  447.  
  448.     Home        This key positions the cursor to the top left
  449.             corner.  If the PEN is on, the point at the cursor
  450.             will change.
  451.  
  452.     End        This key positions the cursor to the bottom left
  453.             corner.  If the PEN is on, the point at the cursor
  454.             will change.
  455.  
  456.     PgDn        This key positions the cursor to the bottom right
  457.             corner.  If the PEN is on, the point at the cursor
  458.             will change.
  459.  
  460.     PgUp        This key positions the cursor to the top right
  461.             corner.  If the PEN is on, the point at the cursor
  462.             will change.
  463.  
  464.     Cursor up    This key moves the cursor up one point.  At the top
  465.             of the display, the cursor wraps to the bottom.  If
  466.             the PEN is on, the point at the new cursor changes.
  467.  
  468.     Cursor left    This key moves the cursor left one point.  At the
  469.             side of the display, the cursor wraps oppositely.  If
  470.             the PEN is on, the point at the new cursor changes.
  471.  
  472.     Cursor down    This key moves the cursor down one point.  At the
  473.             bottom of the display, the cursor wraps to the top.
  474.             If the PEN is on, the point at the new cursor changes.
  475.  
  476.     Cursor right    This key moves the cursor right one point.  At the
  477.             side of the display, the cursor wraps oppositely.  If
  478.             the PEN is on, the point at the new cursor changes.
  479.  
  480.             [Note:    If you have a Microsoft Mouse, motion of the
  481.             mouse will act as substitute for the cursor keys.]
  482.  
  483.  
  484.  
  485.  
  486.  
  487. Version 2.2: 880705
  488.  
  489. VCOLIB: PC-VCO Face Librarian                         Page   6
  490.  
  491.  
  492. V.    The Graphic Editor (continued)
  493.  
  494.  
  495.     Active keys in the graphic editor (continued)...
  496.  
  497.     Ins        This key turns the point at the cursor off (dark).
  498.  
  499.     Del        This key turns the point at the cursor on (light).
  500.  
  501.     Alt-C        This key clears all points in the ICON (all dark).
  502.  
  503.     Alt-S        This key sets all points on (all light).
  504.  
  505.     Alt-R        This key reverses all points in the image.
  506.  
  507.     Alt-P        This key turns the PEN on and off.  When the PEN is
  508.             on, a message is displayed at the top of the screen.
  509.             PEN drawing is very convenient in may cases.
  510.  
  511.             [Note: On the MS Mouse, the left button is PEN on
  512.             and the right button is PEN off.]
  513.  
  514.     Esc        This key cancels any changes and returns you to the
  515.             view screen.  No changes will be made to any ICONs.
  516.  
  517.     <return>    This key terminates the graphic editor and modifies
  518.             the ICON you selected with your changes.
  519.  
  520.  
  521.     The graphic editor uses the method called 'fatbits'.  The ICON is
  522.     displayed in its correct size, and also magnified 4 times.
  523.     Magnification allows a cursor to be displayed within the picture.
  524.  
  525.  
  526.     Most ICONs used in VCO have a light background with dark points
  527.     outlining or shading the drawing.  Alt-S allows you to make a
  528.     blank canvas on which to draw.    Once you've drawn your first ICON,
  529.     you can copy it over top of all the rest, and then make changes to
  530.     each as appropriate.
  531.  
  532.  
  533.     It may seem intimidating at first to have to create 18 images (9
  534.     for the seated display, and 9 for the speaker's box).  However, it
  535.     turns out to be considerably more simple than it appears,
  536.     especially if you start out with someone else's ICONs that are
  537.     similar to the set you visualize for yourself.
  538.  
  539.  
  540.     In any case, you can always 'Esc' cancel the editor and make no
  541.     changes.  You have an opportunity to experiment, and throw away the
  542.     result if you don't like it.  So...  have at it!
  543.  
  544.  
  545.  
  546.  
  547.  
  548. Version 2.2: 880705
  549.  
  550. VCOLIB: PC-VCO Face Librarian                         Page   7
  551.  
  552.  
  553. VI.    Sharing your Face File
  554.  
  555.  
  556.     In order for other VCO/PC-VCO users to see your face, you must
  557.     share your face file.  VCOLIB will OUTPUT a library entry to a
  558.     MacIntosh type resource file.  This file may be uploaded to a BBS
  559.     or service.  Other VCO/PC-VCO users then download the file and add
  560.     it to their library.
  561.  
  562.  
  563.     Please note that when you OUTPUT a face to a file for uploading,
  564.     each system to which you wish to upload has differing requirements.
  565.     VCOLIB will query the target system, and prepare the file
  566.     accordingly.  You cannot upload a file prepared for CIS to GEnie,
  567.     for example, and expect GEnie users to be able to use the file.  If
  568.     you use several systems, you must prepare a different face file for
  569.     each.
  570.  
  571.  
  572.     Included with this distribution of PC-VCO are 6 face files (in the
  573.     library file PC-VCO.FLB).  You may see the entries in this library
  574.     with the command:
  575.  
  576.        "d>" VCOLIB V PC-VCO.FLB
  577.  
  578.     Kelly, Mike, Bob, and OZMA have all shared VCO with me during the
  579.     development of this program.  Their faces are included.  The entry
  580.     PC-VCO-DEFAULT is the Charlie Brown entry used for IDs not
  581.     contained in the library.  I am TARTAN.
  582.  
  583.  
  584.     One note - Some VCO/VMCO users pack resource files together in a
  585.     single file and upload the one file.  This version of VCOLIB does
  586.     not accept a Packit format face library.  Each resource file must
  587.     be extracted from a Packit format file (on a MacIntosh, or with the
  588.     utility 'unPACKIT' released separately) and then entered in to the
  589.     PC-VCO face Library.
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609. Version 2.2: 880705
  610.  
  611. VCOLIB: PC-VCO Face Librarian                         Page   8
  612.  
  613.  
  614. VII.    Program Requirements
  615.  
  616.  
  617.     This program can only function on an IBM PC or DOS compatible
  618.     machine.  The MODIFY and VIEW commands require a color graphics
  619.     or Hercules graphics display adapter.
  620.  
  621.  
  622.     On an EGA adapter, VCOLIB displays graphics in CGA mode to provide
  623.     the 'closest' square ICON available on a PC.
  624.  
  625.  
  626.     Version 2.2 VCOLIB supports the Microsoft Mouse, if you have one.
  627.     The mouse functions are provided in VCOLIB... no external menu or
  628.     TSR program is required.
  629.  
  630.  
  631.     VCOLIB does direct to screen buffer fetches and stores - so
  632.     compatibility is an important issue.  VCOLIB disk I/O is done
  633.     through the 'Handle' oriented I/O routines added with DOS 2.0.
  634.     Therefore DOS 2.0 is also a requirement.
  635.  
  636.  
  637.     The current version's memory requirements are modest.  Each Icon
  638.     uses 128 bytes.  Each ID can have 18 Icons (two for each expression;
  639.     one for display and another for speaking).  VCOLIB will run in 64K.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670. Version 2.2: 880705
  671.  
  672. VCOLIB: PC-VCO Face Librarian                         Page   9
  673.  
  674.  
  675. VIII.    Program and Author Information
  676.  
  677.  
  678.     This program was written using Microsoft Macro-Assembler.  The
  679.     author likes assembler.  Assembly language is entirely appropriate
  680.     for some of the program, and a not-inappropriate vehicle for the
  681.     rest of it.
  682.  
  683.  
  684.     VCOLIB and PC-VCO were written by R.  Scott McGinnis of Chicago,
  685.     Illinois.  My ID on PLINK and on GEnie is TARTAN.  Comment and
  686.     suggestions are welcomed.
  687.  
  688.              R. (Scott) McGinnis
  689.              P.O. Box 3607 Mdse Mart
  690.              Chicago, IL 60654-0607
  691.  
  692.  
  693.     Credit for information on the VCO must be given to Kelly Major and
  694.     Mike Cohen.  Both Kelly and Mike worked to make PC-VCO possible.  I
  695.     must also thank my wife, Elizabeth, who allowed me to isolate myself
  696.     (literally) for 5 months to write this, and who further read me hex
  697.     dumps (of resource files) while I keyboarded values.
  698.  
  699.  
  700.     VCOLIB (Version 2.2) may be distributed freely, with the caveat that
  701.     the Author information displayed at program termination is not
  702.     removed.  If you find PC-VCO useful or entertaining, a registration
  703.     of $50.00 is requested.  Should response warrant it, I will continue
  704.     to support this product.
  705.  
  706.  
  707.     Most of the hardware names and software names in this document are
  708.     trademarks or trade names of specific manufacturers.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731. Version 2.2: 880705
  732.  
  733. VCOLIB: PC-VCO Face Librarian                         Page  10
  734.  
  735.  
  736. A.    Face File Contents
  737.  
  738.  
  739.     VCOLIB maintains a Library of faces, each face associated with an
  740.     ID.  The Library may include up to 100 face entries.  Each entry
  741.     contains:
  742.  
  743.     .  The ID associated with the face(s)
  744.  
  745.     .  The personal name of the individual (optional and unused by
  746.        both MacIntosh VCO and PC-VCO); Field STR1000
  747.  
  748.     .  The speaking rate (words per minute) - used by VOICE.EXE driver;
  749.        Field STR 600
  750.  
  751.     .  The speaking pitch (frequency) - used by VOICE.EXE speech driver;
  752.        Field STR 610
  753.  
  754.     .  Faces.  Nine expressions are defined, each with two modes:
  755.        Display, and speaking.  Using MacIntosh terminology, these are:
  756.  
  757.        Expression      Face Icon    Speaking Icon
  758.        -------------- -----------  -------------
  759.        Normal          260       360
  760.        Grin           261       361
  761.        Laughing          262       362
  762.        Surprised          263       363
  763.        Anger          264       364
  764.        Zzzzzz          265       365
  765.        Sad              266       366
  766.        Away from CRT      267       367
  767.        Question          268       368
  768.  
  769.  
  770.     PC-VCO reserves the ID "PC-VCO-DEFAULT" for itself, to be used for
  771.     faces displayed when the ID is unknown.  The current distribution
  772.     contains Charlie Brown and Snoopy Icons for this ID.  If the entry
  773.     is marked deleted, PC-VCO will revert to text Icons for unknown IDs.
  774.     If the entry is marked deleted, and subsequent ADDs are performed,
  775.     the entry will be lost.
  776.  
  777.  
  778.     A second face-set has been provided with this version of VCOLIB and
  779.     PC-VCO.  It has been ID'd 'ANOTHER-DEFAULT' in the library.  You may
  780.     view the entry with the command:
  781.  
  782.         'd>' VCOLIB V PC-VCO.FLB ANOTHER-DEFAULT
  783.  
  784.     This face-set was created by Howard Hoffman.  It makes an interesting
  785.     contrast to the Charlie Brown faces.  By renaming 'PC-VCO-DEFAULT'
  786.     to, say 'OLD-DEFAULT', and renaming 'ANOTHER-DEFAULT' to become
  787.     'PC-VCO-DEFAULT', PC-VCO will use it for unknown faces.
  788.  
  789.  
  790.  
  791.  
  792. Version 2.2: 880705                           Appendices
  793.  
  794. VCOLIB: PC-VCO Face Librarian                         Page  11
  795.  
  796.  
  797. B.    File formats
  798.  
  799.  
  800.     Library file structure.
  801.  
  802.     Version 1.0 of VCOLIB uses a very simple structure for the LIB file.
  803.     The structure consists of a preamble, followed by fixed length slots
  804.     - each slot representing one 'face'.
  805.  
  806.     ------ Preamble format --------------------------------------------
  807.  
  808.     Byte 0        1       2      3     4    5      6      7      8
  809.          +------+------+------+------+------+------+------+------+->
  810.          ! "V"  ! "C"  ! "O"  ! "L"  ! "I"  ! "B"  ! Ver  ! Rev  !
  811.          +------+------+------+------+------+------+------+------+->
  812.  
  813.     Byte        8       9      10     11    12     13     14     15     16
  814.           >-+------+------+------+------+------+------+------+------+
  815.             ! Yr lsb-msb  ! Da     ! Mo    ! Mi   ! Hr   ! 100th! Sec  !
  816.           >-+------+------+------+------+------+------+------+------+
  817.  
  818.     Byte        17       18      19     20    21     22
  819.           >-+------+------+------+------+------+
  820.             ! IDln ! NmLn ! ICLn ! Max    ! Cnt  !
  821.           >-+------+------+------+------+------+
  822.  
  823.     Where: Ver -------> Creating program version # (ASCII)
  824.            Rev -------> Creating program revision # (ASCII)
  825.            Yr --------> Year # (Stored lsb/msb)
  826.            Mo --------> Month # (1-12); note reversal
  827.            Da --------> Day # (1-31); note reversal
  828.            Hr --------> Hour # (0-23); note reversal
  829.            Mi --------> Minute # (0-59); note reversal
  830.            Sec -------> Second # (0-59); note reversal
  831.            100th -----> 1/100 count; note reversal
  832.            IDLn ------> Maximum length in bytes of ID field
  833.            NmLn ------> Maximum length in bytes of Name field
  834.            ICLn ------> Size in bytes of each ICON field
  835.            Max -------> Max size of Library (in slots)
  836.            Cnt -------> Current count of lib slots
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. Version 2.2: 880705                           Appendices
  854.  
  855. VCOLIB: PC-VCO Face Librarian                         Page  12
  856.  
  857.  
  858. B.    File formats (continued)
  859.  
  860.  
  861.     Library file structure (continued)
  862.  
  863.     ------ Face slot format -------------------------------------------
  864.  
  865.     Each slot of the library represents one face.  The structure
  866.     declared below controls the format of the slot.  The fields
  867.     are laid out and used as follows:
  868.  
  869.     Byte 0           20      21        41     42     43
  870.          +-----/ /-----+------+-----/ /-----+------+------+->
  871.          ! ID       ! Del  ! Name    ! Rate          !
  872.          +-----/ /-----+------+-----/ /-----+------+------+->
  873.  
  874.     Byte        43       44      45        63          191        319
  875.           >-+------+------+-----/ /-----+-----/ /-----+------+------+->
  876.             ! Pitch      ! ICON Map    ! ICON_260    ! ICON_261    !
  877.           >-+------+------+-----/ /-----+-----/ /-----+------+------+->
  878.  
  879.     Byte        ...    1215      1343           3239         3367
  880.           >-+------+-----/ /-----+-----/ /-----+------+------+
  881.             ! ...  ! ICON_360     ! ...           ! ICON_368    !
  882.           >-+------+-----/ /-----+-----/ /-----+------+------+
  883.  
  884.     ID -----------> This field represents the ID for the face.
  885.     Del ----------> This field, if not zero, indicates unused slot.
  886.     Name ---------> This field carries a name for the face.
  887.     Rate ---------> This field carries a 16 bit rate for speaking (WPM)
  888.     Pitch --------> This field carries a 16 bit pitch for speaking (CPS)
  889.     ICON_Map -----> This set of flags indicates whether or not certain
  890.             faces in the arrays below have been filled in.
  891.             0 => ICON not present.    18 bytes, one per ICON.
  892.     ICON_260/268 -> These bitmaps are the 9 ICONs for display (4x32)
  893.     ICON_360/368 -> These bitmaps are the 9 ICONs for speaking (4x32)
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914. Version 2.2: 880705                           Appendices
  915.  
  916. VCOLIB: PC-VCO Face Librarian                         Page  13
  917.  
  918.  
  919. C.    Harry Chesley's VCO
  920.  
  921.  
  922.     This version of PC-VCO was written to be compatible with Mike
  923.     Cohen's MacIntosh VCO as used on PLINK.  Mike derived his VCO from
  924.     Harry Chesley's original work.  The ICON numbers used by both Harry
  925.     and Mike overlap.  The string fields (NAME, RATE, and PITCH) are
  926.     different.
  927.  
  928.  
  929.     You may add files created for either VCO to PC-VCO's face library.
  930.     If the input is from a file created for Harry Chesley's VCO, certain
  931.     changes must be made.  These can be accomplished with the MODIFY
  932.     command, and are:
  933.  
  934.     .  The personal name of the individual (optional and unused by
  935.        both MacIntosh VCO and PC-VCO); This field is not normally
  936.        carried by files created for Harry Chesley's VCO.  It may be
  937.        added with the MODIFY command.
  938.  
  939.     .  The speaking rate (words per minute) and pitch (frequency).
  940.        These fields are carried by files created for Harry Chesley's
  941.        VCO, but with different IDs.  The IDs are STR 256 and STR 257,
  942.        respectively, for Harry Chesley's VCO.  VCOLIB allows you to set
  943.        field values with the MODIFY command.
  944.  
  945.     .  Faces.  Eight expressions are defined, each with two modes:
  946.        Display, and speaking.  Using MacIntosh terminology, these are:
  947.  
  948.                    Mike Cohen's VCO          Harry Chesley's VCO
  949.               -------------------------- --------------------------
  950.        Expression      Face Icon    Speaking Icon Face Icon      Speaking Icon
  951.        -------------- -----------  ------------- -----------  -------------
  952.        Normal          260       360         260          360
  953.        Grin           261       361         <none>       <none>
  954.        Laughing          262       362         261          361
  955.        Surprised          263       363         265          365
  956.        Anger          264       364         263          363
  957.        Zzzzzz          265       365         264          364
  958.        Sad              266       366         262          362
  959.        Away from CRT      267       367         267          367
  960.        Question          268       368         266          366
  961.  
  962.     ICONs added from a file created for Harry Chesley's VCO are auto-
  963.     matically moved around to match the enumeration given above for Mike
  964.     Cohen's VCO.  There is no differentiation in Harry Chesley's VCO
  965.     between 'grin' and 'laughing'...  so 'happy' is replicated for both.
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975. Version 2.2: 880705                           Appendices
  976.  
  977. VCOLIB: PC-VCO Face Librarian                         Page  14
  978.  
  979.  
  980. D.    Newly supported systems
  981.  
  982.  
  983.     With the release of Version 2.0 PC-VCO, several systems are
  984.     supported that are not mentioned during the output sequence.
  985.     PC-VCO Version 2.2 supports TBBS, and PROTOCALL services as well
  986.     as PLINK, GEnie, SOURCE, CIS, and Delphi, but the output command
  987.     prompt does not mention the two new services.  There is a
  988.     reason...
  989.  
  990.  
  991.     MacIntosh VCO/VMCO users actually use THREE resource file formats.
  992.     [The above discussion might lead one to suspect that there are two,
  993.     but there are actually three.]    VCOLIB recognizes all three on
  994.     input, and can output a file in any of the forms.
  995.  
  996.  
  997.     Online, there are two differing sets of control sequences (one for
  998.     PLINK/CIS and another for GEnie/Delphi).  PC-VCO requires users to
  999.     switch to the set appropriate for the system.  MacIntosh users
  1000.     cannot do the same.  [There are three programs, after all.]
  1001.  
  1002.  
  1003.     Users on the newly supported services must decide which MacIntosh
  1004.     user community with which they wish to be compatible.  All three
  1005.     have MacIntosh as well as IBM PC users.  Harry Chesley has provided
  1006.     (or will provide) a version of his VCO modified for SOURCE users.
  1007.     For PROTOCALL and TBBS users no clear choice is available (now).
  1008.  
  1009.  
  1010.     Users on each system where PC-VCO is used must decide which form
  1011.     (Chesley (GEnie/Delphi), Perez (CIS), or Cohen (PLINK/CIS/Delphi)
  1012.     they wish to 'standardize'.  Most of the decision depends upon
  1013.     whether MacIntosh users are to be included easily.  When a decision
  1014.     is reached on each of the above systems by the user community, I
  1015.     will add the appropriate prompt to the OUTPUT command.
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036. Version 2.2: 880705                           Appendices
  1037.  
  1038. VCOLIB: PC-VCO Face Librarian                         Page  15
  1039.  
  1040.  
  1041. E.    PACKIT and STUFFIT files
  1042.  
  1043.  
  1044.     MacIntosh users often pack multiple files into a single file for
  1045.     efficiency and data compression.  PACKIT files cannot be accepted by
  1046.     VCOLIB.  When VCOLIB was written, the format for a PACKIT archive
  1047.     (file.PIT) was not available to me.  It is now.
  1048.  
  1049.  
  1050.     Two utility program have been released separately to deal with packed
  1051.     and stuffed files.  unPACKIT unpacks files that have been packed by
  1052.     PACKIT versions I, II and III (though it will not decode encoded
  1053.     PACKIT III files).  PIT files may be obtained from many services,
  1054.     unpacked, and the unpacked contents added into PC-VCO's face library.
  1055.     unSTUFIT unpacks files packed by the MacIntosh STUFFIT.  SIT files
  1056.     (STUFFIT files) many be obtained from many MacIntosh libraries.
  1057.  
  1058.  
  1059.     unPACKIT and unSTUFIT were released separately.  However, I consider
  1060.     them a part of the PC-VCO package.  If you have subscribed to PC-VCO,
  1061.     consider it free for your use.    If you haven't subscribed to PC-VCO,
  1062.     and have use for unPACKIT or unSTUFIT, I've asked for a separate
  1063.     registration.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097. Version 2.2: 880705                           Appendices
  1098.  
  1099. VCOLIB: PC-VCO Face Librarian                         Page  16
  1100.  
  1101.  
  1102. F.    Command Examples
  1103.  
  1104.  
  1105.     To obtain a quick overview (a help display, if you wish), enter:
  1106.  
  1107.           VCOLIB
  1108.  
  1109.     (The following examples assume that the face library you wish to
  1110.      employ is PC-VCO.FLB.    VCOLIB will work on any face library.)
  1111.  
  1112.     To List library entries, enter:
  1113.  
  1114.           VCOLIB L PC-VCO.FLB    -or-   VCOLIB > PRN L PC-VCO.FLB
  1115.  
  1116.     To view the library entry for the ID "TARTAN", enter
  1117.  
  1118.           VCOLIB V PC-VCO.FLB TARTAN
  1119.  
  1120.     To add an entry to the library from a file you've downloaded, enter:
  1121.  
  1122.           VCOLIB A PC-VCO.FLB <file>
  1123.  
  1124.           where <file> is the name you gave to the file you downloaded.
  1125.           PC-VCO will tell you the ID represented by the file, and ask
  1126.           for approval to update the file.    If the ID already exists in
  1127.           your library, you will have the opportunity to change the
  1128.           (new) ID, or to replace the existing entry.
  1129.  
  1130.     To delete the entry for TARTAN in the library, enter:
  1131.  
  1132.           VCOLIB D PC-VCO.FLB TARTAN
  1133.  
  1134.           if you list the library now, the entry will appear, but
  1135.           be marked 'deleted'.
  1136.  
  1137.     To undelete the entry for TARTAN in the library, enter:
  1138.  
  1139.           VCOLIB U PC-VCO.FLB TARTAN
  1140.  
  1141.           note that you can recover an entry you've deleted immediately
  1142.           after you delete it.  The first (A)dd, (R)eplace, or (C)opy
  1143.           performed after the delete will use the deleted entry's space.
  1144.           After that, the entry can no longer be recovered.
  1145.  
  1146.     To copy an entry in the library to a new entry, enter:
  1147.  
  1148.           VCOLIB C PC-VCO.FLB <ID>
  1149.  
  1150.           where <ID> is the entry you want to copy.  A new entry will be
  1151.           created, and you will be asked for a (new) ID for the entry.
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158. Version 2.2: 880705                           Appendices
  1159.  
  1160. VCOLIB: PC-VCO Face Librarian                         Page  17
  1161.  
  1162.  
  1163. F.    Command Examples (continued)
  1164.  
  1165.  
  1166.     To modify an entry in the library, enter:
  1167.  
  1168.           VCOLIB M PC-VCO.FLB <ID>
  1169.  
  1170.           where <ID> is the entry you want to modify.  Normally, you
  1171.           would copy an entry and modify the copy.    (M)odify allows you
  1172.           to change the ID for an entry, the NAME (which PC-VCO doesn't
  1173.           use), and to edit the ICONs.
  1174.  
  1175.     To generate a file (for uploading) from the library, enter:
  1176.  
  1177.           VCOLIB O PC-VCO.FLB <ID>
  1178.  
  1179.           where <ID> is the entry you want to output.  You will be asked
  1180.           for a file name to be used, and the system to which the file
  1181.           will be uploaded.  VCOLIB will create (or replace, if the file
  1182.           already exists) a file that you can then upload for other VCO
  1183.           users...    both PC and MacIntosh.
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  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                           Appendices
  1220.