10 releases (5 breaking)

0.10.0 Mar 14, 2024
0.9.3 Dec 19, 2023
0.9.2 Mar 27, 2023
0.8.0 Nov 20, 2022
0.1.0 Aug 3, 2021

#243 in Game dev

Download history 11/week @ 2024-07-23 7/week @ 2024-09-24

359 downloads per month

MIT license

460KB
13K SLoC

Rust bindings to Houdini Engine API

Cargo Documentation MIT/Apache 2.0

SideFX Houdini Meets Rust!

SideFx Houdini is world leading software for creating stunning visual effects for movies and games. Apart from the main graphical interface written in C++ and Python, Houdini also provides a C interface called Houdini Engine or HAPI for short. Its goal is to bring the power of Houdini to other DCCs (Digital Content Creation) software and game engines.

This crate aims to provide idiomatic Rust interface to Houdini Engine and is built on top of hapi-sys.

❗ A valid commercial Houdini Engine license is required to use this crate

HDA Viewer Demo

https://user-images.githubusercontent.com/10694389/227816361-b9ffa083-7932-40e4-afda-3cb400126eb5.mp4

Introduction Video On Youtube

Example

use hapi_rs::Result;
use hapi_rs::session::quick_session;
use hapi_rs::parameter::*;

fn main() -> Result<()> {
    // Start a standalone engine process
    let session = quick_session(None)?;
    // Load a Houdini Asset and create a node
    let lib = session.load_asset_file("otls/hapi_geo.hda")?;
    let node = lib.create_asset_for_node("Object/hapi_geo", None)?;
    // Set the "scale" parameter
    if let Parameter::Float(parm) = node.parameter("scale")? {
        parm.set(0, 3.0)?;
        node.cook(None)?;
    }
    // Get a reference to the node's internal geometry
    let geometry = node.geometry()?.expect("geometry");
    // Save it to one of the supported geometry formats
    geometry.save_to_file("/tmp/output.fbx")?;
    Ok(())
}

Building

Check the documentation building section

HAPI C Documentation

More Examples

Dependencies

~2–10MB
~124K SLoC