147 lines
5.5 KiB
Markdown
147 lines
5.5 KiB
Markdown
# Documentation
|
|
- Class name: ImageCompositeRelative
|
|
- Category: image/composite
|
|
- Output node: False
|
|
|
|
ImageCompositeRelative节点用于根据两张图像的相对尺寸和位置进行合成，允许基于指定坐标和大小进行动态图像叠加和操作。该节点通过计算输入图像的相对位置和大小来创建复合图像，以达到预期的布局和视觉效果。
|
|
|
|
# Input types
|
|
## Required
|
|
- images_a
|
|
- 此参数代表要合成到容器上的第一组图像。它在叠加过程中起着关键作用，决定了复合图像中的视觉内容和层叠顺序。
|
|
- Comfy dtype: IMAGE
|
|
- Python dtype: numpy.ndarray
|
|
- images_b
|
|
- 与images_a类似，此参数代表要叠加到容器上的第二组图像。它允许引入额外的视觉元素，增强复合图像的复杂性和深度。
|
|
- Comfy dtype: IMAGE
|
|
- Python dtype: numpy.ndarray
|
|
- images_a_x
|
|
- 指定第一组图像的水平位置（相对于容器宽度的百分比），影响它们在复合图像中的放置。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- images_a_y
|
|
- 指定第一组图像的垂直位置（相对于容器高度的百分比），影响它们在复合图像中的对齐和层叠。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- images_b_x
|
|
- 确定第二组图像的水平位置（相对于容器宽度的百分比），指导它们的放置以及与第一组图像的交互。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- images_b_y
|
|
- 确定第二组图像的垂直位置（相对于容器高度的百分比），影响它们与第一组图像的层叠和视觉关系。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- background
|
|
- background参数指定哪组图像（images_a或images_b）应被视为复合图像中的背景层。这个选择影响复合图像的视觉层次和层叠。
|
|
- Comfy dtype: COMBO[STRING]
|
|
- Python dtype: str
|
|
- container_size_type
|
|
- 定义确定容器大小的策略，可以基于输入图像的最大尺寸或它们的总和，影响复合图像的整体尺寸。
|
|
- Comfy dtype: COMBO[STRING]
|
|
- Python dtype: str
|
|
- method
|
|
- 定义用于合成图像的方法或算法。此参数影响应用的混合和叠加技术，从而影响复合图像的最终外观。
|
|
- Comfy dtype: COMBO[STRING]
|
|
- Python dtype: str
|
|
|
|
# Output types
|
|
- image
|
|
- 结果复合图像，通过根据给定的位置、大小和方法混合和叠加指定的图像而创建。这个输出代表合成过程的最终视觉产品。
|
|
- Comfy dtype: IMAGE
|
|
- Python dtype: numpy.ndarray
|
|
|
|
## Usage tips
|
|
- Infra type: `CPU`
|
|
- Common nodes: unknown
|
|
|
|
|
|
## Source code
|
|
```python
|
|
class ImageCompositeRelative:
|
|
def __init__(self):
|
|
pass
|
|
|
|
@classmethod
|
|
def INPUT_TYPES(cls):
|
|
return {
|
|
"required": {
|
|
"images_a": ("IMAGE",),
|
|
"images_b": ("IMAGE",),
|
|
"images_a_x": ("FLOAT", {
|
|
"default": 0.0,
|
|
"max": 1.0,
|
|
"step": 0.01
|
|
}),
|
|
"images_a_y": ("FLOAT", {
|
|
"default": 0.0,
|
|
"max": 1.0,
|
|
"step": 0.01
|
|
}),
|
|
"images_b_x": ("FLOAT", {
|
|
"default": 0.0,
|
|
"max": 1.0,
|
|
"step": 0.01
|
|
}),
|
|
"images_b_y": ("FLOAT", {
|
|
"default": 0.0,
|
|
"max": 1.0,
|
|
"step": 0.01
|
|
}),
|
|
"background": (["images_a", "images_b"],),
|
|
"container_size_type": (["max", "sum", "sum_width", "sum_height"],),
|
|
"method": (["pair", "matrix"],),
|
|
},
|
|
}
|
|
|
|
RETURN_TYPES = ("IMAGE",)
|
|
FUNCTION = "node"
|
|
CATEGORY = "image/composite"
|
|
|
|
def node(
|
|
self,
|
|
images_a,
|
|
images_b,
|
|
images_a_x,
|
|
images_a_y,
|
|
images_b_x,
|
|
images_b_y,
|
|
background,
|
|
container_size_type,
|
|
method
|
|
):
|
|
def offset_by_percent(container_size: int, image_size: int, percent: float):
|
|
return int((container_size - image_size) * percent)
|
|
|
|
img_a_height, img_a_width = images_a[0, :, :, 0].shape
|
|
img_b_height, img_b_width = images_b[0, :, :, 0].shape
|
|
|
|
if container_size_type == "max":
|
|
container_width = max(img_a_width, img_b_width)
|
|
container_height = max(img_a_height, img_b_height)
|
|
elif container_size_type == "sum":
|
|
container_width = img_a_width + img_b_width
|
|
container_height = img_a_height + img_b_height
|
|
elif container_size_type == "sum_width":
|
|
container_width = img_a_width + img_b_width
|
|
container_height = max(img_a_height, img_b_height)
|
|
elif container_size_type == "sum_height":
|
|
container_width = max(img_a_width, img_b_width)
|
|
container_height = img_a_height + img_a_height
|
|
else:
|
|
raise ValueError()
|
|
|
|
return ImageCompositeAbsolute().node(
|
|
images_a,
|
|
images_b,
|
|
offset_by_percent(container_width, img_a_width, images_a_x),
|
|
offset_by_percent(container_height, img_a_height, images_a_y),
|
|
offset_by_percent(container_width, img_b_width, images_b_x),
|
|
offset_by_percent(container_height, img_b_height, images_b_y),
|
|
container_width,
|
|
container_height,
|
|
background,
|
|
method
|
|
)
|
|
|
|
```
|