PythonScripts Toolkit for Nuke

目录

• 前言 📚
• 下载 📚
• 安装 📚
• 介绍 📚
  • PythonScripts 菜单 📜
    • 3D 🏷️
    • Import_Export 🏷️
    • Misc 🏷️
    • NodeGraph 🏷️
    • UI 🏷️
    • 问答 ❓ ❗
  • PythonScripts 🧰 目录结构
• 附录 📚
• 证书 📚

可单击标题直接导航到该部分。

前言 📚

很久前整合制作了一个名为 nuLibrary 的工具库（大约是在2018年12月，后续一直慢慢地优化），nuLibrary 内含有 Gizmos 🧰、 PythonScripts 🧰、 Series 🧰 三个不同的工具包，里面含有我平时搜集并使用的 gizmos 和 scripts，大部分来自网络，少部分为自己编写。

nuLibrary 一直在作为个人使用，最近决定公开发布其中的 PythonScripts 🧰。 Gizmos 🧰 和 Series 🧰 主要针对于我个人使用习惯做了排版布局，与 NukeSurvivalToolkit 中的内容相似，其表面的最大区别就是在 Nuke 中的布局，所以暂不公开，无太多意义。

在 PythonScripts 🧰 中整合了我在 Nuke 中所使用的一些较为 实用、 高效 且 优雅 的 scripts（脚本，或者称之为插件 🔌），这完全改变了我与 Nuke 的交互方式。

下载 📚

若熟悉 GitHub 可略过

点击右侧的 Releases - latest，

没找到 ？ 那就点击 此处 吧 ！

进入页面后点击 Assets 下的第一个 nuLibrary_vX.X.X.zip 链接 🔗 即可。

安装 📚

要求： NukeX 13 或更新版本

已测试 Windows 10，Linux CentOS 7，macOS Sonoma。

若熟悉安装可略过

1. 下载 .zip 💼 文件解压后将 nuLibrary 📁 文件夹复制到用户目录的 .nuke 📁 文件夹内。

2. • 若 .nuke 📁 文件夹内没有 init.py 文件，则新建一个 init.txt 文件，并将以下代码复制到文件中，最后将 init.txt 更改为 init.py

   • 若 .nuke 📁 文件夹内存在 init.py 文件，打开 init.py，并将以下代码复制到文件中。

     （ 右键以记事本方式打开文件 或用 其他熟悉的一种方式打开）

     import nuke
     
     nuke.pluginAddPath('./nuLibrary')

3. 打开 Nuke ☢️ ，尽情享用 😋 ~

想要深入了解 Nuke 插件安装？请查看官方文档 Installing Plug-ins

什么 ❓ 你还想了解怎么 uninstall ❓ 直接 delete 即可~

• 只需删除 .nuke 📁 文件夹下 init.py 中的下列代码， 删除 nuLibrary 📁 文件夹。

  nuke.pluginAddPath('./nuLibrary')

介绍 📚

PythonScripts 菜单 📜

完成安装后 ✔️ 可以看到位于 Nuke 顶部菜单栏右侧的 PythonScripts 菜单 📜。

PythonScripts 🧰 遵循 NukePedia 的分类方式，以下为各种分类文件夹内脚本的介绍。目前存在 3D 🏷️、Import_Export 🏷️、Misc 🏷️、NodeGraph 🏷️、UI 🏷️ 五种分类（以后可能会根据相应脚本继续添加分类）。有关快捷键，请在 PythonScripts 菜单 📜 内查看。

如若感兴趣建议尽可能地熟悉 W_hotbox（下面有介绍），快速高效、高度自定义化、大幅减少了对快捷键的占用。完全熟悉后，会使你 锦上添花 🌻，若同时了解 Python 更是 如虎添翼 🦅。

3D 🏷️

• animatedSnap3D

  • 作者：Ivan Busquets

  • 使用方法：https://www.nukepedia.com/python/3d/animatedsnap3d

Import_Export 🏷️

• CollectFiles

  • 作者：Mariano Antico

  • 使用方法：https://www.nukepedia.com/python/import/export/collectfiles

• Create Out Dirs

  • 来源：NUKE Python Developer’s Guide

  • 使用方法：无需操作，打开 Nuke 后自动启用。

    它会在 Write 节点开始渲染前的那一刻自动检测当前 Write 节点的文件目录是否存在，若为否，则自动先创建该目录然后再渲染。相当于勾选 ☑️ 了 Write 节点中的 create directories 选项，只不过它忽略 create directories 选项，无论是否勾选， CreateOutDirs 都会运行 ✔️。

Misc 🏷️

• Auto open .nk as NukeX

  • 作者：Max van Leeuwen

  • 使用方法：仅针对于 Windows 系统。自动将 .nk 文件与 NukeX 关联，双击 Nuke 工程将自动以 NukeX 打开。需要到文件路径 .nuke/nuLibrary/PythonScripts/Misc/Auto_open_nk_as_NukeX 下将 NukeXByDefault.reg 文件右键以记事本方式打开，更改路径中的 版本号，保存后，双击运行，一劳永逸。

• Default

  • 作者：Simon Jokuschies

  • 使用方法：https://www.nukepedia.com/python/misc/default-automatic-knobdefaults

• openExploreDir

  • （原名：winExploreDir，原作者：Thorsten 编写，Varun Hadkar 发布。思路来源于 Thorsten，代码和名字现已全部被我更改，已适用于 Windows、Linux、Mac，并添加了新功能，也发布在了 NukePedia 上。）

  • 使用方法：https://github.com/isLundy/openExploreDir#feature

• read From Write

  • 作者：未知

  • 使用方法：表里如一，同字面意思。可使用快捷键从选定的 Write 节点读取已渲染的图像。

NodeGraph 🏷️

• AlignDots

  • 作者：Max van Leeuwen

  • 使用方法：https://www.nukepedia.com/python/nodegraph/aligndots（快捷键已被我更改）

• AlignNodes

  • 作者：Frank Rueter

  • 使用方法：https://www.nukepedia.com/python/nodegraph/alignnodes（快捷键已被我更改）

• MultiChannelSplit

  • 作者：Simon Jokuschies

  • 使用方法：https://www.nukepedia.com/python/nodegraph/multichannelsplit_v03

• V_Tools

  • 作者： Victor Perez

  • 使用方法：只保留了 V_ConvertGizmosToGroups，V_PostageStampGenerator，V_PresetBackdrop 这三个 scripts（共四个，另外一个由 readFromWrite 替代）。功能同字面意思，作用于已选定的节点。

• W_scaleTree

  • 作者：Wouter Gilsing

  • 使用方法：https://www.nukepedia.com/python/nodegraph/w_scaletree，在 Linux 系统上该快捷键更改为 Alt + 1，原快捷键被系统所用。

• W_smartAlign

  • 作者：Wouter Gilsing

  • 使用方法：https://www.nukepedia.com/python/nodegraph/w_smartalign（快捷键已被我更改）

AlignDots、AlignNodes、W_smartAlign 现在三者的快捷键已关联到 Alt + 0 2 4 5 6 8，更改这三个脚本快捷键是为了相互配合适用，在使用数字键盘对齐节点时极为便利。

UI 🏷️

• AnimationMaker

  • 作者：David Emeny

  • 使用方法：https://www.nukepedia.com/python/ui/animation-maker，与 ExpressionWaveGenerator gizmo 相似，都能达到同样的动画效果。

• Channel_Hotbox

  • 作者：Falk Hofmann

  • 使用方法：https://www.nukepedia.com/python/ui/channel-hotbox

• CloseAllProperties

  • 作者：Max van Leeuwen

  • 使用方法：快捷键已更改为源自 Josh Parks 使用的热键（熟练后很好用 👏）。使用快捷键可一次关闭所有已打开的 Node 面板和 Project Settings 面板。 对于习惯使用 Node 浮动面板的人非常适合（例如我 ~）, 可以减少对操作空间的占用，nice 👏 ！

• SearchReplacePanel

  • 作者：Frank Rueter

  • 使用方法：https://www.nukepedia.com/python/ui/searchreplacepanel

• W_hotbox

  • 作者：Wouter Gilsing

  • 使用方法：https://www.nukepedia.com/python/ui/w_hotbox，我个人编写的很多脚本也放在了 W_hotbox 中，因为实在是太方便了。

问答 ❓ ❗

Q. 安装完打开 Nuke 后为什么有些没有显示在 PythonScripts 菜单中 📜 ❓ 例如 W_hotbox animatedSnap3D 或者 CreateOutDirs。

A:

• 布局方式不同。有些作者的主要代码块内设置了布局，为方便以后的更新一般采用作者的默认设置。对于 W_hotbox，看了它的使用方法后会发现它分别显示在了 Nuke 的 Edit 菜单最下面一项和 Preferences 面板最下面一项。对于 animatedSnap3D，使用方法中也有介绍到，它会显示在 Card、 Cube、 Camera 等这类三维节点面板的 snap_menu 旋钮中。

• 非必要显示。像 CreateOutDirs 这类自动启动、自动运行、全程后台的脚本。

PythonScripts 🧰 目录结构

若不熟悉 Python 可略过。

• 在现有基础上添加脚本

  安装到 .nuke 📁 文件夹后可以看到以下结构示例：

  .nuke	/nuLibrary	/PythonScripts	/UI	/AnimationMaker /Channel_Hotbox /CloseAllProperties /SearchReplacePanel /W_hotbox	script.py
  	工具库名 ⤴️	工具包名 ⤴️	分类名 ⤴️	脚本文件夹名 ⤴️	脚本文件 ⤴️
  		当前目录 ⤴️	二级目录 ⤴️	三级目录 ⤴️

  .nuke/nuLibrary/PythonScripts/init.py 会 自动 添加 PythonScripts目录下的 第三级目录的路径，所有的脚本都可以放到相应的 三级目录 下。由于 PythonScripts 下的二级目录是分类名，无需添加到 Nuke 的插件路径中，所以请勿在二级目录下放置文件，务必建立文件夹 📁。

  .nuke/nuLibrary/init.py 会 自动 添加 nuLibrary 目录下的目录路径（原 nuLibrary 下有 Gizmos、PythonScripts、Series 文件夹，因现只公开 PythonScripts，所以现在是会自动添加 PythonScripts 文件夹路径）。

• 自定义方式添加脚本

  请自行修改 init.py 和 menu.py。

  使用代码时请勿遍历添加 所有 目录路径，请利用适当的条件判断只添加需求的目录即可，否则可能会导致 Nuke 打开速度变慢或其他未知问题，原因是某些插件文件夹内含有很多的 .py 文件，但这些文件夹路径都不需要添加到 Nuke 的插件路径中（经测试打开速度会变慢约 20 - 30 s）。

附录 📚

在此非常感谢 Wouter Gilsing、Frank Rueter、Max van Leeuwen、Josh Parks、Falk Hofmann、David Emeny、Victor Perez、Simon Jokuschies、Mariano Antico、Ivan Busquets、Thorsten、Varun Hadkar 以及 Nuke 社区的其他贡献者。 💖

排名不分先后

证书 📚