read

하나 이상의 비디오 프레임 읽기

구문

video = read(v)

video = read(v,index)

video = read(___,'native')

설명

video = read(v)는 v와 연결된 파일에서 모든 비디오 프레임을 읽어 들입니다.

video = read(v,index)는 index에서 지정한 프레임만 읽어 들입니다.

video = read(___,'native')는 데이터를 VideoFormat 속성에서 지정한 형식으로 반환하며, 위에 열거된 구문의 어떠한 입력 인수도 포함할 수 있습니다.

예제

프레임 인덱스를 사용하여 비디오 프레임 읽기

샘플 비디오 파일 xylophone_video.mp4에 대한 VideoReader 객체를 만듭니다.

v = VideoReader("xylophone_video.mp4");

첫 번째 비디오 프레임만 읽습니다.

firstFrame = read(v,1);

마지막 비디오 프레임만 읽습니다.

lastFrame = read(v,Inf);

프레임 5~10을 읽습니다.

earlyFrames = read(v,[5 10]);

50번째 프레임에서 비디오 파일의 끝까지 읽습니다.

lateFrames = read(v,[50 Inf]);

비디오 프레임 변수의 크기 및 유형 정보를 표시합니다.

whos *Frame*

  Name               Size                     Bytes  Class    Attributes

  earlyFrames      240x320x3x6              1382400  uint8              
  firstFrame       240x320x3                 230400  uint8              
  lastFrame        240x320x3                 230400  uint8              
  lateFrames       240x320x3x92            21196800  uint8              

VideoReader 객체를 지웁니다.

clear v

입력 인수

v — 입력 VideoReader 객체

VideoReader 객체

입력 VideoReader 객체입니다. VideoReader 함수를 사용하여 비디오 파일에서 VideoReader 객체를 만듭니다.

index — 읽을 프레임

[1 Inf] (디폴트 값) | 숫자형 스칼라 | 요소를 2개 가진 배열

읽을 프레임으로, 숫자형 스칼라나 요소를 2개 가진 배열로 지정됩니다.

• 단일 프레임을 읽으려면 숫자형 스칼라를 지정하십시오.

• 프레임의 범위를 읽으려면 요소를 2개 가진 배열을 지정하십시오.

첫 번째 프레임 번호는 1이고, Inf는 파일의 마지막 프레임을 나타냅니다.

예: 10

예: Inf

예: [1 20]

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

출력 인수

video — 비디오 프레임 데이터

숫자형 배열 | 구조체형 배열

비디오 프레임 데이터로, 숫자형 배열이나 구조체형 배열로 반환됩니다. video의 크기와 형식은 v의 VideoFormat 속성에 따라 달라집니다. v의 VideoFormat 속성이 'Indexed' 또는 'Grayscale'일 때 video의 데이터형과 차원은 read를 'native' 인수와 함께 호출하는지에 따라 달라집니다. 대부분의 파일에서 video의 데이터형과 차원은 다음과 같습니다.

H는 이미지 프레임 높이이고, W는 이미지 프레임 너비, F는 읽어 들인 프레임 수입니다.

obj.VideoFormat의 값	video의 데이터형	video의 차원	설명
'RGB24'('native'를 지정하거나 지정하지 않음)	uint8	H×W×3×F	RGB24 이미지
'Grayscale'('native'를 지정하지 않음)	uint8	H×W×1×F	회색조 이미지
'Indexed'('native'를 지정하지 않음)	uint8	H×W×3×F	RGB24 이미지
'Grayscale' 또는 'Indexed'('native'를 지정함)	struct	1×F	각각 cdata 필드와 colormap 필드를 포함하는 프레임 구조체 배열로 구성된 배열인 MATLAB® 동영상.

Motion JPEG 2000 파일의 경우, video의 데이터형과 차원은 다음과 같습니다.

obj.VideoFormat의 값	video의 데이터형	video의 차원	설명
'Mono8'	uint8	H×W×1×F	단색 이미지
'Mono8 Signed'	int8	H×W×1×F	단색의 부호 있는 이미지
'Mono16'	uint16	H×W×1×F	단색 이미지
'Mono16 Signed'	int16	H×W×1×F	단색의 부호 있는 이미지
'RGB24'	uint8	H×W×3×F	RGB24 이미지
'RGB24 Signed'	int8	H×W×3×F	RGB24의 부호 있는 이미지
'RGB48'	uint16	H×W×3×F	RGB48 이미지
'RGB48 Signed'	int16	H×W×3×F	RGB48의 부호 있는 이미지

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• read에 대한 코드 생성 시 선택적 위치 인수 native는 지원되지 않습니다.

• 행 우선 레이아웃을 사용하는 코드 생성 — Generate Code That Uses Row-Major Array Layout (MATLAB Coder).

버전 내역

R2010b에 개발됨

참고 항목

movie | VideoReader | readFrame