Geometry Setters

Functions
HAPI_DECL	HAPI_SetPartInfo (const HAPI_Session *session, HAPI_NodeId node_id, HAPI_PartId part_id, const HAPI_PartInfo *part_info)
	Set the main part info struct (HAPI_PartInfo). More...
HAPI_DECL	HAPI_SetFaceCounts (const HAPI_Session *session, HAPI_NodeId node_id, HAPI_PartId part_id, const int *face_counts_array, int start, int length)
	Set the array of faces where the nth integer in the array is the number of vertices the nth face has. More...
HAPI_DECL	HAPI_SetVertexList (const HAPI_Session *session, HAPI_NodeId node_id, HAPI_PartId part_id, const int *vertex_list_array, int start, int length)
	Set array containing the vertex-point associations where the ith element in the array is the point index the ith vertex associates with. More...
HAPI_DECL	HAPI_AddGroup (const HAPI_Session *session, HAPI_NodeId node_id, HAPI_PartId part_id, HAPI_GroupType group_type, const char *group_name)
	Add a group to the input geo with the given type and name. More...
HAPI_DECL	HAPI_DeleteGroup (const HAPI_Session *session, HAPI_NodeId node_id, HAPI_PartId part_id, HAPI_GroupType group_type, const char *group_name)
	Remove a group from the input geo with the given type and name. More...
HAPI_DECL	HAPI_SetGroupMembership (const HAPI_Session *session, HAPI_NodeId node_id, HAPI_PartId part_id, HAPI_GroupType group_type, const char *group_name, const int *membership_array, int start, int length)
	Set group membership. More...
HAPI_DECL	HAPI_CommitGeo (const HAPI_Session *session, HAPI_NodeId node_id)
	Commit the current input geometry to the cook engine. Nodes that use this geometry node will re-cook using the input geometry given through the geometry setter API calls. More...
HAPI_DECL	HAPI_RevertGeo (const HAPI_Session *session, HAPI_NodeId node_id)
	Remove all changes that have been committed to this geometry. If this is an intermediate result node (Edit SOP), all deltas will be removed. If it's any other type of node, the node will be unlocked if it is locked. More...

Detailed Description

Functions for setting geometry (SOP) data

Function Documentation

HAPI_DECL HAPI_AddGroup	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id,
		HAPI_PartId	part_id,
		HAPI_GroupType	group_type,
		const char *	group_name
	)

Add a group to the input geo with the given type and name.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.
[in]	part_id	Currently not used. Just pass 0.
[in]	group_type	The group type.
[in]	group_name	Name of new group to be added.

HAPI_DECL HAPI_CommitGeo	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id
	)

Commit the current input geometry to the cook engine. Nodes that use this geometry node will re-cook using the input geometry given through the geometry setter API calls.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.

HAPI_DECL HAPI_DeleteGroup	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id,
		HAPI_PartId	part_id,
		HAPI_GroupType	group_type,
		const char *	group_name
	)

Remove a group from the input geo with the given type and name.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.
[in]	part_id	Currently not used. Just pass 0.
[in]	group_type	The group type.
[in]	group_name	Name of the group to be removed

HAPI_DECL HAPI_RevertGeo	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id
	)

Remove all changes that have been committed to this geometry. If this is an intermediate result node (Edit SOP), all deltas will be removed. If it's any other type of node, the node will be unlocked if it is locked.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.

HAPI_DECL HAPI_SetFaceCounts	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id,
		HAPI_PartId	part_id,
		const int *	face_counts_array,
		int	start,
		int	length
	)

Set the array of faces where the nth integer in the array is the number of vertices the nth face has.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.
[in]	part_id	Currently not used. Just pass 0.
[in]	face_counts_array	An integer array at least the size of length.
[in]	start	First index of range. Must be at least 0 and at most HAPI_PartInfo::faceCount - 1.
[in]	length	Must be at least 0 and at most HAPI_PartInfo::faceCount - start.

HAPI_DECL HAPI_SetGroupMembership	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id,
		HAPI_PartId	part_id,
		HAPI_GroupType	group_type,
		const char *	group_name,
		const int *	membership_array,
		int	start,
		int	length
	)

Set group membership.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.
[in]	part_id	Currently not used. Just pass 0.
[in]	group_type	The group type.
[in]	group_name	The group name.
[in]	membership_array	Array of ints that represent the membership of this group. Should be the size given by HAPI_PartInfo_GetElementCountByGroupType() with group_type and the HAPI_PartInfo of part_id.
[in]	start	Start offset into the membership array. Must be less than HAPI_PartInfo_GetElementCountByGroupType().
[in]	length	Should be less than or equal to the size of membership_array. When setting edge group membership, this parameter should be set to the number of points (which are used to implictly define the edges), not to the number edges in the group.

HAPI_DECL HAPI_SetPartInfo	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id,
		HAPI_PartId	part_id,
		const HAPI_PartInfo *	part_info
	)

Set the main part info struct (HAPI_PartInfo).

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.
[in]	part_id	Currently not used. Just pass 0.
[in]	part_info	HAPI_PartInfo value that describes the input geometry.

HAPI_DECL HAPI_SetVertexList	(	const HAPI_Session *	session,
		HAPI_NodeId	node_id,
		HAPI_PartId	part_id,
		const int *	vertex_list_array,
		int	start,
		int	length
	)

Set array containing the vertex-point associations where the ith element in the array is the point index the ith vertex associates with.

Parameters

[in]	session	The session of Houdini you are interacting with. See Sessions for more on sessions. Pass NULL to just use the default in-process session.
[in]	node_id	The SOP node id.
[in]	part_id	Currently not used. Just pass 0.
[in]	vertex_list_array	An integer array at least the size of length.
[in]	start	First index of range. Must be at least 0 and at most HAPI_PartInfo::vertexCount - 1.
[in]	length	Must be at least 0 and at most HAPI_PartInfo::vertexCount - start.