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

getsnapshot

R2026b

단일 이미지 프레임을 즉시 반환합니다.

페이지 내 모두 축소

구문

frame = getsnapshot(obj)
[frame,metadata] = getsnapshot(obj)

설명

frame = getsnapshot(obj)는 비디오 입력 객체 obj에서 단일 이미지 프레임 frame를 즉시 반환합니다.

참고

obj가 실행 중이지만 기록하지 않고 하드웨어 트리거로 구성된 경우 시간 초과 오류가 발생합니다.

getsnapshot 함수를 중단하고 MATLAB® 명령줄로 제어권을 반환하려면 ^C (Ctrl+C) 명령을 실행하십시오.

예제

[frame,metadata] = getsnapshot(obj)는 이미지 프레임에 대한 추가 정보를 반환합니다.

예제

모두 축소

videoinput 함수를 사용하여 비디오 객체를 만듭니다.

obj = videoinput('winvideo')
Summary of Video Input Object Using 'Microsoft® LifeCam Cinema(TM)'.

   Acquisition Source(s):  input1 is available.

  Acquisition Parameters:  'input1' is the current selected source.
                           10 frames per trigger using the selected source.
                           'YUY2_1280x720' video data to be logged upon START.
                           Grabbing first of every 1 frame(s).
                           Log data to 'memory' on trigger.

      Trigger Parameters:  1 'immediate' trigger(s) on START.

                  Status:  Waiting for START.
                           0 frames acquired since starting.
                           0 frames available for GETDATA.

이 카메라의 디폴트 비디오 포맷이 YUY2_1280x720이므로 이미지는 YCbCr 컬러스페이스로 반환됩니다. ReturnedColorSpace 속성 값을 지정하여 컬러스페이스를 rgb로 변경합니다.

obj.ReturnedColorSpace = "rgb";

단일 프레임을 얻으려면 getsnapshot 함수를 사용하십시오.

frame = getsnapshot(obj);

프레임을 Figure 창에 표시합니다.

imagesc(frame)

Rubik's cube

지원 장치의 활성화된 모든 구성 요소에 대한 스냅샷을 확보합니다. 구성 요소 선택 및 활성화에 대한 자세한 내용은 componentInfo 페이지의 Configure Hardware and View Component Settings 항목을 참조하십시오.

  • data = getsnapshot(vid)
    data =

  struct with fields:

         Range: [480×640×3 single]
     Intensity: [480×640 uint16]
    Confidence: [480×640 uint16]

입력 인수

모두 축소

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

예: videoinput("matrox")

출력 인수

모두 축소

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

H

객체의 ROIPosition 속성에 지정된 이미지 높이

W

객체의 ROIPosition 속성에 지정된 이미지 너비

B

NumberOfBands 속성에 지정된 색 대역 수

반환된 데이터 프레임은 비디오 입력 객체의 FramesPerTrigger 속성과 독립적이며 FramesAvailable 또는 FramesAcquired 속성의 값에 영향을 미치지 않습니다.

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

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

여러 구성 요소에 대한 데이터를 가져올 때, 이 함수는 각 구성 요소마다 하나의 필드를 가진 구조체를 반환합니다. 각 필드 이름은 컴포넌트 이름과 일치하며, 그 값은 여기에 설명된 대로 배열입니다. 다중 구성 요소 지원은 GenICam™ GenTL 호환 하드웨어에서만 사용할 수 있습니다.

data의 프레임에 대한 추가 정보는 구조체로 반환됩니다. metadata 구조체에는 프레임이 수집된 절대 시간을 시간 벡터로 표현하는 필드 AbsTime가 포함되어 있습니다. 해당 필드 외에도, 일부 어댑터는 어댑터 고유의 다른 메타데이터를 추가할 수도 있습니다. 예를 들어, GenICam GenTL 호환 카메라는 chunkDataInfo 함수에서 확인한 구성에 따라 청크 메타데이터를 반환하는 ChunkData 필드를 가질 수 있습니다.

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| |

도움말 항목