imfinfo

그래픽스 파일에 대한 정보

페이지 내 모두 축소

구문

info = imfinfo(filename)

info = imfinfo(filename,fmt)

설명

예제

info = imfinfo(filename)은 그래픽스 파일 filename 내에 있는 이미지에 대한 정보가 필드에 들어 있는 구조체를 반환합니다.

파일 형식은 파일의 내용에서 유추됩니다.

filename이 둘 이상의 이미지를 포함하는 TIFF, PGM, PBM, PPM, HDF, ICO, GIF, SVS 또는 CUR 파일인 경우, info는 파일의 각 이미지에 대해 하나의 요소를 가지는 구조체형 배열입니다. 예를 들어, info(3)에는 파일의 세 번째 이미지에 대한 정보가 있습니다.

info = imfinfo(filename,fmt)는 MATLAB^®이 파일 filename을 찾을 수 없는 경우에 filename.fmt라는 파일을 추가적으로 찾습니다.

예제

모두 축소

그래픽스 파일에 대한 정보 반환

라이브 스크립트 열기

예제 이미지 ngc6543a.jpg에 대한 정보를 찾습니다.

info = imfinfo('ngc6543a.jpg');

info 구조체는 정보 필드 Filename, FileModDate, FileSize, Format, FormatVersion, Width, Height, BitDepth, ColorType, FormatSignature, NumberOfSamples, CodingMethod, CodingProcess, Comment를 포함합니다.

이 구조체에서 정보(예: CodingMethod)를 표시하려면 명령 창에 info.CodingMethod를 입력하십시오.

info.CodingMethod

ans = 
'Huffman'

이 구조체에 포함된 모든 속성을 표시하려면 명령 창에 info를 입력하십시오.

입력 인수

모두 축소

`filename` — 그래픽스 파일의 이름
문자형 벡터 | string형 스칼라

그래픽스 파일의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

파일의 위치에 따라 filename은 다음 형식 중 하나가 될 수 있습니다.

위치

형식

현재 폴더 또는 MATLAB 경로의 폴더

filename에 파일의 이름을 지정합니다.

예: 'myImage.jpg'

폴더 안의 파일

파일이 현재 폴더나 MATLAB 경로의 폴더에 없는 경우, 전체 경로 또는 상대 경로 이름을 지정합니다.

예: 'C:\myFolder\myImage.ext'

예: '\imgDir\myImage.ext'

URL

파일의 위치가 인터넷 URL인 경우, filename은 프로토콜 유형(예: http://)을 포함해야 합니다.

예: 'http://hostname/path_to_file/my_image.jpg'

원격 위치

파일이 원격 위치에 저장된 경우, filename은 다음 형식과 같이 URL(Uniform Resource Locator)로 지정된 파일의 전체 경로를 포함해야 합니다.

scheme_name://path_to_file/my_file.ext

원격 위치에 따라 scheme_name은 다음 표에 있는 값 중 하나가 될 수 있습니다.

원격 위치	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

예: 's3://bucketname/path_to_file/my_image.jpg'

데이터형: char | string

`fmt` — 이미지 형식
문자형 벡터 | string형 스칼라

이미지 형식으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. fmt에 사용될 수 있는 값은 MATLAB 파일 형식 레지스트리에 포함되어 있습니다. 이 형식 목록을 보려면 imformats 명령을 실행하십시오.

예: 'gif'

데이터형: char | string

출력 인수

모두 축소

`info` — 그래픽스 파일에 대한 정보
구조체형 배열

그래픽스 파일에 대한 정보로, 구조체형 배열로 반환됩니다. info 내의 필드 세트는 개별 파일과 그 형식에 따라 달라집니다. 다음 표에는 항상 포함되는 9개 필드에 대한 설명이 나와 있습니다.

필드 이름	설명	값
`Filename`	파일 이름 또는 지정된 인터넷 URL. 파일이 현재 폴더 내에 없는 경우, 문자형 벡터는 파일의 전체 경로 이름을 포함합니다.	문자형 벡터
`FileModDate`	파일이 마지막으로 수정된 날짜.	문자형 벡터
`FileSize`	파일의 크기(단위: 바이트).	정수
`Format`	파일 형식으로, `fmt`로 지정됨. 가능한 확장자가 두 개 이상인 형식(예: JPEG와 TIFF 파일)에 대해 `imfinfo`는 파일 형식 레지스트리의 첫 번째 형식을 반환합니다.	문자형 벡터
`FormatVersion`	파일 형식 버전.	문자형 벡터나 숫자
`Width`	이미지 너비(단위: 픽셀).	정수
`Height`	이미지 높이(단위: 픽셀). (BMP 파일에 대한 자세한 내용은 팁 항목을 참조하십시오.)	정수
`BitDepth`	픽셀당 비트 수.	정수
`ColorType`	이미지 유형. `ColorType`에는 트루컬러(RGB) 이미지용인 `'truecolor'`, 회색조 명암 이미지용인 `'grayscale'`, 또는 인덱스 이미지용인 `'indexed'` 등의 유형이 있지만 이에 국한되지는 않습니다.	문자형 벡터

일부 파일 형식이 반환한 추가 필드는 다음과 같습니다.

JPEG, DNG 및 TIFF에만 해당 — filename에 EXIF(교환 이미지 파일 형식) 태그가 있는 경우 info는 'DigitalCamera' 또는 'GPSInfo'(GPS 정보) 필드 또한 포함할 수 있습니다.
GIF에만 해당 — imfinfo는 'DelayTime' 필드의 값을 백분의 1초 단위로 반환합니다.
JPEG2000에만 해당 — info 구조체는 m×3 셀형 배열 'ChannelDefinition'을 포함합니다. 'ChannelDefinition'의 첫 번째 열은 파일 내의 채널 위치를 보고합니다. 두 번째 열은 채널의 유형을 보고하고, 세 번째 열은 채널 매핑을 보고합니다.
DNG에만 해당 — imfinfo는 Adobe^® DNG 파일 버전 1.2~1.5에 속하는 태그를 출력 구조체에 개별 명명된 필드로 반환합니다. DNG 파일 태그의 전체 목록은 Adobe Digital Negative (DNG) Specification의 4장을 참조하십시오.

팁

imfinfo를 사용하여 Adobe DNG 파일에 대한 정보를 가져오는 경우 imfinfo는 info 구조체의 'Height' 필드와 'Width' 필드에 미리보기 이미지의 이미지 차원을 반환합니다.
imfinfo를 사용하여 BMP 파일에 대한 정보를 가져오는 경우 imfinfo는 음수 'Height' 값을 포함할 수 있는 info 구조체를 반환합니다. 음수 값은 이미지의 원점이 왼쪽 상단 코너에 있음을 나타냅니다. 이러한 경우, 이미지의 실제 높이(단위: 픽셀)는 'Height' 값의 절댓값입니다.