                       tDDrawPaintBox component

     Hi!  Becouse  of  lack  of  space  in  DSP info's I've decided to
write   this   short  text  file.  I  would  like  to  give  you  some
background  information  about  the  component  you've just downloaded
as well as some legal notes about using it.

     Nearly  a  year  ago  I  started  to  use  a  DirectX  tech in my
programs.  It's  a  wounderful  tech  that  allows  you to take almost
full  control  over  your  hardware  &  makes  it  easy  to write, for
example,  a  game, but it requires an initialization part in your apps
that  is  about  100  lines  long  (when  you  want to make a bug-free
program)  which  is  almost the same for each app you write. Soon I've
becomed  tired  of  rewriting  the  same code again and again, so I've
decided  to  write  a  simple  component which would make it easier to
use DirectDraw in my apps.

     I  wanted  to  write  a  component which would provide a simplest
way  to  use  a  DDraw  in  my windowed apps, so I've decided to start
with  a  tPaintBox  component.  After  a  week  of coding & testing my
brand  new  component  was ready to use - now all you have to do is to
drop  a  tDDrawPaintBox  on  your form & write a code which would draw
something  on  the  screen.  Becouse  a  help  is  provided  for  this
component, I won't bother you with details. The main points are:

     1. to retrive a pointer to the drawing surface just read a
        value from a surface property
     2. to find out what is the pixel format and other
        parameters of the current surface check out following
        properites:
          - Width & Length - no comments
          - DPitch - length in bytes of a single logical
            scan-line
          - PixelLen - length in bytes of a single pixel
          - PixelWidth - length in bits of a single pixel
          - RMask,GMask,BMask - no comments
          - rCnv,gCnv,bCnv - color converion arrays (from RGB to
            pixel-nativ format)
     3. when you'r done with the surface you M*U*S*T free it by
        calling the freeSurface method with a pointer to the
        surface as a parameter.

     So,  as  you  can  see, the basic usage of this component is very
simple  (I  think).  Nevertheless  you  must  code evrything properly,
becouse  Delphi  doesn't  support  debugging  for the code between the
surface lock & release calls.
     More  advenced  stuff  is  up to you - component gives you access
to  all  the  DirectDraw  objects created by it. It's relative ease to
switch  resolution  or  to  gain  full control over main processor for
example (e-mail me for sample programs).

     If  you  want  to  see  some my programs I've deveolped with this
component,  check  out  the  sample program or e-mail me (an exccelent
example   is  my  MOD  player  -  scopes  &  fft  is  done  using  two
DDrawPaintBox components).


IMPORTANT:

     Shareware  verion  of  this  component  wasn't designed for 8-bit
color   resolutions  &  it  can  cause  problems  when  used  in  that
resolution modes.



LEGAL NOTICE:

     This  program  is  shareware,  which  means  you can check it out
before   you  buy  it.  You  can  use  it  freealy  in  non-commertial
programs however.
     Regisration  fee  is  $5,  after registration you'll be delivered
a  full  version  of  component  (support for 8-bit surfaces, improved
support  of  DDraw  standart)  with it's source code. Plese, e-mail me
for details (plimano@zly.kis.p.lodz.pl).