Annotation of /trunk/pyvisi/readme

 ****************************************************************************
 **                              Pyvisi Notes                              **
 **                                                                        **
 **                       Last Updated: 21 June 2007                       **
 ****************************************************************************


- Two DataCollector instances need to be created when two active scalars
  are read from the same file.

- setScalarRange() and generateContours() must be supplied with the same range
  in order for the colors to turn out correctly when contouring is performed.

- setPlaneToXY(), setPlaneToXZ() or setPlaneToYZ() needs to be executed
  whenever a plane cut is performed before a plane can be rendered correctly.

- If a surface map and legend is created, both must have the the same scalar
  range. For instance, if the surface map's scalar range is set between 2 and 
  4, the same must apply to the scalar bar's scalar range. Otherwise, the 
  colors of the scalar bar and surface map will not be sync.

- Movie will create a temporary file called 'make_movie' and will delete it
  once the movie has been generated if no parameter file name was specified.

- To modify the parameter_file (i.e. change frames/second or codec), one needs
  to save the parameter file (by supplying a name when creating the movie
  instance) and run it manually using the 'ppmtompeg' command.

- Movies cannot be generated from post script (.ps) files.

- .iv (open inventor) and .wrl (VRML) files do not support multiple 
  viewports.
 
- .iv files suffer from some lighting problems when generated by VTK.

- On occasions, objects using cell data may be rendered incorrectly
  even after conversion. A workaround is to use escript interpolation to
  get the node data for visualizations.

1	jongui	1201	****************************************************************************
2			Pyvisi Notes
3
4			Last Updated: 21 June 2007
5			****************************************************************************
6
7
8	caltinay	1961	- Two DataCollector instances need to be created when two active scalars
9	jongui	1201	are read from the same file.
10
11	caltinay	1961	- setScalarRange() and generateContours() must be supplied with the same range
12	jongui	1201	in order for the colors to turn out correctly when contouring is performed.
13
14			- setPlaneToXY(), setPlaneToXZ() or setPlaneToYZ() needs to be executed
15			whenever a plane cut is performed before a plane can be rendered correctly.
16
17			- If a surface map and legend is created, both must have the the same scalar
18			range. For instance, if the surface map's scalar range is set between 2 and
19			4, the same must apply to the scalar bar's scalar range. Otherwise, the
20			colors of the scalar bar and surface map will not be sync.
21
22			- Movie will create a temporary file called 'make_movie' and will delete it
23			once the movie has been generated if no parameter file name was specified.
24
25			- To modify the parameter_file (i.e. change frames/second or codec), one needs
26			to save the parameter file (by supplying a name when creating the movie
27			instance) and run it manually using the 'ppmtompeg' command.
28
29			- Movies cannot be generated from post script (.ps) files.
30
31	caltinay	1961	- .iv (open inventor) and .wrl (VRML) files do not support multiple
32	jongui	1201	viewports.
33
34	caltinay	1961	- .iv files suffer from some lighting problems when generated by VTK.
35	jongui	1201
36	caltinay	1961	- On occasions, objects using cell data may be rendered incorrectly
37			even after conversion. A workaround is to use escript interpolation to
38			get the node data for visualizations.
39	jongui	1201