추론¶

이미지에 대한 추론을 수행합니다.

Public Functions¶

Type	Name
int	SaigeInferFromImageFile (SaigeInferenceHandle handle, const char * imagePath, SaigeInferenceResult result) 이미지 경로를 입력하여 추론을 수행합니다.
int	SaigeInferFromByteArray (SaigeInferenceHandle handle, const unsigned char * imageData, const int width, const int height, const unsigned int flags, SaigeInferenceResult result) 한 장의 이미지 데이터를 입력하여 추론을 수행합니다. 3채널 컬러 이미지의 경우 RGB 순서가 연산속도에 약간 유리합니다. 실시간 검사에서 이미지 취득이 RGB로 가능한 경우 RGB를 권장합니다. SaigeGetImageData 함수는 항상 RGB로 이미지 파일을 로드합니다.
int	SaigeInferFromByteArrayWithProductId (SaigeInferenceHandle handle, const unsigned char * imageData, const int width, const int height, const unsigned int flags, const char * productId, SaigeInferenceResult result) 한 장의 이미지 데이터를 입력하여 추론을 수행합니다.SaigeInferFromByteArray 와 동일하며 입력으로 productId를 추가로 받습니다. productId는 이용자가 설정한 검사대상의 식별자입니다.
int	SaigeInferFromMultipleByteArray (SaigeInferenceHandle handle, const int numOfImages, const unsigned char imageData, const int width, const int height, const unsigned int flags, SaigeInferenceResult** * results) 크기가 같은 이미지 데이터를 여러 장 입력하여 배치 추론을 수행합니다.
int	SaigeInferFromMultiPageByteArray (SaigeInferenceHandle handle, const int numOfPages, const unsigned char ** imageData, const int width, const int height, const int * channels, const unsigned int flags, SaigeInferenceResult result) 여러 페이지의 이미지 데이터를 입력하여 추론을 수행합니다.

Macros¶

Type	Name
define	SAIGE_IMAGE_COLOR 0x01 컬러 이미지 데이터임을 나타내는 플래그입니다.
define	SAIGE_IMAGE_16BIT 0x02 16 Bit Per Channel 이미지임을 나타내는 플래그입니다.
define	SAIGE_IMAGE_ALPHA 0x04 Alpha 채널을 가지는 데이터임을 나타내는 플래그입니다.
define	SAIGE_IMAGE_BGR 0x08 채널의 컬러 순서가 Blue, Green, Red 순서인 데이터임을 나타내는 플래그입니다.
define	SAIGE_IMAGE_8BIT_GRAY 0x00 8-bit 회색조 이미지 데이터임을 나타내는 매크로입니다. 1 Channel, Width x Height 크기의 배열입니다.
define	SAIGE_IMAGE_24BIT_RGB (SAIGE_IMAGE_COLOR) 24-bit RGB 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 R, G, B 입니다.
define	SAIGE_IMAGE_24BIT_BGR (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_BGR) 24-bit BGR 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 B, G, R 입니다.
define	SAIGE_IMAGE_32BIT_RGBA (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_ALPHA) 32-bit RGBA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 R, G, B, A 입니다.
define	SAIGE_IMAGE_32BIT_BGRA (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_ALPHA \| SAIGE_IMAGE_BGR) 32-bit BGRA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 B, G, R, A 입니다.
define	SAIGE_IMAGE_16BIT_GRAY (SAIGE_IMAGE_16BIT) 16-bit 회색조 이미지 데이터임을 나타내는 매크로입니다. 1 Channel, Width x Height 크기의 배열입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.
define	SAIGE_IMAGE_48BIT_RGB (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_16BIT) 48-bit RGB 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 R, G, B 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.
define	SAIGE_IMAGE_48BIT_BGR (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_16BIT \| SAIGE_IMAGE_BGR) 48-bit BGR 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 B, G, R 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.
define	SAIGE_IMAGE_64BIT_RGBA (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_16BIT \| SAIGE_IMAGE_ALPHA) 64-bit RGBA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 R, G, B, A 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.
define	SAIGE_IMAGE_64BIT_BGRA (SAIGE_IMAGE_COLOR \| SAIGE_IMAGE_16BIT \| SAIGE_IMAGE_ALPHA \| SAIGE_IMAGE_BGR) 64-bit BGRA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 B, G, R, A 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.

Public Functions Documentation¶

`SaigeInferFromImageFile`¶

이미지 경로를 입력하여 추론을 수행합니다.

int SaigeInferFromImageFile (
    SaigeInferenceHandle handle,
    const char * imagePath,
    SaigeInferenceResult result
)

Parameters:

handle 추론을 수행할 추론 핸들입니다.
imagePath 추론을 수행할 이미지의 경로입니다. 사용 가능한 확장자는 jpg, jpeg, png, ppm, bmp, pgm, tif, tiff, webp입니다.
result 추론 결과를 담을 결과 핸들입니다.

