CavinHuang-comfyui-nodes-docs/docs/Noise Control Script.md

Documentation

• Class name: Noise Control Script
• Category: Efficiency Nodes/Scripts
• Output node: False
• Repo Ref: https://github.com/comfyanonymous/ComfyUI

Noise Control Script节点旨在ComfyUI框架内整合和管理噪声源和种子变化。它允许自定义噪声生成和种子操作，增强对生成输出中随机性和可变性的控制。该节点作为调整噪声特性和种子行为的关键元素，为管理生成过程中的随机元素提供了一种细致入微的方法。

Input types

Required

• rng_source
  • 指定噪声生成的随机源，允许从CPU、GPU或NV选项中进行选择。这个选择影响噪声生成的计算后端，进而影响性能和兼容性。
  • Comfy dtype: COMBO[STRING]
  • Python dtype: List[str]
• cfg_denoiser
  • 一个布尔标志，用于启用或禁用配置去噪器，影响生成过程中的噪声过滤。
  • Comfy dtype: BOOLEAN
  • Python dtype: bool
• add_seed_noise
  • 决定是否引入基于种子值的额外噪声，为输出增加另一层变异性。
  • Comfy dtype: BOOLEAN
  • Python dtype: bool
• seed
  • 噪声生成的种子值，为应用的噪声提供可重现性和变化的基础。
  • Comfy dtype: INT
  • Python dtype: int
• weight
  • 定义种子噪声的权重，调整噪声效果对输出的影响强度。
  • Comfy dtype: FLOAT
  • Python dtype: float

Optional

• script
  • 一个可选的脚本参数，可以通过噪声设置进行修改或扩展，为基于脚本的定制提供灵活性。
  • Comfy dtype: SCRIPT
  • Python dtype: Dict

Output types

• SCRIPT
  • 返回一个带有应用噪声设置的修改或扩展脚本，便于在生成过程中进行自定义噪声控制。
  • Comfy dtype: SCRIPT
  • Python dtype: Dict

Usage tips

• Infra type: CPU
• Common nodes:
  • [KSampler Adv. (Efficient)](../../efficiency-nodes-comfyui/Nodes/KSampler Adv. (Efficient).md)
  • [KSampler SDXL (Eff.)](../../efficiency-nodes-comfyui/Nodes/KSampler SDXL (Eff.).md)

Source code

class TSC_Noise_Control_Script:

    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "rng_source": (["cpu", "gpu", "nv"],),
                "cfg_denoiser": ("BOOLEAN", {"default": False}),
                "add_seed_noise": ("BOOLEAN", {"default": False}),
                "seed": ("INT", {"default": 0, "min": 0, "max": 0xffffffffffffffff}),
                "weight": ("FLOAT", {"default": 0.015, "min": 0, "max": 1, "step": 0.001})},
            "optional": {"script": ("SCRIPT",)}
        }

    RETURN_TYPES = ("SCRIPT",)
    RETURN_NAMES = ("SCRIPT",)
    FUNCTION = "noise_control"
    CATEGORY = "Efficiency Nodes/Scripts"

    def noise_control(self, rng_source, cfg_denoiser, add_seed_noise, seed, weight, script=None):
        script = script or {}
        script["noise"] = (rng_source, cfg_denoiser, add_seed_noise, seed, weight)
        return (script,)