KSJ_UC130C_MRNN = 0, KSJ_UC130M_MRNN, KSJ_RESERVED0, KSJ_UC320C_MRNN,
  KSJ_UC130C_MRYN, KSJ_UC130M_MRYN, KSJ_RESERVED1, KSJ_UC320C_MRYN,
  KSJ_UC500C_MRNN, KSJ_UC500M_MRNN, KSJ_UC500C_MRYN, KSJ_UC500M_MRYN,
  KSJ_UC320_OCR, KSJ_UC900C_MRNN, KSJ_UC1000C_MRNN, KSJ_UC900C_MRYN,
  KSJ_UC1000C_MRYN, KSJ_MUC120C_MRYYO, KSJ_MUC120M_MRYYO, KSJ_UD140C_SRNN,
  KSJ_UD140M_SRNN, KSJ_UC36C_MGNN, KSJ_UC36M_MGNN, KSJ_UC36C_MGYN,
  KSJ_UC36M_MGYN, KSJ_UC900C_MRYY, KSJ_UC1000C_MRYY, KSJ_UC1400C_MRYY,
  KSJ_UC36C_MGYY, KSJ_UC36M_MGYY, KSJ_UC320C_MRYY, KSJ_UC500C_MRYY,
  KSJ_UC500M_MRYY, KSJ_MUC130C_MRYN, KSJ_MUC130M_MRYN, KSJ_MUC320C_MRYN,
  KSJ_MUC36C_MGYYO, KSJ_MUC36M_MGYYO, KSJ_MUC130C_MRYY, KSJ_MUC130M_MRYY,
  KSJ_MUC320C_MRYY, KSJ_MUC500C_MRYYO, KSJ_MUC500M_MRYYO, KSJ_MUC900C_MRYY,
  KSJ_MUC1000C_MRYY, KSJ_MUC1400C_MRYY, KSJ_UD205C_SGYY, KSJ_UD205M_SGYY,
  KSJ_UD274C_SGYY, KSJ_UD274M_SGYY, KSJ_UD285C_SGYY, KSJ_UD285M_SGYY,
  KSJ_MU3C500C_MRYYO, KSJ_MU3C500M_MRYYO, KSJ_MU3C1000C_MRYYO, KSJ_MU3C1400C_MRYYO,
  KSJ_MU3V130C_CGYYO, KSJ_MU3V130M_CGYYO, KSJ_MU3E130C_EGYYO, KSJ_MU3E130M_EGYYO,
  KSJ_MUC36C_MGYFO, KSJ_MUC36M_MGYFO, KSJ_MU3C120C_MGYYO, KSJ_MU3C120M_MGYYO,
  KSJ_MU3E200C_EGYYO, KSJ_MU3E200M_EGYYO, KSJ_MUC130C_MRYNO, KSJ_MUC130M_MRYNO,
  KSJ_MUC320C_MRYNO, KSJ_U3C130C_MRYNO, KSJ_U3C130M_MRYNO, KSJ_U3C320C_MRYNO,
  KSJ_U3C500C_MRYNO, KSJ_U3C500M_MRYNO, KSJ_MU3C1401C_MRYYO, KSJ_MU3C1001C_MRYYO,
  KSJ_MUC131M_MRYN, KSJ_MU3C501C_MRYYO, KSJ_MU3C501M_MRYYO, KSJ_MUC120C_MGYYO,
  KSJ_MUC120M_MGYYO, KSJ_MU3E131C_EGYYO, KSJ_MU3E131M_EGYYO, KSJ_MU3E201C_EGYYO,
  KSJ_MU3E201M_EGYYO, KSJ_MISSING_DEVICE, KSJ_MU3S230C_SGYYO, KSJ_MU3S230M_SGYYO,
  KSJ_MU3S640C_SRYYO, KSJ_MU3S640M_SRYYO, KSJ_CUD285C_SGYYO, KSJ_CUD285M_SGYYO,
  KSJ_MU3S231C_SGYYO, KSJ_MU3S231M_SGYYO, KSJ_MU3S500C_SGYYO, KSJ_MU3S500M_SGYYO,
  KSJ_MU3S1200C_SRYYO, KSJ_MU3S1200M_SRYYO, KSJ_MU3L2K7C_AGYYO, KSJ_MU3L2K7M_AGYYO,
  KSJ_MU3L4K3C_AGYYO, KSJ_MU3L4K3M_AGYYO, KSJ_MU3HS2000C_SRYYO, KSJ_MU3HS2000M_SRYYO,
  KSJ_MU3HS500C_SGYYO, KSJ_MU3HS500M_SGYYO, KSJ_MU3HS230C_SGYYO, KSJ_MU3HS230M_SGYYO,
  KSJ_MU3HI400C_IGYYO, KSJ_MU3HI400M_IGYYO, KSJ_TEST_CAMERA, KSJ_MU3HI401C_IGYYO,
  KSJ_MU3HI401M_IGYYO, KSJ_MU3S40C_SGYYO, KSJ_MU3S40M_SGYYO, KSJ_MU3S210C_SRYYO,
  KSJ_MU3S210M_SRYYO, KSJ_MU3I130C_IGYYO, KSJ_MU3I130M_IGYYO, KSJ_MU3S321C_SGYYO,
  KSJ_MU3S321M_SGYYO, KSJ_MU3S641M_SRYYO, KSJ_MU3S1201M_SRYYO, KSJ_MU3HS2001M_SRYYO,
  KSJ_MU3S211M_SRYYO, KSJ_MU3C36C_MGYY, KSJ_MU3C36M_MGYY, KSJ_MU3HS1200C_SRYYO,
  KSJ_MU3HS1200M_SRYYO, KSJ_MU3S160C_SGYYO, KSJ_MU3S160M_SGYYO, KSJ_MU3S641C_SRYYO,
  KSJ_HU3HG500C_GGYYO, KSJ_HU3HG500M_GGYYO, KSJ_HU3HG900C_GGYYO, KSJ_HU3HG900M_GGYYO,
  KSJ_HU3HG1800C_GGYYO, KSJ_HU3HG1800M_GGYYO, KSJ_HU3HG2500C_GGYYO, KSJ_HU3HG2500M_GGYYO,
  KSJ_MU3S1600C_SRYYO, KSJ_MU3S1600M_SRYYO
}
 

定义了所有KSJApi开发包所支持的相机类型

