유용한 함수¶

간단한 이미지 처리, 추론 결과를 시각화하는 등의 유용한 함수를 제공합니다.

Public Functions¶

Type	Name
void	SaigeInitTextFormatting (SaigeTextFormatting * formatting) 주어진 SaigeTextFormatting의 문자집합 포함 여부 배열의 모든 값을 false로 초기화합니다.
unsigned int	SaigeConvertImageType (const int channel, const int type) 이미지 채널과 SaigeImageType을 SaigeInferFromByteArray에서 사용하는 image flag 매크로로 변환합니다.
int	SaigeOverlaySegmentedObjects (const void * baseImage, const SaigeSegmentedObject * objects, SaigeModelInfo * modelInfo, const int numOfSegmentedObjects, const int width, const int height, const int channels, const int type, const bool isRGB, const double overlayAlpha, void * resultImage) (SEG, IAD) 베이스 이미지에 SegmentedObject를 그려 결과 이미지에 저장합니다.
int	SaigeOverlayDetectedObjects (const void * baseImage, const SaigeDetectedObject * objects, SaigeModelInfo * modelInfo, const int numOfDetectedObjects, const int width, const int height, const int channels, const int type, const bool withClassName, const bool isRGB, const double overlayAlpha, void * resultImage) (DET) 베이스 이미지에 DetectedObject의 Bounding Box를 그려 결과 이미지에 저장합니다.
int	SaigeOverlayTextObjects (const void * baseImage, const SaigeTextObject * objects, const int numOfTextObjects, const int width, const int height, const int channels, const int type, const bool isRGB, const double overlayAlpha, const double textScale, void * resultImage) (OCR) 베이스 이미지에 OCR 검사 결과인 SaigeTextObject를 그려 결과 이미지에 저장합니다. 현재 한글은 ? 로 나오며 추후 지원예정입니다.
int	SaigeOverlayHeatmap (const void * baseImage, const float * heatmap, const int width, const int height, const int channels, const int type, const bool isRGB, const double overlayAlpha, void * resultImage) (IAD) 베이스 이미지에 색상을 입힌 Heatmap을 그려 결과 이미지에 저장합니다.
int	SaigeShowImage (const void * image, const int width, const int height, const int channels, const int type, const bool isRGB, const bool invert, const double alpha, const int waitMS) 이미지를 별도의 윈도우에 디스플레이합니다.
void *	SaigeCropWithRotatedBox (const void * originalImage, const int width, const int height, const int channel, SaigeRotatedBox * rotatedBox, int * croppedWidth, int * croppedHeight)
int	SaigeFreeCroppedImage (void * croppedImage)

Public Functions Documentation¶

`SaigeInitTextFormatting`¶

주어진 SaigeTextFormatting의 문자집합 포함 여부 배열의 모든 값을 false로 초기화합니다.

void SaigeInitTextFormatting (
    SaigeTextFormatting * formatting
)

Parameters:

formatting 설정하고자하는 변수의 포인터입니다.

`SaigeConvertImageType`¶

이미지 채널과 SaigeImageType을 SaigeInferFromByteArray에서 사용하는 image flag 매크로로 변환합니다.

unsigned int SaigeConvertImageType (
    const int channel,
    const int type
)

Parameters:

channel 이미지의 채널 수입니다.
type 이미지의 데이터 타입입니다. SaigeDrawImage 를 참고해 주세요.

Returns:

imageFlag 변환된 image flag 매크로를 리턴합니다.

`SaigeOverlaySegmentedObjects`¶

(SEG, IAD) 베이스 이미지에 SegmentedObject를 그려 결과 이미지에 저장합니다.

int SaigeOverlaySegmentedObjects (
    const void * baseImage,
    const SaigeSegmentedObject * objects,
    SaigeModelInfo * modelInfo,
    const int numOfSegmentedObjects,
    const int width,
    const int height,
    const int channels,
    const int type,
    const bool isRGB,
    const double overlayAlpha,
    void * resultImage
)

Parameters:

baseImage SegmentedObject가 그려질 베이스 이미지 데이터입니다.
objects 추론으로 검출된 SegmentedObject의 배열입니다.
modelInfo 모델 정보입니다. 클래스 색상 표시에 사용됩니다. null인 경우 빨간색으로 표시됩니다.
numOfSegmentedObjects SegmentedObject의 개수입니다.
width 베이스, 결과 이미지의 너비입니다.
height 베이스, 결과 이미지의 높이입니다.
channels 베이스, 결과 이미지의 채널 수입니다.
type 이미지의 타입입니다. SaigeImageType 참고
overlayAlpha SegmentedObject를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 SegmentedObject가 투명하게 그려집니다.
resultImage [out] SegmentedObject가 그려진 결과 이미지 데이터입니다.

Returns:

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

`SaigeOverlayDetectedObjects`¶

(DET) 베이스 이미지에 DetectedObject의 Bounding Box를 그려 결과 이미지에 저장합니다.

int SaigeOverlayDetectedObjects (
    const void * baseImage,
    const SaigeDetectedObject * objects,
    SaigeModelInfo * modelInfo,
    const int numOfDetectedObjects,
    const int width,
    const int height,
    const int channels,
    const int type,
    const bool withClassName,
    const bool isRGB,
    const double overlayAlpha,
    void * resultImage
)

Parameters:

