QR 코드 생성기
텍스트 입력에서 QR 코드 이미지를 생성합니다.
텍스트 입력(URL, 텍스트 내용 또는 기타 데이터)으로부터 사용자 지정 가능한 오류 정정 수준, 시각적 스타일(색상, 테두리), 자동 크기 최적화를 적용해 QR 코드 이미지를 생성하며, 워크플로에서 임베딩, 인쇄 또는 추가 이미지 처리에 적합한 PNG 이미지를 생성합니다.
이 블록의 작동 방식
이 블록은 qrcode 라이브러리를 사용해 텍스트 입력으로부터 QR 코드 이미지를 생성하고, 제공된 텍스트를 스캔 가능한 QR 코드 패턴으로 인코딩합니다. 이 블록은:
인코드할 텍스트 입력(URL, 문자열 또는 기타 데이터)과 QR 코드 구성 매개변수를 받습니다
내부 LRU 캐시에서 동일한 매개변수로 이전에 생성된 QR 코드를 확인합니다(캐싱은 반복되는 QR 코드 생성의 성능을 향상시킵니다)
공통 색상 유틸리티를 사용해 채우기 및 배경색의 색상 사양을 파싱합니다(hex 코드, RGB 문자열, 표준 색상 이름, CSS3 색상 이름 지원)
오류 정정 수준 문자열을 qrcode 라이브러리의 해당 상수(Low, Medium, Quartile 또는 High 오류 정정)로 매핑합니다
지정된 매개변수로 QRCode 객체를 생성합니다:
version이 None인 경우 데이터 길이를 기준으로 버전(크기)을 자동으로 결정합니다
선택한 옵션에 따라 오류 정정 수준을 설정합니다
모듈당 고정 box_size 10픽셀을 사용합니다
지정된 테두리 너비를 적용합니다
텍스트 데이터를 QR 코드 패턴에 인코딩합니다
지정된 채우기 색상과 배경색으로 QR 코드에서 PIL 이미지를 생성합니다
이미지를 RGB 형식으로 변환한 다음 NumPy 배열로 변환합니다
워크플로 이미지 처리와의 호환성을 위해 RGB(PIL 형식)에서 BGR(OpenCV/WorkflowImageData 형식)로 변환합니다
QR 코드 이미지와 메타데이터를 포함하는 WorkflowImageData 객체를 생성합니다
나중에 재사용할 수 있도록 결과를 캐시에 저장합니다(캐시는 100개 항목을 수용하고 TTL은 1시간입니다)
QR 코드 이미지를 반환합니다
이 블록은 데이터 길이를 기준으로 QR 코드 크기를 자동으로 최적화(auto-sizing)하여, 데이터 인코딩에 충분히 크지만 불필요하게 크지는 않도록 보장합니다. 오류 정정 수준은 데이터 용량과 오류 복구 사이의 절충을 제공합니다: 더 높은 오류 정정은 QR 코드가 일부 손상되거나 가려져 있어도 스캔할 수 있게 해 주지만, 최대 데이터 용량은 줄어듭니다. 이 블록은 동일한 QR 코드를 여러 번 생성할 때 성능을 향상시키기 위해 캐싱을 사용합니다. 이는 동일한 URL이나 데이터를 위한 QR 코드를 반복적으로 생성하는 워크플로에서 흔합니다.
일반적인 사용 사례
URL 및 링크 인코딩: URL 및 웹 링크용 QR 코드를 생성합니다(예: 제품 페이지용 QR 코드 생성, 문서 링크용 QR 코드 생성, 모바일에서 쉽게 접근할 수 있도록 URL 인코딩), QR 코드 스캔을 통해 웹 리소스에 빠르게 접근할 수 있게 합니다
데이터 인코딩 및 공유: 텍스트 데이터, 식별자 또는 정보를 QR 코드로 인코딩합니다(예: 제품 ID용 QR 코드 생성, 일련번호 인코딩, 재고 추적용 QR 코드 생성), 기계가 판독할 수 있는 데이터 인코딩과 공유를 가능하게 합니다
문서 및 보고서 생성: 생성된 문서나 보고서에 QR 코드를 포함합니다(예: 상세 데이터로 연결되는 QR 코드를 PDF 보고서에 추가, 생성된 이미지에 QR 코드 삽입, 서식화된 출력에 QR 코드 포함), 스캔 가능한 링크가 있는 대화형 문서 기능을 가능하게 합니다
워크플로 결과 공유: 워크플로 결과나 출력으로 연결되는 QR 코드를 생성합니다(예: 탐지 결과를 가리키는 QR 코드 생성, 분석 보고서 링크 인코딩, 워크플로 출력 공유용 QR 코드 생성), QR 코드 스캔을 통해 워크플로 생성 콘텐츠를 쉽게 공유하고 접근할 수 있게 합니다
라벨 및 태그 생성: 라벨링 및 식별 목적의 QR 코드를 생성합니다(예: 자산 태그용 QR 코드 생성, 제품 라벨용 QR 코드 생성, 식별 정보 인코딩), 자동화된 라벨 및 태그 생성 워크플로를 가능하게 합니다
통합 및 자동화: 자동화된 워크플로의 일부로 QR 코드를 생성합니다(예: 자동 문서 처리용 QR 코드 생성, 워크플로 자동화 트리거용 QR 코드 생성, 시스템 통합용 데이터 인코딩), 자동화된 프로세스의 일부로 QR 코드 생성을 가능하게 합니다
다른 블록에 연결하기
이 블록은 텍스트 입력을 받아 QR 코드 이미지를 생성합니다:
데이터 처리 블록 다음 (예: Expression, Property Definition)로, 계산된 값, URL 또는 처리된 데이터를 QR 코드로 인코딩하는 텍스트 출력을 생성하여 워크플로가 생성한 데이터의 기계 판독 가능한 인코딩을 가능하게 합니다
시각화 블록 이전 다른 이미지와 QR 코드를 오버레이하거나 결합할 수 있는(예: 이미지 위에 QR 코드 오버레이, QR 코드를 탐지 시각화와 결합, 합성 이미지에 QR 코드 삽입) 기능으로, QR 코드의 시각적 출력 통합을 가능하게 합니다
포매터 블록 이전에 (예: CSV Formatter)에서 형식화된 출력에 QR 코드 참조나 링크를 포함하여 구조화된 데이터 내보내기에 QR 코드 통합을 가능하게 합니다
싱크 블록 이전에 (예: Local File Sink, Webhook Sink)에서 생성된 QR 코드 이미지를 저장하거나 전송하여 QR 코드 배포 및 저장을 가능하게 합니다
문서 생성 워크플로에서 QR 코드를 문서나 보고서에 삽입해야 하는 경우, 스캔 가능한 코드로 상호작용형 문서 기능을 가능하게 합니다
탐지 또는 분석 블록 뒤에서 탐지 결과 또는 분석 출력으로 연결되는 QR 코드를 생성하여 QR 코드 스캔을 통해 워크플로 결과를 쉽게 공유하고 접근할 수 있게 합니다
유형 식별자
단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/qr_code_generator@v1 워크플로우에 이 블록을 단계로 추가하려면.
속성
이름
유형
설명
참조
name
str
이 단계에 대한 고유 식별자를 입력하세요..
❌
text
str
QR 코드에 인코딩할 텍스트, URL 또는 데이터입니다. URLs(예: 'https://roboflow.com'), 텍스트 메시지, 식별자, 일련번호 또는 기타 데이터를 포함한 모든 문자열 콘텐츠일 수 있습니다. QR 코드는 데이터 길이에 따라 자동으로 크기를 조정합니다. 더 긴 텍스트는 더 큰 QR 코드나 더 낮은 오류 정정 수준이 필요합니다. 최대 데이터 용량은 선택한 오류 정정 수준에 따라 달라집니다..
✅
error_correct
str
QR 코드가 스캔 가능한 상태를 유지하면서 견딜 수 있는 손상 또는 가림의 정도를 결정하는 오류 정정 수준입니다. 더 높은 오류 정정은 QR 코드가 부분적으로 손상되었거나 가려졌거나 변형되었더라도 스캔할 수 있게 해 주지만, 최대 데이터 용량(텍스트 길이)은 줄어듭니다. QR 코드가 선명하게 보이고 손상되지 않을 때 최대 데이터 용량을 원하면 'Low'를 선택하세요. 균형 잡힌 용량과 오류 복구를 원하면 'Medium'(기본값)을 선택하세요. QR 코드가 부분적으로 가려지거나 손상되었거나 어려운 각도에서 스캔해야 할 수 있을 때는 'Quartile' 또는 'High'를 선택하세요. 절충점: 더 높은 오류 정정 = 더 나은 오류 복구이지만 더 적은 데이터 용량입니다..
❌
border
정수
모듈 단위의 테두리 두께(QR 코드 단위)입니다. 기본값은 4 모듈입니다. 테두리는 QR 코드 패턴 주위의 여백 영역으로, QR 코드 스캐너가 코드를 식별하고 디코딩하는 데 도움이 됩니다. 더 큰 테두리는 스캔 안정성을 높이지만 이미지 크기도 커집니다. 최소 권장 테두리는 4 모듈입니다. 테두리는 QR 코드 모듈 단위로 측정됩니다(픽셀이 아님 - 실제 픽셀 테두리 크기는 모듈당 10픽셀로 고정된 box_size에 따라 달라집니다)..
✅
fill_color
str
QR 코드 패턴 블록(QR 코드의 어두운 사각형) 색상입니다. 기본값은 'BLACK'입니다. 여러 색상 형식을 지원합니다: hex 코드(예: 빨간색 '#FF0000', 검은색 '#000000'), RGB 문자열(예: 'rgb(255, 0, 0)'), 표준 색상 이름(예: 'BLACK', 'WHITE', 'RED', 'BLUE') 또는 CSS3 색상 이름. 채우기 색상은 안정적인 스캔을 위해 배경색과 충분한 대비를 이루어야 합니다. 전통적인 흰색 배경에 검은색 조합이 가장 높은 스캔 신뢰성을 제공합니다..
✅
back_color
str
QR 코드의 배경 색상(패턴 블록 사이의 밝은 영역)입니다. 기본값은 'WHITE'입니다. 여러 색상 형식을 지원합니다: hex 코드(예: 흰색 '#FFFFFF', 검은색 '#000000'), RGB 문자열(예: 'rgb(255, 255, 255)'), 표준 색상 이름(예: 'BLACK', 'WHITE', 'RED', 'BLUE') 또는 CSS3 색상 이름. 배경색은 안정적인 스캔을 위해 채우기 색상과 충분한 대비를 이루어야 합니다. 전통적인 흰색 배경에 검은색 채우기 조합이 가장 높은 스캔 신뢰성을 제공합니다..
✅
이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.
입력 및 출력 바인딩
사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 QR 코드 생성기 버전 v1 을 가지고 있는지.
입력 및 출력 바인딩
입력
text(string): QR 코드에 인코딩할 텍스트, URL 또는 데이터입니다. URLs(예: 'https://roboflow.com'), 텍스트 메시지, 식별자, 일련번호 또는 기타 데이터를 포함한 모든 문자열 콘텐츠일 수 있습니다. QR 코드는 데이터 길이에 따라 자동으로 크기를 조정합니다. 더 긴 텍스트는 더 큰 QR 코드나 더 낮은 오류 정정 수준이 필요합니다. 최대 데이터 용량은 선택한 오류 정정 수준에 따라 달라집니다..border(정수): 모듈 단위의 테두리 두께(QR 코드 단위)입니다. 기본값은 4 모듈입니다. 테두리는 QR 코드 패턴 주위의 여백 영역으로, QR 코드 스캐너가 코드를 식별하고 디코딩하는 데 도움이 됩니다. 더 큰 테두리는 스캔 안정성을 높이지만 이미지 크기도 커집니다. 최소 권장 테두리는 4 모듈입니다. 테두리는 QR 코드 모듈 단위로 측정됩니다(픽셀이 아님 - 실제 픽셀 테두리 크기는 모듈당 10픽셀로 고정된 box_size에 따라 달라집니다)..fill_color(string): QR 코드 패턴 블록(QR 코드의 어두운 사각형) 색상입니다. 기본값은 'BLACK'입니다. 여러 색상 형식을 지원합니다: hex 코드(예: 빨간색 '#FF0000', 검은색 '#000000'), RGB 문자열(예: 'rgb(255, 0, 0)'), 표준 색상 이름(예: 'BLACK', 'WHITE', 'RED', 'BLUE') 또는 CSS3 색상 이름. 채우기 색상은 안정적인 스캔을 위해 배경색과 충분한 대비를 이루어야 합니다. 전통적인 흰색 배경에 검은색 조합이 가장 높은 스캔 신뢰성을 제공합니다..back_color(string): QR 코드의 배경 색상(패턴 블록 사이의 밝은 영역)입니다. 기본값은 'WHITE'입니다. 여러 색상 형식을 지원합니다: hex 코드(예: 흰색 '#FFFFFF', 검은색 '#000000'), RGB 문자열(예: 'rgb(255, 255, 255)'), 표준 색상 이름(예: 'BLACK', 'WHITE', 'RED', 'BLUE') 또는 CSS3 색상 이름. 배경색은 안정적인 스캔을 위해 채우기 색상과 충분한 대비를 이루어야 합니다. 전통적인 흰색 배경에 검은색 채우기 조합이 가장 높은 스캔 신뢰성을 제공합니다..
출력
qr_code(이미지): 워크플로의 이미지입니다.
마지막 업데이트
도움이 되었나요?