Actual source code: drawreg.c
petsc-3.7.3 2016-08-01
2: /*
3: Provides the registration process for PETSc PetscDraw routines
4: */
5: #include <petsc/private/drawimpl.h> /*I "petscdraw.h" I*/
6: #include <petscviewer.h> /*I "petscviewer.h" I*/
7: #if defined(PETSC_HAVE_SAWS)
8: #include <petscviewersaws.h>
9: #endif
11: /*
12: Contains the list of registered PetscDraw routines
13: */
14: PetscFunctionList PetscDrawList = 0;
18: /*@C
19: PetscDrawView - Prints the PetscDraw data structure.
21: Collective on PetscDraw
23: Input Parameters:
24: + indraw - the PetscDraw context
25: - viewer - visualization context
27: See PetscDrawSetFromOptions() for options database keys
29: Note:
30: The available visualization contexts include
31: + PETSC_VIEWER_STDOUT_SELF - standard output (default)
32: - PETSC_VIEWER_STDOUT_WORLD - synchronized standard
33: output where only the first processor opens
34: the file. All other processors send their
35: data to the first processor to print.
37: The user can open an alternative visualization context with
38: PetscViewerASCIIOpen() - output to a specified file.
40: Level: beginner
42: .keywords: PetscDraw, view
44: .seealso: PCView(), PetscViewerASCIIOpen()
45: @*/
46: PetscErrorCode PetscDrawView(PetscDraw indraw,PetscViewer viewer)
47: {
49: PetscBool isdraw;
50: #if defined(PETSC_HAVE_SAWS)
51: PetscBool issaws;
52: #endif
56: if (!viewer) {
57: PetscViewerASCIIGetStdout(PetscObjectComm((PetscObject)indraw),&viewer);
58: }
62: PetscObjectPrintClassNamePrefixType((PetscObject)indraw,viewer);
63: PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERDRAW,&isdraw);
64: #if defined(PETSC_HAVE_SAWS)
65: PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERSAWS,&issaws);
66: #endif
67: if (isdraw) {
68: PetscDraw draw;
69: char str[36];
70: PetscReal x,y,bottom,h;
72: PetscViewerDrawGetDraw(viewer,0,&draw);
73: PetscDrawGetCurrentPoint(draw,&x,&y);
74: PetscStrcpy(str,"PetscDraw: ");
75: PetscStrcat(str,((PetscObject)indraw)->type_name);
76: PetscDrawStringBoxed(draw,x,y,PETSC_DRAW_RED,PETSC_DRAW_BLACK,str,NULL,&h);
77: bottom = y - h;
78: PetscDrawPushCurrentPoint(draw,x,bottom);
79: #if defined(PETSC_HAVE_SAWS)
80: } else if (issaws) {
81: PetscMPIInt rank;
83: PetscObjectName((PetscObject)indraw);
84: MPI_Comm_rank(PETSC_COMM_WORLD,&rank);
85: if (!((PetscObject)indraw)->amsmem && !rank) {
86: PetscObjectViewSAWs((PetscObject)indraw,viewer);
87: }
88: #endif
89: } else if (indraw->ops->view) {
90: (*indraw->ops->view)(indraw,viewer);
91: }
92: return(0);
93: }
97: /*@C
98: PetscDrawCreate - Creates a graphics context.
100: Collective on MPI_Comm
102: Input Parameter:
103: + comm - MPI communicator
104: . display - X display when using X windows
105: . title - optional title added to top of window
106: . x,y - coordinates of lower left corner of window or PETSC_DECIDE
107: - w, h - width and height of window or PETSC_DECIDE or PETSC_DRAW_HALF_SIZE, PETSC_DRAW_FULL_SIZE,
108: or PETSC_DRAW_THIRD_SIZE or PETSC_DRAW_QUARTER_SIZE
110: Output Parameter:
111: . draw - location to put the PetscDraw context
113: Level: beginner
115: Concepts: graphics^creating context
116: Concepts: drawing^creating context
118: .seealso: PetscDrawSetFromOptions(), PetscDrawDestroy(), PetscDrawSetType()
119: @*/
120: PetscErrorCode PetscDrawCreate(MPI_Comm comm,const char display[],const char title[],int x,int y,int w,int h,PetscDraw *indraw)
121: {
122: PetscDraw draw;
124: PetscReal dpause = 0.0;
125: PetscBool flag;
128: PetscDrawInitializePackage();
129: *indraw = 0;
130: PetscHeaderCreate(draw,PETSC_DRAW_CLASSID,"Draw","Graphics","Draw",comm,PetscDrawDestroy,PetscDrawView);
132: draw->data = NULL;
133: PetscStrallocpy(display,&draw->display);
134: PetscStrallocpy(title,&draw->title);
135: draw->x = x;
136: draw->y = y;
137: draw->w = w;
138: draw->h = h;
139: draw->pause = 0.0;
140: draw->coor_xl = 0.0;
141: draw->coor_xr = 1.0;
142: draw->coor_yl = 0.0;
143: draw->coor_yr = 1.0;
144: draw->port_xl = 0.0;
145: draw->port_xr = 1.0;
146: draw->port_yl = 0.0;
147: draw->port_yr = 1.0;
148: draw->popup = NULL;
150: PetscOptionsGetReal(NULL,NULL,"-draw_pause",&dpause,&flag);
151: if (flag) draw->pause = dpause;
153: draw->savefilename = NULL;
154: draw->saveimageext = NULL;
155: draw->savemovieext = NULL;
156: draw->savefilecount = 0;
157: draw->savesinglefile = PETSC_FALSE;
158: draw->savemoviefps = PETSC_DECIDE;
160: PetscDrawSetCurrentPoint(draw,.5,.9);
162: draw->boundbox_xl = .5;
163: draw->boundbox_xr = .5;
164: draw->boundbox_yl = .9;
165: draw->boundbox_yr = .9;
167: *indraw = draw;
168: return(0);
169: }
173: /*@C
174: PetscDrawSetType - Builds graphics object for a particular implementation
176: Collective on PetscDraw
178: Input Parameter:
179: + draw - the graphics context
180: - type - for example, PETSC_DRAW_X
182: Options Database Command:
183: . -draw_type <type> - Sets the type; use -help for a list of available methods (for instance, x)
185: See PetscDrawSetFromOptions for additional options database keys
187: Level: intermediate
189: Notes:
190: See "petsc/include/petscdraw.h" for available methods (for instance,
191: PETSC_DRAW_X)
193: Concepts: drawing^X windows
194: Concepts: X windows^graphics
195: Concepts: drawing^Microsoft Windows
197: .seealso: PetscDrawSetFromOptions(), PetscDrawCreate(), PetscDrawDestroy()
198: @*/
199: PetscErrorCode PetscDrawSetType(PetscDraw draw,PetscDrawType type)
200: {
201: PetscErrorCode ierr,(*r)(PetscDraw);
202: PetscBool match;
203: PetscBool flg=PETSC_FALSE;
209: PetscObjectTypeCompare((PetscObject)draw,type,&match);
210: if (match) return(0);
212: /* User requests no graphics */
213: PetscOptionsHasName(((PetscObject)draw)->options,NULL,"-nox",&flg);
215: /*
216: This is not ideal, but it allows codes to continue to run if X graphics
217: was requested but is not installed on this machine. Mostly this is for
218: testing.
219: */
220: #if !defined(PETSC_HAVE_X)
221: if (!flg) {
222: PetscStrcmp(type,PETSC_DRAW_X,&match);
223: if (match) {
224: PetscBool dontwarn = PETSC_TRUE;
225: flg = PETSC_TRUE;
226: PetscOptionsHasName(NULL,NULL,"-nox_warning",&dontwarn);
227: if (!dontwarn) (*PetscErrorPrintf)("PETSc installed without X windows on this machine\nproceeding without graphics\n");
228: }
229: }
230: #endif
231: if (flg) type = PETSC_DRAW_NULL;
233: PetscFunctionListFind(PetscDrawList,type,&r);
234: if (!r) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_UNKNOWN_TYPE,"Unknown PetscDraw type given: %s",type);
235: if (draw->ops->destroy) {(*draw->ops->destroy)(draw);}
236: PetscMemzero(draw->ops,sizeof(struct _PetscDrawOps));
237: PetscObjectChangeTypeName((PetscObject)draw,type);
238: (*r)(draw);
239: return(0);
240: }
244: /*@C
245: PetscDrawGetType - Gets the PetscDraw type as a string from the PetscDraw object.
247: Not Collective
249: Input Parameter:
250: . draw - Krylov context
252: Output Parameters:
253: . name - name of PetscDraw method
255: Level: advanced
257: @*/
258: PetscErrorCode PetscDrawGetType(PetscDraw draw,PetscDrawType *type)
259: {
263: *type = ((PetscObject)draw)->type_name;
264: return(0);
265: }
269: /*@C
270: PetscDrawRegister - Adds a method to the graphics package.
272: Not Collective
274: Input Parameters:
275: + name_solver - name of a new user-defined graphics class
276: - routine_create - routine to create method context
278: Level: developer
280: Notes:
281: PetscDrawRegister() may be called multiple times to add several user-defined graphics classes
283: Sample usage:
284: .vb
285: PetscDrawRegister("my_draw_type", MyDrawCreate);
286: .ve
288: Then, your specific graphics package can be chosen with the procedural interface via
289: $ PetscDrawSetType(ksp,"my_draw_type")
290: or at runtime via the option
291: $ -draw_type my_draw_type
293: Concepts: graphics^registering new draw classes
294: Concepts: PetscDraw^registering new draw classes
296: .seealso: PetscDrawRegisterAll(), PetscDrawRegisterDestroy()
297: @*/
298: PetscErrorCode PetscDrawRegister(const char *sname,PetscErrorCode (*function)(PetscDraw))
299: {
303: PetscFunctionListAdd(&PetscDrawList,sname,function);
304: return(0);
305: }
309: /*@C
310: PetscDrawSetOptionsPrefix - Sets the prefix used for searching for all
311: PetscDraw options in the database.
313: Logically Collective on PetscDraw
315: Input Parameter:
316: + draw - the draw context
317: - prefix - the prefix to prepend to all option names
319: Level: advanced
321: .keywords: PetscDraw, set, options, prefix, database
323: .seealso: PetscDrawSetFromOptions()
324: @*/
325: PetscErrorCode PetscDrawSetOptionsPrefix(PetscDraw draw,const char prefix[])
326: {
331: PetscObjectSetOptionsPrefix((PetscObject)draw,prefix);
332: return(0);
333: }
337: /*@
338: PetscDrawSetFromOptions - Sets the graphics type from the options database.
339: Defaults to a PETSc X windows graphics.
341: Collective on PetscDraw
343: Input Parameter:
344: . draw - the graphics context
346: Options Database Keys:
347: + -nox - do not use X graphics (ignore graphics calls, but run program correctly)
348: . -nox_warning - when X windows support is not installed this prevents the warning message from being printed
349: . -draw_pause <pause amount> -- -1 indicates wait for mouse input, -2 indicates pause when window is to be destroyed
350: . -draw_marker_type - <x,point>
351: . -draw_save [optional filename] - (X windows only) saves each image before it is cleared to a file
352: . -draw_save_final_image [optional filename] - (X windows only) saves the final image displayed in a window
353: . -draw_save_movie - converts image files to a movie at the end of the run. See PetscDrawSetSave()
354: . -draw_save_single_file - saves each new image in the same file, normally each new image is saved in a new file with 'filename/filename_%d.ext'
355: . -draw_save_on_clear - saves an image on each clear, mainly for debugging
356: - -draw_save_on_flush - saves an image on each flush, mainly for debugging
358: Level: intermediate
360: Notes: Must be called after PetscDrawCreate() before the PetscDraw is used.
362: Concepts: drawing^setting options
363: Concepts: graphics^setting options
365: .seealso: PetscDrawCreate(), PetscDrawSetType(), PetscDrawSetSave(), PetscDrawSetSaveFinalImage()
367: @*/
368: PetscErrorCode PetscDrawSetFromOptions(PetscDraw draw)
369: {
370: PetscErrorCode ierr;
371: PetscBool flg,nox;
372: char vtype[256];
373: const char *def;
374: #if !defined(PETSC_USE_WINDOWS_GRAPHICS) && !defined(PETSC_HAVE_X)
375: PetscBool warn;
376: #endif
381: PetscDrawRegisterAll();
383: if (((PetscObject)draw)->type_name) def = ((PetscObject)draw)->type_name;
384: else {
385: PetscOptionsHasName(((PetscObject)draw)->options,NULL,"-nox",&nox);
386: def = PETSC_DRAW_NULL;
387: #if defined(PETSC_USE_WINDOWS_GRAPHICS)
388: if (!nox) def = PETSC_DRAW_WIN32;
389: #elif defined(PETSC_HAVE_X)
390: if (!nox) def = PETSC_DRAW_X;
391: #elif defined(PETSC_HAVE_GLUT)
392: if (!nox) def = PETSC_DRAW_GLUT;
393: #elif defined(PETSC_HAVE_OPENGLES)
394: if (!nox) def = PETSC_DRAW_OPENGLES;
395: #else
396: PetscOptionsHasName(NULL,NULL,"-nox_warning",&warn);
397: if (!nox && !warn) (*PetscErrorPrintf)("PETSc installed without X windows, Microsoft Graphics, OpenGL ES, or GLUT/OpenGL on this machine\nproceeding without graphics\n");
398: #endif
399: }
400: PetscObjectOptionsBegin((PetscObject)draw);
401: PetscOptionsFList("-draw_type","Type of graphical output","PetscDrawSetType",PetscDrawList,def,vtype,256,&flg);
402: if (flg) {
403: PetscDrawSetType(draw,vtype);
404: } else if (!((PetscObject)draw)->type_name) {
405: PetscDrawSetType(draw,def);
406: }
407: PetscOptionsName("-nox","Run without graphics","None",&nox);
408: {
409: char filename[PETSC_MAX_PATH_LEN];
410: char movieext[32];
411: PetscBool image,movie;
412: PetscSNPrintf(filename,sizeof(filename),"%s%s",draw->savefilename?draw->savefilename:"",draw->saveimageext?draw->saveimageext:"");
413: PetscSNPrintf(movieext,sizeof(movieext),"%s",draw->savemovieext?draw->savemovieext:"");
414: PetscOptionsString("-draw_save","Save graphics to image file","PetscDrawSetSave",filename,filename,sizeof(filename),&image);
415: PetscOptionsString("-draw_save_movie","Make a movie from saved images","PetscDrawSetSaveMovie",movieext,movieext,sizeof(movieext),&movie);
416: PetscOptionsInt("-draw_save_movie_fps","Set frames per second in saved movie",__FUNCT__,draw->savemoviefps,&draw->savemoviefps,NULL);
417: PetscOptionsBool("-draw_save_single_file","Each new image replaces previous image in file",__FUNCT__,draw->savesinglefile,&draw->savesinglefile,NULL);
418: if (image) {PetscDrawSetSave(draw,filename);}
419: if (movie) {PetscDrawSetSaveMovie(draw,movieext);}
420: PetscOptionsString("-draw_save_final_image","Save final graphics to image file","PetscDrawSetSaveFinalImage",filename,filename,sizeof(filename),&image);
421: if (image) {PetscDrawSetSaveFinalImage(draw,filename);}
422: PetscOptionsBool("-draw_save_on_clear","Save graphics to file on each clear",__FUNCT__,draw->saveonclear,&draw->saveonclear,NULL);
423: PetscOptionsBool("-draw_save_on_flush","Save graphics to file on each flush",__FUNCT__,draw->saveonflush,&draw->saveonflush,NULL);
424: }
425: PetscOptionsReal("-draw_pause","Amount of time that program pauses after plots","PetscDrawSetPause",draw->pause,&draw->pause,NULL);
426: PetscOptionsEnum("-draw_marker_type","Type of marker to use on plots","PetscDrawSetMarkerType",PetscDrawMarkerTypes,(PetscEnum)draw->markertype,(PetscEnum *)&draw->markertype,NULL);
428: /* process any options handlers added with PetscObjectAddOptionsHandler() */
429: PetscObjectProcessOptionsHandlers(PetscOptionsObject,(PetscObject)draw);
431: PetscDrawViewFromOptions(draw,NULL,"-draw_view");
432: PetscOptionsEnd();
433: return(0);
434: }