바코드 생성기로 PNG 이미지 만드는 방법

사용 목적과 먼저 확인할 항목

바코드 생성기는 입력한 문자열을 바코드 이미지로 바꾸고, 성공한 경우 base64로 인코딩된 PNG 이미지 데이터를 돌려주는 도구입니다. 상품 코드, 문서 식별자, 재고 관리용 값처럼 바코드로 표현할 데이터를 준비했을 때 사용할 수 있습니다. 기본 형식은 Code 128이므로 형식을 별도로 고르지 않아도 기본 설정으로 시작할 수 있습니다.

이 도구에서 확인할 대상은 입력 데이터, 바코드 형식, 이미지 설정, 생성 결과입니다. 데이터 입력은 선택 사항으로 정의되어 있지만, 값을 비워 두면 이미지가 나오지 않고 오류 표시가 포함된 성공 결과가 반환됩니다. 따라서 실제 PNG가 필요하다면 먼저 바코드로 만들 값을 준비하는 편이 좋습니다. 생성이 성공했는지는 단순히 성공 상태만 보지 말고 PNG 이미지 데이터가 결과에 포함되었는지로 판단해야 합니다.

너비, 높이, 바코드 아래의 글자 표시 여부도 결과를 살필 때 함께 고려할 항목입니다. 기본 설정은 너비 400, 높이 100, 글자 표시 사용입니다. 다만 설정한 수치와 결과 PNG의 픽셀 크기가 그대로 일치한다고 보장되지는 않으므로, 최종 사용 전에 결과 이미지를 확인해야 합니다.

입력부터 PNG 결과 확인까지

바코드로 변환할 값을 데이터 입력란에 적습니다. 예를 들어 상품 코드라면 ABC-123처럼 실제로 표현하려는 문자열을 입력합니다. 입력을 비워 둔 상태에서도 요청 자체는 처리되지만, 이 경우 이미지 없이 오류 표시가 포함된 성공 결과가 반환되므로 PNG를 얻는 단계로 진행할 수 없습니다.
형식 선택에서 사용할 바코드 형식을 정합니다. 별도 선택을 하지 않으면 Code 128이 기본으로 적용됩니다. 처음 사용하는 값이 일반 문자열이라면 기본 형식으로 생성한 뒤 결과에 이미지 데이터가 있는지 확인할 수 있습니다. 숫자 전용 형식을 고른 경우에는 표시되는 형식이 요구하는 자릿수를 먼저 확인해야 합니다.
숫자 전용 형식에 값을 넣을 때는 숫자가 아닌 문자가 처리 대상에서 제외될 수 있다는 점을 염두에 둡니다. 입력에 구분 기호나 문자가 섞여 있다면 처리 후 남는 숫자의 개수가 형식의 요구 조건에 맞는지 살펴보세요. 필요한 자릿수보다 적으면 이미지 대신 오류 표시가 반환될 수 있으며, 해당되는 형식에서는 검사 숫자가 바코드 라이브러리에 의해 제공됩니다.
이미지 설정에서 너비와 높이를 입력합니다. 데이터가 비어 있지 않을 때 너비는 정수로 변환된 다음 100에서 2000 사이로 제한됩니다. 높이는 정수로 바뀐 뒤 40에서 600 사이로 제한됩니다. 입력값을 정수로 바꿀 수 없으면 너비는 400, 높이는 100으로 처리됩니다. 따라서 범위를 벗어난 수치나 숫자가 아닌 값을 사용했다면 결과에 반영된 설정을 따로 확인해야 합니다.
바코드 아래에 데이터를 글자로 표시할지 결정합니다. 글자 표시 옵션은 기본적으로 사용 상태입니다. 사람이 바코드 값을 함께 읽어야 하는 상황이면 기본 상태를 유지하고, 표시 여부를 바꾸려면 생성 전에 해당 선택을 조정합니다.
생성 동작을 실행한 뒤 반환된 결과를 살핍니다. 성공하면서 이미지가 만들어진 경우 결과에는 base64로 인코딩된 PNG 이미지 데이터가 포함됩니다. 결과에 이미지 데이터가 없으면 입력 데이터가 비어 있었는지, 숫자 형식의 숫자가 부족했는지, 선택한 형식을 바코드 라이브러리가 제공하는지 차례로 점검합니다. 형식 이름은 소문자화되고 하이픈과 공백이 제거되며, 일부 밑줄 표기는 대응하는 이름으로 정리될 수 있으므로 입력 표기와 처리 결과가 다를 수 있습니다.

