¶Input & Output

In adn.scripts.houdini.adnio module, a set of Python functions are provided to allow users to:

• Gather the AdonisFX nodes setup from the scene.
• Clear the scene by removing all AdonisFX nodes and dependent nodes.
• Build the AdonisFX setup in the scene from a dictionary.
• Import AdonisFX setup from a JSON file.
• Export AdonisFX setup into a JSON file.

In the following sections, we provide a brief overview of how to use the utilities provided in this Python module.

¶Gather Data

To gather all AdonisFX nodes from the scene and store their setup into a dictionary, run this command in Python:

from adn.scripts.houdini import adnio
data = adnio.gather_from_scene(enabled_features, context)

The argument enabled_features is optional and it is a dictionary where keys are feature names (i.e. AdonisFX solver nodes and other util nodes) and values are flags to determine if a feature has to be gathered or bypassed. If this is not provided, all features will be gathered.

The second argument context is optional and it is the path to the geometry node where the AdonisFX rig should be gathered from (i.e. /obj/geo1). If the argument is not provided, the rig will be gathered from the first found active geometry node in /obj.

from adn.utils.constants import IOFeaturesData
enabled_features = {
    IOFeaturesData.SENSOR: True,
    IOFeaturesData.ACTIVATION: True,
    IOFeaturesData.MUSCLE: True,
    IOFeaturesData.GLUE: True,
    IOFeaturesData.SKIN: True,
    IOFeaturesData.FAT: True,
    IOFeaturesData.RELAX: True,
    IOFeaturesData.PUSH: True,
    IOFeaturesData.SKIN_MERGE: True,
    IOFeaturesData.SIMSHAPE: True,
    IOFeaturesData.EDGE_EVALUATOR: True,
    IOFeaturesData.REMAP: True
}
context = "/obj/geo1"

¶Clear All

To clear all AdonisFX related nodes from the scene, run the command below in Python. This is useful for when AdonisFX data has to be imported onto a clean version of the rig.

from adn.scripts.houdini import adnio
adnio.clear_scene()

¶Build

To build an AdonisFX setup in Python, it is required to provide the setup information in dictionary format. This dictionary data can be the value returned by the function gather_from_scene or the result of loading a JSON file exported previously with the function export_data. The code to build the AdonisFX setup is:

from adn.scripts.houdini import adnio
adnio.build_from_data(data, enabled_features, context)

The first argument data is required and it is the dictionary with the mapped data. The second argument enabled_features is optional and corresponds to a dictionary where keys are feature names and values are flags to determine if a feature has to be built or bypassed (same format used for gathering data). The third argument context is optional and corresponds to the path to the geometry node where the AdonisFX rig should be built. If it is not provided, the rig will be built into the first found active geometry node in /obj.

¶Import

To import an AdonisFX setup from a JSON file, run the command below:

from adn.scripts.houdini import adnio
file_path = "path/to/source/file.json"
adnio.import_data(file_path, enabled_features)

The first argument file_path is required and it is the full path to the JSON file containing a valid AdonisFX setup definition. The second argument enabled_features is optional and corresponds to a dictionary where keys are feature names and values are flags to determine if a feature has to be imported or bypassed (same format used for gathering data).

Find more information about the use of the import feature in the Import page.

¶Export

To export the AdonisFX setup in the current scene into a file, run this command:

from adn.scripts.houdini import adnio
file_path = "path/to/destination/file.json"
adnio.export_data(file_path, enabled_features)

The first argument file_path is required and it is the full path to the JSON file to export the data into. The second argument enabled_features is optional and corresponds to a dictionary where keys are feature names and values are flags to determine if a feature has to be exported or bypassed (same format used for gathering data).

Find more information about the use of the export feature in the Export page.

¶Limitations

• The adnio scripts do not support subnetworks inside of the Geometry context. This means that all AdonisFX SOP nodes (and any other SOP nodes containing geometry required by the AdonisFX rig) must exist at the same level within the Geometry context (e.g., /obj/geo1).
• Only one active geometry node (with the visibility/display flag enabled) in the /obj context is allowed for the adnio scripts to work.
• Nodes used to drive attachment to transform or slide on segment constraints (e.g. null, joint or rivet nodes) must live in the /obj context.
• KineFX joint transforms are not supported.