Date: 2026-03-01T05:25:09+00:00

Actual source code: dclear.c

      1: /*
      2:        Provides the calling sequences for all the basic PetscDraw routines.
      3: */
      4: #include <petsc/private/drawimpl.h>

      6: /*@
      7:   PetscDrawClear - Clears graphical output. All processors must call this routine.
      8:   Does not return until the draw in context is clear.

     10:   Collective

     12:   Input Parameter:
     13: . draw - the drawing context

     15:   Level: intermediate

     17: .seealso: `PetscDrawBOP()`, `PetscDrawEOP()`
     18: @*/
     19: PetscErrorCode PetscDrawClear(PetscDraw draw)
     20: {
     21:   PetscFunctionBegin;
     23:   if (draw->saveonclear) PetscCall(PetscDrawSave(draw));
     24:   PetscTryTypeMethod(draw, clear);
     25:   PetscFunctionReturn(PETSC_SUCCESS);
     26: }

     28: /*@
     29:   PetscDrawBOP - Begins a new page or frame on the selected graphical device.

     31:   Logically Collective

     33:   Input Parameter:
     34: . draw - the drawing context

     36:   Level: advanced

     38: .seealso: `PetscDrawEOP()`, `PetscDrawClear()`
     39: @*/
     40: PetscErrorCode PetscDrawBOP(PetscDraw draw)
     41: {
     42:   PetscFunctionBegin;
     44:   PetscTryTypeMethod(draw, beginpage);
     45:   PetscFunctionReturn(PETSC_SUCCESS);
     46: }
     47: /*@
     48:   PetscDrawEOP - Ends a page or frame on the selected graphical device.

     50:   Logically Collective

     52:   Input Parameter:
     53: . draw - the drawing context

     55:   Level: advanced

     57: .seealso: `PetscDrawBOP()`, `PetscDrawClear()`
     58: @*/
     59: PetscErrorCode PetscDrawEOP(PetscDraw draw)
     60: {
     61:   PetscFunctionBegin;
     63:   PetscTryTypeMethod(draw, endpage);
     64:   PetscFunctionReturn(PETSC_SUCCESS);
     65: }