xref: /petsc/src/sys/classes/draw/interface/dclear.c (revision dbbe0bcd3f3a8fbab5a45420dc06f8387e5764c6)
15c6c1daeSBarry Smith /*
25c6c1daeSBarry Smith        Provides the calling sequences for all the basic PetscDraw routines.
35c6c1daeSBarry Smith */
4af0996ceSBarry Smith #include <petsc/private/drawimpl.h>  /*I "petscdraw.h" I*/
55c6c1daeSBarry Smith 
65c6c1daeSBarry Smith /*@
75b399a63SLisandro Dalcin    PetscDrawClear - Clears graphical output. All processors must call this routine.
88f69470aSLisandro Dalcin    Does not return until the draw in context is clear.
98f69470aSLisandro Dalcin 
108f69470aSLisandro Dalcin    Collective on PetscDraw
118f69470aSLisandro Dalcin 
128f69470aSLisandro Dalcin    Input Parameters:
138f69470aSLisandro Dalcin .  draw - the drawing context
148f69470aSLisandro Dalcin 
158f69470aSLisandro Dalcin    Level: intermediate
168f69470aSLisandro Dalcin 
178f69470aSLisandro Dalcin @*/
185b399a63SLisandro Dalcin PetscErrorCode  PetscDrawClear(PetscDraw draw)
198f69470aSLisandro Dalcin {
208f69470aSLisandro Dalcin   PetscFunctionBegin;
218f69470aSLisandro Dalcin   PetscValidHeaderSpecific(draw,PETSC_DRAW_CLASSID,1);
229566063dSJacob Faibussowitsch   if (draw->saveonclear) PetscCall(PetscDrawSave(draw));
23*dbbe0bcdSBarry Smith   PetscTryTypeMethod(draw,clear);
248f69470aSLisandro Dalcin   PetscFunctionReturn(0);
258f69470aSLisandro Dalcin }
268f69470aSLisandro Dalcin 
275c6c1daeSBarry Smith /*@
285c6c1daeSBarry Smith    PetscDrawBOP - Begins a new page or frame on the selected graphical device.
295c6c1daeSBarry Smith 
305c6c1daeSBarry Smith    Logically Collective on PetscDraw
315c6c1daeSBarry Smith 
325c6c1daeSBarry Smith    Input Parameter:
335c6c1daeSBarry Smith .  draw - the drawing context
345c6c1daeSBarry Smith 
355c6c1daeSBarry Smith    Level: advanced
365c6c1daeSBarry Smith 
37db781477SPatrick Sanan .seealso: `PetscDrawEOP()`, `PetscDrawClear()`
385c6c1daeSBarry Smith @*/
395c6c1daeSBarry Smith PetscErrorCode  PetscDrawBOP(PetscDraw draw)
405c6c1daeSBarry Smith {
415c6c1daeSBarry Smith   PetscFunctionBegin;
425c6c1daeSBarry Smith   PetscValidHeaderSpecific(draw,PETSC_DRAW_CLASSID,1);
43*dbbe0bcdSBarry Smith   PetscTryTypeMethod(draw,beginpage);
445c6c1daeSBarry Smith   PetscFunctionReturn(0);
455c6c1daeSBarry Smith }
465c6c1daeSBarry Smith /*@
475c6c1daeSBarry Smith    PetscDrawEOP - Ends a page or frame on the selected graphical device.
485c6c1daeSBarry Smith 
495c6c1daeSBarry Smith    Logically Collective on PetscDraw
505c6c1daeSBarry Smith 
515c6c1daeSBarry Smith    Input Parameter:
525c6c1daeSBarry Smith .  draw - the drawing context
535c6c1daeSBarry Smith 
545c6c1daeSBarry Smith    Level: advanced
555c6c1daeSBarry Smith 
56db781477SPatrick Sanan .seealso: `PetscDrawBOP()`, `PetscDrawClear()`
575c6c1daeSBarry Smith @*/
585c6c1daeSBarry Smith PetscErrorCode  PetscDrawEOP(PetscDraw draw)
595c6c1daeSBarry Smith {
605c6c1daeSBarry Smith   PetscFunctionBegin;
615c6c1daeSBarry Smith   PetscValidHeaderSpecific(draw,PETSC_DRAW_CLASSID,1);
62*dbbe0bcdSBarry Smith   PetscTryTypeMethod(draw,endpage);
635c6c1daeSBarry Smith   PetscFunctionReturn(0);
645c6c1daeSBarry Smith }
65