About This Manual
What You Need to Know
Manual Organization
Notation
Typographic Conventions
Naming Conventions
A Note on Examples
Further Reading
Introducing Rogue Wave Views Foundation
Application Programming Interface (API)
Libraries
Class Hierarchy
Using Rogue Wave Views
Windows and Views
What is a View?
Looking at a View Window
Containers: Controlling the View
Introducing Graphic Objects
Displaying Graphic Objects
Interactors
Drawing Attributes and Palettes
Color
Line Style and Width
Patterns
Font
Basic Drawing Types
Lines
Regions
Strings
Graphic Objects
IlvGraphic: The Graphic Objects Class
Member Functions
Callbacks
The IlvSimpleGraphic Class
Member Functions
Graphic Attributes
Predefined Graphic Objects
IlvArc
IlvFilledArc
IlvEllipse
IlvFilledEllipse
IlvIcon
IlvZoomableIcon
IlvTransparentIcon
IlvZoomableTransparentIcon
IlvLabel
IlvFilledLabel
IlvListLabel
IlvZoomableLabel
IlvLine
IlvArrowLine
IlvReliefLine
IlvMarker
IlvZoomableMarker
IlvPolyPoints
IlvPolySelection
IlvPolyline
IlvArrowPolyline
IlvPolygon
IlvOutlinePolygon
IlvRectangle
IlvFilledRectangle
IlvRoundRectangle
IlvFilledRoundRectangle
IlvShadowRectangle
IlvShadowLabel
IlvGridRectangle
IlvReliefRectangle
IlvReliefLabel
IlvReliefDiamond
IlvSpline
IlvClosedSpline
IlvFilledSpline
Composite Graphic Objects
Filling Polygons: IlvGraphicPath
Grouping Objects: IlvGraphicSet
Referencing Objects: IlvGraphicHandle
Other Base Classes
IlvGauge
IlvScale
IlvGadget
IlvGroupGraphic
IlvMapxx
Creating a New Graphic Object Class
The Example: ShadowEllipse
Basic Steps to Subtype a Graphic Object
Redefining IlvGraphic Member Functions
Creating the Header File
Implementing the Object Functions
Updating the Palettes
Saving and Loading the Object Description
Graphic Resources
IlvResource: The Resource Object Base Class
Predefined Graphic Resources
Named Resources
Resource Creation and Destruction: lock and unLock
IlvColor: The Color Class
Color Models
Using the IlvColor Class
Converting between Color Models
Computing Shadow Colors
IlvLineStyle: The Line Style Class
New Line Styles
IlvPattern and IlvColorPattern: The Pattern Classes
Monochrome Patterns
Colored Patterns
IlvGradientPattern: The Pattern Class Dedicated to Gradients
The IlvLinearGradientGeometry class
The IlvRadialGradientGeometry class
The IlvGradientGeometry class
Gradient Patterns Sharing
IlvFont: The Font Class
New Fonts
Font Names
IlvCursor: The Cursor Class
Other Drawing Parameters
Line Width
Fill Style
Fill Rule
Arc Mode
Draw Mode
Alpha Value
Anti-Aliasing Mode
IlvPalette: Drawing Using a Group of Resources
Locking and Unlocking Resources
Clipping Area
Creating a Non-shared Palette
Creating a Shared Palette
Naming Palettes
IlvQuantizer: The Image Color Quantization Class
Graphic Formats
Graphic Formats Supported
Bitmaps
IlvBitmap: The Bitmap Image Class
Bitmap-Related Member Functions
Bitmap Formats
Loading Bitmaps: Streamers
Loading Transparent Bitmaps
IlvBitmapData: The Portable Bitmap Data Management Class
The IlvBitmapData Class
The IlvIndexedBitmapData Class
The IlvRGBBitmapData Class
The IlvBWBitmapData Class
Image Processing Filters
IlvBitmapFilter: The Image Processing Class
The IlvBlendFilter Class
The IlvColorMatrixFilter Class
The IlvComponentTransferFilter Class
The IlvComposeFilter Class
The IlvConvolutionFilter Class
The IlvDisplaceFilter Class
The IlvFloodFilter Class
The IlvGaussianBlurFilter Class
The IlvImageFilter Class
The IlvLightingFilter Class
The IlvLightSource Class
The IlvMergeFilter Class
The IlvMorphologyFilter Class
The IlvOffsetFilter Class
The IlvTileFilter Class
The IlvTurbulenceFilter Class
The IlvFilterFlow Class
Using IlvFilteredGraphic to Apply Filter Flows to Graphic Objects
The Display System
IlvDisplay: The Display System Class
Connecting to the Display Server
Opening a Connection and Checking the Display
Closing a Connection and Ending a Session
Display System Resources
The getResource Method
How Display System Resources are Stored
Default Display System Resources
Environment Variables and Resource Names
Display System Resources on Windows
Home
The Display Path
Setting the Display Path
The Path Resource
The ILVPATH Environment Variable
Querying or Modifying the Display Path
Example: Add a Directory to the Display Path
Views
View Hierarchies: Two Perspectives
Window-Oriented View Hierarchy
Class-Oriented View Hierarchy
IlvAbstractView: The Base Class
IlvView: The Drawing Class
IlvView Subclasses
The IlvElasticView Class
The IlvDrawingView Class
The IlvContainer Class
The IlvScrollView Class
Drawing Ports
IlvPort: The Drawing Port Class
Derived Classes of IlvPort
The IlvSystemPort Class
The IlvPSDevice Class
Containers
IlvContainer: The Graphic Placeholder Class
General-Purpose Member Functions
Applying Functions to Objects
Tagged Objects
Object Properties
Displaying Containers
Drawing Member Functions
Geometric Transformations
Managing Double Buffering
Reading Objects from Disk
Managing Events: Accelerators
Member Functions
Implementing Accelerators: IlvContainerAccelerator
Predefined Container Accelerators
Managing Events: Object Interactors
Using Object Interactors
Predefined Object Interactors
Example: Linking an Interactor and an Accelerator
Creating Objects with Complex Behavior
Example: Creating a Slider
Associating a Behavior with Your Device
Building and Extending your Device
Dynamic Modules
IlvModule: The Dynamic Module Class
Dynamic Module Code Skeleton
Building a Dynamic Module
Loading a Dynamic Module
Implicit Mode
Explicit Mode
An Example: Dynamic Access
Writing the Sample Module Definition File
Implementing the New Class
Loading and Registration of the Example
Registration Macros
Adding the Sample Class to a Dynamic Module
Events
IlvEvent: The Event Handler Class
Recording and Playing Back Event Sequences: IlvEventPlayer
Functions Handling Event Recording
The IlvTimer Class
External Input Sources (UNIX only)
Idle Procedures
Low-level Event Handling
Main Loop Definition: An Example
IlvNamedProperty: The Persistent Properties Class
Associating Named Properties with Objects
Extension of Named Properties
Example: Creating a Named Property
Printing in Rogue Wave Views
The IlvPrintableDocument Class
Iterators
Example
The IlvPrintable Class
The IlvPrintableLayout Class
The IlvPrinter Class
The IlvPrintUnit Class
The IlvPaperFormat Class
Dialogs
Rogue Wave Script Programming
Rogue Wave Script for Rogue Wave Views
Making Rogue Wave Views Applications Scriptable
Including the Header File
Linking with Rogue Wave Script for Rogue Wave Views Libraries
Binding Rogue Wave Views Objects
Getting the Global Rogue Wave Script Context
Binding Rogue Wave Views Objects
Loading Rogue Wave Script Modules
Inline Scripts
Default Rogue Wave Script Files
Independent Rogue Wave Script Files
Rogue Wave Script Static Functions
Using Rogue Wave Script Callbacks
Writing a Callback
Setting an Rogue Wave Script Callback
Handling Panel Events
The OnLoad Function
The onShow Property
The onHide Property
The onClose Property
Creating Rogue Wave Views Objects at Run Time
Common Properties of Rogue Wave Views Objects
className
name
help
Using Resources in Rogue Wave Script for Rogue Wave Views
Using Resource Names with Rogue Wave Script for Rogue Wave Views
Using Bitmaps with Rogue Wave Script for Rogue Wave Views
Using Fonts with Rogue Wave Script for Rogue Wave Views
Guidelines for Developing Scriptable Applications
Resource Names
Internationalization
What is i18n?
Checklist for Localized Environments
Creating a Program to Run in a Localized Environment
Locale Requirements
Checking Your System’s Locale Requirements
Locale Name Format
Current Default Locale
Changing the Current Default Locale
X Library Support (UNIX only)
Rogue Wave Views Locale Support
Rogue Wave Views Locale Names
Determining Rogue Wave Views Support for the Locale
Required Fonts
Localized Message Database Files in Rogue Wave Views
The IlvMessageDatabase Class
Language of the Message Database Files
Location of the Message Database Files
Determining Parameters of the Message Database Files
Loading the Message Database
.dbm File Format
How to Dynamically Change Your Display Language
Using Rogue Wave Views with Far Eastern Languages
Data Input Requirements
Input Method (IM)
Far Eastern Input Method Servers Tested with Rogue Wave Views
How to Control the Language Used for Data Input
Limitations of Internationalization Features
Troubleshooting
Reference: Encoding Listings
Reference: Supported Locales on Different Platforms
Packaging Rogue Wave Views Applications
Launching ilv2data
The ilv2data Panel
Launching ilv2data with a Batch Command
Adding a Resource File to a UNIX Library
Adding a Resource File to a Windows DLL
Using Rogue Wave Views on Microsoft Windows
Creating a New Rogue Wave Views Application on Microsoft Windows
Incorporating Windows Code into an Rogue Wave Views Application
Integrating Rogue Wave Views Code into a Windows Application
Exiting an Application Running on Microsoft Windows
Windows-specific Devices
Printing
Selecting a Printer
Using GDI+ Features with Rogue Wave Views
What is GDI+
GDI+ and Rogue Wave Views
Controlling GDI+ Features at Run Time
Limitations
Using Multiple Display Monitors with Rogue Wave Views
Using Rogue Wave Views on X Window Systems
Libraries
Using the Xlib Version, libxviews
Using the Motif Version, libmviews
Adding New Sources of Input
Integrating Rogue Wave Views with a Motif Application Using libmviews
Initializing Your Application
Standard Rogue Wave Views Initialization Procedure
Motif Application Initialization Procedure
Retrieving Connection Information
Using an Existing Widget
Running the Main Loop
Sample Program Using Motif and Rogue Wave Views
Integrating Rogue Wave Views with an X Application Using libxviews
Integration Steps
Complete Template
Complete Example with Motif
Using Cairo Features with Rogue Wave Views
Cairo Features in Rogue Wave Views
Controlling Cairo Features at Run Time
Limitations
Portability Limitations
Non-Supported or Limited Features
The Main Event Loop
Error Messages
The IlvError Class
Fatal Errors
Warnings
Rogue Wave Script 2.0 Language Reference
Syntax
Rogue Wave Script Program Syntax
Compound Statements
Comments
Identifier Syntax
Expressions
Rogue Wave Script Expressions
Literals
Variable Reference
Property Access
Assignment Operators
Function Call
Special Keywords
Special Operators
Other Operators
Statements
Conditional Statement
Loops
Variable Declaration
Function Definition
Default Value
Numbers
Number Literal Syntax
Special Numbers
Automatic Conversion to a Number
Number Methods
Numeric Functions
Numeric Constants
Numeric Operators
Strings
String Literal Syntax
Automatic Conversion to a String
String Properties
String Methods
String Functions
String Operators
Booleans
Boolean Literal Syntax
Automatic Conversion to a Boolean
Boolean methods
Logical Operators
Arrays
Rogue Wave Script Arrays
Array Constructor
Array Properties
Array Methods
Objects
Rogue Wave Script Objects
Defining Methods
The this Keyword
Object Constructor
User-defined Constructors
Built-in Methods
Dates
Rogue Wave Script Date Values
Date Constructor
Date Methods
Date Functions
Date Operators
The null Value
The Rogue Wave Script null Value
Methods of null
The undefined Value
The Rogue Wave Script undefined Value
Methods of undefined
Functions
Rogue Wave Script Functions
Function Methods
Miscellaneous
About This Manual
Miscellaneous