텍스트나 URL을 QR 코드 이미지로 만드는 방법

QR 코드에 담을 내용과 결과 형식

QR 코드 생성기는 사용자가 제공한 텍스트나 URL을 QR 코드 이미지로 바꾸는 용도로 사용할 수 있습니다. 행사 안내 문구, 짧은 메모, 웹 주소처럼 코드에 담을 내용을 먼저 정하면 입력 과정이 간단해집니다. 내용이 비어 있지 않고 생성이 성공하면 결과는 PNG 이미지이며, 반환 형태는 비어 있지 않은 base64 문자열입니다. 따라서 화면에 바로 표시되는 이미지가 아니라 인코딩된 결과를 받는 경우에도 PNG 데이터로 활용할 수 있습니다. 기본 입력 외에 텍스트, URL, 콘텐츠에 해당하는 별도 입력 방식도 선택할 수 있으므로 사용하는 화면에서 제공되는 입력 위치를 확인하면 됩니다. 이미지의 기본 전경색은 검은색이고 배경색은 흰색입니다. 색상을 바꾸고 싶을 때는 생성 전에 해당 설정을 조정하면 됩니다. 입력할 문구가 길거나 주소에 공백과 기호가 포함되어 있다면 실행하기 전에 내용이 빠지지 않았는지 살펴보는 것이 좋습니다.

입력부터 PNG 결과 확인까지

QR 코드로 만들 텍스트나 URL을 준비합니다. 예를 들어 안내 문구를 그대로 넣거나 웹 주소를 입력할 수 있습니다. 입력 내용을 정한 뒤 기본 입력란을 사용하거나 텍스트, URL, 콘텐츠에 해당하는 입력 방식을 고릅니다. 여러 입력 위치를 동시에 채우기보다 실제로 사용할 한 곳에 내용을 넣어 값이 서로 엇갈리지 않게 합니다.
입력한 값이 공백만 남은 상태가 아닌지 확인합니다. 기본 입력을 생략하면 내용은 빈 값으로 처리되므로, 이 상태에서는 이미지 생성이 시작되지 않습니다. 짧은 테스트 문구를 넣어 동작을 살펴보려는 경우에도 먼저 입력란에 문자를 남겨 두어야 합니다.
필요할 때 이미지 크기를 지정합니다. 크기를 적지 않으면 기본값 256이 사용됩니다. 지정한 값은 정수로 변환된 뒤 64보다 작지 않고 1024보다 크지 않은 범위로 제한됩니다. 숫자로 바꿀 수 없는 값은 256으로 돌아갑니다. 크기 설정은 결과의 기준이 되지만, QR 모듈 배율을 계산하는 과정 때문에 PNG의 실제 가로세로 픽셀 치수는 정규화된 요청값과 달라질 수 있습니다.
오류 복원 수준을 조정하려면 문자열로 L, M, Q 또는 H 중 하나를 입력합니다. 이 값은 대문자로 정리되어 적용됩니다. 지원되지 않는 문자열을 입력하면 M이 사용되므로, 의도한 수준이 있는 경우 네 가지 값 가운데 하나를 선택하는 편이 분명합니다. 별도 설정이 필요하지 않다면 기본값 M을 그대로 둘 수 있습니다.
색상을 바꾸려면 전경색과 배경색을 각각 지정하고, 기본 모양을 원하면 설정하지 않은 채 진행합니다. 기본 조합은 검은색 전경과 흰색 배경입니다. 입력과 선택 사항을 확인한 다음 생성 작업을 실행합니다.
성공 결과에서 비어 있지 않은 base64 문자열을 확인합니다. 이 문자열을 PNG 데이터로 디코딩하면 생성된 이미지 형식과 결과 내용을 이어서 확인할 수 있습니다. 반환된 값이 이미지로 보이지 않는다면 문자열 자체를 일반 문장으로 다루지 말고 PNG 데이터로 처리해야 합니다.

반환값을 읽는 기준과 주의점

성공 결과를 판단할 때는 값이 비어 있지 않은 base64 문자열인지 먼저 봅니다. 그 문자열을 디코딩한 결과가 PNG라면 도구가 반환하는 이미지 형식과 일치합니다. 내용이 빠진 상태에서 실행하면 이미지가 나오지 않는 것이 정상적인 경계이므로, 결과가 없다는 이유만으로 크기나 색상 설정을 먼저 바꿀 필요는 없습니다. 입력이 들어갔는데도 이미지가 반환되지 않는 경우에는 생성 단계의 실패나 필요한 의존성 문제도 원인이 될 수 있습니다. 크기를 64에서 1024 사이로 설정했더라도 최종 PNG의 픽셀 치수는 QR 모듈 배율 계산에 따라 요청한 수치와 달라질 수 있습니다. 반대로 설정하지 않은 크기는 256을 기준으로 처리됩니다. 오류 복원 수준을 지정했다면 L, M, Q, H 가운데 어떤 값을 사용했는지 확인하고, 다른 문자열을 넣었다면 M으로 처리되었다고 해석합니다. 이 도구에서 확인되는 결과는 QR 이미지의 PNG 생성과 반환 형식에 관한 것이므로, 생성된 이미지가 특정 환경에서 어떻게 읽히는지까지 이 결과만으로 판단해서는 안 됩니다. 색상을 지정하지 않은 결과는 검은색 전경과 흰색 배경 조합으로 이해할 수 있습니다. 입력한 텍스트와 주소는 결과를 확인할 때 함께 대조하여 글자 누락이나 입력 위치 착오를 찾는 데 활용합니다.

사용 예시

웹 페이지 주소를 휴대전화로 열 수 있도록 해당 URL을 QR 코드 이미지로 만들려고 합니다.

예를 들어 입력란에 https://example.com을 넣고 기본 크기(256)와 기본 색상을 유지한 상태로 생성한 뒤, 반환된 문자열을 PNG 데이터로 디코딩해 형식을 확인합니다.

입력한 웹 주소가 비어 있지 않고 생성에 성공하면 비어 있지 않은 base64 문자열이 반환되며, 이 문자열을 디코딩한 데이터는 PNG 이미지가 됩니다.

제한 사항

빈 입력에서는 이미지가 생성되지 않으며 생성 단계나 의존성의 실패로 결과가 없을 수도 있습니다. 지정한 크기와 최종 PNG의 픽셀 치수가 달라질 가능성도 있습니다.

자주 발생하는 오류

입력란을 비워 둔 채 실행한 것이 이미지 부재의 원인일 수 있습니다. 텍스트나 URL을 실제 입력 위치에 넣고 다시 생성해 보세요.

자주 묻는 질문

어떤 내용을 QR 코드로 만들 수 있나요?

텍스트나 URL을 넣을 수 있으며, 기본 입력 외에도 텍스트, URL, 콘텐츠에 해당하는 입력 방식을 사용할 수 있습니다. 제공된 내용이 비어 있지 않아야 생성 대상이 됩니다.

QR 코드 이미지 크기를 지정할 수 있나요?

크기를 생략하면 256을 기준으로 처리합니다. 입력한 크기는 정수로 변환되고 64부터 1024까지의 범위로 제한되며, 변환할 수 없는 값은 256으로 대체됩니다.

실행했는데 이미지가 나오지 않으면 어떻게 해야 하나요?

먼저 입력 내용이 비어 있지 않은지 확인하세요. 내용이 있는데도 결과가 없으면 생성 단계나 필요한 의존성에서 실패했을 가능성을 살펴봐야 하며, 성공 결과는 PNG로 해석되는 비어 있지 않은 base64 문자열입니다.