See ez3_doc for main facts about EZSCROLL and its graphics. This EZView reads saved data files with the fields (the records) and visualizes them instead of actual calculations. *************** PARAMETER FILE The name of parameter files is the only (and optional) argument of ezview. It defaults to "task.dat". It is similar in style to EZSCROLL task file, but different in contents. Line 1: format. A (blank separated) text string. Currently understood: - "ez" the standard ic.dat/fc.dat format as used by EZSCROLL ver. 1.5. - "tiff" for tiff-encoded z=const sections named NN.tif (4 channels), where NN runs from 0 to nz-1. - "ppm" which is 3D extension of binary ppm (3 channels). NB this is not proper extension as described in NETPBM manual, as the header is assumed the same for all images and is not repeated, as standard multi-image ppm requires. Line 2: template. A (blank separated) text string. It should contain a C format (with %04d or something like that inside) which would produce the name of the file/directory with field record when the record number is printed using that format. Line 3: three numbers (minimal, step, maximal) defining available set of records. Line 4: grid dimensions Line 5: simulation and rotation resolutions, as in EZSCROLL. Line 6: field shown initilly, as in EZSCROLL Line 7: the channel in which the "u" variable in the records is to be found (0,1 or 22 for ppm and 0,1,2 or 3 for tiff), then its min and max expected values (assuming the integer vlues 0..255 have been scaled to 0..1 real interval), and the critical values used for detecting filaments. NB no check is made on relative values of umin, umax and uc etc. Line 8: same, for the "v" variable. Line 9: coloring rule (a number from 0 to 3) and maximal value of the opacity (some of coloring rules use gradual variation of opacity). Line 10: (initial) angular coords defining viewpoint Line 12: (initial) backs elimination flag Line 13: (initial) clipping plane flag Line 14: (initial) filament draw flag Line 15: (initial) filament write flag Line 16: (initial) save images flag Line 17: (initial) write history flag Line 18: (initial) coordinates of the history point Line 20: space and time step. They are only used to output "dimensional" time and space coords, and do not affect visualization. Line 22: verbosity level, as in EZSCROLL. ************ WINDOW TITLE is informative: it shows - the current field (U, V or N for no field), - the current record number ("m=..."), - its dimensional version ("t=..."), - direction of "simulation" (-> for forward and <- for backward), - pause indicator ('*' when paused, place left blank in "simulation" mode) - [....] string indicating current values of the visualization flags, - [...] string indicating current values of the file output flags, - (..,..) entry showing curent viewpoint angles. Visualization flags: (B)ack elimination (C)utting plant (D)epth sorting (F)ilament drawing File output flags: (H)istory (I)mages (W)rite filament data 'Back elimination': when on, the portions of the u-isosurface corresponding to v-values above the critical (the backs) are not visualized. This is now done in a crude way (whole triangles are ignored) so works reasonably well only for good resolution data. 'Images': when on, the contents of visualization window will be saved automatically to numbered png files at every step when in "simulation mode". ******* HOTKEYS The flags mentioned above can be changed by pressing "hot keys" while keyboard focus is in the visualization window. Many correspond to the hot keys as used EZSCROLL, including 'P' for pause, 'U', 'V' or 'N' for the field shown. Further hot keys: 'S' for Save image: will save just the contents of the current visualization window into a png file. It is not a flag but an immediately executed command. It is available in EZSCROLL but the version here should work on any platform with GL. '-' : will reverse the value of "step" parameter. You can scroll through records automatically either forwards and backwards '=' : will initiate parameter changing dialogue in the parent terminal window. You will need to change keyboard focus to that window to use it, and then back to visualization window again when you finished with it. Hopefully the dialogue should be self-explanatory. Empty answer for parameter value means do not change, and for parameter name means finish the dialogue. For further particulars see the source code.