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

imaqfind

이미지 수집 객체 찾기

페이지 내 모두 축소

    구문

    imaqfind
    out = imaqfind(S)
    out = imaqfind(Name,Value)
    out = imaqfind(obj,Name,Value)

    설명

    imaqfind는 메모리에 존재하는 모든 비디오 입력 객체를 포함하는 배열을 반환합니다. 메모리에 비디오 입력 객체가 하나만 있는 경우 imaqfind 함수는 해당 객체에 대한 자세한 요약을 표시합니다.

    예제

    out = imaqfind(S)는 구조체 S에 정의된 속성 값과 일치하는 이미지 수집 객체를 포함하는 셀 배열 out를 반환합니다.

    예제

    out = imaqfind(Name,Value)는 지정된 이름-값 인수와 일치하는 이미지 수집 객체를 포함하는 셀형 배열을 반환합니다.

    예제

    out = imaqfind(obj,Name,Value)는 obj에 나열된 이미지 수집 객체의 이름-값 인수 값과 일치하는 이미지 수집 객체가 포함된 셀형 배열을 반환합니다.

    예제

    예제

    모두 축소

    이 예제에서는 단일 이미지 수집 장치에 대해 여러 개의 비디오 입력 객체를 생성하고 여러 가지 비디오 형식을 지정합니다. 이 예제를 시스템에서 실행하려면 imaqhwinfo 함수를 사용하여 이미지 수집 장치에 대한 객체 생성자를 가져온 후, 다음 코드에서 해당 구문을 대체하세요.

    비디오 입력 객체를 생성합니다.

    vidobj1 = videoinput('demo', 1, 'RGB_NTSC');
vidobj2 = videoinput('demo', 1, 'S-Video');
vidobj3 = videoinput('demo', 2, 'CCIR');
imaqfind;
   
    Video Input Object Array:

   Index:   Type:          Name:
   1        videoinput     RGB_NTSC-demo-1
   2        videoinput     S-Video-demo-1
   3        videoinput     CCIR-demo-2

    지정된 인수와 일치하는 속성 이름과 속성 값을 가진 이미지 수집 객체를 찾습니다.

    out2 = imaqfind(FramesPerTrigger = 10, FramesAcquired = 0);
    out =

  3×1 cell array

    {1×1 videoinput}
    {1×1 videoinput}
    {1×1 videoinput}

    지정된 이름-값 인수와 일치하는 vidobj1의 이미지 수집 객체를 검색합니다.

    out1 = imaqfind(vidobj1,{'FramesPerTrigger', 'FramesAcquired'}, {10, 0});
    out1 =

  1×1 cell array

    {1×1 videoinput}

    입력 인수

    모두 축소

    구조체로 지정되는 이미지 수집 속성 이름 값 인수입니다. S의 필드 이름은 이미지 수집 객체 속성 이름이고 필드 값은 요청된 속성 값입니다. get 함수를 사용하여 이미지 수집 객체가 지원하는 속성 목록을 확인합니다.

    데이터형: struct

    찾을 이미지 수집 객체는 찾으려는 이미지 수집 객체의 셀형 배열로 지정됩니다.

    데이터형: cell

    이름-값 인수

    모두 축소

    Name1=Value1,...,NameN=ValueN와 같이 선택적 인수 쌍을 지정합니다. 여기서 Name는 인수 이름이고 Value는 해당 값입니다. 이름-값 인수는 다른 인수 뒤에 나와야 하지만 쌍의 순서는 중요하지 않습니다.

    예: out = imaqfind(FramesPerTrigger = 10, FramesAcquired = 0)는 지정된 값과 이름-값 인수가 일치하는 이미지 수집 객체에 대한 셀형 배열을 반환합니다.

    get 함수를 사용하여 이미지 수집 객체가 지원하는 속성 목록을 확인합니다. 셀형 배열에 이러한 속성 이름-값 인수를 지정할 수 있습니다.

    여기에 나열된 속성은 이미지 수집 객체 속성의 하위 집합입니다. 이러한 속성의 전체 목록을 보려면 videoinput의 속성 섹션을 참조하세요.

    읽기 전용 속성입니다.

    지정된 어댑터에 대한 장치 ID이며 음이 아닌 정수로 지정됩니다. 이 속성은 비디오 입력 객체가 나타내는 장치를 식별합니다.

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

    비디오 입력 객체를 생성할 때 videoinput 함수의 입력으로 장치 ID를 지정할 수 있습니다. 객체는 DeviceID 속성에 값을 저장하고, Name 속성의 디폴트 값을 구성할 때도 이 값을 사용합니다.

    시스템에 연결된 장치의 ID 목록을 얻으려면 imaqhwinfo 함수를 사용하고 어댑터의 이름을 지정하세요.

    데이터형: double

    선택한 비디오 소스를 사용하여 비디오 입력 객체가 트리거를 실행할 때마다 수집할 프레임 수로, 양의 정수로 지정됩니다.

    데이터형: double

    읽기 전용 속성입니다.

    메모리 버퍼에서 추출된 프레임 수에 관계없이 객체가 수집한 총 프레임 수이며, 음이 아닌 정수로 지정됩니다. 비디오 입력 객체는 프레임을 수집하면서 FramesAcquired 속성의 값을 지속적으로 업데이트합니다.

    메모리 버퍼에서 사용 가능한 프레임 수를 알아보려면 FramesAvailable 속성을 사용하세요.

    데이터형: double

    읽기 전용 속성입니다.

    장치에 연결된 물리적 데이터 소스를 나타내는 비디오 소스 객체의 벡터입니다. 비디오 입력 객체가 생성되면 툴박스는 비디오 입력 객체와 연관된 비디오 소스 객체의 벡터를 생성합니다.

    각 비디오 소스 객체에는 고유한 소스 이름이 있습니다. 비디오 입력 객체의 SelectedSourceName 속성을 구성하여 소스 이름을 사용하여 원하는 수집 소스를 선택할 수 있습니다. 비디오 소스 객체의 이름은 SourceName 속성에 있습니다. 비디오 소스 객체의 SourceName가 해당 비디오 소스 객체의 SelectedSourceName와 동일하면 Selected 속성은 "on" 값을 갖습니다.

    비디오 소스 객체는 SourceName와 같은 일반적인 속성 집합을 지원합니다. 각 비디오 소스 객체는 밝기, 색조, 채도와 같은 물리적 장치의 특성을 제어하는 장치별 속성도 지원할 수 있습니다. 다양한 이미지 수집 장치는 각기 다른 속성 집합을 노출합니다.

    비디오 소스는 단일 엔터티로 처리되는 하나 이상의 물리적 데이터 소스의 모음입니다. 예를 들어, 각각 3개의 물리적 연결(빨강-녹색-파랑)로 구성된 여러 RGB 소스를 지원하는 하드웨어는 단일 비디오 소스 객체로 처리됩니다.

    Source 속성은 하나 이상의 비디오 소스를 캡슐화합니다. 비디오 소스를 참조하려면 숫자형 정수를 사용하여 비디오 소스 객체 벡터를 색인합니다.

    출력 인수

    모두 축소

    이미지 수집 객체의 요약으로, 이미지 수집 객체 또는 비디오 입력 객체의 셀 배열로 반환됩니다.

    데이터형: cell

    버전 내역

    R2006a에 개발됨

    참고 항목

    도움말 항목