HALCON 산자 설명: getimage_pointer1

성함

get_image_pointer1에서 채널을 가져오는 Pointer (표시기)

함수 서명

get_image_pointer1(Image : : : Pointer, Type, Width, Height) 이미지 객체 출력이 비어 있고 제어 입력 매개 변수가 비어 있습니다.

묘사

이 산자는 그림 대상 Image 을 입력한 첫 번째 채널의 Pointer (지시기) 를 되돌려줍니다.또한 이 산자도 그림 형식과 그림 크기 (width와height) 를 되돌려줍니다.이렇게 하면 HALCON을 사용하는 프로그래밍 언어에서 이 Pointer(설명자)를 통해 HALCON 데이터베이스에 있는 이미지 데이터에 접근할 수 있다.HALCON에 저장된 이미지는 주행순으로 한 줄 한 줄이지만 이미지 유형이 complex과vector_type일 때 특수한 방식으로 저장된다. 구체적으로 말하면 유형이 conplex일 때 실과 허는 번갈아 저장된다. 반대로 이미지 유형이 vector_type일 때 두 개의 행렬이 있는데 하나는 저장 줄과 한 개의 저장 열이고 두 개의 행렬은 HALCON 데이터베이스에 하나씩 저장된다.

주의

입력한 이미지 대상인 Image가 HALCON 데이터베이스에 존재할 때만 이 산자는 대응하는 Image의 Pointer(지시기)를 되돌려줍니다. HALCON을 사용하는 프로그래밍 언어에서 대응하는 변수가 유효하면 됩니다. 이런 조건을 충족시키지 못하면 정의되지 않은 행위나 프로그램이 붕괴될 수 있습니다.이미지 데이터에 반환된 Pointer 수정(다시 쓰기)을 통해 이미지를 참조하는 모든 이미지 객체(Image Object)가 수정됩니다.

병행화

Multithreading type: reentrant (runs in parallel with non-exclusive operators).

Multithreading scope: global (may be called from any thread).

Processed without parallelization.

매개 변수

Image(객체 입력): 가져온 이미지 객체

Pointer(출력 제어): 핸들처럼 이미지 객체에 대한 표시기

Type(출력 제어): 출력 이미지의 유형

Width(출력 제어): 이미지의 폭

Height(출력 제어): 이미지 높이

C 언어 인스턴스

Hobject  Image;
char     typ[128];
Hlong     width,height;
unsigned char *ptr;

read_image(&Image,"fabrik");
get_image_pointer1(Image,(Hlong*)&ptr,typ,&width,&height);

결실

입력한 이미지가 유효하면 이 산자의 반환 값은 2 (H MSG TRUE) 이고 입력한 이미지가 유효하지 않을 때 반환 값은 set시스템('no object result')은 구체적으로 결정되어 필요하면 이상 던지기를 되돌려줍니다.

가능한 선행 조치

read_이미지 표시기를 가져오려면 이미지를 읽어야 합니다

선택할 수 있는 산수

SetGrayval, GetGrayval, GetImagePointer3, GetImageSize, GetImageType