图像对齐

图像对齐

Public Functions

Type	Name
int	SaigeInitializeAlignModule (const int gpuIndex, const int sourceWidth, const int sourceHeight, const int targetWidth, const int targetHeight) 激活Saige Alignment功能的函数。
int	SaigeFinalizeAlignModule () 结束Saige Alignment功能的函数。释放功能使用的GPU内存。
int	SaigeAlignImageFromByteArray (const unsigned char * sourceImage, const int sourceWidth, const int sourceHeight, const int sourceChannel, const unsigned char * targetImage, const int targetWidht, const int targetHeight, const int targetChannel, unsigned int flag, unsigned char * croppedSourceImage) 将Source图像的位置调整到与Target图像匹配的函数。
int	SaigeAlignImageFromByteArrayWithCoord (const unsigned char * sourceImage, const int sourceWidth, const int sourceHeight, const int sourceChannel, const unsigned char * targetImage, const int targetWidht, const int targetHeight, const int targetChannel, unsigned int flag, unsigned char * croppedSourceImage, int * cropCoords) SaigeAlignImageFromByteArray的扩展版本，同时返回应用于Source图像的裁剪框像素坐标。
int	SaigeAlignImageFromFile (const char * sourceImagePath, const char * targetImagePath, int * cropWidth, int * cropHeight, int * cropChannel, unsigned char * croppedSourceImage) Not Implemented

Public Functions Documentation

SaigeInitializeAlignModule

激活Saige Alignment功能的函数。

int SaigeInitializeAlignModule (
    const int gpuIndex,
    const int sourceWidth,
    const int sourceHeight,
    const int targetWidth,
    const int targetHeight
) 

Alignment功能将Source图像的位置调整到与Target图像匹配并裁剪它。 因此，Source图像必须大于Target图像。

Parameters:

• gpuIndex 此功能使用GPU，是要使用的GPU的索引。
• sourceWidth
• sourceHeight
• targetWidth
• targetHeight

Returns:

errorCode 成功时返回0，失败时返回错误代码。

SaigeFinalizeAlignModule

结束Saige Alignment功能的函数。释放功能使用的GPU内存。

int SaigeFinalizeAlignModule () 

Returns:

errorCode 成功时返回0，失败时返回错误代码。

SaigeAlignImageFromByteArray

将Source图像的位置调整到与Target图像匹配的函数。

int SaigeAlignImageFromByteArray (
    const unsigned char * sourceImage,
    const int sourceWidth,
    const int sourceHeight,
    const int sourceChannel,
    const unsigned char * targetImage,
    const int targetWidht,
    const int targetHeight,
    const int targetChannel,
    unsigned int flag,
    unsigned char * croppedSourceImage
) 

Crop的Source图像的大小应为targetWidth * targetHeight * sourceChannel。

Parameters:

• sourceImage Source图像的字节数组。
• sourceWidth Source图像的宽度。
• sourceHeight Source图像的高度。
• sourceChannel Source图像的通道。
• targetImage Target图像的字节数组。
• targetWidht Target图像的宽度。
• targetHeight Target图像的高度。
• targetChannel Target图像的通道。
• flag 是否检测裁剪的Source图像的边缘。
• croppedSourceImage 裁剪的Source图像的字节数组。

Returns:

errorCode 成功时返回0，失败时返回错误代码。

SaigeAlignImageFromByteArrayWithCoord

SaigeAlignImageFromByteArray的扩展版本，同时返回应用于Source图像的裁剪框像素坐标。

int SaigeAlignImageFromByteArrayWithCoord (
    const unsigned char * sourceImage,
    const int sourceWidth,
    const int sourceHeight,
    const int sourceChannel,
    const unsigned char * targetImage,
    const int targetWidht,
    const int targetHeight,
    const int targetChannel,
    unsigned int flag,
    unsigned char * croppedSourceImage,
    int * cropCoords
) 

Parameters:

• cropCoords 用于接收应用于Source图像的裁剪框像素坐标（x1, y1, x2, y2）的int[4]数组。 如果不需要坐标，可以传入nullptr。

Returns:

errorCode 成功时返回0，失败时返回错误代码。

SaigeAlignImageFromFile

Not Implemented

int SaigeAlignImageFromFile (
    const char * sourceImagePath,
    const char * targetImagePath,
    int * cropWidth,
    int * cropHeight,
    int * cropChannel,
    unsigned char * croppedSourceImage
)