imfinfo

그래픽스 파일에 대한 정보

페이지 내 모두 축소

구문

info = imfinfo(filename)
info = imfinfo(filename,fmt)

설명

info = imfinfo(filename)은 지정된 그래픽스 파일 내에 있는 이미지에 대한 정보를 필드에 포함하는 구조체를 반환합니다. 파일 형식은 파일의 내용에서 유추됩니다.

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

filename이 두 개 이상의 이미지를 포함하는 HEIF 또는 HEIC 파일인 경우 info는 그래픽스 파일 내에 있는 주 이미지에 대한 정보를 필드에 포함하는 구조체를 반환합니다. (R2025a 이후)

예제

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

예제

모두 축소

라이브 스크립트 열기

샘플 이미지에 대한 정보를 찾습니다.

info = imfinfo("ngc6543a.jpg");

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

구조체에서 특정 정보를 표시하려면 해당 필드를 참조하면 됩니다. 예를 들어, 구조체에서 코딩 방법 정보를 표시해 보겠습니다.

info.CodingMethod
ans = 
'Huffman'

입력 인수

모두 축소

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

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

위치

형식

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

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

예: "myImage.jpg"

폴더 안의 파일

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

예: "C:\myFolder\myImage.png"

예: "\imgDir\myImage.bmp"

URL(Uniform Resource Locator)

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

예: "http://my_hostname/my_path/my_image.jpg"

원격 위치

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

scheme_name://path_to_file/my_file.ext

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

원격 위치scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs
HDFS™hdfs

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

예: "s3://my_bucket/my_path/my_image.heif"

이미지 형식으로, 표준 파일 확장자를 나타내는 string형 스칼라 또는 문자형 벡터로 지정됩니다. imformats를 호출하면 지원되는 형식과 해당하는 파일 확장자 목록이 표시됩니다.

예: "png"

출력 인수

모두 축소

그래픽스 파일에 대한 정보로, 구조체형 배열로 반환됩니다. info 내의 필드 세트는 파일과 파일의 형식에 따라 달라집니다. 다음 표에서는 구조체의 필드를 설명합니다.

필드 이름

설명

값

Filename

파일의 이름. 파일이 현재 폴더에 없거나 원격 위치에 있는 경우, Filename은 파일의 전체 경로 또는 주소를 포함합니다.

문자형 벡터

FileModDate

파일이 마지막으로 수정된 날짜.

문자형 벡터

FileSize

파일의 크기(단위: 바이트).

정수

Format

파일 형식으로, 파일 확장자 형식을 취합니다. 가능한 확장자가 두 개 이상인 형식(예: JPEG와 TIFF)에 대해 imfinfo 함수는 파일 형식 레지스트리의 첫 번째 형식을 반환합니다. (자세한 내용은 imformats 항목을 참조하십시오.)

문자형 벡터

FormatVersion

파일 형식 버전.

문자형 벡터나 숫자

Width

이미지 너비(단위: 픽셀).

정수

Height

이미지 높이(단위: 픽셀). (BMP 파일에 대한 자세한 내용은 팁 항목을 참조하십시오.)

정수

BitDepth

픽셀당 비트 수.

정수

ColorType

이미지 유형. ColorType에 사용할 수 있는 값에는 트루컬러(RGB) 이미지용인 'truecolor', 회색조 명암 이미지용인 'grayscale', 인덱스 이미지용인 'indexed' 등의 유형이 있지만 이에 국한되지는 않습니다.

문자형 벡터

AutoOrientedWidth (R2024b 이후)

Exif(Exchangeable Image File Format) Orientation 태그를 적용한 후의 이미지 너비(단위: 픽셀). 파일에 Exif Orientation 태그가 없으면 이 필드의 값은 Width 필드의 값과 같습니다.정수

AutoOrientedHeight (R2024b 이후)

