IMAGINE DEVELOPERS TOOLKIT

Transcription

1 IMAGINE DEVELOPERS TOOLKIT The Power Portfoio from Hexagon Geospatia combines the best photogrammetry, remote sensing, GIS and cartography technoogies avaiabe. Fowing seamessy from the desktop to server-based soutions, these technoogies speciaize in data organization, automated geoprocessing, spatia data infrastructure, workfow optimization, web editing, and web mapping. The Producer Suite enabes you to inteigenty author, anayze, process, and map mutipe sources of data. White Paper February 21, 2018

2 CONTENTS Product Overview... 4 Customizing Capabiities... 4 Preferences... 4 Ribbon Customization... 5 EML Script Changes... 6 Extending Capabiities... 6 EML Script Additions... 6 SML Additions... 6 Spatia Modeer Diaogs... 6 Spatia Modeer SDK... 6 Custom Appications... 7 Custom DLLs... 7 Product Definition and Requirements... 7 Probem Soving Exampes... 8 Exampe 1: Create a New Data Importer... 8 Exampe 2: Create a Pug-in for a Unique Sensor Mode... 9 Exampe 3: Enhanced Atmospheric Correction... 9 Exampe 4: Deveop a Photointerpreter Workstation... 9 Key Features Technica Specifications Architecture Routines DLL Casses ERDAS IMAGINE Object Manipuation Routines Appication Environment Routines Low-Leve Fie I / O and System Access Routines Abstract Object Manipuation Routines EML GUI Access Routines February 21,

3 New Capabiities D Visuaization Routines About Hexagon Geospatia February 21,

4 PRODUCT OVERVIEW IMAGINE Deveopers Tookit is a set of ibraries and documentation for ERDAS IMAGINE users who want to modify the commercia version of the software, or deveop entirey new appications to extend the capabiities of the software, to meet their specific project needs. The Tookit incudes a set of C/C++ anguage APIs that are intended for the experienced C/C++ programmer. The IMAGINE Deveopers Tookit is avaiabe through the Hexagon Geospatia Deveoper Network (HGDN) Subscription program. The HGDN community provides an onine, interactive too used to present the most up-to-date documentation and exampes for the Deveopers Tookit API. ERDAS IMAGINE is a broad suite of software products designed to address the needs of a wide audience. Athough the user interface is designed to make workfows easy for a variety of ski and experience eves, some organizations need to customize the software in order to streamine a particuar production workfow. The basic customization capabiities of ERDAS IMAGINE are particuary we suited for modifying the easy-to-use graphica interface, whie the IMAGINE Deveopers Tookit is designed primariy for users needing to taior the software beyond this eve. What type of customization/modifications do you need to make? This is the most important question in determining which ERDAS IMAGINE toos you wi need to use. ERDAS IMAGINE offers two broad categories of customization capabiities, each achievabe with different sets of toos: Customizing Extending Learn about specific types of modifications and new appications that you can deveop using the IMAGINE Deveopers Tookit. CUSTOMIZING CAPABILITIES ERDAS IMAGINE provides a range of customization capabiities from simpe preferences to compete changes to the user interface. These customizations hep organizations that want to change the anguage of the interface, for exampe, or need to simpify it for dedicated appications, such as photo-interpretation. PREFERENCES The simpest and most straightforward means of customizing is provided by the Preference Editor. The Preference Editor manages a database of preference vaues that are used throughout the product to modify its behavior. A preference is a vaue that defines a user s choice for some optiona aspect of the software. For exampe, ERDAS IMAGINE can open bubbe hep whenever the cursor rests on top of a user interface eement for some period of time. By setting preferences, the user may define the ength of time before bubbe hep opens, or choose to never open it. Preferences are saved through the user interface in a oca sense. A oca change affects ony the current user by saving the settings in his/her home directory. A goba change can be affected by moving a customized preference fie to the ERDAS IMAGINE instaation directory, thereby affecting a users (uness overridden by a oca change). The Preference Editor is provided with every ERDAS IMAGINE icense. February 21,

5 RIBBON CUSTOMIZATION Beginning with the reease of ERDAS IMAGINE 2010, the main user interface is presented using the nowstandard Microsoft ribbon stye format. Ribbons themseves offer a high degree of customizabiity through standard capabiities such as Quick Access Toobars and the Customize Ribbon diaog for re-organizing the user interface. February 21,

