# osgearth-full-stack-build

**Repository Path**: leoZhangs/osgearth-full-stack-build

## Basic Information

- **Project Name**: osgearth-full-stack-build
- **Description**: Windows 平台 GIS 三维可视化 SDK 一键编译脚本合集。涵盖 osg/osgearth/gdal全部依赖共 20 个库。输出Release x64 共享 DLL，使用Visual Studio 2022 + v141 工具集编译，兼容 Windows 7。

- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GIS SDK Build Scripts

A collection of one-click build scripts for a complete GIS 3D visualization SDK stack on Windows.

## Stack

| Category | Libraries |
|---|---|
| Compression | zlib |
| Image | libpng, libjpeg-turbo (jpeg), giflib, libtiff |
| Font | freetype |
| Network | curl + OpenSSL |
| Data | sqlite, json-c, libexpat, hdf5, netcdf-c |
| GIS Core | PROJ, GEOS, libgeotiff, GDAL |
| 3D Engine | OpenSceneGraph 3.6.5 |
| 3D Earth | osgEarth 2.10.2 |

## Environment

- **OS**: Windows 7+ x64
- **Compiler**: Visual Studio 2022 Community
- **Toolset**: MSVC v141 (VS 2017 toolchain)
- **Windows SDK**: 10.0.26100.0
- **CMake**: 4.0.1 (Ninja generator)
- **Config**: Release / x64 / Shared (DLL)

## Prerequisites

1. Visual Studio 2022 with "Desktop development with C++" and "MSVC v141 - VS 2017 C++ x64/x86 build tools"
2. [CMake 4.0.1+](https://cmake.org/download/) (Ninja included)
3. Git for cloning source repos
4. [Strawberry Perl](https://strawberryperl.com/) (for OpenSSL build) — `strawberry.zip` bundled

## Build

Each library has a `build_v141.bat` in its source directory. Run them in dependency order (see `REPOS.md` and `docs/DEPENDENCIES.md`).

```batch
REM Example: build zlib then libpng
cd zlib && build_v141.bat
cd ..\libpng && build_v141.bat
```

Outputs go to `install/<lib>/`. All installs are self-contained with no system library dependencies.

The consolidated deploy package is at `ReleaseDeploy/`.

## Runtime

```batch
env.bat
gdalinfo --version
osgviewer
osgearth_viewer
```

## Directory Layout

```
.
├── <lib>/                  # Source repos (each with its own .git)
│   └── build_v141.bat      # One-click build script
├── install/                # Build outputs per library
├── ReleaseDeploy/          # Consolidated deploy package
│   ├── bin/                # DLLs, EXEs, OSG/osgEarth plugins
│   ├── include/            # All headers
│   ├── lib/                # Import libraries + CMake configs
│   └── share/              # GDAL/PROJ data files
├── docs/                   # Build docs, dependency info, patches
├── examples/               # CMake demo project
├── env.bat                 # Runtime environment setup
├── REPOS.md                # Sub-repo git references
└── README.md               # This file
```

## Docs

- [DEPENDENCIES.md](docs/DEPENDENCIES.md) — library versions, dependency graph, download URLs
- [BUILD.md](docs/BUILD.md) — compiler environment and per-library build notes
- [PATCHES.md](docs/PATCHES.md) — source modifications applied

## License

Each third-party library is covered by its own license. See individual repositories for details.