FILE: LOGPOLARWARPER\README.TXT

ACTIVEX LOGPOLARWARPER V2.0

-----------------------------------------
1. About LogPolarWarper ActiveX Server.

2. Whats New

3. Known Limitations

4. Files

5. Installation

6. Use in Matlab

7. Use in C++

8. Technical Information
------------------------------------------


1. About LogPolarWarper ActiveX Server.

LogPolarWarper is an ActiveX server object that warps logpolar 
images according to some geometrical transformations.

It works in conjunction with the LogPolarMapper object.
IT IS REQUIRED THAT YOU INSTALL IN YOUR SYSTEM THE LOGPOLARMAPPER 
FILES BEFORE INSTALLING THE LOGPOLAR WARPER.

The object exposes its internal functionality to most programming 
languages and environments in Windows platforms. It was 
designed to be accessed via Matlab and C++ clients, but 
can be used by other compiled/scripted languages.

2. Whats New

Uses IPP (Intel Performance Primitives Library) optimized functions. 
Linkage is static such that no extra libraries are required to install in 
the target machine.

3. Known Limitations

- Only tested with MATLAB 6.0 and Microsoft Visual C++ 6.0.


4. Files

LogPolarWarper is distributed in a zip file (LOGPOLARWARPER.ZIP)
and includes the following files:

	- Binary object
LogPolarWarper.dll

	- Type library for use with compiled languages
LogPolarWarper.tlb

	- Interface Definition File
LogPolarWarper.idl

README.TXT
	- this file
PROBLEMS.TXT
	- Description of some problems found in this release
INSTALL.BAT
	- The registration script required to install the object
UNINSTALL.BAT
	- The registration script required to uninstall the object
TEST.CPP
	- C++ file with an example to illustrate object usage
IMVIEWW32.H
    - Included by TEST.CPP. Defines classes for image display.
AVIFILE.H 
	- Included by TEST.CPP. Defines classes for reading avi files
TIMER.H
	- Included by TEST.CPP. Defines classes for benchmarcking
TEST.EXE
	- compiled program to test the object
TEST.M
	- Matlab script files with an example of object usage  
MATLAB2C.M
C2MATLAB.M
	- Helper macros to convert color modes between C and MATLAB. 
	  Check matlab script test file to see an example of its usage.
LEFT.AVI
RIGHT.AVI
	- Data used by the test files
WARP_PARAMS.CSV
	- File with the warp transformation parameters to apply to the images.
	  Each row in this file file contain 8 parameters of a projective 
	  transformation. The following list describes the meaning of each
	  parameter:
	  1 - horizontal translation (pixels)
	  2 - vertical translation (pixels)
	  3 - rotation in degrees
	  4 - scale change in percentage 
		  (100% = double size; 50% = half size)
	  5 - aspect ratio change in percentage 
	      (100% = doubles horiz. dim. and halves vert. dim.)
	  6 - shear in percentage of image size 
	      (100% = shears equivalent to image size)
	  7 - horz. curl. in percentage of the inverse of the vanish. point 
	      (100% = vanish. point touches image border)
	  8 - vert. curl. in percentage of the inverse of the vanish. point 
	      (100% = vanish. point touches image border)

	All transformations are applied in the center o the image.

5. Installation

- Unpack the "LOGPOLARWARPER.ZIP" file to a new directory.

- Run the registration script "INSTALL.BAT"

- Test object typing in the command line:
	>> test left.avi right.avi

- If you have Matlab 6.0 or higher you can run the test script TEST.M
	>> test('left.avi','right.avi');

6. Use in Matlab

The LogPolarWarper object can be called by any ActiveX aware
scripting languages like Java, VisualBasic and Matlab. 

Check the matlab script files *.M to see examples of use in Matlab:

For more information check matlab help on integration with activex objects

7. Use in C++

The LogPolarWarper object can also be used with compiled languages and takes 
advantage of their flexibility to create highly optimized code. It exposes
functions that allow the internal access to data structures, avoiding expensive
data transfers between the object and the client, but reducing the robustness 
against programming errors. These functions are not available to scripting 
languages due to reliability requirements.

Check file TEST.CPP to see an example of use in C++. 


8. Technical Information


	LogPolarWarper


	PROGID	LogPolarWarper.CoLogPolarWarper

	For more information check the OLE/COM object viewer - Object CoLogPolarWarper
	and the interface definition files.


Copyright (c) 2002, Alexandre Bernardino - ISR/IST.  All rights reserved.
alex@isr.ist.utl.pt