89 lines
3.2 KiB
Markdown
89 lines
3.2 KiB
Markdown
|
|
# Documentation
|
|
- Class name: RegionalIPAdapterEncodedMask __Inspire
|
|
- Category: InspirePack/Regional
|
|
- Output node: False
|
|
|
|
该节点专门用于在InspirePack框架内应用基于编码掩码的图像处理调整，利用区域IP适配器技术根据指定的掩码和权重有条件地修改图像嵌入。
|
|
|
|
# Input types
|
|
## Required
|
|
- mask
|
|
- 掩码输入指定了图像中需要进行条件嵌入调整的区域，通过定义重点处理的区域在节点操作中发挥关键作用。
|
|
- Comfy dtype: MASK
|
|
- Python dtype: torch.Tensor
|
|
- embeds
|
|
- 表示要应用于图像指定区域的所需调整或特征的嵌入，基于掩码影响最终输出。
|
|
- Comfy dtype: EMBEDS
|
|
- Python dtype: torch.Tensor
|
|
- weight
|
|
- 一个浮点值，用于确定应用于图像的嵌入调整的强度，允许对效果强度进行微调。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- weight_type
|
|
- 指定将权重应用于嵌入的方法，提供原始、线性或通道惩罚等选项，以实现多样化的调整效果。
|
|
- Comfy dtype: COMBO[STRING]
|
|
- Python dtype: str
|
|
- start_at
|
|
- 定义效果应用在图像处理中的起始点，实现分阶段调整。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- end_at
|
|
- 设置效果应用的终点，允许精确控制调整的范围。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- unfold_batch
|
|
- 一个布尔标志，当为真时，单独处理批次中的每个项目，增强处理批量输入的灵活性。
|
|
- Comfy dtype: BOOLEAN
|
|
- Python dtype: bool
|
|
|
|
## Optional
|
|
- neg_embeds
|
|
- 可选的负面嵌入，可用于指定在特定区域需要避免的特征或调整，添加了反向效果的能力。
|
|
- Comfy dtype: EMBEDS
|
|
- Python dtype: torch.Tensor
|
|
|
|
# Output types
|
|
- regional_ipadapter
|
|
- 基于编码掩码和指定参数生成输入的条件版本，反映了目标调整。
|
|
- Comfy dtype: REGIONAL_IPADAPTER
|
|
- Python dtype: IPAdapterConditioning
|
|
|
|
|
|
## Usage tips
|
|
- Infra type: `GPU`
|
|
- Common nodes: unknown
|
|
|
|
|
|
## Source code
|
|
```python
|
|
class RegionalIPAdapterEncodedMask:
|
|
@classmethod
|
|
def INPUT_TYPES(s):
|
|
return {
|
|
"required": {
|
|
"mask": ("MASK",),
|
|
|
|
"embeds": ("EMBEDS",),
|
|
"weight": ("FLOAT", {"default": 0.7, "min": -1, "max": 3, "step": 0.05}),
|
|
"weight_type": (["original", "linear", "channel penalty"],),
|
|
"start_at": ("FLOAT", {"default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001}),
|
|
"end_at": ("FLOAT", {"default": 1.0, "min": 0.0, "max": 1.0, "step": 0.001}),
|
|
"unfold_batch": ("BOOLEAN", {"default": False}),
|
|
},
|
|
"optional": {
|
|
"neg_embeds": ("EMBEDS",),
|
|
}
|
|
}
|
|
|
|
RETURN_TYPES = ("REGIONAL_IPADAPTER", )
|
|
FUNCTION = "doit"
|
|
|
|
CATEGORY = "InspirePack/Regional"
|
|
|
|
def doit(self, mask, embeds, weight, weight_type, start_at=0.0, end_at=1.0, unfold_batch=False, neg_embeds=None):
|
|
cond = IPAdapterConditioning(mask, weight, weight_type, embeds=embeds, start_at=start_at, end_at=end_at, unfold_batch=unfold_batch, neg_embeds=neg_embeds)
|
|
return (cond, )
|
|
|
|
```
|