8.1 Create and delete objects

There are several group of functions.

• Functions for non-visual “grapher” creation:

  C function: HMGL mgl_create_graph_gl ()

  Create the instance of class mglGraphGL.

  C function: HMGL mgl_create_graph_zb (int width, int height)

  Create the instance of class mglGraphZB with specified sizes.

  C function: HMGL mgl_create_graph_ps (int width, int height)

  Create the instance of class mglGraphPS with specified sizes.

  C function: HMGL mgl_create_graph_idtf ()

  Create the instance of class mglGraphIDTF.

• Function for windowed “grapher” creation:

  C function: HMGL mgl_create_graph_glut (int (*draw)(HMGL gr, void *p), const char *title, void *par)

  Create the instance of class mglGraphGLUT and connected GLUT window. Only one GLUT window can be opened at once. Arguments description can be found in mglGraphAB class.

  C function: HMGL mgl_create_graph_fltk (int (*draw)(HMGL gr, void *p), const char *title, void *par)

  Create the instance of class mglGraphFLTK and connected FLTK window. Several windows can be opened at the same time. However user must call mgl_fltk_run() function to start the message handling circle. Arguments description can be found in mglGraphAB class.

  C function: HMGL mgl_create_graph_qt (int (*draw)(HMGL gr, void *p), const char *title, void *par)

  Create the instance of class mglGraphQT and connected Qt window. Several windows can be opened at the same time. However user must call mgl_qt_run() function to start the message handling circle. Arguments description can be found in mglGraphAB class.

  C function: void mgl_fltk_run ()

  Start FLTK message handling cycle. A normal program will end main() function with return mgl_fltk_run();.

  C function: void mgl_fltk_thread ()

  Start FLTK message handling cycle. In difference of mgl_fltk_run() the loop is started in separate thread so that program continues immediately.

  C function: void mgl_qt_run ()

  Start Qt message handling cycle. A normal program will end main() function with return mgl_qt_run();. Alternatively user may setup Qt application by direct Qt functions calls.

  C function: void mgl_qt_thread ()

  Start Qt message handling cycle. In difference of mgl_qt_run() the loop is started in separate thread so that program continues immediately.

  C function: void mgl_update (HMGL graph)

  Manually update contents of the window.

• Functions for data creation:

  C function: HMDT mgl_create_data ()

  Create simple instance of class mglData.

  C function: HMDT mgl_create_data_size (int nx, int ny, int nz)

  Create instance of class mglData with specified sizes.

  C function: HMDT mgl_create_data_file (const char *fname)

  Create instance of class mglData and fill it by data from text file.

• Each created object must be deleted after usage by functions:

  C function: void mgl_delete_graph (HMGL graph)

  Delete the instance of class. Must be used after plotting for every created graphical object.

  C function: void mgl_delete_data (HMDT dat)

  Delete the instance of class. Must be used after using for every created data object.