home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / joystick / rd_stk / rd_stk.doc < prev    next >
Encoding:
Text File  |  1992-03-01  |  5.9 KB  |  193 lines
  1.  
  2.  
  3.                               RD_STK. V1.1
  4.  
  5.                      ( Turbo C ) Joy Stick Toolbox
  6.  
  7.  
  8.                             Earle Cooley
  9.                           2268 Glenmoor Rd S
  10.                        Clearwater Florida  34624
  11.  
  12.  
  13.  
  14.                              INTRODUCTION
  15.                              ------------
  16.  
  17.    RD_STK is a software "toolbox" of routines for programs written in
  18.    BORLAND's TURBO C.There only two function calls that are used to
  19.    read the game port & they are described below. Also included is a
  20.    function to control the cursor.
  21.  
  22.                      Distribution List
  23.                    ----------------------
  24.  
  25.  1.0   RD_STK.ZIP
  26.  
  27.     The distribution you have received should contain the
  28.         following:
  29.  
  30.         o RD_DEMO.C     Source code for sample program.
  31.  
  32.         o RD_DEMO.EXE   A sample program that uses RD_STK.
  33.  
  34.         o RD_DEMO.PRJ   Project file for Demo.c .
  35.  
  36.         o RD_STK.DOC    This document
  37.  
  38.         o RD_STK.H      The header file to be included at the top
  39.                            of all C source files that reference
  40.                            RD_STK functions
  41.                            (Contains function prototypes & constants).
  42.  
  43.         o RD_STK.OBJ    Turbo C object code by which the RD_STK
  44.                            get it's functions from.
  45.  
  46.  
  47.  
  48.  2.0   Adding RD_STK to your Turbo C programs
  49.  
  50.        To use RD_STK in your own TURBO C programs simply include the
  51.        object file RD_STK.OBJ at the end of your project file and call
  52.        the RD_STK functions described below from within your application
  53.        program.
  54.  
  55.  
  56.  2.1   GET_JOYBUTTON
  57.  
  58.  2.1.1 DESCRIPTION:
  59.  
  60.        GET_JOYBUTTON - Gets the current activation of the Joy Stick(s)
  61.                        Buttons & returns them.
  62.  
  63.  2.1.2 PROTOTYPE:
  64.  
  65.          void get_joybutton(int stk1_b1,int stk1_b2,int stk2_b1,int stk2_b2)
  66.  
  67.   2.1.3 ARGUMENTS:
  68.          stk1_b1 == 0 ( joystick A button one is off)
  69.          stk1_b1 == 1 ( joystick A button one is on )
  70.          stk1_b2 == 0 ( joystick A button one is off)
  71.          stk1_b2 == 1 ( joystick A button one is on )
  72.  
  73.          stk2_b1 == 0 ( joystick B button one is off )
  74.          stk2_b1 == 1 ( joystick B button one is on  )
  75.          stk2_b1 == 0 ( joystick B button one is off )
  76.          stk2_b1 == 1 ( joystick B button one is on  )
  77.  
  78.   2.1.4 SAMPLE USAGE:
  79.  
  80.          get_joybutton(&stk1_b1,&stk1_b2,&stk2_b1,&stk2_b2);
  81.  
  82.   2.2 GET_JOY_POS()
  83.  
  84.   2.2.1 DESCRIPTION:
  85.  
  86.         GET_JOY_POS - Gets the current count accumulated from the Joy Stick(s)
  87.                       and returns them.
  88.  
  89.   2.2.2 PROTOTYPE:
  90.  
  91.         void  get_ joy_pos(int stk1_x,int stk1_y,int stk2_x,int stk2_y)
  92.  
  93.  
  94.   2.2.3 ARGUMENTS:
  95.  
  96.         stk1_x =  joystick A X axis count
  97.         stk1_y =  joystick A Y axis count
  98.         stk2_x =  joystick B X axis count
  99.         stk2_y =  joystick B Y axis count
  100.  
  101.   2.2.4 SAMPLE USAGE:
  102.  
  103.          get_joypos(&stk1_x, &stk1_y, &stk2_x, &stk2_y );
  104.  
  105.  
  106.  
  107.   2.3 SET_CURSOR
  108.  
  109.   2.3.1 DESCRIPTION:
  110.        SET_CURSOR - sets the cursor style.  This is required
  111.      to remove the cursor from the display & when quitting
  112.      your program to leave the cursor set on the screen.
  113.  
  114.   2.3.2 PROTOTYPE:
  115.  
  116.        void setcursor(int cursor);
  117.  
  118.   2.3.3 ARGUMENTS:
  119.             cursor = OFF        for a hidden cursor,
  120.           cursor = ON_L      for an underscore cursor
  121.            cursor = ON_T      for a block cursor.
  122.  
  123.       (The constants  OFF, ON_L, ON_B  are defined in RD_STK.H.)
  124.  
  125.   2.3.4 SAMPLE USAGE:
  126.         set_cursor(OFF);
  127.  
  128.  
  129.  
  130.                 (C)Copyright 1989, EC   Systems
  131.                         All Rights Reserved
  132.                         LICENSE AGREEMENT
  133.  
  134.     This program is distributed "as is", without guarantee or
  135.     warranty of any kind.  Furthermore, EC Systems and its author
  136.     do not warrant or guarantee the accuracy, the use, or the results
  137.     of the use of this program or its associated documentation.
  138.     All warranties are disclaimed.
  139.  
  140.     EC Systems grants you permission to evaluate, use, reproduce,and
  141.     distribute this "shareware" version of this  Utility Program on
  142.     the express condition that this program remain in their original
  143.     state.It is not permitted to modify or change in any way the files
  144.     associated with this software package nor is it permissible to
  145.     receive any payment, or benefit from, the reproduction or
  146.     distribution of this software or its documentation. All
  147.     comments and suggestions for enhancements will be considered and
  148.     greatly appreciated.
  149.  
  150.                             Registration
  151.  
  152.     This copy of RD_STK is a SHAREWARE evaluation copy which you are
  153.     encouraged to experiment with. If you find this program to be useful
  154.     you are encouraged to register your evaluation copy with EC Systems,
  155.     who will in turn provide you with the following:
  156.  
  157.     1.  Complete, carefully commented source code to  RD_STK
  158.     2.  This code is optimized for a 70 % faster response time.
  159.     3.  Technical support via CompuServ Easyplex mail.
  160.  
  161.     Registration is $12.00 which includes return shipping .
  162.     A registration form is provided for your convenience as the
  163.     last page of this  document.
  164.  
  165.                               REGISTRATION FORM
  166.  
  167.                                  RD_STK V1.1
  168.  
  169.                         ( Turbo C ) Joy Stick Toolbox
  170.  
  171.  
  172.         NAME           ____________________________________________
  173.  
  174.         STREET ADDRESS ____________________________________________
  175.  
  176.         CITY, STATE    ____________________________________________
  177.  
  178.         ZIP CODE       ____________________________________________
  179.  
  180.         COMPUSERVE ID. ____________________________________________
  181.  
  182.         FILE DATE      __________________
  183.  
  184. ------------------------------------------------------------------------------
  185.                                CUT ON DOTTED LINE
  186.  
  187.                Please send above registration form and $12.00 to:
  188.  
  189.                                   Earle Cooley
  190.                                2268 Glenmoor Rd S.
  191.                               CLEARWATER, FL. 34624
  192.  
  193.