page no. 

Start Release No : 7.0.500.20260528-21 / Update Release No : 품질에서 작성

작성자 :  박주연  / 검수자 :  검수자가 작성

1. 기능 설명

a. 업로드 단계에서 용량을 축소해 저장할 수 있도록 Matrix.ShowImageEditor API로 오픈하는 이미지 에디터에 「압축 용량」 입력 필드가 추가되었습니다.

b. 이미지 에디터에 붙여넣은 이미지를 삭제하거나 교체할 수 있는 기능도 추가되었습니다.


2. 주요 기능

a. 「압축 용량」 입력 필드 추가

  • Matrix.ShowImageEditor API를 호출하여 이미지 에디터 팝업을 오픈하는 경우에만 압축 용량 입력 필드가 노출됩니다.
  • 이미지 선택 팝업의 [클립보드 복사]에서 이미지 에디터가 열리는 경우 「압축 용량」 입력 필드가 출력되지 않습니다.


기능

동작

미리보기

입력값 변경 시 미리보기 화면이 즉시 갱신

압축 용량

목표 용량 (KB) 입력 시 해상도를 자동 축소하여 입력한 용량 (KB) 이하로 저장

원본 용량 표시

붙여 넣은 이미지의 PNG 용량을 입력 필드 우측에 표시 (예: 12.34 KB 형식)


b. 그 외 기능

  • 이미지 삭제·교체 기능은 Matrix.ShowImageEditor API, Image 컨트롤의 이미지 선택 팝업 내 [클립보드 복사] 에서 공통으로 동작합니다.

기능

동작

이미지 삭제

이미지 클릭 후 Delete 키를 입력합니다.

이미지 교체

이미지 클릭 후 교체할 이미지를 복사하여 Ctrl + V를 통해 붙여넣습니다.


3. 이미지 압축

a. i-AUD 보고서에서 ScriptEditor를 열어, Matrix.ShowImageEditor API를 호출하여 이미지 에디터를 엽니다.

      • 이미지 선택 팝업의 [클립보드 복사]에서 이미지 에디터가 열리는 경우 「압축 용량」 입력 필드가 출력되지 않습니다.

b. 클립보드에 복사된 이미지를 Ctrl+V 로 붙여 넣고, 「압축 용량」 입력 필드 우측에 현재 이미지의 용량을 확인합니다.

c. 필요 시 「압축 용량」 값을 입력하고 미리보기에서 결과를 확인합니다. 


입력값

동작

0 (기본값)

붙여 넣은 미리보기 이미지를 그대로 업로드 합니다.

양의 정수 N (KB)

파일 크기가 N KB 이하로 이미지 용량을 압축합니다.

    • 음수 / 소수는 입력 필드에서 자동으로 정수로 보정됩니다.

    • 입력 가능한 최댓값은 현재 이미지의 원본 용량으로 자동 설정됩니다. 원본보다 큰 값은 입력할 수 없습니다.

    • 입력 값이 매우 작으면 (예: 1) 해상도가 1×1 픽셀까지 줄어들 수 있습니다. 미리보기에서 결과를 반드시 확인해 주십시오

d. 「압축 용량」 값을 입력한 상태에서 [저장] 을 누르면, 미리보기에 보이는 압축 이미지로 업로드할지 묻는 확인창이 표시됩니다. [예] 선택 시 미리보기 상태 그대로 업로드됩니다.


4. 이미지 삭제

a. 이미지 에디터에 이미지가 표시된 상태에서 이미지를 클릭 후 Delete 키를 누르면 "이미지를 삭제하시겠습니까?" 확인창이 표시됩니다.

b. [예] 선택 시 화면이 초기 상태로 돌아가며, 파일명은 초기화되고 「압축 용량」 값은 0 으로 초기화되며 우측의 원본 용량 표시도 사라집니다.

      • 텍스트 입력란에 커서가 있을 때 는 해당 입력 란의 문자가 지워집니다.

5. 이미지 교체

a. 이미지 에디터에 이미지가 표시된 상태에서 다른 이미지를 클립보드에 복사한 후, 이미지 영역을 클릭하고 Ctrl + V 를 누르면 새 이미지로 즉시 교체됩니다.

b. 이미지 교체 시 파일명은 초기화되며, 「압축 용량」 값은 0 으로 초기화되고 우측의 원본 용량 표시는 새 이미지 기준으로 갱신됩니다.



Matrix.ShowImageEditor는 이미지 에디터 팝업을 표시하는 API입니다.

Matrix.ShowImageEditor(function (p) {
	// callback function
	// p.FolderName;
	// p.ImageName;
	// p.ImageWidth;
	// p.ImageHeight;
});


※ CallBack 함수로 넘어오는 파라미터

변수명데이터 형식설명
FolderNamestring서버에 저장된 이미지 경로(reports 폴더 하위)
ImageNamestring이미지 이름
ImageWidthnumber이미지 너비
ImageHeightnumber이미지 높이



  • 이미지 압축 기능은 새로 이미지를 업로드하는 시점에만 동작하며, 이미 저장된 이미지를 다시 압축하지 않습니다.

  • 「압축 용량」 의 기본값은 0 (압축 안 함) 이므로, 명시적으로 값을 입력하지 않는 한 기존과 동일하게 동작합니다.

  • 이미지 압축해상도를 줄이는 방식으로 동작합니다. 입력한 값이 작을수록 이미지가 더 흐려질 수 있으니 미리보기에서 결과를 확인해 주십시오.

  • 압축한 이미지를 i-AUD 보고서 내 큰 영역에 배치하면 흐릿하게 보일 수 있으므로 표시 영역 크기를 고려하여 적정 KB 값을 지정해 주십시오.
  • 한 번 압축되어 저장된 이미지는 원본으로 되돌릴 수 없습니다. 원본 파일이 필요한 경우 별도로 보관해 주십시오.

  • 변경 사항

    변경 전변경 후릴리즈 번호

    Matrix.ShowImageEditor API로 오픈한 이미지 에디터


    Image 컨트롤 > [이미지 선택] > [클립보드 복사] 로 오픈한 이미지 에디터

    Matrix.ShowImageEditor API로 오픈한 이미지 에디터


    Image 컨트롤 > [이미지 선택] > [클립보드 복사] 로 오픈한 이미지 에디터


    7.0.500.20260528-21





기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보
  • 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 일때 최종 값이 유지되지 않으면 좋겠습니다.
추가 이슈 처리가 있을 경우 표 뒤에 행 추가 한 다음 작성 합니다.