6 EML SCRIPT CHANGES Many diaogs invoked from the ERDAS IMAGINE ribbon interface were deveoped with the ERDAS Macro Language (EML), which comes with every icense of the software. This anguage is a scripting anguage that can be used to define the structure and content of the user interface, as we as provide some fundamenta procedura scripting capabiities. Each script is interpreted at appication startup and converted to instructions for the native windowing system. These fies are incuded in a virtua scripts directory when the associated appication is buit. Instead of being compied, they are just copied to the IMAGINE_HOME directory for runtime. Each script is an ASCII fie, which may be edited to change its contents. For exampe, the tites of a menus, buttons, and other user contros may be changed to another anguage. In addition, menu items may be added or deeted. In many cases (though not a), commands may be added to or deeted from existing diaogs. EXTENDING CAPABILITIES In addition to customizing the existing appications, some organizations may want to add new capabiities to the software, such as adding to the existing scripts, writing new Spatia Modes, creating new Spatia Mode Operators and embedding Geoprocessing into other appications using the Spatia Modeer SDK (SMSDK), or deveoping entirey new appications using the IMAGINE Deveopers Tookit. EML SCRIPT ADDITIONS Because EML provides a procedura-scripting environment in addition to the user interface definition, it is possibe to create new capabiities by combining existing ERDAS IMAGINE commands under new menu items or new buttons. SML ADDITIONS New appications can be buit using Spatia Modeer Language (SML), which is a component of both IMAGINE Advantage and IMAGINE Professiona icenses. Many toos on the Raster tab in ERDAS IMAGINE (for exampe, Decorreation Stretch) were buit primariy from SML scripts with an EML interface. Once you have deveoped a new agorithm using the graphica Mode Maker environment, you can generate an SML script that can be combined with a custom-deveoped user interface. The new appication may be pugged into the existing ERDAS IMAGINE menu structure so that it functions ike any other part of the system. SPATIAL MODELER DIALOGS A more modern way to extend the user interface with new spatia modes is to use the Spatia Mode Editor to deveop an agorithm using Post Input operators to define required inputs to the mode. These types of modes use the Port Input definitions to auto-generate diaogs, which can be easiy added to the Ribbon interface without the need to use an interface anguage such as EML. SPATIAL MODELER SDK Spatia Modeer SDK (SMSDK) is a C++ tookit for buiding, modifying, and running workfows on geospatia data. SMSDK can be used to buid compex agorithms or simpy to run routine tasks. Based on the Spatia Modeer too initiay deveoped for ERDAS IMAGINE 2013, SMSDK is extensibe via a pugin mechanism where objects, such as operators, data types, and configuration diaogs, are discovered at runtime by demand-oading a DLLs found February 21,

7 in a search path and identifying the Spatia Modeer objects impemented in those DLLs. Buid add-ons to ERDAS IMAGINE or buid and run workfows within your own product (the atter requiring additiona signed agreement with Hexagon Geospatia) using the Spatia Modeer SDK. CUSTOM APPLICATIONS Extending ERDAS IMAGINE goes beyond changing interfaces and adding new image processing appications, and consequenty generay requires the use of the IMAGINE Deveopers Tookit. One of the keys to making the system usefu is the abiity to use any data avaiabe, or to integrate entirey new types of image processing. CUSTOM DLLS A major feature of the ERDAS IMAGINE architecture is the use of DLLs to provide for custom extensions. A DLL is a Dynamicay Loadabe Library, which is a piece of code to be ocated and used at run time by an appication. ERDAS IMAGINE uses this to create pug-in sockets in a variety of areas, such as imagery access, coordinate conversion, coordinate projection, and font access. Without modification to existing appications, a Raster Format DLL may be written and added to the system, which aows a ERDAS IMAGINE appications to access data stored in previousy unsupported fie formats directy and without fie conversion. PRODUCT DEFINITION AND REQUIREMENTS IMAGINE Deveopers Tookit is the coection of ibraries and associated headers and documentation used by the Hexagon Geospatia deveopment staff to create ERDAS IMAGINE products. The ibraries are organized into severa arge functiona groups. emib creation of portabe GUI, interfacing with EML eib non-gui components of appication creation erasterib core functionaity for geospatia imagery The core is the base ibrary, caed erasterib (ERDAS Raster Library), which contains a the core functionaity needed to create / read / write geospatia imagery. Layered on top of this is eib (ERDAS Library), which contains a the non-gui components of appication creation, such as session management, annotation I/O, and various utiity packages. February 21,

