summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPatrick Lu <ptlu@hawkwind.ncsa.uiuc.edu>1999-11-19 17:06:55 (GMT)
committerPatrick Lu <ptlu@hawkwind.ncsa.uiuc.edu>1999-11-19 17:06:55 (GMT)
commitffa778636fa99f599f520b51e1696482537ddcb2 (patch)
treedc7e0b65878910a3f79879c0cba06483ba643914
parentde40a00325d0e80b268cee042057e228746f0eea (diff)
downloadhdf5-ffa778636fa99f599f520b51e1696482537ddcb2.zip
hdf5-ffa778636fa99f599f520b51e1696482537ddcb2.tar.gz
hdf5-ffa778636fa99f599f520b51e1696482537ddcb2.tar.bz2
[svn-r1843] added a section that gives more detailed descriptions on using the library
and the dll in VC
-rw-r--r--INSTALL_Windows.txt60
1 files changed, 54 insertions, 6 deletions
diff --git a/INSTALL_Windows.txt b/INSTALL_Windows.txt
index 8a35060..ea00d44 100644
--- a/INSTALL_Windows.txt
+++ b/INSTALL_Windows.txt
@@ -6,6 +6,12 @@ code release 'zip' file (hdf5-1_2_0.zip).
The following sections discuss in detail installation procedures.
+ Section 1: Building from Source Code Release
+ Section 2: Building an application using the HDF5 library or DLL
+ Section 3: Some more helpful pointers
+ Section 4: ZLIB library - removing or changing the path
+
+Section 1:
Building from Source Code Release (hdf5-1_2_0.zip)
===============================================
@@ -238,10 +244,9 @@ STEP IV: BUILDING THE EXAMPLES
-STEP V:
-
-BUILDING AN APPLICATION USING THE HDF5 LIBRARY - SOME HELPFUL POINTERS
-=====================================================================
+Section 2:
+BUILDING AN APPLICATION USING THE HDF5 LIBRARY OR DLL- SOME HELPFUL POINTERS
+============================================================================
If you are building an application that uses the HDF5 library
the following locations will need to be specified for locating
@@ -253,7 +258,50 @@ where <top-level HDF5 directory> may be
C:\MyHDFstuff\hdf5\
-
+To specify this location in the settings for your VC++ project:
+
+ 1. Open your VC project in Microsoft Visual C++ and make sure it is the
+ active project.
+ 2. Go to the Project menu and chose the 'Settings' option.
+ 3. Chose the build configuration you would like to modify in the drop down
+ menu labeled with 'Settings For:'
+ 4. Chose the C/C++ tab
+ 5. At the bottom of the window, there should be a text-area labeled with
+ 'Project Options:'. In this text-area, scroll until you reach the end
+ and type /I "<top-level HDF5 directory>\src" and then click OK.
+
+To link the HDF5 library with your application:
+
+ 1. Open your VC project in Microsoft Visual C++ and make sure it is the
+ active project.
+ 2. Go to the Project menu and chose the 'Add to Project' option and then
+ 'Files' option.
+ 3. Change the 'Files of type:' to 'Library Files (.lib)'
+ 4. Navigate through the directories until you find the location of the
+ hdf5.lib.
+ 5. Select hdf5.lib and click OK.
+
+
+To use the DLL:
+
+ 1. Follow the steps for specifing the location of the header files as shown
+ above.
+ 2. Follow the steps for linking the HDF5 library as shown above except now
+ link the export library that is created with the DLL. The export library
+ is called hdf5dll.lib.
+ 3. Place the DLL in a location that Windows will be able to locate it.
+ The search path and order for DLL's is
+ a) The directory where the executable module for the current process is
+ located.
+ b) The current directory.
+ c} The Windows system directory. The GetSystemDirectory function
+ retrieves the path of this directory.
+ d) The Windows directory. The GetWindowsDirectory function retrieves the
+ path of this directory.
+ e) The directories listed in the PATH environment variable.
+
+
+Section 3:
MORE HELPFUL POINTERS
=====================
@@ -295,7 +343,7 @@ Settings... details:
Single-Threaded
-
+Section 4:
ZLIB LIBRARY- REMOVING OR CHANGING THE PATH
============================================