This project is used to generate Docker images which can be used to run hython with the goal of performing automated testing with processes such as GitHub Actions.
Use of these images is subject to the terms and conditions of the SIDE EFFECTS SOFTWARE LICENSE AGREEMENT. By using these images, you agree to abide by all the terms and conditions as described in the SIDE EFFECTS SOFTWARE LICENSE AGREEMENT
Each image for a particular build of Houdini provides versions of related tools matching those of the VFX Platform.
Currently, all images provided are created using the default build of Houdini, which means libraries that match those of the VFX Platform year, and not builds with alternative Python or GCC versions.
| Houdini Version | Linux Image | VFX Platform Year | Python Version | GCC Version |
|---|---|---|---|---|
| 20.5 | ubuntu:mantic | 2024 | 3.11 | 11.2 |
| 20.0 | ubuntu:jammy | 2023 | 3.10 | 11.2 |
| 19.5 | ubuntu:focal | 2022 | 3.9 | 9.3 |
The following notable system packages are installed:
- git - Available to allow you to check out code required for testing
- gcc / cmake / build related packages - Packages related to C++ compilation are included to enable building HDK plugins.
- nodejs - Node.js (v20) is installed to facilitate various GitHub Action workflows which rely on it.
The Houdini build is installed to the standard /opt/hfs{version} location, along with the {major.minor} symlink:
$ ls -l /opt/
... hfs19.5 -> /opt/hfs19.5.805
... hfs19.5.805Houdini command line tool locations ($HFS/bin, $HFS/houdini/sbin) are included in $PATH, however the only Houdini specific
environment variable defined is $HFS. Other variables defined in the houdini_setup* files ($HB, $HT, etc.) are not set.
If you need any of these, it is recommended to explicitly source the setup file.
The hython-runner containers do not have any Houdini licensing set up which means that Houdini related programs
which require a license will not function by default. You are responsible for configuring your own licensing
setup.
It should be possible to compile HDK plugins right out of the box, using either hcustom or cmake.
The CMAKE_PREFIX_PATH variable is defined and pointing to the $HT/cmake directory such that if you are using cmake
to compile HDK plugins, it will be able to find the Houdini config without additional setup.
The rez package manager is also available for workflows which use it. A number of already bound or installed packages which are designed to help facilitate testing.
- houdini
- cmake
- gcc
- python