 






           Software
           Product
           Description

           _________________________________________________________

           PRODUCT NAME:  DECimage Application Services          SPD
           25.E8.02                for VMS, Version 3.0

           DESCRIPTION

           DECimage Application Services provides an application pro-
           gramming interface (API) and programming tools for a fam-
           ily of image capture, processing and display services. The
           services are library resident routines (included with VMS
           DECwindows Motif) that include the following sets:

           Image      -  image scanner device drivers, device
           Input         setup, and image data acquisition
           Services

           Image      -  image datatype support, file i/o, image
           Services      processing and manipulation, data encoding
           Library       conversion

           Image      -  device independent image rendition con-
           Display       trol, image display, and X Image Extension
           Services      support

           X Image    -  extension to the X Core protocol for com-
           Exten-        municating image resource request with an
           sions         X Image Server Extension

           DECimage Application Services is language independent and
           intended to enable application developers and systems in-
           tegrators handle bitonal, gray scale (photographic), and RGB
           (red, green, blue) color image data. DECimage Application
           Services offer a consistent interface that conforms to the
           VAX-11 Procedure Calling and Condition Handling Standard and
           MIT C bindings and routine names for source code transporta-
           bility. Examples are provided in BASIC, FORTRAN, and C.

                                    DIGITAL                July 1991

                                                         AE-MI21C-TE

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           DECimage Application Services supports CCITT, Group III (1D
           and 2D) and Group IV (2D) [CCITT Standards T.4 and T.6] rec-
           ommendations for bitonal (facsimile) image data compression
           schemes, and the JPEG R5 Baseline recommended standard for
           continuous tone image data compression. It also supports the
           X Window System standard, DECwindows, Motif and the PostScript
           Language Reference industry standard. It complies with Dig-
           ital's Imaging System Architecture (DISA), Document Inter-
           change Format (DDIF), and Compound Document Architecture (CDA).

           DECimage Application Services features a condition handling
           facility (CHF) to provide error signaling portable between
           VMS and ULTRIX. CHF provides one common interface for both
           VMS and ULTRIX applications and includes messaging support
           services.

           Features

           Image Input Services (IIS)

           o  Device drivers for the MD300, MD400, and MD410 image scan-
              ners.

           o  Assign/deassign local or remote image input device re-
              serving the device for exclusive use and then releasing
              the device. This includes support for remote node access
              and mixed VMS and ULTRIX scanner environments.

           o  et, set, and reset the device attributes.

           o  Read image data synchronously from the device and com-
              bine the data with the image attributes to create and de-
              liver an image frame to the application.

           o  Acquire image data synchronously or asynchronously from
              the device to a specified buffer preallocated by the ap-
              plication.

           o  Cancel asynchronous image data acquisition.


                                       2

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           Image Services Library (ISL)

           o  Frame services

              -  Create/delete image frame in memory

              -  Allocate/free/deallocate/store data plane in buffer

              -  Get/set single image and image frame attributes

           o  Import/export bitmap to/from application buffer

           o  Create/delete region of interest within a frame for pro-
              cessing

           o  Formatting services

              -  Open/close a DDIF file

              -  Create/delete a DDIF stream for reading or writing

              -  Import/export a DDIF frame

              -  Export DDIF page break (hard or soft) into a DDIF stream
                 or file

              -  Export bitonal sixel or PostScript

              -  Compress/decompress bitonal image data using CCITT,
                 Group III (1D and 2D) and Group IV (2D) facsimile com-
                 pression schemes

              -  Compress/decompress grayscale and color image data us-
                 ing JPEG R5 Baseline compression scheme

           o  Domain adjustment

              -  Copy all or a portion of an image into a new image frame

              -  Dither or reduce the bits per pixel

              -  Flip or mirror the image, either horizontally and/or
                 vertically

              -  Rotate the image around the Z axis

              -  Scale or change the dimensions of the image

                                       3

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           o  Image operator services

              -  Combine (16 logical point operations)

              -  Filters for enhancement, edge detection, and noise re-
                 duction

              -  Pixel remapping based on look-up tables or remapping
                 functions provided by the programmer

              -  Tone scale adjustment to enhance contrast

           o  Statistical services

              -  Create/delete histogram of intensities for in-memory
                 image

           o  Image processing primitive services

              -  General purpose convolution engine for filtering func-
                 tions

           Image Display Services (IDS)

           o  Services for display of images on DECwindows workstations,
              DECwindows terminals and supported hardcopy devices

           o  Rendition of bitonal, continuous tone monochrome, and con-
              tinuous tone RGB color images

           o  DECwindows and Motif image widgets with scroll bars to
              render and display an image or portion of an image, and
              to interactively roam through the image

           o  Widget creation routines and tools

           o  Manage sharing of colors and grayscale shades between ap-
              plications

           o  Color sixel output for the LJ250 color printer

           o  Transparent utilization of X Image Server Extension ca-
              pabilities, if available, via X Image Extension proto-
              col

                                       4

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           X Image Extension Client

           o  Session Services - allow clients to initialize and ter-
              minate a session with an X Image Server Extension.

           o  Resource Services - allow clients to create, query, copy,
              and delete one of the following X Image Extensions Server
              resources:

              Photomap-   image objects that contain the image data
                          and closely associated attributes

              IDC     -   image domain context to define the subset
                          or region of an image or process and
                          act as an area operand in area image
                          operations

              Photoflo-   image process context that describes the
                          relationship among the various transfer,
                          enhancement, and rendition processes

           o  Server/Client Image/Export Services - allow clients to
              read and write image data within the X Image Server Ex-
              tension resource from and to core DECwindows X server draw-
              ables.

           o  Transport Services - allow the transfer of image data to
              and from the client and X Image Server Extension in com-
              pressed or uncompressed form.

           o  Process Services - provide form for the application of
              low level image operators and image data, primarily in
              support of preparation for or improvement of a display.

           o  Statistic Services - provide clients with the procedures
              to generate statistical information such as the mean, vari-
              ance, standard deviation, maximum, and minimum about the
              data within an image.

           o  Process Control Services - provide clients with the abil-
              ity to define and apply pipelines containing transport,
              process, and display operations.

                                       5

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           o  Event Services - allow clients to select or query X Im-
              age Server Extension specific events.

           DCL IMAGE is a command line interface to specific functions.
           DCL IMAGE commands include:

           o  IMAGE SCAN (only supports the MD300 Scanner) allows the
              user to create a new revisable form image file (DDIF) by
              feeding a page through a scanner and directing the re-
              sulting image data into the specified image file. It pro-
              vides limited control over these scanner features: bright-
              ness, compression, contrast, mode (line art or halftone)
              and resolution.

           o  IMAGE RENDER converts a DDIF bitonal or continuous tone
              image file into a format suitable for output, display,
              or printing on a specific device. It adjusts the image
              file to match the type, characteristics and presentation
              level protocol of the output device.

           o  IMAGE VIEW permits the user to see a final form bitonal
              or continuous tone image file on a display device which
              supports sixel, DDIF, or X Window System format.

           o  IMAGE ADJUST allows the user to create a new revisable
              form image file from an existing revisable form image file
              (bitonal or continuous tone), allowing three adjustments:
              Crop or extract a piece of the original image; scale (en-
              large or reduce) the original image; and rotate or re-
              orient the original image.

           o  IMAGE CONVERT provides conversion of the Microtek Eye-
              star[TM] bitonal image file format to DDIF format for in-
              clusion in compound documents.







                                       6

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           SOURCE CODE INFORMATION

           Source code examples in VAX C, VAX BASIC, and VAX FORTRAN
           are provided to show the programmer interface to Applica-
           tion Services.

           Language-specific files for definition of structures, flags,
           and constants needed to interface with Application Services
           are provided.

           HARDWARE REQUIREMENTS

           VAX, MicroVAX, VAXserver, or VAXstation configuration as spec-
           ified in the System Support Addendum (SSA 25.E8.02-x).

           SOFTWARE REQUIREMENTS

           o  VMS Operating System

           o  VMS DECwindows Motif

           Refer to the System Support Addendum (SSA 25.E8.02-x) for
           availability and required versions of prerequisite/optional
           software and for information regarding components of VMS DECwin-
           dows.

           ORDERING INFORMATION

           Software Licenses: QL-892A*-**
           Software Media: QA-892AA-H*
           Software Documentation: QA-892AA-GZ
           Software Product Services: QT-892A*-**

           *  Denotes variant fields. For additional information on avail-
              able licenses, services, and media, refer to the appro-
              priate price book.





                                       7

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0

           SOFTWARE LICENSING

           This software is furnished under the licensing provisions
           of Digital Equipment Corporation's Standard Terms and Con-
           ditions. For more information about Digital's licensing terms
           and policies, contact your local Digital office.

           LICENSE MANAGEMENT FACILITY

           This layered product supports the VMS License Management Fa-
           cility. License units for this product are allocated on a
           CPU-capacity basis.

           For more information on the License Management Facility, re-
           fer to the VMS Operating System Software Product Descrip-
           tion (SPD 25.01.xx) or the License Management Facility man-
           ual of the VMS Operating System documentation set.

           For more information about Digital's licensing terms and poli-
           cies, contact your local Digital office.

           SOFTWARE PRODUCT SERVICES

           A variety of service options are available from Digital. For
           more information contact your local Digital office.

           SOFTWARE WARRANTY

           Warranty for this software product is provided by Digital
           with the purchase of a license for the product as defined
           in the Software Warranty Addendum of this SPD.

              PostScript is a registered trademark of Adobe Systems
               Incorporated.

              Microtek is a registered trademark of Microtek Lab,
               Inc.




                                       8

 



           DECimage Application Services               SPD 25.E8.02
           for VMS, Version 3.0


              Motif is a registered trademark of Open Software
               Foundation, Inc.

           [TM]EyeStar is a trademark of Microtek Lab, Inc.

           [TM]The DIGITAL Logo, CDA, CI, DDIF, DECimage, DECnet,
               DECwindows, DDIF, LN03 PLUS MicroVAX, Q-bus, ULTRIX,
               VAX, VAX BASIC, VAX C, VAXft, VAXcluster, VAXserver,
               VAXstation and VMS are trademarks of Digital Equip-
               ment Corporation.






























                                       9
