WebP 이미지를 JPEG로 변환하는 방법

WebP를 JPEG로 변환할 때 알아둘 점

WebP 이미지 데이터를 JPEG(JPG) 형식으로 바꾸려면 이미지 파일 자체의 경로가 아니라 base64로 인코딩된 이미지 데이터를 입력해야 합니다. 변환이 완료되면 JPEG 데이터가 다시 base64 문자열 형태로 반환됩니다. 이미지 변환 전에 WebP 데이터를 준비하고, 필요하다면 JPEG 품질 설정을 함께 정하세요.

변환 절차

1. WebP 이미지의 바이너리 데이터를 base64 문자열로 준비합니다. 파일 경로나 웹 주소를 입력하는 방식이 아니라, 이미지 데이터를 base64로 표현한 값을 사용해야 합니다.
2. 준비한 값을 image_data 입력란에 넣습니다. 이 입력은 생략할 수 있지만, 비워 둔 값으로 처리하면 변환이 실패하므로 실제 이미지 데이터를 제공해야 합니다.
3. 필요하면 quality 값을 입력합니다. 값을 지정하지 않으면 기본값 90이 사용되며, 입력한 품질 값은 JPEG 저장 과정에 전달됩니다. 지원 범위나 자동 보정 방식이 확인된 것은 아니므로 임의의 범위를 전제로 입력하지 마세요.
4. 변환을 실행합니다. base64 데이터 해석이나 이미지 처리가 실패하면 성공 결과 대신 작업 실패가 보고됩니다.
5. 성공 결과에서 반환된 base64 문자열을 확인합니다. 이 문자열은 변환된 JPEG 바이트를 base64로 인코딩한 값이므로, JPEG 데이터로 디코딩해 후속 저장이나 전송에 사용하면 됩니다.

결과 읽기와 한계

성공하면 결과는 JPEG 바이트를 base64로 표현한 값입니다. 따라서 화면에서 바로 이미지가 보이는 파일 경로를 기대하기보다, 반환된 문자열을 JPEG 데이터로 디코딩해야 합니다. RGBA 또는 팔레트 모드 이미지라면 JPEG 저장 전에 RGB로 변환됩니다.

입력 데이터가 비어 있거나 base64 해석에 실패하면 변환 결과가 나오지 않습니다. 이미지 처리에 필요한 구성 요소를 사용할 수 없는 경우에도 작업은 실패로 보고됩니다. 이런 실패는 JPEG 결과가 생성되었다는 뜻이 아니므로, 입력 데이터와 처리 환경을 확인한 뒤 다시 시도해야 합니다.

사용 예시

온라인 상품 안내에 넣을 WebP 이미지를 JPEG 데이터로 바꾸려는 상황입니다.

상품 안내에 사용할 WebP 이미지의 데이터를 base64 문자열로 준비하고 image_data에 입력한 뒤, quality는 지정하지 않고 변환을 실행합니다.

변환이 성공하면 JPEG 바이트를 나타내는 base64 문자열 형태의 결과를 확인할 수 있습니다.

제한 사항

• base64 해석이나 이미지 처리 중 예외가 발생하거나 필요한 이미지 처리 구성 요소를 사용할 수 없으면 성공한 JPEG 결과가 반환되지 않습니다.

자주 발생하는 오류

• 이미지 파일 경로나 빈 값을 image_data에 넣으면 실패할 수 있습니다. WebP 이미지 데이터를 base64로 인코딩한 문자열을 입력했는지 확인하세요.

자주 묻는 질문

이미지 데이터를 입력하지 않아도 변환할 수 있나요?

image_data를 비워 두면 변환이 실패합니다. WebP 이미지 데이터를 base64 문자열로 준비해 입력해야 합니다.

JPEG 품질 값은 어떻게 지정하나요?

quality를 생략하면 기본값 90이 사용됩니다. 값을 입력하면 해당 값이 JPEG 저장 과정에 전달되지만, 지원 범위나 자동 보정 방식은 확인된 바가 없습니다.

변환 결과는 어떤 형태로 반환되나요?

변환이 성공하면 JPEG 바이트가 base64로 인코딩된 결과를 받습니다. 반환된 문자열을 JPEG 데이터로 디코딩해야 이미지 데이터로 사용할 수 있습니다.