<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN"> <HTML> <HEAD> <META NAME="GENERATOR" CONTENT="DOCTEXT"> <TITLE>MPE_CaptureFile</TITLE> </HEAD> <BODY BGCOLOR="FFFFFF"> <A NAME="MPE_CaptureFile"><H1>MPE_CaptureFile</H1></A> Sets the base filename used to capture output from updates <H2>Synopsis</H2> <PRE> #include "mpe.h" int MPE_CaptureFile( handle, fname, freq ) MPE_XGraph handle; char *fname; int freq; </PRE> <H2>Input Parameters</H2> <DL> <DT><B>handle </B><DD>MPE graphics handle <DT><B>fname </B><DD>base file name (see below) <DT><B>freq </B><DD>Frequency of updates </DL> <P> <H2>Return Values</H2> <DL> <DT><B>MPE_ERR_LOW_MEM </B><DD>malloc for copy of the filename (fname) failed <DT><B>MPE_ERR_BAD_ARGS </B><DD>'handle' parameter is bad <DT><B>MPE_SUCCESS </B><DD>success </DL> <P> <H2>Notes</H2> The output is written in xwd format to 'fname%d', where '%d' is the number of the file (starting from zero). <P> <P> <H2>Notes For Fortran Interface </H2> 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. <P> All MPI and MPE objects, MPI_Comm, MPE_XGraph and MPE_Color, are of type INTEGER in Fortran. <P> <H2>Additional Notes for Fortran Interface </H2> The trailing blanks in Fortran 'CHARACTER' string argument will be ignored. <P><B>Location:</B>../src/graphics/src/mpe_graphics.c<P> </BODY></HTML>