Struct hapi_rs::session::Session

pub struct Session { /* private fields */ }

Session represents a unique connection to the Engine instance and all API calls require a valid session. It implements Clone and is Send and Sync

Implementations

impl Session

pub fn session_type(&self) -> SessionType

Return SessionType current session is initialized with.

pub fn connection_type(&self) -> &ConnectionType

Return enum with extra connection data such as pipe file or socket.

pub fn set_server_var<T: EnvVariable + ?Sized>(
    &self,
    key: &str,
    value: &T::Type
) -> Result<()>

Set environment variable on the server

pub fn get_server_var<T: EnvVariable + ?Sized>(
    &self,
    key: &str
) -> Result<<T::Type as ToOwned>::Owned>

Get environment variable from the server

pub fn get_server_variables(&self) -> Result<StringArray>

Retrieve all server variables

pub fn get_string(&self, handle: i32) -> Result<String>

Retrieve string data given a handle.

pub fn cleanup(&self) -> Result<()>

Cleanup the session. Session will not be valid after this call and needs to be initialized again

pub fn is_initialized(&self) -> bool

Check if session is initialized

pub fn create_input_node(&self, name: &str) -> Result<Geometry>

Create an input geometry node which can accept modifications

pub fn create_input_curve_node(&self, name: &str) -> Result<Geometry>

Create an input geometry node with crate::enums::PartType set to Curve

pub fn create_node<'a>(
    &self,
    name: impl AsRef<str>,
    label: impl Into<Option<&'a str>>,
    parent: Option<NodeHandle>
) -> Result<HoudiniNode>

Create a node. name must start with a network category, e.g, “Object/geo”, “Sop/box” New node will not be cooked.

pub fn find_node_from_path(
    &self,
    path: impl AsRef<str>,
    parent: Option<NodeHandle>
) -> Result<HoudiniNode>

Find a node given an absolute path. To find a child node, pass the parent node or use HoudiniNode::find_child_by_path

pub fn find_parameter_from_path(
    &self,
    path: impl AsRef<str>
) -> Result<Option<Parameter>>

Find a parameter by its absolute path

pub fn get_manager_node(&self, node_type: NodeType) -> Result<ManagerNode>

Returns a manager (root) node such as OBJ, TOP, CHOP, etc

pub fn save_hip(&self, name: &str, lock_nodes: bool) -> Result<()>

Save current session to hip file

pub fn load_hip(&self, path: impl AsRef<Path>, cook: bool) -> Result<()>

Load a hip file into current session

pub fn merge_hip(&self, name: &str, cook: bool) -> Result<i32>

Merge a hip file into current session

pub fn load_asset_file(&self, file: impl AsRef<Path>) -> Result<AssetLibrary>

Load an HDA file into current session

pub fn interrupt(&self) -> Result<()>

Interrupt session cooking

pub fn get_status(&self, flag: StatusType) -> Result<State>

Get session state of a requested crate::enums::StatusType

pub fn is_cooking(&self) -> Result<bool>

Is session currently cooking. In non-threaded mode always returns false

pub fn is_valid(&self) -> bool

Explicit check if the session is valid. Many APIs do this check in the debug build.

pub fn get_status_string(
    &self,
    status: StatusType,
    verbosity: StatusVerbosity
) -> Result<String>

Get the status message given a type and verbosity

pub fn get_cook_result_string(
    &self,
    verbosity: StatusVerbosity
) -> Result<String>

Get session cook result status as string

pub fn cooking_total_count(&self) -> Result<i32>

How many nodes need to cook

pub fn cooking_current_count(&self) -> Result<i32>

How many nodes have already cooked

pub fn cook(&self) -> Result<CookResult>

In threaded mode wait for Session finishes cooking. In single-thread mode, immediately return See Documentation

pub fn get_connection_error(&self, clear: bool) -> Result<String>

Retrieve connection error if could not connect to engine instance

pub fn get_time(&self) -> Result<f32>

Get Houdini time

pub fn set_time(&self, time: f32) -> Result<()>

Set Houdini time

pub fn lock(&self) -> ReentrantMutexGuard<'_, ()>

Lock the internal reentrant mutex. Should not be used in general, but may be useful in certain situations when a series of API calls must be done in sequence

pub fn set_timeline_options(&self, options: TimelineOptions) -> Result<()>

Set Houdini timeline options

pub fn get_timeline_options(&self) -> Result<TimelineOptions>

Get Houdini timeline options

pub fn set_use_houdini_time(&self, do_use: bool) -> Result<()>

Set session to use Houdini time

pub fn get_viewport(&self) -> Result<Viewport>

Get the viewport(camera) position

pub fn set_viewport(&self, viewport: &Viewport) -> Result<()>

Set the viewport(camera) position

pub fn set_sync(&self, enable: bool) -> Result<()>

Set session sync mode on/off

pub fn get_sync_info(&self) -> Result<SessionSyncInfo>

Get session sync info

pub fn set_sync_info(&self, info: &SessionSyncInfo) -> Result<()>

Set session sync info

pub fn get_license_type(&self) -> Result<License>

Get license type used by this session

pub fn render_cop_to_image(
    &self,
    cop_node: impl Into<NodeHandle>,
    image_planes: impl AsRef<str>,
    path: impl AsRef<Path>
) -> Result<String>

Render a COP node to an image file

pub fn render_cop_to_memory(
    &self,
    cop_node: impl Into<NodeHandle>,
    image_planes: impl AsRef<str>,
    format: impl AsRef<str>
) -> Result<Vec<i8>>

Render a COP node to a memory buffer

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Session

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for Session

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq<Session> for Session

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.