Points Editor (PointsEditor) - ComfyUI-KJNodes

Points Editor 노드는 두 가지 좌표점 유형(양수 및 음수)과 두 가지 바운딩 박스 형식(xyxy 및 xywh)을 지원합니다.

Points Editor는 이미지 상에서 상호작용 방식으로 좌표점을 생성하고 편집하는 그래픽 도구 노드입니다. 사용자가 클릭 작업을 통해 관심 영역을 표시하고 해당 좌표 데이터를 생성하여 후속 이미지 처리 단계에 정확한 위치 정보를 제공할 수 있습니다.

대화형 제어

Shift + 클릭으로 초록색(양수) 점을 추가합니다.
Shift + 오른쪽 클릭으로 빨간색(음수) 점을 추가합니다.
점에서 오른쪽 클릭하여 삭제합니다.
Ctrl + 클릭으로 바운딩 박스를 그립니다.
바운딩 박스 모서리를 드래그하여 크기를 조정하고, 내부를 드래그하여 이동합니다.
바운딩 박스에서 오른쪽 클릭하여 삭제합니다.
이미지를 추가하려면 노드를 선택한 후 복사/붙여넣기 또는 이미지를 드래그하거나, bg_image 입력(배치의 첫 번째 프레임)을 통해 제공하세요.

노드 기능

이 노드는 두 가지 좌표점 유형(양수와 음수)과 두 가지 바운딩 박스 형식(xyxy 및 xywh)을 지원합니다. 핵심 메커니즘은 내장된 그래픽 인터페이스를 통해 사용자의 마우스 작업을 받아 클릭 위치를 좌표 데이터로 변환하며, 이 데이터를 문자열 또는 구조화된 형식(예: 바운딩 박스, 마스크)으로 출력하여 워크플로의 다른 노드에서 사용할 수 있게 합니다.

노드 매개변수 설명 - Points Editor

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`bg_image`	IMAGE	아니요	-	-	bg_image (입력 매개변수): 선택적 매개변수로, 편집기에 배경 이미지를 로드하여 그리기 참조용으로 사용합니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`bbox_format`	COMBO	예	xyxy	"xyxy", "xywh", ""	bbox_format (입력 매개변수): 바운딩 박스의 좌표 형식을 선택합니다. 선택 가능한 값은 "xyxy"(좌상단 x, y, 우하단 x, y) 또는 "xywh"(좌상단 x, y, 너비, 높이)입니다.
`points_store`	STRING	예	-	-	points_store (입력 매개변수): 양수 좌표점 데이터를 내부적으로 저장하고 관리하는 문자열 필드입니다.
`coordinates`	STRING	예	-	-	coordinates (입력 매개변수): 기존 양수 좌표점 문자열을 입력하거나 수신합니다. 형식은 일반적으로 "x1,y1;x2,y2"입니다.
`neg_coordinates`	STRING	예	-	-	neg_coordinates (입력 매개변수): 기존 음수 좌표점 문자열을 입력하거나 수신합니다. 형식은 일반적으로 "x1,y1;x2,y2"입니다.
`bbox_store`	STRING	예	-	-	bbox_store (입력 매개변수): 바운딩 박스 데이터를 내부적으로 저장하고 관리하는 문자열 필드입니다.
`bboxes`	STRING	예	-	-	bboxes (입력 매개변수): 기존 바운딩 박스 좌표 문자열을 입력하거나 수신합니다.
`width`	INT	예	512	8 - 4096 (간격: 8)	width (입력 매개변수): 편집기 캔버스 및 출력 좌표 참조 프레임의 너비를 정의합니다. 범위는 8에서 4096이며, 조정 간격은 8입니다.
`height`	INT	예	512	8 - 4096 (간격: 8)	height (입력 매개변수): 편집기 캔버스 및 출력 좌표 참조 프레임의 높이를 정의합니다. 범위는 8에서 4096이며, 조정 간격은 8입니다.
`normalize`	BOOLEAN	예	False	-	normalize (입력 매개변수): 출력 좌표 값을 0-1 범위로 정규화할지 여부를 제어합니다.

출력 (Outputs)

매개변수 이름	데이터 타입	설명
positive_coords	STRING	positive_coords (출력 매개변수): 모든 양수(초록색) 좌표점의 문자열을 출력합니다.
negative_coords	STRING	negative_coords (출력 매개변수): 모든 음수(빨간색) 좌표점의 문자열을 출력합니다.
bbox	BBOX	bbox (출력 매개변수): 사용자가 그린 바운딩 박스 데이터를 출력합니다.
bbox_mask	MASK	bbox_mask (출력 매개변수): 바운딩 박스에 해당하는 검정색-흰색 마스크 이미지를 출력합니다.
cropped_image	IMAGE	cropped_image (출력 매개변수): 바운딩 박스에 따라 잘린 이미지 영역을 출력합니다.

사용 시나리오

이미지 복원(inpainting) 또는 부분 재생성 워크플로에서 이 노드를 사용하여 배경 이미지 상에서 수정이 필요한 영역(양수 점)과 보호해야 할 영역(음수 점)을 정확하게 표시할 수 있습니다. 생성된 좌표와 바운딩 박스는 샘플러 또는 마스크 처리 노드에 직접 연결되어 AI가 지정된 영역에만 그리도록 유도할 수 있습니다.

주의사항

작업 진행 중(Work in progress): 아직 이 노드를 워크플로의 일부로 신뢰하지 마세요. 버그가 많을 가능성이 있으며 안정성은 보장되지 않습니다!! 노드에 로드된 배경 이미지는 노드 및 워크플로 메타데이터에 저장됩니다. 캔버스에서 오른쪽 클릭하고 컨텍스트 메뉴에서 'Clear Image'를 선택하여 제거할 수 있습니다.

Points Editor 노드 소스 코드 링크

Points Editor 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Points Editor(PointsEditor)

Points Editor