更多...
enum  KSJ_PARAM {
  KSJ_EXPOSURE = 0, KSJ_RED, KSJ_GREEN, KSJ_BLUE,
  KSJ_GAMMA, KSJ_PREVIEW_COLUMNSTART, KSJ_PREVIEW_ROWSTART, KSJ_CAPTURE_COLUMNSTART,
  KSJ_CAPTURE_ROWSTART, KSJ_HORIZONTALBLANK, KSJ_VERTICALBLANK, KSJ_FLIP,
  KSJ_BIN, KSJ_MIRROR, KSJ_CONTRAST, KSJ_BRIGHTNESS,
  KSJ_VGAGAIN, KSJ_CLAMPLEVEL, KSJ_CDSGAIN, KSJ_RED_SHIFT,
  KSJ_GREEN_SHIFT, KSJ_BLUE_SHIFT, KSJ_COMPANDING, KSJ_EXPOSURE_LINES,
  KSJ_SATURATION, KSJ_TRIGGERDELAY, KSJ_STROBEDELAY, KSJ_TRIGGER_MODE,
  KSJ_TRIGGER_METHOD, KSJ_BLACKLEVEL, KSJ_BLACKLEVEL_THRESHOLD_AUTO, KSJ_BLACKLEVEL_THRESHOLD_LO,
  KSJ_BLACKLEVEL_THRESHOLD_HI
}
 

相机参数类型

更多...
enum  KSJ_ADDRESSMODE {
  KSJ_SKIPNONE = 0, KSJ_SKIP2, KSJ_SKIP3, KSJ_SKIP4,
  KSJ_SKIP8
}
enum  KSJ_PREVIEWSTATUS { PS_STOP, PS_START, PS_PAUSE }
 

预览视频流的状态

更多...

函数

KSJ_API int __stdcall KSJ_Init ()
 KSJ_Init.
KSJ_API int __stdcall KSJ_UnInit (void)
 KSJ_UnInit.
KSJ_API int __stdcall KSJ_DeviceGetCount (void)
 KSJ_DeviceGetCount.
KSJ_API int __stdcall KSJ_DeviceGetInformation (IN int nIndex, OUT KSJ_DEVICETYPE *pDeviceType, OUT int *pnSerials, OUT unsigned short *pwFirmwareVersion)
 KSJ_DeviceGetInformation.
KSJ_API int __stdcall KSJ_DeviceGetInformationEx (IN int nIndex, OUT KSJ_DEVICETYPE *pDeviceType, OUT int *pnSerials, OUT unsigned short *pwFirmwareVersion, OUT unsigned short *pwFpgaVersion)
 KSJ_DeviceGetInformationEx.
KSJ_API int __stdcall KSJ_GetParamRange (IN int nIndex, IN KSJ_PARAM Param, OUT int *pnMinValue, OUT int *pnMaxValue)
 KSJ_GetParamRange.
KSJ_API int __stdcall KSJ_SetParam (IN int nIndex, IN KSJ_PARAM Param, IN int nValue)
 KSJ_SetParam.
KSJ_API int __stdcall KSJ_GetParam (IN int nIndex, IN KSJ_PARAM Param, OUT int *pnValue)
 KSJ_GetParam.
KSJ_API int __stdcall KSJ_ExposureTimeSet (int nIndex, float fExposureTimeMs)
 KSJ_ExposureTimeSet.
KSJ_API int __stdcall KSJ_ExposureTimeGet (int nIndex, float *pfExpTimeMs)
 KSJ_ExposureTimeGet.
KSJ_API int __stdcall KSJ_CaptureGetDefaultFieldOfView (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode)
 KSJ_CaptureGetDefaultFieldOfView.
KSJ_API int __stdcall KSJ_CaptureSetFieldOfView (int nIndex, int nColStart, int nRowStart, int nColSize, int nRowSize, KSJ_ADDRESSMODE AmCol, KSJ_ADDRESSMODE AmRow)
 KSJ_CaptureSetFieldOfView.
KSJ_API int __stdcall KSJ_CaptureGetFieldOfView (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode)
 KSJ_CaptureGetFieldOfView.
KSJ_API int __stdcall KSJ_CaptureGetSize (int nIndex, int *pnWidth, int *pnHeight)
 KSJ_CaptureGetSize.
KSJ_API int __stdcall KSJ_CaptureGetSizeEx (int nIndex, int *pnWidth, int *pnHeight, int *pnBitCount)
 KSJ_CaptureGetSizeEx.
KSJ_API int __stdcall KSJ_CaptureRawData (int nIndex, unsigned char *pRawData)
 KSJ_CaptureRawData.
KSJ_API int __stdcall KSJ_CaptureRgbData (int nIndex, unsigned char *pRgbData)
 KSJ_CaptureRgbData.
KSJ_API int __stdcall KSJ_CaptureRgbDataEx (int nIndex, unsigned char *pRgbData, int *pnWidth, int *pnHeight, int *pnBitCount)
 KSJ_CaptureRgbDataEx.
KSJ_API int __stdcall KSJ_PreviewGetDefaultFieldOfView (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode)
 KSJ_PreviewGetDefaultFieldOfView.
KSJ_API int __stdcall KSJ_PreviewSetFieldOfView (int nIndex, int nColStart, int nRowStart, int nColSize, int nRowSize, KSJ_ADDRESSMODE AmCol, KSJ_ADDRESSMODE AmRow)
 KSJ_PreviewSetFieldOfView.
KSJ_API int __stdcall KSJ_PreviewGetFieldOfView (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode)
 KSJ_PreviewGetFieldOfView.
KSJ_API int __stdcall KSJ_PreviewGetSize (int nIndex, int *pnWidth, int *pnHeight)
 KSJ_PreviewGetSize.
KSJ_API int __stdcall KSJ_PreviewGetSizeEx (int nIndex, int *pnWidth, int *pnHeight, int *pnBitCount)
 KSJ_PreviewGetSizeEx.
KSJ_API int __stdcall KSJ_PreviewSetPos (int nIndex, HWND hWnd, int x, int y, int nWidth, int nHeight)
 KSJ_PreviewSetPos.
KSJ_API int __stdcall KSJ_PreviewGetPos (int nIndex, int *px, int *py, int *pnWidth, int *pnHeight)
 KSJ_PreviewGetPos.
KSJ_API int __stdcall KSJ_PreviewStart (int nIndex, bool bStart)
 KSJ_PreviewStart.
KSJ_API int __stdcall KSJ_PreviewGetStatus (int nIndex, KSJ_PREVIEWSTATUS *pPreviewStatus)
 KSJ_PreviewGetStatus.
KSJ_API int __stdcall KSJ_PreviewStartEx (int nIndex, bool bStart, bool bParallel)
 KSJ_PreviewStartEx.
KSJ_API int __stdcall KSJ_PreviewGetStatusEx (int nIndex, KSJ_PREVIEWSTATUS *pPreviewStatus, bool *pbParallel)
 KSJ_PreviewGetStatusEx.
KSJ_API int __stdcall KSJ_PreviewGetFrameRateEx (int nIndex, float *fFrameRateCapture, float *fFrameRateShow)
 KSJ_PreviewGetFrameRateEx.
