유용한 함수¶
간단한 이미지 처리, 추론 결과를 시각화하는 등의 유용한 함수를 제공합니다.
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) 이미지를 별도의 윈도우에 디스플레이합니다. |
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:
baseImageSegmentedObject가 그려질 베이스 이미지 데이터입니다.objects추론으로 검출된 SegmentedObject의 배열입니다.modelInfo모델 정보입니다. 클래스 색상 표시에 사용됩니다. null인 경우 빨간색으로 표시됩니다.numOfSegmentedObjectsSegmentedObject의 개수입니다.width베이스, 결과 이미지의 너비입니다.height베이스, 결과 이미지의 높이입니다.channels베이스, 결과 이미지의 채널 수입니다.type이미지의 타입입니다. SaigeImageType 참고overlayAlphaSegmentedObject를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 SegmentedObject가 투명하게 그려집니다.resultImage[out] SegmentedObject가 그려진 결과 이미지 데이터입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeGetInferenceResultNumOfSegmentedObjects, SaigeGetInferenceResultSegmentedObjects
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:
baseImageDetectedObject가 그려질 베이스 이미지 데이터입니다.objects추론으로 검출된 DetectedObject의 배열입니다.modelInfo모델 정보입니다. 클래스 이름과 색상 표시에 사용됩니다. null인 경우 빨간색으로 표시됩니다.numOfDetectedObjectsDetectedObject의 개수입니다.width베이스, 결과 이미지의 너비입니다.height베이스, 결과 이미지의 높이입니다.channels베이스, 결과 이미지의 채널 수입니다.type이미지의 타입입니다. SaigeImageType 참고withClassNametrue로 설정하면 DetectedObject의 클래스 이름을 함께 표시합니다.isRGBtrue로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.overlayAlphaDetectedObject를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 DetectedObject가 투명하게 그려집니다.resultImage[out] DetectedObject가 그려진 결과 이미지 데이터입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeGetInferenceResultNumOfDetectedObjects, SaigeGetInferenceResultDetectedObjects
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:
baseImageSaigeTextObject가 그려질 베이스 이미지 데이터입니다.objects추론으로 검출된 SaigeTextObject의 배열입니다.numOfSaigeTextObjectSaigeTextObject의 개수입니다.width베이스, 결과 이미지의 너비입니다.height베이스, 결과 이미지의 높이입니다.channels베이스, 결과 이미지의 채널 수입니다.type이미지의 타입입니다. SaigeImageType 참고isRGBtrue로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.overlayAlphaSaigeTextObject를 시각화할 때 투명도를 나타내는 값입니다. 범위는 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:
baseImageSaigeHeatmap가 그려질 베이스 이미지 데이터입니다.heatmap검사 결과로 얻은 Heatmap의 배열입니다.width베이스, 결과 이미지의 너비입니다.height베이스, 결과 이미지의 높이입니다.channels베이스, 결과 이미지의 채널 수입니다.type이미지의 타입입니다. SaigeImageType 참고isRGBtrue로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.overlayAlphaSaigeHeatmap를 시각화할 때 투명도를 나타내는 값입니다. 범위는 0~1이며 1에 가까울수록 SaigeHeatmap가 투명하게 그려집니다.resultImage[out] SaigeHeatmap가 그려진 결과 이미지 데이터입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeGetInferenceResultHeatmap
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 을 참고해 주세요.isRGBtrue로 설정하면 이미지 데이터가 RGB 순서로 되어 있음을 나타냅니다.inverttrue로 설정하면 색상이 반전되어 표시됩니다.alpha이미지 데이터의 픽셀 값에 곱해지는 수입니다.waitMS디스플레이 시간입니다. 단위는 밀리초이며 0으로 설정할 시 디스플레이 창을 직접 종료해야 합니다.