팩토리 » Api

createdataurlbyobject

Description

화면내 컴포넌트에 대한 이미지 캡쳐 데이터를 처리한다.

Parameters

Parameters Type Description
objTarget INSTANCE HTML BLOB 오브젝트 또는 HTML File 오브젝트
objCallbackScreen INSTANCE [옵션] 콜백 함수가 포함된 화면 인스턴스 (기본값: null)
strCallbackFuncName STRING [옵션] 이미지 추출 완료시 호출된 함수 이름 (기본값: 공백문자열)
strDataUrlName STRING [옵션] 콜백 함수에 전달될 DataUrl 이름 (기본값: 공백문자열);

Return Value

Type Description
BOOL 정상 처리 여부

Remark

이미지 저장을 위해서, html2canvas.min.js 오픈소스를 사용하고 있으며, 이미지 저장 대상에[ 따라 이미지가 화면에 보이는 것과 다를 수 있다.

getcomponentimagedata API는 비동기 방식으로 동작하므로, 함수 리턴값이 true라고 해서 함수 동작이 완료되었다는 것을 의미하지 않는다.

strCallbackFuncName

objCallbackScreen 파라미터 값이 유효하고, strCallbackFuncName 파라미터에 유효한 함수 이름 지정시, 이미지 데이터 처리 완료시 호출된다. 콜백 함수 사용 방식은 샘플 소스를 참조한다.

strImageFileName 파라미터에 유효한 이름 지정시, 이미지 데이터 처리 완료시 이미지 파일 저장 처리가 진행된다.

nImageType 파라미터는 콜백 함수에 전달된 이미지 데이터 유형을 지정한다. 0이 경우, Data URL 형식으로 전달되고, 1인 경우 이미지 데이터만 BASE64로 인코딩된 형태로 전달된다.

Example

function btn_on_mouseup(objInst) { var ret, blob_object; // 이미지에서 BLOB 오브젝트 생성 blob_object = img.getimageblobobject(1); // BLOB 오브젝트에서 Data URL 생성 시작 // Data URL 생성 완료시 콜백 함수가 호출됨 ret = factory.createdataurlbyobject(blob_object, screen, "on_dataurl_complete", "mydataurl"); if (ret == false) { screen.alert("factory.createdataurlbyobject Fail"); } } // BLOB 오브젝트에서 Data URL 생성 완료 콜백 function on_dataurl_complete(data_url, data_url_name) { // 이미지 컴포넌트에 데이터 URL 설정하여 이미지 표시 img2.setimagedata(data_url); }

See Also

createblobobjectbydataurl
createfileobjectbydataurl

Viewer Ver.

9.1.1.1

Update Date

20230206