0.8.4

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Added field ssbh_data_py.matl_data.MatlEntryData.uv_transforms.
• Added type ssbh_data_py.matl_data.UvTransformParam.
• Added type ssbh_data_py.matl_data.UvTransform.
• Updated ssbh_data to add read and save support for version 1.5 for ssbh_data_py.matl_data.MatlData.

0.8.3

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Added field ssbh_data_py.matl_data.MatlEntryData.uv_transforms.
• Added type ssbh_data_py.matl_data.UvTransformParam.
• Added type ssbh_data_py.matl_data.UvTransform.
• Updated ssbh_data to add read and save support for version 1.5 for ssbh_data_py.matl_data.MatlData.

0.8.2

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Updated ssbh_data.
• Added support for Python 3.11 and Python 3.12 for PyPi builds.

0.8.1

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Added field ssbh_data_py.anim_data.TransformFlags.override_compensate_scale
• Updated ssbh_data to fix an issue where some compressed anims would not import/export correctly.

Breaking Changes

• Removed ssbh_data_py.anim_data.ScaleOptions
• Moved field ssbh_data_py.anim_data.ScaleOptions.compensate_scale to ssbh_data_py.anim_data.TrackData.compensate_scale
• Changed the type of ssbh_data_py.meshex_data.MeshObjectGroupData.bounding_sphere to ssbh_data_py.meshex_data.BoundingSphere

0.7.1

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Added support for nuhlpb files with the ssbh_data_py.hlpb_data submodule.
• Improved export times when using numpy arrays for mesh attribute data.
• Fixed comparison operators not working as expected for enum types. Enum variants are equal if their value field is equal.
• Fixed an issue where error types couldn't be matched on in exception handling like except ssbh_data_py.MeshDataError as e:.
• Added field ssbh_data_py.skel_data.BoneData.billboard_type of type BillboardType.
• Added field ssbh_data_py.anim_data.TrackData.transform_flags of type TransformFlags.

Breaking Changes

• Renamed ssbh_data_py.MeshExError to ssbh_data_py.MeshExDataError
• Renamed ssbh_data_py.mesh_data.MeshObjectData.sub_index to ssbh_data_py.mesh_data.MeshObjectData.subindex
• Renamed ssbh_data_py.modl_data.ModlEntryData.mesh_object_sub_index to ssbh_data_py.modl_data.ModlEntryData.mesh_object_subindex
• Adjusted matrices to use column-major order instead of row-major order.
• Renamed enum variant ssbh_data_py.matl_data.CullMode.None to ssbh_data_py.matl_data.CullMode.Disabled.

0.6.2

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Added support for numshexb files with the ssbh_data_py.meshex_data submodule.
• Improved type hints.
• Changed classes to support specifying all fields at construction with clear defaults for optional fields.
• Added support for installing from PyPi for Apple M1 processors on Python 3.9.

Breaking Changes

ssbh_data_py.mesh_data

• Removed ssbh_data_py.mesh_data.read_mesh_numpy. Use read_mesh(..., use_numpy=True) instead.

0.5.3

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes:

• Added from_str and from_value static methods to enum types.
• Improved type hints for default parameters and class attributes.
• Added ssbh_data_py.mesh_data.read_mesh_numpy. This is an experimental API and may change in future releases.

0.5.2

ssbh_data_py

See the examples and readme for sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes:

• Added support for numatb files with the ssbh_data_py.matl_data submodule.
• Improved the printed output of ssbh_data_py classes when calling repr(), str(), or print().
• Removed support for Python 3.6.

0.5.1

ssbh_data_py

See the examples and readme for up to date sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes:

• Added the sort_bias, disable_depth_write, and disable_depth_test fields to to MeshObjectData. These default to 0, False, and False.
• Types will now display as being a member of their respective module rather than a member of "builtins" when debugging objects.
• Added support for adjb files with the ssbh_data_py.adj_data submodule.
• Added scale options to TrackData. This is accessible as track.scale_options.inherit_scale and
  track.scale_options.compensate_scale.

Breaking Changes:

ssbh_data_py.anim_data

• Moved the compensate_scale field to TrackData. This now applies to all frames in the track.

v0.4.0

ssbh_data_py

See the examples and readme for up to date sample code.

Installation

The package can be installed for a supported python version using pip on the latest version of Windows, Linux, or MacOS. The prebuilt wheels (.whl files) are included only for situations where pip might not be available such as for plugin development for applications.

Installing: pip install ssbh_data_py
Updating: pip install ssbh_data_py --upgrade

Changes

• Fields and function parameters that used to only accept lists of floats or ints now accept sequences such as tuples or numpy arrays. For example, bone.transform = numpy.zeros((4,4)), mesh_object_data.vertex_indices = numpy.arange(12), and attribute_data.data = [(1,0,0), (0,1,0)] now work as expected without requiring any conversions.
• Improved the printed representation of ssbh_data_py.anim_data.Transform and ssbh_data_py.anim_data.UvTransform
• Added ssbh_data_py.mesh_data.calculate_smooth_normals and ssbh_data_py.mesh_data.calculate_tangents_vec4 functions from ssbh_data
• Fixed an issue where the 4th value of Transform.rotation would sometimes be set to NaN.
• Improved the readability of Python exceptions triggered by panics in Rust code.

Breaking Changes

ssbh_data_py.anim_data

• Renamed all UvTransform fields
• Changed the expected type from float to integer for Transform.compensate_scale
• Added the final_frame_index field to AnimData. This should be set to frame_count - 1 or 0 for empty animations.