Alacron FAST-UXGA User manual

FAST-UXGA PCI-EXPRESS
TECHNICAL PRODUCT DESCRIPTION
30002-00192

2 of 28

3 of 28
COPYRIGHT NOTICE
Copyright © 2001-2007 by Alacron Inc.
All rights reserved. This document, in whole or in part, may not be copied, photocopied,
reproduced, translated, or reduced to any other electronic medium or machine-readable form
without the express written consent of Alacron Inc.
Alacron makes no warranty for the use of its products, assumes no responsibility for any error,
which may appear in this document, and makes no commitment to update the information
contained herein. Alacron Inc. retains the right to make changes to this manual at any time
without notice.
Document Name: Fast-X Technical Product Description
Document Number: 30002-00192
Revision History: 1.0 October 25, 2006
2.0 February 26, 2007
2.1 May 10, 2007
Trademarks:
Alacron ® is a registered trademark of Alacron Inc.
FastSeries ® is a registered trademark of Alacron Inc.
Stretch ™ is a trademark of Stretch Inc.
Unix ® is a registered trademark of Sun Microsystems Inc.
Windows ™ , Windows 2000 ™ , Windows XP ™ , Microsoft .NET ™ are trademarks of
Microsoft Corporation
All trademarks are the property of their respective holders.
Alacron Inc.
71 Spit Brook Road, Suite 200
Nashua, NH 03060
USA
Telephone: [phone]
Fax: [phone]
Web Site: http://www.alacron.com
Email: [email protected] or [email protected]

4 of 28

5 of 28
TABLE OF CONTENTS
TABLE OF CONTENTS..............................................................................................................5
INTRODUCTION.........................................................................................................................8
FAST-X UXGA OPTION FEATURE SUMMARY......................................................................9
HARDWARE OVERVIEW...........................................................................................................9
VIDEO INPUTS.....................................................................................................................10
ADC ADI9888B......................................................................................................................10
I
2
C I NTERFACE .........................................................................................................................11
CONNECTOR PINOUT.............................................................................................................11
SOFTWARE MODEL................................................................................................................12
THEORY OF OPERATION.......................................................................................................12
I NTRODUCTION TO THE A LACRON OCX M ODEL ..........................................................................14
Alacron Imaging OCX.........................................................................................................15
ALPicture OCX...................................................................................................................................15
Introduction.........................................................................................................................15
Definition ............................................................................................................................15
ALPICTURE Type Library IDL...........................................................................................................15
ALPICTURE Properties .....................................................................................................................16
ALPICTURE Methods........................................................................................................................17
The Image Structure ..........................................................................................................................18
ALPICTURE Events...........................................................................................................................20
Using the control ................................................................................................................20
A LACRON ’ S S TRETCH /N EXPERIA OCX ......................................................................................21
Interfaces............................................................................................................................21
IStretchBoard .....................................................................................................................21
Properties...........................................................................................................................................23
BOOL Valid ........................................................................................................................................23
BOOL ReadyState .............................................................................................................................23
Int PID id(1) ........................................................................................................................................23
Int rval id(2) ........................................................................................................................................23
BOOL ResetOnRelease id(3) ............................................................................................................23
ULONG FlagRegister[0-9] id(4) .........................................................................................................23
CHAR *AlfastVersion id(5).................................................................................................................23
CHAR * PciProbeVersion id(6) ..........................................................................................................23
ULONG MMIO(reg) id(7)....................................................................................................................23
CHAR *SRAM id(8)............................................................................................................................23
Methods..............................................................................................................................................23
Open(pid, char *filename) id(50)........................................................................................................23
Variant CapValue (char *key, char *subKey) id(51)..........................................................................23
Id(52) id(53) are not used. .................................................................................................................23
SDRAMQuery id(54) ..........................................................................................................................23
SendMsg (int command, int len, char*data) id(55)............................................................................23
ShmQuery (ULONG* size, ULONG* paddr, char **ppVaddr) id(56) ...............................................24
Advise id(57) ......................................................................................................................................24
IStretchBoardEvent ............................................................................................................24
TROUBLESHOOTING..............................................................................................................24
ALACRON TECHNICAL SUPPORT ........................................................................................25

6 of 28
C ONTACTING T ECHNICAL S UPPORT ...........................................................................................25
R ETURNING P RODUCTS F OR R EPAIR O R R EPLACEMENT ............................................................27
R EPORTING B UGS ....................................................................................................................27

