fix: issues/60,214,239,292,299,328,339,384,385,386 (#379)

* test whether split will take owner of string?

meta.SRS.split() will take meta.SRS ? or meta.SRS.str().split()

* Fix: file separator and runtime error (#340)

* fix: file separator

* fix: Result::unwrap() on an Err value: Error("control character (\\u0000-\\u001F)

* feature: e2e

* fix: coordinate offset

* fix

* fix: auto fix terrain height

* fix: fbx drift

* docs: update

* refactor: coordinate system

* fix: fbx texture

* fix: shapefile supports more coordinate system

* fix: shapefile

* fix: windows compiler error

* fix: windows compiler error

* fix: windows compiler error

---------

Co-authored-by: fanvanzh <fanvanzh@sina.com>

Author: WallanceLee

.gitignore

@@ -5,4 +5,7 @@
 /.cache/
 /build/
 /.idea/
-.DS_Store
+.DS_Store
+
+data
+output

CMakeLists.txt

@@ -141,6 +141,10 @@ target_link_libraries(_3dtile PUBLIC Eigen3::Eigen)
 find_package(unofficial-sqlite3 CONFIG REQUIRED)
 target_link_libraries(_3dtile PRIVATE unofficial::sqlite3::sqlite3)
 
+# GeographicLib for geoid height calculation
+find_package(GeographicLib CONFIG REQUIRED)
+target_link_libraries(_3dtile PRIVATE ${GeographicLib_LIBRARIES})
+
 
 install(TARGETS _3dtile DESTINATION lib)
 install(TARGETS ufbx DESTINATION lib)

README_EN.md

@@ -223,6 +223,12 @@ _3dtile.exe -f shape -i E:\Data\aa.shp -o E:\Data\aa --height height
 # from single fbx file
 _3dtile.exe -f fbx -i E:\Data\model.fbx -o E:\Data\model
 
+# from fbx with geoid height conversion (China 1985 to WGS84)
+_3dtile.exe -f fbx -i E:\Data\model.fbx -o E:\Data\model --lon 120.0 --lat 30.0 --alt 100 --geoid egm96
+
+# from fbx with custom geoid data path
+_3dtile.exe -f fbx -i E:\Data\model.fbx -o E:\Data\model --lon 120.0 --lat 30.0 --geoid egm96 --geoid-path geoids/geoids
+
 # from single osgb file to glb file
 _3dtile.exe -f gltf -i E:\Data\TT\001.osgb -o E:\Data\TT\001.glb
 
@@ -272,6 +278,30 @@ _3dtile.exe -f shape -i E:\Data\aa.shp -o E:\Data\aa \
 
 - `--height <FIELD>` - Height attribute field name (required for shapefile conversion)
 
+- `--lon <LON>` - Longitude
+  Set the center longitude for FBX format positioning
+
+- `--lat <LAT>` - Latitude
+  Set the center latitude for FBX format positioning
+
+- `--alt <ALT>` - Altitude
+  Set the center altitude for FBX format positioning
+
+- `--geoid <MODEL>` - Geoid model for height conversion
+  Set the geoid model to convert orthometric height (e.g., China 1985) to ellipsoidal height (WGS84)
+  - **Available values:** `none` (default), `egm84`, `egm96`, `egm2008`
+  - **Applies to:** FBX format
+  - **Use case:** Required when source data uses orthometric height (above sea level) instead of ellipsoidal height
+  - **Example:** `--geoid egm96`
+
+- `--geoid-path <PATH>` - Path to geoid data files
+  Set the path to geoid data files (e.g., egm96-5.pgm)
+  - **Default behavior:**
+    1. First checks `GEOGRAPHICLIB_GEOID_PATH` environment variable
+    2. Falls back to default path `/usr/local/share/GeographicLib/geoids`
+  - **Applies to:** Used with `--geoid` option
+  - **Example:** `--geoid-path /path/to/geoids`
+
 - `-v, --verbose` - Enable verbose output for debugging
 
 ### Optimization Flags (New)

README_ZH.md

@@ -307,6 +307,15 @@ _3dtile.exe -f gltf -i E:\Data\TT\001.obj -o E:\Data\TT\001.glb
 
 # convert single b3dm file to glb file
 _3dtile.exe -f b3dm -i E:\Data\aa.b3dm -o E:\Data\aa.glb
+
+# from single fbx file
+_3dtile.exe -f fbx -i E:\Data\model.fbx -o E:\Data\model
+
+# from fbx with geoid height conversion (China 1985 to WGS84)
+_3dtile.exe -f fbx -i E:\Data\model.fbx -o E:\Data\model --lon 120.0 --lat 30.0 --alt 100 --geoid egm96
+
+# from fbx with custom geoid data path
+_3dtile.exe -f fbx -i E:\Data\model.fbx -o E:\Data\model --lon 120.0 --lat 30.0 --geoid egm96 --geoid-path geoids/geoids
 ```
 
 ### 使用优化参数的高级选项
@@ -367,6 +376,30 @@ _3dtile.exe -f shape -i E:\Data\aa.shp -o E:\Data\aa \
 - `--height <FIELD>` 高度字段名称
   指定 shapefile 中的高度属性字段，转换 shp 时的必需参数
 
+- `--lon <LON>` 经度
+  设置中心点经度，用于 FBX 格式定位
+
+- `--lat <LAT>` 纬度
+  设置中心点纬度，用于 FBX 格式定位
+
+- `--alt <ALT>` 高度
+  设置中心点高度，用于 FBX 格式定位
+
+- `--geoid <MODEL>` 大地水准面模型
+  设置用于高度转换的大地水准面模型，将正高（如中国1985高程）转换为椭球高（WGS84）
+  - **可选值：** `none`（默认）, `egm84`, `egm96`, `egm2008`
+  - **适用于：** FBX 格式
+  - **使用场景：** 当源数据使用正高（海拔高）而非椭球高时，需要进行高程转换
+  - **示例：** `--geoid egm96`
+
+- `--geoid-path <PATH>` 大地水准面数据路径
+  设置大地水准面数据文件的路径（如 egm96-5.pgm）
+  - **默认行为：**
+    1. 优先使用 `GEOGRAPHICLIB_GEOID_PATH` 环境变量
+    2. 其次使用默认路径 `/usr/local/share/GeographicLib/geoids`
+  - **适用于：** 与 `--geoid` 配合使用
+  - **示例：** `--geoid-path /path/to/geoids`
+
 - `-v, --verbose` 启用详细输出用于调试
 
 ### 优化参数（新增）

build.rs

@@ -117,6 +117,16 @@ fn build_win_msvc() {
     let vcpkg_installed_lib_dir = vcpkg_installed_dir.join("lib");
     println!("cargo:rustc-link-search=native={}", vcpkg_installed_lib_dir.display());
 
+    // Determine if building in debug or release mode
+    let profile = env::var("PROFILE").unwrap_or("release".to_string());
+    let is_debug = profile == "debug";
+    let geolib_lib_name = if is_debug {
+        "GeographicLib_d-i"
+    } else {
+        "GeographicLib-i"
+    };
+    println!("cargo:warning=Building in {} mode, linking GeographicLib as: {}", profile, geolib_lib_name);
+
     // 1. FFI static
     println!("cargo:rustc-link-lib=static=_3dtile");
     println!("cargo:rustc-link-lib=static=ufbx");
@@ -138,6 +148,9 @@ fn build_win_msvc() {
     // zstd is required by gdal/basisu when building KTX2 (supercompression) and some GDAL drivers
     println!("cargo:rustc-link-lib=zstd");
 
+    // GeographicLib for geoid height calculation
+    println!("cargo:rustc-link-lib={}", geolib_lib_name);
+
     // 5. sqlite
     println!("cargo:rustc-link-lib=sqlite3");
 
@@ -285,6 +298,9 @@ fn build_linux_unknown() {
     // zstd is required by gdal/basisu when building KTX2 (supercompression) and some GDAL drivers
     println!("cargo:rustc-link-lib=zstd");
 
+    // GeographicLib for geoid height calculation
+    println!("cargo:rustc-link-lib=GeographicLib");
+
     let vcpkg_share_dir = vcpkg_installed_dir.join("share");
     copy_gdal_data(vcpkg_share_dir.to_str().unwrap());
     copy_proj_data(vcpkg_share_dir.to_str().unwrap());
@@ -412,6 +428,9 @@ fn build_macos() {
     // zstd is required by gdal/basisu when building KTX2 (supercompression) and some GDAL drivers
     println!("cargo:rustc-link-lib=zstd");
 
+    // GeographicLib for geoid height calculation
+    println!("cargo:rustc-link-lib=GeographicLib");
+
     // 7. System libraries / frameworks
     println!("cargo:rustc-link-lib=c++");
     println!("cargo:rustc-link-lib=z");
@@ -555,6 +574,9 @@ fn build_macos_x86_64() {
     // zstd is required by gdal/basisu when building KTX2 (supercompression) and some GDAL drivers
     println!("cargo:rustc-link-lib=zstd");
 
+    // GeographicLib for geoid height calculation
+    println!("cargo:rustc-link-lib=GeographicLib");
+
     // 7. System libraries / frameworks
     println!("cargo:rustc-link-lib=c++");
     println!("cargo:rustc-link-lib=z");