반환 결과의 의미와 경계

결과를 사용할 때는 성공 여부와 이미지 데이터의 존재를 함께 확인합니다. 생성이 성공했다면 base64로 인코딩된 PNG 이미지 데이터를 후속 작업에 사용할 수 있습니다. 반대로 데이터가 없는 경우에는 처리 자체가 성공으로 표시될 수 있어도 이미지가 반환되지 않습니다. 이 차이 때문에 성공 상태만으로 바코드 생성 완료를 판단하면 안 됩니다.

숫자 전용 형식에서는 입력 원문과 실제 처리 대상이 달라질 수 있습니다. 숫자가 아닌 문자가 제거될 수 있으므로, 구분 기호를 넣은 값이라면 정리된 뒤 남을 숫자열을 예상해야 합니다. 남은 숫자가 선택한 형식의 요구 자릿수보다 적으면 이미지가 생성되지 않고 오류 표시가 포함된 성공 결과가 나올 수 있습니다.

선택한 형식이 바코드 라이브러리에서 제공되지 않는 경우에도 이미지 대신 오류 표시가 포함된 성공 결과가 반환될 수 있습니다. 바코드 기능을 사용할 수 없거나 생성 중 예외가 발생하면 성공하지 못한 결과와 오류 표시가 반환될 수 있습니다. 그러므로 이미지 데이터가 보이지 않을 때에는 입력값, 형식, 숫자 자릿수, 결과의 오류 표시를 함께 비교하면서 원인을 좁혀야 합니다.

너비와 높이는 입력 요청을 그대로 보존하는 값이 아니라 비어 있지 않은 데이터에 대해 변환과 범위 조정을 거치는 설정입니다. 결과 PNG의 픽셀 크기는 설정한 수치와 일치한다고 단정할 수 없으므로, 인쇄나 화면 배치에 사용하기 전에는 반환된 이미지를 실제 사용 환경에서 확인하는 것이 적절합니다. 글자 표시를 켠 경우에는 바코드와 함께 사람이 읽는 값이 보이는지, 끈 경우에는 의도하지 않은 문자가 표시되지 않는지도 점검할 수 있습니다.

사용 예시

상품 코드 ‘ABC-123’을 인쇄용 바코드 PNG로 준비하려는 상황입니다.

데이터에 ‘ABC-123’을 입력하고 기본 형식인 Code 128을 사용합니다. 너비 500, 높이 120을 지정하고 글자 표시 옵션을 켠 뒤 생성 결과에 이미지 데이터가 포함되었는지 확인합니다.

생성에 성공하면 결과 안에 base64로 인코딩된 PNG 이미지 데이터가 포함됩니다. 실제 PNG의 픽셀 크기는 입력한 너비와 높이와 일치한다고 보장되지 않습니다.

제한 사항

너비와 높이는 정해진 범위로 조정되지만, 반환된 PNG의 실제 픽셀 크기가 입력한 설정과 일치한다고 보장되지는 않습니다.

자주 발생하는 오류

숫자 전용 형식에서 구분 기호를 포함한 입력을 그대로 자릿수로 세면, 숫자가 아닌 문자가 제거된 뒤 필요한 숫자가 부족할 수 있습니다. 처리 후 남는 숫자 개수를 확인하고 선택한 형식의 요구 조건에 맞는 값을 다시 입력하세요.

자주 묻는 질문

데이터를 비워 둔 채 바코드를 만들 수 있나요?

데이터를 입력하지 않은 경우에는 요청이 성공으로 처리될 수 있지만 이미지가 반환되지 않고 오류 표시가 함께 제공됩니다. PNG가 필요하다면 먼저 바코드로 만들 값을 입력해야 합니다.

형식을 선택하지 않으면 어떤 바코드가 생성되나요?

형식을 따로 고르지 않은 경우에는 Code 128이 기본 형식으로 사용됩니다. 다른 형식을 선택했을 때에는 해당 형식이 바코드 라이브러리에서 제공되는지에 따라 이미지 대신 오류 표시가 나올 수 있습니다.

너비와 높이를 지정하면 PNG 크기도 그대로 정해지나요?

비어 있지 않은 데이터를 기준으로 너비는 100에서 2000, 높이는 40에서 600 사이로 조정됩니다. 요청한 수치가 결과 PNG의 픽셀 크기와 그대로 일치한다고 보장되지는 않습니다.