xref: /petsc/include/petscviewer.h (revision 5a5d4f665b3034485fbcdfbe42345f740a4bd170)
1 /* $Id: viewer.h,v 1.47 1997/10/10 04:08:45 bsmith Exp bsmith $ */
2 /*
3      Viewers are objects where other objects can be looked at or stored.
4 */
5 
6 #if !defined(__VIEWER_PACKAGE)
7 #define __VIEWER_PACKAGE
8 
9 typedef struct _p_Viewer*            Viewer;
10 
11 /*
12     petsc.h must be included AFTER the definition of Viewer for ADIC to
13    process correctly.
14 */
15 #include "petsc.h"
16 
17 #define VIEWER_COOKIE              PETSC_COOKIE+1
18 typedef enum { MATLAB_VIEWER,ASCII_FILE_VIEWER, ASCII_FILES_VIEWER,
19                BINARY_FILE_VIEWER, STRING_VIEWER, DRAW_VIEWER} ViewerType;
20 
21 extern int ViewerFileOpenASCII(MPI_Comm,char*,Viewer *);
22 typedef enum { BINARY_RDONLY, BINARY_WRONLY, BINARY_CREATE} ViewerBinaryType;
23 extern int ViewerFileOpenBinary(MPI_Comm,char*,ViewerBinaryType,Viewer *);
24 extern int ViewerMatlabOpen(MPI_Comm,char*,int,Viewer *);
25 extern int ViewerStringOpen(MPI_Comm,char *,int, Viewer *);
26 extern int ViewerDrawOpenX(MPI_Comm,char *,char *,int,int,int,int,Viewer*);
27 extern int ViewerDrawOpenVRML(MPI_Comm,char *,char *,Viewer*);
28 extern int ViewerDrawClear(Viewer);
29 
30 extern int ViewerGetType(Viewer,ViewerType*);
31 extern int ViewerDestroy(Viewer);
32 
33 extern int ViewerASCIIGetPointer(Viewer,FILE**);
34 extern int ViewerBinaryGetDescriptor(Viewer,int*);
35 extern int ViewerBinaryGetInfoPointer(Viewer,FILE **);
36 
37 #define VIEWER_FORMAT_ASCII_DEFAULT       0
38 #define VIEWER_FORMAT_ASCII_MATLAB        1
39 #define VIEWER_FORMAT_ASCII_IMPL          2
40 #define VIEWER_FORMAT_ASCII_INFO          3
41 #define VIEWER_FORMAT_ASCII_INFO_LONG     4
42 #define VIEWER_FORMAT_ASCII_COMMON        5
43 #define VIEWER_FORMAT_ASCII_SYMMODU       6
44 #define VIEWER_FORMAT_BINARY_DEFAULT      0
45 #define VIEWER_FORMAT_BINARY_NATIVE       1
46 #define VIEWER_FORMAT_DRAW_BASIC          0
47 #define VIEWER_FORMAT_DRAW_LG             1
48 #define VIEWER_FORMAT_DRAW_CONTOUR        2
49 
50 extern int    ViewerSetFormat(Viewer,int,char *);
51 extern int    ViewerPushFormat(Viewer,int,char *);
52 extern int    ViewerPopFormat(Viewer);
53 extern int    ViewerGetFormat(Viewer,int*);
54 
55 extern int    ViewerFlush(Viewer);
56 extern int    ViewerStringSPrintf(Viewer,char *,...);
57 
58 extern Viewer VIEWER_STDOUT_SELF;
59 extern Viewer VIEWER_STDERR_SELF;
60 extern Viewer VIEWER_STDOUT_WORLD;
61 extern Viewer VIEWER_STDOUT_(MPI_Comm);
62 extern int    VIEWER_STDOUT_Destroy(MPI_Comm);
63 extern Viewer VIEWER_STDERR_WORLD;
64 extern Viewer VIEWER_STDERR_(MPI_Comm);
65 extern int    VIEWER_STDERR_Destroy(MPI_Comm);
66 extern Viewer VIEWER_DRAWX_WORLD_PRIVATE_0;
67 extern Viewer VIEWER_DRAWX_WORLD_PRIVATE_1;
68 extern Viewer VIEWER_DRAWX_WORLD_PRIVATE_2;
69 extern Viewer VIEWER_DRAWX_SELF_PRIVATE;
70 extern Viewer VIEWER_MATLAB_WORLD_PRIVATE;
71 extern Viewer VIEWER_MATLAB_SELF_PRIVATE;  /* not yet used */
72 
73 extern int    ViewerInitializeDrawXWorld_Private_0();
74 extern int    ViewerInitializeDrawXWorld_Private_1();
75 extern int    ViewerInitializeDrawXWorld_Private_2();
76 extern int    ViewerInitializeDrawXSelf_Private();
77 extern int    ViewerInitializeMatlabWorld_Private();
78 extern Viewer VIEWER_DRAWX_(MPI_Comm);
79 extern int    VIEWER_DRAWX_Destroy(MPI_Comm);
80 
81 #define VIEWER_DRAWX_WORLD_0 \
82               (ViewerInitializeDrawXWorld_Private_0(),VIEWER_DRAWX_WORLD_PRIVATE_0)
83 #define VIEWER_DRAWX_WORLD_1 \
84               (ViewerInitializeDrawXWorld_Private_1(),VIEWER_DRAWX_WORLD_PRIVATE_1)
85 #define VIEWER_DRAWX_WORLD_2 \
86               (ViewerInitializeDrawXWorld_Private_2(),VIEWER_DRAWX_WORLD_PRIVATE_2)
87 
88 #define VIEWER_DRAWX_SELF \
89               (ViewerInitializeDrawXSelf_Private(),VIEWER_DRAWX_SELF_PRIVATE)
90 #define VIEWER_DRAWX_WORLD VIEWER_DRAWX_WORLD_0
91 #define VIEWER_MATLAB_WORLD \
92         (ViewerInitializeMatlabWorld_Private(),VIEWER_MATLAB_WORLD_PRIVATE)
93 
94 extern int ViewersDrawOpenX(MPI_Comm,char *,char **,int,int,int,Viewer**);
95 extern int ViewersDestroy(int,Viewer *);
96 
97 #endif
98