home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vidbtn.zip / VIDBUTTN.DOC < prev    next >
Text File  |  1994-06-10  |  9KB  |  220 lines
  1.                          VidButtn  V2.00
  2.  
  3.                   Copyright 1994, Greg Ratajik.
  4.  
  5.                        Friday, May 13, 1993
  6.  
  7.                CompuServe: 74555,542 (primary access)
  8.                Genie     : G.RATAJIK
  9.  
  10.                Internet  : 74555.542@compuserve.com  (primary access)
  11.                     or   : G.RATAJIK@genie.geis.com
  12.      
  13.                Voice     : (305)/340-7985
  14.  
  15.                To register, send $15 check or money order, payable
  16.                to Greg Ratajik, to:
  17.  
  18.                Greg Ratajik
  19.                1722 Forres Ave.
  20.                St. Joseph, MI 49085
  21.  
  22.                OR, if you are using CompuServe to register
  23.                Easyplay, go to SWREG, and search fo VIDBUTTN.
  24.  
  25.                NOTE:  This is the OS/2 2.1 Version.
  26. -------------------------------------------------------------------
  27.      VidButtn is a Shareware program.  If you find VidButtn
  28. useful, please send $15 to the above address (And if you find it
  29. VERY useful, feel free to send what you think is a fair price.) 
  30. Feel free to play around with and copy VidButtn, but, if you use it
  31. in one of your programs, and you sell that program, you must
  32. register VidButtn.  If you don't, or you modify the VidButtn DLL,
  33. LIB or OBJ in anyway, you will be in violation of VidButtn's
  34. copyright.
  35.  
  36.   If you don't want/can't send in the $15 dollars, then I ask that
  37. if you release a peice of software, and use VidButtns,
  38. display that fact in the about box (or somewhere visible
  39. like that)  i.e.:  "Uses VidButtns, copyright 1994, Greg
  40. Ratajik.
  41.  
  42.   If you are not even willing to do that then go ahead and use
  43. them, but remember that the curse of all programmers will be on
  44. your head! :)  ...I rather that people write new and cool programs
  45. for OS/2 than get the $15.  It really is the BEST OS!
  46.  
  47. -------------------------------------------------------------------
  48.      I hope you find VidButtn useful, but (DISCLAIMER) I am
  49. in no way responsible for any damages the use of VidButtn may
  50. cause.    
  51.  
  52.      If you have any questions, comments, ideas, etc, feel free to
  53. contact me.  I'm always looking for ways to improve my software!
  54.  
  55. ---------------------------------------------------------------
  56. I.   General
  57.  
  58.           VidButtn provides a programmer with a simple,
  59.      straightforward way to create and use multi-state graphical
  60.      pushbuttons.  VidButtn also provides a way for the user to get
  61.      help when moving the mouse pointer over a VidButtn, via a
  62.      status bar.   VidButtn can be used for any pushbutton, but are
  63.      especially nice for Toolbars.
  64.  
  65. II.  Using VidButtn (DLL Version.)
  66.  
  67.      A.   To add VidButtn to a program:
  68.  
  69.           In the MAKE file:
  70.           o    and VidButtn.LIB to the LINK statement, in addition
  71.                to any other libraries you may be using.
  72.  
  73.           In the RC file (if using)
  74.           
  75.           o    Add a control for AniCreateButton to use.  This
  76.                control should be of type WC_BUTTON, WS_USERBUTTON
  77.  
  78.           In the PROGRAM FILE
  79.  
  80.           o    add #include "VidButtn.H"
  81.           o    call the API VidCreateButton to make the button
  82.                added in the RC.  An example of this call would be:
  83.  
  84.                usUpBits[0]  = ID_EYE1;
  85.                usUpBits[1]  = ID_EYE2;
  86.                usUpBits[2]  = ID_EYE3;
  87.                usUpBits[3]  = ID_EYE4;
  88.                usUpBits[4]  = ID_EYE5;
  89.                usUpBits[5]  = 0;           // The last element MUST be NULL
  90.  
  91.                usDownBits[5]  = 0;         // The last element MUST be NULL
  92.                usDownBits[4]  = ID_EYE1;
  93.                usDownBits[3]  = ID_EYE2;
  94.                usDownBits[2]  = ID_EYE3;
  95.                usDownBits[1]  = ID_EYE4;
  96.                usDownBits[0]  = ID_EYE5;
  97.  
  98.                VidCreateButton(hWndDlg,             /* Handle of Dialog    */
  99.                                PB_SCAN_DRIVE,       /* ID of control       */
  100.                                &usUpBits[0],        /* ID of UP bitmap     */
  101.                                &usDownBits[0],      /* ID of DOWN bitmap   */
  102.                                68,                  /* X Size of bitmaps   */
  103.                                31,                  /* Y Size of bitmaps   */
  104.                                "Press this VidButton to scan the current drive for the selected file type.", /* Status bar text     */
  105.                                TX_HELP);            /* ID of status bar    */
  106.  
  107.                NOTE:  VidButtns will take any number of bitmaps, but a
  108.                       NULL MUST be the last number of each array.
  109.  
  110.                When the button first comes up, it will have ID_EYE1
  111.                displayed.  When the user presses the button, it will
  112.                display ID_EYE2, ID_EYE3, ID_EYE4, and ID_EYE5.  When the
  113.                user releases the button, it will display ID_EYE5, ID_EYE4,
  114.                ID_EYE3, ID_EYE2, and ID_EYE1.
  115.  
  116.                The Status Bar text and ID of status bar are
  117.                optional.  When the user moves the mouse arrow over
  118.                the VidButtn, It will display the status bar text
  119.                in the status bar (which should be a TEXT field)
  120.  
  121.           o    Processing on the VidButtn from this point on is
  122.                the same as any other pushbutton.
  123.  
  124.           o    When exiting the Window or dialog, you should use
  125.                the cleanup function VidDeleteButton. An example of
  126.                this call would be:
  127.                
  128.                VidDeleteButton(hWndDlg, PB_SCAN_DRIVE);
  129.  
  130.  
  131.      For a complete example, see TOOLBAR.C and it's accompanying
  132.      files.  If you have any question on implementing VidButtn,
  133.      please feel free to get in touch with.
  134.  
  135.      If you would like to see VidButtns in action in a working
  136.      application, get EasyPlay (the EASY way to play!)
  137.  
  138. IV. Other shareware/PD programs to look for:
  139.  
  140.      o    Easyplay - lets you play WAV, AVI, MID, VOC, or any other type
  141.           that can be used with MMOS2.  It lets you play ALL of these files
  142.           on a drive, in sequence.  It also contains a new control type
  143.           called "VidButtons" (i.e. Full-frame video pushbuttons)
  144.  
  145.      o    ChatterBox - Allows users to send one line messages to
  146.           each other across a LAN.  Very nice for non-critical
  147.           messages. One of the first OS/2 1.3 program to use real
  148.           custom animated pushbuttons (The first VidButtn program).
  149.  
  150.      o    DeleteDir - A simple full-screen program to delete a
  151.           directory and all files/directories that are children to
  152.           it.
  153.  
  154.      o    ChkPath - Will check the path's you set in your
  155.           config.sys, and let you know if you've got problems.
  156.  
  157.      o    Pwh - Path'ed Where.  Will search a path for a file.  PWH
  158.           will tell you every place it hit's the file.  Very useful
  159.           for checking what version of a program you using.
  160.      
  161.      o    SMPrint - Prints a text file on a HP printer, in
  162.           landscape mode.
  163.  
  164.      o    MDD - Multiple make directory.  MDD will create a
  165.           multiple directories (i.e. if you wanted to make
  166.           C:\GREG\PROGRAM\SOURCE20\MDD\RELEASE, MDD could do it in
  167.           one shot.)
  168.      
  169.      o    WHO - Will display information about all users of a
  170.           LAN/Domain.
  171.  
  172.      o    QWHO - Displays all user ID's currently on a LAN/Domain.
  173.  
  174.      o    NetChat - This program allows many users to have Chat
  175.           sessions over the LAN.  It allows each user to set up
  176.           Conference groups and security levels.  Each Conference
  177.           can have as many users as you want chatting.  This is
  178.           similar to CompuServer's CB, or a BBS's multi-node chat
  179.           area.
  180.  
  181.      o    NetMail - Improved net massaging (i.e. "Blue Boxes") This
  182.           program gives you better control of system level LAN
  183.           messages.  You can enter message subjects, set priority
  184.           levels, and type in longer messages. 
  185.           NetMail allows each user to set up their own message
  186.           groups, along with global message groups.  Each user can
  187.           choose which groups to receive messages from, and what
  188.           groups to send messages to.
  189.           NetMail also let's you choose whether to get the message
  190.           in the traditional VIO BlueBox (but better looking!), a
  191.           PM Message Box, or to display no message but to retrieve
  192.           it at a latter time.
  193.  
  194.           This program makes Net Massaging easier to use, and less
  195.           annoying to the recipients.
  196.  
  197.      o    Vtree - Visual directory tree.
  198.  
  199.      o    EDCNFG - PM based program that will verify everything's
  200.           okay in your config.sys, keep track/retro changes into
  201.           multiple config's, and edit/setup a config.sys
  202.  
  203.      o    HPMLib - Library tracking system
  204.  
  205.      o    HPMCook - Cooking software
  206.  
  207.      o    HPMDiet - Dieting software
  208.  
  209.      o    DosText - Change the message a OS/2 program gives when
  210.           running it from DOS.
  211.  
  212.      Program Utilities:
  213.  
  214.      o    AniButtn - Two-state animated pushbuttons that you can
  215.           easily replace any pushbutton with.
  216.  
  217.      o    VidButtn -  Just like AniButtn, but will full-frame
  218.           animation.  (The ones in EasyPlay work exactly like a
  219.           pushbutton, but have up to 17 frames of animation!)
  220.