This is a *-sys
crate; you shouldn't use its API directly. The proj
crate is designed for general use.
A guide to the functions can be found here: https://proj.org/development/reference/functions.html. Run cargo doc (optionally --open)
to generate the crate documentation.
By default, this crate depends on a pre-built library, so libproj
(via PROJ v7.1.x
) must be present on your system. While this crate may be backwards-compatible with older PROJ 7 and PROJ 6 versions, this is neither tested or supported.
Enable these in your Cargo.toml
like so:
proj-sys = { version = "0.17", features = ["pkg_config"] }
proj-sys = { version = "0.17", features = ["bundled_proj"] }
Note that these features are mutually exclusive.
pkg_config
(Linux and macOS targets)
pkg-config
to add search paths to the build script. Requires pkg-config
to be installed (available on Homebrew, Macports, apt etc.)bundled_proj
(Linux and macOS targets):
libtiff
must be present on your system if you wish to use this feature. Note that this feature builds libproj
without its native network functionality, and you will have to implement your own set of callbacks if you wish to make use of them (see the proj
crate for an example of this).Licensed under either of
at your option.