KSJ_API int __stdcall KSJ_GetPreviewFrameCount (int nIndex, int *pnCaptureFrameCount, int *pnShowFrameCount)
 KSJ_GetPreviewFrameCount.
KSJ_API int __stdcall KSJ_SendPktEnd (int nIndex)
 KSJ_SendPktEnd.
KSJ_API int __stdcall KSJ_LogSet (bool bEnable, const TCHAR *pszFolder)
 KSJ_LogSet.
KSJ_API int __stdcall KSJ_LogGet (bool *bEnable, TCHAR *pszFolder)
 KSJ_LogGet.
KSJ_API int __stdcall KSJ_GetVersion (OUT int *pnMaj1, OUT int *pnMaj2, OUT int *pnMin1, OUT int *pnMin2)
 KSJ_GetVersion.
KSJ_API int __stdcall KSJ_GetDriveVersion (int nIndex, int *pnMaj1, int *pnMaj2, int *pnMin1, int *pnMin2)
 KSJ_GetDriveVersion.
KSJ_API int __stdcall KSJ_HelperSaveToBmp (unsigned char *pData, int nWidth, int nHeight, int nBitCount, const TCHAR *pszFileName)
 KSJ_HelperSaveToBmp.
KSJ_API int __stdcall KSJ_HelperSaveToJpg (unsigned char *pData, int nWidth, int nHeight, int nBitCount, int nQulity, const TCHAR *pszFileName)
 KSJ_HelperSaveToJpg.
KSJ_API int __stdcall KSJ_OpenSettingPage (IN int nIndex, IN void *hWndParent, int nLeft, int nTop)
 KSJ_OpenSettingPage.
KSJ_API int __stdcall KSJ_IsSettingPageShow (bool *pbShow)
 KSJ_IsSettingPageshow.
KSJ_API int __stdcall KSJ_CloseSettingPageShow ()
 KSJ_CloseSettingPageShow.
KSJ_API int __stdcall KSJ_GetSegmentNum (int nIndex, int *pnSegNum)
 KSJ_GetSegmentNum.
KSJ_API int __stdcall KSJ_GetBlackLevelRange (int nIndex, int nSegIndex, int *pnMin, int *pnMax)
 KSJ_GetBlackLevelRange.
KSJ_API int __stdcall KSJ_SetBlackLevel (int nIndex, int nSegIndex, int nBlackLevel)
 KSJ_SetBlackLevel.
KSJ_API int __stdcall KSJ_GetBlackLevel (int nIndex, int nSegIndex, int *pnBlackLevel)
 KSJ_GetBlackLevel.

枚举类型文档

定义了所有KSJApi开发包所支持的相机类型

枚举值:
KSJ_UC130C_MRNN 

0 Guass2

KSJ_UC130M_MRNN 

1 Guass2

KSJ_RESERVED0 

2 Not Support

KSJ_UC320C_MRNN 

3 Guass2

KSJ_UC130C_MRYN 

4 Guass2

KSJ_UC130M_MRYN 

5 Guass2

KSJ_RESERVED1 

6 Not Support

KSJ_UC320C_MRYN 

7 Guass2

KSJ_UC500C_MRNN 

8 Guass2

KSJ_UC500M_MRNN 

9 Guass2

KSJ_UC500C_MRYN 

10 Guass2

KSJ_UC500M_MRYN 

11 Guass2

KSJ_UC320_OCR 

12 Not Support

KSJ_UC900C_MRNN 

13 Not Support

KSJ_UC1000C_MRNN 

14 Not Support

KSJ_UC900C_MRYN 

15 Not Support

KSJ_UC1000C_MRYN 

16 Not Support

KSJ_MUC120C_MRYYO 

17 Jelly2 V6.0.121.16

KSJ_MUC120M_MRYYO 

18 Jelly2 V6.0.121.16

KSJ_UD140C_SRNN 

19 Not Support

KSJ_UD140M_SRNN 

20 Not Support

KSJ_UC36C_MGNN 

21 Elanus2 Not Support

KSJ_UC36M_MGNN 

22 Elanus2 Not Support

KSJ_UC36C_MGYN 

23 Elanus2 Not Support

KSJ_UC36M_MGYN 

24 Elanus2 Not Support

KSJ_UC900C_MRYY 

25 Elanus2

KSJ_UC1000C_MRYY 

26 Elanus2

KSJ_UC1400C_MRYY 

27 Elanus2

KSJ_UC36C_MGYY 

28 Elanus2 Not Support

KSJ_UC36M_MGYY 

29 Elanus2 Not Support

KSJ_UC320C_MRYY 

30 Elanus2 Not Support

KSJ_UC500C_MRYY 

31 Elanus2 Not Support

KSJ_UC500M_MRYY 

32 Elanus2 Not Support

KSJ_MUC130C_MRYN 

33 OEM

KSJ_MUC130M_MRYN 

34 OEM.

KSJ_MUC320C_MRYN 

35 OEM

KSJ_MUC36C_MGYYO 

36 Jelly2

KSJ_MUC36M_MGYYO 

37 Jelly2

KSJ_MUC130C_MRYY 

38 Not Support

KSJ_MUC130M_MRYY 

39 Not Support

KSJ_MUC320C_MRYY 

40 Not Support

KSJ_MUC500C_MRYYO 

41 Jelly2

KSJ_MUC500M_MRYYO 

42 Jelly2

KSJ_MUC900C_MRYY 

43 Not Support

KSJ_MUC1000C_MRYY 

44 Not Support

KSJ_MUC1400C_MRYY 

45 Not Support

KSJ_UD205C_SGYY 

46 Elanus2

KSJ_UD205M_SGYY 

47 Elanus2

KSJ_UD274C_SGYY 

48 Elanus2

KSJ_UD274M_SGYY 

49 Elanus2

KSJ_UD285C_SGYY 

50 Elanus2

KSJ_UD285M_SGYY 

51 Elanus2

KSJ_MU3C500C_MRYYO 

52 Jelly3

KSJ_MU3C500M_MRYYO 

53 Jelly3

KSJ_MU3C1000C_MRYYO 

54 Jelly3

KSJ_MU3C1400C_MRYYO 

55 Jelly3

KSJ_MU3V130C_CGYYO 

56 Jelly3

KSJ_MU3V130M_CGYYO 

57 Jelly3

KSJ_MU3E130C_EGYYO 

58 Jelly3

KSJ_MU3E130M_EGYYO 

59 Jelly3

KSJ_MUC36C_MGYFO 

60 Jelly1

KSJ_MUC36M_MGYFO 

61 Jelly1

KSJ_MU3C120C_MGYYO 

62 Jelly3

KSJ_MU3C120M_MGYYO 

63 Jelly3

KSJ_MU3E200C_EGYYO 

64 Jelly3

