----------------------------------------------------------------

                        PhotoV OCX Control  

              Copyright 1994 Northeast Data Corp.

                     All Rights Reserved

----------------------------------------------------------------


   Release 2.0

   January 1996


This document describes the PhotoV OCX Control. 


               CONTENTS

1. Product Description
2. Legal Information
3. Installation
4. Usage
5. Demonstration application
6. Release notes

----------------------------------------------------------------

1. Product Description

The PhotoV OCX Control is a Microsoft Windows OLE 2.0 custom control 
that displays, prints, and saves various types of image files. It 
works with PCX, TIFF, BMP, TARGA, GIF, JPEG, and Kodak Photo CD files.

It can be used with any host programming environment or application
that supports OCX controls. 


-------------------------------------------------------------------

2. Legal Information

The purchaser of the PhotoV Control is allowed to use it and
distribute it in applications without paying any royalty, and without
printing or displaying a copyright notice for the control. This only
includes distribution of the PHOTOV.OCX control and supporting files. 
It does not include distribution of documentation that comes with the 
PhotoV Control. 

The purchaser of the PhotoV Control may distribute the control with
applications that are networked (multiple users accessing the control 
from a file server) without paying any license fees to Northeast Data 
Corp. 

The purchaser may not distribute the PHOTOV.LIC file. This file allows
use of the OCX control in the design-time environment.


-------------------------------------------------------------------

3. Installation

Note: OCX controls REQUIRE OLE V2.02 or higher. Lower versions will cause
the control registration to fail.


Create a "PhotoV" directory on your hard disk and copy all files from
the distribution disk to the directory. These files include:


   OC25.DLL
   PHOTOV.OCX
   PHOTOV.LIC
   PCDLIB.DLL
   PCDXBMP.DLL
   PCDXTIF.DLL
   PCDXRIF.DLL
   PCDXEPS.DLL
   PCDXPCX.DLL
   VIC.DLL
   README.TXT (this file)
   ACCESS.MDB
	PROJECT1.VBP
	FORM1.FRM
	PROJECT1.EXE
   REGSVR.EXE

If you have downloaded the PHOTOV.ZIP file from Compuserve, use
PKUNZIP to extract the files into the directory.

Copy all .DLL files to your WINDOWS\SYSTEM directory.

Using the RUN command from the Program Manager, 
Run the REGSVR program to register the OC25.DLL:

   REGSVR OC25.DLL

Using the RUN command from the Program Manager, 
Run the REGSVR program to register the control:

   REGSVR PHOTOV.OCX


If you have Microsoft Access V2.0, start it and create a form or report.
From the Edit menu, choose Insert Object, and check the Custom Control
radio button. Choose the PhotoV control to insert it into the form or
report.

Note: The example Access database contains five records with image file
      specs for files that are not shipped with the demo. Modify these
      records to point to your own image files.

A Visual Basic V4.0 16-bit demo application is included in the files
listed above. 


-------------------------------------------------------------------

4. Usage


PROPERTIES
----------

Picture        -  The full file specification of the file containing the
                  image to display.

Rotation       -  0   - 0 degrees
                  90  - 90 degrees 
                  180 - 180 degrees
                  270 - 270 degrees

ScaleMode      -  0   - Fit Vertical
                  1   - Fit Horizontal
                  2   - Fit 1 to 1
                  3   - Best Fit
                  4   - Use ScalePercent property

                  ScaleMode is ignored for Photo CD images.

ScalePercent   - Percent of original image size. 100 percent is the
                 same as 1 to 1 scaling. Scale percent is ignored for
                 Photo CD images.

ScrollBars     -  0   - None
                  1   - Vertical
                  2   - Horizontal
                  3   - Both

VScrollPos     - Vertical scroll position (run-time only).

HScrollPos     - Horizontal scroll position (run-time only).

