1 Introduction

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 600 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:

http://www.oracle.com/technetwork/indexes/documentation/index.html#middleware

and click on Outside In Technology.

This chapter includes the following sections:

Section 1.1, "What's New in this Release"
Section 1.2, "What Does the Oracle Outside In Viewer Do?"
Section 1.3, "Architectural Overview"
Section 1.4, "Definition of Terms"
Section 1.5, "Directory Structure"
Section 1.6, "Copyright Information"

1.1 What's New in this Release

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.
Support has been added for AutoCAD 2013.
The LibreOffice 4.0 suite (Impress, Draw, Calc, and Writer) is now supported.
64-bit zip compression is now supported in the zip input filter.
Input filter support for HTML5 and CSS2.1 tags and attributes related to email messages has been added.
Microsoft Visio 2010 is now supported.
From Microsoft Office 2013, Access, OneNote, and Visio are now supported.
From the Apple iWork suite, Pages (iPad) PDF Preview & Text, Numbers (iPad) PDF Preview & Text, and Keynote (iPad) PDF Preview & Text are supported.
From the WordPerfect X6 suite, Word Processor, Quattro Pro, and Presentations are supported.
Support has been added for both win-x86-32/win-x86-64 on Windows 8.1 desktop.
A new message, SCCVW_INFOMESSAGE, is sent during processing when the Viewer is unable to correctly render.
A new option, SCCID_MAINTAINZOOM, instructs the Viewer to maintain its zoom and rotation settings when changing sections within a file.
The new options, SCCID_WPDISPLAYMODE / SCCID_HTMLDISPLAYMODE / SCCID_EMAILDISPLAYMODE and SCCID_WPDISPLAYMODE / SCCID_HTMLDISPLAYMODE / SCCID_EMAILDISPLAYMODE, allow you to customize the display of word processor pages.
A new option, SCCID_STROKE_TEXT, is used to stroke out (display as graphical primitives) text in an AutoCAD file.
A fidelity enhancement has been made adding support for smallcaps and automatic font colors.

1.2 What Does the Oracle Outside In Viewer Do?

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.

Figure 1-1 View Window

Graphic showing view window with blank display

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.

Figure 1-2 View Window in Use

Graphic of an aquarium in the view window

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.

1.3 Architectural Overview

The basic architecture of the Oracle Outside In Viewer is noted below. There are no supported platform distinctions:

Filter/Module	Description
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 600 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.

1.4 Definition of Terms

Term	Definition
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.

1.5 Directory Structure

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:

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.

1.6 Copyright Information

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:

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.