 |
NDEVR
API Documentation
|
|
NDEVR
API Documentation
|
Persistent settings for a drone photogrammetry processing run. More...
Public Member Functions | |
| void | getINI (INIFactory &factory) final override |
| Populates the given INI factory with the options managed by this interface. | |
| Public Member Functions inherited from INIInterface | |
| INIInterface () | |
| Constructs an INIInterface with no default INI file. | |
| INIInterface (const File &default_ini) | |
| Constructs an INIInterface with the specified default INI file. | |
| virtual | ~INIInterface () |
| Virtual destructor for safe polymorphic cleanup. | |
| virtual void | finishReadingINI (INIFactory &) |
| Called after reading an INI file. | |
| virtual void | prepareForINI (INIFactory &) |
| Called before reading or writing an INI file. | |
| virtual bool | readINIOptions () |
| Reads INI options from the default INI file. | |
| virtual bool | readINIOptions (File &ini_file) |
| Reads INI options from the specified INI file. | |
| virtual bool | saveINIOptions (bool multithead=false) |
| Saves INI options to the default INI file. | |
| virtual bool | saveINIOptions (File &ini_file, bool multithead=false) |
| Saves INI options to the specified INI file. | |
| void | setDefaultINIFile (const File &file) |
| Sets the default INI file path used for reading and writing options. | |
| virtual void | writeToLog (const StringView &title, LogPtr log, uint01 log_level=2U) |
| Writes the current INI options to the specified log with a title. | |
| virtual void | writeToLog (LogPtr log, uint01 log_level=2U) |
| Writes the current INI options to the specified log. | |
Public Attributes | |
| uint04 | dense_max_resolution |
| Maximum image resolution (long-edge pixels) for dense reconstruction. | |
| DenseReconstructionMode | dense_mode |
| Dense reconstruction pipeline mode. | |
| String | gcp_file |
| Optional GCP file path (used when georeference_mode == e_gcp_file) Format: point_id world_x world_y world_z image_name pixel_x pixel_y. | |
| PhotogrammetryGeoreferenceMode | georeference_mode |
| Georeferencing source. | |
| PhotogrammetryGPSAccuracy | gps_accuracy |
| GPS accuracy profile for SfM position prior weighting. | |
| String | image_folder |
| Folder containing the drone images to process. | |
| bool | lock_focal |
| When true, locks the focal length during bundle adjustment (only refines distortion coefficients). | |
| uint04 | max_resolution |
| Maximum image resolution (long-edge pixels) for feature extraction and SfM. | |
| uint04 | max_threads |
| Maximum number of threads to use during feature extraction (0 = all available). | |
| PhotogrammetryQuality | quality |
| Feature extraction / matching quality preset. | |
Additional Inherited Members | |
| Protected Attributes inherited from INIInterface | |
| File | m_default_ini |
| The default file path used for reading and writing INI options. | |
Persistent settings for a drone photogrammetry processing run.
Serialized via INIInterface so values survive across sessions.
Definition at line 96 of file PhotogrammetryOptions.h.
|
finaloverridevirtual |
Populates the given INI factory with the options managed by this interface.
| [in] | factory | The INI factory to populate with option definitions. |
Implements INIInterface.
| uint04 PhotogrammetryOptions::dense_max_resolution |
Maximum image resolution (long-edge pixels) for dense reconstruction.
0 = automatic (chosen based on quality preset — typically lower than max_resolution, matching industry practice: COLMAP, OpenMVS, AliceVision and ODM all use lower resolution for dense than for features/SfM). Camera intrinsics are automatically rescaled from SfM resolution.
Definition at line 126 of file PhotogrammetryOptions.h.
| DenseReconstructionMode PhotogrammetryOptions::dense_mode |
Dense reconstruction pipeline mode.
e_cpu_openmvs (default): OpenMVS handles depth estimation and fusion. e_gpu_openmvs_fusion: GPU PatchMatch depth maps fed into OpenMVS fusion. e_gpu_direct_fusion: GPU PatchMatch depth maps with direct 3D projection.
Definition at line 145 of file PhotogrammetryOptions.h.
| PhotogrammetryGPSAccuracy PhotogrammetryOptions::gps_accuracy |
GPS accuracy profile for SfM position prior weighting.
Controls how strongly GPS coordinates constrain bundle adjustment. e_consumer (default): light weights suitable for standard drone GPS (~5m). e_rtk: strong weights for RTK/PPK high-precision surveys (~2cm).
Definition at line 139 of file PhotogrammetryOptions.h.
| bool PhotogrammetryOptions::lock_focal |
When true, locks the focal length during bundle adjustment (only refines distortion coefficients).
Default is false (refine focal + distortion), matching the industry standard (COLMAP, ODM, MicMac all refine focal). Set true for datasets where EXIF focal is highly trusted and BA drift is a concern (e.g. fixed-lens drone surveys with calibrated cameras).
Definition at line 133 of file PhotogrammetryOptions.h.
| uint04 PhotogrammetryOptions::max_resolution |
Maximum image resolution (long-edge pixels) for feature extraction and SfM.
Images larger than this are downscaled before keypoint detection. 0 = automatic (chosen based on quality preset). Higher values improve camera pose accuracy at the cost of speed.
Definition at line 119 of file PhotogrammetryOptions.h.