Nuke Python Scripts Toolkit

目录 📚

• 前言 📚
• 下载 📚
• 安装 📚
• 介绍 📚
  • PythonScripts 菜单 📜
  • 分类 🗂️
    • 3D 🏷️
    • Import_Export 🏷️
    • Misc 🏷️
    • NodeGraph 🏷️
    • UI 🏷️
  • 新脚本的摆放位置 🗃️
    • 针对非特定节点类的脚本 🧩
    • 针对特定节点类的脚本 🧩
  • PythonScripts 目录结构 📁
  • 问答 ❓ ❗
• 附录 📚
• 证书 📚

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

前言 📚

2018年12月，开始制作了一个用于 Nuke 的工具库，名为 nuLibrary ( /njuːˈlɪbrəri/ )，后续一直不断的整合优化。

nuLibrary 内含有 Gizmos 🧰、 PythonScripts 🧰、 Series 🧰 三个不同的工具包，里面含有我平时搜集并使用的 gizmos 和 scripts，大部分来自网络，其他为自己编写。

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

PythonScripts 🧰 中包含了我在 Nuke 中所使用的一些非常 实用、 高效、 便捷 的 scripts（脚本，或者称之为插件），不仅可以加快工作流程，而且也非常有趣，这完全改变了我与 Nuke 的交互方式。

下载 📚

若熟悉 GitHub 可略过

点击右侧的 Releases - latest，

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

进入页面后点击 Assets 下的第一个 nuLibrary_vX.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#features

• 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 中。

---

新脚本的摆放位置 🗃️

对于我个人编写的脚本是采用下面的方式.对于其他作者的脚本，如果其作者将脚本发布在了 NukePedia上 ，则按照 NukePedia 上的分类规则。

针对非特定节点类的脚本 🧩

• 使用频率很高且需要设置快捷键，一般放在 PythonScripts 菜单中。
• 使用频率较低且无需设置快捷键，一般放在 PythonScripts 菜单中。
• 使用频率很高但不需要设置快捷键，一般放在 W_hotbox 中.

针对特定节点类的脚本 🧩

• 一般放在 W_hotbox 中。

---

PythonScripts 目录结构 📁

若不熟悉 Python 可略过。

• 在现有基础上添加脚本

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

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

  .nuke/nuLibrary/PythonScripts/init.py 会 自动 添加 PythonScripts目录下的 第三级目录的路径，所有的脚本都可以放到相应的 三级目录 下。

• 自定义方式添加脚本

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

---

问答 ❓ ❗

有任何问题可随时在 此处 发起讨论～

附录 📚

在此非常感谢 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 社区的其他贡献者。 💖

排名不分先后

证书 📚