QR
QR 위젯은 지정한 문자열을 QR 코드 이미지로 변환해 화면에 표시하는 위젯입니다.
URL·텍스트 등을 QR로 만들어 보여줄 때 사용하며, 중앙에 로고 이미지를 넣을 수 있습니다.
정의 / 역할
QR 위젯은 value에 넣은 문자열을 QR 코드로 인코딩해 정사각형 이미지로 그려줍니다. 배경색과 크기를 설정할 수 있고, 중앙에 로고 이미지를 겹쳐 표시할 수 있습니다.
- 카테고리: Contents
- 기본 배경색:
#FFFFFF(흰색) — QR 모듈과 눈(코너 사각형) 색은 검정으로 고정 - 항상 정사각형으로 표시 (가로·세로 중 작은 값을 한 변으로 사용)
기능
| 기능 | 설명 |
|---|---|
| QR 코드 생성 | value에 넣은 문자열을 QR 코드로 변환해 렌더링합니다. 값이 비어 있으면 자동으로 Lucy Studio가 표시됩니다. |
| 중앙 로고 | image에 이미지를 지정하면 QR 중앙에 로고를 겹쳐 표시합니다. logoRatio로 로고 크기를 조절합니다. |
| 배경색 | color로 QR 배경색을 지정합니다(기본 흰색). QR 모듈·눈 색은 검정으로 고정됩니다. |
| 크기 (정사각형) | width·height 중 작은 값을 한 변으로 사용해 항상 정사각형으로 그립니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- QR 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서
value에 QR로 만들 문자열(URL·텍스트 등)을 입력합니다. - 필요하면
image에 중앙 로고 이미지를 지정하고logoRatio로 크기를 조정합니다. - 필요하면 배경색(
color)·크기(Size)를 조정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
value | QR 코드로 인코딩할 문자열. 비어 있으면 Lucy Studio로 대체됩니다. | 빈 문자열 | 문자열 |
image | QR 중앙에 겹쳐 표시할 로고 이미지 (선택) | 없음 | 이미지 |
placeholder | 값이 비어 있을 때 표시할 대체 텍스트 — 현재 버전에서는 동작하지 않습니다. | 미지정 | 문자열 |
Size | 위젯 크기 — 너비·높이. 미지정 시 배치 영역 또는 200 사용. QR은 둘 중 작은 값을 한 변으로 정사각형 표시 (펼치면 width·height) | 미지정 | 숫자(px) |
color | QR 배경색 (모듈·눈 색은 검정 고정) | #FFFFFF (흰색) | 색상 |
colorBlendMode | 색상 블렌드 모드 — 현재 버전에서는 동작하지 않습니다. | 미지정 | 블렌드 모드 |
fit | 이미지 맞춤 방식 — 현재 버전에서는 동작하지 않습니다. | 미지정 | fill / contain / cover / fitWidth / fitHeight / none / scaleDown |
alignment | 정렬 — 현재 버전에서는 동작하지 않습니다. | center | 정렬 |
repeat | 반복 방식 — 현재 버전에서는 동작하지 않습니다. | noRepeat | repeat / repeatX / repeatY / noRepeat |
centerSlice | 센터 슬라이스 영역 — 현재 버전에서는 동작하지 않습니다. | 미지정 | 사각 영역 |
matchTextDirection | 텍스트 방향 일치 — 현재 버전에서는 동작하지 않습니다. | 꺼짐(false) | 참 / 거짓 |
gaplessPlayback | 갭리스 재생 — 현재 버전에서는 동작하지 않습니다. | 꺼짐(false) | 참 / 거짓 |
isAntiAlias | 안티에일리어싱 — 현재 버전에서는 동작하지 않습니다. | 꺼짐(false) | 참 / 거짓 |
filterQuality | 필터 품질 — 현재 버전에서는 동작하지 않습니다. | low | none / low / medium / high |
semanticLabel | 시맨틱 라벨 — 현재 버전에서는 동작하지 않습니다. | 미지정 | 문자열 |
excludeFromSemantics | 시맨틱 제외 — 현재 버전에서는 동작하지 않습니다. | 꺼짐(false) | 참 / 거짓 |
logoRatio | 한 변 대비 중앙 로고 크기 비율. 0~0.5 범위로 제한됩니다. | 0.28 | 숫자(0~0.5) |
노트
위 표에서 '현재 버전에서는 동작하지 않습니다'로 표시된 이미지 계열 속성(fit·repeat·alignment·filterQuality 등)은 함께 등록되어 있으나 QR 렌더링에 영향을 주지 않습니다.
주의 / 팁
경고
value가 비어 있으면 QR에 자동으로 Lucy Studio가 인코딩됩니다. 원하는 값을 반드시 입력하세요.
팁
중앙 로고를 넣으면 로고가 가린 부분을 보정하기 위해 오류 정정 레벨이 자동으로 높아집니다(로고 없음 M → 로고 있음 Q). logoRatio는 0~0.5로 제한되며 기본값은 0.28입니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 QR (QR) Widget Control 문서에서 확인하세요.