KSJ_MU3E200M_EGYYO 

65 Jelly3

KSJ_MUC130C_MRYNO 

66 Jelly1

KSJ_MUC130M_MRYNO 

67 Jelly1

KSJ_MUC320C_MRYNO 

68 Jelly1

KSJ_U3C130C_MRYNO 

69 Not Support

KSJ_U3C130M_MRYNO 

70 Not Support

KSJ_U3C320C_MRYNO 

71 Not Support

KSJ_U3C500C_MRYNO 

72 Guass3

KSJ_U3C500M_MRYNO 

73 Guass3

KSJ_MU3C1401C_MRYYO 

74 DELETE Not Support

KSJ_MU3C1001C_MRYYO 

75 DELETE Not Support

KSJ_MUC131M_MRYN 

76 OEM Device

KSJ_MU3C501C_MRYYO 

77 DELETE Not Support

KSJ_MU3C501M_MRYYO 

78 DELETE Not Support

KSJ_MUC120C_MGYYO 

79 Jelly2

KSJ_MUC120M_MGYYO 

80 Jelly2

KSJ_MU3E131C_EGYYO 

81 DELETE Not Support

KSJ_MU3E131M_EGYYO 

82 DELETE Not Support

KSJ_MU3E201C_EGYYO 

83 DELETE Not Support

KSJ_MU3E201M_EGYYO 

84 DELETE Not Support

KSJ_MISSING_DEVICE 

85 Device Lost Program

KSJ_MU3S230C_SGYYO 

86 Jelly3 Sony IMX174

KSJ_MU3S230M_SGYYO 

87 Jelly3 Sony IMX174

KSJ_MU3S640C_SRYYO 

88 Jelly3 Sony IMX178

KSJ_MU3S640M_SRYYO 

89 Jelly3 Sony IMX178

KSJ_CUD285C_SGYYO 

90

KSJ_CUD285M_SGYYO 

91

KSJ_MU3S231C_SGYYO 

92 Jelly3 Sony IMX249

KSJ_MU3S231M_SGYYO 

93 Jelly3 Sony IMX249

KSJ_MU3S500C_SGYYO 

94

KSJ_MU3S500M_SGYYO 

95

KSJ_MU3S1200C_SRYYO 

96

KSJ_MU3S1200M_SRYYO 

97

KSJ_MU3L2K7C_AGYYO 

98

KSJ_MU3L2K7M_AGYYO 

99

KSJ_MU3L4K3C_AGYYO 

100

KSJ_MU3L4K3M_AGYYO 

101

KSJ_MU3HS2000C_SRYYO 

102

KSJ_MU3HS2000M_SRYYO 

103

KSJ_MU3HS500C_SGYYO 

104

KSJ_MU3HS500M_SGYYO 

105

KSJ_MU3HS230C_SGYYO 

106 imx174

KSJ_MU3HS230M_SGYYO 

107

KSJ_MU3HI400C_IGYYO 

108

KSJ_MU3HI400M_IGYYO 

109

KSJ_TEST_CAMERA 

110

KSJ_MU3HI401C_IGYYO 
KSJ_MU3HI401M_IGYYO 
KSJ_MU3S40C_SGYYO 
KSJ_MU3S40M_SGYYO 

114

KSJ_MU3S210C_SRYYO 

115

KSJ_MU3S210M_SRYYO 

116

KSJ_MU3I130C_IGYYO 

117

KSJ_MU3I130M_IGYYO 

118

KSJ_MU3S321C_SGYYO 

119

KSJ_MU3S321M_SGYYO 

120

KSJ_MU3S641M_SRYYO 

121

KSJ_MU3S1201M_SRYYO 

122

KSJ_MU3HS2001M_SRYYO 

123

KSJ_MU3S211M_SRYYO 

124

KSJ_MU3C36C_MGYY 

125

KSJ_MU3C36M_MGYY 

126

KSJ_MU3HS1200C_SRYYO 

127

KSJ_MU3HS1200M_SRYYO 

128

KSJ_MU3S160C_SGYYO 

129

KSJ_MU3S160M_SGYYO 

130

KSJ_MU3S641C_SRYYO 

131

KSJ_HU3HG500C_GGYYO 

132

KSJ_HU3HG500M_GGYYO 

133

KSJ_HU3HG900C_GGYYO 

134

KSJ_HU3HG900M_GGYYO 

135

KSJ_HU3HG1800C_GGYYO 

136

KSJ_HU3HG1800M_GGYYO 

137

KSJ_HU3HG2500C_GGYYO 

138

KSJ_HU3HG2500M_GGYYO 

139

KSJ_MU3S1600C_SRYYO 

140

KSJ_MU3S1600M_SRYYO 

141

enum KSJ_PARAM

相机参数类型

枚举值:
KSJ_EXPOSURE 

Exposure Time (ms).

KSJ_RED 

Red Gain, for line scan sensor map to seg0, for ccd map to KSJ_VGAGAIN.

KSJ_GREEN 

Green Gain, for line scan sensor map to seg1, for ccd map to KSJ_LAMPLEVEL.

KSJ_BLUE 

Blue Gain, for CCD map to KSJ_CDSGAIN.

KSJ_GAMMA 

Gamma.

KSJ_PREVIEW_COLUMNSTART 

Preview Col Start.

KSJ_PREVIEW_ROWSTART 

Preview Row Start.

KSJ_CAPTURE_COLUMNSTART 

Capture Col Start.

KSJ_CAPTURE_ROWSTART 

Capture Row Start.

KSJ_HORIZONTALBLANK 

Horizontal Blank.

KSJ_VERTICALBLANK 

Vertical Blank.

KSJ_FLIP 

Flip.

KSJ_BIN 

Binning.

KSJ_MIRROR 

Mirror.

KSJ_CONTRAST 

Contrast.

KSJ_BRIGHTNESS 

Brightness.

KSJ_VGAGAIN 

VGA Gain(CCD).

KSJ_CLAMPLEVEL 

Clamp Level(CCD).

KSJ_CDSGAIN 

CDS Gain(CCD).

KSJ_RED_SHIFT 

Not Use.

KSJ_GREEN_SHIFT 

Not Use.

KSJ_BLUE_SHIFT 

Not Use.

KSJ_COMPANDING 

Companding.

KSJ_EXPOSURE_LINES 

Exposure Lines.

KSJ_SATURATION 

Saturation.

KSJ_TRIGGERDELAY 

Trigger Delay Step = 100uS.

KSJ_STROBEDELAY 

Not Use.

KSJ_TRIGGER_MODE 

Trigger Mode.

KSJ_TRIGGER_METHOD 

Trigger Method.

KSJ_BLACKLEVEL 

Black Level.

KSJ_BLACKLEVEL_THRESHOLD_AUTO 

