home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / FOXPRO / 3DGEN / READ.ME < prev    next >
Text File  |  1993-09-01  |  6KB  |  144 lines
  1.  
  2.                      3-D Controls for FoxPro for Windows
  3.                      -----------------------------------
  4.                      Updated 9/1/93 to accomodate 2.5a
  5.  
  6.  
  7.         Author:  Rick Whitt - 70672,605
  8.  
  9.         The author hereby places the portions of this code written
  10.         by the author into the public domain.  No guarantee of fitness
  11.         for use is made.  Comments and suggestions via E-Mail are
  12.         welcome and appreciated.
  13.  
  14.  
  15.         Description:
  16.  
  17.         This archive contains a patch file to create a modified
  18.         GENSCRN.PRG, that allows you to effortlessly create 3-D effects
  19.         via the FoxPro for Windows screen builder.  It's as easy as
  20.         placing the string "#3D" in the comment field of any object for
  21.         which you want 3-D effects.  Now you can easily create that slick
  22.         chiselled metallic look with hardly any effort!
  23.  
  24.  
  25.         Contents:
  26.  
  27.         3DGEN25A.RTP - Patch for standard genscrn.prg to create 3dgenscr.prg
  28.                        This only patches current 2.5a release genscrn.prg!
  29.  
  30.         3DGENSCR.RTP - Patch for older 2.5 genscrn.prg to create 3dgenscr.prg
  31.                        This only patches original 2.5 genscrn.prg!
  32.  
  33.         PATCH.EXE    - Version 2.00 RTPatch to run the above patch file
  34.  
  35.         3DPANEL.PRG  - Routine for drawing 3D panels (from Foxpro Advisor)
  36.  
  37.         3D.APP       - Sample APP showing most available controls
  38.  
  39.         3D PJT       - Files that make up 3D.APP
  40.         3D PJX
  41.         3D.SCT                   .
  42.         3D.SCX                   .
  43.         FOXPRO.ICO               .
  44.         CANCEL.BMP               .
  45.         OK.BMP
  46.         WIN.BMP
  47.  
  48.  
  49.         Setup:
  50.  
  51.         To get started using the system, you must run the supplied patch
  52.         against a standard 2.5a GENSCRN.PRG to create the modified
  53.         3DGENSCR.PRG.  You must have the GENSCRN.PRG dated 4-22-93, 4:54pm,
  54.         size 277,228 bytes.  If you have a modified GENSCRN, you will need
  55.         to reload the original, patch it, then extract the modified code and
  56.         put it in your modified GENSCRN as directed below.  Put the original
  57.         GENSCRN.PRG in a temporary directory, along with 3DGENSCR.RTP
  58.         and PATCH.EXE.  Run the following command:
  59.  
  60.                         PATCH 3DGEN25A
  61.  
  62.         If you still have the older 2.5 GENSCRN.PRG dated 1-18-93, 2:50am,
  63.         size 277,113 bytes, you will need to use the older patch instead:
  64.  
  65.                         PATCH 3DGENSCR
  66.  
  67.         If all goes well, you will end up with 3DGENSCR.PRG.  The
  68.         original GENSCRN.PRG will be deleted, which is why it is important
  69.         to do the patch on a copy in a temporary directory!  Next, put
  70.         3DGENSCR.PRG in the Foxpro for Windows directory.
  71.  
  72.         Put the following line in your CONFIG.FPW file:
  73.  
  74.                         _GENSCRN = "3DGENSCR"
  75.  
  76.         If you use any 3D effects, calls to the 3DPANEL.PRG will be
  77.         placed in your code.  This file must be available in the search
  78.         path at runtime or included in your APP.
  79.  
  80.         If you already have a modified GENSCRN program and wish to
  81.         incorporate the 3D changes into it, search 3DGENSCR.PRG for the
  82.         string "*! rlw".  There are some lines of code added to procedure
  83.         BUILDFMT and two new procedures at the end of the file.  These
  84.         are all that's needed to change your custom GENSCRN to do the 3D
  85.         generation.
  86.  
  87.  
  88.         Usage:
  89.  
  90.         Simplicity itself!  To add 3D shading to any screen object, select
  91.         that object and place the string "#3D" anywhere in its COMMENT
  92.         field.  Case does not matter.  That's all that's required for
  93.         default behavior.  You will not see the change in the screen
  94.         builder, but the next time you generate or build, the resulting
  95.         program will have the effects.  All visible screen objects are
  96.         supported with the exception of regular (round) radio buttons.
  97.         A subsequent release will include that capability plus anything
  98.         else I think of between now and then.
  99.  
  100.         There are two additional parameters that can be added to the
  101.         comment field to change the default behavior.  The defaults are
  102.         2 pixel wide shading for all objects except lines and boxes, which
  103.         are 1 line.  To change this, insert the string "PEN:x" in the
  104.         comments, with x being a number from 0-6 for pen size.
  105.  
  106.         Indented-type shading is the default.  If you wish raised-looking
  107.         areas, insert the string "STYLE:RAISED" in the comments field.
  108.  
  109.         IMPORTANT!  You must select a background color for your window
  110.         for these effects to look right.  Light grey looks best, IMHO.
  111.         Also, be sure to turn GET boarders OFF in your generate dialog
  112.         if you will be adding effects to any GET fields.
  113.  
  114.  
  115.         Limitations:
  116.  
  117.         This is my first attempt at this, so these routines may still
  118.         have some rough edges and have not had anything like extensive
  119.         testing!  I'm throwing it out in hopes that I might get comments
  120.         and more ideas for improvement.  I will be updating the file
  121.         on FoxForum as improvements are made.  I'm not 100% certain how
  122.         Fox calculates the sizes of some of it's screen objects, so more
  123.         messing around with this is inevitable.
  124.  
  125.         The most glaring hole right now is regular round Radio buttons.
  126.         They are not currently supported because I haven't yet figured
  127.         out how I'm going to do it!  Since there's no native arc drawing
  128.         function in Fox, I'm not sure how I'll attack it yet. If anyone
  129.         has a suggestion, I would love to hear it!  If anyone figures this
  130.         part out, I would appreciate an e-mail of the technique or an
  131.         example file.
  132.  
  133.  
  134.         Change Log:
  135.  
  136.  
  137.         9/1/93 - new patch file 3DGEN25A patches 2.5a version of genscrn.prg
  138.                - included user suggested changes to 3dpanel.prg for better
  139.                  performance.
  140.                - Updated PATCH.EXE to vesion 2.00.
  141.                - Still no 3D effects for radio buttons!
  142.  
  143.         5/7/93 - Original version.
  144.