7 of 28
OTHER ALACRON MANUALS
Alacron manuals cover all aspects of FastSeries hardware and software installation and
operation. Call Alacron at 603-891-2750 and ask for the appropriate manuals from the list
below if they did not come in your FastSeries shipment.
30002-00148 ALFAST Runtime Software Programmer’s Guide & Reference
30002-00150 FastSeries Library User’s Manual
30002-00169 ALRT Runtime Software Programmer’s Guide & Reference
30002-00184 FastSeries Getting Started Manual
30002-00185 FastVision Hardware Installation Manual
30002-00186 FastVision Software Installation Manual
30002-00395 FastMotion User’s Manual

8 of 28
INTRODUCTION
The Alacron Fast-UXGA PCIe version is a highly flexible, programmable and expandable video
capture and processing device. The Fast-UXGA Option provides for the capture, processing,
and delivery of UXGA (1600x1200) true color, and high bandwidth monochrome video to a host
PC.
Figure 1 - Fast-UXGA PCI-X Board
The Fast-X UXGA option attaches to a Fast-Xe (PCI Express) card. It provides the interface to
the high bandwidth analog video source. It attaches to the card on the long vertical connector
seen in the image above. Note the back panel metal bracket is replaces, and the Camera link
support is removed from the board with the UXGA option is used.
Figure 2, Fast-UXGA PCI-Express Diagram

9 of 28
.
68 Pin
VHDCI Connector
AD9888
PLL & ADC
AD9888
PLL & ADC
FAST-X OPTION CONNECTOR
Figure 3: A block Diagram of the Fast-X UXGA option is shown below
FAST-X UXGA OPTION FEATURE SUMMARY
Board
3"X4" board with a proprietary interface
Video I/O Connections
Four RGB & SYNC Inputs, five wires or sync on
green. Two channels active at any time
Video I/O Extender card
Mezzanine expansion card with 152-pin VHDCI
connector.
Plugging-in a Video I/O Extender daughter card
replaces standard video connections with a variety
of analog and digital video formats
Performance
640x480 to 1600x1200 with a 10 MHz to 205 MHz
pixel clock and Phase locked loop clock
restoration
Software Development
Fast Motion Library for Windows
ALRT for Stretch
System Requirements
Fast-X
Temperature
0
o
C (32
o
F) to 55
o
C (131
o
F)
Relative Humidity: up to 95% (non-condensing)
HARDWARE OVERVIEW
This section provides an overview of Fast-X UXGA hardware.

10 of 28
VIDEO INPUTS
The video inputs are designed to interface to several different video standards.
• VGA Video, or video from the output of an analog output computer display adapter.
This is three wires of 1 volt video with two separate syncs as TTL levels.
• Sync on Green color video. This is three wires of analog video, with the green channel
carrying a composite sync.
• Single channel of monochrome analog composite video
The video inputs are terminated to ground with 75 ohms and capacitive coupled into the
ADC inputs. DC restore is provided by clamping to black.
The sync inputs are pulled up and terminated with 2K.
ADC ADI9888B
The Analog Devices AD9888B is type of ADC used on the Fast-X UXGA Option. A block
diagram of the AD9888B is shown below.
Figure 4, AD9888 internal architecture
ADC9888B Features:

11 of 28
• 205 MSPS Maximum Conversion Rate
• 500 MHz Programmable Analog Bandwidth
• 0.5 V to 1.0 V Analog Input Range
• Less than 450 psec p-p PLL Clock Jitter @ 205 MSPS
• 3.3 V Power Supply
• Full Sync Processing
• Sync Detect for “Hot Plugging”
• 2:1 Analog Input Mux
• 4:2:2 Output Format Mode
• Mid-scale Clamping
• Power-Down Mode
• Low Power: <1 W Typical @ 205 MSPS
The AD9888B provides for the conversion of the analog vide to digital video. The AD9888B has
an input multiplexer with two inputs. The digital output of the AD9888B is provided on one or
two 24 bit digital channels. At higher data rates the two outputs can be used as a double data
rate interface. The AD9888B is configured via the I
2
C interface from the Fast-X/Fast-Xe board.
I
2
C INTERFACE
The I
2
C interface exposes 32 registers to control the operation of the AD9888Bs. Each
AD9888Bs has a separate slave address, Channel 1, Mux 0 and 1 are addressed at 0x98,
while Channel 2, Mux 0 and 1 are addressed at address 0x9A. Please see the ADI9888B data
sheet on the operation of the I
2
C interfaces. The ALRT Runtime and the Fast Motion Library
provide APIs that do not require knowledge of the I
2
C interface.
CONNECTOR PINOUT
Table 6 – Pinout of the UXGAoption input connector
Pin Function Function Pin
1 HSYNC Ch1 Mux1 GROUND 35
2 RED Ch1 Mux1 GROUND 36
3 GREEN Ch1 Mux1 GROUND 37
4 BLUE Ch1 Mux1 GROUND 38
5 VSYNC Ch1 Mux1 GROUND 39
6 NC = No Connect GROUND 40
7 NC GROUND 41
8 HSYNC Ch1 Mux2 GROUND 42
9 RED Ch1 Mux2 GROUND 43
10 GREEN Ch1 Mux2 GROUND 44
11 BLUE Ch1 Mux2 GROUND 45
12 VSYNC Ch1 Mux2 GROUND 46
13 NC GROUND 47
14 NC GROUND 48
15 HSYNC Ch2 Mux1 GROUND 49

