Pegasus Imaging's Web Licensing FAQ's

Web Licensing FAQ

This page contains frequently asked questions regarding Web Licensing of all current versions of Pegasus Imaging development toolkits.

Q1: What are the steps to license a Pegasus Imaging control in a client-side web application?

Q2: How do I add a Pegasus Imaging control object to an HTML document?

Q3: Where can I obtain the Microsoft ActiveX Control tool?

Q4: What is an LPK file?

Q5: How do I create an LPK file for a Pegasus Imaging control?

Q6: How do I add an LPK object to an HTML document?

Q7: How do I call the UnlockWeb method from an HTML document?

Q8: How do I obtain an UnlockWeb license string?

Q9: What information is required to obtain an UnlockWeb license string?

Q10: What is a CAB file?

Q11: Where can I obtain a CAB file for the appropriate Pegasus Imaging control?

Q12: Where are the HTML, LPK and CAB files deployed on the web server?

Q13: How do I license a Pegasus Imaging control on a server-side web application that does not provide a user interface?

Q1: What are the steps to license a Pegasus Imaging control in a client-side web application?

Licensing a Pegasus Imaging Corporation control on a client-side web application requires successful completion of the following steps. Please note that all these steps must be followed exactly in order to successfully license the control.

1) Add the Pegasus ActiveX control to the web document using the HTML <OBJECT> tag.
2) Add the LPK license manager into the web document using the HTML <OBJECT> tag.
3) Call the UnlockWeb method from within the HTML document <SCRIPT> tag.
4) Deploy the web document, LPK and CAB files to the web server.

Q2: How do I add a Pegasus Imaging control object to an HTML document?

The following procedure demonstrates how to insert a Pegasus ActiveX control into an HTML document using the Microsoft ActiveX Control Tool.

1) Click Edit=>Insert ActiveX Control… to open the "Insert ActiveX Control" dialog.
2) Select a Pegasus control from the "Control Type:" listbox control. For example: "Pegasus ImagXpress Control v7.0".
3) Click the "OK" button to open the "Edit ActiveX Control" tool dialog, which displays the properties for the inserted ActiveX control.
4) Enter the name for the Pegasus ActiveX control into the "ID" property row. e.g. "ImagXpress1".
5) Click the "Apply" button.
6) Close the "Edit ActiveX Control" tool to insert the <OBJECT> tag into the HTML document.
7) The only required Pegasus component object properties include _ExtentX, _ExtentY, ErrStr, ErrCode and ErrInfo. All other parameters should be removed from the <OBJECT> tag in the HTML document.

For example:
<HTML>
    <HEAD>
        <TITLE>New Page</TITLE>
    </HEAD>
    <BODY bgcolor="BLUE">
        
        <OBJECT CLASSID="clsid:5220cb21-c88d-11cf-b347-00aa00a28331">
            <PARAM NAME="LPKPath" VALUE="all.lpk"/>
        </OBJECT>
        
         <SCRIPT LANGUAGE="VBScript">
         ImagXpress1.UnlockWeb "https://www.jpg.com?CE16B69B69AEB7C57975250040C9"
         </SCRIPT>

     </BODY>
</HTML>

Q3: Where can I obtain the Microsoft ActiveX Control tool?

The Microsoft ActiveX Control Tool may be downloaded from the following link:
http://download.microsoft.com/download/activexcontrolpad/Install/4.0.0.950/WIN98MeXP/EN-US/setuppad.exe

Q4: What is an LPK file?

A license package file (LPK) stores all run-time licenses for ActiveX controls used in a single HTML document. Additional information is available from the following link:
http://support.microsoft.com/default.aspx?scid=http://support.microsoft.com:80/support/kb/articles/Q159/9/23.ASP&NoWebContent=1

Q5: How do I create an LPK file for a Pegasus Imaging control?

The LPK file is created using the Microsoft License Package Authoring Tool on the development machine where the Pegasus control toolkit is installed and registered. Only one LPK file may be utilized in a single HTML document; a single LPK file must be created for all licensed ActiveX controls utilized in a particular HTML document. The Microsoft License Package Authoring Tool may be obtained from the following link:
http://www.microsoft.com/downloads/details.aspx?FamilyID=d2728e89-575e-42e9-a6ff-07d0021e68cc&DisplayLang=en