baseImage DetectedObject가 그려질 베이스 이미지 데이터입니다.
objects 추론으로 검출된 DetectedObject의 배열입니다.
modelInfo 모델 정보입니다. 클래스 이름과 색상 표시에 사용됩니다. null인 경우 빨간색으로 표시됩니다.
numOfDetectedObjects DetectedObject의 개수입니다.
width 베이스, 결과 이미지의 너비입니다.
height 베이스, 결과 이미지의 높이입니다.
channels 베이스, 결과 이미지의 채널 수입니다.
type 이미지의 타입입니다. SaigeImageType 참고
withClassName true로 설정하면 DetectedObject의 클래스 이름을 함께 표시합니다.
isRGB true로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.
overlayAlpha DetectedObject를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 DetectedObject가 투명하게 그려집니다.
resultImage [out] DetectedObject가 그려진 결과 이미지 데이터입니다.

Returns:

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

`SaigeOverlayTextObjects`¶

(OCR) 베이스 이미지에 OCR 검사 결과인 SaigeTextObject를 그려 결과 이미지에 저장합니다. 현재 한글은 ? 로 나오며 추후 지원예정입니다.

int SaigeOverlayTextObjects (
    const void * baseImage,
    const SaigeTextObject * objects,
    const int numOfTextObjects,
    const int width,
    const int height,
    const int channels,
    const int type,
    const bool isRGB,
    const double overlayAlpha,
    const double textScale,
    void * resultImage
)

Parameters:

baseImage SaigeTextObject가 그려질 베이스 이미지 데이터입니다.
objects 추론으로 검출된 SaigeTextObject의 배열입니다.
numOfSaigeTextObject SaigeTextObject의 개수입니다.
width 베이스, 결과 이미지의 너비입니다.
height 베이스, 결과 이미지의 높이입니다.
channels 베이스, 결과 이미지의 채널 수입니다.
type 이미지의 타입입니다. SaigeImageType 참고
isRGB true로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.
overlayAlpha SaigeTextObject를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 SaigeTextObject가 투명하게 그려집니다.
resultImage [out] SaigeTextObject가 그려진 결과 이미지 데이터입니다.

Returns:

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

See also: SaigeGetInferenceResultNumOfSaigeTextObject, SaigeGetInferenceResultSaigeTextObject

`SaigeOverlayHeatmap`¶

(IAD) 베이스 이미지에 색상을 입힌 Heatmap을 그려 결과 이미지에 저장합니다.

int SaigeOverlayHeatmap (
    const void * baseImage,
    const float * heatmap,
    const int width,
    const int height,
    const int channels,
    const int type,
    const bool isRGB,
    const double overlayAlpha,
    void * resultImage
)

Parameters:

baseImage SaigeHeatmap가 그려질 베이스 이미지 데이터입니다.
heatmap 검사 결과로 얻은 Heatmap의 배열입니다.
width 베이스, 결과 이미지의 너비입니다.
height 베이스, 결과 이미지의 높이입니다.
channels 베이스, 결과 이미지의 채널 수입니다.
type 이미지의 타입입니다. SaigeImageType 참고
isRGB true로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.
overlayAlpha SaigeHeatmap를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 SaigeHeatmap가 투명하게 그려집니다.
resultImage [out] SaigeHeatmap가 그려진 결과 이미지 데이터입니다.

Returns:

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

`SaigeShowImage`¶

이미지를 별도의 윈도우에 디스플레이합니다.

int SaigeShowImage (
    const void * image,
    const int width,
    const int height,
    const int channels,
    const int type,
    const bool isRGB,
    const bool invert,
    const double alpha,
    const int waitMS
)

Parameters:

image 디스플레이할 이미지 데이터입니다.
width 이미지의 너비입니다.
height 이미지의 높이입니다.
channels 이미지의 채널 수입니다.
type 이미지 데이터 타입입니다. 설정 방법은 SaigeImageType 을 참고해 주세요.
isRGB true로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.
invert true로 설정하면 색상이 반전되어 표시됩니다.
alpha 이미지 데이터의 픽셀 값에 곱해지는 수입니다.
waitMS 디스플레이 시간입니다. 단위는 밀리초이며 0으로 설정할 시 디스플레이 창을 직접 종료해야 합니다.

`SaigeCropWithRotatedBox`¶

void * SaigeCropWithRotatedBox (
    const void * originalImage,
    const int width,
    const int height,
    const int channel,
    SaigeRotatedBox * rotatedBox,
    int * croppedWidth,
    int * croppedHeight
)

`SaigeFreeCroppedImage`¶

int SaigeFreeCroppedImage (
    void * croppedImage
)

유용한 함수¶

Public Functions¶

Public Functions Documentation¶

SaigeInitTextFormatting¶

SaigeConvertImageType¶

SaigeOverlaySegmentedObjects¶

SaigeOverlayDetectedObjects¶

SaigeOverlayTextObjects¶

SaigeOverlayHeatmap¶

SaigeShowImage¶

SaigeCropWithRotatedBox¶

SaigeFreeCroppedImage¶

`SaigeInitTextFormatting`¶

`SaigeConvertImageType`¶

`SaigeOverlaySegmentedObjects`¶

`SaigeOverlayDetectedObjects`¶

`SaigeOverlayTextObjects`¶

`SaigeOverlayHeatmap`¶

`SaigeShowImage`¶

`SaigeCropWithRotatedBox`¶

`SaigeFreeCroppedImage`¶