특정 화면을 캡쳐하여 로컬 파일로 저장하는 API이다. 화면에 스크롤이 있는 경우 화면을 자동 스크롤하여 화면 전체를 Capture하는 방식이기 때문에 깜빡임이 있을수 있습니다.
| Parameters | Type | Description |
|---|---|---|
| objScreen | INSTANCE | 대상 화면 인스턴스 |
| strFilePath | STRING | 저장할 파일 절대 경로 |
| strCallbackFunc | STRING | [옵션] 처리결과 수신용 콜백 함수 이름 |
| nJpgQuality | short | [옵션] jpg이미지 퀄리티(0 ~ 100)(기본값:100) |
| bGetImageData | BOOL | [옵션] 이미지데이터 반환여부(기본값:false) |
| Type | Description |
|---|---|
| BOOL | 성공/실패 여부 (Remark 참조) |
* 저장 가능한 이미지포맷은 png, jpg 이다. ** 리턴값 성공/실패 여부는 화면 켭쳐시작요청에 대한 결과이다. 실제 캡쳐의 성공/실패 여부는 콜백 함수를 통해서 확인할 수 있다. *** bGetImageData 파라미터 bGetImageData 파라미터를 true로 지정시, 캡쳐내용을 파일에 저장하지 않고, 콜백함수의 파라미터로 이미지데이터를 전달한다. 이때 strFilePath 파라미터에는 파일경로가 아닌 이미지포맷(png, jpg)을 지정해야 한다.
cef 101버전 이상의 전용 브라우저 환경에서만 동작합니다.
function btn_on_mouseup(objInst)
{
var file_name = "D:\\temp\\screenshot.png";
factory.xplussavescreenshot(this.screen, file_name, "save_screenshot_callback");
}
function save_screenshot_callback(is_success, file_path) {
if (is_success) {
alert("캡쳐 성공 : " + file_path);
}
}
function btn_on_mouseup(objInst)
{
var image_format = "jpg";
factory.xplussavescreenshot(this.screen, image_format, "save_screenshot_imagedata_callback", 100, true);
}
function save_screenshot_imagedata_callback(is_success, file_path, image_data) {
if (image_data) {
// 캡쳐이미지를 이미지컴포넌트에 표시
img.setimagedata(image_data);
}
}