DragonFly On-Line Manual Pages

Search: Section:  

MPE_CaptureFile(4)                    MPE                   MPE_CaptureFile(4)


NAME

       MPE_CaptureFile -  Sets the base filename used to capture output from
       updates


SYNOPSIS

       #include "mpe.h"
       int MPE_CaptureFile( handle, fname, freq )
       MPE_XGraph handle;
       char       *fname;
       int        freq;


INPUT PARAMETERS

       handle - MPE graphics handle
       fname  - base file name (see below)
       freq   - Frequency of updates


RETURN VALUES

       MPE_ERR_LOW_MEM
              - malloc for copy of the filename (fname) failed
       MPE_ERR_BAD_ARGS
              - 'handle' parameter is bad
       MPE_SUCCESS
              - success


NOTES

       The output is written in xwd format to 'fname%d', where '%d' is the
       number of the file (starting from zero).


NOTES FOR FORTRAN INTERFACE

       The Fortran interface to this routine is different from its C
       counterpart and it has an additional argument, ierr, at the end of the
       argument list, i.e. the returned function value (the error code) in C
       interface is returned as the additional argument in Fortran interface.
       The Fortran interface is invoked with the CALL statement.

       All MPI and MPE objects, MPI_Comm, MPE_XGraph and MPE_Color, are of
       type INTEGER in Fortran.


ADDITIONAL NOTES FOR FORTRAN INTERFACE

       The trailing blanks in Fortran 'CHARACTER' string argument will be
       ignored.


LOCATION


                                   4/2/2012                 MPE_CaptureFile(4)

Search: Section: