NDEVR
API Documentation
PhotogrammetryOptions.h
1/*--------------------------------------------------------------------------------------------
2Copyright (c) 2026, NDEVR LLC
3tyler.parke@ndevr.org
4 __ __ ____ _____ __ __ _______
5 | \ | | | __ \ | ___|\ \ / / | __ \
6 | \ | | | | \ \ | |___ \ \ / / | |__) |
7 | . \| | | |__/ / | |___ \ V / | _ /
8 | |\ |_|_____/__|_____|___\_/____| | \ \
9 |__| \__________________________________| \__\
10
11Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants
12Licensee a limited, non-exclusive, non-transferable, royalty-free license
13(without the right to sublicense) to use the API solely for the purpose of
14Licensee's internal development efforts to develop applications for which
15the API was provided.
16
17The above copyright notice and this permission notice shall be included in all
18copies or substantial portions of the Software.
19
20THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
21INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
22PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
23FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
24OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25DEALINGS IN THE SOFTWARE.
26
27Library: DronePhotogrammetry
28File: PhotogrammetryOptions
29Included in API: True
30Author(s): Tyler Parke
31 *-----------------------------------------------------------------------------------------**/
32#pragma once
33#include "DLLInfo.h"
34#include <NDEVR/INIInterface.h>
35#include <NDEVR/BaseValues.h>
36#include <NDEVR/String.h>
37namespace NDEVR
38{
51
67
78
91
96 class DRONE_PHOTOGRAMMETRY_API PhotogrammetryOptions : public INIInterface
97 {
98 public:
101
105
108
111
114
120
127
134
140
146
147 public:
148 PhotogrammetryOptions();
149 void getINI(INIFactory& factory) final override;
150 void resetToDefaults();
151 static PhotogrammetryOptions& DefaultOptions();
152 };
153}
Contains methods for easily reading and writing to an INI file including efficient casting,...
Definition INIReader.h:107
INIInterface()
Constructs an INIInterface with no default INI file.
bool lock_focal
When true, locks the focal length during bundle adjustment (only refines distortion coefficients).
void getINI(INIFactory &factory) final override
Populates the given INI factory with the options managed by this interface.
PhotogrammetryGPSAccuracy gps_accuracy
GPS accuracy profile for SfM position prior weighting.
PhotogrammetryQuality quality
Feature extraction / matching quality preset.
uint04 max_threads
Maximum number of threads to use during feature extraction (0 = all available).
String image_folder
Folder containing the drone images to process.
String gcp_file
Optional GCP file path (used when georeference_mode == e_gcp_file) Format: point_id world_x world_y w...
PhotogrammetryGeoreferenceMode georeference_mode
Georeferencing source.
uint04 dense_max_resolution
Maximum image resolution (long-edge pixels) for dense reconstruction.
DenseReconstructionMode dense_mode
Dense reconstruction pipeline mode.
uint04 max_resolution
Maximum image resolution (long-edge pixels) for feature extraction and SfM.
The core String class for the NDEVR API.
Definition String.h:95
The primary namespace for the NDEVR SDK.
DenseReconstructionMode
Controls the dense reconstruction pipeline.
@ e_gpu_openmvs_fusion
GPU PatchMatch depth maps fed into OpenMVS fusion (hybrid).
@ e_cpu_openmvs
OpenMVS CPU pipeline: depth estimation + fusion (default).
@ e_gpu_direct_fusion
GPU PatchMatch depth maps + direct projection (experimental).
PhotogrammetryGPSAccuracy
GPS accuracy profile for SfM position prior weighting.
@ e_consumer
~5m accuracy: lighter BA prior weights, less trust in altitude
@ e_rtk
~2cm accuracy: strong BA prior weights for high-precision surveys
uint32_t uint04
-Defines an alias representing a 4 byte, unsigned integer -Can represent exact integer values 0 throu...
PhotogrammetryGeoreferenceMode
Controls how image positions are georeferenced.
@ e_gps_exif
Read GPS coordinates from EXIF metadata embedded in each image.
@ e_gcp_file
Read ground control points from a user-supplied text file.
PhotogrammetryQuality
Controls which feature extractor and matching strategy OpenMVG uses.
@ e_high
Quality: SIFT features, vocabulary-tree matching, full-resolution MVS.
@ e_draft
Fast: AKAZE features, cascade hash matching, half-resolution MVS.
uint8_t uint01
-Defines an alias representing a 1 byte, unsigned integer -Can represent exact integer values 0 throu...
@ e_normal
Normal map channel for per-pixel lighting.