FILE: LOGPOLARMAPPER\README.TXT

ACTIVEX LOGPOLARMAPPER V2.0

-----------------------------------------
1. About LogPolarMapper 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 LogPolarMapper ActiveX Server.

LogPolarMapper is an ActiveX server object that performs 
geometrical transformations from uniform sampled images to the 
log-polar space variant representation.

It 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

Added some functions to interface with the LogPolarWarper

3. Known Limitations

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


4. Files

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

	- Binary objects
LogPolarMapper.dll
Camera.dll
LogPolar.dll
NonLinearSensor.dll

	- Type libraries for use with compiled languages
LogPolarMapper.tlb
Camera.tlb
LogPolar.tlb
NonLinearSensor.tlb

	- Interface Definition Files for all objects
LogPolarMapper.idl
Camera.idl
LogPolar.idl
Nonlinearsensor.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.M
	- Matlab script files with an example of object usage  
TEST.CPP
	- C++ file with an example to illustrate object usage
IMVIEWW32.H
    - Included by TEST.CPP. Defines classes for image display.
TEST.EXE
	- compiled program to test the object
GDIPLUS.DLL
	- Microsoft distributable library with graphical functions and image file I/O

TEST1.BMP
TEST2.BMP
	- Images for test programs.
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.
5. Installation

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

- Run the registration script "INSTALL.BAT"

- Test object typing in the command line:
	>> test test1.bmp         
	>> test test2.bmp

- If you have Matlab 6.0 or higher you can run the test script TEST.M
	>> test('test1.bmp');
	>> test('test2.bmp');


6. Use in Matlab

The LogPolarMapper 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 LogPolar 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++. If you have the 
Microsoft Vision SDK installed in your system, you can compile and run the 
test application.


8. Technical Information


	LogPolarMapper


	PROGID	LogPolarMapper.CoLogPolarMapper

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


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