CameraDescriptionNonStandard Class Reference

A class describing non-standard video cameras(Device specific interface layout only) (deprecated. More...

Inheritance diagram for CameraDescriptionNonStandard:

Public Member Functions
int	copyDescription (String newName)
	Creates a new camera description list as a copy of the current one.
synchronized void	delete ()
int	exportDescription ()
	Stores the current camera description on disk.
PropertyI	getAoiHeight ()
	An integer property defining the number of active lines to capture from the camera.
PropertyI	getAoiStartX ()
	An integer property defining the X-offset in pixels to the first active pixel to capture.
PropertyI	getAoiStartY ()
	An integer property defining the Y-offset in lines to the first active line to capture.
PropertyI	getAoiWidth ()
	An integer property defining the number of active pixels to capture per line.
PropertyI	getClampMode ()
	An enumerated integer property defining the clamp mode for this camera description.
PropertyI	getClampStart_us ()
	The clamp start position defines where in each line of the video signal the frame grabber assumes the black level position.
String	getClassName ()
	Returns the class this description is belonging to.
PropertyI	getFieldGateMode ()
	An enumerated integer property defining the clamp mode for this camera description.
PropertyI	getFieldGateStart ()
	An integer property defining the start position (in pixel clocks) of the field gate detection area.
PropertyI	getFieldGateWidth ()
	An integer property defining the width (in pixel clocks) of the field gate detection area.
PropertyI	getHDOutput ()
	An enumerated integer property defining whether the horizontal sync.
PropertyI	getInterlacedType ()
	An enumerated integer property defining how the camera transmits image data.
PropertyI	getLineFrequency_Hz ()
	An integer property containing the line frequency of this camera in Hertz.
PropertyS	getName ()
	A string property read-only containing the name of this camera description list.
PropertyI	getPixelClockOutput ()
	An enumerated integer property containing information whether the pixel clock is part of the video signal or not.
PropertyI	getScanRate_kHz ()
	An integer property containing the scan rate in kHz needed to driver the AD converter of the capture device with to convert the video signal properly.
PropertyI	getScanStandard ()
	An enumerated integer property defining the scan standard this camera is compliant with.
PropertyI	getStartField ()
	An enumerated integer property containing information about the first field transmitted by a camera.
PropertyI	getSyncOutput ()
	An enumerated integer property for RGB cameras containing information where the sync.
PropertyI	getVDOutput ()
	An enumerated integer property defining whether the vertical sync.
PropertyI	getVideoOutput ()
	An enumerated integer property defining the type of video outputs this camera offers.
PropertyI	getVideoStandard ()
	An enumerated integer property for defining the video standard this camera is compliant with.
int	hObj ()
	Returns a unique identifier for the component collection referenced by this object.
int	importDescription ()
	Updates a camera description with the data stored in a previous session or with the original default data.
ComponentCollection	restoreDefault ()
	Restores the default for every component of this collection.

Protected Member Functions
	CameraDescriptionNonStandard (long cPtr, boolean cMemoryOwn)
void	finalize ()

Static Protected Member Functions
static long	swigRelease (CameraDescriptionBase obj)
static long	swigRelease (CameraDescriptionNonStandard obj)
static long	swigRelease (CameraDescriptionStandardBase obj)
static long	swigRelease (ComponentCollection obj)

Protected Attributes
transient boolean	swigCMemOwn

Detailed Description

A class describing non-standard video cameras(Device specific interface layout only) (deprecated.

Deprecated

Beginning with the release of 3.0.0 of Impact Acquire everything specifically related to frame grabber boards will be considered as deprecated and might be removed without further notice!

This class can be used to describe a non-standard analogue video camera. A camera considered as non-standard when it is not compliant with one of the defined video standards like e.g. CCIR.

Note

This class will only be available if mvIMPACT.acquire.Device.getInterfaceLayout() is set to mvIMPACT.acquire.TDeviceInterfaceLayout.dilDeviceSpecific before the device is opened.

Constructor & Destructor Documentation

CameraDescriptionNonStandard()

CameraDescriptionNonStandard ( long cPtr, boolean cMemoryOwn )

protected

Member Function Documentation

copyDescription()

int copyDescription ( String newName )

inherited

Creates a new camera description list as a copy of the current one.

This function can be used to create a new camera description list. It will create a deep copy of the properties referenced by this camera description and will append the new description to the list of camera descriptions.

Note

This will NOT store the new description permanently. After the driver has been closed, this data will be lost. To store the new list in a way that it will be available the next time the driver/device is opened again, mvIMPACT.acquire.CameraDescriptionBase.exportDescription must be called with the handle of the newly created description after this function.

See also

mvIMPACT.acquire.CameraDescriptionBase.exportDescription,
mvIMPACT.acquire.CameraDescriptionBase.importDescription

Returns

• mvIMPACT.acquire.TDMR_ERROR.DMR_NO_ERROR if successful.
• mvIMPACT.acquire.TDMR_ERROR.DEV_INPUT_PARAM_INVALID if new name matches a description that is already existing.
• A negative error code of type mvIMPACT.acquire.TDMR_ERROR or mvIMPACT.acquire.TPROPHANDLING_ERROR otherwise.

Parameters

newName

[in] The name for the newly created camera description. This name MUST NOT match a description already existing.

delete()

synchronized void delete

(

)

Reimplemented from CameraDescriptionStandardBase.

exportDescription()

int exportDescription ( )

inherited

Stores the current camera description on disk.

This function can be used to store the current settings of a camera description permanently so that the next time the driver is initialized these settings are restored.

When exporting a camera description a file in XML format will be written to disk.

• On Windows® camera descriptions will be stored under PUBLIC%/Documents/Balluff/ImpactAcquire/CameraFiles (or MVIMPACT_ACQUIRE_DATA_DIR%/CameraFiles, which will point to the same folder)
• On Unix based systems this directory will be /opt/ImpactAcquire/data/camerafiles
• On other platforms these files will end up in the current working directory.

This behaviour can be modified by writing the property mvIMPACT.acquire.Device.getCustomDataDirectory() before initialising the device.

See also

mvIMPACT.acquire.CameraDescriptionBase.copyDescription,
mvIMPACT.acquire.CameraDescriptionBase.importDescription

Returns

• mvIMPACT.acquire.TDMR_ERROR.DMR_NO_ERROR if successful.
• A negative error code of type mvIMPACT.acquire.TDMR_ERROR or mvIMPACT.acquire.TPROPHANDLING_ERROR otherwise.

finalize()

void finalize ( )

protected

Reimplemented from CameraDescriptionStandardBase.

getAoiHeight()

PropertyI getAoiHeight ( )

inherited

An integer property defining the number of active lines to capture from the camera.

getAoiStartX()

PropertyI getAoiStartX ( )

inherited

An integer property defining the X-offset in pixels to the first active pixel to capture.

getAoiStartY()

PropertyI getAoiStartY ( )

inherited

An integer property defining the Y-offset in lines to the first active line to capture.

getAoiWidth()

PropertyI getAoiWidth ( )

inherited

An integer property defining the number of active pixels to capture per line.

getClampMode()

PropertyI getClampMode

(

)

An enumerated integer property defining the clamp mode for this camera description.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TClampMode.

getClampStart_us()

PropertyI getClampStart_us

(

)

The clamp start position defines where in each line of the video signal the frame grabber assumes the black level position.

This will only need modification in very rare cases.

getClassName()

String getClassName ( )

inherited

Returns the class this description is belonging to.

Returns

The class this description is belonging to.

getFieldGateMode()

PropertyI getFieldGateMode

(

)

An enumerated integer property defining the clamp mode for this camera description.

This defines how the field detection(ODD/EVEN) is done.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TFieldGateMode.

getFieldGateStart()

PropertyI getFieldGateStart

(

)

An integer property defining the start position (in pixel clocks) of the field gate detection area.

This will only need modification in very rare cases.

getFieldGateWidth()

PropertyI getFieldGateWidth

(

)

An integer property defining the width (in pixel clocks) of the field gate detection area.

This will only need modification in very rare cases.

getHDOutput()

PropertyI getHDOutput

(

)

An enumerated integer property defining whether the horizontal sync.

information is part of the video signal or transmitted via a separate wire.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraExternalSyncEdge.

getInterlacedType()

PropertyI getInterlacedType ( )

inherited

An enumerated integer property defining how the camera transmits image data.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraInterlacedType.

getLineFrequency_Hz()

PropertyI getLineFrequency_Hz

(

)

An integer property containing the line frequency of this camera in Hertz.

getName()

PropertyS getName ( )

inherited

A string property read-only containing the name of this camera description list.

getPixelClockOutput()

PropertyI getPixelClockOutput

(

)

An enumerated integer property containing information whether the pixel clock is part of the video signal or not.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraExternalSyncEdge.

getScanRate_kHz()

PropertyI getScanRate_kHz ( )

inherited

An integer property containing the scan rate in kHz needed to driver the AD converter of the capture device with to convert the video signal properly.

getScanStandard()

PropertyI getScanStandard ( )

inherited

An enumerated integer property defining the scan standard this camera is compliant with.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TScanStandard.

getStartField()

PropertyI getStartField ( )

inherited

An enumerated integer property containing information about the first field transmitted by a camera.

A camera might transmit either the odd or the even field of an interlaced video signal first.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TAcquisitionField.

getSyncOutput()

PropertyI getSyncOutput

(

)

An enumerated integer property for RGB cameras containing information where the sync.

information is transmitted.

This can either be within one of the three color components or on a separate wire.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraExternalSyncOutput.

getVDOutput()

PropertyI getVDOutput

(

)

An enumerated integer property defining whether the vertical sync.

information is part of the video signal or transmitted via a separate wire.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraExternalSyncEdge.

getVideoOutput()

PropertyI getVideoOutput ( )

inherited

An enumerated integer property defining the type of video outputs this camera offers.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraOutput.

Note

This property will be (read-only) for camera descriptions of type mvIMPACT.acquire.CameraDescriptionCameraLink and mvIMPACT.acquire.CameraDescriptionSDI as for these camera types the video output depends on certain other parameters according to the corresponding standard.

getVideoStandard()

PropertyI getVideoStandard ( )

inherited

An enumerated integer property for defining the video standard this camera is compliant with.

Valid values for this property are defined by the enumeration mvIMPACT.acquire.TVideoStandard.

hObj()

int hObj ( )

inherited

Returns a unique identifier for the component collection referenced by this object.

This handle will always reference an object of type mvIMPACT.acquire.ComponentList.

Returns

A unique identifier for the component referenced by this object.

importDescription()

int importDescription ( )

inherited

Updates a camera description with the data stored in a previous session or with the original default data.

When importing a camera description the device driver will try to retrieve the parameters needed from a XML file.

• On Windows® camera descriptions MUST be stored under PUBLIC%/Documents/Balluff/ImpactAcquire/CameraFiles (or MVIMPACT_ACQUIRE_DATA_DIR%/CameraFiles, which will point to the same folder)
• n Unix based systems this directory will be /opt/ImpactAcquire/data/camerafiles
• On other platforms these files MUST be located in the current working directory.

This behaviour can be modified by writing the property mvIMPACT.acquire.Device.getCustomDataDirectory() before initialising the device. To get access to an XML description file within the application, these file must be copied to this directory BEFORE the device is initialized. During the initialisation process the device driver will process every file located under this location and will add them to the internal list of descriptions. Every camera located during this process and also descriptions created later on during the program operation can be selected via the property mvIMPACT.acquire.CameraSettingsFrameGrabber.getType().

Note

In order not to bloat the device driver with redundant data it's wise only to store the descriptions needed for the application to run under this location.

Only camera descriptions supported by the capture device will be added to the device drivers internal list and will therefore be accessible via the mvIMPACT.acquire.CameraDescriptionManager.

To restore the default values valid during the driver was initialized the function mvIMPACT.acquire.ComponentCollection.restoreDefault can be used as well.

See also

mvIMPACT.acquire.CameraDescriptionBase.exportDescription,
mvIMPACT.acquire.CameraDescriptionBase.copyDescription

Returns

• mvIMPACT.acquire.TDMR_ERROR.DMR_NO_ERROR if successful.
• A negative error code of type mvIMPACT.acquire.TDMR_ERROR or mvIMPACT.acquire.TPROPHANDLING_ERROR otherwise.

restoreDefault()

ComponentCollection restoreDefault ( )

inherited

Restores the default for every component of this collection.

Calling this function will restore the default value for every component belonging to this collection.

Note

The caller must have the right to modify the component. Otherwise an exception will be thrown.

Returns

A const reference to the component.

swigRelease() [1/4]

static long swigRelease ( CameraDescriptionBase obj )

staticprotectedinherited

swigRelease() [2/4]

static long swigRelease ( CameraDescriptionNonStandard obj )

staticprotected

swigRelease() [3/4]

static long swigRelease ( CameraDescriptionStandardBase obj )

staticprotectedinherited

swigRelease() [4/4]

static long swigRelease ( ComponentCollection obj )

staticprotectedinherited

Member Data Documentation

swigCMemOwn

transient boolean swigCMemOwn

protectedinherited