Skip to main content

The Blur Studio Simplex Blendshape Combination System

Project description

SIMPLEX UI


Example Simplex UI


For Artitsts

Simplex aims to provide an intuitive, cross-package UI that allows for building, editing, and controlling complex shapes, combos, and transitions for use in high-end blendshape facial rigs, or even PSD systems.

This tool was built with the full Facial Action Coding System (FACS) in mind. As such, it easily handles hundreds of shapes with arbitrary combo depth. Spline interpolation for in-between shapes, positive-negative shapes, in-between combo shapes, and combo transitions are supported. Arbitrary value combinations are also fully supported (eg. ComboX activates when SliderA is at 0.25 and SliderB is at 0.33).

For TD's

Simplex aims to be fully scriptable so that it can easily be inserted into any pipeline. The UI and API are fully Python, all content creation commands are abstracted (for multi-package and external use), and all systems are built as human readable JSON strings.

There is a suite of tools included that allow for manipulating .smpx files. Most of which can be run completely outside of a DCC. This includes vertex reordering, un-subdividing, splitting, and even shape-inversion. These .smpx files are nothing more than specially structured alembic caches

As long as your package supports Plugins, Python, and Qt (or PySide), you can use Simplex.

Simplex is NOT

  • Simplex is not a modeling toolkit
    • Modeling is done using whatever tools you choose on your current package
  • Simplex is not a deformer
    • It only informs a native blendshape deformer what values the current shapes should have
    • In the future, I do have ideas for building an interface to an advanced deformer for dynamically previewing arbitrary splits, but the final output will always have the ability to bake down to a basic blendshape.

Basic Usage

Follow this youtube link to a basic walkthrough of Simplex usage. This video highlights a slightly older version of Simplex, but the interaction remains basically the same. https://www.youtube.com/watch?v=LQwzsxU8z_Q

Easy Installation

  1. Download this file to your computer. Make sure it's saved as a python file.
  2. Drag/drop the python file into a freshly opened instance of Maya (make sure all other mayas are closed). A command prompt window may open for a couple seconds. This is normal.
  3. If you have multiple Maya versions installed, repeat step 2 for those versions as well. This just ensures that numpy and Qt.py are installed for those versions.
  4. Create a python shelf button with this script.
from simplexui import runSimplexUI
runSimplexUI()

Updating

  1. Download this file to your computer. Make sure it's saved as a python file.
  2. Drag/drop the python file into a freshly opened instance of Maya (make sure all other mayas are closed). A command prompt window may open for a couple seconds. This is normal.
  3. If you have multiple Maya versions installed, you do NOT have to repeat step 2 for all of them.

Manual Installation

  1. Download the simplex-v*.*.*.zip file from the latest release
  2. Create a modules folder in your maya user directory. For example, on Windows, that would mean creating C:\Users\<your-username>\Documents\maya\modules
  3. Copy the simplex.mod file and the simplex folder into that directory.
  4. Install numpy and Qt.py to mayapy using pip. For example, on Windows, once you're in the right place the command will be mayapy -m pip install numpy Qt.py. You will need admin privelages for this.
  5. Run these two Python commands in Maya to start the tool. (This is probably what you should put into a shelf button)
from simplexui import runSimplexUI
runSimplexUI()

Uninstalling

  1. Delete the simplex.mod file and the simplex folder from the modules folder in your maya user directory. For example, on Windows, that would mean deleting C:\Users\<your-username>\Documents\maya\modules\simplex.mod and C:\Users\<your-username>\Documents\maya\modules\simplex

Compiling

Hopefully you don't need to do this, but if you have to, just take a look at .github/workflows/main.yml and you should be able to piece together how to get a compile working using CMake. You aren't required to download the devkit or set its path for CMake if you've got maya installed on your machine. Also note, I use features from CMake 3.16+ so I can target python 2 and 3 separately.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

simplex_solver-3.0.18-39-abi3-macosx_12_0_arm64.whl (388.6 kB view details)

Uploaded macOS 12.0+ ARM64

simplex_solver-3.0.18-37-abi3-win_amd64.whl (388.0 kB view details)

Uploaded Windows x86-64

simplex_solver-3.0.18-37-abi3-manylinux_2_17_x86_64.whl (407.9 kB view details)

Uploaded manylinux: glibc 2.17+ x86-64

File details

Details for the file simplex_solver-3.0.18-39-abi3-macosx_12_0_arm64.whl.

File metadata

File hashes

Hashes for simplex_solver-3.0.18-39-abi3-macosx_12_0_arm64.whl
Algorithm Hash digest
SHA256 dc46b5b7c0b6e118fa4d1408dc9c06faced1b955d47470fd877da9a41e7cd29f
MD5 945c64eb39b615c3c76ff4c380d77e79
BLAKE2b-256 db36a1ca1ad119811a0c8ff0a87c470abe10750d47862f15d8b8106585cb4a6d

See more details on using hashes here.

File details

Details for the file simplex_solver-3.0.18-37-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for simplex_solver-3.0.18-37-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 d8033bafdc41cc383323293bff9bb4898c3fd14e00a4d79f41164c9796df200a
MD5 5ab2e6698117698f44a000ac97e04796
BLAKE2b-256 36f71d300b97c7dc9ea114c469475e8b1f228e00bf89a52cb4a28870674307f8

See more details on using hashes here.

File details

Details for the file simplex_solver-3.0.18-37-abi3-manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for simplex_solver-3.0.18-37-abi3-manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 39fc45f171fe2c4a79ce9f4ae73896158d45362273229fc16ed966a0a09783a3
MD5 7486b0402dd7365acf3b6895c9288f54
BLAKE2b-256 c62820619a01cfe67c0abd62de533ad665ca45b35f772fe0ea6783c2a315ad04

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page