Returns:

errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.

`SaigeInferFromByteArray`¶

한 장의 이미지 데이터를 입력하여 추론을 수행합니다. 3채널 컬러 이미지의 경우 RGB 순서가 연산속도에 약간 유리합니다. 실시간 검사에서 이미지 취득이 RGB로 가능한 경우 RGB를 권장합니다. SaigeGetImageData 함수는 항상 RGB로 이미지 파일을 로드합니다.

int SaigeInferFromByteArray (
    SaigeInferenceHandle handle,
    const unsigned char * imageData,
    const int width,
    const int height,
    const unsigned int flags,
    SaigeInferenceResult result
)

Parameters:

handle 추론을 수행할 추론 핸들입니다.
imageData 추론을 수행할 이미지 데이터입니다.
width 이미지 데이터의 너비입니다.
height 이미지 데이터의 높이입니다.
flags 이미지의 색상 및 비트 수를 설정하는 플래그입니다.
result 추론 결과를 담을 결과 핸들입니다.

Returns:

errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.

`SaigeInferFromByteArrayWithProductId`¶

한 장의 이미지 데이터를 입력하여 추론을 수행합니다.SaigeInferFromByteArray 와 동일하며 입력으로 productId를 추가로 받습니다. productId는 이용자가 설정한 검사대상의 식별자입니다.

int SaigeInferFromByteArrayWithProductId (
    SaigeInferenceHandle handle,
    const unsigned char * imageData,
    const int width,
    const int height,
    const unsigned int flags,
    const char * productId,
    SaigeInferenceResult result
)

Parameters:

handle 추론을 수행할 추론 핸들입니다.
imageData 추론을 수행할 이미지 데이터입니다.
width 이미지 데이터의 너비입니다.
height 이미지 데이터의 높이입니다.
flags 이미지의 색상 및 비트 수를 설정하는 플래그입니다.
productId 추론을 수행할 제품의 ID입니다.
result 추론 결과를 담을 결과 핸들입니다.

Returns:

errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.

`SaigeInferFromMultipleByteArray`¶

크기가 같은 이미지 데이터를 여러 장 입력하여 배치 추론을 수행합니다.

int SaigeInferFromMultipleByteArray (
    SaigeInferenceHandle handle,
    const int numOfImages,
    const unsigned char ** imageData,
    const int width,
    const int height,
    const unsigned int flags,
    SaigeInferenceResult * results
)

Parameters:

handle 추론을 수행할 추론 핸들입니다.
numOfImages 추론을 수행할 이미지 데이터의 개수입니다.
imageData 추론을 수행할 이미지 데이터입니다.
width 이미지 데이터의 너비입니다.
height 이미지 데이터의 높이입니다.
flags 이미지의 색상 및 비트 수를 설정하는 플래그입니다.
results 추론 결과를 담을 결과 핸들의 배열입니다.

Returns:

errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.

`SaigeInferFromMultiPageByteArray`¶

여러 페이지의 이미지 데이터를 입력하여 추론을 수행합니다.

int SaigeInferFromMultiPageByteArray (
    SaigeInferenceHandle handle,
    const int numOfPages,
    const unsigned char ** imageData,
    const int width,
    const int height,
    const int * channels,
    const unsigned int flags,
    SaigeInferenceResult result
)

Parameters:

handle 추론을 수행할 추론 핸들입니다.
numOfPages 이미지 데이터의 페이지 수입니다.
imageData 이미지 데이터 배열입니다.
width 이미지 데이터의 너비입니다.
height 이미지 데이터의 높이입니다.
channels 이미지 데이터의 채널 수 배열입니다. 각 페이지의 채널 수를 나타냅니다.
flags 이미지의 색상 및 비트 수를 설정하는 플래그입니다.
result 추론 결과를 담을 결과 핸들입니다.

Returns:

errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.

Macro Definition Documentation¶

`SAIGE_IMAGE_COLOR`¶

컬러 이미지 데이터임을 나타내는 플래그입니다.

#define SAIGE_IMAGE_COLOR 0x01

`SAIGE_IMAGE_16BIT`¶

16 Bit Per Channel 이미지임을 나타내는 플래그입니다.

#define SAIGE_IMAGE_16BIT 0x02

`SAIGE_IMAGE_ALPHA`¶

Alpha 채널을 가지는 데이터임을 나타내는 플래그입니다.

#define SAIGE_IMAGE_ALPHA 0x04

`SAIGE_IMAGE_BGR`¶

채널의 컬러 순서가 Blue, Green, Red 순서인 데이터임을 나타내는 플래그입니다.

#define SAIGE_IMAGE_BGR 0x08

`SAIGE_IMAGE_8BIT_GRAY`¶