12 of 28
16 RED Ch2 Mux1 GROUND 50
17 GREEN Ch2 Mux1 GROUND 51
18 BLUE Ch2 Mux1 GROUND 52
19 VSYNC Ch2 Mux1 GROUND 53
20 NC GROUND 54
21 NC GROUND 55
22 HSYNC Ch2 Mux2 GROUND 56
23 RED Ch2 Mux2 GROUND 57
24 GREEN Ch2 Mux2 GROUND 58
25 BLUE Ch2 Mux2 GROUND 59
26 VSYNC Ch2 Mux2 GROUND 60
27 NC GROUND 61
28 NC GROUND 62
29 NC GROUND 63
30 NC GROUND 64
31 NC GROUND 65
32 NC GROUND 66
33 NC GROUND 67
34 NC GROUND 68
SOFTWARE MODEL
The software model for the Fast-X UXGA option is very simple. From the Stretch processor
which provides the I
2
C interface, the AD9888Bs are controlled. As these are the only
components on the UXGA board (excluding their glue circuits) the data sheet for the AD9888
provides the software model via the definition and use of the internal registers of the AD9888.
The data passed back to the front end FPGA of the Fast-X board handles the collection of data
from the two AD9888Bs and the transfer of that data to the Stretch processor. ALRT provides
Stretch APIs to access the hardware, while Fast Motion Library provides the more useful
interfaces as message based commands. Both software packages provide for an ASCII control
file, which operates all the settings of the AD9888B.
Please see the Fast Motion Library Documentation or the Documentation for ALRT for Stretch
for the details of the software.
THEORY OF OPERATION
This section describes the functionality of the firmware in the FPGA and the Stretch processor
to explain how the UXGA option is used.

13 of 28
Figure 5 Data and flow control
The diagram above shows the data and control flow for the UXGA option. It shows the logical
blocks in the FPGA which is on the Fast-X/e board, as well as the host interface. The AD9888s
provide for the conversion of the analog video to digital form. The input FIFOs convert the
digital data clock domain from the video clock speed to the 200 MHz clock used for the rest of
the interface. The input FIFOs also provide a small amount of storage. Note: this limits the
average video pixel rate to 200 mega pixels per second, for each video interface.
Video packets are generated as 32 byte data payload, with four bytes of address. The packets
are stored in the large FIFO, until the DMA controller needs them. The large FIFO provides for
any not ready conditions on the SYSAD bus to the Stretch processor. Video packets contain
the target address of the buffer they go to in Stretch memory. The 2 Channel DMA controller
provides for the transport of the video packets for both channels at the same time. The DMA
controller is programmed by the Stretch to double buffer the data into Stretch memory.
Figure : Stretch memory flow

14 of 28
The sequence of operation of the system is as follows. (1) The Stretch programs the AD9888s
over the I-squared-C bus to digitize the input video. (2) The Stretch programs the input FIFOs
to accept data from the AD9888s (essentially just an enable). (3) The Stretch programs the
DMA controller, to use two buffers in Stretch memory for each channel. (4) The Stretch starts
the DMA controllers which enables the data flow. From this point video will be presented to the
Stretch processor in a buffer in memory. The Stretch processor is notified of the buffer being
ready (full) with an interrupt. For most applications the Stretch does not need to reprogram the
interface while it is operating, except to switch the input multiplexers in the AD9888s.
Please see the Fast Motion Library manual for the details of the data flow, as well as the ALRT
for Stretch manual for the details of the operation of the option boards.
The FPGA that implements the above data flow can be customized to provide different types of
functionality. Please contact Alacron should you require modification to the FPGA firmware.
INTRODUCTION TO THE ALACRON OCX MODEL
When developing under Windows Alacron provides an OCX pathway to speed application
development. These OCXs are also used in the canned Alacron applications and Libraries
such as FastMotion Application and FastMotion Library that support simplified custom
development. Alacron’s development pathways are outlined in the table below.

