PetscViewerDrawOpen#
Opens a PetscDraw window for use as a PetscViewer with type PETSCVIEWERDRAW.
Synopsis#
#include "petscdraw.h" 
#include "petscviewer.h" 
PetscErrorCode PetscViewerDrawOpen(MPI_Comm comm, const char display[], const char title[], int x, int y, int w, int h, PetscViewer *viewer)
Collective
Input Parameters#
- comm - communicator that will share window 
- display - the X display on which to open, or - NULLfor the local machine
- title - the title to put in the title bar, or - NULLfor no title
- x - horizontal screen coordinate of the upper left corner of window, or use - PETSC_DECIDE
- y - vertical screen coordinate of the upper left corner of window, or use - PETSC_DECIDE
- w - window width in pixels, or may use - PETSC_DECIDEor- PETSC_DRAW_FULL_SIZE,- PETSC_DRAW_HALF_SIZE,- PETSC_DRAW_THIRD_SIZE,- PETSC_DRAW_QUARTER_SIZE
- h - window height in pixels, or may use - PETSC_DECIDEor- PETSC_DRAW_FULL_SIZE,- PETSC_DRAW_HALF_SIZE,- PETSC_DRAW_THIRD_SIZE,- PETSC_DRAW_QUARTER_SIZE
Output Parameter#
- viewer - the - PetscViewer
Options Database Keys#
- -draw_type - use x or null 
- -nox - Disables all x-windows output 
- -display - - Specifies name of machine for the X display
- -geometry <x,y,w,h> - allows setting the window location and size 
- -draw_pause - - Sets time (in seconds) that the program pauses after PetscDrawPause() has been called (0 is default, -1 implies until user input).
Notes#
If you want to do graphics in this window, you must call PetscViewerDrawGetDraw() and
perform the graphics on the PetscDraw object.
Format options include:
- PETSC_VIEWER_DRAW_BASIC- displays with basic format
- PETSC_VIEWER_DRAW_LG- displays using a line graph
Fortran Notes#
Whenever indicating null character data in a Fortran code,
PETSC_NULL_CHARACTER must be employed; using NULL is not
correct for character data!  Thus, PETSC_NULL_CHARACTER can be
used for the display and title input parameters.
See Also#
Viewers: Looking at PETSc Objects, PETSCVIEWERDRAW, PetscDrawCreate(), PetscViewerDestroy(), PetscViewerDrawGetDraw(), PetscViewerCreate(), PETSC_VIEWER_DRAW_,
PETSC_VIEWER_DRAW_WORLD, PETSC_VIEWER_DRAW_SELF
Level#
beginner
Location#
Examples#
src/ts/tutorials/ex4.c
src/ts/tutorials/ex5.c
src/snes/tutorials/ex22.c
src/snes/tutorials/ex21.c
src/dm/tutorials/ex2.c
src/ts/tutorials/ex3.c
src/snes/tutorials/ex3.c
src/dm/tutorials/ex1.c
src/snes/tutorials/ex2.c
src/dm/tutorials/ex5.c
Index of all Viewer routines
Table of Contents for all manual pages
Index of all manual pages