주요 콘텐츠

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

imaqregister

타사 맞춤형 어댑터를 등록하세요

설명

adaptors = imaqregister는 등록된 타사 어댑터 목록과 해당 전체 경로를 반환합니다. 등록된 어댑터가 없는 경우 imaqregister는 빈 셀 배열을 반환합니다.

참고

imaqhwinfovideoinput 함수는 전체 경로가 아닌 어댑터 기본 이름을 사용합니다. 예를 들어 어댑터의 전체 경로가 "c:\adaptor.dll"(Windows®), "/local/adaptors/adaptor.so"(Linux®) 또는 "/local/adaptors/adaptor.dylib"(macOS)인 경우 어댑터의 기본 이름은 "adaptor"입니다.

adaptors = imaqregister(adaptorpath)는 지정된 타사 어댑터 라이브러리를 등록하고 등록된 모든 어댑터 목록을 반환합니다.

어댑터를 등록하면 Image Acquisition Toolbox™에게 타사 어댑터 라이브러리의 위치를 알려줍니다. imaqhwinfo 명령어를 사용하여 시스템에서 사용 가능한 이미지 획득 하드웨어를 쿼리하면 툴박스는 이전에 등록된 어댑터 라이브러리를 제공합니다. imaqregister 함수는 등록된 어댑터의 이름을 저장하여 MATLAB® 세션 간에 위치 정보가 유지되도록 합니다. imaqhwinfo는 사용 가능한 어댑터 목록을 캐시하므로 새로 등록된 어댑터를 사용하려면 imaqregister를 호출한 후 imaqreset를 호출해야 할 수도 있습니다.

참고

어댑터 공유 라이브러리(Windows에서는 DLL)는 하드웨어 공급업체에서 제공하는 드라이버 공유 라이브러리(Windows에서는 역시 DLL)와 다릅니다. 어댑터 공유 라이브러리는 Image Acquisition Toolbox에 특화되어 있으며 하드웨어 공급업체에서 그렇게 명시하고 있습니다.

예제

adaptors = imaqregister(adaptorpath,action)action에 지정된 대로 사용 가능한 어댑터 목록에서 타사 어댑터를 추가하거나 제거합니다.

예제

모두 축소

Windows 시스템에서 Image Acquisition Toolbox에 타사 어댑터를 등록하고 데이터를 미리 보세요. 이 예제에서는 Image Acquisition Toolbox에 포함된 데모 어댑터를 사용하지만, 다음 단계를 따라 타사에서 제공하는 사용자 지정 어댑터를 등록할 수도 있습니다. 데모 어댑터 소스 파일을 보려면 시스템에서 해당 디렉터리로 이동하십시오. 정확한 파일 경로는 컴퓨터에 따라 다를 수 있습니다.

cd('C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\')

타사 어댑터를 사용하고 있음을 Image Acquisition Toolbox에 알리려면 imaqregister를 사용하십시오. 이 예시에서는 \toolbox\imaq\imaqadaptors\kit\demo\win64 폴더에 있는 Windows용 데모 어댑터의 사전 빌드 버전을 살펴보겠습니다.

imaqregister('C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\win64\mwdemoimaq.dll')
ans = 1×1 cell array
    {'C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\win64\mwdemoimaq.dll'}

툴박스는 어댑터 정보를 캐시하므로 타사 어댑터가 표시되려면 툴박스에 등록된 어댑터 라이브러리를 다시 로드해야 합니다.

imaqreset

InstalledAdaptors 필드에서 설치된 어댑터 목록을 확인하세요. 새로 등록된 타사 어댑터는 mwdemoimaq로 표시됩니다.

imaqhwinfo
ans = struct with fields:
    InstalledAdaptors: {'demo'  'gentl'  'gige'  'kinect'  'matrox'  'mwdemoimaq'  'spinnaker'  'winvideo'}
        MATLABVersion: '9.7 (R2019b)'
          ToolboxName: 'Image Acquisition Toolbox'
       ToolboxVersion: '6.1 (R2019b)'

이 어댑터를 사용하여 비디오 입력 객체를 생성합니다.

vid = videoinput('mwdemoimaq')
Summary of Video Input Object Using 'Color Device'.

   Acquisition Source(s):  input1 is available.

  Acquisition Parameters:  'input1' is the current selected source.
                           10 frames per trigger using the selected source.
                           'RGB_NTSC' video data to be logged upon START.
                           Grabbing first of every 1 frame(s).
                           Log data to 'memory' on trigger.

      Trigger Parameters:  1 'immediate' trigger(s) on START.

                  Status:  Waiting for START.
                           0 frames acquired since starting.
                           0 frames available for GETDATA.

어댑터에서 반환되는 데이터의 미리보기를 확인하세요.

preview(vid)

미리보기 작업을 마치셨으면 창을 닫으세요.

closepreview(vid)

입력 인수

모두 축소

어댑터 경로는 문자 벡터 또는 문자열 배열로 지정됩니다. 어댑터 라이브러리 파일의 전체 절대 경로를 지정해야 합니다.

예: imaqregister('c:\temp\thirdpartyadaptor.dll')는 어댑터 thirdpartyadaptor를 등록합니다.

데이터형: char | string

어댑터 등록으로, 'register' 또는 'unregister'로 지정됩니다. 'register'를 사용하면 타사 어댑터가 사용 가능한 어댑터 목록에 추가됩니다. 'unregister'를 사용하면 목록에서 타사 어댑터가 제거됩니다.

예: imaqregister('c:\temp\thirdpartyadaptor.dll','unregister')는 어댑터 thirdpartyadaptor를 제거합니다.

데이터형: char | string

  • MATLAB Compiler™를 사용하여 독립 실행형 애플리케이션에 사용자 지정 어댑터를 배포할 때 다음 제안 사항을 따르십시오.

    • 배포하려는 MATLAB 코드에서 imaqregister를 호출하세요. 이렇게 하면 배포된 애플리케이션이 애플리케이션을 실행하는 사용자를 위해 사용자 지정 어댑터 라이브러리를 등록하게 됩니다. 자세한 내용은 사용자 정의 어댑터 생성 항목을 참조하십시오.

    • 사용자 지정 어댑터 라이브러리를 독립 실행형 애플리케이션과 함께 패키징합니다. 이렇게 하려면 애플리케이션 컴파일러 앱의 Files installed for your end user 섹션에 어댑터 DLL 파일을 추가하십시오. 독립 실행형 애플리케이션 생성에 대한 자세한 내용은 MATLAB에서 독립 실행형 애플리케이션 만들기 (MATLAB Compiler)를 참조하십시오.

    • imaqregister를 호출하는 배포된 애플리케이션을 처음 실행할 때는 Run as administrator 모드로 애플리케이션을 실행해야 할 수도 있습니다.

버전 내역

R2006a 이전에 개발됨

참고 항목