Tilt

Description

Returns or sets the row value of the tilt.


Syntax

[VB]
objActiveDcam.Tilt [= Value]

[C/C++]
HRESULT get_Tilt( long *pTilt );
HRESULT put_Tilt( long Tilt );


Data Type [VB]

Long

Parameters [C/C++]

pTilt [out,retval]

Pointer to the current tilt value

Tilt [in]

The tilt value to be set

Return Values

S_OK

Success

E_FAIL

The tilt control is not available for the selected camera

E_INVALIDARG

The value is out of range

Example

The following VB example demonstrates the use of a scroll control for real-time adjustment of the camera's tilt.

Private Sub Form_Load()
ActiveDcam1.Acquire=True
HScroll1.Value = ActiveDcam1.Tilt
HScroll1.Min = ActiveDcam1.GetTiltMin
HScroll1.Max = ActiveDcam1.GetTiltMax
End Sub

Private Sub HScroll1_Scroll()
ActiveDcam1.Tilt = HScroll1.Value
End Sub

Remarks

This property provides adjustment of the camera's pan feature. Depending on the camera model, it can control the mechanical tilt by physically moving the camera in the vertical plane or the electronic tilt by choosing the vertical position of the effective image area on a CCD sensor.

The valid property range is reported by the GetTiltMin and GetTiltMax methods. Note that the property is available only if the currently selected camera supports software tilt control.