Struct SessionConfig 

pub struct SessionConfig {

    pub image_root: PathBuf,
    pub gps: Vec<GpsRecord>,
    pub span: usize,
    pub overlap: usize,
    pub total_positions: Option<usize>,
    pub incremental_triangulation: bool,
    pub fixed_enu_origin: bool,
    pub seed: Option<u64>,
    pub extraction: ExtractionOptions,
    pub sift: Arc<dyn SiftEngine>,
    pub matcher: Arc<dyn MatcherBackend>,
    pub dense: Option<DenseConfig>,
    pub history: usize,
}

세션 설정.

Fields

image_root: PathBuf

입력 영상 폴더(영상 이름의 기준).

gps: Vec<GpsRecord>

GPS 기록(정렬 순서 = 이 순서).

span: usize

구역 크기·겹침(위치 단위).

overlap: usize

구역 겹침(위치 수).

total_positions: Option<usize>

알려진 전체 위치 수. 있으면 마지막 구역들이 마지막 위치에서 닫히고, 없으면 finish 에서 닫힌다.

incremental_triangulation: bool

새로 등록된 영상만 삼각측량.

fixed_enu_origin: bool

첫 GPS 기록으로 ENU 원점 고정(기본: 정렬마다 첫 공통 기록).

seed: Option<u64>

두 뷰 기하·GPS 정렬 RANSAC 시드.

extraction: ExtractionOptions

특징 추출 옵션.

sift: Arc<dyn SiftEngine>

SIFT 백엔드.

matcher: Arc<dyn MatcherBackend>

기술자 매칭 백엔드.

dense: Option<DenseConfig>

조밀화 설정(None = 조밀화 생략, 점군 이벤트는 dense: false).

history: usize

Command::ResetFrom 용으로 보관할 위치별 되감기 지점 수(0 = 되감기 불가, 메모리 절약).

Implementations

impl SessionConfig

pub fn new(image_root: impl Into<PathBuf>) -> Self

기본값: 구역 12 / 겹침 2, SIFT 최대 8192 특징·입력 3200, CPU SIFT·매칭, 조밀화 없음, 되감기 8.

Examples found in repository

examples/hooks.rs (line 33)

fn main() -> Result<(), String> {
    let out = std::env::args().nth(1).map(PathBuf::from).unwrap_or_else(|| std::env::temp_dir().join("cumulus3d_hooks"));
    let src = out.with_extension("src");
    if !src.join("gps_ref.txt").exists() {
        common::make_dataset(&src);
    }
    if out.exists() {
        std::fs::remove_dir_all(&out).map_err(|e| e.to_string())?;
    }
    let layout = Layout::discover(&src, 1)?;
    let npos = layout.frames.len();

    let mut cfg = SessionConfig::new(src.join("images"));
    cfg.gps = read_gps_file(src.join("gps_ref.txt")).map_err(|e| e.to_string())?;
    (cfg.span, cfg.overlap, cfg.total_positions, cfg.seed) = (4, 1, Some(npos), Some(7));
    if cumulus3d_cuda::is_available() {
        let mut d = DenseConfig::new(make_pm_backend("cuda"), parse_profile("fast")?);
        d.undistort.max_image_size = 160;
        cfg.dense = Some(d);
    }

    // 훅: 사건 문구 출력, 구역 점군 점 수, 경고·오류. 그리고 기본 출력 훅(파일).
    let pipeline = Pipeline::new(Session::new(cfg))
        .on_any(|e: &Event| {
            if let Some(t) = e.timeline_text() {
                println!("[event v{}] {t}", e.meta().version);
            }
        })
        .on(EventKind::ZonePreview, |e: &Event| {
            if let Event::ZonePreview { range, cloud, model, .. } = e {
                println!("  초벌 {}: 조밀 점 {} / 희소 점 {}", range.zone, cloud.len(), model.num_points3d());
            }
        })
        .on(EventKind::ZoneRefined, |e: &Event| {
            if let Event::ZoneRefined { range, cloud, model, .. } = e {
                println!("  정밀 {}: 조밀 점 {} / 희소 점 {}", range.zone, cloud.len(), model.num_points3d());
            }
        })
        .on_message(|k, m| eprintln!("  {k:?}: {m}"));
    let mut pipeline = sinks::attach(pipeline, &out, &SinkOptions::default()).map_err(|e| e.to_string())?;

    for p in 0..npos {
        pipeline.push(Input::Frames(FrameSet::new(CAMS.iter().map(|c| (*c, layout.name(c, p))))));
    }
    let (_, summary) = pipeline.finish();
    println!("이벤트 {} 개, 훅 호출 {} 번, 훅 패닉 {}", summary.events, summary.hook_calls, summary.hook_panics);

    for f in ["timeline.txt", "run.log", "snapshots/manifest.json", "snapshots/timeline.txt", "DONE"] {
        let p = out.join(f);
        println!("{} {}", if p.exists() { "있음" } else { "없음" }, p.display());
    }
    Ok(())
}

Trait Implementations

impl Clone for SessionConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.