# 项目目标 我想做一个Maya的Metahuman自定义的插件， 语言：基于Python Maya版本：2022, 2023, 2024, 2025 ## 项目描述 本项目是一个Maya插件，主要功能是提供与MetaHuman相同拓扑的模型或者自定义的3d模型以来完成自定义绑定，编辑DNA，校准骨骼位置，保存DNA，载入DNA，导出fbx，保存DNA文件, 编辑BlendShape,等功能。 ## 这个插件主要功能： 提供与MetaHuman相同拓扑的模型或者自定义的3d模型以来完成自定义绑定，编辑DNA，校准骨骼位置，保存DNA，载入DNA，导出fbx，保存DNA文件, 编辑BlendShape,等功能。 ## 注意Reference路径不参与参见功能实现，只作为参考。Reference只作为参考，可以从中拷贝必要的文件到当前项目中 ## 代码实现： 根据Maya和Python版本来获取plugin的路径，并尽可能使用PySide编写UI，要保证PySide的通用性，使用单独的ccs文件来定义定义样式。 根据Maya不同的版本来定义PySide的UI定义，版本通用性参考MSLiveLink。 ## 参考代码： DNA\_Calibration中主要参考DNA编辑等功能更，SuperRigigng主要参考UI样式并获取对应的功能的实现逻辑，MSLiveLink主要参开DNA编辑和文件处理方式。 ## 产品功能对标： DNA Calibration Document : https://epicgames.github.io/MetaHuman-DNA-Calibration/index.html MetaHuman-DNA-Calibration 代码：https://github.com/EpicGames/MetaHuman-DNA-Calibration SuperRigging：https://docs.pointart.net/ AnimCraft：https://geekdaxue.co/read/animcraft@cn/ ## 代码初始结构： . ├── config │ └── \_\_init\_\_.py │ └── data.py ├── plugins │ └── Linux │ │ ├── 2022 │ │ │ ├── \_py3dnacalib.so │ │ │ ├── dnacalib.py │ │ │ ├── libdnacalib.so.6 │ │ │ ├── libembeddedRL4.so │ │ │ ├── libembeddedRL4.so.8 │ │ │ ├── libembeddedRL4.so.8.0.8 │ │ │ ├── MayaUE4RBFPlugin2022.mll │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── 2023 │ │ │ ├── \_py3dnacalib.so │ │ │ ├── dnacalib.py │ │ │ ├── libdnacalib.so.6 │ │ │ ├── libembeddedRL4.so │ │ │ ├── libembeddedRL4.so.8 │ │ │ ├── libembeddedRL4.so.8.0.8 │ │ │ ├── MayaUE4RBFPlugin2023.mll │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── 2024 │ │ │ ├── \_py3dnacalib.so │ │ │ ├── dnacalib.py │ │ │ ├── libdnacalib.so.6 │ │ │ ├── libembeddedRL4.so │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── 2025 │ │ │ ├── \_py3dnacalib.so │ │ │ ├── dnacalib.py │ │ │ ├── embeddedRL4.so │ │ │ ├── libdnacalib.so.6 │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── pydna │ │ │ ├── python3 │ │ │ │ ├── \_py3dna.so │ │ │ │ ├── dna.py │ │ │ │ ├── libdna.so.7.1.0 │ │ │ ├── python311 │ │ │ │ ├── \_py3dna.so │ │ │ │ ├── dna.py │ │ │ │ ├── libdna.so.7 │ │ │ ├── python397 │ │ │ │ ├── \_py3dna.so │ │ │ │ ├── dna.py │ │ │ │ ├── libdna.so.7.1.0 │ │ │ ├── python3108 │ │ │ │ ├── \_py3dna.so │ │ │ │ ├── dna.py │ │ │ │ ├── libdna.so.7.1.0 │ └── Windows │ │ ├── 2022 │ │ │ ├── \_py3dnacalib.pyd │ │ │ ├── dnacalib.dll │ │ │ ├── dnacalib.py │ │ │ ├── embeddedRL4.mll │ │ │ ├── MayaUE4RBFPlugin2022.mll │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── 2023 │ │ │ ├── \_py3dnacalib.pyd │ │ │ ├── dnacalib.dll │ │ │ ├── dnacalib.py │ │ │ ├── embeddedRL4.mll │ │ │ ├── MayaUE4RBFPlugin2023.mll │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── 2024 │ │ │ ├── \_py3dnacalib.pyd │ │ │ ├── dnacalib.dll │ │ │ ├── dnacalib.py │ │ │ ├── embeddedRL4.mll │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── 2025 │ │ │ ├── \_py3dnacalib.pyd │ │ │ ├── dnacalib.dll │ │ │ ├── dnacalib.py │ │ │ ├── embeddedRL4.mll │ │ │ ├── MayaUERBFPlugin.mll │ │ ├── pydna │ │ │ ├── python3 │ │ │ │ ├── \_py3dna.pyd │ │ │ │ ├── dna.dll │ │ │ │ ├── dna.py │ │ │ ├── python311 │ │ │ │ ├── \_py3dna.pyd │ │ │ │ ├── \_py3dna9\_4\_3.pyd │ │ │ │ ├── dna.dll │ │ │ │ ├── dna.py │ │ │ │ ├── dna9\_4\_3.dll │ │ │ │ ├── polyalloc1\_3\_12.dll │ │ │ │ ├── statuscode1\_2\_6.dll │ │ │ │ ├── trio4\_0\_16.dll │ │ │ ├── python397 │ │ │ │ ├── \_py3dna.pyd │ │ │ │ ├── dna.dll │ │ │ │ ├── dna.py │ │ │ ├── python3108 │ │ │ │ ├── \_py3dna.pyd │ │ │ │ ├── dna.dll │ │ │ │ ├── dna.py │ │ │ ├── \_\_init\_\_.py ├── resources │ ├── icons │ │ ├── ARKit52.png │ │ ├── automatic\_grouping.png │ │ ├── backward.png │ │ ├── behaviour.png │ │ ├── blendRaw.png │ │ ├── blendShape\_current.png │ │ ├── blendShape.png │ │ ├── change\_password.png │ │ ├── chinese.png │ │ ├── clone\_blendShape.png │ │ ├── clothing\_weight.png │ │ ├── color.png │ │ ├── CommandButton.png │ │ ├── configuration.png │ │ ├── connect.png │ │ ├── controller.png │ │ ├── copy\_skin.png │ │ ├── copy.png │ │ ├── create\_body\_ctrl.png │ │ ├── create\_lod.png │ │ ├── ctrl\_hide.png │ │ ├── definition.png │ │ ├── delete.png │ │ ├── detector.png │ │ ├── disconnect.png │ │ ├── english.png │ │ ├── exit.png │ │ ├── export\_skin.png │ │ ├── export.png │ │ ├── expression.png │ │ ├── expressions\_blend.png │ │ ├── expressions\_current.png │ │ ├── expressions.png │ │ ├── forward.png │ │ ├── help.png │ │ ├── import\_body\_anim.png │ │ ├── import\_face\_anim.png │ │ ├── import\_skin.png │ │ ├── import.png │ │ ├── joint.png │ │ ├── load\_meshes.png │ │ ├── loading.png │ │ ├── locator.png │ │ ├── lock.png │ │ ├── mark.png │ │ ├── meshes.png │ │ ├── message.png │ │ ├── MetaFusionLogo.png │ │ ├── mirror.png │ │ ├── mirrorL.png │ │ ├── mirrorR.png │ │ ├── motion\_apply.png │ │ ├── open\_camera.png │ │ ├── open.png │ │ ├── pause.png │ │ ├── play.png │ │ ├── plus.png │ │ ├── pose\_A\_To\_T.png │ │ ├── pose\_T\_To\_A.png │ │ ├── presets.png │ │ ├── psd.png │ │ ├── rebuildTargets.png │ │ ├── reduce.png │ │ ├── rename.png │ │ ├── repair\_normals.png │ │ ├── repair\_vertex\_order.png │ │ ├── reset.png │ │ ├── resetname.png │ │ ├── return.png │ │ ├── save\_new.png │ │ ├── save.png │ │ ├── search.png │ │ ├── set\_current.png │ │ ├── set\_no.png │ │ ├── set\_ok.png │ │ ├── set\_range.png │ │ ├── settings.png │ │ ├── standardized\_naming.png │ │ ├── stop.png │ │ ├── supplement\_meshes.png │ │ ├── symmetry.png │ │ ├── target.png │ │ ├── transfer\_maps.png │ │ ├── unmark\_all.png │ │ ├── unreal.png │ │ ├── update.png │ │ ├── user\_login.png │ │ ├── visible.png │ │ ├── warning.png │ ├── styles │ │ ├── style.qss ├── scripts │ ├── ui │ ├── MetaFusion.py ├── CleanPycache.bat ├── Install.mel ├── Install.py ├── README.md ## 重要代码内容： ├── Install.mel ```Python global proc install() { string $scriptPath = `whatIs install`; string $dirPath = `substring $scriptPath 25 (size($scriptPath))`; $dirPath = `dirname $dirPath`; string $pythonPath = $dirPath + "/Install.py"; $pythonPath = substituteAllString($pythonPath, "\\", "/"); string $pythonCmd = "import os, sys\n"; $pythonCmd += "INSTALL_PATH = r'" + $pythonPath + "'\n"; $pythonCmd += "sys.path.append(os.path.dirname(INSTALL_PATH))\n"; $pythonCmd += "import Install\n"; $pythonCmd += "Install.main()\n"; python($pythonCmd); } install(); ``` ├── Install.py ```Python #!/usr/bin/env python # -*- coding: utf-8 -*- #===================================== 1. Module Imports ===================================== # Standard library imports import os import sys import webbrowser # Maya imports import maya.mel as mel import maya.cmds as cmds import maya.OpenMayaUI as omui # Qt imports from PySide2 import QtWidgets, QtGui, QtCore from shiboken2 import wrapInstance # Custom imports from config import data QtCore, QtGui, QtWidgets = data.Qt() #===================================== 2. Global Variables ===================================== ROOT_PATH = data.ROOT_PATH TOOL_NAME = data.TOOL_NAME TOOL_VERSION = data.TOOL_VERSION TOOL_AUTHOR = data.TOOL_AUTHOR TOOL_LANG = data.TOOL_LANG TOOL_WSCL_NAME = data.TOOL_WSCL_NAME TOOL_HELP_URL = data.TOOL_HELP_URL SCRIPTS_PATH = data.SCRIPTS_PATH ICONS_PATH = data.ICONS_PATH TOOL_MAIN_SCRIPT = data.TOOL_MAIN_SCRIPT TOOL_MOD_FILENAME = data.TOOL_MOD_FILENAME TOOL_ICON = data.TOOL_ICON TOOL_COMMAND_ICON = data.TOOL_COMMAND_ICON #===================================== 3. Utility Functions ===================================== def maya_main_window(): """Get Maya main window as QWidget""" main_window_ptr = omui.MQtUtil.mainWindow() return wrapInstance(int(main_window_ptr), QtWidgets.QWidget) def ensure_directory(directory_path): """Ensure directory exists, create if not""" if not os.path.exists(directory_path): os.makedirs(directory_path) print(f"Created directory: {directory_path}") return directory_path def get_maya_modules_dir(): """Get Maya modules directory path""" maya_app_dir = cmds.internalVar(userAppDir=True) return ensure_directory(os.path.join(maya_app_dir, "modules")) #===================================== 4. UI Component Classes ===================================== class SetButton(QtWidgets.QPushButton): """Custom styled button for installation interface""" def __init__(self, text): super(SetButton, self).__init__(text) #===================================== 5. Main Window Class ===================================== class InstallDialog(QtWidgets.QDialog): def __init__(self, parent=maya_main_window()): super(InstallDialog, self).__init__(parent) self.load_stylesheet() self.setup_ui() def load_stylesheet(self): """加载 QSS 样式文件""" try: style_file = data.TOOL_STYLE_FILE if os.path.exists(style_file): with open(style_file, 'r') as f: self.setStyleSheet(f.read()) else: print(f"Warning: Style file not found: {style_file}") except Exception as e: print(f"Error loading stylesheet: {e}") def setup_ui(self): """Initialize and setup UI components""" self.setWindowTitle(f"{TOOL_NAME} Installation") self.setFixedSize(220, 120) self.setup_window_icon() self.create_widgets() self.create_layouts() self.create_connections() def setup_window_icon(self): """Setup window icon if available""" if os.path.exists(TOOL_ICON): self.setWindowIcon(QtGui.QIcon(TOOL_ICON)) else: print(f"Warning: Icon file not found: {TOOL_ICON}") #----------------- 5.1 UI Methods ----------------- def create_widgets(self): self.new_shelf_toggle = QtWidgets.QCheckBox(f"{TOOL_NAME} Installation") self.install_button = SetButton("Install " + TOOL_NAME) self.uninstall_button = SetButton("Uninstall " + TOOL_NAME) def create_layouts(self): main_layout = QtWidgets.QVBoxLayout(self) main_layout.setContentsMargins(10, 2, 10, 5) main_layout.setSpacing(5) header_layout = QtWidgets.QHBoxLayout() header_layout.setSpacing(5) welcome_label = QtWidgets.QLabel("Welcome to " + TOOL_NAME + "!") welcome_label.setStyleSheet("font-size: 11px; padding: 0px; margin: 0px;") header_layout.addWidget(welcome_label) header_layout.addStretch() main_layout.addLayout(header_layout) main_layout.addWidget(self.install_button) main_layout.addWidget(self.uninstall_button) self.install_button.setFixedHeight(30) self.uninstall_button.setFixedHeight(30) def create_connections(self): self.install_button.clicked.connect(self.install) self.uninstall_button.clicked.connect(self.uninstall) def create_styled_message_box(self, title, text): msg_box = QtWidgets.QMessageBox(self) msg_box.setWindowTitle(title) msg_box.setText(text) msg_box.setStandardButtons(QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No) msg_box.setStyleSheet(self.styleSheet()) return msg_box #----------------- 5.2 Event Handler Methods ----------------- def event(self, event): if event.type() == QtCore.QEvent.EnterWhatsThisMode: QtWidgets.QWhatsThis.leaveWhatsThisMode() self.open_help_url() return True return QtWidgets.QDialog.event(self, event) def closeEvent(self, event): """Handle window close event""" try: super(InstallDialog, self).closeEvent(event) except Exception as e: print(f"Error closing window: {e}") event.accept() def helpEvent(self, event): self.open_help_url() event.accept() #----------------- 5.3 Utility Methods ----------------- def open_help_url(self): webbrowser.open(TOOL_HELP_URL) QtWidgets.QApplication.restoreOverrideCursor() def get_script_path(self): maya_script = mel.eval('getenv("MAYA_SCRIPT_NAME")') if maya_script and os.path.exists(maya_script): return os.path.dirname(maya_script) for sys_path in sys.path: install_path = os.path.join(sys_path, "install.py") if os.path.exists(install_path): return os.path.dirname(install_path) return os.getcwd() #----------------- 5.4 Installation Methods ----------------- def install(self): """Handle install request with error handling""" if not self._validate_paths(): return msg_box = self.create_styled_message_box( "Confirm Installation", f"Are you sure you want to install {TOOL_NAME}?" ) if msg_box.exec_() == QtWidgets.QMessageBox.Yes: try: self.install_tool() self.close() except Exception as e: error_msg = f"Error during installation: {e}" print(error_msg) QtWidgets.QMessageBox.critical(self, "Error", error_msg) def uninstall(self, *args): """Handle uninstall request""" msg_box = self.create_styled_message_box( "Confirm Uninstallation", f"Are you sure you want to uninstall {TOOL_NAME}?" ) if msg_box.exec_() == QtWidgets.QMessageBox.Yes: try: self.uninstall_tool() self.close() except Exception as e: error_msg = f"Error during uninstallation: {e}" print(error_msg) QtWidgets.QMessageBox.critical(self, "Error", error_msg) else: print("Uninstallation cancelled") def create_mod_file(self): """Create or update the .mod file for Maya""" modules_dir = get_maya_modules_dir() mod_content = f"""+ {TOOL_NAME} {TOOL_VERSION} {ROOT_PATH} scripts: {SCRIPTS_PATH} """ mod_file_path = os.path.join(modules_dir, TOOL_MOD_FILENAME) self._write_mod_file(mod_file_path, mod_content) def _write_mod_file(self, file_path, content): """Helper method to write .mod file""" try: with open(file_path, "w") as f: f.write(content) print(f"Successfully created/updated: {file_path}") except Exception as e: error_msg = f"Error writing .mod file: {e}" print(error_msg) QtWidgets.QMessageBox.critical(self, "Error", error_msg) def uninstall_mod_file(self): modules_dir = get_maya_modules_dir() mod_file_path = os.path.join(modules_dir, TOOL_MOD_FILENAME) if os.path.exists(mod_file_path): try: os.remove(mod_file_path) print(f"{TOOL_NAME}.mod file deleted") except Exception as e: print(f"Error deleting {TOOL_NAME}.mod file: {e}") def clean_existing_buttons(self): if cmds.shelfLayout(TOOL_NAME, exists=True): buttons = cmds.shelfLayout(TOOL_NAME, query=True, childArray=True) or [] for btn in buttons: if cmds.shelfButton(btn, query=True, exists=True): label = cmds.shelfButton(btn, query=True, label=True) if label == TOOL_NAME: cmds.deleteUI(btn) print(f"Deleted existing {TOOL_NAME} button: {btn}") def install_tool(self): """Install the tool to Maya""" if not os.path.exists(SCRIPTS_PATH): print(f"Error: Scripts path does not exist: {SCRIPTS_PATH}") return if not os.path.exists(TOOL_MAIN_SCRIPT): print(f"Error: Main script file not found: {TOOL_MAIN_SCRIPT}") return # Add scripts path to Python path if SCRIPTS_PATH not in sys.path: sys.path.insert(0, SCRIPTS_PATH) # Create shelf and button self._create_shelf_button() self.create_mod_file() # Switch to the newly created shelf try: cmds.shelfTabLayout("ShelfLayout", edit=True, selectTab=TOOL_NAME) print(f"Switched to {TOOL_NAME} shelf") except Exception as e: print(f"Error switching to {TOOL_NAME} shelf: {e}") self._show_install_success_message() def _create_shelf_button(self): """Create shelf button for the tool""" shelf_layout = mel.eval('$tmpVar=$gShelfTopLevel') # Create shelf if not exists if not cmds.shelfLayout(TOOL_NAME, exists=True): cmds.shelfLayout(TOOL_NAME, parent=shelf_layout) # Clean existing buttons self.clean_existing_buttons() # Create new button icon_path = TOOL_ICON if os.path.exists(TOOL_ICON) else TOOL_COMMAND_ICON command = self._get_shelf_button_command() cmds.shelfButton( parent=TOOL_NAME, image1=icon_path, label=TOOL_NAME, command=command, sourceType="python", annotation=f"{TOOL_NAME} {TOOL_VERSION}", noDefaultPopup=True, style="iconOnly" ) def _get_shelf_button_command(self): """Get the command string for shelf button""" return f""" import sys import os SCRIPTS_PATH = r'{SCRIPTS_PATH}' if SCRIPTS_PATH not in sys.path: sys.path.insert(0, SCRIPTS_PATH) os.chdir(SCRIPTS_PATH) try: import {TOOL_NAME} {TOOL_NAME}.show() except ImportError as e: print("Error importing {TOOL_NAME}:", str(e)) print("Scripts path:", SCRIPTS_PATH) print("sys.path:", sys.path) print("Contents of Scripts folder:", os.listdir(SCRIPTS_PATH)) """ def uninstall_tool(self): """Uninstall the tool from Maya""" window_name = f"{TOOL_NAME}Window" dock_name = f"{TOOL_NAME}WindowDock" shelf_file = f"shelf_{TOOL_NAME}.mel" if cmds.window(window_name, exists=True): try: cmds.deleteUI(window_name) except Exception as e: print(f"Error closing {TOOL_NAME} window: {e}") if cmds.dockControl(dock_name, exists=True): try: cmds.deleteUI(dock_name) except Exception as e: print(f"Error closing docked {TOOL_NAME} window: {e}") self.uninstall_mod_file() # Get the current shelf before removing it current_shelf = cmds.shelfTabLayout("ShelfLayout", query=True, selectTab=True) # Delete Shelves and Buttons if cmds.shelfLayout(TOOL_NAME, exists=True): try: cmds.deleteUI(TOOL_NAME, layout=True) except Exception as e: print(f"Error deleting {TOOL_NAME} shelf: {e}") self._clean_all_shelf_buttons() # Remove from Python path if SCRIPTS_PATH in sys.path: sys.path.remove(SCRIPTS_PATH) # Deleting Shelf Files shelf_path = os.path.join( cmds.internalVar(userAppDir=True), cmds.about(version=True), "prefs", "shelves", f"shelf_{TOOL_NAME}.mel" ) if os.path.exists(shelf_path): try: os.remove(shelf_path) except Exception as e: print(f"Error deleting shelf file: {e}") # If the current tool shelf is a deleted tool shelf, switch to another tool shelf if current_shelf == TOOL_NAME: shelves = cmds.shelfTabLayout("ShelfLayout", query=True, childArray=True) if shelves and len(shelves) > 0: cmds.shelfTabLayout("ShelfLayout", edit=True, selectTab=shelves[0]) self._show_uninstall_success_message() def _clean_all_shelf_buttons(self): """Clean up all shelf buttons related to the tool""" all_shelves = cmds.shelfTabLayout("ShelfLayout", query=True, childArray=True) or [] for shelf in all_shelves: shelf_buttons = cmds.shelfLayout(shelf, query=True, childArray=True) or [] for btn in shelf_buttons: if cmds.shelfButton(btn, query=True, exists=True): if cmds.shelfButton(btn, query=True, label=True) == TOOL_NAME: cmds.deleteUI(btn) def _show_uninstall_success_message(self): """Show uninstallation success message""" msg_box = QtWidgets.QMessageBox() msg_box.setWindowTitle("Uninstallation Successful") msg_box.setText(f"{TOOL_NAME} has been successfully uninstalled!") msg_box.setStandardButtons(QtWidgets.QMessageBox.Ok) msg_box.setWindowIcon(QtGui.QIcon(TOOL_ICON)) msg_box.setStyleSheet(self.styleSheet()) msg_box.exec_() def _show_install_success_message(self): msg_box = QtWidgets.QMessageBox() msg_box.setWindowTitle("Installation Successful") msg_box.setText(f"{TOOL_NAME} has been successfully installed!") msg_box.setStandardButtons(QtWidgets.QMessageBox.Ok) msg_box.setWindowIcon(QtGui.QIcon(TOOL_ICON)) msg_box.setStyleSheet(self.styleSheet()) msg_box.exec_() def _validate_paths(self): """Validate all required paths exist""" paths = { "Root": ROOT_PATH, "Scripts": SCRIPTS_PATH, "Icons": ICONS_PATH } for name, path in paths.items(): if not os.path.exists(path): error_msg = f"Error: {name} path does not exist: {path}" print(error_msg) QtWidgets.QMessageBox.critical(self, "Error", error_msg) return False return True def _log(self, message, error=False): """Log messages with timestamp""" from datetime import datetime timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") log_message = f"[{timestamp}] {message}" print(log_message) if error: QtWidgets.QMessageBox.critical(self, "Error", message) def _load_mel_shelf(self): """Load mel shelf file with error handling""" try: mel.eval(f'loadNewShelf "shelf_{TOOL_NAME}.mel"') except Exception as e: self._log(f"Error loading shelf file: {e}", error=True) #===================================== 6. Main Function ===================================== def main(): """Main entry point for the installer""" try: dialog = InstallDialog() dialog.show() except Exception as e: print(f"Error launching installer: {e}") return -1 return dialog if __name__ == "__main__": main() ``` │ ├── styles │ │ ├── style.qss ```Python /* 全局 QPushButton 样式 */ QPushButton { background-color: #D0D0D0; color: #303030; border-radius: 10px; padding: 5px; font-weight: bold; min-width: 80px; } QPushButton:hover { background-color: #E0E0E0; } QPushButton:pressed { background-color: #C0C0C0; } /* 单独的消息按钮样式（可选） */ .messageButton { background-color: #B0B0B0; color: #303030; border-radius: 10px; padding: 5px; font-weight: bold; min-width: 80px; } .messageButton:hover { background-color: #C0C0C0; } .messageButton:pressed { background-color: #A0A0A0; } /* MetaFusion 深色主题样式 */ /* 主窗口样式 */ QMainWindow { background-color: #333333; color: #CCCCCC; } /* 菜单栏样式 */ QMenuBar { background-color: #333333; color: #CCCCCC; border-bottom: 1px solid #222222; } QMenuBar::item { background-color: transparent; padding: 4px 8px; } QMenuBar::item:selected { background-color: #444444; } /* 工具栏样式 */ QToolBar { background-color: #333333; border: none; padding: 3px; } QToolButton { background-color: transparent; border: 1px solid transparent; border-radius: 2px; padding: 4px; margin: 1px; } QToolButton:hover { background-color: #444444; border: 1px solid #555555; } /* 标签页样式 */ QTabWidget::pane { border: 1px solid #222222; background-color: #333333; } QTabBar::tab { background-color: #2A2A2A; color: #CCCCCC; padding: 5px 10px; border: 1px solid #222222; min-width: 80px; } QTabBar::tab:selected { background-color: #333333; border-bottom: none; } QTabBar::tab:hover:not(:selected) { background-color: #3A3A3A; } /* 列表和树形控件样式 */ QTreeView, QListView { background-color: #2A2A2A; border: 1px solid #222222; color: #CCCCCC; } QTreeView::item:hover, QListView::item:hover { background-color: #3A3A3A; } QTreeView::item:selected, QListView::item:selected { background-color: #444444; } /* 输入框样式 */ QLineEdit { background-color: #2A2A2A; border: 1px solid #222222; border-radius: 2px; color: #CCCCCC; padding: 3px; } /* 下拉框样式 */ QComboBox { background-color: #2A2A2A; border: 1px solid #222222; border-radius: 2px; color: #CCCCCC; padding: 3px; min-width: 100px; } QComboBox::drop-down { border: none; width: 20px; } QComboBox::down-arrow { border-image: url(:/resources/icons/down_arrow.png); width: 12px; height: 12px; } /* 按钮样式 */ QPushButton { background-color: #2A2A2A; border: 1px solid #222222; border-radius: 2px; color: #CCCCCC; padding: 5px 15px; min-width: 80px; } QPushButton:hover { background-color: #3A3A3A; border: 1px solid #444444; } QPushButton:pressed { background-color: #222222; } /* 滚动条样式 */ QScrollBar:vertical { background: #2A2A2A; width: 10px; margin: 0; } QScrollBar::handle:vertical { background: #444444; min-height: 20px; border-radius: 5px; } QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical { height: 0px; } QScrollBar:horizontal { background: #2A2A2A; height: 10px; margin: 0; } QScrollBar::handle:horizontal { background: #444444; min-width: 20px; border-radius: 5px; } QScrollBar::add-line:horizontal, QScrollBar::sub-line:horizontal { width: 0px; } /* 分组框样式 */ QGroupBox { border: 1px solid #222222; border-radius: 3px; margin-top: 6px; padding-top: 6px; color: #CCCCCC; } QGroupBox::title { left: 7px; padding: 0px 3px; } /* 状态栏样式 */ QStatusBar { background-color: #333333; color: #CCCCCC; } /* 工具提示样式 */ QToolTip { background-color: #2A2A2A; border: 1px solid #222222; color: #CCCCCC; padding: 3px; } ``` ├── config │ └── \_\_init\_\_.py ```Python #!/usr/bin/env python # -*- coding: utf-8 -*- from . import * ``` │ └── data.py ```Python #!/usr/bin/env python # -*- coding: utf-8 -*- import os import sys import maya.cmds as cmds #===================================== 2. Global Variables ===================================== try: ROOT_PATH = os.path.dirname(INSTALL_PATH).replace("\\", "/") except NameError: # __file__ 在 config 中，所以返回上一级目录即项目根目录 ROOT_PATH = os.path.dirname(os.path.dirname(os.path.abspath(__file__))).replace("\\", "/") TOOL_NAME = "MetaFusion" TOOL_VERSION = "Beta v1.0.0" TOOL_AUTHOR = "Virtuos" TOOL_LANG = 'en_US' TOOL_WSCL_NAME = f"{TOOL_NAME}WorkSpaceControl" TOOL_HELP_URL = f"https://gitea.cgnico.com/CGNICO/{TOOL_NAME}/wiki" #===================================== 3. Paths ===================================== # PATHS SCRIPTS_PATH = os.path.join(ROOT_PATH, "scripts").replace("\\", "/") ICONS_PATH = os.path.join(ROOT_PATH, "resources", "icons").replace("\\", "/") STYLES_PATH = os.path.join(ROOT_PATH, "resources", "styles").replace("\\", "/") MAYA_VERSION = cmds.about(version=True) SYSTEM_OS = cmds.about(os=True) if MAYA_VERSION in ["2022", "2023", "2024", "2025"]: PLUGIN_PATH = os.path.join(ROOT_PATH, "plugins", SYSTEM_OS, MAYA_VERSION).replace("\\", "/") else: print(f"MetaFusion is not supported on Maya {MAYA_VERSION}") PYTHON_VERSION = sys.version_info.major if PYTHON_VERSION == 3: PYDNA_PATH = os.path.join(ROOT_PATH, "plugins", SYSTEM_OS, "python3").replace("\\", "/") elif PYTHON_VERSION == 3.11: PYDNA_PATH = os.path.join(ROOT_PATH, "plugins", SYSTEM_OS, "python311").replace("\\", "/") elif PYTHON_VERSION == 3.9: PYDNA_PATH = os.path.join(ROOT_PATH, "plugins", SYSTEM_OS, "python397").replace("\\", "/") elif PYTHON_VERSION == 3.10: PYDNA_PATH = os.path.join(ROOT_PATH, "plugins", SYSTEM_OS, "python3108").replace("\\", "/") else: print(f"MetaFusion is not supported on Python {PYTHON_VERSION}") #===================================== 3. Files ===================================== # FILES TOOL_MAIN_SCRIPT = os.path.join(SCRIPTS_PATH, f"{TOOL_NAME}.py").replace("\\", "/") TOOL_STYLE_FILE = os.path.join(STYLES_PATH, "style.qss").replace("\\", "/") TOOL_ICON = os.path.join(ICONS_PATH, f"{TOOL_NAME}Logo.png").replace("\\", "/") TOOL_COMMAND_ICON = os.path.join(ICONS_PATH, "CommandButton.png").replace("\\", "/") TOOL_MOD_FILENAME = f"{TOOL_NAME}.mod" #===================================== 4. Qt ===================================== # Qt def Qt(): try: from PySide import QtCore, QtGui, QtWidgets return QtCore, QtGui, QtWidgets except ImportError: try: from PySide2 import QtCore, QtGui, QtWidgets return QtCore, QtGui, QtWidgets except ImportError: try: from PySide3 import QtCore, QtGui, QtWidgets return QtCore, QtGui, QtWidgets except ImportError: try: from PySide4 import QtCore, QtGui, QtWidgets return QtCore, QtGui, QtWidgets except ImportError: try: from PySide5 import QtCore, QtGui, QtWidgets return QtCore, QtGui, QtWidgets except ImportError: try: from PySide6 import QtCore, QtGui, QtWidgets return QtCore, QtGui, QtWidgets except ImportError: print("未找到 Qt 模块") return None, None, None ``` ├── scripts │ ├── MetaFusion.py ```Python #!/usr/bin/env python # -*- coding: utf-8 -*- import os import sys from PySide2 import QtCore, QtGui, QtWidgets # 添加项目根目录到 Python 路径 ROOT_DIR = os.path.dirname(os.path.dirname(__file__)) if ROOT_DIR not in sys.path: sys.path.insert(0, ROOT_DIR) from config import data QtCore, QtGui, QtWidgets = data.Qt() #===================================== 2. Global Variables ===================================== TOOL_NAME = data.TOOL_NAME TOOL_VERSION = data.TOOL_VERSION TOOL_AUTHOR = data.TOOL_AUTHOR TOOL_LANG = data.TOOL_LANG TOOL_WSCL_NAME = data.TOOL_WSCL_NAME TOOL_HELP_URL = data.TOOL_HELP_URL SCRIPTS_PATH = data.SCRIPTS_PATH ICONS_PATH = data.ICONS_PATH TOOL_MAIN_SCRIPT = data.TOOL_MAIN_SCRIPT TOOL_MOD_FILENAME = data.TOOL_MOD_FILENAME TOOL_ICON = data.TOOL_ICON TOOL_COMMAND_ICON = data.TOOL_COMMAND_ICON main_window = None class MetaFusionWindow(QtWidgets.QMainWindow): def __init__(self, parent=None): super(MetaFusionWindow, self).__init__(parent) self.setWindowTitle("MetaFusion") self.resize(800, 600) # 加载样式表 self.load_stylesheet() # 创建UI self.setup_ui() def load_stylesheet(self): """加载QSS样式表""" style_file = os.path.join(os.path.dirname(os.path.dirname(__file__)), "resources", "styles", "style.qss") if os.path.exists(style_file): with open(style_file, 'r', encoding='utf-8') as f: self.setStyleSheet(f.read()) def setup_ui(self): """设置UI结构""" # 创建中心部件 central_widget = QtWidgets.QWidget() self.setCentralWidget(central_widget) # 创建主布局 main_layout = QtWidgets.QVBoxLayout(central_widget) # 创建菜单栏 self.create_menu_bar() # 创建工具栏 self.create_tool_bar() # 创建标签页 self.create_tabs() def create_menu_bar(self): """创建菜单栏""" menubar = self.menuBar() # 文件菜单 file_menu = menubar.addMenu("文件") file_menu.addAction("新建") file_menu.addAction("打开") file_menu.addAction("保存") file_menu.addSeparator() file_menu.addAction("退出") # 编辑菜单 edit_menu = menubar.addMenu("编辑") edit_menu.addAction("撤销") edit_menu.addAction("重做") # 帮助菜单 help_menu = menubar.addMenu("帮助") help_menu.addAction("关于") def create_tool_bar(self): """创建工具栏""" toolbar = self.addToolBar("主工具栏") toolbar.setMovable(False) # 添加工具栏按钮 toolbar.addAction(QtGui.QIcon(":/icons/new.png"), "新建") toolbar.addAction(QtGui.QIcon(":/icons/open.png"), "打开") toolbar.addAction(QtGui.QIcon(":/icons/save.png"), "保存") def create_tabs(self): """创建标签页""" self.tab_widget = QtWidgets.QTabWidget() self.centralWidget().layout().addWidget(self.tab_widget) # 创建四个主要标签页 self.model_tab = QtWidgets.QWidget() self.rig_tab = QtWidgets.QWidget() self.adjust_tab = QtWidgets.QWidget() self.define_tab = QtWidgets.QWidget() # 添加标签页到标签页控件 self.tab_widget.addTab(self.model_tab, "模型") self.tab_widget.addTab(self.rig_tab, "绑定") self.tab_widget.addTab(self.adjust_tab, "调整") self.tab_widget.addTab(self.define_tab, "定义") # 设置各个标签页的内容 self.setup_model_tab() self.setup_rig_tab() self.setup_adjust_tab() self.setup_define_tab() def setup_model_tab(self): """设置模型标签页内容""" layout = QtWidgets.QVBoxLayout(self.model_tab) # 在这里添加模型标签页的具体控件 def setup_rig_tab(self): """设置绑定标签页内容""" layout = QtWidgets.QVBoxLayout(self.rig_tab) # 在这里添加绑定标签页的具体控件 def setup_adjust_tab(self): """设置调整标签页内容""" layout = QtWidgets.QVBoxLayout(self.adjust_tab) # 在这里添加调整标签页的具体控件 def setup_define_tab(self): """设置定义标签页内容""" layout = QtWidgets.QVBoxLayout(self.define_tab) # 在这里添加定义标签页的具体控件 def show(): """显示主窗口""" global main_window try: main_window.close() except: pass main_window = MetaFusionWindow() main_window.show() return main_window if __name__ == "__main__": app = QtWidgets.QApplication([]) window = show() app.exec_() ```