7cf870ef7e45a22b4d08e40307d6212717d4b645
[alexxy/gromacs.git] / include / xdrf.h
1 /*
2  * 
3  *                This source code is part of
4  * 
5  *                 G   R   O   M   A   C   S
6  * 
7  *          GROningen MAchine for Chemical Simulations
8  * 
9  *                        VERSION 3.2.0
10  * Written by David van der Spoel, Erik Lindahl, Berk Hess, and others.
11  * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
12  * Copyright (c) 2001-2004, The GROMACS development team,
13  * check out http://www.gromacs.org for more information.
14
15  * This program is free software; you can redistribute it and/or
16  * modify it under the terms of the GNU General Public License
17  * as published by the Free Software Foundation; either version 2
18  * of the License, or (at your option) any later version.
19  * 
20  * If you want to redistribute modifications, please consider that
21  * scientific software is very special. Version control is crucial -
22  * bugs must be traceable. We will be happy to consider code for
23  * inclusion in the official distribution, but derived work must not
24  * be called official GROMACS. Details are found in the README & COPYING
25  * files - if they are missing, get the official version at www.gromacs.org.
26  * 
27  * To help us fund GROMACS development, we humbly ask that you cite
28  * the papers on the package - you can find them in the top README file.
29  * 
30  * For more info, check our website at http://www.gromacs.org
31  * 
32  * And Hey:
33  * Gromacs Runs On Most of All Computer Systems
34  */
35
36 #ifndef _xdrf_h
37 #define _xdrf_h
38
39
40 #include <stdio.h>
41 #include "visibility.h"
42 #include "typedefs.h"
43
44 #ifdef __PGI    /*Portland group compiler*/
45 #define int64_t long long
46 #endif
47
48 #include "gmx_header_config.h"
49 #if (defined GMX_NATIVE_WINDOWS || defined GMX_CYGWIN || defined GMX_INTERNAL_XDR)
50 #include "gmx_system_xdr.h"
51 #else
52 #include <rpc/rpc.h>
53 #include <rpc/xdr.h>
54 #endif
55
56 #ifdef __cplusplus
57 extern "C" {
58 #endif
59
60
61 /* THESE 3 FUNCTIONS (xdropen, xdrclose and xdr_get_fp) ARE NOW OBSOLETE 
62    AND ONLY PROVIDED FOR BACKWARD COMPATIBILITY OF 3D PARTY TOOLS. 
63    THEY SHOULD NOT BE USED ANYWHERE IN GROMACS ITSELF. 
64 int xdropen(XDR *xdrs, const char *filename, const char *type);
65 int xdrclose(XDR *xdrs);
66 */
67
68 /* the xdr data types; note that there is no data type 'real' because
69    here we deal with the types as they are actually written to disk.  */
70 typedef enum
71 {
72     xdr_datatype_int,
73     xdr_datatype_float,
74     xdr_datatype_double,
75     xdr_datatype_large_int,
76     xdr_datatype_char,
77     xdr_datatype_string
78 } xdr_datatype;
79
80 /* names corresponding to the xdr_datatype enum */
81 GMX_LIBGMX_EXPORT
82 extern const char *xdr_datatype_names[];
83
84 /* Read or write reduced precision *float* coordinates */
85 int xdr3dfcoord(XDR *xdrs, float *fp, int *size, float *precision);
86
87
88 /* Read or write a *real* value (stored as float) */
89 int xdr_real(XDR *xdrs,real *r); 
90
91
92 /* Read or write reduced precision *real* coordinates */
93 int xdr3drcoord(XDR *xdrs,real *fp,int *size,real *precision);
94
95
96 int xdr_gmx_large_int(XDR *xdrs,gmx_large_int_t *i,const char *warn);
97 /* Read or write a gmx_large_int_t value.
98  * 32bit code reading a 64bit gmx_large_int_t value from xdrs could
99  * lead to values out of int range.
100  * When warn!=NULL a warning will be written to stderr
101  * when a value does not fit,
102  * the first line is:
103  * "WARNING during %s:", where warn is printed in %s.
104  */
105
106 int xdr_xtc_seek_time(real time, FILE *fp, XDR *xdrs, int natoms,gmx_bool bSeekForwardOnly);
107
108
109 int xdr_xtc_seek_frame(int frame, FILE *fp, XDR *xdrs, int natoms);
110
111
112 GMX_LIBGMX_EXPORT
113 float xdr_xtc_get_last_frame_time(FILE *fp, XDR *xdrs, int natoms, gmx_bool * bOK);
114
115
116 int xdr_xtc_get_last_frame_number(FILE *fp, XDR *xdrs, int natoms, gmx_bool * bOK);
117
118 #ifdef __cplusplus
119 }
120 #endif
121
122 #endif
123
124