Q6: How do I add an LPK object to an HTML document?

After creating an LPK file using the Microsoft License Package Authoring Tool an <OBJECT> HTML tag must be introduced to specify the location of the LPK file. Each HTML document is limited to a single LPK object. The license package object must be specified before any other component objects tags in the document.

For example:
<HTML>

<HEAD>
        <TITLE>New Page</TITLE>
</HEAD>

<BODY bgcolor="BLUE">
        <-- // Only one license package file (LPK) per
            // HTML Document
            // -->
        <OBJECT CLASSID="clsid:5220cb21-c88d-11cf-b347-0aa00a28331">
            <PARAM NAME="LPKPath" VALUE="all.lpk">
        </OBJECT>
        
         <OBJECT ID="ImagXpress1" WIDTH=100 HEIGHT=51
             CLASSID="CLSID:6D3CF4F3-C2F3-46E7-A126-3E53102A6B91"
             CODEBASE="imagxpress7.cab">
             <PARAM NAME="_ExtentX" VALUE="5080"/>
             <PARAM NAME="_ExtentY" VALUE="5080"/>
             <PARAM NAME="ErrStr" VALUE="4D0A1788335DD9A71D7FED01CDE208F3"/>
              <PARAM NAME="ErrCode" VALUE="464262469"/>
             <PARAM NAME="ErrInfo" VALUE="-1362856377"/>
         </OBJECT>

         
         <SCRIPT LANGUAGE="VBScript">
         ImagXpress1.UnlockWeb "https://www.jpg.com?CE16B69B69AEB7C57975250040C9"
         </SCRIPT>

     </BODY>
</HTML>

Q7: How do I call the UnlockWeb method from an HTML document?

The UnlockWeb method is used inside <SCRIPT> tags of an HTML document. The UnlockWeb method is called using the web license string supplied by Pegasus Imaging Corporation. The UnlockWeb method should be called immediately after the Pegasus control object is declared.

For example:
<HTML>
     <HEAD>
         <TITLE>New Page</TITLE>
     </HEAD>
     <BODY bgcolor="BLUE">

         
         <OBJECT CLASSID="clsid:5220cb21-c88d-11cf-b347-00aa00a28331">
             <PARAM NAME="LPKPath" VALUE="all.lpk"/>
         </OBJECT>

         
         <OBJECT ID="ImagXpress1" WIDTH=100 HEIGHT=51
             CLASSID="CLSID:6D3CF4F3-C2F3-46E7-A126-3E53102A6B91"
             CODEBASE="imagxpress7.cab">
             <PARAM NAME="_ExtentX" VALUE="5080"/>
             <PARAM NAME="_ExtentY" VALUE="5080"/>
             <PARAM NAME="ErrStr" VALUE="4D0A1788335DD9A71D7FED01CDE208F3"/>
             <PARAM NAME="ErrCode" VALUE="464262469"/>
             <PARAM NAME="ErrInfo" VALUE="-1362856377"/>
         </OBJECT>

         
         <SCRIPT LANGUAGE="VBScript">        ImagXpress1.UnlockWeb "https://www.jpg.com?CE16B69B69AEB7C57975250040C9"
         </SCRIPT>

     </BODY>
</HTML>

Q8: How do I obtain an UnlockWeb license string?

If you do not have an UnlockWeb license string specific to your licensed product and serial number then please review the "Client Deployment" documentation available at the following link and contact sales@jpg.com to arrange appropriate licensing: http://www.pegasusimaging.com/licensing.htm. The link to the Pegasus Imaging Corporation application that generates the UnlockWeb string is provided when client runtime licenses are purchased.

Note: If you are not sure what information you must provide Pegasus Imaging in order to generate the web license string, please see the answer to the next question, Q9.

Q9: What information is required to obtain an UnlockWeb license string?

