home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / educ / quizzer1.zip / QUIZ.DOC < prev    next >
Text File  |  1989-03-01  |  42KB  |  1,388 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                       PC-QUIZZER
  11.                                      Version 2.1
  12.                                       01-Sep-88
  13.  
  14.  
  15.           Copyright (c) 1987, 1988 - Data Assist, All Rights Reserved.
  16.  
  17.           No part of this document may be reproduced in any form or by any
  18.           means without the express written permission of Data Assist.
  19.  
  20.           The information in this document is subject to change without
  21.           notice and should not be construed as a commitment by Data
  22.           Assist. The software described is furnished under a license and
  23.           may be used or copied only in accordance with this license
  24.           agreement.
  25.  
  26.           You may use this software on a single computer, but may transfer
  27.           it to another computer as long as it is used on only one computer
  28.           at a time. You may copy the software for backup purposes only.
  29.           You may modify the software for your use on a single computer.
  30.           You may not distribute any portion of this software, modified or
  31.           unmodified, without an additional license. 
  32.  
  33.           Use of this program indicates your acceptance of the agreement.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                           1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                                      INTRODUCTION
  76.  
  77.           PC-QUIZZER is a Computer Based Testing (CBT) and training package
  78.           designed for easy use while retaining many of the features found
  79.           in expensive CAI packages. The product permits the user to create
  80.           lessons without the requirement to learn a complex CAI
  81.           programming language. The lesson is presented to the student
  82.           using windows which contain options, questions, the answer
  83.           prompt, and help. In addition, PC-QUIZZER permits the use of
  84.           color text, color graphics, and music. A VOTRAX speech
  85.           synthesizer may also be used to produce speech. 
  86.  
  87.           Throughout this document we will refer to "the student" and "the
  88.           author". The student is the person who is taking the quiz or
  89.           lesson. The author is the person who is writing the lesson. From
  90.           the options menu the student is able to select features such as
  91.           Immediate question retry, Repeat missed questions, Almost correct
  92.           answer, Select questions based on keywords and others. 
  93.  
  94.           PC-QUIZZER lessons are text files which contain questions and
  95.           commands which control the presentation of the questions. The
  96.           questions used in a PC-QUIZZER lesson may be true/false, fill in
  97.           the blank, multiple choice, or K-type multiple-choice. 
  98.  
  99.           The questions on the quiz may be given sequentially or be
  100.           randomly chosen by the computer. Questions that are missed are
  101.           flagged for later retry, or they may be asked again immediately
  102.           until the correct answer is given. 
  103.  
  104.           Each question may contain multiple correct answers and incorrect
  105.           answers. Various levels of help and other information may be
  106.           included and displayed when the student needs help or has entered
  107.           a right or wrong answer. 
  108.  
  109.           Quiz files may be created using any standard ASCII text editor or
  110.           word processor. Once created, the entire quiz file may be loaded
  111.           into PC-QUIZZER or certain questions may be selected based on a
  112.           list of keywords. Graphics images for use with PC-QUIZZER may be
  113.           created with any graphics program, painting package or an
  114.           application program. 
  115.  
  116.           Another PC-QUIZZER option permits answers that are "almost
  117.           correct." This feature allows minor misspelled words to be
  118.           accepted if the response is "similar" to the correct answer. For
  119.           example: The response "Georg Washington" may be considered
  120.           correct as the answer to "Who was the first President of the
  121.           United States?" 
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                           2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.           PC-QUIZZER can be used for instruction in almost any subject
  142.           including foreign languages, history, science, math, vocabulary
  143.           and word definitions. It may also be used to ask trivia questions
  144.           at your next party for hours of fun. PC-QUIZZER is an excellent
  145.           educational tool and a must for everyone involved with learning
  146.           or teaching. 
  147.  
  148.  
  149.                                      AVAILABILITY
  150.  
  151.           PC-QUIZZER is available for the IBM PC and most compatibles.
  152.           PC-QUIZZER requires only one disk drive and either a Monochrome,
  153.           CGA, EGA, MCGA or VGA graphics adapter. The system should have at
  154.           least 384K of RAM memory. Color Graphics is only supported on
  155.           graphics adapters compatible with those made by IBM.
  156.  
  157.  
  158.                                 OPERATING INSTRUCTIONS
  159.  
  160.           PC-QUIZZER is executed by typing QUIZ from the ">" prompt.
  161.           PC-QUIZZER will begin by displaying the title screen. Press the
  162.           Return key to continue to the main menu. 
  163.  
  164.           The main menu contains several options which are used to load
  165.           files and set parameters which control the way PC-QUIZZER
  166.           operates. Simply press the key corresponding to the appropriate
  167.           menu option. 
  168.  
  169.           The following section describes in greater detail the main menu
  170.           options and how they are used. 
  171.  
  172.  
  173.                                   MAIN MENU OPTIONS
  174.  
  175.                                A - Allow Approx. Match
  176.  
  177.           This option may be used to enable or disable PC-QUIZZER from
  178.           allowing minor misspelled answers from being accepted as correct.
  179.  
  180.           If this parameter is set to NO, the student must enter the answer
  181.           exactly as specified in the QUIZ file. Only an exact match will
  182.           be accepted. PC-QUIZZER will always accept answers in either
  183.           upper or lower case. 
  184.  
  185.           When this parameter is set to YES, PC-QUIZZER will determine if
  186.           the answer entered by the student is "almost" like one of the
  187.           correct answers given in the question entry. This feature may be
  188.           used when the student should not be penalized for a minor
  189.           misspelling of the answer. 
  190.  
  191.  
  192.  
  193.  
  194.                                           3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.                                     B - Begin Quiz
  208.  
  209.           This option is used to begin a quiz. Before you may begin a quiz
  210.           you must load one into the computer by using either Option L or
  211.           Option K. After the quiz has completed you may repeat the quiz
  212.           again by selecting Option B a second time without the need to
  213.           reload the quiz file. Also see Option M. 
  214.  
  215.                               C - Display Correct Answer
  216.  
  217.           This option is used to control if the correct answer is displayed 
  218.           whenever the student enters an incorrect answer. 
  219.  
  220.           If this parameter is set to NO, the correct answer will not be
  221.           displayed. If this parameter is set to YES, the correct answer
  222.           will be shown to the student. You may choose to set this option
  223.           to YES while the student is studying the subject matter or is
  224.           taking a practice quiz. 
  225.  
  226.           Note: Should the question contain multiple correct answers, only
  227.           the first correct answer will be displayed. Also see $ANSWER. 
  228.  
  229.  
  230.                                    E - Exit Program
  231.  
  232.           This option will cause PC-QUIZZER to exit back to MS-DOS. 
  233.  
  234.  
  235.                                 H - Display Help Lines
  236.  
  237.           This option controls whether PC-QUIZZER displays HELP lines
  238.           during the quiz.
  239.  
  240.           If this parameter is set to YES, the student may request help by
  241.           entering a question mark while at the answer prompt. PC-QUIZZER
  242.           will display a window containing any HELP lines given in the
  243.           question entry. If this parameter is set to NO, then the help
  244.           text will not be displayed. 
  245.            
  246.           If no help is available for a question and the student asks for
  247.           help, an error message will be displayed in the error window.
  248.           This parameter should be set to YES during drill and practice
  249.           sessions. Also see $HELP under the commands section.
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                           4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                                  I - Immediate Retry
  274.  
  275.           This option is used to control whether the student will be given
  276.           a second (or third) chance to correctly answer a question. 
  277.  
  278.           If the Immediate Retry option is set to YES, the student is given
  279.           three attempts to supply a correct answer to a question. If the
  280.           Immediate Retry option is set to NO, the student will be given
  281.           only one try to enter the correct answer. If the student enters
  282.           an incorrect answer, the question will be graded as wrong. 
  283.  
  284.           The student may retry the missed question at a later time by
  285.           choosing option M on the main menu. Also see Option M. 
  286.  
  287.                                    K - Keyword Load
  288.  
  289.           This option performs the same function as Option L except that
  290.           the student may specify a list of keywords. The keywords are used
  291.           to select questions from the quiz file. 
  292.  
  293.           After the student has specified the quiz filename, PC-QUIZZER
  294.           will display a keyword window. The keywords are entered into this
  295.           window, and the arrow keys may be used to move around the inside
  296.           of the window. When all the keywords have been entered the END
  297.           key is used to terminate the list. The keywords may be entered in
  298.           either upper or lower case.
  299.  
  300.           When searching the quiz file, PC-QUIZZER will select only those
  301.           questions which contain one or more of the keywords within the
  302.           text of the question. Also see Option L and $KEY under the
  303.           commands section.
  304.  
  305.           Example: Use Option K to load the STATES demo file and specify
  306.           the name of your state and the name of each of your adjacent
  307.           states. 
  308.  
  309.                                      L - Load All
  310.  
  311.           This option is used to Load All questions from a quiz file. All
  312.           of the questions will be loaded and selected. After the quiz file
  313.           has been loaded, select Option B to begin the quiz. Also see
  314.           Option K.
  315.  
  316.                                   M - Repeat Missed
  317.  
  318.           After completing a quiz, Option M may be used to repeat any
  319.           questions that were missed. Option M may be repeated over and
  320.           over again until no more questions are missed. The "Wrong:" field
  321.           on the main menu indicates the number of questions which will be
  322.           selected if Option M is specified.
  323.  
  324.  
  325.  
  326.                                           5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.                                    R - Random Mode
  340.  
  341.           This option tells PC-QUIZZER to randomize the questions before
  342.           they are asked. This is a very useful study technique. Random
  343.           mode is the opposite of Sequential Mode. Also see Option S. 
  344.  
  345.  
  346.                                  S - Sequential Mode
  347.  
  348.           This option is the opposite of random mode. If sequential mode is
  349.           specified, PC-QUIZZER will present the questions in the same
  350.           order as they appear in the quiz file. This is the default mode.
  351.           Also see Option R.
  352.  
  353.  
  354.                                   V - VOTRAX Output
  355.  
  356.           If your computer has a VOTRAX Type'n Talk, Personal Speech
  357.           System, or ECHO synthesizer, you may select option V to enable
  358.           speech output. PC-QUIZZER will "speak" the questions and other
  359.           messages to the student.
  360.  
  361.           Note: PC-QUIZZER requires an initialization file to define the
  362.           synthesizer communications port. Registered user should contact
  363.           Data Assist for an Applications Note which describes how to set
  364.           up the port before using a speech device. Registered users with a
  365.           speech synthesizer other than those previously listed should
  366.           contact Data Assist for support.
  367.  
  368.  
  369.                                    CREATING LESSONS
  370.  
  371.           Lesson files, or quiz files, may be created using any standard
  372.           text editor or word processor. If a word processor is used be
  373.           sure that the non-document or ASCII mode is used. 
  374.  
  375.           Questions are organized into question entries. Each entry
  376.           contains the text of the question, one or more correct answers,
  377.           any anticipated incorrect answers and optional text to be
  378.           displayed for various conditions. As you will soon discover,
  379.           other there are many other PC-QUIZZER commands that may be used
  380.           in a question entry. 
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                           6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.                                    SIMPLE COMMANDS
  406.  
  407.           The question entry starts with a $QUESTION command and ends with
  408.           a $EOQ command. Each line of text between these two commands is
  409.           part of the question entry. Each question entry must also have at
  410.           least one $ANSWER command.
  411.  
  412.           Example:
  413.  
  414.           $QUESTION
  415.           What is 1+1? 
  416.           $ANSWER 2
  417.           $EOQ
  418.  
  419.  
  420.           Each PC-QUIZZER command begins with a dollar sign which must
  421.           start in column one. The command name may be abbreviated to three
  422.           character, but no less! 
  423.  
  424.           Lets take a more detailed look at the three simple commands.
  425.  
  426.  
  427.           $QUESTION
  428.  
  429.           Syntax: $QUESTION [name] 
  430.  
  431.           This command marks the beginning of a question. The question may
  432.           optionally contain a name from 1 to 8 characters in length.
  433.           Although you do not need to name a question, if a name is used,
  434.           it should be unique.
  435.  
  436.           Following the $QUESTION statement is the body of the question.
  437.           This text is displayed in the question window when PC-QUIZZER
  438.           asks the student this question. 
  439.  
  440.  
  441.           $ANSWER
  442.  
  443.           Syntax: $ANSWER answer-string 
  444.  
  445.           The $ANSWER command tells PC-QUIZZER what the correct answer to a
  446.           question is. A question may contain multiple correct answers but
  447.           each correct answer must be specified on a different $ANSWER
  448.           command. 
  449.  
  450.           After the $ANSWER statement you may have additional lines of
  451.           text. These lines will be displayed in the question window if the
  452.           "answer-string"  matches the answer given by the student. If your
  453.           question has multiple correct answers, you may have different
  454.           responses for each of the possible correct answers.
  455.  
  456.  
  457.  
  458.                                           7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.           $EOQ
  472.  
  473.           Syntax:   $EOQ 
  474.  
  475.           This command marks the End Of the Question (EOQ). It must be the
  476.           last statement in the question entry. Its purpose is to mark the
  477.           end of the question and all the additional commands and text
  478.           lines which are part of the question entry. 
  479.  
  480.  
  481.                             HELP AND INFORMATION COMMANDS
  482.  
  483.           $HELP
  484.  
  485.           Syntax: $HELP 
  486.  
  487.           The $HELP command marks the beginning of a HELP block. The lines
  488.           following the $HELP statement (until the next command) will be
  489.           displayed if the student enters a "?" at the Answer prompt. If
  490.           menu option H is set to OFF then PC-QUIZZER will not provide the
  491.           student with any help. 
  492.  
  493.           The HELP text is displayed in the HELP window. 
  494.  
  495.  
  496.           $RIGHT
  497.  
  498.           Syntax: $RIGHT 
  499.  
  500.           The $RIGHT command begins a block of text which is displayed
  501.           whenever the student enters any answer that is correct. This 
  502.           statement is typically used when the question contains multiple
  503.           correct answers. 
  504.  
  505.  
  506.           $WRONG
  507.  
  508.           Syntax: $WRONG 
  509.  
  510.           The $WRONG command is similar to the $RIGHT command except that
  511.           the block of text is displayed only if the student enters a wrong
  512.           answer. 
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                           8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.           $NOT
  538.  
  539.           Syntax: $NOT incorrect-answer-string 
  540.  
  541.           The $NOT command is similar to the $ANSWER command except that it
  542.           specifies an incorrect answer. The text block following the $NOT
  543.           statement will be displayed in the question window if the student
  544.           enters an incorrect answer which matches the incorrect-answer-
  545.           string. A question entry may contain multiple $NOT commands.
  546.  
  547.  
  548.           $RANGE
  549.  
  550.           Syntax: $RANGE low-value high-value
  551.  
  552.           The $RANGE command provides an easy way to specify a numeric
  553.           answer range. The two parameters indicate the low-value and the
  554.           high-value of the correct answer.
  555.  
  556.           After the $RANGE statement you may have additional lines of text.
  557.           These lines are displayed if the student's answer falls within
  558.           the specified range. A question entry may contain multiple $RANGE
  559.           commands.
  560.  
  561.           Example:
  562.  
  563.           $QUE
  564.           What is the square root of 2?
  565.           $RANGE 1.4140 1.4143
  566.           $ANS 1.41421
  567.           $EOQ
  568.  
  569.           Note: Every question must have at least one $ANSWER command, even
  570.           if the question contains a $RANGE command.
  571.  
  572.  
  573.                                COLOR GRAPHICS COMMANDS
  574.  
  575.           PC-QUIZZER supports color graphics through the use of BSAVE and
  576.           PCX graphics files. PCX files require less disk space than BSAVE
  577.           and support most of the graphic modes used on PC's. Several
  578.           painting packages are also capable of creating PCX graphics
  579.           files. 
  580.  
  581.           Data Assist offers a graphics screen capture program (ARGUS)
  582.           which supports all the PCX video display modes. PC-QUIZZER users
  583.           who plan to create graphics screens may wish to purchase the
  584.           ARGUS utility. 
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                           9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.           BSAVE files are still supported in order to maintain
  604.           compatibility with previous versions of PC-QUIZZER. Data Assist
  605.           recommends that customers switch to using PCX files. 
  606.  
  607.  
  608.           $CGA
  609.  
  610.           Syntax: $CGA mode picture-file-name 
  611.  
  612.           The $CGA command is used to display a BSAVE color graphic image.
  613.           The mode parameter specifies the video mode needed to display the
  614.           graphic image. Currently only modes 4, 5 (medium resolution) and
  615.           6 (high resolution) are supported.
  616.  
  617.           Picture-file-name is the name of a disk file which contains the
  618.           graphic image. The complete file path name must be given. The
  619.           graphic image must be stored in BSAVE format. Also see the
  620.           $PCOLOR command. 
  621.  
  622.  
  623.           $PCOLOR
  624.  
  625.           Syntax: $PCOLOR palette-number 
  626.  
  627.           Before using the $CGA command you should set the desired
  628.           pallet-number by using the $PCOLOR command. The palette-number
  629.           may be either 0 or 1 on a Color Graphics Adapter. 
  630.  
  631.  
  632.           $PAINT
  633.  
  634.           Syntax: $PAINT x-loc y-loc color-code 
  635.  
  636.           The $PAINT command is used to paint an area of the screen. The
  637.           x-loc and y-loc specify the starting x and y location of the area
  638.           to paint. PC-QUIZZER will paint the area using the color-code
  639.           specified. The area to be painted must be outlined with a color
  640.           different from the present color of the area. See demo file
  641.           USA.QIZ. 
  642.  
  643.           Note: $PAINT should NOT be used to paint complex areas of the
  644.           screen. Doing so may cause the stack to overflow and the PC to
  645.           lock up!!!
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                           10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.           $ASK
  670.  
  671.           Syntax: $ASK prompt-string 
  672.  
  673.           The purpose of the $ASK command is to prompt the student for an
  674.           answer while a graphics image is displayed. If the $ASK command
  675.           is not used, PC-QUIZZER will return to the text screen and prompt
  676.           the student for an answer. If $ASK is used while a text screen is
  677.           currently displayed, it will be ignored. See demo file USA.QIZ. 
  678.  
  679.  
  680.           $PCX
  681.  
  682.           Syntax: $PCX mode pcx-file 
  683.  
  684.           The $PCX command is used to display a graphics file stored in PCX
  685.           format. The mode parameter represents the graphics mode needed to
  686.           display the picture. The mode also defines the Horizontal and
  687.           Vertical dimensions of the picture as well as the number of
  688.           colors: (HORIZONTAL x VERTICAL x COLOR):
  689.  
  690.                0 - CGA (320 x 200 x 4) 
  691.                1 - CGA (640 x 200 x 2) 
  692.                2 - EGA (320 x 200 x 16)
  693.                3 - EGA (640 x 200 x 16)
  694.                4 - EGA (640 x 350 x 2)
  695.                5 - EGA (640 x 350 x 16)
  696.                6 - VGA (640 x 480 x 2) [also used on MCGA]
  697.                7 - VGA (640 x 480 x 16)
  698.                8 - VGA (320 x 200 x 256) [also used on MCGA]
  699.                9 - Hercules (720 x 384 x 2)
  700.  
  701.           Example:
  702.  
  703.           $PCX 8 BUNNY.PCX
  704.  
  705.           This command will display a picture of a bunny using 256 colors
  706.           on a VGA or MCGA graphics system. 
  707.  
  708.           Note: Only modes 0, 1, 6 and 8 are supported in PC-QUIZZER. All
  709.           modes are supported in PC-QUIZZER+. The ARGUS utility (available
  710.           from Data Assist) is required to capture a PCX graphics screen.
  711.           Although many other products are capable of creating PCX files,
  712.           Data Assist can only guaranty the products that we sell!
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                           11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                           COLOR AND MONOCHROME TEXT COMMANDS
  736.  
  737.           When using a color monitor you may wish to display characters of
  738.           different colors in your questions. This is accomplished by use
  739.           of the $TEXT, $TCOLOR and $TATTRIB commands.
  740.  
  741.  
  742.           $TEXT
  743.  
  744.           Syntax: $TEXT text-string 
  745.  
  746.           The $TEXT command displays the text-string in the question
  747.           window. If the text string contains sub-strings enclosed inside
  748.           of {} characters, these sub-strings will be colored using the
  749.           color codes specified by the $TCOLOR or $TATTRIB commands. Each
  750.           group of sub-strings may be colored differently. Up to ten
  751.           sub-strings may occur within one text-string. 
  752.  
  753.  
  754.           $TCOLOR
  755.  
  756.           Syntax: $TCOLOR index f-color b-color [BLINK] 
  757.  
  758.           The $TCOLOR command defines a foreground color and background
  759.           colors for use with the $TEXT command. The index may range from 1
  760.           to 10. You may optionally use the modifier BLINK to select a
  761.           blinking color. The $TCOLOR statement must come before the first
  762.           $TEXT statement within the question entry. 
  763.  
  764.           Up to ten different color groups may be defined and used per
  765.           $TEXT command. Once the colors are defined by $TCOLOR, they may
  766.           be used by multiple $TEXT commands within the same question
  767.           entry. See demo file TCOLOR.QIZ.
  768.  
  769.           The color codes which may be specified for f-color and b-color
  770.           are: Black, Blue, Green, Cyan, Red, Magenta, Brown, White, Grey,
  771.           LBlue, LGreen, LCyan, LRed, LMagenta, Yellow and LWhite. 
  772.  
  773.           Example:
  774.  
  775.           $QUE 
  776.           $TCOLOR 1 BLACK WHITE
  777.           $TCOLOR 2 WHITE BLACK BLINK
  778.           $TCOLOR 3 RED BLACK
  779.           $TEXT This is {Reversed}. This is {Blinking}. This is {RED}. 
  780.           And this is a normal line of text... 
  781.           $TEXT What does {1+1} equal? 
  782.           $ANS 2 
  783.           $EOQ 
  784.  
  785.  
  786.  
  787.  
  788.                                           12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.           $TATTRIB
  803.  
  804.           Syntax: $TATTRIB index f-attrib b-attrib 
  805.  
  806.           The $TATTRIB command provides an alternate, shorthand method to
  807.           specify foreground and background colors. This command performs
  808.           the same function as $TCOLOR. However numeric attribute (color)
  809.           codes are used rather than the symbolic codes as used by $TCOLOR.
  810.           $TATTRIB also provides the ability to specify attributes for use
  811.           with Monochrome monitors and color display adapters which use
  812.           non-standard color attributes. See demo file MONO.QIZ.
  813.  
  814.  
  815.  
  816.                                  ADDITIONAL COMMANDS
  817.  
  818.           $KEY
  819.  
  820.           Syntax: $KEY keyword-1 keyword-2 ... 
  821.  
  822.           The $KEY command gives the author the ability to specify keywords
  823.           in a question entry. The keyword(s) specified on the $KEY
  824.           statement are used by the Keyword Load Option (K) to select
  825.           questions based on keywords. 
  826.  
  827.  
  828.           $PRESS
  829.  
  830.           Syntax: $PRESS 
  831.  
  832.           The $PRESS command will cause PC-QUIZZER to display "Press Enter
  833.           to continue" in the answer window. The lesson will pause until
  834.           the student presses the Enter key or the Return key. The command
  835.           may be used to divide up a large question into paragraphs that
  836.           fit inside of the question window. 
  837.  
  838.           Another use for the $PRESS command is just prior to the use of a
  839.           $CGA command. This allows the student an opportunity to read a
  840.           question before being presented with a graphic image.
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                           13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.           $PLAY
  868.  
  869.           Syntax: $PLAY music-string 
  870.  
  871.           The $PLAY command is used to play music. The music string
  872.           contains an expression which describes the music to be played.
  873.           The music string uses a format similar to the PLAY statement in
  874.           BASIC. See demo file MUSIC.QIZ.
  875.  
  876.                A-G: plays this note in the current octave. 
  877.                On: sets n as the current octave. (0..6) 
  878.                Nn: plays note n. (0..84) 
  879.                Ln: set the length of the following notes. (1..64) 
  880.                Pn: set the length of a rest. (1..64) 
  881.                Tn: sets the number of quarter notes in a minute (32..255) 
  882.                >n: plays note n in the next higher octave. 
  883.                <n: plays note n in the next lower octave. 
  884.                ML: play complete period of Ln value. 
  885.                MN: play 7/8 time of Ln value. 
  886.                MS: play 3/4 time of Ln value. 
  887.  
  888.           Example:
  889.  
  890.           $QUE 
  891.           Name this tune... 
  892.           $PLAY T120L4MNO4C8C8DCFE2C8C8DCGF2C8C8O5CO4A 
  893.           $PLAY FED2T90B-8B-8AFGF2 
  894.           $ANS HAPPY BIRTHDAY 
  895.           That was an easy one. 
  896.           $EOQ 
  897.  
  898.  
  899.           $SLEEP
  900.  
  901.           Syntax: $SLEEP seconds 
  902.  
  903.           The $SLEEP command causes PC-QUIZZER to sleep for the specified
  904.           number of seconds. If any key is pressed while PC-QUIZZER is
  905.           sleeping, the program will continue.
  906.  
  907.  
  908.           $TALK
  909.  
  910.           Syntax: $TALK speech-string
  911.  
  912.           This command will output the speech-string on a speech
  913.           synthesizer.
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                           14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                                   ADVANCED COMMANDS
  934.  
  935.           $CHOICE
  936.  
  937.           Syntax: $CHOICE style
  938.  
  939.           The $CHOICE command is used to display a menu of answers. The
  940.           student selects their answer by using the arrow keys on the
  941.           keypad. The style parameter is used to indicate the type of
  942.           answer that is expected. The valid style parameters are:
  943.  
  944.                K - when a K-type answer is needed.
  945.                T - when a True/False answer is needed. 
  946.                C - when a single Character answer is needed.
  947.                N - when a Numeric answer is needed.
  948.                X - when an eXact answer is needed.
  949.  
  950.           The lines following the $CHOICE command are used as the items on
  951.           the menu. The menu is presented to the student using a scroll-bar
  952.           window. When style K or T is specified, PC-QUIZZER generates the
  953.           menu automatically.
  954.  
  955.           The answer for the question (specified with the $ANSWER command)
  956.           must contain the correct number of characters:
  957.  
  958.                K - 1 character: A, B, C, D or E
  959.                T - 1 character: T or F.
  960.                C - 1  - Must match the first character of the answer.
  961.                N - 1 to 70 - Must exactly match the answer.
  962.                X - 1 to 70 - Must exactly match the answer.
  963.  
  964.           Example:
  965.  
  966.           $QUE
  967.           In what month was George Washington born?
  968.           $CHOICE C
  969.           A. January
  970.           B. February
  971.           C. March
  972.           D. April
  973.           E. May
  974.           $ANS B
  975.           $EOQ
  976.  
  977.           Note: Sample file CHOICE.QIZ provides additional examples showing
  978.           the use of the $CHOICE command. 
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                           15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.           $KTYPE
  1000.  
  1001.           Syntax: $KTYPE code 
  1002.  
  1003.           PC-QUIZZER provides a facility to accept K-type questions. The
  1004.           K-type question format is often used on professional
  1005.           examinations.
  1006.  
  1007.           A K-type question contains 4 items of which 1 or more are true.
  1008.           The answer is either A, B, C, D, or E and is formed using these
  1009.           fixed rules: 
  1010.  
  1011.                The answer is A if items 1, 2 and 3 are true. 
  1012.                The answer is B if items 1 and 3 are true. 
  1013.                The answer is C if items 2 and 4 are true. 
  1014.                The answer is D if only item 4 is true. 
  1015.                The answer is E if items 1, 2, 3 and 4 are true. 
  1016.  
  1017.           Example:
  1018.  
  1019.           $QUE 
  1020.           Which of the following Presidents were in office before 1850?
  1021.  
  1022.                1. George Washington 
  1023.                2. Ronald Reagan 
  1024.                3. Andrew Jackson 
  1025.                4. Abraham Lincoln
  1026.           $ANS B 
  1027.           $! B means that 1 and 3 are true.
  1028.           $KTYPE 1 
  1029.           George Washington's term began in 1789.
  1030.           $KTYPE 2 
  1031.           Ronald Reagan's term began in 1981.
  1032.           $KTYPE 3 
  1033.           Andrew Jackson's term began in 1829.
  1034.           $KTYPE 4 
  1035.           Abraham Lincoln's term began in 1861.
  1036.           $EOQ 
  1037.  
  1038.           The correct answer in this example is B, which means that (1)
  1039.           George Washington and (3) Andrew Jackson were both in office
  1040.           before 1850 and the others were not. 
  1041.  
  1042.           Should the student incorrectly answer this question, PC-QUIZZER
  1043.           will use the text following the corresponding $KTYPE statement to
  1044.           display why the specified answer was wrong.
  1045.  
  1046.           Note: In order for PC-QUIZZER to properly ask a K-type question,
  1047.           the above format must be used. For more insight into using K-type
  1048.           questions load the file KTYPE.QIZ from the distribution disk. 
  1049.  
  1050.  
  1051.  
  1052.                                           16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.           Note: KTYPE questions may not be used in conjunction with Graphic
  1066.           Screens.
  1067.  
  1068.  
  1069.  
  1070.                                 ADDITIONAL INFORMATION
  1071.  
  1072.           PC-QUIZZER may be used on a Monochrome Monitor or a Color
  1073.           Graphics Monitor. The program defines 6 windows which are used
  1074.           for all screen displays. They are numbered as follows: 
  1075.  
  1076.                1 - Main Menu Window 
  1077.                2 - Question & File Load Window 
  1078.                3 - Answer Window 
  1079.                4 - Help & Keyword Load Window 
  1080.                5 - Error Window 
  1081.                6 - Grade Window 
  1082.  
  1083.           On a Monochrome system each window appears the same color. On a
  1084.           color system PC-QUIZZER defines each window using just black and
  1085.           white. If you have a color monitor, you may find it desireable to
  1086.           display the text windows using different colors as this makes the
  1087.           presentation more attractive. This may be done by typing the
  1088.           command COLOR from the MS-DOS prompt before you start PC-QUIZZER.
  1089.  
  1090.  
  1091.           Example:
  1092.  
  1093.                C> COLOR
  1094.                C> QUIZ
  1095.  
  1096.  
  1097.           PC-QUIZZER uses direct memory I/O to the video screen. While this
  1098.           technique is very fast, it is also prone to not work correctly on
  1099.           some not-so-compatible computers. Please contact Data Assist if
  1100.           you are having any problems using PC-QUIZZER on your video
  1101.           system. 
  1102.  
  1103.                                          ---
  1104.  
  1105.           PC-QUIZZER permits all responses to be entered in upper or lower
  1106.           case. This includes menu options as well as keywords and question
  1107.           answers.
  1108.  
  1109.                                          ---
  1110.            
  1111.           When entering True/False questions into the quiz file, the author
  1112.           should enter "$ANSWER T" or "$ANSWER F" as the correct answer.
  1113.           This will enable the student to enter "T", "F", "TRUE" or "FALSE"
  1114.           as their answer. 
  1115.  
  1116.  
  1117.  
  1118.                                           17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.                                      RESTRICTIONS
  1134.  
  1135.           For PC-QUIZZER a maximum of 100 questions may be entered into a
  1136.           question file. PC-QUIZZER+ allows up to 300 questions per file.
  1137.           Depending on the size of the questions and amount of memory in
  1138.           your computer, it is possible to exceed memory before all of the
  1139.           questions have been loaded. 
  1140.  
  1141.                                          ---
  1142.  
  1143.           The length of each quiz text line should not exceed 100
  1144.           characters. 
  1145.  
  1146.  
  1147.  
  1148.                                     ERROR MESSAGES
  1149.  
  1150.  
  1151.           Can't open the quiz file. Please try again -- The quiz file
  1152.           specified does not exist or the filename was entered incorrectly.
  1153.  
  1154.  
  1155.           Illegal CGA mode -- Only CGA modes 4, 5 and 6 are supported in
  1156.           this version of PC-QUIZZER. See section on $CGA command. 
  1157.  
  1158.           Illegal command or parameter -- A command was read from the quiz
  1159.           file which is either an unknown command or is a legal command
  1160.           which contains an illegal parameter. Correct the statement and
  1161.           try again. 
  1162.  
  1163.           Maximum of 100 questions loaded -- A maximum of 100 questions
  1164.           were loaded from the quiz file. PC-QUIZZER will only use the
  1165.           first 100 questions on the quiz. 300 questions for PC-QUIZZER+.
  1166.  
  1167.           No questions are currently selected -- Before entering option B
  1168.           to begin a quiz, you must load a quiz file using either option K
  1169.           (Keyword Load) or option L (Load All). 
  1170.  
  1171.           No questions were missed -- An attempt has been made to use
  1172.           option M when there are no questions marked as being missed. See
  1173.           discussion of option M. 
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.                                           18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.           Not enough memory -- PC-QUIZZER was unable to allocate enough
  1198.           memory to work correctly. For most quiz files, 384K of memory
  1199.           should be sufficient. 
  1200.  
  1201.           Question entry is missing an answer -- A question does not
  1202.           contain an $ANSWER statement. PC-QUIZZER will skip this question.
  1203.  
  1204.           Quiz file is empty. Please try another file -- The file you are
  1205.           trying to load into PC-QUIZZER does not contain any questions.
  1206.           Are you sure that you specified the correct name of a quiz file? 
  1207.  
  1208.           This question does not have an answer. Skipping on -- PC-QUIZZER
  1209.           is trying to ask you a question which does not have an answer.
  1210.           Edit the quiz file and be sure that each question entry has at
  1211.           least one $ANSWER command with the correct answer specified. See
  1212.           also $ANSWER. 
  1213.  
  1214.           Too many lines read -- The quiz file you are loading is too big
  1215.           for the version of PC-QUIZZER that you have. (3000 lines) Make
  1216.           the quiz smaller and try again. 
  1217.  
  1218.           Unable to display PCX screen -- While executing a $PCX command,
  1219.           PC-QUIZZER was unable to display the picture. Make sure that the
  1220.           picture file exists on your disk. This error can also occur if
  1221.           PC-QUIZZER attempts to display a picture and you do not have the
  1222.           appropriate graphics hardware.
  1223.  
  1224.           Unable to load picture -- While executing a $CGA or $MCGA
  1225.           command, PC-QUIZZER was unable to locate the file which contains
  1226.           the graphic image. Make sure that the picture file exists in the
  1227.           path you specified on the command.
  1228.  
  1229.           Unable to open VOTRAX port -- PC-QUIZZER could not open the port 
  1230.           which drives the VOTRAX unit. Make sure that the port is
  1231.           configured into your system.
  1232.  
  1233.           VOTRAX port is unknown to PC-QUIZZER -- Prior to using the VOTRAX
  1234.           device with PC-QUIZZER you must create an initialize file which
  1235.           sets up the port. Contact Data Assist for support.
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                           19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.                                      SAMPLE FILES
  1264.  
  1265.           Several sample quiz files have been included on the distribution
  1266.           diskette. These files are intended to show examples of the format
  1267.           used to build your own lesson files. We suggest that you
  1268.           experiment with these files to help you better understand how to
  1269.           use PC-QUIZZER. 
  1270.  
  1271.  
  1272.  
  1273.                                        REQUESTS
  1274.  
  1275.           Data Assist has designed PC-QUIZZER to be both flexible and easy
  1276.           to use. Like any software package there are numerous improvements
  1277.           and additions which could be made. We have received several
  1278.           requests and invite you to submit written requests at any time.
  1279.            
  1280.           Registered users are asked to "vote" for the requests that they
  1281.           would like to see implemented. To vote, simply mail us a letter
  1282.           indicating which requests from the list below you would like to
  1283.           see implemented. Those items which get the most votes will get
  1284.           the most attention in future releases. Be sure to include your
  1285.           own requests or comments if you have any.
  1286.  
  1287.  
  1288.           REQ001: Add EGA graphics support. (Available in PC-QUIZZER+)
  1289.  
  1290.           REQ002: Add an $INCLUDE command to include files.
  1291.  
  1292.           REQ003: Save scores on disk with student names. Also a list of
  1293.           which questions they missed would be nice. (Available in PC-
  1294.           QUIZZER+).
  1295.  
  1296.           REQ004: Allow colors to be used in help messages. 
  1297.  
  1298.           REQ005: Would like to save a quiz in the middle and resume at a
  1299.           later time. 
  1300.  
  1301.           REQ006: Need to have multiple part questions, i.e., here is some
  1302.           text, and these five questions are about this text. The GMAT has
  1303.           questions like this. 
  1304.  
  1305.           REQ007: Would like to be able to change menu options like
  1306.           A,C,H,R,S and I in the middle of the quiz. 
  1307.  
  1308.           REQ008: Would like to "preview" a quiz, i.e., have the computer
  1309.           ask the questions and show me the answer. Then I can practice
  1310.           typing in the answers. Later on I will take the quiz and enter
  1311.           the answers the normal way. Many times I just want to learn how
  1312.           to spell the answers and this would sure help. 
  1313.  
  1314.  
  1315.  
  1316.                                           20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.           REQ009: Provide an option to scan a quiz and mark the questions
  1330.           to be selected. It would be nice if the selected questions could
  1331.           be written back to disk as another quiz.
  1332.  
  1333.           REQ010: Sometimes I find typo errors in my questions. I'd like to
  1334.           be able to call up an editor while in PC-QUIZZER and fix it. An
  1335.           integrated Editor would be perfect!
  1336.  
  1337.           REQ011: For very large questions, I'd like to be able to scroll
  1338.           back and forth in the window. Need this capability on the HELP
  1339.           window too.
  1340.  
  1341.           REQ012: I would like to say "Skip question M if I got question N
  1342.           right." Or "Skip question M if I got question N wrong..." 
  1343.  
  1344.           REQ013: Need to have numeric answer ranges. (Now available).
  1345.  
  1346.           REQ014: The ability to load selected questions from multiple quiz
  1347.           files using keywords. The ability to load all questions from
  1348.           multiple files. 
  1349.  
  1350.  
  1351.                                    ACKNOWLEDGEMENTS
  1352.  
  1353.           PC-QUIZZER was written in Turbo C from Borland International.
  1354.           About 10% of the code is assembler.  We have found the Turbo C
  1355.           compiler to be very fast and highly recommend it.
  1356.  
  1357.           A special thanks to our customers (and even some non-customers)
  1358.           who have provided us with numerous ideas, suggestions and
  1359.           requests. 
  1360.  
  1361.  
  1362.  
  1363.                                       TRADEMARKS
  1364.  
  1365.           MS-DOS is a registered trademark of Microsoft.
  1366.           IBM-PC is a registered trademark of IBM Corporation. 
  1367.           PC-QUIZZER is a trademark of Data Assist.
  1368.           Turbo C is a registered trademark of Borland International. 
  1369.           VOTRAX and Type'n Talk are trademarks of VOTRAX Corporation. 
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.                                           21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.