1. 기능 설명
a. 업로드 단계에서 용량을 축소해 저장할 수 있도록 Matrix.ShowImageEditor API를 통해 표시되는 이미지 에디터에 「압축 용량」 입력 필드가 추가되었습니다.
b. 이미지 에디터에 붙여넣은 이미지를 삭제하거나 교체할 수 있는 기능도 추가되었습니다.
2. 주요 기능
a. 「압축 용량」 입력 필드 추가
- Matrix.ShowImageEditor API를 호출하여 이미지 에디터 팝업을 오픈하는 경우에만 압축 용량 입력 필드가 노출됩니다.
- 이미지 선택 팝업의 [클립보드 복사]에서 이미지 에디터가 열리는 경우 「압축 용량」 입력 필드가 출력되지 않습니다.
[이미지 에디터 화면 추가]
| 기능 | 동작 |
|---|
| 미리보기 | 입력값 변경 시 미리보기 화면이 즉시 갱신 |
| 압축 용량 | 목표 용량 (KB) 입력 시 해상도를 자동 축소하여 입력한 용량 (KB) 이하로 저장 |
| 원본 용량 표시 | 붙여 넣은 이미지의 PNG 용량을 입력 필드 우측에 표시 (예: / 12.34KB 형식) |
b. 그 외 기능
- 이미지 선택 팝업의 [클립보드 복사]에서 이미지 에디터가 열리는 경우
기능 | 동작 |
|---|
이미지 삭제 | 이미지 클릭 후 Delete 키를 입력합니다. |
이미지 교체 | 이미지 클릭 후 교체할 이미지를 복사하여 `Ctrl + V`를 통해 붙여넣습니다. |
3. 이미지 압축
a. i-AUD 보고서에서 ScriptEditor를 열어, Matrix.ShowImageEditor API를 호출하여 이미지 에디터를 엽니다.
- 이미지 선택 팝업의 [클립보드 복사]에서 이미지 에디터가 열리는 경우 「압축 용량」 입력 필드가 출력되지 않습니다.
![연구 개발 매뉴얼 > [i-AUD] ShowImageEditor API 이미지 에디터에 이미지 압축 기능이 추가되었습니다. > 스크린샷 2026-05-18 185704.png](/download/attachments/151650453/%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%202026-05-18%20185704.png?version=1&modificationDate=1779098610734&api=v2)
Matrix.ShowImageEditor는 이미지 에디터 팝업을 표시하는 API입니다. Matrix.ShowImageEditor(function (p) {
// callback function
// p.FolderName;
// p.ImageName;
// p.ImageWidth;
// p.ImageHeight;
}); |
※ CallBack 함수로 넘어오는 파라미터 | 변수명 | 데이터 형식 | 설명 |
|---|
| FolderName | string | 서버에 저장된 이미지 경로(reports 폴더 하위) | | ImageName | string | 이미지 이름 | | ImageWidth | number | 이미지 너비 | | ImageHeight | number | 이미지 높이 |
|
b. 클립보드에 복사된 이미지를 Ctrl+V 로 붙여 넣고, 「압축 용량」 입력 필드 우측에 현재 이미지의 용량을 확인합니다.
[이미지 붙여넣고 현재 이미지 용량 부분 이미지 추가]
c. 필요 시 「압축 용량」 값을 입력하고 미리보기에서 결과를 확인합니다.
입력값 | 동작 |
|---|
0 (기본값) | 붙여 넣은 미리보기 이미지를 그대로 업로드 합니다. | 양의 정수 N (KB) | 파일 크기가 N KB 이하로 이미지 용량을 압축합니다. |
음수 / 소수는 입력 필드에서 자동으로 정수로 보정 됩니다. 입력 가능한 최댓값은 현재 이미지의 원본 용량으로 자동 설정됩니다. 원본보다 큰 값은 입력할 수 없습니다. 입력 값이 매우 작으면 (예: 1) 해상도가 1×1 픽셀까지 줄어들 수 있습니다. 미리보기에서 결과를 반드시 확인해 주십시오.
|
d. [저장] 버튼을 클릭하여 업로드합니다.
4. 이미지 삭제
[이미지 삭제 시 안내 메세지 출력 화면 추가]
a. 이미지 에디터에 이미지가 표시된 상태에서 이미지를 클릭 후 Delete 키를 누르면 "이미지를 삭제하시겠습니까?" 확인창이 표시됩니다.
b. [예] 선택 시 화면이 초기 상태로 돌아가고, 압축 용량의 입력 값도 함께 초기화됩니다.
5. 이미지 교체
[이미지 교체 전 후 화면 추가]
a. 이미지 에디터에 이미지가 표시된 상태에서 다른 이미지를 클립보드에 복사한 후, 이미지 영역을 클릭하고 Ctrl + V 를 누르면 새 이미지로 즉시 교체됩니다.
b. 교체 시 「압축 용량」 값은 0 으로, 원본 용량 표시는 새 이미지 기준으로 갱신됩니다. 새 이미지의 원본 용량이 기준이 되므로 압축값을 다시 입력해 주십시오.
이미지 압축 기능은 새로 이미지를 업로드하는 시점에만 동작하며, 이미 저장된 이미지를 다시 압축하지 않습니다. 「압축 용량」 의 기본값은 0 (압축 안 함) 이므로, 명시적으로 값을 입력하지 않는 한 기존과 동일하게 동작합니다. 이미지 압축은 해상도를 줄이는 방식으로 동작합니다. 입력한 값이 작을수록 이미지가 더 흐려질 수 있으니 미리보기에서 결과를 확인해 주십시오. - 압축한 이미지를 i-AUD 보고서 내 큰 영역에 배치하면 흐릿하게 보일 수 있으므로 표시 영역 크기를 고려하여 적정 KB 값을 지정해 주십시오.
한 번 압축되어 저장된 이미지는 원본으로 되돌릴 수 없습니다. 원본 파일이 필요한 경우 별도로 보관해 주십시오. 변경 사항 | 변경 전 | 변경 후 | 릴리즈 번호 |
|---|
| 변경 후 이미지 또는 현상 설명을 작성 (이미지 크기는 중간 이하로 사용 합니다.) | 7.0.500.20260528-21 |
|
- 샘플 URL : https://rnd.bimatrix.co.kr/aud7/ 또는 https://aud.bimatrix.co.kr 등 외부 접근 위치에 샘플이 있을 경우 보고서 경로를 입력합니다.
- 샘플 파일

|
| BCRM 접수 제목을 번호와 함께 작성 합니다. 예 ) (BCRM#E0070) [i-AUD][조건개인화]조건 개인화 대상 컨트롤이 isReadOnly=true, isEnabled=flase 일때 최종 값이 유지되지 않으면 좋겠습니다. | | 추가 이슈 처리가 있을 경우 표 뒤에 행 추가 한 다음 작성 합니다. |
|
|