Description Creates a rayset by Gabor synthesis from the specified complex vector field file using settings from the T_SYNTH_RAYS_FROM_FIELD structure. The synthesized rayset will propagate along the +Z axis of the associated analysis grid that generated the vector field. Depending on the number of rays traced, it may be necessary to dimension ray index and ray counter variables as data type Huge_ instead of Long. Please see Multi-threaded Raytracing for more information.
Syntax count = CreateRaysFromVectorFieldFile( fname, raysynth )
Parameters count (Long or Huge_) Number of rays created by the Vector Field synthesis.
fname As String Name of file containing vector field data. This file must be created using the VectorFieldToFile command.
raysynth As T_SYNTH_RAYS_FROM_FIELD Structure containing Gabor synthesis settings.
Remarks Creates a rayset by Gabor synthesis from the specified complex vector field file using settings from the T_SYNTH_RAYS_FROM_FIELD structure. Attempting to read a scalar field file will generate an error.
Rays created by this method are added directly to the ray buffer with a default Append operation. If the intent is to replace existing rays with the newly created ones, simply issue a DeleteRays command prior to ray creation.
See Also
|