home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / unix / libtiff / lbtif3_3.tar / contrib / vms / readme.vms
Text File  |  1993-01-28  |  3KB  |  87 lines
  1.  
  2. Installation and use of the TIFF library and tools under VMS
  3.  
  4. It is assumed that you  have unpacked the tar  file into a VMS directory
  5. tree, in this text called DISK:[TIFF].
  6.  
  7. Installation:
  8. 1) Move the VMS specific files to their proper directories
  9.     $ SET DEFAULT DISK:[TIFF.CONTRIB.VMS]
  10.     $ RENAME [.LIBTIFF]*.* [-.-.LIBTIFF]
  11.     $ RENAME [.TOOLS]*.* [-.-.TOOLS]
  12. 2) Compile the library
  13.     $ SET DEFAULT DISK:[TIFF.LIBTIFF]
  14.     $ @MAKEVMS
  15. 3) Compile the tools
  16.     $ SET DEFAULT DISK:[TIFF.TOOLS]
  17.     $ @MAKEVMS
  18. 4) Define the programs
  19.     $ DEFINE TIFFSHR DISK:[TIFF.LIBTIFF]TIFFSHR
  20.     $ TIFFCP    :==$DISK:[TIFF.TOOLS]TIFFCP
  21.     $ TIFFCMP   :==$DISK:[TIFF.TOOLS]TIFFCMP
  22.     $ TIFFINFO  :==$DISK:[TIFF.TOOLS]TIFFINFO
  23.     $ TIFFDUMP  :==$DISK:[TIFF.TOOLS]TIFFDUMP
  24.     $ TIFF2PS   :==$DISK:[TIFF.TOOLS]TIFF2PS
  25.     $ TIFFDITHER:==$DISK:[TIFF.TOOLS]TIFFDITHER
  26.     $ TIFF2BW   :==$DISK:[TIFF.TOOLS]TIFF2BW
  27.     $ TIFFMEDIAN:==$DISK:[TIFF.TOOLS]TIFFMEDIAN
  28.     $ TIFFSPLIT :==$DISK:[TIFF.TOOLS]TIFFSPLIT
  29.     $ FAX2TIFF  :==$DISK:[TIFF.TOOLS]FAX2TIFF
  30.     $ GIF2TIFF  :==$DISK:[TIFF.TOOLS]GIF2TIFF
  31.     $ PAL2RGB   :==$DISK:[TIFF.TOOLS]PAL2RGB
  32.     $ PPM2TIFF  :==$DISK:[TIFF.TOOLS]PPM2TIFF
  33.     $ RAS2TIFF  :==$DISK:[TIFF.TOOLS]RAS2TIFF
  34. You will want to add these lines  to your LOGIN.COM file, after changing
  35. the name of the directory that you have used on your machine.
  36.  
  37.  
  38. Compiling your own program
  39.  
  40. When compiling a source file in which you "#include <tiffio.h>", use the
  41. following command
  42.     $ CC/INCLUDE=DISK:[TIFF.LIBTIFF]
  43. This  ensures  that the  header  file is  found.
  44.  
  45.  
  46. Linking your own program to the TIFF library
  47.  
  48. You can  link to  a  library in  two ways:  Either  using the  shareable
  49. library,  or   using the   object  library.  This  gives  the  following
  50. possibilities
  51.  
  52. 1) Using the shareable TIFF library
  53.     $ LINK MY_PROGRAM,SYS$INPUT:/OPTIONS
  54.         DISK:[TIFF.LIBTIFF]TIFF/OPTIONS
  55.         SYS$SHARE:VAXCRTL/SHAREABLE
  56.  
  57. 2) Using the TIFF object library and shareable C run time library
  58.     $ LINK MY_PROGRAM,DISK:[TIFF.LIBTIFF]TIFF/LIBRARY,SYS$INPUT:/OPTIONS
  59.         SYS$SHARE:VAXCRTL/SHAREABLE
  60.  
  61. 3) Using the TIFF object library and object C run time library
  62.     $ LINK MY_PROGRAM,DISK:[TIFF.LIBTIFF]TIFF/LIBRARY,-
  63.         SYS$LIBRARY:VAXCRTL/LIBRARY
  64.  
  65. (You may think of a fourth possibility, but that is not possible)
  66.  
  67. Method 1  uses the shortest  link time  and smallest  .EXE files, but it
  68. requires    that   TIFFSHR  is   defined  as  above  at  link   time and
  69. *at*run*time*.  Using  the  compilation  procedure above,  the tools are
  70. linked in this way.
  71.  
  72. Method 2 gives somewhat longer link time and larger .EXE files, but does
  73. not require  TIFFSHR to be  defined. This  method is  recommended if you
  74. want to run your  program on another machine,  and for some reason don't
  75. want to have the library on that  machine. If you plan to have more than
  76. one program (including the tools)  on the machine, it is rcommended that
  77. you copy the library to the other machine and use method 1.
  78.  
  79. Method 3 gives even longer link times and .EXE files, it not recommended
  80. unless  you  are  going to  use  your  program on  a  machine  without a
  81. shareable C library.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.