Black Level Threshold Auto.

KSJ_BLACKLEVEL_THRESHOLD_LO 

Black Level Low Threshold.

KSJ_BLACKLEVEL_THRESHOLD_HI 

Black Level High Threshold.

枚举值:
KSJ_SKIPNONE 

正常输出所有视场设置范围内的像素点

KSJ_SKIP2 

当设置为列时,输出col0, col2, col4, col6, col8, col10等, 当设置为行时,输出row0, row2, row4, row6, row8, row10等

KSJ_SKIP3 

当设置为列时,输出col0, col3, col6, col9, col12, col15等, 当设置为行时,输出row0, row3, row6, row9, row12, row15等

KSJ_SKIP4 

当设置为列时,输出col0, col4, col8, col12, col16, col20等, 当设置为行时,输出row0, row4, row8, row12, row16, row20等

KSJ_SKIP8 

当设置为列时,输出col0, col8, col16, col24, col32, col40等,当设置为行时,输出row0, row8, row16, row24, row32, row40等

预览视频流的状态

枚举值:
PS_STOP 

视频流停止

PS_START 

视频流运行

PS_PAUSE 

视频流暂停


函数文档

KSJ_API int __stdcall KSJ_Init (  ) 

KSJ_Init.

-----------------------------------------------------------------------------

初始化KSJApi动态库,该函数在整个进程运行期间只需要调用一次。

返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
一般在程序初始化时调用
  • 相机需在这个执行这个函数之前与电脑连接
  • 可以调用多次,第二次调用如果发现已经初始化,那么将不进行任何操作,直接返回RET_SUCCESS
  • 如果需要重新枚举相机,请执行反初始化KSJ_UnInit()后再执行KSJ_Init()
  • 特别需要注意的是:重新枚举操作以后,实际相机所对应的操作索引(库函数中的nIndex参数)可能会改变;所以不能通过操作索引(库函数中的nIndex参数)区别相机,可以通过函数KSJ_SetSerials()给相机分配不同的序号(0-255,该序号保存到相机内部),通过序号区别相机。
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_UnInit ( void   ) 

KSJ_UnInit.

-----------------------------------------------------------------------------

反初始化KSJApi动态库

返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后,释放分配资源并关闭本进程中所有已经打开的相机

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_DeviceGetCount ( void   ) 

KSJ_DeviceGetCount.

-----------------------------------------------------------------------------

得到相机数目

返回:
连接到主机上的凯视佳相机数目
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_DeviceGetInformation ( IN int  nIndex,
OUT KSJ_DEVICETYPE pDeviceType,
OUT int *  pnSerials,
OUT unsigned short *  pwFirmwareVersion 
)

KSJ_DeviceGetInformation.

-----------------------------------------------------------------------------

得到相机信息(型号,序号,固件版本号)

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pusDeviceType [out] 返回相机类型的地址指针
pnSerials [out] 返回相机序号的地址指针,通过这个序号可以区别不同的物理相机,这个序号可以通过KSJ_SetSerials()修改
pusFirmwareVersion [out] 返回相机固件版本号的地址指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_DeviceGetInformationEx ( IN int  nIndex,
OUT KSJ_DEVICETYPE pDeviceType,
OUT int *  pnSerials,
OUT unsigned short *  pwFirmwareVersion,
OUT unsigned short *  pwFpgaVersion 
)

KSJ_DeviceGetInformationEx.

-----------------------------------------------------------------------------

得到相机信息(型号,序号,固件版本号,FPGA版本号)

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pusDeviceType [out] 返回相机类型的地址指针
pnSerials [out] 返回相机序号的地址指针,通过设个序号可以区别不同的物理相机,这个序号可以通过KSJ_SetSerials()修改
pusFirmwareVersion [out] 返回相机固件版本号的地址指针
pusFpgaVersion [out] 返回相机FPGA版本号的地址指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_GetParamRange ( IN int  nIndex,
IN KSJ_PARAM  Param,
OUT int *  pnMinValue,
OUT int *  pnMaxValue 
)

KSJ_GetParamRange.

-----------------------------------------------------------------------------

获取指定参数的取值范围

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
Param [in] 指定的参数(参考KSJ_PARAM定义)
pnMinValue [out] 取得指定参数的最小值
pnMaxValue [out] 取得指定参数的最大值
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_SetParam ( IN int  nIndex,
IN KSJ_PARAM  Param,
IN int  nValue 
)

KSJ_SetParam.

-----------------------------------------------------------------------------

设置相机参数值

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
Param [in] 指定的参数(参考KSJ_PARAM定义)
nValue [in] 参数设置的值
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_GetParam ( IN int  nIndex,
IN KSJ_PARAM  Param,
OUT int *  pnValue 
)

KSJ_GetParam.

-----------------------------------------------------------------------------

获取相机参数值

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
Param [in] 指定的参数(参考KSJ_PARAM定义)
pnValue [out] 参数值的地址指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ExposureTimeSet ( int  nIndex,
float  fExposureTimeMs 
)

KSJ_ExposureTimeSet.

-----------------------------------------------------------------------------

设置曝光时间

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fExposureTimeMs [in] 设置的曝光时间,单位:毫秒
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ExposureTimeGet ( int  nIndex,
float *  pfExpTimeMs 
)

KSJ_ExposureTimeGet.

-----------------------------------------------------------------------------

获取曝光时间

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pfExpTimeMs [out] 返回曝光时间的指针,单位:毫秒
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

----------------------------------------------------------------------------- 枚举类型凯视佳抽点模式定义(分为列抽点和行抽点)

KSJ_API int __stdcall KSJ_CaptureGetDefaultFieldOfView ( int  nIndex,
int *  pnColStart,
int *  pnRowStart,
int *  pnColSize,
int *  pnRowSize,
KSJ_ADDRESSMODE pColAddressMode,
KSJ_ADDRESSMODE pRowAddressMode 
)

KSJ_CaptureGetDefaultFieldOfView.

-----------------------------------------------------------------------------

获取相机的默认采集视场大小,也就是相机所支持的最大视场

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [out] 返回图像感光芯片采集时成像感光的有效区域起始列位置
pnRowStart [out] 返回图像感光芯片采集时成像感光的有效区域起始行位置
pnColSize [out] 返回图像感光芯片采集时成像感光的有效区域水平像素数
pnRowSize [out] 返回图像感光芯片采集时成像感光的有效区域垂直行数
pColAddressMode [out] 返回图像感光芯片采集列抽点模式(请参考KSJ_ADDRESSMODE的定义)
pRowAddressMode [out] 返回图像感光芯片采集行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_CaptureSetFieldOfView ( int  nIndex,
int  nColStart,
int  nRowStart,
int  nColSize,
int  nRowSize,
KSJ_ADDRESSMODE  AmCol,
KSJ_ADDRESSMODE  AmRow 
)

