📄 extdev.h
字号:
* SY_Field_1 - Synchronize with the start of field 1
* SY_Frame - Synchronize with the start of frame
* SY_VSync - Synchronize with the vertical sync pulse
* @endcode
* This value can be OR-ed with one of the
* @ref LiveFreeze_Target "LiveFreeze_Target" definitions to select
* the target to be lived.
* @return @ref ErrorDefinitions
* @sa Live(), LvGrabberNode::ActivateCamera(), SetLiveParam()
*/
LVSTATUS Freeze(U32BIT Mode);
/** Acquire a single frame from the camera.
* The function acquires a single frame from the camera and then freezes
* the acquisition. The function returns when the image is completely
* acquired.\n
* The camera must be already activated and a LvROI must be activated on
* a specific target.
* @return @ref ErrorDefinitions
* @sa Live(), Freeze(), LvGrabberNode::ActivateCamera(), LvGrabberNode::ActivateROI()
*/
LVSTATUS AcquireSingleFrame(void);
/*! Sets the contrast level.
* @param Level_0_100 Percentage level to which the level will be
* set; in the actual release this percentage
* cannot exceed the 100% as it is referred to
* the actual hardware capability. The contrast
* and brightness when working with BW or
* RGB cameras are interrelated.
* @return @ref ErrorDefinitions
*/
LVSTATUS SetContrast(float Level_0_100);
/*! Sets the Brightness level
* @param Level_0_100 Percentage level to which the level will be
* set; in the actual release this percentage
* cannot exceed the 100% as it is referred to
* the actual hardware capability. The contrast
* and brightness when working with BW or
* RGB cameras are interrelated.
* @return @ref ErrorDefinitions
*/
LVSTATUS SetBrightness(float Level_0_100);
/*! Sets the Hue level
* @param Level_0_100 Percentage level to which the level will be
* set; in the actual release this percentage
* cannot exceed the 100% as it is referred to
* the actual hardware capability. This method
* will fail when applied to BW or RGB cameras.
* @return @ref ErrorDefinitions
*/
LVSTATUS SetHue(float Level_0_100);
/*! Sets the Saturation level
* @param Level_0_100 Percentage level to which the level will be
* set; in the actual release this percentage
* cannot exceed the 100% as it is referred to
* the actual hardware capability. This method
* will fail when applied to BW or RGB cameras.
* @return @ref ErrorDefinitions
*/
LVSTATUS SetSaturation(float Level_0_100);
/*? Sets the ADC upper level.
* PicPort Monochrome only.\n
* This function allows an application to directly set the desired upper level in
* the input ADC. This bypasses the handling made by Daisy in the
* SetContrast() and SetBrightness() functions.
* @param Value The value to be set in the ADC as upper
* level; this value depends on the actual
* hardware and should be in the range
* determined by calling the
* GetADCUpperLimit() and
* GetADCLowerLimit() functions.
* @return @ref ErrorDefinitions
* @sa SetADCLowerLevel(), GetADCUpperLevel(), GetADCUpperLimit(),
* GetADCLowerLimit(), SetContrast(), SetBrightness()
*/
LVSTATUS SetADCUpperLevel(U32BIT Value);
/*? Sets the ADC lower level.
* PicPort Monochrome only.\n
* This function allows an application to directly set the desired lower level in
* the input ADC. This bypasses the handling made by Daisy in the
* SetContrast() and SetBrightness() functions.
* @param Value The value to be set in the ADC as lower level;
* this value depends on the actual hardware
* and should be in the range determined by
* calling the GetADCUpperLimit and
* GetADCLowerLimit() functions.
* @return @ref ErrorDefinitions
* @sa SetADCUpperLevel(), GetADCLowerLevel(), GetADCUpperLimit()
* GetADCLowerLimit(), SetContrast(), SetBrightness()
*/
LVSTATUS SetADCLowerLevel(U32BIT Value);
/*? Returns the lowest possible value for the ADC level.
* This function returns the lowest possible value for the ADC level.
* @return The lowest value an application can set as lower ADC level.
* @sa SetADCUpperLevel(), SetADCLowerLevel()
*/
U32BIT GetADCLowerLimit(void);
/*? Returns the highest possible value for the ADC level.
* This function returns the highest possible value for the ADC level.
* @return The highest value an application can set as upper ADC level.
* @sa SetADCUpperLevel(), SetADCLowerLevel()
*/
U32BIT GetADCUpperLimit(void);
/** Set gain property of camera.
* If the image from camera is too dark or too light there could be set gain of
* this camera by calling this function.\n
* - Analog gain: amplification applied by the A/D converter during the signal conversion
* - Digital gain: amplification applied to already digitized image by means of a bit-shift (by controlling
* which bits are actually output from the A/D converter)
*
* @note Currently functional only on GigE and USB cameras. CameraLink cameras will be supported
* in some of next release
* @param Gain Very difficult to explain what could be entered in this parameter. It depends on camera type and
* which sensor this camera uses.
* - CCD cameras: value describes the analog gain times 100. This means a value
* of 750 means 7.5db.
* - CMOS cameras: this setting is treated another way.
*
* Generally the best solution is to use GetGain() function and gets limits of this camera. Then
* use some value from this range.\n
* @param GainType type of gain - /b CameraGain_Analog (for analog cameras) or /b CameraGain_Digital (for digital cameras)
* @sa GetGain()
*/
LVSTATUS SetGain(U32BIT Gain, U32BIT GainType=0);
/** Get gain information of this camera.
* Get gain actual value and range of possible other values which could be entered as parameter
* in @ref SetGain() function.\n
* If some parameter isn't necessary, you could enter NULL value\n
* - Analog gain: amplification applied by the A/D converter during the signal conversion
* - Digital gain: amplification applied to already digitized image by means of a bit-shift (by controlling
* which bits are actually output from the A/D converter)
*
* @param Current current value of gain
* @param Min minimal value, which this camera supports
* @param Max maximal value, which this camera supports
* @param GainType type of gain - /b CameraGain_Analog (for analog cameras) or /b CameraGain_Digital (for digital cameras)
* @return @ref ErrorDefinitions
* @sa SetGain()
*/
LVSTATUS GetGain(U32BIT *Current, U32BIT *Min, U32BIT *Max, U32BIT GainType=0);
/** Shutter time in microseconds.
* If the requested value cannot be used, the camera uses the
* closest possible value lower than the requested one.
* @param uSec requested time of exposure in microseconds. Its functionality depends
* of camera which you use.
* - CCD camera supports only discrete shutter times. When calling this function
* it always takes the equal or next lower available shutter time. Therefore one
* have to call GetExposure() to retrieve the current active shutter time.
* - CMOS camera supports variable shutter times within the max./min. range. So even for
* CMOS camera you have to query back the information to be sure that you don't
* crossed the limits.
*
* @param Reserved Reserved. Not use.
* @return @ref ErrorDefinitions
*/
LVSTATUS SetExposure(U32BIT uSec, U32BIT Reserved=0);
/** Get current exposure time value in microseconds.
* Get current exposure time value in microseconds.
* @param uSec current exposure time in microseconds
* @param Reserved Reserved, do not use
* @return @ref ErrorDefinitions
*/
LVSTATUS GetExposure(U32BIT *uSec, U32BIT Reserved=0);
/** Get current exposure time value together with minmum and maximum values.
* All exposure time values are in microseconds.
* @param Current current exposure time in microseconds
* @param Min minimum allowed exposure time in microseconds
* @param MAx maximum allowed exposure time in microseconds
* @return @ref ErrorDefinitions
*/
LVSTATUS GetExposureAndLimits(U32BIT *Current, U32BIT *Min, U32BIT *Max);
/** Set black level offset.
* Black level is offset applied to the video signal, shifting the output values to desired range.
* @param Level the CCD cameras support black level adjustment in range 0-255. The CMOS cameras have
* currently no support for black level function.
* @param Reserved Reserved. Don't use.
*/
LVSTATUS SetBlackLevel(U32BIT Level, U32BIT Reserved=0);
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -