텍스트 표시

스타일과 위치 옵션을 사용해 이미지에 사용자 지정 텍스트를 표시합니다.

이 텍스트 표시 이 블록은 스타일과 위치를 완전히 제어하여 이미지 위에 텍스트를 렌더링합니다.

동적 텍스트 콘텐츠

텍스트 콘텐츠는 Email 및 SMS 알림 블록과 동일한 템플릿 구문을 사용하여 워크플로 실행 결과로 매개변수화할 수 있습니다:

text = "감지된 {{ $parameters.count }}개의 {{ $parameters.class_name }} 객체"

매개변수는 다음을 통해 제공됩니다 text_parameters 필드:

text_parameters = {
    "count": "$steps.model.predictions",
    "class_name": "$inputs.target_class"
}

다음을 사용하여 매개변수에 변환을 적용할 수 있습니다 text_parameters_operations:

text_parameters_operations = {
    "count": [{"type": "SequenceLength"}]
}

스타일 옵션

• text_color: 텍스트 색상입니다. 다음을 지원합니다:

  • Supervision 색상 이름(대문자): "WHITE", "BLACK", "RED", "GREEN", "BLUE", "YELLOW", "ROBOFLOW" 등.

  • 16진수 형식: "#RRGGBB"(예: 빨간색은 "#FF0000")

  • RGB 형식: "rgb(R, G, B)"(예: 빨간색은 "rgb(255, 0, 0)")

  • BGR 형식: "bgr(B, G, R)"(예: 빨간색은 "bgr(0, 0, 255)")

• background_color: 텍스트 뒤의 배경색입니다. text_color와 동일한 색상 형식을 지원합니다 text_color. 배경이 없게 하려면 "transparent"를 사용합니다.

• background_opacity: 배경의 투명도(0.0 = 완전 투명, 1.0 = 완전 불투명)

• font_scale: 글꼴 크기의 배율

• font_thickness: 텍스트 획의 두께

• padding: 텍스트 주변의 패딩(픽셀)

• text_align: 텍스트의 가로 정렬("left", "center", "right")

• border_radius: 배경의 둥근 모서리 반경

위치 지정 옵션

이 블록은 절대 위치 지정과 상대 위치 지정을 모두 지원합니다:

절대 위치 지정 (position_mode = "absolute"):

• position_x: 왼쪽 가장자리에서의 X 좌표(픽셀)

• position_y: 위쪽 가장자리에서의 Y 좌표(픽셀)

상대 위치 지정 (position_mode = "relative"):

• anchor: 텍스트를 고정할 위치("center", "top_left", "top_center", "top_right", "bottom_left", "bottom_center", "bottom_right", "center_left", "center_right")

• offset_x: 기준점에서의 가로 오프셋(양수 = 오른쪽)

• offset_y: 기준점에서의 세로 오프셋(양수 = 아래)

유형 식별자

단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/text_display@v1 워크플로우에 이 블록을 단계로 추가하려면.

속성