8 Layered on top of the eib ibrary is the user interface ibrary, caed emib (ERDAS Macro Language Library), which contains a the functions for creating a portabe GUI and interfacing with EML. Hexagon Geospatia Deveopers Network (HGDN) is an interactive onine network of programmers and deveopers. A content in this environment is shared by HGDN Subscribers and Hexagon Geospatia empoyees, which makes this a true network of programmers. This method for presenting the IMAGINE Deveopers Tookit documentation to every programmer using it ensures that a content in the network is as up-to-date as possibe. There are severa parts to this web environment: 1. The most important feature is the Tookit Library which contains a supported Tookit packages, data types, and functions. A entries are categorized for easy searching and every item is guaranteed to be compete. 2. Deveopers FAQ section is a ist of commony asked questions with answers provided by Hexagon Geospatia empoyees. 3. Each item in the Tookit Library Database is dynamicay inked to every exampe. This means that when seecting a particuar function or data type, a ist of exampe program that contain that item wi be returned. There is aso a categorica search for Visua C/C++, EML, SML, and spatia modes. 4. Each user wi be abe to downoad the compete project from the Exampes Database. There is aso a categorica search in pace to hep when downoading severa exampes at a time. 5. We have deveoped a peer-to-peer coding forum so that customers are abe to ask questions on any deveoper-reated topic. Users of the IMAGINE Deveopers Tookit must be experienced C/C++ programmers. The IMAGINE Deveopers Tookit is avaiabe as part of an HGDN Subscription. PROBLEM SOLVING EXAMPLES EXAMPLE 1: CREATE A NEW DATA IMPORTER With the number and variety of imagery formats aways on the rise, the data importer and exporter is the most common type of appication added to ERDAS IMAGINE. The IMAGINE Deveopers Tookit contains functions that provide I/O for the ERDAS IMAGINE fie format, as we as functions that make it easier to create an importer / exporter that operates ike those that are incuded with ERDAS IMAGINE. An airborne scanner manufacturer might need to make their data easiy accessibe to potentia customers who use ERDAS IMAGINE by providing an importer into an ERDAS IMAGINE compatibe fie format. As the data is read it coud be written to an ERDAS IMAGINE.img fie using the Image I/O functions in eib. The geographic information coud aso be used to create input to ERDAS IMAGINE rectification toos to provide a semi-automated process of geocorrection. February 21,

9 EXAMPLE 2: CREATE A PLUG-IN FOR A UNIQUE SENSOR MODEL Whie deveoping a system for photointerpretation of sateite data, a miitary contractor had a sensor that did not use a geometry simiar to any of the typica frame cameras or push broom sensors, and they wanted to use the imagery without resamping in the ERDAS IMAGINE appication. To sove this probem, they created a pug-in sensor mode for use with ERDAS IMAGINE s geometric modeing. The sensor mode describes the geometry of their sensor (for exampe, it tes how to convert a pixe coordinate row and coumn into a ground coordinate) and how to perform the inverse operation. Impemented as an ERDAS IMAGINE Geometric Mode DLL, ground base coordinates coud be read from the image using ERDAS IMAGINE with this mode, as we as orthocorrect the image using existing ERDAS IMAGINE toos. EXAMPLE 3: ENHANCED ATMOSPHERIC CORRECTION Dr. Rudoph Richter of DLR in Germany is a eading speciaist in the study of atmospheric correction. His agorithms, known as ATCOR, have been widey used to remove the effects of the atmosphere from sateite images. The ERDAS IMAGINE distributor in Germany, GEOSYSTEMS GmbH, coaborated with Dr. Richter and used the IMAGINE Deveopers Tookit to create the ATCOR Workfow for IMAGINE modue for use with ERDAS IMAGINE. Instaed add-on modues in ERDAS IMAGINE are indicated by a new icon object in a tab in the ribbon. When aunched, ATCOR Workfow for IMAGINE opens various toos for fine-tuning the atmospheric mode before correction takes pace, then dispays the output in ERDAS IMAGINE. More recenty the SMSDK has been used to convert the ATCOR capabiities into operators for use in arger workfows buit using the Spatia Mode Editor. EXAMPLE 4: DEVELOP A PHOTOINTERPRETER WORKSTATION One of the eariest appications of the IMAGINE Deveopers Tookit was the deveopment of the Target Materias Workstation, or TMWS. TMWS was deveoped to provide an easy-to-use workstation for miitary photointerpreters. The interpreter s task is to ook at an image, mark up any important features, and then print the resuts. They must be abe to sharpen, contrast stretch, and perhaps rotate and scae the image. Then text, ines, and other wedefined graphics are paced on the image using annotation toos. This marked-up image is then inserted into one of severa standard map tempates and printed for dissemination. In addition, there is usuay some centra contro of tasking. TMWS was made by customizing ERDAS IMAGINE. The menus and too paettes were simpified and taiored for the task at hand. In addition, specia top-eve icons were created to ead the operator through the process. Coordination of the workfow and data management was achieved by working with an aready existing centra SAP (formery Sybase) database. This was done by using SAP (formery Sybase) ibraries in conjunction with the IMAGINE Deveopers Tookit to create a modue that coud obtain information about the images to be anayzed, and then record the name and ocation of the fina products. February 21,