8-bit 회색조 이미지 데이터임을 나타내는 매크로입니다. 1 Channel, Width x Height 크기의 배열입니다.

#define SAIGE_IMAGE_8BIT_GRAY 0x00

`SAIGE_IMAGE_24BIT_RGB`¶

24-bit RGB 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 R, G, B 입니다.

#define SAIGE_IMAGE_24BIT_RGB ( SAIGE_IMAGE_COLOR )

`SAIGE_IMAGE_24BIT_BGR`¶

24-bit BGR 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 B, G, R 입니다.

#define SAIGE_IMAGE_24BIT_BGR ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_BGR )

`SAIGE_IMAGE_32BIT_RGBA`¶

32-bit RGBA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 R, G, B, A 입니다.

#define SAIGE_IMAGE_32BIT_RGBA ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_ALPHA )

`SAIGE_IMAGE_32BIT_BGRA`¶

32-bit BGRA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 B, G, R, A 입니다.

#define SAIGE_IMAGE_32BIT_BGRA ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_ALPHA | SAIGE_IMAGE_BGR )

`SAIGE_IMAGE_16BIT_GRAY`¶

16-bit 회색조 이미지 데이터임을 나타내는 매크로입니다. 1 Channel, Width x Height 크기의 배열입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.

#define SAIGE_IMAGE_16BIT_GRAY ( SAIGE_IMAGE_16BIT )

`SAIGE_IMAGE_48BIT_RGB`¶

48-bit RGB 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 R, G, B 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.

#define SAIGE_IMAGE_48BIT_RGB ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_16BIT )

`SAIGE_IMAGE_48BIT_BGR`¶

48-bit BGR 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (3) 크기의 배열이며, 채널 순서는 B, G, R 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.

#define SAIGE_IMAGE_48BIT_BGR ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_16BIT | SAIGE_IMAGE_BGR )

`SAIGE_IMAGE_64BIT_RGBA`¶

64-bit RGBA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 R, G, B, A 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.

#define SAIGE_IMAGE_64BIT_RGBA ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_16BIT | SAIGE_IMAGE_ALPHA )

`SAIGE_IMAGE_64BIT_BGRA`¶

64-bit BGRA 컬러 이미지 데이터임을 나타내는 매크로입니다. Width x Height x Channels (4) 크기의 배열이며, 채널 순서는 B, G, R, A 입니다. 픽셀 당 2바이트를 사용하는 unsigned short 타입입니다.

#define SAIGE_IMAGE_64BIT_BGRA ( SAIGE_IMAGE_COLOR | SAIGE_IMAGE_16BIT | SAIGE_IMAGE_ALPHA | SAIGE_IMAGE_BGR )

추론¶

Public Functions¶

Macros¶

Public Functions Documentation¶

SaigeInferFromImageFile¶

SaigeInferFromByteArray¶

SaigeInferFromByteArrayWithProductId¶

SaigeInferFromMultipleByteArray¶

SaigeInferFromMultiPageByteArray¶

Macro Definition Documentation¶

SAIGE_IMAGE_COLOR¶

SAIGE_IMAGE_16BIT¶

SAIGE_IMAGE_ALPHA¶

SAIGE_IMAGE_BGR¶

SAIGE_IMAGE_8BIT_GRAY¶

SAIGE_IMAGE_24BIT_RGB¶

SAIGE_IMAGE_24BIT_BGR¶

SAIGE_IMAGE_32BIT_RGBA¶

SAIGE_IMAGE_32BIT_BGRA¶

SAIGE_IMAGE_16BIT_GRAY¶

SAIGE_IMAGE_48BIT_RGB¶

SAIGE_IMAGE_48BIT_BGR¶

SAIGE_IMAGE_64BIT_RGBA¶

SAIGE_IMAGE_64BIT_BGRA¶

`SaigeInferFromImageFile`¶

`SaigeInferFromByteArray`¶

`SaigeInferFromByteArrayWithProductId`¶

`SaigeInferFromMultipleByteArray`¶

`SaigeInferFromMultiPageByteArray`¶

`SAIGE_IMAGE_COLOR`¶

`SAIGE_IMAGE_16BIT`¶

`SAIGE_IMAGE_ALPHA`¶

`SAIGE_IMAGE_BGR`¶

`SAIGE_IMAGE_8BIT_GRAY`¶

`SAIGE_IMAGE_24BIT_RGB`¶

`SAIGE_IMAGE_24BIT_BGR`¶

`SAIGE_IMAGE_32BIT_RGBA`¶

`SAIGE_IMAGE_32BIT_BGRA`¶

`SAIGE_IMAGE_16BIT_GRAY`¶

`SAIGE_IMAGE_48BIT_RGB`¶

`SAIGE_IMAGE_48BIT_BGR`¶

`SAIGE_IMAGE_64BIT_RGBA`¶

`SAIGE_IMAGE_64BIT_BGRA`¶