QR 코드 생성기

1. 사전적 정의 및 도구 설명
이 도구는 텍스트나 URL을 입력하면 즉시 스캔 가능한 QR 코드를 생성하고 이미지로 저장하거나 복사할 수 있는 온라인 생성기입니다.
QR 코드는 흑백 격자 모듈에 데이터를 배치하고 오류 보정 레벨을 적용해 일부 손상이나 가림이 있어도 복원이 가능하도록 설계된 2차원 바코드입니다.
오류 보정 레벨은 L M Q H 네 가지가 있으며 레벨이 높을수록 손상에 더 강하지만 같은 내용이라도 코드가 촘촘해져 스캔 난도가 올라갑니다.
옵션에서 오류 보정 크기 여백 색상을 조절해 인쇄용부터 화면용까지 다양한 상황에 맞게 최적화할 수 있습니다.
전경과 배경 색을 바꿀 수 있지만 명도 대비가 충분하지 않으면 스캐너 인식률이 급격히 떨어질 수 있습니다.
여백은 코드 주위를 둘러싼 조용한 영역으로 스캐너가 경계를 구분하는 데 매우 중요합니다.
이 도구는 모듈 크기와 별도로 바깥쪽 여백 픽셀을 추가해 다양한 배치에서도 인식 안정성을 높입니다.
생성된 이미지는 미리보기 영역에 캔버스로 표시되며 PNG 파일로 다운로드하거나 클립보드로 직접 복사할 수 있습니다.
자동 업데이트를 켜면 입력과 옵션 변경마다 실시간으로 다시 렌더링되고 껐을 때는 생성 버튼으로 수동 갱신합니다.
브라우저에서 모든 연산이 수행되므로 입력 데이터가 외부 서버로 전송되지 않습니다.
긴 텍스트는 더 많은 모듈을 필요로 하므로 같은 픽셀 크기에서는 셀당 크기가 작아져 스캔이 어려워질 수 있습니다.
이 경우 코드 크기를 키우거나 오류 보정 레벨을 낮추고 여백을 충분히 확보하는 것이 권장됩니다.

2. 알고리즘 설명
생성은 qrcodejs 라이브러리를 사용하여 브라우저 내에서 수행됩니다.
입력 텍스트와 옵션을 읽어 라이브러리 인스턴스를 만들고 원하는 크기와 색상 그리고 오류 보정 레벨을 전달합니다.
오류 보정은 L M Q H를 QRCode CorrectLevel 상수로 매핑해 내부 부호화 단계에서 적용됩니다.
라이브러리는 환경에 따라 캔버스 또는 이미지를 생성할 수 있으므로 결과가 이미지일 때는 새 캔버스에 그려 통일합니다.
바깥 여백은 기존 캔버스를 받아 더 큰 새 캔버스를 만들고 배경색으로 채운 뒤 중앙에 원본을 붙여넣는 방식으로 구현됩니다.
이 방식은 모듈 스케일을 건드리지 않으면서도 충분한 조용한 영역을 보장합니다.
색상 선택기는 전경과 배경을 직접 지정하며 전경은 모듈 색 배경은 바탕색으로 사용됩니다.
명암 대비가 낮을 경우 스캐너가 경계를 인식하기 어려우므로 높은 대비를 유지하는 것이 중요합니다.
크기 입력은 64에서 1024 픽셀 사이로 클램프되어 지나치게 큰 렌더링으로 인한 성능 저하를 방지합니다.
여백 입력은 0에서 64 픽셀 사이로 제한하여 잘못된 배치로 인한 잘림을 예방합니다.
생성 직후 미리보기 영역을 비우고 새 결과만 남겨 중복 노드를 방지합니다.
PNG 다운로드는 현재 캔버스를 데이터 URL로 변환해 가상 링크를 클릭하는 방식으로 저장됩니다.
이미지 복사는 Clipboard API와 ClipboardItem을 사용하여 현재 캔버스의 PNG 블롭을 클립보드에 기록합니다.
일부 브라우저에서는 이미지 복사가 지원되지 않을 수 있으므로 경고 메시지로 안내합니다.
자동 업데이트가 켜진 경우 입력과 옵션의 input 또는 change 이벤트에서 호출되어 즉시 재생성합니다.
꺼진 경우에는 생성 버튼을 누를 때만 렌더링해 잦은 재계산을 피할 수 있습니다.
텍스트는 유니코드로 처리되며 한글과 이모지 같은 멀티바이트 문자도 정상적으로 인코딩됩니다.
데이터 양이 많아 모듈 수가 극단적으로 커지면 스캔 실패가 발생할 수 있으므로 적절한 길이와 옵션 선택이 필요합니다.

3. 활용 예시
(예시 1)
입력 텍스트 https colon slash slash example com promo
옵션 오류 보정 M 크기 256 여백 8 전경 검정 배경 흰색 자동 업데이트 ON
예상 결과 선명한 흑백 QR이 생성되고 PNG 다운로드와 이미지 복사 버튼으로 배포용 파일을 즉시 얻을 수 있습니다.
설명 웹 링크와 같이 비교적 짧은 데이터는 중간 수준의 오류 보정과 충분한 여백으로 인쇄와 화면 모두에서 잘 인식됩니다.
(예시 2)
입력 텍스트 Wi Fi 설정 문자열 또는 긴 안내 문구
옵션 오류 보정 H 크기 512 여백 16 전경 짙은 남색 배경 흰색 자동 업데이트 OFF
예상 결과 더 촘촘한 모듈이 생성되며 큰 크기와 넉넉한 여백으로 스캔 안정성을 확보합니다.
설명 데이터가 길거나 스티커 인쇄처럼 손상 가능성이 있을 때는 높은 오류 보정과 큰 픽셀 크기를 선택하는 것이 좋습니다.