Two pieces of information are required in order to obtain the UnlockWeb license string for use in the client-side web application:
1) IP address or server name
2) Product serial number

The server information provided must match identically to the URL used to access the web page from the Internet Explorer URL address bar. For example, if you are going to be accessing the web page as www.pegasusimaging.com or http://www.pegasusimaging.com then we need the server name which in this case is pegasusimaging and if you are going to be accessing the web page as 152.58.55 or http://152.58.55 then we need the IP address. Always use lower case. For example:

pegasusimaging
asp.imageproject
jpg.com/directory
152.58.55

If the web page is accessed over a secure web server (https) then the supplied server name must reflect this to ensure a properly generated web license string is supplied. Again, use lower case and drop "www." For example:

https://pegasusimaging
https://152.58.55

Also, please note that we never need the port address in the string that is provided us.

Q10: What is a CAB file?

Cabinet (CAB) files are used to distribute applications. Client-side applications shall automatically download and install Pegasus ActiveX controls using cabinet files. The Pegasus control's cabinet file is specified within the objects declaration using the "CODEBASE" property of the <OBJECT> tag in the HTML document.
Please download the PegConnect utility program from the following link: PegConnect
or reference the Latest Builds page. For example:
<HTML>
     <HEAD>
         <TITLE>New Page</TITLE>
     </HEAD>
     <BODY bgcolor="BLUE">


         <OBJECT CLASSID="clsid:5220cb21-c88d-11cf-b347-00aa00a28331">
             <PARAM NAME="LPKPath" VALUE="all.lpk"/>
         </OBJECT>

         
         <OBJECT ID="ImagXpress1" WIDTH=100 HEIGHT=51
             CLASSID="CLSID:6D3CF4F3-C2F3-46E7-A126-3E53102A6B91"
             CODEBASE="imagxpress7.cab">
             <PARAM NAME="_ExtentX" VALUE="5080"/>
             <PARAM NAME="_ExtentY" VALUE="5080"/>
             <PARAM NAME="ErrStr" VALUE="4D0A1788335DD9A71D7FED01CDE208F3"/>
             <PARAM NAME="ErrCode" VALUE="464262469"/>
             <PARAM NAME="ErrInfo" VALUE="-1362856377"/>
         </OBJECT>

         
         <SCRIPT LANGUAGE="VBScript">
         ImagXpress1.UnlockWeb "https://www.jpg.com?CE16B69B69AEB7C57975250040C9"
         </SCRIPT>

     </BODY>
</HTML>

Q11: Where can I obtain a CAB file for the appropriate Pegasus Imaging control?

Please download the necessary CAB file(s) from the following links:

ImagXpress® v9
ImagXpress®/NotateXpress™ v9
ImagXpress® v8
ImagXpress®/NotateXpress™ v8
ISIS® Xpress™ v2
ISIS® Xpress™ v3
CapturePRO™ v3
PDFXpress™
PDF Xpress™ v2
PrintPRO™ v4
Smartscan Xpress™ Barcode v4
Smartscan Xpress™ ICR/OCR/OMR v4
Smartscan Xpress™ ICR/OCR/OMR/MICR v3
TwainPRO™ v5
ScanFix® v5
ThumbnailXpress™ v2
OCR Xpress™
SmartZone™

Q12: Where are the HTML, LPK and CAB files deployed on the web server?

The HTML document, LPK and CAB files are placed in a common directory on the web server.

Q13: How do I license a Pegasus Imaging control on a server-side web application that does not provide a user interface?

It is necessary to call the PS_Unlock function for the Pegasus control. The PS_Unlock function serves to suppress the licensing dialog that will attempt to display. If the PS_Unlock function is not used then the symptom that you would see is that your web page would hang on the server.

Pegasus has created a helper DLL to expose the PS_Unlock function so that it may be called from an HTML document. If you are using the control in this manner please send an e-mail to: support@jpg.com and they can send this to you.

Please note that in order to use this DLL you will need your unlock codes. Lost unlock codes may be automatically requested from the following link: http://www.pegasusimaging.com/lostcodes.htm.