info mathgl

3.4 Export to file

These functions export current view to a graphic file. The filename fname should have appropriate extension. Parameter descr gives the short description of the picture. Just now the transparency is supported in PNG and SVG files.

Method on mglGraph (C++, Python): void WriteFrame (const char *fname="", const char *descr="")
C function: void mgl_write_frame (HMGL gr, const char *fname, const char *descr): Exports current frame to a file fname which type is determined by the extension. Parameter descr adds description to file (can be ""). If fname="" then the file ‘frame####.jpg’ is used, where ‘####’ is current frame id and name ‘frame’ is defined by PlotId class property.

Method on mglGraph (C++, Python): void WritePNG (const char *fname, const char *descr="", int compr="", bool alpha=true)
C function: void mgl_write_png (HMGL gr, const char *fname, const char *descr)
C function: void mgl_write_png_solid (HMGL gr, const char *fname, const char *descr): Exports current frame to PNG file. Parameter fname specifies the file name, descr adds description to file, alpha gives the transparency type. By default there are no description added and transparent image used. This function does nothing if NO_PNG is defined during compilation of MathGL library.

Method on mglGraph (C++, Python): void WriteJPEG (const char *fname, const char *descr="")
C function: void mgl_write_jpg (HMGL gr, const char *fname, const char *descr): Exports current frame to JPEG file. Parameter fname specifies the file name, descr adds description to file. By default there is no description added. This function does nothing if NO_JPEG is defined during compilation of MathGL library.

Method on mglGraph (C++, Python): void WriteGIF (const char *fname, const char *descr="")
C function: void mgl_write_gif (HMGL gr, const char *fname, const char *descr): Exports current frame to GIF file. Parameter fname specifies the file name, descr adds description to file. By default there is no description added.

Method on mglGraph (C++, Python): void WriteBMP (const char *fname, const char *descr="")
C function: void mgl_write_bmp (HMGL gr, const char *fname, const char *descr): Exports current frame to BMP file. Parameter fname specifies the file name, descr adds description to file. There is no compression used.

Method on mglGraph (C++, Python): void WriteEPS (const char *fname, const char *descr="")
C function: void mgl_write_eps (HMGL gr, const char *fname, const char *descr): Exports current frame to EPS file. The vector representation is used if possible. So it is not recommended for the export of large data plot. It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file. By default there is no description added. If file name is terminated by ‘z’ (for example, ‘fname.eps.gz’) then file will be compressed in gzip format.

Method on mglGraph (C++, Python): void WriteSVG (const char *fname, const char *descr="")
C function: void mgl_write_svg (HMGL gr, const char *fname, const char *descr): Exports current frame to SVG (Scalable Vector Graphics) file. The vector representation is used. In difference of EPS format, SVG format support transparency that allows to correctly draw half-transparent plot (like SurfA(), Surf3A(), CloudQ() or CloudP()). Note, the output file may be too large for graphic of large data array (especially for surfaces). It is better to use bitmap format (for example PNG or JPEG). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name). If file name is terminated by ‘z’ (for example, ‘fname.svgz’) then file will be compressed in gzip format.

Method on mglGraph (C++, Python): void WriteIDTF (const char *fname, const char *descr="")
C function: void mgl_write_idtf (HMGL gr, const char *fname, const char *descr): Exports current frame to IDTF file. Later this file can be converted to U3D format. The vector representation is used. So, the output file may be too large for graphic of large data array (especially for surfaces). However, program has no internal limitations for size of output file. Parameter fname specifies the file name, descr adds description to file (default is file name).

Method on mglGraph (C++, Python): void ShowImage (const char *viewer="kuickshow", bool nowait=false)
C function: void mgl_show_image (const char *viewer, int nowait): Displays the current picture using external program viewer for viewing. The function save the picture to temporary file and call viewer to display it. If nowait=true then the function return immediately (it will not wait while window will be closed).

Method on mglGraph (C++, Python): void SetSize (int width, int height)
C function: void mgl_set_size (HMGL gr, int width, int height): Sets size of picture in pixels. This function must be called before any other plotting because it completely remove picture contents.

Method on mglGraph (C++, Python): void Flush ()
C function: void mgl_flush (HMGL gr): Flushes the plotting commands to frame. This function may be useful if one wants to remove array before the finishing of the plot (i.e. before calling Finish()). Also call of this function separate the objects in mglGraphIDTF. Most of plots call this function internally.

Method on mglGraph (C++): void Finish (): Finishes plotting and create a picture. Normally this function is called internally.

[ < ]

[ > ]

[ << ]

[ Up ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]