Skip to main content

API Overview

This section provides complete API reference documentation for MipMapEngine SDK, including all available interfaces, parameter descriptions, and usage examples.

Before You Start

If you haven't installed the SDK yet, please first check the Installation Guide Windows or Installation Guide Linux.

MipMapEngine SDK provides multiple interfaces to meet different usage scenarios:

📚 Interface Categories

InterfaceFunctionTypeApplicable Scenarios
ReconstructFull【Recommended】Full-process reconstruction0Quick startup, automatic processing, simple parameter configuration, see ReconstructFull Interface Details
ReconstructATAerotriangulation1Fine control, professional users, see ReconstructAT Details
Reconstruct3D3D Reconstruction2Generate models from aerotriangulation results, see Reconstruct3D Details
OptimizeATControl point optimization3Use control points to improve accuracy, see OptimizeAT Details
DivideTilesTile processing4Large-scale data tile reconstruction, see DivideTiles Details

📚 >>> Learn more about the ReconstructFull interface

📝 Interface Invocation Methods

1. Command Line Invocation

The SDK supports direct invocation of each engine through the command line, controlling interface usage by controlling Type:

# General format
reconstruct_full_engine -reconstruct_type <type_number> -task_json <config_task_file.json>

# Example: Invoke ReconstructFull (Type=0)
reconstruct_full_engine -reconstruct_type 0 -task_json config_task.json

🎯 Choosing the Right Interface

If you...RecommendedReason
Using SDK for the first timeReconstructFull, see ReconstructFull Interface DetailsAutomatic processing, simple to get started, suitable for most tasks
Need to use control points to optimize reconstructionReconstructAT/OptimizeAT/Reconstruct3DSupports control point optimization
Regular tile processing of ultra-large dataReconstructAT/DivideTiles/Reconstruct3DSupports custom tile processing

📖 JSON Configuration Files

All interfaces use JSON format configuration files, basic structure:

{
"working_dir": "string", // Required: Working directory
"gdal_folder": "string", // Required: GDAL data directory
// ... Other parameters depend on the interface
}

For more detailed information, refer to the API manual.

Error Handling

All interfaces return integer error codes:

  • 0: Success
  • Non-zero: Various error conditions

For details, see error code reference Error Codes.

🚀 Next Steps


Tip: Most users can meet their needs using ReconstructFull. Only use other interfaces when fine control is needed.