15 of 28
Thus this section will concentrate on the documentation and use cases of the Alacron Imaging
and the Alacron Stretch/Nexperia OCXs.
A LACRON I MAGING OCX
ALP ICTURE OCX
I NTRODUCTION
The Alacron Picture OCX (Alpicture.ocx) provides an easy way for a user to display an image
from his application. It is not intended to be a high performance display object, but rather a load
and examine the image tool. It can display several images a second, and is depends on the
speed of the processor to do this. It does not take advantage of DirectX or OpenGL.
D EFINITION
The Alpicture.ocx can be defined by it Interfaces Description which we present in the IDL used
to describe it. This OCX uses the MFC class library to leverage the predefined classes in MFC.
It can not claim to be a light weight control, but rather a multipurpose control.
ALPICTURE T YPE L IBRARY IDL
[uuid(F3D73419-0BEE-438C-BA84-264B37A829C5), version(2.0),
helpfile("ALPicture.hlp"),
helpstring("ALPicture 2.0 ActiveX Control module"),
control ]
[ uuid(B6C7F46D-FF0B-4B3B-9FD0-5CD704A74493),
helpstring("Dispatch interface for ALPicture Control 2.0"), hidden ]
dispinterface _DALPicture
{
properties:
[id(DISPID_HWND)] OLE_HANDLE hWnd;
[id(DISPID_READYSTATE), readonly] long ReadyState;
[id(0), readonly] long _ReadyState;
[id(1)] float Zoom;
[id(2)] long XOrigin;
[id(3)] long YOrigin;
[id(4)] boolean RedEnable;
[id(5)] boolean BluEnable;
[id(6)] boolean GrnEnable;
[id(7)] boolean AutoZoomAndPan;
[id(14)] boolean Rotated;
// 2.0 feature
[id(18), readonly] float Compression;
methods:
[id(8)] SCODE Update(long* Image, short Shift);

16 of 28
[id(9)] SCODE Create(long* Image, short Shift);
[id(10)] SCODE Move(long X, long Y);
[id(11)] SCODE ClientToImage(long X, long Y, long* iX, long* iY);
[id(12)] SCODE ImageToClient(long X, long Y, long* cX, long* cY);
[id(13)] SCODE UpdateROI(long* Image, long X, long Y,
long sX, long sY,short Shift);
[id(15)] SCODE ClearROI(long X, long Y,
long sX, long sY, long value);
[id(16)] SCODE MoveI(long x, long y);
// 2.0 feature
[id(17)] SCODE SwapColors (long a, long b);
[id(DISPID_ABOUTBOX)] void AboutBox();
// Event dispatch interface for CALPictureCtrl
[ uuid(C0EC6F6F-7393-4754-B39A-7FBF55CA0C1C),
helpstring("Event interface for ALPicture Control 2.0") ]
dispinterface _DALPictureEvents
properties:
// Event interface has no properties
methods:
[id(DISPID_READYSTATECHANGE)] void ReadyStateChange();
[id(DISPID_MOUSEMOVE)] void MouseMove(short Button, short Shift,
OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y);
[id(DISPID_MOUSEUP)] void MouseUp(short Button, short Shift,
OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y);
[id(DISPID_DBLCLICK)] void DblClick(short Button, short Shift,
OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y);
// Class information for CALPictureCtrl
[ uuid(E582F61D-81DF-406C-9F49-FA9332DA6496), licensed,
helpstring("ALPicture Control 2.0"), control ]
coclass ALPicture
{
[default] dispinterface _DALPicture;
[default, source] dispinterface _DALPictureEvents;
};
ALPICTURE P ROPERTIES
id(DISPID_HWND) OLE_HANDLE hWnd;
This is a stock property provided by MFC for all controls. It is the handle to the window which is
the face of the control.
id(DISPID_READYSTATE) long ReadyState;
This is a stock property provided by MFC for all controls. It is set to True and stays true.

17 of 28
id(1) float Zoom;
This variable controls how the images are displayed on the controls surface. When set to 1.0
the pixels of the image are display as pixels on the screen, this is some time called 1:1 viewing.
If set to less than one a larger piece of the image is displayed (zoom out). If set larger than one
a small portion of the image is displayed (zoom in).
id(2) long XOrigin;
This property controls which pixel is displayed in the upper left corner of the OCX display
surface. Large values display pixels to the right.
id(3) long YOrigin;
This property controls which line is displayed at the top of the OCX display surface. Larger
values move down the image.
id(4) boolean RedEnable;
If the image is color, and the RedEnable is true, then the first plane of the image is displayed. If
it is false the first plane is not displayed. For non-RGB formats for example YUV 4:4:4 this
refers to the Y part of the image. All images are converted from their native format to RGB
when input to the control. Typically no color space conversion is done.
id(5) boolean BluEnable;
If the image is color, and the BlueEnable is true, then the last plane of the image is displayed. If
it is false the last plane is not displayed. For non-RGB formats for example YUV 4:4:4 this
refers to the V part of the image. All images are converted from their native format to RGB
when input to the control. Typically no color space conversion is done.
id(6) boolean GrnEnable;
If the image is color, and the GrnEnable is true, then the middle plane of the image is
displayed. If it is false the middle plane is not displayed. For non-RGB formats for example YUV
4:4:4 this refers to the U part of the image. All images are converted from their native format to
RGB when input to the control. Typically no color space conversion is done.
id(7) boolean AutoZoomAndPan;
This flag controls whether the use of the control can pan and zoom the control view with the
mouse and the shift key.
Normally the mouse just moves the cursor over the image. If the shift key is held down (either
one), the image will pan. The panning area is the central portion of the display area, and is
scaled so you can pan of the whole image without double dragging.
id(14) boolean Rotated;
This flag allows one to rotate the image 90 degrees, before displaying.
id(18) readonly] float Compression;
This property is set to the compression level of a JPEG image if one
is passed to the control.
ALPICTURE M ETHODS
id(8) Update(long* Image, short Shift);
This method is used to provide a pointer to the image structure containing the image. The shift
factor is applied to the pixel planes before display. The image structure is defined below. A long
pointer is used to avoid complexity in the IDL of little benefit. As the pointer is being passed into
the control, this method can not be used across processes. The Update API is canned by the
Create API and is typically not used by a user. The Update method assumes that the image
surface has already been setup in memory to match the display characteristics of the display
mode in effect.
id(9) Create(long* Image, short Shift);
This method is used to provide a pointer to the image structure containing the image. The shift
factor is applied to the pixel planes before display. The image structure is defined below. A long
pointer is used to avoid complexity in the IDL of little benefit. As the pointer is being passed into