KSJ_CaptureSetFieldOfView.

-----------------------------------------------------------------------------

设置采集视场大小

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nColStart [in] 采集时有效成像区域相对于默认最大成像区域的水平像素起始位置
nRowStart [in] 采集时有效成像区域相对于最大成像区域的垂直行起始位置
nColSize [in] 采集时有效成像区域的水平像素数
nRowSize [in] 采集时有效成像区域的垂直行数
AmCol [in] 采集时针对有效成像区域列抽点模式(请参考KSJ_ADDRESSMODE的定义)
AmRow [in] 采集时针对有效成像区域行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 如果设置的参数不符合相机的FOV要求(例如有一些相机要求Start位置必须满足2的倍数,Size必须满足4的倍数,不能设置某个抽点模式),函数内部将会自动使用最接近的参数进行设置,并返回RET_SUCCESS(1)
  • 所以设置以后,需要重新获取当前实际生效的参数。
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureGetFieldOfView ( int  nIndex,
int *  pnColStart,
int *  pnRowStart,
int *  pnColSize,
int *  pnRowSize,
KSJ_ADDRESSMODE pColAddressMode,
KSJ_ADDRESSMODE pRowAddressMode 
)

KSJ_CaptureGetFieldOfView.

-----------------------------------------------------------------------------

获取采集视场的实际大小

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [out] 返回采集时有效成像区域相对于默认最大成像区域的水平像素起始位置
pnRowStart [out] 返回采集时有效成像区域相对于最大成像区域的垂直行起始位置
pnColSize [out] 返回采集时有效成像区域的水平像素数
pnRowSize [out] 返返回采集时有效成像区域的垂直行数
pAmCol [out] 返回采集时针对有效成像区域列抽点模式(请参考KSJ_ADDRESSMODE的定义)
pAmRow [out] 返回采集时针对有效成像区域行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_CaptureGetSize ( int  nIndex,
int *  pnWidth,
int *  pnHeight 
)

KSJ_CaptureGetSize.

-----------------------------------------------------------------------------

获取采集图像的宽度和高度

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnWidth [out] 返回当前视场模式设置下的实际采集图像的像素宽度
pnHeight [out] 返回当前视场模式设置下的实际采集图像的像素高度
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 实际采集图像的像素宽度与采集视场行大小、抽点模式有关
  • 实际采集图像的像素高度与采集视场列大小、抽点模式、多帧采集数有关
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureGetSizeEx ( int  nIndex,
int *  pnWidth,
int *  pnHeight,
int *  pnBitCount 
)

KSJ_CaptureGetSizeEx.

-----------------------------------------------------------------------------

获取采集图像的宽度和高度(单位:像素)及位图深度(8,24,32)

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnWidth [out] 返回当前视场模式设置下的实际采集图像的像素宽度
pnHeight [out] 返回当前视场模式设置下的实际采集图像的像素高度
pnBitCount [out] 返回当前视场模式设置下的实际采集图像的位图深度
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 实际采集图像的像素宽度与采集视场行大小、抽点模式有关
  • 实际采集图像的像素高度与采集视场列大小、抽点模式、多帧采集数有关
  • 实际采集图像的位图深度与当前相机类型以及Bayer模式有关
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureRawData ( int  nIndex,
unsigned char *  pRawData 
)

KSJ_CaptureRawData.

-----------------------------------------------------------------------------

采集一帧原始或黑白图像数据

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pRawData [out] 由用户分配内存空间,用于保存采集数据,采集图像的像素尺寸可以通过KSJ_CaptureGetSize或KSJ_CaptureGetSizeEx函数获得
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • pRawData必须使用者提前分配,分配的大小应为KSJ_CaptureGetSize得到的图像宽度*图像高度,如果是16bit数,应该是再乘以2。
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureRgbData ( int  nIndex,
unsigned char *  pRgbData 
)

KSJ_CaptureRgbData.

-----------------------------------------------------------------------------

采集一帧8位原始或灰度图像或24,32位彩色数据图像

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pRgbData [out] 由用户分配内存空间,用于保存采集数据,采集图像的像素尺寸可以通过KSJ_CaptureGetSizeEx函数获得
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • pRgbData必须使用者提前分配,分配的大小应为KSJ_CaptureGetSizeEx得到的图像宽度*图像高度*位图深度/8。
  • 如果是黑白相机,该函数取得的图像会原始灰度图,和KSJ_CaptureRawData得到的图像数据一样。
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureRgbDataEx ( int  nIndex,
unsigned char *  pRgbData,
int *  pnWidth,
int *  pnHeight,
int *  pnBitCount 
)

KSJ_CaptureRgbDataEx.

-----------------------------------------------------------------------------

采集一帧8位原始或灰度图像或24,32位彩色数据图像

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pRgbData [out] 由用户分配内存空间,用于保存采集数据,采集图像的像素尺寸可以通过KSJ_CaptureGetSizeEx函数获得
pnWidth [out] 返回图像的宽度(像素)
pnHeight [out] 返回图像的高度(像素)
pnBitCount [out] 返回当前视场模式设置下的实际采集图像的位图深度
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewGetDefaultFieldOfView ( int  nIndex,
int *  pnColStart,
int *  pnRowStart,
int *  pnColSize,
int *  pnRowSize,
KSJ_ADDRESSMODE pColAddressMode,
KSJ_ADDRESSMODE pRowAddressMode 
)

KSJ_PreviewGetDefaultFieldOfView.

-----------------------------------------------------------------------------

获取相机的默认预览视场大小,也就是相机所支持的最大视场

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [out] 返回图像感光芯片采集时成像感光的有效区域起始列位置
pnRowStart [out] 返回图像感光芯片采集时成像感光的有效区域起始行位置
pnColSize [out] 返回图像感光芯片采集时成像感光的有效区域水平像素数
pnRowSize [out] 返回图像感光芯片采集时成像感光的有效区域垂直行数
pAmCol [out] 返回图像感光芯片采集列抽点模式(请参考KSJ_ADDRESSMODE的定义)
pAmRow [out] 返回图像感光芯片采集行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewSetFieldOfView ( int  nIndex,
int  nColStart,
int  nRowStart,
int  nColSize,
int  nRowSize,
KSJ_ADDRESSMODE  AmCol,
KSJ_ADDRESSMODE  AmRow 
)

KSJ_PreviewSetFieldOfView.

-----------------------------------------------------------------------------

