이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

peekdata

가장 최근에 획득한 이미지 데이터

구문

data = peekdata(obj,frames)

설명

data = peekdata(obj,frames)는 frames로 지정된 최신 프레임 수를 포함하는 비디오 데이터를 반환합니다.

peekdata는 이미지 프레임과 실행 제어를 MATLAB^® 작업 공간으로 즉시 반환하는 비차단 함수입니다. 요청하신 데이터가 모두 반환되지 않을 수 있습니다.

peekdata는 start 명령이 실행된 후 객체가 실행 중인 동안에만 사용할 수 있습니다. peekdata는 obj가 실행을 중지한 후 한 번 호출할 수도 있습니다.

참고

peekdata는 데이터의 내용을 보여주는 함수이며, 메모리 버퍼에서 데이터를 삭제하는 함수는 아닙니다. 객체의 FramesAvailable 속성 값은 peekdata에서 반환되는 프레임 수의 영향을 받지 않습니다.

예제

최근 동영상 데이터 가져오기

비디오 입력 객체를 구성합니다.

obj = videoinput("gentl",1);

수집을 시작합니다.

start(obj);

사용 가능한 데이터 프레임 수를 확인하세요.

obj.FramesAvailable

ans =
     10

가능하다면 최근 10개 프레임을 가져오세요.

frames = 10;
data = peekdata(obj,frames);

peekdata 실행 시 메모리 버퍼에서 데이터가 삭제되지 않는지 확인하십시오.

obj.FramesAvailable

ans =
     10

메모리에서 비디오 입력 객체를 제거합니다.

delete(obj)

입력 인수

obj — 비디오 입력 객체

videoinput로 생성된 객체

videoinput 함수의 출력으로 지정된 비디오 입력 객체입니다. obj는 1x1 비디오 입력 객체여야 합니다.

예: videoinput("matrox")

frames — 데이터 프레임 수

양의 정수

데이터 프레임 수를 양의 정수로 지정합니다.

peekdata에서 사용 가능한 프레임 수는 이전 peekdata 호출에서 반환된 마지막 프레임과 그 이후에 획득된 프레임 수를 불러와서 결정됩니다.

obj Running 속성이 on이고 Logging 속성이 off인 경우, peekdata는 하나의 이미지 프레임으로 제한됩니다.

frames 값이 현재 획득한 프레임 수보다 크면, 요청한 프레임 수를 사용할 수 없다는 경고 메시지와 함께 사용 가능한 모든 프레임이 반환됩니다.

예: 12

데이터형: single | double

출력 인수

data — 이미지 데이터

H×W×B×F 배열

이미지 데이터는 H×W×B×F 배열로 반환됩니다.

H	객체의 ROIPosition 속성에 지정된 이미지 높이
W	객체의 ROIPosition 속성에 지정된 이미지 너비
B	NumberOfBands 속성에 지정된 색 대역 수
F	반환된 프레임 수

data는 ReturnedColorSpace 속성으로 지정된 컬러스페이스를 사용하여 기본 데이터 유형으로 MATLAB 작업 공간으로 반환됩니다.

MATLAB image 또는 imagesc 함수를 사용하면 반환된 데이터를 볼 수 있습니다. 여러 프레임을 한 번에 보려면 imaqmontage를 사용하세요.

w

peekdata의 동작은 Running 및 Logging 속성 설정에 따라 달라집니다.

Running	기록	객체 상태	결과
On	Off	객체가 시작되었지만 트리거를 기다리고 있습니다. (TriggerType가 'manual' 또는 'hardware'로 설정되었습니다.) 데이터가 수집되지 않아 사용할 수 있는 데이터가 없습니다.	peekdata는 단일 프레임의 데이터를 반환하며, 두 프레임 이상을 요청한 경우 경고 메시지를 표시합니다.
On	On	객체가 시작되었고, 트리거가 실행되었으며, 객체가 활발하게 데이터를 수집하고 있습니다.	peekdata는 가장 최근에 획득한 n 프레임의 데이터를 반환합니다. 프레임은 버퍼에서 제거되지 않습니다.
Off	Off	요청된 프레임 수를 획득했거나 stop 함수를 호출했기 때문에 객체가 실행을 중지했습니다.	peekdata는 FramesAvailable가 0보다 크다고 가정할 때, 가장 최근에 획득한 n 프레임의 데이터를 반환하기 위해 한 번 호출될 수 있습니다. 그렇지 않으면 peekdata는 오류를 반환합니다. 반환된 프레임은 메모리 버퍼에서 제거되지 않습니다.

참고

peekdata 함수는 디스크 기록 모드에서 실행될 때 데이터를 반환하지 않습니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

getdata | getsnapshot | imaqmontage | propinfo | start