10 KEY FEATURES ERDAS IMAGINE object manipuation routines Appication environment routines Low-eve fie I/O and system access routines Abstract object manipuation routines Unicode storage casses EML GUI access routines extensive context-sensitive onine Hep Peer-to-peer forum avaiabe through the Hexagon Geospatia Deveopers Network Exampe programs IMAGINE Photogrammetry bock fie creation routines 2D visuaization routines TECHNICAL SPECIFICATIONS ARCHITECTURE ROUTINES IMAGINE Deveopers Tookit is organized as various packages that create and support a type of data object. The package usuay defines a few data types, which are then manipuated by the functions. These packages are described beow in groups of routines. DLL CLASSES Some of the packages are buit on a DLL mechanism that aows that package to be extended dynamicay. For exampe, the eimg routines for reading and writing imagery from fies are based on the Raster Formats DLL Cass. Any appication written using the eimg package wi be abe to read data from any of the supported fie formats. The packages based upon an extensibe DLL are indicated by the name of the DLL cass in brackets, for exampe [Raster Formats DLL]. February 21,

11 ERDAS IMAGINE OBJECT MANIPULATION ROUTINES Package Library Description Annotation eant Provides functions for creating, reading, writing, rendering, and editing ERDAS IMAGINE annotation eements and their styes. Annotation eements consist of poyines, poygons, eipses, eiptica arcs, points, text, and groups. Area of Interest eaoi Provides basic toos for area of interest anaysis. It incudes AOI structure operations (create, deete, copy, so forth), AOI input and output operations, and AOI rendering operations. Coor Library ecb Provides support for coor ibraries, RGB / IHS conversions, and eve sicing. Unit Conversion ecvt Provides routines for converting between units of distance, area, time, voume, ange, and so forth. The units supported are defined in a database (units.dat), which defines the reation between a standard unit and others. For exampe, the standard distance is in meters, a other distance units are defined as mutipes of meters. Descriptor Tabe Access Digita Signa Processing edsc edsp Provides basic toos for manipuating descriptor tabes. A descriptor tabe is the part of an ERDAS IMAGINE.img fie that stores anciary information about a particuar data vaue or set of data vaues in a raster ayer. The information for each data vaue, or set of data vaues, might incude a histogram vaue, coor tabe ook-up vaues, a cass name, tota area, and so forth. With the edsc functions, the programmer can easiy create in-memory data structures for descriptor tabes and easiy pass descriptor tabe information between memory and disk without having to dea with the ower eve ehfa, emif, and efio packages. Using the functions, the programmer can: Create, open, and cose a descriptor tabe Create, copy, and deete a bin function the part of the descriptor tabe that describes how data vaues in the raster ayer are mapped to rows in the descriptor tabe Create, open, read, write, and cose a descriptor tabe coumn the anciary information Provides functions that perform 1- and 2-dimensiona forward and inverse Fast Fourier Transformations (FFTs) on compex or rea data. Most functions in this routine have been speciay designed for efficient transformation of rea vaued sequences and arrays. These sequences have certain symmetries that reduce both storage requirements and the number of computations. The ength of each sequence must be a power of two. Graphics Support eevg Provides functions for rendering vector-type data (annotation, vectors) to output devices. It handes the rendering of ine styes, poygon fi styes, and smooth outine scaabe text. Foating-Point Graphics Arithmetic efga Provides routines for performing commony used vector, matrix, point, and poynomia (incuding affine) transformation functions. Fie Node Parse efnp Breaks up strings containing fie names and ehfa node names and ranges of ehfa node names into their component parts. For exampe, use it to separate the path D:/data/cherokee-hickory-fats.img(:Layer_1) into the components: D:/data/ February 21,

