DCTV Library Developers Kit
===========================

v3.48 - 30 Sep 1992

Copyright (C) 1991, 1992 Digital Creations, Inc.


Description
-----------

"dctv.library" is a disk-resident library providing functions to
developers for converting 24-bit RGB data to and from DCTV display format.

The documentation is sparse, but things are fairly straightforward and
there a some C examples.


Contents
--------

dctv.doc        - autodoc for dctv.library
dctv.library    - the library
ReadMe.dev      - this file

example
    dctvgrad.c  - convert a 24-bit gradient to DCTV.
    graygrad.c  - convert a DCTV gradient from dctvgrad.c to 24-bit RGB,
                  display as 4-bit gray.

glue
    dctv.lib    - glue library for use with Blink.  Compatible
                  with Manx LN when using the +l option.
    dctv_lib.fd - .FD file for dctv.library

include
    clib/dctv_protos.h     - dctv.library function prototypes
    libraries/dctv.h       - dctv.library main C include file
    libraries/dctv.i       - dctv.library main assembly include file
    pragmas/dctv_pragmas.h - dctv.library #pragmas for SAS/C
                             (compatible with Aztec C).


Distribution
------------

1.  The DCTV Library Developers Kit is freely distributable in it's
    entirety. However, the Developers Kit may not be included with any
    commercial product or freely distributed package without written
    permission from Digital Creations.

2.  The file "dctv.library" contained in this kit may be included with
    commercial products with written permission from Digital Creations.
    A separate application for distribution must be made for each
    product.  See the file called RegistrationForm for more information.

    "dctv.library" may not be distributed with freely distributable
    packages.

NOTE: There is a separate library-only distribution file for
"dctv.library" that is available for free distribution to end users.  The
Developers Kit is primarily intended for developers.


Contact
-------

Digital Creations
P.O. Box 97
Folsom, CA  95763-0097

voice: (916) 344-4825
  fax: (916) 635-0475

  bix: peabody


Revisions
---------

v3.48 - 30 Sep 1992
    . dctv.library
        . added DCTV -> RGB conversion
        . new functions:
            . AllocDCTVCvtTagList()
            . AllocDCTVCvtTags()
            . ReadDCTVPixel()
            . SetDCTVColorTable()
        . added custom RGB line buffer support (DCTVCVTF_CustomRGBBuf)

    . includes
        . libraries/dctv.[hi]
            . added DCTVCVTA_ tags
            . added DCTVCVTT_ types
            . added DCTVCVTERR_ error codes
        . renamed pragma/dctv_lib.h -> pragmas/dctv_pragmas.h

    . examples
        . updated dctvgrad.c to use V3 functions.
        . added graygrad.c.

    . glue
        . renamed some functions:
            . DCTVFormat() -> FormatDCTV()
            . DCTVCvtLine() -> CvtDCTVLine()

    . embedded versions numbers:
        . dctv.library 3.48
        . dctv.lib     3.7

v2.2 - 26 Nov 1991
    . dctv.library
        . RGB -> DCTV ColorTable consistent with DCTV 1.1 software.

v1.31 - 8 Apr 1991
    . Initial release.