레퍼런스 saveFrames()

saveFrames()

캔버스에서 이미지로 저장할 수 있는 프레임 시퀀스(sequence)를 캡처합니다.

saveFrames() 함수는 프레임 객체의 배열을 생성합니다. 각 프레임은 파일 형식, 파일 이름, 이미지 데이터를 문자열로 포함하는 객체로 저장됩니다. 예를 들어, 처음으로 저장된 프레임은 다음과 같은 속성을 가집니다:

{ ext: 'png', filenmame: 'frame0', imageData: 'data:image/octet-stream;base64, abc123' }.

첫 번째 매개변수인 filename은 파일 이름의 앞 부분(prefix)을 설정합니다. 예를 들어, 앞 부분을 'frame'으로 설정하면 이미지 파일 code>frame0.png, frame1.png 등이 생성됩니다.

두 번째 매개변수인 extension은 파일 형식을 'png' 또는 'jpg'로 설정합니다.

세 번째 매개변수인 duration은 초 단위로 녹화할 지속 시간을 설정합니다. 최대 지속 시간은 15초입니다.

네 번째 매개변수인 framerate은 초당 프레임 수(frame per second)를 설정합니다. 최대 초당 프레임 수(frame rate) 값은 22입니다. 메모리 사용량을 줄이기 위해 durationframerate에 제한이 있습니다. 큰 크기의 캔버스를 녹화하면 스케치가 쉽게 충돌하거나 심지어 웹 브라우저가 충돌할 수 있습니다.

다섯 번째 매개변수인 callback은 선택 사항입니다. 함수가 전달되면 이미지 파일은 기본적으로 저장되지 않습니다. 콜백(callback) 함수는 캡처된 각 프레임의 데이터를 포함하는 배열을 처리하는 데 사용될 수 있습니다. 이미지 데이터 배열에는 각 프레임에 대해 세 가지 속성을 가진 객체 시퀀스가 포함됩니다: imageData, filename, extension.

참고: 기본적으로 프레임은 개별 이미지 파일로 다운로드됩니다.

예제

구문

saveFrames(filename, extension, duration, framerate, [callback])

매개변수

filename
String:

파일명의 앞 부분.

extension
String:

파일 확장자, 'jpg' 또는 'png'.

duration
Number:

기록할 지속 시간(초)입니다. 이 매개변수는 15 이하로 제한됩니다.

framerate
Number:

초당 저장할 프레임 수입니다. 이 매개변수는 22 이하로 제한됩니다.

callback
Function(Array):

이미지 데이터를 처리하기 위해 실행될 콜백 함수입니다. 이 함수는 배열을 매개변수로 받아야 합니다. 배열에는 지정된 개수만큼 프레임 객체가 포함됩니다. 각 객체는 세 개의 속성을 가지고 있습니다: imageData, filename, extension.

Notice any errors or typos? Please let us know. Please feel free to edit src/image/image.js and open a pull request!

관련 레퍼런스