12 Genera Data Arithmetic egda cherokee-hickory-fats.img (:Layer_1) Provides basic toos to perform operations on various data objects based on the Egda_BaseData structure. Objects based on this data structure are prevaent in the IMAGINE Deveopers Tookit ibraries such as the eimg_pixerect. The derivatives of this data structure incude ayer, stack, matrix, tabe, vector, window, and scaar objects. In addition to providing functions that create, copy, modify, and destroy these data types, the routines aso hande operations such as data type conversion, standard point functions (for exampe, sin, cos, so forth), GIS point functions (for exampe, diversity or density), singe argument operations (for exampe, not or sign), mutipe argument operations (for exampe, mutipy or divide), and neighborhood functions (for exampe, majority or convove). Bock Fie Creation epho Supports the easy creation of IMAGINE Photogrammetry bock structures. It is most ikey to be used by appications that import other data formats into the bock fie format. The bock structure stores a the information that is associated with a bock of images. Some this data is created and maintained by the IMAGINE Photogrammetry ibraries and some of the data is created and maintained by the BockModeInterfaces DLLs. Feature Space efsp Contains a the feature space functions, incuding: Read and write of feature space nodes as chidren in.img fies Read and write ists of feature space nodes for communication with the transformation process Convert the image data into feature space pots Map auxiiary fies (thematic) into the feature space Hierarchica Fie Access Histogram and Lookup Tabe ehfa ehst Provides an impementation of the ERDAS IMAGINE EHFA fie format. This format maintains an object-oriented representation of data in a disk fie by using a tree structure. A non-ascii fies used by ERDAS IMAGINE are in this format (for exampe,.img,.ovr). Using the functions in this routine, the programmer can identify, create, copy, open and cose EHFA fies; and ocate, read, and write objects within an EHFA fie. The standard ERDAS IMAGINE data objects (ayers, map information, descriptor tabes, and so forth) can be accessed through higher eve packages (eimg, edsc, and so forth), so these functions are normay used to manipuate appication-specific data objects within EHFA fies. Provides various functions on histograms and ookup tabes, primariy in support of the histogram toos and the contrast adjustment in the Viewer. Histogram, LUT, and breakpoint structures can be created, converted, and edited using these routines. Image Fie Access eimg Provides toos to access and manipuate data in image fies supported by the RasterFormats DLL Cass, incuding ERDAS IMAGINE.img fies. The package incudes functions to read and write objects commony found in geospatia raster datasets such as map information, projection parameters, statistics, histograms, covariance matrices, descriptor tabes, cass names, and coor vaues. February 21,

13 Image Resamping [ResampeMethods DLL] eirf The package aso provides high-eve functions for processing the raster data within the dataset incuding functions to create, read, and write raster ayers; associate windows, and areas of interest with a raster ayer; and appy neighborhood functions to raster ayers. An appication may modify the actua data vaues in a raster ayer using this package and its constructs. Provides toos to resampe imagery that is being geometricay transformed (see Transform). Three resamping methods are supported: Nearest neighbor Biinear interpoation Cubic convoution Other types of resamping can be supported through the ResampeMethods DLL Cass mechanism. Kerne Library ekb Provides for reading and writing convoution fiter kernes from a kerne ibrary fie. Map Printing emap Provides routines for generating and reading map fies (.map) and for creating, reading, and writing a types of fies associated with hardcopy map output. Pixe Management epxm Provides functions for creating and copying rectanguar arrays of pixes of any of the thirteen data types supported by ERDAS IMAGINE. The pixe rectanges are compatibe with the egda functions. Raster GIS Anaysis Seed / Region Growing Signature Management erga esed esig esig_io Provides toos to anayze raster data incuding toos for point anaysis, neighborhood anaysis, regiona anaysis, and feature extraction. This high-eve package operates on top of the eimg package, unike the egda, efga, and eirf packages that are not stricty dependent on any eimg constructs. Performs the region growing functions. Functions exist at different eves to do the raster region grow, convert the raster region to a poygon, and generate an annotation ayer of the region poygon. Signature packages contain a the signature support functions: esig provides functions to create signatures, set and get signature attributes, copy signatures, manage ists of signatures, merge signatures, and so forth. esig_io contains a the fie I/O functions for signatures and signature ists. Statistics esta Provides toos for: Manipuating (that is, reading and writing to/from fies, creating and copying inmemory data structures, computing, and so forth) statistics (mean, standard deviation, and so forth) Histograms Covariance matrices Coor tabes Cass names This midde eve package is utiized by the eimg package but reies on the edsc, ehfa, and emif packages. Vector evec Provides toos for: Creating and deeting structures reated to vector ayers Opening and cosing vector ayers Reading features and their attributes Getting descriptive information about the ayer Measuring distances and engths Modifying vertices of arcs (spining, generaizing, and densifying) February 21,