이름	유형	설명	참조
name	str	이 단계에 대한 고유 식별자를 입력하세요..	❌
text	str	표시할 텍스트 내용입니다. 다음을 사용한 매개변수 보간을 지원합니다: {{ $parameters.name }} 구문..	❌
text_parameters	Dict[str, Union[bool, float, int, str]]	텍스트에 보간할 매개변수..	✅
text_parameters_operations	Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]	보간 전에 텍스트 매개변수에 적용할 연산..	❌
text_color	str	텍스트 색상입니다. Supervision 색상 이름(WHITE, BLACK, RED, GREEN, BLUE, YELLOW, ROBOFLOW 등), 16진수 형식(#RRGGBB), rgb(R,G,B) 형식 또는 bgr(B,G,R) 형식을 지원합니다..	✅
background_color	str	텍스트 뒤의 배경색입니다. text_color와 동일한 색상 형식을 지원합니다. 배경이 없게 하려면 'transparent'를 사용합니다..	✅
background_opacity	float	배경의 불투명도(0.0 = 완전 투명, 1.0 = 완전 불투명)..	✅
font_scale	float	글꼴 크기의 배율..	✅
font_thickness	정수	텍스트 획의 두께..	✅
padding	정수	텍스트 주변의 패딩(픽셀)..	✅
text_align	str	텍스트의 바운딩 박스 내 가로 정렬..	✅
border_radius	정수	배경 사각형의 둥근 모서리 반경..	✅
position_mode	str	위치 지정 모드: 'absolute'는 정확한 픽셀 좌표를 사용하고, 'relative'는 오프셋이 있는 기준점을 사용합니다..	✅
position_x	정수	절대 위치 지정 시 X 좌표(왼쪽 가장자리에서의 픽셀)..	✅
position_y	정수	절대 위치 지정 시 Y 좌표(위쪽 가장자리에서의 픽셀)..	✅
anchor	str	상대 위치 지정용 기준점..	✅
offset_x	정수	기준점에서의 가로 오프셋(양수 = 오른쪽)..	✅
offset_y	정수	기준점에서의 세로 오프셋(양수 = 아래)..	✅
copy_image	bool	그리기 전에 입력 이미지를 복사할지 여부(원본 유지)..	✅

이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.

입력 및 출력 바인딩

사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 텍스트 표시 버전 v1 을 가지고 있는지.

입력 및 출력 바인딩

• 입력

  • 이미지 (이미지): 텍스트를 표시할 이미지..

  • text_parameters (*): 텍스트에 보간할 매개변수..

  • text_color (string): 텍스트 색상입니다. Supervision 색상 이름(WHITE, BLACK, RED, GREEN, BLUE, YELLOW, ROBOFLOW 등), 16진수 형식(#RRGGBB), rgb(R,G,B) 형식 또는 bgr(B,G,R) 형식을 지원합니다..

  • background_color (string): 텍스트 뒤의 배경색입니다. text_color와 동일한 색상 형식을 지원합니다. 배경이 없게 하려면 'transparent'를 사용합니다..

  • background_opacity (0에서 1 사이의 실수): 배경의 불투명도(0.0 = 완전 투명, 1.0 = 완전 불투명)..

  • font_scale (float): 글꼴 크기의 배율..

  • font_thickness (정수): 텍스트 획의 두께..

  • padding (정수): 텍스트 주변의 패딩(픽셀)..

  • text_align (string): 텍스트의 바운딩 박스 내 가로 정렬..

  • border_radius (정수): 배경 사각형의 둥근 모서리 반경..

  • position_mode (string): 위치 지정 모드: 'absolute'는 정확한 픽셀 좌표를 사용하고, 'relative'는 오프셋이 있는 기준점을 사용합니다..

  • position_x (정수): 절대 위치 지정 시 X 좌표(왼쪽 가장자리에서의 픽셀)..

  • position_y (정수): 절대 위치 지정 시 Y 좌표(위쪽 가장자리에서의 픽셀)..

  • anchor (string): 상대 위치 지정용 기준점..

  • offset_x (정수): 기준점에서의 가로 오프셋(양수 = 오른쪽)..

  • offset_y (정수): 기준점에서의 세로 오프셋(양수 = 아래)..

  • copy_image (boolean): 그리기 전에 입력 이미지를 복사할지 여부(원본 유지)..

• 출력

  • 이미지 (이미지): 워크플로의 이미지입니다.

예시 JSON 정의

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/text_display@v1",
	    "image": "$inputs.image",
	    "text": "감지 수: {{ $parameters.count }}",
	    "text_parameters": {
	        "class_name": "$inputs.target_class",
	        "count": "$steps.model.predictions"
	    },
	    "text_parameters_operations": {
	        "count": [
	            {
	                "type": "SequenceLength"
	            }
	        ]
	    },
	    "text_color": "WHITE",
	    "background_color": "BLACK",
	    "background_opacity": 1.0,
	    "font_scale": 1.0,
	    "font_thickness": 1,
	    "padding": 5,
	    "text_align": "left",
	    "border_radius": 0,
	    "position_mode": "absolute",
	    "position_x": 10,
	    "position_y": 10,
	    "anchor": "center",
	    "offset_x": 0,
	    "offset_y": 0,
	    "copy_image": true
	}