设置预览视场大小

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [in] 预览时有效成像区域相对于默认最大成像区域的水平像素起始位置
pnRowStart [in] 预览时有效成像区域相对于最大成像区域的垂直行起始位置
pnColSize [in] 预览时有效成像区域的水平像素数
pnRowSize [in] 预览时有效成像区域的垂直行数
ColAddressMode [in] 预览时针对有效成像区域列抽点模式(请参考KSJ_ADDRESSMODE的定义)
RowAddressMode [in] 预览时针对有效成像区域行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 如果设置的参数不符合相机的FOV要求(例如有一些相机要求Start位置必须满足2的倍数,Size必须满足4的倍数,不能设置某个抽点模式),函数内部将会自动使用最接近的参数进行设置,并返回RET_SUCCESS(1)
  • 所以设置以后,需要重新获取当前实际生效的参数。
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreviewGetFieldOfView ( int  nIndex,
int *  pnColStart,
int *  pnRowStart,
int *  pnColSize,
int *  pnRowSize,
KSJ_ADDRESSMODE pColAddressMode,
KSJ_ADDRESSMODE pRowAddressMode 
)

KSJ_PreviewGetFieldOfView.

-----------------------------------------------------------------------------

获取预览视场的实际大小

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [out] 返回采集时有效成像区域相对于默认最大成像区域的水平像素起始位置
pnRowStart [out] 返回采集时有效成像区域相对于最大成像区域的垂直行起始位置
pnColSize [out] 返回采集时有效成像区域的水平像素数
pnRowSize [out] 返返回采集时有效成像区域的垂直行数
pAmCol [out] 返回采集时针对有效成像区域列抽点模式(请参考KSJ_ADDRESSMODE的定义)
pAmRow [out] 返回采集时针对有效成像区域行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewGetSize ( int  nIndex,
int *  pnWidth,
int *  pnHeight 
)

KSJ_PreviewGetSize.

-----------------------------------------------------------------------------

获取预览图像的宽度和高度

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnWidth [out] 返回当前视场模式设置下的实际预览图像的像素宽度
pnHeight [out] 返回当前视场模式设置下的实际预览图像的像素高度
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 实际预览图像的像素宽度与采集视场行大小、抽点模式有关
  • 实际预览图像的像素高度与采集视场列大小、抽点模式、多帧采集数有关
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreviewGetSizeEx ( int  nIndex,
int *  pnWidth,
int *  pnHeight,
int *  pnBitCount 
)

KSJ_PreviewGetSizeEx.

-----------------------------------------------------------------------------

获取预览图像的宽度和高度(单位:像素)及位图深度(8,24,32)

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnWidth [out] 返回当前视场模式设置下的实际预览图像的像素宽度
pnHeight [out] 返回当前视场模式设置下的实际预览图像的像素高度
pnBitCount [out] 返回当前视场模式设置下的实际预览图像的位图深度
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 实际预览图像的像素宽度与采集视场行大小、抽点模式有关
  • 实际预览图像的像素高度与采集视场列大小、抽点模式、多帧采集数有关
  • 实际预览图像的位图深度与当前相机类型以及Bayer模式有关
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreviewSetPos ( int  nIndex,
HWND  hWnd,
int  x,
int  y,
int  nWidth,
int  nHeight 
)

KSJ_PreviewSetPos.

-----------------------------------------------------------------------------

设置视频图像在窗口上的显示位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
hWnd [in] 显示窗口的句柄
x [in] 显示位置相对窗口左上角水平偏移(像素)
y [in] 显示位置相对窗口左上角垂直偏移(像素)
nWidth [in] 显示的宽度,这个宽度如果大于预览图像的宽度,图像会水平放大,反之缩小
nHeight [in] 显示图像的高度,这个宽度如果大于预览图像的高度,图像会垂直放大,反之缩小
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewGetPos ( int  nIndex,
int *  px,
int *  py,
int *  pnWidth,
int *  pnHeight 
)

KSJ_PreviewGetPos.

-----------------------------------------------------------------------------

得到当前视频预览图像的显示位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
px [out] 返回显示位置相对窗口左上角水平偏移(像素)
py [out] 返回显示位置相对窗口左上角垂直偏移(像素)
pnWidth [out] 返回显示的宽度
pnHeight [out] 返回显示图像的高度
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewStart ( int  nIndex,
bool  bStart 
)

KSJ_PreviewStart.

-----------------------------------------------------------------------------

启动视频流,用户必须先通过KSJ_PreviewSetPos来设置视频显示的窗口及位置创建一个预览窗口,否则将看不到预览视频流

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bStart [in] true 打开视频流,显示在窗口指定位置(参考KSJ_PreviewSetPos函数),false 关闭视频流
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewGetStatus ( int  nIndex,
KSJ_PREVIEWSTATUS pPreviewStatus 
)

KSJ_PreviewGetStatus.

-----------------------------------------------------------------------------

获取视频预览的状态

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pPreviewStatus [out] 返回预览状态
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewStartEx ( int  nIndex,
bool  bStart,
bool  bParallel 
)

KSJ_PreviewStartEx.

-----------------------------------------------------------------------------

用并行模式启动视频流,用户必须先通过KSJ_PreviewSetPos来设置视频显示的窗口及位置创建一个预览窗口,否则将看不到预览视频流

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bStart [in] true 开启视频流,false 关闭视频流
bParallel [in] true 用并行模式打开视频流,false 使用串行模式
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewGetStatusEx ( int  nIndex,
KSJ_PREVIEWSTATUS pPreviewStatus,
bool *  pbParallel 
)

KSJ_PreviewGetStatusEx.

-----------------------------------------------------------------------------

获取视频预览和并行的状态

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pPreviewStatus [out] 返回预览状态
pbParallel [out] 返回并行状态
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_PreviewGetFrameRateEx ( int  nIndex,
float *  fFrameRateCapture,
float *  fFrameRateShow 
)

KSJ_PreviewGetFrameRateEx.

-----------------------------------------------------------------------------

预览时,获取采集和显示的帧速

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fFrameRateCapture [out] 返回当前采集的帧速
fFrameRateShow [out] 返回当前视频流的帧速
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_GetPreviewFrameCount ( int  nIndex,
int *  pnCaptureFrameCount,
int *  pnShowFrameCount 
)

KSJ_GetPreviewFrameCount.

-----------------------------------------------------------------------------

获取预览采集和显示的图像数

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnCaptureFrameCount [out] 返回当前预览一共采集的图像数
pnShowFrameCount [out] 返回当前预览一共显示的图像图像数
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_SendPktEnd ( int  nIndex  ) 

KSJ_SendPktEnd.

-----------------------------------------------------------------------------

主动结束当前传输请求

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 在使用KSJ_CaptureRgbData等函数采集图像时,如果一直没有图像传回(比如外触发模式下,当前没有外触发信号),需要在超时时间内结束采集,可以执行该操作,Capture函数立即返回。
  • Capture函数立即返回有可能是零帧(RET_ZEROFRAME)或者半帧(RET_INVALIDFRAME,数据传到一半被中断)
  • 如果当前没有执行采集操作,执行了该操作(一次或者多次),那么下一次将会采集到一个零帧(RET_ZEROFRAME)
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_LogSet ( bool  bEnable,
const TCHAR *  pszFolder 
)