14 Transform [GeometricModes DLL] exfr Determining the spatia reationship between points, ines, and poygons Provides a generaized set of toos for creating and managing coordinate transforms, regardess of the type. Each transform may be a combination of any number of the basic transforms. The package provides functions for mapping arrays of points through a transform, inverting transforms, and composing transforms. The package is aso constructed so that the programmer can create new types of transforms. This package is extensibe through the use of the Geometric Mode DLLs. APPLICATION ENVIRONMENT ROUTINES Package Library Description Argument Parsing earg Provides a convenient means of creating appications that are controed by command ine options. Parsing the command ine and ooking for options is a tedious task and without a set of standard toos, the resuting command ine syntax wi vary from program to program. Error Logging and Reporting eerr Provides functions to create, deete, and print error reports. Neary every function in the ibraries of the IMAGINE Deveopers Tookit requires an argument that represents a pace for the function to pass back an error report to the caing function. Using the functions and macros defined in this package, the programmer can work within the error reporting system of the IMAGINE Deveopers Tookit. Master Initiaization eint Initiaize the IMAGINE Deveopers Tookit. This step is required in an appication before the other IMAGINE Deveopers Tookit functions can be used. Progress Meter Support Magnetic Tape Access Preference Database emet emta epmg An ERDAS IMAGINE appication can report its progress in an extensibe way. A user can track the progress of an appication by pacing cas to the emet package at critica points in a process. Provides a cient-side API to the ERDAS IMAGINE tape server. Using the API to the tape server, an appication can open, cose, and manipuate (for exampe, rewind, skip fies) tape devices, as we as read and write data to those devices. The type of device (8 mm, track, and so forth) and its ocation on the network (oca, remote) are transparent to the API, and therefore, the appication. Provides a programmer with an interface to the Preference Database. Provides functions to access, set, and change the preferences for different categories at goba and user eves. Aso provides caback mechanisms to notify the cients when a preference vaue is changed. Session Manager esmg Provides an interface to the ERDAS IMAGINE Session Manager. Primary functions are: Connect to the Session Manager Indicate job state February 21,

15 Indicate job progress Log warning/status messages in the Session Log Indicate the end of a job Viewer evue Contains a set of functions for interacting with the ERDAS IMAGINE Viewer. Using the functions, the appication can: Query the contents of specified viewers Load image, annotation, vector, or AOI ayers into specified viewers Add cabacks on images in the viewer Create graphics representing ines or areas at specified ocations Interactivey seect areas or ines Dispay map compositions Set image extents Create and destroy viewers Warp images Create screen inks Set convoution kernes LOW-LEVEL FILE I / O AND SYSTEM ACCESS ROUTINES Package Library Description Low Leve Fie efio Provides functions for creating, reading, writing, ocating, and finding information about fies and directories. Many of these functions are simpy wrappers for existing POSIX and ANSI C functions. The wrapper aows for expansion of environment variabes in fie names and directory paths, as we as the transation of the standard errno variabe into an error report consistent with the eerr package. Other functions aow temporary fie names to be generated and for a directory path to be searched whie attempting to ocate a particuar fie. The package aso aows efficient I/O that is portabe across patforms. Machine Independent Format emif Aows data to be read and written to disk in a format that is sharabe across compiers, operating systems, and machine architectures. Using the package, a programmer can create and destroy dictionaries of object designs, create and destroy object designs in those data dictionaries, and read and write data to disk based on an object design. Standard ERDAS IMAGINE data objects (ayers, map information, descriptor tabes, and so forth) can be accessed through higher-eve packages (eimg, edsc, and so forth), so these functions are normay used to manipuate appication-specific data objects within EHFA fies. Timer etim Provides routines for timing code execution. ABSTRACT OBJECT MANIPULATION ROUTINES Package Library Description Binary Search Tree ebst Provides a compete set of toos for creating and maintaining sorted binary search trees. Modeed after the qsort/bsearch functions in the standard C ibraries, the ebst package works February 21,