Exif Orientation 태그를 적용한 후의 이미지 높이(단위: 픽셀). 파일에 Exif Orientation 태그가 없으면 이 필드의 값은 Height 필드의 값과 같습니다.정수

참고

HEIF 또는 HEIC 이미지 파일을 지정하면 구조체형 배열에는 BitDepth와 ColorType 필드를 제외한, 테이블의 모든 필드가 포함됩니다.

info 구조체형 배열에는 일부 파일 형식에 쓰이는 추가 필드가 포함됩니다.

  • DNG에만 해당 — imfinfo 함수는 Adobe® DNG 파일 버전 1.5 이하에 속하는 태그를 출력 구조체에 개별 명명된 필드로 반환합니다. DNG 파일 태그의 전체 목록은 Adobe Digital Negative (DNG) Specification의 4장을 참조하십시오.

  • DNG, JPEG, TIFF에만 해당 — filename에 Exif 태그가 있는 경우 info는 DigitalCamera 또는 GPSInfo(GPS 정보) 필드를 포함할 수 있습니다.

  • GIF에만 해당 — info 구조체는 백분의 1초 단위의 값이 포함된 DelayTime 필드를 포함합니다.

  • JPEG에만 해당

    • filename에 내장된 XMP(Extensible Metadata Platform) 메타데이터가 있는 경우 info는 XMPData 필드를 포함합니다. filename의 XMP 메타데이터에 IPTC(국제뉴스통신협의회) 데이터가 있는 경우 이 데이터는 XMPData 필드의 Iptc4xmpCore(코어 메타데이터) 및 Iptc4xmpExt(확장 메타데이터) 하위 필드에 위치합니다.

    • filename에 Exif Orientation 태그가 있는 경우 info는 Exif Orientation 태그 값이 포함된 Orientation 필드를 포함합니다.

  • JPEG 2000만 해당 — info 구조체는 m×3 셀형 배열이 포함된 ChannelDefinition 필드를 포함합니다. 여기서 m은 이미지 데이터의 행 개수입니다.

    • ChannelDefinition의 첫 번째 열은 파일 내의 채널 위치를 보고합니다.

    • ChannelDefinition의 두 번째 열은 채널의 유형을 보고합니다.

    • ChannelDefinition의 세 번째 열은 채널 매핑을 보고합니다.

  • TIFF에만 해당 — info 구조체는 Exif Orientation 태그의 값이 포함된 Orientation 필드를 포함합니다(또는 Exif Orientation 태그가 없는 경우 값 1을 포함합니다).

팁

  • JPEG, TIFF, HEIF 및 HEIC (R2025a 이후) 파일의 경우 info 구조체는 이미지 파일의 Exif Orientation 태그 값이 포함된 Orientation 필드를 포함할 수 있습니다.

    다음 표에서는 AutoOrient 이름-값 인수가 true인 경우 imread 함수가 Exif Orientation 태그 값을 사용하여 이미지 데이터를 변환하는 방법을 보여줍니다.

    Orientation 필드 값변환에 대한 설명
    1변환 없음
    2세로 축에 대해 반사
    3180° 회전
    4세로 축에 대해 반사한 다음 180° 회전
    5세로 축에 대해 반사한 다음 시계 반대 방향으로 90° 회전
    6시계 방향으로 90° 회전
    7세로 축에 대해 반사한 다음 시계 방향으로 90° 회전
    8시계 반대 방향으로 90° 회전

    (R2024b 이후)

  • Adobe DNG 파일의 경우 imfinfo 함수는 info 구조체의 Height 필드와 Width 필드에 미리보기 이미지의 이미지 차원을 반환합니다.

  • BMP 파일의 경우 info 구조체에는 음수의 Height 값이 포함될 수 있습니다. 음수 값은 이미지의 원점이 왼쪽 상단 코너에 있음을 나타냅니다. 이러한 경우, 이미지의 실제 높이(단위: 픽셀)는 Height 값의 절댓값입니다.

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| | | (Image Processing Toolbox)