is an ActiveX control implementing a high performance viewer for documents stored in
a variety of document image formats,
including TIFF, CALS, JEDMICS, JFAX, and
CPC.
The viewer supports
document navigation, arbitrary scaling, anti-aliased images in both a
page view and thumbnail view, and much more.
Consult the CPC View User's Guide
for a complete description of the viewer's capabilities and user interface.
is one member
of the CPC View product family. This document describes installation notes
and other technical details specific to .
Consult the CPC View Programmer's Guide for
general information on the CPC View programming model.
This release of is targeted to developers of web based products
using Internet Explorer 4 or later.
If used in conjunction with Internet Explorer, the control can be downloaded
and installed automatically. See § Automatic Installation
for more information.
Prior to use, the control must be installed on the host computer.
You can download
the latest version of from the Cartesian web site.
To install the control manually, use the regsvr32 utility.
(The regsvr32 utility is included as part of Windows 95, Windows 98, and Windows NT.)
For example, if you saved the control to
c:\Program Files\Cartesian Products\CpcViewAX.ocx,
the following command would register the control:
In order to use , it must be embedded in a host application that supports
ActiveX controls (e.g., Internet Explorer; MFC).
exposes a custom programming and event interface allowing complete
interactive control of the viewer by the host application.
Consult the CPC View Programmer's Guide for a
complete description of the programming interfaces.
Under Windows, each ActiveX control is assigned a unique class ID that is used
to identify the control. Many host applications require specification of the control's
class ID in order to instantiate the control. The class ID of the control
is:
0F7A9297-7268-11D1-B81A-00A076C01B0A.
See § Using the Control with Internet Explorer for more information on instantiating the
control
under Internet Explorer. For all other host applications,
consult the documentation for the host application.
An instance of the control displays exactly one image document at a time. The
instance's SRC property
specifies the URL of the current image document.
The URL must point to an image file in one of the
supported formats.
If the host application supports it, retrieves the URL using the
context of the host application. In particular, this means that HTML
pages displayed within Internet Explorer can use URLs relative to the base
URL of the HTML page.
will begin loading the image document as soon as its SRC property is set.
All image loading is performed in the background, so the host application regains control
immediately. If the value of the SRC property is changed, will dispose of the
current image data and initiate loading of the new image from the new URL.
The SRC property can be augmented with optional
URL parameters which describe
the desired initial state of the user interface. The URL parameters are specified
by appending to the URL a '?' followed by the parameters.
For example, the URL http://foobar.org/abc.cpc?strict;page=2 would cause the
control to display page 2 of the image found in http://foobar.org/abc.cpc.
For more information on URL parameters, consult the CPC View Author's Guide.
Internet Explorer will not pass the URL parameters to the control if the
'#' separator is used. You must use the '?' separator.
Internet Explorer uses the fullscreen property to differentiate between
fullscreen instances of the control, in which the control occupies the entire frame
of the host, and embedded instances of the control, in which the control shares space
with other elements within the host frame. uses this parameter to differentiate
its behavior in the following ways
In fullscreen mode, if the image is smaller than the size of the control's window,
the uncovered portion of the window is drawn with the window background color;
otherwise, if the image is smaller than the size of the control's window,
the uncovered portion of the window is drawn with the image background color.
In fullscreen mode, the control defaults to fit the image to the width of the screen;
otherwise, the control defaults to fit the image to the control's window.
In fullscreen mode, user UI preferences are maintained on a per document basis;
otherwise, user UI preferences are not maintained.
In fullscreen mode, a standard client window border is drawn around the control;
otherwise, the border is not drawn.
Perhaps the easiest way to use is as a full page viewer.
A full page viewer occupies an entire window or frame within Internet Explorer.
Internet Explorer will automatically load into the
full frame whenever the browser is directed to a URL of the
appropriate mime type.
Simply specify the image URL as the href attribute of an <A>
tag or as the src attribute of a <FRAME> tag.
For example, we can specify a hyperlink directly to an image file using the
following HTML:
Under full page viewing, URL parameters will only work as part of an http: URL.
Internet Explorer will not pass on URL parameters specified as part of a file: URL.
In addition to using the to view image documents in a full
frame or window, the control can also be embedded within an
HTML document using either the
<EMBED> tag or the <OBJECT> tag.