16 Dynamic List Manager edm with any type of programmer-suppied data for which the programmer provides a compare function. Provides a means to create and retrieve data from ists and stacks of arbitrary size. The ists, or stacks, may contain any type of object. Lists and stacks are usefu in situations in which you need to buid a set of data by sequentiay adding objects, but you do not know beforehand how many objects wi be in the set. Linked List em Provides a common set of functions used to create and manage inked ists. The ists may contain any type of data. Misceaneous emsc Defines macros and functions that dea with memory management or are otherwise not specific to any one routine in the IMAGINE Deveopers Tookit, for exampe, EMSC_MIN, EMSC_MAX, EMSC_CURRENT_VER. Seection ese Provides a set of functions for impementing queries based on a simpe query anguage. A query is then converted to an interna form, which is then used by the query evauator. The resut of the query is stored in a bitmapped tabe of Booean resuts. There is a compete set of functions for managing the resuting Booean tabes. String Manipuation estr Provides functions for 6 categories of character string manipuation: Genera string manipuation (compare, change, dupicate, anayze character strings) Fie name string parsing String ist manipuation String expression evauation Numeric formatting to a character string Misceaneous string functions (for exampe, converting errno to a string description of the error) Symbo Tabe esym Provides a set of functions used to create and manage symbo tabes. Each hods one or more symbos that reate a string with some type of user data. The package provides functions for adding symbos to the tabe and for ocating symbos within a given tabe. EML GUI ACCESS ROUTINES Package Library Description EML eem Provides a programmer with an interface to a the ERDAS Macro Language (EML) API functions. Appication programs that present a GUI through an EML script shoud use the functions in this package. Functions incude: Create a GUI for the appication program using the EML scripts as tempates Dispay and undispay the diaog frames defined in the EML script Add and remove caback functions on the GUI parts defined in the EML script Manipuate GUI objects (get vaues, set vaues, and so forth) Button eem_button Provides functions specific to the EML button part. Functions incude: Get and set coors for coor buttons Arm and disarm and togge buttons Canvas eem_canvas Provides a system independent interface to on-screen and off-screen graphics February 21,

17 primitives. Many of the primitives are specificay designed to work with the structures from the eimg package, making it easier to read ERDAS IMAGINE fies and dispay the data to the screen. These primitives can be used to buid graphic appications such as the ERDAS IMAGINE Viewer. Using this package in conjunction with the rest of the EML package resuts in an appication that is easiy ported between the various operating systems and window systems that ERDAS IMAGINE supports. Diaog eem_diaog Contains functions that provide consistent interaction with the user for common userinterface operations such as asking the user for confirmation, dispaying a warning message, dispaying a status message. Frame eem_frame Provides functions specific to EML diaog frames. Functions incude: Set and get geometry to and from dispayed and undispayed frames Dispay the frame on a different screen (dua-headed systems) Set the tite string, dispay the status message, show/hide the menu bar, show/hide the status bar, and so forth, access frame menus, and so forth. Generic Part eem_generic Provides functions specific to the EML generic part. The generic part is designed as a space hoder in an EML diaog. It typicay reserves space in the diaog for a user interface part that cannot be specified in EML, such as a CeArray or a canvas. Aspects of the user interface that cannot be handed in EML must be handed programmaticay. Through the eem_generic portion of the eem package, functions are made avaiabe to the programmer that provide a consistent and portabe way to dispay a busy cursor over a generic part whie that part is being updated. Menu eem_menu Provides the functions to create and interact with popup and pu-down menu systems. Popup List eem_popupist Provides functions specific to the EML popup ist part. Functions incude: Repace the od ist with a new ist Repace the od picture ist with a new picture ist Projection Editor eem_prjeditor Provides a function to contro an interactive Projection Editor that can be used by appication programs to get projection parameters from the user. Scroed List eem_scroist Contains functions specific to the EML scro ist part. The functions aow appication programs to manipuate the EML scro ist, for exampe, add items, repace items, and so forth. Tabet Digitizer eem_tabet Provides functions to access the Tabet Digitizer driver via an interactive GUI. Functions incude: Open and connect to the tabet digitizer Add cabacks on the digitizer Cose and disconnect from the tabet digitizer Text eem_text Contains functions specific to the EML text part. Functions aow appication programs to: Insert text Overwrite, repace, append text Turn on, turn off the highight attribute of the text Get and set the cursor position on the text Cut, copy, paste text Set, get, cear the primary seection on the text February 21,

