Pegasus Imaging's CapturePRO v3 FAQ's

CapturePRO™ v3 FAQ

Q1: How can I determine if I have the latest version of a Pegasus control?

Q2: I'm having an issue with CapturePRO v3. What can I do?

Q3: How do I distribute my application (in .NET, Delphi, VB etc.)?

Q4: What DLL's do I need to distribute with my application?

Q5: Does CapturePRO support multichannel boards?

Q6: Does CapturePRO support MPEG capture?

Q1: How can I determine if I have the latest version of a Pegasus control?

Please download the PegConnect utility program from the following link: PegConnect
or reference the Latest Builds page.

Q2: I'm having an issue with CapturePRO v3. What can I do?

There are some things you should check before contacting Pegasus support:

1) Please make sure you installed all the critical updates and service packs for your version of Windows. Critical updates and service packs can be installed via the Windows Update service at: http://windowsupdate.microsoft.com

2) Please make sure you have DirectX 8.0a or better installed. The current version is 9.0b and can be installed via the Windows Update service. Although CapturePRO only requires DirectX 8.0a or better, we have found that updating to 9.0b sometimes "fixes" problems with a particular capture device.

3) Please make sure you have the current drivers for the capture device you are using. Please check the manufacturer's website to make sure. If you are experiencing lockups or blue screens, the most likely cause is the hardware driver. Please note that we cannot supply a list of recommended hardware as there are simply too many capture devices with too many interim driver updates to maintain such a list. Given that DirectX 9 and XP have been out for a while now, it's a reasonable assumption that most new drivers are tested primarily on XP with DirectX 9.

4) Please test with another capture device (such as an inexpensive Logitech webcam) to make sure your problem is not hardware-related.

5) Please try the Microsoft AMCap utility and see if it works with your card. The current CapturePRO installer places it by default in:

C:\Program Files\Pegasus Imaging\CapturePRO\V3.0\Utilities\AMCap

6) Please make sure you have the current version of CapturePRO installed. You can get the CapturePRO version number either from the version resource of the DLL (CapturePRO3.dll in the System32 folder) or by bringing up the CapturePRO About box. If you have CapturePRO 3.1.5.0 or greater, you can use the PegConnect utility to update the DLL. PegConnect can be obtained here: PegConnect

If you have an older version of CapturePRO, please download it from here:

ftp://jpg.com/capturepro/cappro.exe

7) Please check the CapturePRO 3.0 Changes document to see if there is a known issue with your hardware.

8) If you are still experiencing a problem and it doesn't seem to be hardware related, please mail a test application to support@jpg.com with source so we can reproduce the problem. We prefer to deal with VB (6 or .NET), Visual C++, C#, Delphi, or scripted HTML projects, but if you are using some other environment, let's discuss it before you send in your test application.

Q3: How do I distribute my application (in .NET, Delphi, VB etc.)?

PLEASE NOTE: You must have your unlock codes to distribute your application in the majority of the scenarios outlined below. If you do not have these please complete the form at: http://www.pegasusimaging.com/lostcodes.htm and the codes will be sent to you.

1) If you are using .NET as your development tool you must call the UnlockPICCapturePro.PS_Unlock function and pass as the parameters the same 4 unlock codes that were received at the time of purchase.

For C# Developers:
Call the static PS_Unlock function in the class constructor BEFORE the generated call to InitializeComponent () as follows:

Public FormMain()
{
UnlockPICCapturePro.PS_Unlock(1234, 1234, 1234, 1234);
InitializeComponent();
}

For Visual Basic. NET Developers:
Call the static PS_Unlock function in the class constructor (i.e. New function) BEFORE the generated call to InitializeComponent () as follows:

Public Sub New ()
MyBase.New ()

UnlockPICCapturePro.PS_Unlock(1234, 1234, 1234, 1234)

IntializeComponent ()

End Sub

2) If you are using the Delphi VCL as your development tool you must declare the PS_Unlock function as outlined below:

procedure PS_Unlock(pw1, pw2, pw3, pw4: LongInt); stdcall external 'CapturePRO3.dll ';

begin

Application.Initialize;
PS_Unlock(123456789,123456789,987654321,12345);
Application.CreateForm(TForm1, Form1);
Application.Run;
end.

3) If you are using the CapturePRO COM object in VC++ as your development tool you must declare the PS_Unlock function as outlined below:

The CapturePRO COM Object contains a locking mechanism that does not permit you to distribute applications created with evaluation versions of CapturePRO. When you purchase CapturePRO, you are given a set of 4 numeric registration codes that is your individual password set for unlocking CapturePRO for distribution.

If you do not unlock CapturePRO, applications will not run on end user machines.

Before distributing an application, you must unlock CapturePRO.

Cap_Open.cpp is included with CapturePRO to handle licensing for the COM Object. You can find Cap_Open.cpp in the CapturePRO VCCOM\Include directory. In the Cap_Open.cpp () function, locate the call to PS_Unlock(). Replace the four parameters in that call with the four registration codes you obtained when you registered CapturePRO. When you compile your project, CapturePRO should be unlocked meaning that you should no longer see the "Evaluation" message boxes.

4) If you are using the CapturePRO control as a COM object in VB you must declare the PS_Unlock function as outlined below:

  1) Add a reference to the CapturePRO control via Project|References.

  2)Declare the PS_Unlock function as follows:

  Private Declare Sub ControlUnlock Lib "capturepro3" Alias "PS_Unlock" (ByVal pw1 As Long, ByVal pw2 As Long, ByVal pw3 As Long, ByVal pw4 As Long)

  3)Dim the CapturePRO control object:

  Dim cp As CAPTUREPRO3Lib.CapturePRO

  4)Call the unlock method:

  ControlUnlock 1234, 1234, 1234, 1234
  Set pp = New CAPTUREPRO3Lib.CapturePRO

5) If you are using the control within HTML you must obtain a web license string. This web license string is received from our sales department when the web license is purchased. The web license string is passed as the parameter to the IntegratorWeb method. Please refer to http://www.pegasusimaging.com/weblicfaq.htm for more information on using the control within a web environment.

6) If you are using the CapturePRO ActiveX Control open your project with your development tool (Visual Basic or Delphi) and rebuild the EXE. The new registration information will be automatically incorporated in the new executable.

Q4: What DLL's do I need to distribute with my application?

For .NET Windows Forms Applications:
PegasusImaging.WinForms.CapturePRO3.dll

For All Other Applications:
CapturePRO3.dll
If you are using the CapturePRO COM component, it needs to be registered after it is installed. Make sure that your installation program registers the CapturePRO COM component before you run your application.

Q5: Does CapturePRO support multichannel boards?

CapturePRO will not work with most multichannel boards. The central issue is the drivers: most multichannel boards do not expose each channel as a separate device or even as a separate input. Instead, they usually require the user to write a callback function in order to get access to each frame from each channel. CapturePRO doesn't support this scheme and wasn't designed to accomodate it.

Q6: Does CapturePRO support MPEG capture?

CapturePRO can support MPEG capture if a third-party video CODEC is installed that supports this format.