liveViz library needs to be initialized before it can be used for
visualization. For initialization follow the following steps
from your main chare:
Create your chare array (array proxy object 'a') with the entry
method 'functionName' (described above).
Create a CkCallback object ('c'), specifying 'functionName' as the
callback function. This callback will be invoked whenever the
client requests a new image.
Create a liveVizConfig object ('cfg'). LiveVizConfig takes a number
of parameters, as described below.
Call liveVizInit (cfg, a, c).
The liveVizConfig parameters are:
The first parameter is the pixel type to be reduced:
``false'' or liveVizConfig::pix_greyscale means a greyscale image (1 byte per pixel).
``true'' or liveVizConfig::pix_color means a color image (3 RGB bytes per pixel).
liveVizConfig::pix_float means a floating-point color image (1 float per pixel, can only be used with sum_float_image_data or max_float_image_data).
The second parameter is the flag ``serverPush'', which is passed to the client application. If set to true, the client will repeatedly request for images. When set to false the client will only request for images when its window is resized and needs to be updated.
The third parameter is an optional 3D bounding box (type CkBbox3d). If present, this puts the client into a 3D visualization mode.
A typical 2D, RGB, non-push call to liveVizConfig looks like this:
