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

preview

라이브 비디오 데이터 미리보기

구문

preview(obj)

preview(himage,himage)

hpreview = preview(...)

설명

preview(obj)는 비디오 입력 객체 obj에 대한 라이브 비디오 데이터를 표시하는 비디오 미리 보기 창을 만듭니다. 이 창에는 각 프레임의 타임스탬프와 비디오 해상도, 현재 프레임 속도, obj의 현재 상태도 표시됩니다. 비디오 미리 보기 창에는 비디오 데이터가 100% 배율로 표시됩니다. 미리보기 이미지의 크기는 비디오 입력 객체의 ROIPosition 속성 값에 따라 결정됩니다.

비디오 미리보기 창의 구성 요소

비디오 미리보기 창은 stoppreview를 사용하여 중지하거나 closepreview를 사용하여 닫을 때까지 활성 상태로 유지됩니다. delete(obj)를 호출하여 객체를 삭제하면 비디오 미리 보기 창의 미리 보기가 중지되고 자동으로 닫힙니다.

preview(himage,himage)는 핸들 himage로 지정된 이미지 객체의 비디오 입력 객체 obj에 대한 라이브 비디오 데이터를 표시합니다. preview는 이미지 객체의 전체 영역을 채우도록 이미지 데이터의 크기를 조정하지만 이미지 객체 속성 값은 수정하지 않습니다. 이 구문을 사용하여 사용자가 직접 디자인한 사용자 지정 GUI에서 비디오 데이터를 미리 볼 수 있습니다. 사용자 지정 GUI에 대한 자세한 내용은 Previewing Data in Custom GUIs를 참조하세요.

hpreview = preview(...)는 미리 본 데이터가 포함된 이미지 객체의 핸들인 hpreview를 반환합니다.

예제

비디오 입력에서 미리보기 이미지

이 예제에서는 비디오 입력에서 이미지를 미리 보는 방법, 미리 보기 창을 닫는 방법, 미리 보기를 중지하는 방법을 보여줍니다.

사용자 지정 GUI를 만듭니다.

figure("Name","My Custom Preview Window"); 
uicontrol("String","Close","Callback","close(gcf)"); 

먼저 시스템에서 사용 가능한 어댑터를 확인하려면 imaqhwinfo 함수를 사용하세요.

imaqhwinfo

ans = struct with fields:
    InstalledAdaptors: {'demo'  'gentl'  'gige'  'kinect'  'matrox'  'winvideo'}
        MATLABVersion: '25.1 (R2025a)'
          ToolboxName: 'Image Acquisition Toolbox'
       ToolboxVersion: '25.1 (R2025a)'

관심 있는 어댑터에 맞는 지원 형식을 확인하세요.

info = imaqhwinfo("winvideo");
info.DeviceInfo(2).SupportedFormats

ans = 1×19 cell
    {'RGB24_1024x576'}    {'RGB24_1280x720'}    {'RGB24_1600x896'}    {'RGB24_160x120'}    {'RGB24_160x88'}    {'RGB24_176x144'}    {'RGB24_1920x1080'}    {'RGB24_2304x1296'}    {'RGB24_2304x1536'}    {'RGB24_320x176'}    {'RGB24_320x240'}    {'RGB24_352x288'}    {'RGB24_432x240'}    {'RGB24_640x360'}    {'RGB24_640x480'}    {'RGB24_800x448'}    {'RGB24_800x600'}    {'RGB24_864x480'}    {'RGB24_960x720'}

videoinput 함수를 사용하여 비디오 객체를 만듭니다. adaptorname, deviceid, format를 장치의 어댑터 설정에 맞게 구성하세요.

obj = videoinput("winvideo",2,"RGB24_800X600");
vidRes = obj.VideoResolution; 
nBands = obj.NumberOfBands; 
hImage = image(zeros(vidRes(2),vidRes(1),nBands) ); 
im = preview(obj, hImage); 

미리보기를 중지하고 10초 후에 라이브 이미지 미리보기 창을 닫습니다.

pause(10);
stoppreview(obj)
closepreview(obj)

입력 인수

obj — 비디오 객체

객체

비디오 입력 객체는 videoinput 객체 또는 imaq.VideoDevice System object™ 객체로 지정됩니다.

himage — 미리보기 데이터를 표시할 이미지 객체

Image 객체

미리보기 데이터를 표시할 이미지 객체이며, 이미지 객체 핸들로 지정됩니다.

출력 인수

hpreview — 이미지 객체

Image 객체

미리 보기 데이터가 포함된 이미지 객체가 이미지 객체 핸들로 반환됩니다. 이미지 객체가 포함된 도형 창에 대한 핸들을 얻으려면 ancestor 함수를 사용합니다. 이미지 객체 사용에 대한 자세한 내용은 image를 참조하세요. 반환된 이미지 객체에 대한 자세한 내용은 사용자 정의 업데이트 함수를 참조하십시오.

세부 정보

동영상 미리보기 창 동작

비디오 미리 보기 창의 동작은 비디오 입력 객체의 현재 상태 및 트리거 구성에 따라 달라집니다.

객체 상태	미리보기 창 동작
Running=off	모든 트리거 유형에 대해 장치에서 수집되는 이미지의 라이브 뷰를 표시합니다. 객체 속성 구성에 대한 변경 사항을 반영하기 위해 이미지가 업데이트되었습니다. (FrameGrabInterval 속성은 트리거가 발생할 때까지 무시됩니다.)
Running=on	TriggerType를 immediate 또는 manual로 설정하면 비디오 미리 보기 창에 표시된 이미지가 계속 업데이트됩니다. TriggerType를 hardware로 설정하면 비디오 미리 보기 창은 트리거가 발생할 때까지 표시된 이미지 업데이트를 중지합니다.
Logging=on	비디오 미리 보기 창에서 일부 데이터 프레임이 삭제될 수 있지만, 메모리나 디스크에 기록된 프레임에는 영향을 미치지 않습니다.

참고

Image Acquisition Toolbox™ 미리보기 창은 최대 16비트 이미지 데이터의 표시를 지원합니다. 미리 보기 창은 8비트 데이터만 표시하도록 설계되었지만 많은 카메라는 10, 12, 14 또는 16비트 데이터를 반환합니다. 미리 보기 창 표시는 이러한 더 높은 비트 심도 카메라를 지원합니다. 그러나 더 큰 비트 데이터는 미리 보기 데이터를 표시하는 데 사용하기 위해 8비트로 조정됩니다. 회색조 이미지의 전체 비트 심도로 미리 보기 창에서 이미지 데이터를 캡처하려면 PreviewFullBitDepth 속성을 'on'로 설정합니다.

사용자 정의 업데이트 함수

preview는 이미지 객체 hpreview에 대한 애플리케이션 정의 데이터를 생성하고, 이름을 'UpdatePreviewWindowFcn'로 지정하고 값을 빈 배열([])로 설정합니다. MATLAB^® setappdata 및 getappdata 함수를 각각 사용하여 'UpdatePreviewWindowFcn' 애플리케이션 데이터의 값을 구성하고 해당 값을 검색할 수 있습니다.

'UpdatePreviewWindowFcn'는 수집된 모든 프레임에 대해 반드시 호출되는 것은 아닙니다. 새로운 프레임이 수집되고 이전 프레임의 'UpdatePreviewWindowFcn'가 아직 실행을 완료하지 않은 경우, 새로운 프레임에 대한 업데이트가 생성되지 않습니다. 수집한 모든 프레임에 대해 함수를 실행해야 하는 경우, 대신 FramesAcquiredFcn를 사용하세요.

이 함수를 사용하면 미리 본 이미지 데이터에 대한 사용자 정의 처리를 정의할 수 있습니다. preview가 사용자가 지정한 함수 핸들을 호출하면 함수에 세 개의 인수를 전달합니다.

• obj — 미리 보고 있는 비디오 입력 객체

• event — 이미지 프레임 정보를 포함하는 이벤트 구조. 자세한 내용은 아래를 참조하세요.

• hpreview — 업데이트 중인 이미지 객체에 대한 핸들

이벤트 구조에는 다음과 같은 필드가 포함됩니다.

필드	설명
Data	현재 이미지 프레임은 HxWxB 행렬로 지정됩니다. 여기서 H와 W는 각각 ROIPosition 속성에서 지정된 이미지의 높이와 너비이고, B는 NumberOfBands 속성에서 지정된 색 대역의 수입니다.
Resolution	ROIPosition 속성으로 정의된 현재 이미지의 너비와 높이를 지정하는 문자 벡터입니다.
Status	비디오 입력 객체의 현재 수집 상태를 설명하는 문자 벡터입니다.
Timestamp	현재 이미지 프레임과 관련된 타임스탬프를 지정하는 문자 벡터입니다.
FrameRate	초당 프레임 단위로 비디오 입력 객체의 현재 프레임 속도를 지정하는 문자 벡터입니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

ancestor | closepreview | image | stoppreview

도움말 항목

• Previewing Data in Custom GUIs