dear-implot3d-sys

Low-level FFI bindings for ImPlot3D via the cimplot3d C API. This crate pairs with dear-imgui-sys (cimgui C API) and exposes raw functions/types used by the high-level dear-implot3d crate.

Features

prebuilt: allow the build script to auto-download a release archive when available (or when IMPLOT3D_SYS_USE_PREBUILT=1).
build-from-source: force building native sources with cc even if a prebuilt could be linked.
package-bin: enable an internal bin/package helper to produce release artifacts.

Build Modes

This crate supports multiple ways to obtain the native dear_implot3d static library:

Source build (default)
- Compiles cimplot3d.cpp and upstream implot3d/*.cpp with cc.
- Inherits include paths and preprocessor defines from dear-imgui-sys.
System/prebuilt library
- Links an existing static library from a directory you provide (see env vars below).
Docs.rs
- Generates Rust bindings only; native code is not compiled.

Environment Variables

IMPLOT3D_SYS_LIB_DIR
- Directory containing the prebuilt static library.
- Expected names: dear_implot3d.lib (Windows/MSVC), libdear_implot3d.a (Unix).
IMPLOT3D_SYS_PREBUILT_URL
- Direct URL to the prebuilt static library file, or to a .tar.gz package produced by our packager.
- Downloaded to OUT_DIR/prebuilt/ and reused on subsequent builds.
IMPLOT3D_SYS_USE_PREBUILT
- If set to 1 or the prebuilt feature is enabled, the build script may auto-download a release asset.
IMPLOT3D_SYS_SKIP_CC
- If set, skips native C/C++ compilation. Typically used with one of the above.
IMPLOT3D_SYS_FORCE_BUILD
- Force building from source even if a prebuilt could be used.
IMPLOT3D_SYS_PACKAGE_DIR, IMPLOT3D_SYS_CACHE_DIR
- Overrides for local package discovery and cache locations.

The build script also consumes include paths and defines exported by dear-imgui-sys:

DEP_DEAR_IMGUI_IMGUI_INCLUDE_PATH, DEP_DEAR_IMGUI_CIMGUI_INCLUDE_PATH
DEP_DEAR_IMGUI_DEFINE_*

Examples

Default (source build):

cargo build -p dear-implot3d-sys -p dear-implot3d

System/prebuilt (Windows):

$env:IMPLOT3D_SYS_LIB_DIR = "C:\\prebuilt\\implot3d"
cargo build -p dear-implot3d-sys

System/prebuilt (Unix):

export IMPLOT3D_SYS_LIB_DIR=/opt/implot3d/lib
cargo build -p dear-implot3d-sys

Remote prebuilt download:

# Windows: URL must point to dear_implot3d.lib or a .tar.gz package
$env:IMPLOT3D_SYS_PREBUILT_URL = "https://example.com/dear_implot3d.lib"

# Unix: URL must point to libdear_implot3d.a or a .tar.gz package
export IMPLOT3D_SYS_PREBUILT_URL=https://example.com/libdear_implot3d.a

cargo build -p dear-implot3d-sys

Notes