이미지에 텍스트 워터마크를 넣고 PNG로 받는 방법
이미지를 base64 문자열로 입력하고 문구, 불투명도, 위치, 글자 크기를 지정하면 텍스트 워터마크를 넣을 수 있습니다. 성공한 결과는 PNG 이미지 데이터로 반환됩니다.
이미지에 텍스트 워터마크를 넣는 방법
이 도구는 이미지 데이터 위에 지정한 문구를 워터마크로 표시하고, 처리가 끝나면 PNG 이미지 데이터로 반환합니다. 이미지 데이터는 base64로 인코딩된 문자열로 입력해야 하므로, 먼저 사용할 이미지를 해당 형식으로 준비하세요. 별도의 워터마크 이미지 파일을 겹쳐 놓는 방식이 아니라 텍스트를 이미지 위에 렌더링하는 용도입니다.
입력부터 결과 확인까지
- 사용할 이미지를 base64 문자열로 준비해 이미지 입력란에 넣습니다. 이미지 입력이 비어 있으면 처리가 진행되지 않습니다.
- 워터마크 문구를 입력합니다. 문구를 지정하지 않으면 기본 문구인
Watermark가 사용됩니다. - 불투명도를 0.0부터 1.0 사이에서 정합니다. 값을 생략하면 기본값 0.5가 적용되며, 허용 범위를 벗어난 값은 적용 전에 해당 범위 안으로 제한됩니다.
- 위치를 선택합니다. 선택할 수 있는 위치는 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래, 가운데입니다. 이 목록에 없는 값은 가운데 배치로 처리됩니다.
- 글자 크기를 입력합니다. 지정하지 않으면 기본값 36이 사용됩니다.
- 입력과 설정을 확인해 실행합니다. 성공하면 결과를 PNG 이미지 데이터로 받습니다.
결과의 의미와 처리 한계
성공한 결과는 원본 이미지 위에 지정한 텍스트가 표시된 PNG 형식의 이미지 데이터입니다. 불투명도는 0.0에 가까울수록 희미하게, 1.0에 가까울수록 진하게 보이도록 조정할 수 있습니다. 위치를 따로 정하지 않으면 가운데에 배치되며, 지원 목록 밖의 위치도 가운데 배치로 처리됩니다.
결과가 나오지 않으면 입력 문자열이 비어 있지 않은지 먼저 확인하세요. 이후 base64 해석, 이미지 열기, 텍스트 렌더링, 합성 또는 PNG 인코딩 과정에서 문제가 발생했는지 살펴볼 수 있습니다. 필요한 이미지 처리 기능을 사용할 수 없거나 처리 중 예외가 발생한 경우에도 실패할 수 있으므로, 같은 설정을 반복하기보다 이미지 데이터와 입력 형식을 다시 점검하는 편이 좋습니다.
사용 예시
검토용 표시가 필요한 이미지에 검토용 텍스트를 오른쪽 아래에 넣어 PNG 결과를 확인합니다.
이미지를 base64 문자열로 입력하고 워터마크 문구를 검토용, 위치를 오른쪽 아래, 불투명도를 0.7로 지정한 뒤 실행합니다.
입력 이미지 위에 검토용이라는 텍스트가 오른쪽 아래에 표시된 PNG 이미지 데이터가 반환됩니다.
제한 사항
- 이미지 처리 기능을 사용할 수 없거나 디코딩, 열기, 렌더링, 합성, 인코딩 중 예외가 발생하면 결과를 받지 못할 수 있습니다.
자주 발생하는 오류
- 이미지 입력란에 base64 문자열을 넣지 않았거나 값이 비어 있으면 처리가 시작되지 않습니다. 이미지를 base64 형식으로 다시 인코딩한 뒤, 문자열 전체가 누락 없이 입력되었는지 확인하세요.
자주 묻는 질문
어떤 형식으로 이미지를 입력해야 하나요?
이미지 입력은 base64로 디코딩되는 문자열이어야 하며, 값이 비어 있으면 처리가 진행되지 않습니다.
워터마크 문구를 생략하면 어떻게 되나요?
문구를 지정하지 않으면 Watermark가 사용됩니다. 직접 문구를 입력하면 해당 텍스트가 이미지 위에 표시됩니다.
결과가 PNG로 나오지 않거나 처리가 실패하는 이유는 무엇인가요?
성공한 경우 결과는 PNG 이미지 데이터입니다. 다만 이미지 디코딩, 열기, 렌더링, 합성 또는 인코딩 중 문제가 생기면 처리가 실패할 수 있습니다.