|Oracle® Outside In Viewer Developer's Guide
Part Number E12845-02
The Oracle Outside In Viewer module is part of Oracle's family of OEM technologies known as Oracle Outside In, a powerful document viewing and conversion technology that can access the information in more than 500 file formats.
There may be references to other Oracle Outside In Technology SDKs within this manual. To obtain complete documentation for any other Oracle Outside In product, see:
and click on Outside In Technology.
The updated list of supported formats is linked from the page
http://www.outsideinsdk.com/. Look for the data sheet with the latest supported formats.
OIT's internal error processing has been updated and propagation of error codes throughout OIT has been improved. In many cases the error codes reported by OIT will now more accurately reflect the actual cause of the error. DAERR is now functionally the same as SCCERR and OIT API functions that return DAERR may return any of the SCCERR values defined in sccerr.h.
Office 2010 documents with encryption are now supported using our Password API.
Support for CMYK color spaces in JPEG files has been added.
Improved rendering of PDF Images with JBIG2, JPEG2000 compressions and with Explicit Masks.
Attachments in PDF Files are supported.
Support to view/print an image (vector or raster) at the size specified in the image file has been added.
Cell alignment in tables has been improved.
Support for tab leaders has been added.
Support for basic conditional formatting has been added to the Excel 2007 filter.
Support for charts in Office 2007 Binary Excel Files has been added.
The SCCID_TEMPDIR option now supports IOTYPE_UNICODEPATH on Windows.
The NSF filter is now supported on Linux x86-32 and Solaris Sparc 32. See NSF Support in the Unix Implementation chapter for for details about Unix environment variables.
The SCCID_PDF_FILTER_REORDER_BIDI option controls whether or not the PDF filter will attempt to reorder bidirectional text runs so that the output is in standard logical order as used by the Unicode 2.0 and later specification.
For each supported platform, the Oracle Outside In Viewer provides a way to create a rectangular view consisting of a horizontal scroll bar, a vertical scroll bar and a display area. This rectangle is referred to as the view window.
The view window is blank until the developer sends a SCCVW_VIEWFILE message. This message allows the developer to specify a file to be viewed. On some platforms you can specify a bitmap to display when no file is being viewed.
If SCCVW_VIEWFILE returns successfully, the display area will contain the top part of the file specified and scroll bars will be enabled, allowing the user to move around the rest of the file.
Once a file is being viewed, a whole set of messages can be sent by the developer to the view window allowing the developer to print, copy, search, change the look of, and perform a number of other operations on the view.
Eventually, the developer will either close the file (SCCVW_CLOSE) and destroy the view window or make another call to SCCVW_VIEWFILE.
The basic architecture of the Oracle Outside In Viewer is noted below. There are no supported platform distinctions:
|Input Filter||The input filters form the base of the architecture. Each one reads a specific file format or set of related formats and sends the data to the chunker module through a standard set of function calls. There are more than 150 of these filters that read more than 500 distinct file formats. Filters are loaded on demand by the data access module.|
|Chunker||The Chunker module is responsible for caching a certain amount of data from the filter and returning this data as a display engine.
It is also responsible for running the filter to rebuild any data not already in the cache that is requested.
|Display Engine||The Display Engine is responsible for reading data from the chunker and displaying it in the view window. It is also responsible for all user interface, clipboard and printing for a given data type. There are currently six display engines: Document, Spreadsheet/Database, Bitmap, Drawing, Archive and Hex.
Display Engines are loaded on demand by the view window.
|View Window||The View Window controls all of the modules for this product.|
|Developer||Someone integrating this technology into another technology or application. Most likelythis is you, the reader.|
|Source File||The file the developer wishes to view.|
Each Oracle Outside In product has an sdk directory, under which there is a subdirectory for each platform on which the product ships (for example, vw/sdk/vw_win-x86-32_sdk). Under each of these directories are the following three subdirectories:
docs: Contains both a PDF and HTML version of the product manual.
redist: Contains only the files that the customer is allowed to redistribute. These include all the compiled modules, filter support files, .xsd and .dtd files, cmmap000.bin, and third-party libraries, like freetype.
sdk: Contains the other subdirectories that used to be at the root-level of an sdk (common, lib (windows only), resource, samplefiles, and samplecode (previously samples). In addition, one new subdirectory has been added, demo, that holds all of the compiled sample apps and other files that are needed to demo the products. These are files that the customer should not redistribute (.cfg files, exportmaps, etc.).
In the root platform directory (for example, vw/sdk/vw_win-x86-32_sdk), there are two files:
README: Explains the contents of the sdk, and that makedemo must be run in order to use the sample applications.
makedemo (either .bat or .sh – platform-based): This script will either copy (on Windows) or Symlink (on Unix) the contents of …/redist into …/sdk/demo, so that sample applications can then be run out of the demo directory.
The following notice must be included in the documentation, help system, or About box of any software that uses any of Oracle's executable code:
Oracle Outside In Viewer © 1991, 2011 Oracle.
The following notice must be included in the documentation of any software that uses Oracle's TIF6 filter (this filter reads TIFF and JPEG formats):
The software is based in part on the work of the Independent JPEG Group.