Skip to main content

Qt window class for designing tools to be compatible between multiple VFX programs.

Project description

VFXWindow

Qt Window class for designing tools to be compatible between multiple VFX programs.

The main purpose of the class is to integrate into the program UI, but it also contains helpful features such as safely dealing with callbacks and automatically saving the window position.

The intended usage is to make your window class inherit VFXWindow - which is an instance of QMainWindow. By calling cls.show(), it will launch the correct window type based on what program is loaded, and what settings were previously saved.

This is perfectly stable, but there is still plenty that needs improvement. Any help with extending existing application support or adding new applications is very much appreciated.

Installation

pip install vfxwindow

Basic Example:

class MyWindow(VFXWindow):
    WindowID = 'unique_window_id'
    WindowName = 'My Window'

    def __init__(self, parent=None, **kwargs):
        super(MyWindow, self).__init__(parent, **kwargs)
        # Setup window here

        # Setup callbacks, but wait until the program is ready
        self.deferred(self.newScene)

    def newScene(self, *args):
        """Example: Delete and reapply callbacks after loading a new scene."""
        self.removeCallbacks('sceneNewCallbacks')
        if self.application == 'Maya':
            self.addCallbackScene('kAfterNew', self.newScene, group='sceneNewCallbacks')
        elif self.application == 'Nuke':
            self.addCallbackOnCreate(self.newScene, nodeClass='Root', group='sceneNewCallbacks')

if __name__ == '__main__':
    MyWindow.show()

Support / Compatibility

✔️ Working / ❔ Untested / ❌ Not Working

Standard Window Docked Window Callbacks Tested Versions Linux Windows MacOs
Maya ✔️ ✔️ ✔️ 2011-2016, 2017+ ✔️ ✔️
Maya (Standalone) ✔️ ✔️ ✔️
Nuke ✔️ ✔️ ✔️ 9-14 ✔️
Nuke (Terminal) ✔️ ✔️ ✔️
Houdini ✔️ 16-19 ✔️ ✔️
Unreal Engine ✔️ 4.19-4.23, 5.0-5.3 ✔️
Blender ✔️ ✔️ 2.8-3.6 ✔️
3ds Max ✔️ 2018-2020 ✔️
Substance Painter ✔️ ✔️ 8.3 ✔️ ✔️
Substance Designer ✔️ ✔️ 2019.3, 7.1, 12.3 ✔️ ✔️
Blackmagic Fusion ✔️ 9 ✔️
CryEngine Sandbox ✔️ 5.7 ✔️
Standalone Python ✔️ 2.7 (Qt4), 3.7-3.9 (Qt5) ✔️

Features

  • Automatically save/restore window position
  • Move window to screen if out of bounds (windows only)
  • Keep track of callbacks to remove groups if required, and clean up on window close
  • Keep track of signals to remove groups if required
  • Display a popup message that forces control
  • Set palette to that of another program
  • Auto close if opening a duplicate window
  • Close down all windows at once
  • Create dialog windows automatically attached to the application (and return data)

Running with Non-Python Applications

Certain Windows applications have dispatch based COM interface, which will allow a link between Python and the application. See photoshop-scripting-python for an example on how to connect to an application.

Currently there is no way of launching VFXWindow from inside these applications.

Special Thanks

Project details


Download files

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

Source Distribution

vfxwindow-1.9.0.tar.gz (57.5 kB view details)

Uploaded Source

File details

Details for the file vfxwindow-1.9.0.tar.gz.

File metadata

  • Download URL: vfxwindow-1.9.0.tar.gz
  • Upload date:
  • Size: 57.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.8

File hashes

Hashes for vfxwindow-1.9.0.tar.gz
Algorithm Hash digest
SHA256 532172130dea6c546739f4879f12ac17c012469a36e63782e3e9a91421c7568f
MD5 5dfcd0c81d2f5561ca1a2ad0888e88b9
BLAKE2b-256 e94e5480ecba3ff3f63a4687accd97ea0674df5af4192958071da6e703403dec

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