home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / utility / gsview13 / src / gvcspecs.doc < prev    next >
Text File  |  1995-12-09  |  6KB  |  149 lines
  1. INCOMPLETE DRAFT      27 Oct 1994
  2.  
  3. Specifications for GSview.
  4.  
  5. Platform:
  6.  - Three variants exist.  Variants will run under
  7.    - OS/2 2.0, 2.1, 2.11
  8.    - MS-DOS or DRDOS with MS-Windows 3.0 or 3.1.
  9.    - MS-DOS or DRDOS with MS-Windows 3.1 and Win32s, or Windows NT 3.5.
  10.  
  11. Prerequisites:
  12.  - Ghostscript 3.0
  13.  - Later than Ghostscript 3.12 for Windows NT.
  14.  - 386 or higher processor for OS/2 or Win32s.  286 otherwise.
  15.  - 250k bytes disk space per GSview variant.
  16.  - 6M bytes free disk space for GSview, Ghostscript and 
  17.    Ghostscript fonts.
  18.  
  19. Overview:
  20.  - PostScript is a page description language created by Adobe Systems
  21.    and commonly used by laser printers.
  22.  - Using PostScript comments, the Adobe Document Structuring 
  23.    Conventions (DSC) specify page structure and resource 
  24.    requirements for PostScript files.
  25.  - Ghostscript is an interpreter written by Aladdin Enterprises 
  26.    for the PostScript language.
  27.  - Ghostscript processes an entire PostScript file starting from 
  28.    the beginning, ignoring the DSC comments.  By itself, 
  29.    Ghostscript displays all pages of a PostScript file.
  30.  - GSview is a graphical interface for Ghostscript.
  31.  - GSview processes DSC comments and skips over PostScript code.
  32.  - When GSview and Ghostscript are used together on DSC conformant 
  33.    documents, selected pages can be viewed, printed or extracted.
  34.  
  35. Input:
  36.  - PostScript files that conform to DSC version 1, 2, or 3.
  37.  - PostScript files that do not claim to conform to the DSC.
  38.  - PostScript files must not change the page size by direct 
  39.    access to statusdict.
  40.  
  41. Output:
  42.  - A preview in a display window of selected pages of a 
  43.    PostScript file.
  44.  - Printer output of selected pages of a PostScript file.
  45.  - A PostScript file containing selected pages from the original 
  46.    file.
  47.  
  48. General:
  49.  - GSview reads PostScript files and scans the DSC comments.  
  50.    These comments are used to identify the start and end of the 
  51.    header, pages and the trailer.  Using this information 
  52.    GSview sends individual pages to Ghostscript to be 
  53.    rendered.
  54.  - Context sensitive help is provided.  Implementation is through 
  55.    the system help facility.
  56.  - Commands are given to GSview using pull down menus or a 
  57.    button bar.
  58.  - Pages can be viewed in arbitrary order.
  59.  - Display Resolution can be set to a numerical dpi value, or 
  60.    changed by a factor of 1.2 or 1/1.2 using the button bar.
  61.  - The display window can be swapped with a zoomed image.
  62.  - Display depth (number of colours) can be set in bits/pixel.
  63.  - Page size is set automatically from the DSC comments and can 
  64.    be set manually.
  65.  - Orientation is set automatically from the DSC comments and can 
  66.    be set manually.
  67.  - A selected page can be displayed using Ghostscript.
  68.  - Selected pages can be printed with Ghostscript.
  69.  - Selected pages can be extracted to another file.
  70.  - A displayed page can be copied to the system clipboard as a 
  71.    bitmap.
  72.  - A bitmap in the system clipboard can be written to a BMP file.
  73.  - A preview can be added to a PostScript EPS file in one of the 
  74.    following formats: Interchange, TIFF4, TIFF5 or (MS-Windows 
  75.    only) Windows Metafile.
  76.  - The %%BoundingBox of an EPS file can be changed graphically.
  77.  - The header line of a single page DSC file can be changed to 
  78.    EPS.
  79.  - An EPS header can be written for a non-DSC file.  The user 
  80.    must verify that the contents is compatible with EPS.
  81.  - A DOS EPS file can be created from an EPS file.
  82.  - PostScript and bitmap preview sections can be extracted from a 
  83.    DOS EPS file.
  84.  - Text can be partially extracted from a PostScript file.
  85.  - Limited text searches can be made of PostScript files.
  86.    
  87. Distribution:
  88.  - GSview is distributed in a ZIP file named gsview??.exe where 
  89.    ?? depends on the version number.
  90.  - The ZIP file can by unpacked using the InfoZip unzip program 
  91.    version 5.
  92.  - Sources to GSview are provided in the SRC subdirectory within 
  93.    the ZIP file.
  94.  - The ZIP file is available using anonymous ftp to 
  95.    ftp.cs.wisc.edu:pub/ghost/rjl/gsview??.zip
  96.  
  97.  
  98. Compilation:
  99.  - To compile PM GSview you need IBM NMAKE.EXE and EMX/GCC 
  100.    0.8h with emxfix05.  To create the PM GSview online help 
  101.    you need the IBM toolkit.  The makefile is gvpm.mak.
  102.  - To compile GSview for Windows you need Borland C++ 3.1 or 
  103.    4.0. The makefile is gsview.mak.
  104.  - To compile GSview for Windows 32 you need Borland C++ 4.0. 
  105.    The makefile is gsview.mak.
  106.  
  107. Limitations:
  108.  - PostScript programs that change the page size by directly 
  109.    accessing statusdict will prevent GSview from displaying in 
  110.    any orientation other than Portrait and will prevent the
  111.    zoom feature from working correctly..
  112.  
  113. DSC Comments:
  114.  - GSview understands the following DSC comments
  115.    %%PS-Adobe-1.0
  116.    %%PS-Adobe-2.0
  117.    %%PS-Adobe-2.1
  118.    %%PS-Adobe-3.0
  119.    %%PS-Adobe-x.x EPSF-x.x
  120.      %%BoundingBox: int int int int
  121.      %%Pages: int | (atend)
  122.      %%Title: text
  123.      %%CreationDate: text
  124.      %%PageOrder: Ascend | Descend | Special | (atend)
  125.      %%Orientation: Portrait | Landscape | (atend)
  126.      %%PaperSize: text | (atend)
  127.      %%DocumentMedia: text real real anything
  128.      %%+    (only when applied to %%DocumentMedia)
  129.    %%EndComments
  130.    %%BeginPreview
  131.    %%EndPreview
  132.    %%BeginDefaults
  133.      %%PageMedia
  134.    %%EndDefaults
  135.    %%BeginSetup
  136.    %%EndSetup
  137.    %%Page: text int
  138.    %%Trailer
  139.      %%BoundingBox: int int int int
  140.      %%Pages: int
  141.      %%PageOrder: Ascend | Descend | Special
  142.      %%Orientation: Portrait | Landscape
  143.      %%PaperSize: text
  144.      %%DocumentMedia: text real real anything
  145.      %%+    (only when applied to %%DocumentMedia)
  146.    %%EOF
  147.  
  148.  
  149.