read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationData (Operator)
Name
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationData — Load FFT speed optimization data from a file.
Signature
read_fft_optimization_data( : : FileName : )
Herror read_fft_optimization_data(const char* FileName)
Herror T_read_fft_optimization_data(const Htuple FileName)
void ReadFftOptimizationData(const HTuple& FileName)
static void HMisc::ReadFftOptimizationData(const HString& FileName)
static void HMisc::ReadFftOptimizationData(const char* FileName)
static void HMisc::ReadFftOptimizationData(const wchar_t* FileName)
(Windows only)
Description
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataReadFftOptimizationData loads data for optimizing the
runtime of the FFT from the file given by FileNameFileNameFileNameFileNamefileName. The
optimization data must have been determined previously with
optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedOptimizeFftSpeed and must have been stored with
write_fft_optimization_datawrite_fft_optimization_dataWriteFftOptimizationDataWriteFftOptimizationDataWriteFftOptimizationData. If the stored data have been
determined for the image sizes to be used in the application, a call
to optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedOptimizeFftSpeed is unnecessary. It should be noted
that the data should only be used on the same machine on which they
were determined with optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedOptimizeFftSpeed. If this is not
observed the runtimes will not be optimal. Furthermore, it should
be noted that optimization data that were created with Standard
HALCON cannot be used with Parallel HALCON and vice versa.
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataReadFftOptimizationData influences the runtime of the
following operators, which use the FFT: fft_genericfft_genericFftGenericFftGenericFftGeneric,
fft_imagefft_imageFftImageFftImageFftImage, fft_image_invfft_image_invFftImageInvFftImageInvFftImageInv, sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandSfsPentland,
sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrSfsModLr, sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrSfsOrigLrwiener_filterwiener_filterWienerFilterWienerFilterWienerFilter.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FileNameFileNameFileNameFileNamefileName (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
File name of the optimization data.
Default value:
'fft_opt.dat'
"fft_opt.dat"
"fft_opt.dat"
"fft_opt.dat"
"fft_opt.dat"
Result
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataReadFftOptimizationData returns 2 (H_MSG_TRUE) if all parameters
are correct. If necessary, an exception is raised.
Possible Successors
fft_genericfft_genericFftGenericFftGenericFftGeneric,
fft_imagefft_imageFftImageFftImageFftImage,
fft_image_invfft_image_invFftImageInvFftImageInvFftImageInv,
rft_genericrft_genericRftGenericRftGenericRftGeneric,
wiener_filterwiener_filterWienerFilterWienerFilterWienerFilter,
wiener_filter_niwiener_filter_niWienerFilterNiWienerFilterNiWienerFilterNi,
photometric_stereophotometric_stereoPhotometricStereoPhotometricStereoPhotometricStereo,
sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandSfsPentland,
sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrSfsModLr,
sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrSfsOrigLr
Alternatives
optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedOptimizeFftSpeed,
optimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeedOptimizeRftSpeed
See also
write_fft_optimization_datawrite_fft_optimization_dataWriteFftOptimizationDataWriteFftOptimizationDataWriteFftOptimizationData
Module
Foundation