Dynamsoft Panorama - API Reference
|
Classes | |
class | dynamsoft::dps::CPanoramaStitcher |
Variables | |
DM_Panorama * | dynamsoft::dps::CPanoramaStitcher::m_pStitcher |
dynamsoft::dps::CPanoramaStitcher::CPanoramaStitcher () | |
dynamsoft::dps::CPanoramaStitcher::~CPanoramaStitcher () | |
General Functions | |
static const char * | dynamsoft::dps::CPanoramaStitcher::GetErrorString (const int iErrorCode) |
static const char * | dynamsoft::dps::CPanoramaStitcher::GetVersion () |
Initialization Functions | |
int | dynamsoft::dps::CPanoramaStitcher::InitLicense (const char *pLicense) |
int | dynamsoft::dps::CPanoramaStitcher::InitLicenseFromServer (const char *pLicenseServer, const char *pLicenseKey) |
int | dynamsoft::dps::CPanoramaStitcher::InitLicenseFromLicenseContent (const char *pLicenseKey, const char *pLicenseContent) |
int | dynamsoft::dps::CPanoramaStitcher::OutputLicenseToStringPtr (char **content) |
void | dynamsoft::dps::CPanoramaStitcher::FreeLicenseString (char **content) |
Stitching Functions | |
int | dynamsoft::dps::CPanoramaStitcher::StartPanoramaStitchingByFile () |
int | dynamsoft::dps::CPanoramaStitcher::StartPanoramaStitchingByBuffer (int iWidth, int iHeight, int iStride, DPS_ImagePixelFormat format) |
int | dynamsoft::dps::CPanoramaStitcher::AppendNewFrameByFile (const char *pFileName, int isVistaImg) |
int | dynamsoft::dps::CPanoramaStitcher::AppendNewFrameByBuffer (const unsigned char *pBuffer, int isVistaImg) |
void | dynamsoft::dps::CPanoramaStitcher::WaitForFinishStitching () |
void | dynamsoft::dps::CPanoramaStitcher::StopPanoramaStitching () |
Basic Setting Functions | |
int | dynamsoft::dps::CPanoramaStitcher::GetRuntimeSettings (DPS_RuntimeSettings *pSettings) |
int | dynamsoft::dps::CPanoramaStitcher::UpdateRuntimeSettings (DPS_RuntimeSettings *pSettings, char error[], int errorMsgBufferLen) |
Advanced Setting Functions | |
int | dynamsoft::dps::CPanoramaStitcher::InitRuntimeSettingsWithString (const char *pJsonSetting, char error[], int errorMsgBufferLen) |
int | dynamsoft::dps::CPanoramaStitcher::OutputSettingsToStringPtr (char **content) |
void | dynamsoft::dps::CPanoramaStitcher::FreeSettingsString (char **content) |
int | dynamsoft::dps::CPanoramaStitcher::SetBlockImgSavePath (const char *path) |
Result Functions | |
int | dynamsoft::dps::CPanoramaStitcher::GetFinalResults (PanoramaResultArray **pResult) |
int | dynamsoft::dps::CPanoramaStitcher::GetRunningState (RunningState *pRunningState) |
static int | dynamsoft::dps::CPanoramaStitcher::GetCompleteResultImage (PanoramaResult *pResult, DMBitmap **completeImage) |
static void | dynamsoft::dps::CPanoramaStitcher::FreeDMBitmap (DMBitmap **pBmp) |
static void | dynamsoft::dps::CPanoramaStitcher::FreePanoramaResults (PanoramaResultArray **pPresults) |
Callback Functions | |
int | dynamsoft::dps::CPanoramaStitcher::SetResultCallback (CB_PanoramaResult cbFunction, void *pUser) |
int | dynamsoft::dps::CPanoramaStitcher::SetErrorCodeCallback (CB_PanoramaErrorCode cbFunction, void *pUser) |
int dynamsoft::dps::CPanoramaStitcher::AppendNewFrameByBuffer | ( | const unsigned char * | pBuffer, |
int | isVistaImg | ||
) |
Appends a new frame image buffer from a file to the inner frame queue.
[in] | pBuffer | The array of bytes which contain the image data. |
[in] | isVistaImg | A parameter defining whether is a image captured from long-distance or not. |
int dynamsoft::dps::CPanoramaStitcher::AppendNewFrameByFile | ( | const char * | pFileName, |
int | isVistaImg | ||
) |
Appends a new frame from a file to the inner frame queue.
[in] | pFileName | A string defining the file name. |
[in] | isVistaImg | A parameter defining whether is a image captured from long-distance or not. |
dynamsoft::dps::CPanoramaStitcher::CPanoramaStitcher | ( | ) |
Default constructor
|
static |
Frees memory allocated for complete panorama result.
[in] | pBmp | The bmp image. |
void dynamsoft::dps::CPanoramaStitcher::FreeLicenseString | ( | char ** | content | ) |
Frees memory allocated for the license string.
[in] | content | The output string which stores the content of license. |
|
static |
Frees memory allocated for stitched image and panorama result.
[in] | pPresults | The struct of Panorama result array. |
void dynamsoft::dps::CPanoramaStitcher::FreeSettingsString | ( | char ** | content | ) |
Frees memory allocated for runtime settings string.
[in] | content | The runtime settings string. |
|
static |
Gets the complete result image and barcodes.
[in] | pResult | The output panorama result which should be showed. |
[in,out] | completeImage | The output complete result image. |
|
static |
Returns the error info string.
[in] | iErrorCode | The error code. |
int dynamsoft::dps::CPanoramaStitcher::GetFinalResults | ( | PanoramaResultArray ** | pResult | ) |
Gets the image and barcodes results.
[in,out] | pResult | The output panorama result array. |
int dynamsoft::dps::CPanoramaStitcher::GetRunningState | ( | RunningState * | pRunningState | ) |
Gets running state of Panorama program.
[in,out] | pRunningState | The struct of running state. |
int dynamsoft::dps::CPanoramaStitcher::GetRuntimeSettings | ( | DPS_RuntimeSettings * | pSettings | ) |
Gets current settings and saves them into a struct.
[in,out] | pSettings | The struct of template settings. |
|
static |
Returns the version info of the SDK.
int dynamsoft::dps::CPanoramaStitcher::InitLicense | ( | const char * | pLicense | ) |
Reads product key and activates the SDK.
[in] | pLicense | The product keys. |
int dynamsoft::dps::CPanoramaStitcher::InitLicenseFromLicenseContent | ( | const char * | pLicenseKey, |
const char * | pLicenseContent | ||
) |
Initializes the license from the license content on the client-side for offline verification.
[in] | pLicenseKey | The license key. |
[in] | pLicenseContent | An encrypted string representing the license content (quota, expiration date, barcode type, etc.) obtained from the method OutputLicenseToStringPtr(). |
int dynamsoft::dps::CPanoramaStitcher::InitLicenseFromServer | ( | const char * | pLicenseServer, |
const char * | pLicenseKey | ||
) |
Initializes the license and connections to the specified server for online verification.
[in] | pLicenseServer | The URL of the license server. |
[in] | pLicenseKey | The license key. |
int dynamsoft::dps::CPanoramaStitcher::InitRuntimeSettingsWithString | ( | const char * | pJsonSetting, |
char | error[], | ||
int | errorMsgBufferLen | ||
) |
Initializes Panorama settings with the parameters obtained from a JSON string.
[in] | pJsonSetting | A JSON string that represents the content of the settings. |
[in,out] | error | The buffer is allocated by caller and the recommending length is 256. The error message will be copied to the buffer. |
[in] | errorMsgBufferLen | The length of allocated buffer. |
int dynamsoft::dps::CPanoramaStitcher::OutputLicenseToStringPtr | ( | char ** | content | ) |
Outputs the license content as an encrypted string from the license server to be used for offline license verification.
[in,out] | content | The output string which stores the content of license. |
int dynamsoft::dps::CPanoramaStitcher::OutputSettingsToStringPtr | ( | char ** | content | ) |
Outputs runtime settings to a string.
[in,out] | content | The output string which stores the contents of current settings. |
int dynamsoft::dps::CPanoramaStitcher::SetBlockImgSavePath | ( | const char * | path | ) |
Set the save path of small block images.
[in] | path | The save path of small block images. |
int dynamsoft::dps::CPanoramaStitcher::SetErrorCodeCallback | ( | CB_PanoramaErrorCode | cbFunction, |
void * | pUser | ||
) |
Sets callback function to process errors generated during image stitching.
[in] | cbFunction | Callback function. |
[in] | pUser | Customized arguments passed to your function. |
int dynamsoft::dps::CPanoramaStitcher::SetResultCallback | ( | CB_PanoramaResult | cbFunction, |
void * | pUser | ||
) |
Sets callback function to process panorama result, including stitched image and barcodes.
[in] | cbFunction | Callback function. |
[in] | pUser | Customized arguments passed to your function. |
int dynamsoft::dps::CPanoramaStitcher::StartPanoramaStitchingByBuffer | ( | int | iWidth, |
int | iHeight, | ||
int | iStride, | ||
DPS_ImagePixelFormat | format | ||
) |
Starts threads to manage images reading from buffer, this function should be used with AppendNewFrameByBuffer Function.
[in] | iWidth | The width of the frame image in pixels. |
[in] | iHeight | The height of the frame image in pixels. |
[in] | iStride | The stride (or scan width) of the frame image. |
[in] | format | The image pixel format used in the image byte array. |
int dynamsoft::dps::CPanoramaStitcher::StartPanoramaStitchingByFile | ( | ) |
Starts threads to manage images reading from file, this function should be used with AppendNewFrameByFile Function.
void dynamsoft::dps::CPanoramaStitcher::StopPanoramaStitching | ( | ) |
Stops stitching immediately, avoid stitching the remaining frames in the inner frame queue.
int dynamsoft::dps::CPanoramaStitcher::UpdateRuntimeSettings | ( | DPS_RuntimeSettings * | pSettings, |
char | error[], | ||
int | errorMsgBufferLen | ||
) |
Updates runtime settings with a given struct.
[in] | pSettings | The struct of template settings. |
[in,out] | error | The buffer is allocated by caller and the recommended length is 256.The error message will be copied to the buffer. |
[in] | errorMsgBufferLen | The length of the allocated buffer. |
void dynamsoft::dps::CPanoramaStitcher::WaitForFinishStitching | ( | ) |
Waits for finishing stitching all frames in the inner frame queue.
dynamsoft::dps::CPanoramaStitcher::~CPanoramaStitcher | ( | ) |
Destructor
|
protected |
The internal panorama stitcher.