tentacletk 0.9.13

No project description provided

Tentacle: A Python3/PySide2 Marking Menu and DCC Toolkit

Tentacle is a Python3/PySide2 marking menu implemented using Qt's QStackedWidget. It is designed for use with Maya, 3ds Max, Blender, and any other DCC app that supports the PySide2 framework. It allows easy management of various user interfaces (UIs) and provides functionality related to key events and mouse interactions. This is an ongoing personal project and is currently a work in progress. At the moment, I have stopped developing for Max and Blender and am solely focused on Maya, as it proved too much of an undertaking at this stage to support all three apps, especially since I am still somewhat in the experimental stage. However, this can be easily extended to work with those apps. If you have any questions or thoughts about that, feel like collaborating on something, or anything else, just drop me message.

Design

Tentacle runs on top of uitk, a PySide2 dynamic UI loader and management package, which allows for the creation of fully-featured UI with less time and code.

Example

The following example demonstrates re-opening the last scene, renaming a material, and selecting geometry by that material.

Structure

The structure of the project is as follows:

Module	Description
tcl	Handles main GUI construction for the marking menu.
overlay	Tracks cursor position and UI hierarchy to generate paint events that overlay its parent widget.
ui	Location of the dynamic UI files.
slots	Location of the various slot modules.

Installation

Install via pip in a command line window using:

path/to/mayapy.exe -m pip install tentacletk

Usage

To launch the marking menu:

For Maya, add a macro to a hotkey similar to the following:

from tentacle import tcl_maya
tcl_maya.show(key_show='Key_Z')  # Change to match your chosen hotkey.