KSJ_LogSet.

-----------------------------------------------------------------------------

设置Log日志是否输出及输出的保存目录

参数:
bEnable [in] 是否打开Log日志的输出功能
pszFolder [in] 输出的Log日志所保存的目录;可以为NULL或空字符串。

  • 如果为NULL或空字符串,则Log输出目录会自动创建,目录位置在KSJAPI库所在目录下创建名称为KSJApiLog的目录
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
可以在任意时刻调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_LogGet ( bool *  bEnable,
TCHAR *  pszFolder 
)

KSJ_LogGet.

-----------------------------------------------------------------------------

获得日志相关信息

参数:
bEnable [out] 返回是否已经打开Log日志的输出功能
pszFolder [out] 返回输出的Log日志所保存的目录(可以为NULL,表示不需获取此信息)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
可以在任意时刻调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_GetVersion ( OUT int *  pnMaj1,
OUT int *  pnMaj2,
OUT int *  pnMin1,
OUT int *  pnMin2 
)

KSJ_GetVersion.

-----------------------------------------------------------------------------

获取KSJAPI库的版本号

参数:
pnMaj1 [out] 返回主版本号1,一般做重要整体结构调整时会改变,增加1;主版本号1不同的API库不兼容
pnMaj2 [out] 返回主版本号2,一般做主要功能增加时会改变,增加1
pnMin1 [out] 返回次版本号1,一般做重要整体结构调整或者修改主要逻辑时会改变,增加1
pnMin2 [out] 返回次版本号2,一般在小的改动、修改Bug时会改变,增加1
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_GetDriveVersion ( int  nIndex,
int *  pnMaj1,
int *  pnMaj2,
int *  pnMin1,
int *  pnMin2 
)

KSJ_GetDriveVersion.

-----------------------------------------------------------------------------

获取KSJ相机驱动的版本号

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnMaj1 [out] 返回主版本号1
pnMaj2 [out] 返回主版本号2
pnMin1 [out] 返回次版本号1
pnMin2 [out] 返回次版本号2
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
可以在任意时刻调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_HelperSaveToBmp ( unsigned char *  pData,
int  nWidth,
int  nHeight,
int  nBitCount,
const TCHAR *  pszFileName 
)

KSJ_HelperSaveToBmp.

-----------------------------------------------------------------------------

将图像数据保存为BMP文件

参数:
pData [in] 指向图像数据的首地址指针
nWidth [in] 图像的宽度(像素)
nHeight [in] 图像的高度(像素)
nBitCount [in] 8为灰度图像数据,24为24位彩色图像数据,其他值不支持
pszFileName [in] 保存文件的全路径名(所在路径目录必须存在)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
可以在任意时刻调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_HelperSaveToJpg ( unsigned char *  pData,
int  nWidth,
int  nHeight,
int  nBitCount,
int  nQulity,
const TCHAR *  pszFileName 
)

KSJ_HelperSaveToJpg.

-----------------------------------------------------------------------------

将图像数据保存为JPG文件

参数:
pData [in] 指向图像数据的首地址指针
nWidth [in] 图像的宽度(像素)
nHeight [in] 图像的高度(像素)
nBitCount [in] 8为灰度图像数据,24为24位彩色图像数据,其他值不支持
nQulity [in] JPG图像的质量
pszFileName [in] 保存文件的全路径名(所在路径目录必须存在)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
可以在任意时刻调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_OpenSettingPage ( IN int  nIndex,
IN void *  hWndParent,
int  nLeft,
int  nTop 
)

KSJ_OpenSettingPage.

-----------------------------------------------------------------------------

打开相机设置界面

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
hWndParent [in] 弹出设置对话框的主窗口句柄
nLeft [in] 弹出设置对话框相对主窗口的左偏移
nTop [in] 弹出设置对话框相对主窗口的右偏移
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_IsSettingPageShow ( bool *  pbShow  ) 

KSJ_IsSettingPageshow.

-----------------------------------------------------------------------------

相机设置界面是否打开

参数:
pbShow [in] 设置对话框是否显示
返回:
参考返回状态码(KSJCode.H)
注意:
可以在任意时候调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_CloseSettingPageShow (  ) 

KSJ_CloseSettingPageShow.

-----------------------------------------------------------------------------

关闭相机设置界面

返回:
参考返回状态码(KSJCode.H)。
注意:
可以在任意时候调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_GetSegmentNum ( int  nIndex,
int *  pnSegNum 
)

KSJ_GetSegmentNum.

-----------------------------------------------------------------------------

取得相机的区段数目

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnSegNum [out] 返回当前相机的区段数目
返回:
参考返回状态码(KSJCode.H)
注意:
调用KSJ_Init函数初始化后调用
  • 该功能仅对线阵相机有效,获得线阵相机指定区段数
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_GetBlackLevelRange ( int  nIndex,
int  nSegIndex,
int *  pnMin,
int *  pnMax 
)

KSJ_GetBlackLevelRange.

-----------------------------------------------------------------------------

获取相机指定区段的黑电平范围

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nSegIndex [in] 区段索引(范围由KSJ_GetSegmentNum得到)
pnMin [out] 返回最小黑电平值
pnMax [out] 返回最大黑电平值
返回:
参考返回状态码(KSJCode.H)
注意:
调用KSJ_Init函数初始化后调用
  • 该功能仅对线阵相机有效,获得线阵相机指定区段黑平衡电平范围
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_SetBlackLevel ( int  nIndex,
int  nSegIndex,
int  nBlackLevel 
)

KSJ_SetBlackLevel.

-----------------------------------------------------------------------------

设置相机某个区段的黑电平值

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nSegIndex [in] 区段索引(范围由KSJ_GetSegmentNum得到)
nBlackLevel [in] 设置黑电平值
返回:
参考返回状态码(KSJCode.H)
注意:
调用KSJ_Init函数初始化后调用
  • 该功能仅对线阵相机有效,设置线阵相机指定区段黑平衡电平
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_GetBlackLevel ( int  nIndex,
int  nSegIndex,
int *  pnBlackLevel 
)

KSJ_GetBlackLevel.

-----------------------------------------------------------------------------

获取相机某个区段的黑电平值

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nSegIndex [in] 区段索引(范围由KSJ_GetSegmentNum得到)
pnBlackLevel [out] 返回当前的黑电平值
返回:
参考返回状态码(KSJCode.H)
注意:
调用KSJ_Init函数初始化后调用
  • 该功能仅对线阵相机有效,获得当前线阵相机指定区段的黑平衡电平
-----------------------------------------------------------------------------