Menus          - A string that contains a '0' or '1' character for each
                 enabled function. The positions in the string are:

                  0  - copy
                  1  - bestfit
                  2  - fitvert
                  3  - fithorz
                  4  - fit 1 to 1
                  5  - increase contrast
                  6  - decrease contrast
                  7  - zoom in
                  8  - zoom out
                  9  - print
                  10  - rotate 0
                  11 - rotate 90
                  12 - rotate 180
                  13 - rotate 270


Colors         - The number of colors in the image. This is normally 2,
                 16, 256, or 16 million.

ImageWidth     - The width of the current image in pixels. Zooming the
                 image changes this value.

ImageHeight    - The height of the image in pixels. Zooming the image
                 changes this value.


METHODS
-------

Copy           - Copies selected region to clipboard

DecreaseContrast - Decreases the image contrast. This function is not
                   supported for Photo CD images. You can only decrease the
                   contrast on an image after you have increased the contrast.

IncreaseContrast - Increases the image contrast. This function is not
                   supported for Photo CD images.

PrintImage     - Prints the image.

SaveAs (filename, compression)

               - Saves the image in the specified file. The file extension
                 indicates the type of file to save:


      Here are the valid values for the compression argument):


         .BMP     0 - no compression
                  1 - RLE8 compression

         .JPG     0 - 100 for image quality. 100 gives the highest quality.
                     Values less than 100 produce a smaller image file, but
                     with poorer image quality.

         .PIW     0 - no compression
                  1 - compression

         .TGA     0 - no compression
                  1 - RLE compression

         .TIF     For bitonal images:     
      
                     0 - none
                     1 - packbits
                     2 - Group 3
                     3 - Group 4

                  For Grayscale or 8-bit images:

                     0 - none
                     1 - LZW
                     2 - packbits
              
                  For RGB (24 bit) images:

                     0 - none
                     1 - LZW

   For example, to save the current image file (assuming it is an RGB
   color image:

      (PhotoV object name).SaveAs(c:\abc.tif,1)

   The file is saved as a TIFF file with LZW compression.



ZoomIn         - Zooms in on the image.

ZoomOut        - Zooms the image out.

   
EVENTS
------

MenuChange     - Returns a string with characters set for each function
                 that is available. See the description of the Menus
                 property above for the meaning of each character in the
                 string.



-------------------------------------------------------------------

5. Demonstration Application

A Microsoft Access example application is provided with the PhotoV
control. You must have Microsoft Access V2.0 installed on your machine.

The example application allows you to enter file names of image files and
display them. The program will store the file names and descriptions in
the database for later use. 

To use the application, start Microsoft Access and open the Access.mdb 
file. Open the form named "form1". Enter the name of an image file and
press the VIEW button. Other controls on the form allow you to rotate,
zoom, and change the contrast of the image.

A Visual Basic V4.0 (16-bit) demo application is also provided.

-------------------------------------------------------------------


   Northeast Data Corp.
   2117 Buffalo Rd., Suite 290
   Rochester, NY  14624


-------------------------------------------------------------------

6. Release notes


Version 1.1 - March 1995

   First commercial release.


Version 1.2 - June 1995

   Fixed problems with display of images in reports. Incorrect border
   painting occluded images on some display adapters. 

   Fixed problem with scrollbars property not allowing removal of
   scroll bars from the image window.

   Fixed problem with incorrect border painting with images rotated
   90 and 270 degrees.

   Changed Access demo app to use the Print event instead of the Format
   event to set the file property on the control. This eliminates 
   unnecessary reloading of images that are not visible.

   Fixed problem in Access app that caused two zooms to occur when the
   zoom in button was pressed.
   

Version 1.3 - December 1995

   Fixed problem with calculation of number of image colors. This corrects
   problems with some printers printing color images in black & white.

   Added Colors, ImageWidth, and ImageHeight properties.

Version 2.0 - January 1996

	Fixed a problem with the screen HDC not being released. This caused
	crashes in Windows V3.1.

	Added a VB 4.0 16-bit demo application.

	Added a Save function to the MS Access demo application.
