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

imaqhwinfo

R2026b

사용 가능한 이미지 수집 하드웨어에 대한 정보 표시

페이지 내 모두 축소

    구문

    hwinfo = imaqhwinfo
    hwinfo = imaqhwinfo(adaptorname)
    hwinfo = imaqhwinfo(adaptorname,field)
    hwinfo = imaqhwinfo(adaptorname,deviceID)
    hwinfo = imaqhwinfo(obj)
    hwinfo = imaqhwinfo(obj,field)

    설명

    hwinfo = imaqhwinfo는 시스템에서 사용할 수 있는 이미지 수집 어댑터에 대한 정보를 반환합니다. 어댑터는 MATLAB®와 연결된 이미지 수집 장치 사이의 인터페이스로, 이미지 수집 장치 드라이버를 사용하여 MATLAB와 장치 사이의 정보 교환을 원활하게 합니다.

    예제

    hwinfo = imaqhwinfo(adaptorname)는 지정된 어댑터에 대한 정보를 반환합니다. 반환된 정보에는 어댑터 버전과 어댑터에 사용 가능한 하드웨어가 포함됩니다.

    예제

    hwinfo = imaqhwinfo(adaptorname,field)는 어댑터에 대한 지정된 필드의 정보를 반환합니다. field가 셀형 배열이면 hwinfo는 1xn 셀형 배열입니다. 여기서 n는 field의 길이입니다.

    hwinfo = imaqhwinfo(adaptorname,deviceID)는 숫자 deviceID로 지정된 장치에 대한 정보를 반환합니다. deviceID가 벡터이면 hwinfo는 1xn 구조체 배열입니다. 여기서 n는 deviceID의 길이입니다.

    예제

    hwinfo = imaqhwinfo(obj) 는 지정된 이미지 수집 객체에 대한 정보를 반환합니다. 반환된 정보에는 어댑터 이름, 장치 이름, 비디오 해상도, 네이티브 데이터 유형, 장치 드라이버 이름 및 버전이 포함됩니다.

    예제

    hwinfo = imaqhwinfo(obj,field)는 지정된 필드에 있는 이미지 수집 객체의 정보를 반환합니다.

    예제

    모두 축소

    시스템에서 사용할 수 있는 어댑터에 대한 정보입니다.

    hwinfo = imaqhwinfo

    hwinfo = 

  struct with fields:

    InstalledAdaptors: {'winvideo'}
        MATLABVersion: '24.2 (R2024b)'
          ToolboxName: 'Image Acquisition Toolbox'
       ToolboxVersion: '24.2 (R2024b)'

    특정 어댑터를 통해 접근할 수 있는 장치에 대한 정보를 표시합니다.

     hwinfo = imaqhwinfo('winvideo')

    hwinfo = 

  struct with fields:

       AdaptorDllName: [1x73 char]
    AdaptorDllVersion: '24.2 (R2024b)'
          AdaptorName: 'winvideo'
            DeviceIDs: {[1]}
           DeviceInfo: [1×1 struct]

    이 예제는 특정 어댑터를 통해 접근할 수 있는 특정 장치에 대한 정보를 반환합니다. 장치는 장치 ID로 식별합니다.

    dev_info = imaqhwinfo('winvideo',1)

    dev_info = 

          DefaultFormat: 'RGB555_128x96'
    DeviceFileSupported: 0
             DeviceName: 'IBM PC Camera'
               DeviceID: 1
  VideoInputConstructor: 'videoinput('winvideo', 1)'
 VideoDeviceConstructor: 'imaq.VideoDevice('winvideo', 1)'       
       SupportedFormats: {1x34 cell}

    특정 비디오 입력 객체와 관련된 장치에 대한 정보를 표시합니다.

    obj = videoinput('winvideo', 1);
obj_info = imaqhwinfo(obj)

    obj_info = 

                AdaptorName: 'winvideo'
                 DeviceName: 'IBM PC Camera'
                  MaxHeight: 96
                   MaxWidth: 128
             NativeDataType: 'uint8'
               TotalSources: 1
    VendorDriverDescription: 'Windows WDM Compatible Driver'
        VendorDriverVersion: 'DirectX 9.0'

    입력 인수

    모두 축소

    어댑터 이름은 장치와 통신하는 데 사용되는 어댑터의 이름을 지정하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

    데이터형: char | string

    지정된 어댑터에 대한 이미지 수집 장치 ID이며, 음이 아닌 정수로 지정됩니다.

    장치 ID는 어댑터가 할당하는 번호로, 이미지 수집 장치를 고유하게 식별합니다. 어댑터는 감지한 첫 번째 장치에 식별자 1을 할당하고, 두 번째 장치에 식별자 2를 할당하는 식으로 나머지 장치도 식별자 1을 할당합니다.

    데이터형: uint8 | uint16 | uint32 | uint64

    필드 이름은 AdaptorName, AdaptorVersion, DeviceIDs, 및 DeviceInfo로 지정됩니다.

    데이터형: char | string

    객체로 지정된 이미지 수집 객체입니다. obj에는 어댑터 이름, 장치 이름, 비디오 해상도, 공급업체의 장치 드라이버 및 버전에 대한 세부 정보와 같은 정보가 포함됩니다. 자세한 내용은 Creating Image Acquisition Objects 항목을 참조하십시오.

    출력 인수

    모두 축소

    이미지 수집 어댑터에 대한 정보가 구조체로 반환됩니다.

    팁

    imaqhwinfo 함수를 호출한 후, 툴박스는 하드웨어 정보를 캐시합니다. MATLAB가 실행되는 동안 설치된 새 하드웨어를 검색하려면 imaqreset 함수를 사용하세요.

    버전 내역

    R2006a에 개발됨

    참고 항목

    도움말 항목