18 of 28
the control, this method can not be used across processes. The Update API is canned by the
Create API and is typically not used by a user. The Create API builds an image surface in
memory that matches the input image and then passes it to the Update method.
id(10) Move(long X, long Y);
This method moves the display window around on the image surface. The X and Y parameters
are in display window space, X being the display pixel (column) and Y being the display line
(row) of the image. The display window will move so X,Y is in the center of the display area.
id(11) ClientToImage(long X, long Y, long* iX, long* iY);
The method will take a point on the display surface of the image, and return its image
coordinates.
id(12) ImageToClient(long X, long Y, long* cX, long* cY);
This method will take a point on the image and return its coordinates on the display surface.
Note the returned values are not clipped, and could be out side the display area of the OCX.
id(13) UpdateROI(long* Image, long X, long Y, long sX, long sY,short Shift);
This method allows you to update a portion of an image. As big images can take a long time to
be processed into the control. This API allows a smaller are of an image to be updated. It can
be used to combine images on the same display surface. It uses the copy raster op to update
the image surface, the pixels of the ROI that are on the display surface are replaced with those
in the input image.
id(15) ClearROI(long X, long Y, long sX, long sY, long value);
This method updates an ROI to black, or all zero.
id(16) MoveI(long x, long y);
This method moves the display window so that the point (x,y) in the image is in the center of
the display window. X and y are in image coordinates.
id(17) SwapColors (long a, long b);
This method allows the user to swap the display planes of the image. The parameters are the
plane indexes (0=R,1=G,2=B etc.) to swap. It supports three cases (which are all there are):
Swap 0 with 1
Swap 0 with 2
Swap 1 with 2
id(DISPID_ABOUTBOX) void AboutBox();
This method will display the about box.
T HE I MAGE S TRUCTURE
The (long *) used in the methods above point to a structure called an image structure which is
used in Alacron’s OIL library and most other places in the Alacron software. It has the following
definition:
typedef struct image_struct {
int nr;
int nc;
int st;
itype_t itype;
int bpp;
void *data;
void (*pfree) (struct image_struct *pi);
void *extension;

19 of 28
memclass_t memclass;
int ncomp;
struct image_struct *next;
int id;
} image_t;
Most of these fields are clear. 'nr' number of rows (lines) in the image, sometimes also called
the height of the image. 'nc' is the number of columns, pixels,width of the image. 'st' is the
image stride, or the number of bytes from the left most pixel in a line to the left most pixel in the
next line. Note: It can be negative. 'data' points to the actual image data. The size of this data
area is at least nr*st bytes. 'pfree' points to a function which can free the image data and the
structure. This function is used by the OIL API ImageFree. 'extension' is a pointer to data that
some how extends the image (like a color map). 'memclass' describes the type of memory that
the image data uses. Normally this is local memory. 'ncomp' reflects the number of additional
image structures linked on the 'next' field. For planer images each plane is a separate image
linked in a list on the 'next' field. 'id' is an application specific value.
The OCX only uses nr,nc.st.itype,bpp,data, and ncomp. The other fields are not read.
What is passed to the OCX APIs as a long pointer is a pointer to the image structure in
memory.
The two enum types are:
typedef enum {IMAGE_CLASS_LOCAL=1, IMAGE_CLASS_PCI} memclass_t;
This type indicates the kind of memory being used, which for the host will always be
IMAGE_CLASS_LOCAL. The OCX does not use this field.
typedef enum {
IMAGE_TYPE_GRAY8 = 1,
IMAGE_TYPE_GRAY16,
IMAGE_TYPE_GRAY32,
IMAGE_TYPE_YUV422,
IMAGE_TYPE_YUV420,
IMAGE_TYPE_RGBPLANER,
IMAGE_TYPE_RGB15,
IMAGE_TYPE_RGB16,
IMAGE_TYPE_RGB24,
IMAGE_TYPE_RGB32,
IMAGE_TYPE_GRAY32F,
IMAGE_TYPE_BINARY,
IMAGE_TYPE_RGBPLANER16,
IMAGE_TYPE_RGBPLANER32,
IMAGE_TYPE_RGB48,
IMAGE_TYPE_BINARYR,
IMAGE_TYPE_RGB8_332,

20 of 28
IMAGE_TYPE_RGB8_233,
IMAGE_TYPE_UYVY,
IMAGE_TYPE_BAYER8,
IMAGE_TYPE_BAYER16,
IMAGE_TYPE_BAYERLINER8,
IMAGE_TYPE_BAYERLINER16,
IMAGE_TYPE_YUV24, //YUV444 in 24 bit pixels
IMAGE_TYPE_YUV32, //YUV444 in 32 bit pixels
} itype_t;
This enum defines the type of data in memory.
ALPICTURE E VENTS
This OCX supports these events:
void ReadyStateChange();
This event is trigger if the OCX changes ready state, which it never does.
void MouseMove(short Button, short Shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS
y);
This event allows the user to trap mouse movements over the control.
void MouseUp(short Button, short Shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y);
This event is triggered when a mouse button is released in the OCX. This is used as a click
indication
void DblClick(short Button, short Shift, OLE_XPOS_PIXELS x, OLE_YPOS_PIXELS y);
This event is triggered if the mouse is double clicked within the OCX display window.
U SING THE CONTROL
Be sure you have the file 'alpicture.lic' in the same directory and the OCX if you are developing
software. This file is needed to enable the control to be inserted in a new application.
The control as provided will need to be Com registered as all OCXs are. The control contains
code to do that for you. This can be done using the program 'regsvr32.exe' which is in the
Windows System32 directory. You can drag and drop the OCX on the file name or pass the
name of the control to the program on the command line.
If the control does not register, the likely cause is a DLL it uses is not found.
The DLLs used by the control are:
GDIPLUS.DLL Microsoft
LIBBASICFF.DLL Alacron Inc.
MFC71.DLL Microsoft
MSVCR71.DLL Microsoft
All the other DLLs used are provided with the Windows installation.