18 CeArray eeui_ca Provides a singe user interface for deaing with the management of tabuar data. The programmer provides the description of the coumns (string, doube, coor, and so forth) and provides the functions to get and put the data. The CeArray package manages the navigation and dispay of any amount of data. Buit-in functions aow search, sorting, and report generation. Chart eem_chart Provides a graphica part that can be used to pot data in severa modes. The chart is a too that can pot tabuar data as ine graphs on a grid with an associated egend. This is the basis of the various profie toos in ERDAS IMAGINE. Coorwhee eeui_cw Provides an HSI coor part that can be used for coor seection. A sider contros the intensity, with hue and saturation mapped to the ange around a circe and the distance from its center. To seect coors, the user can drag a singe point within the coor whee. The appication is notified of coor changes through a caback mechanism. Histogram eeui_histogram Provides an interactive too for dispaying and manipuating histogram data. The user may zoom in to get more detai on any area of the histogram. In addition, the routine provides functions for controing the contents of the pot as we as printing the histogram to a PostScript fie. NEW CAPABILITIES 2D VISUALIZATION ROUTINES Package Library Description Viewer edis Provides a basic set of toos for embedding one or more viewers into an ERDAS IMAGINE appication. A viewer can dispay various types of 2D data incuding vectors, annotation, and images. These routines aso provide a means of extending the types of data that can be dispayed within the viewer via the ViewLayer cass. ViewWindow Edis_ViewWindow Manages the dispay area of the viewer. When a viewer is created, a hande to the Edis_ViewWindow is returned and can be used with subsequent cas to the Edis_ViewWindow API. Use this API for togging scro bars, adding ViewLayers, scroing imagery, and so forth. ViewLayer Edis_Viewayer Manipuating ViewLayer objects within a ViewWindow. Use for cosing ViewLayers, changing band combinations, setting zoom eves, and so forth. This API can be used with existing ViewLayer types such as the TrueCoor, PseudoCoor, GrayScae, Annotation, Vector, and AOI ayers. ViewLayer cass Edis_ViewLayer Defines the mechanism used for creating new types of ViewLayers that can be dispayed within a ViewWindow. This becomes necessary when the ViewLayer February 21,

19 types that are provided with the tookit do not provide features required by the appication. Graphics Context Graphics Target Both API provide ViewLayers the mechanism needed to render them into the ViewWindow. When impementing new ViewLayer types using the Edis_ViewLayer cass it is necessary to use these functions. Graphics Context is provided for setting attributes such as coor, size, and so forth. Graphics Target is provided for doing the actua drawing. Seector Edis_SeNew Provides an interface for creating graphica representations of objects that are used by the user for editing eements. The seectors do not provide a very robust set of dispay styes because they are typicay used for dispaying fast graphica eements incuding poyines, poygons, points, icons, and rectanges. Seector cass Picks Provides a mechanism for new seector types to be created when the existing seectors do not provide the features required by the appication. Provides toos used when the user is responsibe for creating an eement interactivey using the mouse. Picks have been used for creating annotation eements, AOI eements, seecting viewers, and so forth. The API returns the coordinates seected by the user to the caer. Raster Edit Provides a few routines for modifying properties of raster images incuding contrast and convoutions kernes. These functions can aso be used for modifying the pixe vaues in a TrueCoor or GrayScae image ayer. ABOUT HEXAGON GEOSPATIAL Hexagon Geospatia heps you make sense of the dynamicay changing word. Known gobay as a maker of eading-edge technoogy, we enabe our customers to easiy transform their data into actionabe information, shortening the ifecyce from the moment of change to action. Hexagon Geospatia provides the software products and patforms to a arge variety of customers through direct saes, channe partners, and Hexagon businesses. For more information, visit hexagongeospatia.com or contact us at marketing@hexagongeospatia.com. Geospatia is part of Hexagon, a eading goba provider of information technoogies that drive productivity and quaity across geospatia and industria enterprise appications. Hexagon s soutions integrate sensors, software, domain knowedge and customer workfows into inteigent information ecosystems that deiver actionabe information. They are used in a broad range of vita industries. Hexagon (Nasdaq Stockhom: HEXA B) has more than 18,000 empoyees in 50 countries and net saes of approximatey 3.3bn USD. Learn more at hexagon.com and foow 2018 Hexagon AB and/or its subsidiaries and affiiates. A rights reserved. Hexagon and the Hexagon ogo are registered trademarks of Hexagon AB or its subsidiaries. A other trademarks or service marks used herein are property of their respective owners. Hexagon Geospatia beieves the information in this pubication is accurate as of its pubication date. Such information is subject to change without notice. February 21,