A base class for properties. More...

#include <mvIMPACT_acquire.h>

Inheritance diagram for Property:

Public Member Functions
bool	allowsValueCombinations (void) const
	Checks if this enumerated property allows the combination of enum values.

unsigned int	changedCounter (void) const
	Returns the current changed counter for the component referenced by this object.

unsigned int	changedCounterAttr (void) const
	Returns the current attribute changed counter for the component referenced by this object.

unsigned int	dictSize (void) const
	Returns the size of the properties translation dictionary.

std::string	displayName (void) const
	Returns the display name of the component referenced by this object.

std::string	docString (void) const
	Returns a string containing general information about the component referenced by this object.

Component	firstChild (void) const
	Moves to the first child of this component(moves down one level).

Component	firstSibling (void) const
	Moves to the first sibling(the first feature in the current list of features).

TComponentFlag	flags (void) const
	Returns the flags associated with this component.

std::string	flagsAsString (const std::string &separator=" \| ") const
	Returns the flags associated with this component as a string.

bool	hasDict (void) const
	Returns whether this property defines a translation dictionary or not.

bool	hasMaxValue (void) const
	Checks if a maximum value is defined for this property.

bool	hasMinValue (void) const
	Checks if a minimum value is defined for this property.

bool	hasStepWidth (void) const
	Checks if a step width is defined for this property.

HOBJ	hObj (void) const
	Returns a unique identifier for the component referenced by this object.

bool	isConstDefined (TPropertyLimits constant) const
	Checks if a certain constant is defined for this property(deprecated).

bool	isDefault (void) const
	Checks if this component is currently referencing the default for this component.

bool	isList (void) const
	Checks if this component is of type mvIMPACT::acquire::ComponentList.

bool	isMeth (void) const
	Checks if this component is of type mvIMPACT::acquire::Method.

bool	isProp (void) const
	Checks if this component is of type mvIMPACT::acquire::Property or a derived type.

bool	isValid (void) const
	Checks if the internal component referenced by this object is still valid.

bool	isVisible (void) const
	Checks if the component is currently shadowed due to a settings made elsewhere or not.

bool	isWriteable (void) const
	Checks if the caller has write/modify access to the component.

Component	lastSibling (void) const
	Moves to the last sibling(the last feature in the current list of features).

unsigned int	maxValCount (void) const
	Returns maximum number of values that can be managed by this property.

std::string	name (void) const
	Returns the name of the component referenced by this object.

Component	nextSibling (void)
	Moves to the next sibling(the next feature in the current list of features).

	operator HOBJ () const
	Allows implicit conversion to a HOBJ.

Component	operator++ (int)
	Moves to the next sibling(the next feature in the current list of features).

Component &	operator++ (void)
	Moves to the next sibling(the next feature in the current list of features).

Component	parent (void) const
	Moves to the parent of this component(moves up one level).

	Property (const Property &src)
	Constructs a new mvIMPACT::acquire::Property from an existing one.

	Property (HOBJ hProp)
	Constructs a new mvIMPACT::acquire::Property object.

	Property (void)
	Constructs a new unbound mvIMPACT::acquire::Property object.

std::string	readS (int index=0, const std::string &format="") const
	Reads data from this property as a string.

std::string	readSArray (const std::string &format="", const std::string &delimiter="", int startIndex=0, int endIndex=INT_MAX, int mode=0) const
	Reads data from this property as a string.

const Property &	removeValue (int index=0) const
	Removes a certain value from the property's data.

TComponentRepresentation	representation (void) const
	Returns the recommended representation for this component.

std::string	representationAsString (void) const
	Returns the recommended representation of the referenced component as a string.

const Property &	resizeValArray (unsigned int newSize) const
	Resizes the property's data array.

const Component &	restoreDefault (void) const
	Restores the default for the referenced component.

Component	selectedFeature (unsigned int index) const
	Retrieves a component that is selected by the current one.

unsigned int	selectedFeatureCount (void) const
	Returns the number of features selected by the current one.

unsigned int	selectedFeatures (std::vector< Component > &v) const
	Retrieves the list of components that are selected by the current one.

Component	selectingFeature (unsigned int index) const
	Retrieves a component that is selecting the current one.

unsigned int	selectingFeatureCount (void) const
	Returns the number of features selecting the current one.

unsigned int	selectingFeatures (std::vector< Component > &v) const
	Retrieves the list of components that are selecting the current one.

std::string	stringFormatString (void) const
	Returns the internal format string this property uses to convert data to strings.

TComponentType	type (void) const
	Returns the type of the referenced component.

std::string	typeAsString (void) const
	Returns the type of the referenced component as a string.

unsigned int	valCount (void) const
	Returns the current number of values managed by this property.

TComponentVisibility	visibility (void) const
	Returns the recommended visibility for this component.

std::string	visibilityAsString (void) const
	Returns the recommended visibility of the referenced component as a string.

const Property &	writeS (const std::string &value, int index=0) const
	Assigns a new value to this property.

const Property &	writeS (const std::vector< std::string > &sequence, int index=0) const
	Assigns new values to this property.

Static Public Member Functions
static std::string	representationAsString (TComponentRepresentation representation)
	Returns the recommended representation converted to a string.

static TComponentType	type (HOBJ hObj)
	Returns the type of the component referenced by hObj.

static std::string	visibilityAsString (TComponentVisibility visibility)
	Returns the recommended visibility converted to a string.

Protected Types
enum	{ BUFFER_INCREMENT_FACTOR = 6 }
	An internal constant that defines by which factor dynamic buffers will grow when the current size is not sufficient. More...

Protected Member Functions
std::string	compGetStringParam (TOBJ_StringQuery query, int param1=0, int param2=0) const
	A helper function to query certain component related string parameters.

int	valuesToRead (int start, int end) const

Static Protected Member Functions
static char *	stringAllocator (const char *pBuf, size_t reqBufSize)
	An internal helper function for fast string allocation.

Protected Attributes
HOBJ	m_hObj
	A unique identifier for the internal driver object referenced by this instance of mvIMPACT::acquire::ComponentAccess.

Detailed Description

A base class for properties.

A property can be used to represent certain values like e.g. the input channel of a device. Depending on the way the property has been created it is either possible to read and write data to it or ( when the mvIMPACT::acquire::cfWriteAccess flag is NOT set ) just to read the data. In rare cases it might also be possible that the user is is not allowed to read the data of a property. To find out what you are allowed to do with a property or any other component the function mvIMPACT::acquire::Component::flags() can be called.

A property can contain either a single value or an array of values of the same type (e.g. 4 integer values could be used to represent a property call 'Rectangle'. It can even (if the mvIMPACT::acquire::cfFixedSize flag is not set) contain a different number of values all the time its data is queried. E.g. for a property 'searchresults' each time some function is called which writes its results to this property the property could contain a different number of integer values afterwards.

Every properties value can be read and written either as string or by it actual value type. So you can either assign the value of an integer property by using the standard 'write' function that accepts the value to be the type of the property or the function mvIMPACT::acquire::Property::writeS can be used to set the property via a string containing the new value.

PropertyI prop(hObj);
prop.writeS("5"); // string assignment
prop.write(5); // integer assignment

In addition to that float and int Properties might define a translation dictionary. This cannot be done by the user, but the user can work with the dictionary afterwards. A translation dictionary is a table which maps strings to certain values (e.g. integers).

The translation dictionary serves two purposes: Once it has been defined this property can only be assigned values ( which can either be passed as a string or as the actual value ) which are contained in the translation table. Thus this makes it very easy to restrict a certain property to a fixed number of values, which can be assigned to it. Properties that have a translation dictionary will typically be defined by declaring a template instance with the type of the enumeration.

The second benefit of a translation dictionary is that certain values can be assigned a meaningful description via its translation. When a translation table has been defined either the string translation can be used to assign its value or its actual data type. A float property e.g. might define a translation table like this: 'Auto -> 0', 'auto -> 1', 'OnLowLevel -> 2'. Now to set this property to use the 'on low level' trigger mode this can be done by calling one of the 'write' functions.

PropertyICameraTriggerMode prop = getPropertyFromSomewhere();
prop.writeS("OnLowLevel"); // set value via the translation string
prop.write(ctmOnLowLevel); // set value via enum type

This can also be extremely useful to populate combo boxes for GUI applications.

Float and int properties can also define certain constants like a max. value or a min. value. If a property does define such values it can't be assigned values which do not lie within the defined range. To find out if constants are defined The user can call the functions mvIMPACT::acquire::Property::hasMaxValue, mvIMPACT::acquire::Property::hasMinValue and mvIMPACT::acquire::Property::hasStepWidth. To query to actual value of the max, min or step width the functions getMaxValue, getMinValue and getStepWidth of the classes mvIMPACT::acquire::EnumPropertyF, mvIMPACT::acquire::EnumPropertyI and mvIMPACT::acquire::EnumPropertyI64 can be called.

When reading the value of a property as a string the user can define a format string telling the property module how to format the returned string. This works pretty much like when working e.g. with the printf function.

Examples: GenICamCallbackOnEvent.cpp, GenericInterfaceLayout.cpp, GenericInterfaceLayout.legacy.cpp, Properties.cpp, Properties.legacy.cpp, and exampleHelper.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

protectedinherited

An internal constant that defines by which factor dynamic buffers will grow when the current size is not sufficient.

Enumerator
BUFFER_INCREMENT_FACTOR

Constructor & Destructor Documentation

◆ Property() [1/3]

Property ( void )

inlineexplicit

Constructs a new unbound mvIMPACT::acquire::Property object.

Properties constructed this way can't be used for anything unless they are bound to a internal driver property with a mvIMPACT::acquire::ComponentLocator object.

◆ Property() [2/3]

Property ( HOBJ hProp )

inlineexplicit

Constructs a new mvIMPACT::acquire::Property object.

Properties successfully constructed this way can be worked with directly. If hObj does not reference an internal driver property a mvIMPACT::acquire::ENotAProperty exception will be thrown.

Parameters

[in] hProp A valid handle to a property

◆ Property() [3/3]

Property ( const Property & src )

inline

Constructs a new mvIMPACT::acquire::Property from an existing one.

Parameters

[in] src A constant reference to the mvIMPACT::acquire::Property object, this object shall be created from

Member Function Documentation

◆ allowsValueCombinations()

bool allowsValueCombinations ( void ) const

inline

Checks if this enumerated property allows the combination of enum values.

If this function returns true, the enum constants can be 'ored' together. This works for the enum constants as well as for the string representations returned in the properties translation dictionary.

if a property e.g. defines a dictionary (('1', "one"), ('2', "two")) the following write operations will be valid:

prop = getPropFromSomewhere()
prop.write( 1 | 2 )
prop.write( "one | two" )

If this function returns true code like this will be valid:

enum TEnum
{
  eA,
  eB
};
 
typedef EnumPropertyI<TEnum> PropertyIEnum;
PropertyIEnum p = getPropFromSomewhere();
p.write( TEnum(eA | eB) );

Returns

true if this property allows the combination of enum values.
false otherwise.

◆ changedCounter()

unsigned int changedCounter ( void ) const

inlineinherited

Returns the current changed counter for the component referenced by this object.

This changed counter is incremented internally each time the component is modified. To check if this component has been modified since the last time, this check has been performed, keep track of the last return value of this function and compare it with the new value. This can be helpful e.g. to keep a GUI up to date. The value returned by this function will always be larger than or equal to the value returned by mvIMPACT::acquire::ComponentAccess::changedCounterAttr (except in case of a wrap around) when called at the same time for the same object as it's always incremented when the component has been modified in any way while the latter one will only be incremented if the attributes (e.g. the flags) but NOT if e.g. the value(s) of a property has been modified.

//-----------------------------------------------------------------------------
struct ComponentRef
//-----------------------------------------------------------------------------
{
  mvIMPACT::acquire::Component c_;
  unsigned int lastChangedCount_;
  ComponentRef( mvIMPACT::acquire::Component c ) : c_( c ), lastChangedCount_( 0 ) {}
};
 
//-----------------------------------------------------------------------------
void fn( ComponentRef& cr )
//-----------------------------------------------------------------------------
{
  if( cr.c_.isValid() )
  {
    const unsigned int currentChangedCount = cr.c_.changedCounter();
    if( currentChangedCount != cr.lastChangedCount_ )
    {
      // something has happened since the last check!
      doWhatNeedsToBeDone();
      // and remember the current changed counter
      cr.lastChangedCount_ = currentChangedCount;
    }
  }
}

Returns: The current changed counter of this object.

◆ changedCounterAttr()

unsigned int changedCounterAttr ( void ) const

inlineinherited

Returns the current attribute changed counter for the component referenced by this object.

This changed counter is incremented internally each time the components attributes have been modified. To check if this components attributes have been modified since the last time, this check has been performed, keep track of the last return value of this function and compare it with the new value. This can be helpful e.g. to keep a GUI up to date.

Note: Attributes changes are e.g. a modification to a property's translation dictionary, but NOT a property's value. Because of this the value returned by this function will always be less or equal than the value returned by the function mvIMPACT::acquire::ComponentAccess::changedCounter (except in case of a wrap around) when called at the same time for the same object.

See also: mvIMPACT::acquire::ComponentAccess::changedCounter

Returns: The current attributes changed counter of this object.

◆ compGetStringParam()

std::string compGetStringParam	(	TOBJ_StringQuery	query,
		int	param1 = 0,
		int	param2 = 0 ) const

inlineprotectedinherited

A helper function to query certain component related string parameters.

This function might throw an exception, if an invalid parameter has been queried.

Returns: A string containing the data to be queried.

Parameters

	query	The type of the parameter to read
[in]	param1	An additional parameter
[in]	param2	An additional parameter

◆ dictSize()

unsigned int dictSize ( void ) const

inline

Returns the size of the properties translation dictionary.

If the property does define a translation dictionary this function returns the number of elements contained in this dictionary.

Returns

The size of the properties translation dictionary.
0 If this property does not define a translation dictionary.

◆ displayName()

std::string displayName ( void ) const

inlineinherited

Returns the display name of the component referenced by this object.

Since: 1.11.20

Returns: The display name of the component referenced by this object. This might be an empty string if no display name has been specified.

Examples: GenICamSequencerParameterChangeAtRuntime.cpp, GenICamSequencerUsage.cpp, GenICamSequencerUsage.legacy.cpp, GenICamSequencerUsageWithPaths.cpp, GenICamSequencerUsageWithPaths.legacy.cpp, and exampleHelper.h.

◆ docString()

std::string docString ( void ) const

inlineinherited

Returns a string containing general information about the component referenced by this object.

Returns: A string containing general information about the component referenced by this object.

Examples: exampleHelper.h.

◆ firstChild()

Component firstChild ( void ) const

inlineinherited

Moves to the first child of this component(moves down one level).

Calling this function will only succeed, if the current mvIMPACT::acquire::Component references a list.

Returns: A new mvIMPACT::acquire::Component object

Examples: GenericInterfaceLayout.cpp, GenericInterfaceLayout.legacy.cpp, Properties.cpp, and Properties.legacy.cpp.

◆ firstSibling()

Component firstSibling ( void ) const

inlineinherited

Moves to the first sibling(the first feature in the current list of features).

Returns: A new mvIMPACT::acquire::Component object

◆ flags()

TComponentFlag flags ( void ) const

inlineinherited

Returns the flags associated with this component.

Returns: The flags associated with this component.

◆ flagsAsString()

std::string flagsAsString ( const std::string & separator = " | " ) const

inlineinherited

Returns the flags associated with this component as a string.

Returns: The flags associated with this component as a string.

Parameters

[in] separator A user definable string to separate the individual flags. The default value is ' | ' resulting in the string to look e.g. like this: 'cfWriteAccess | cfReadAccess'

Examples: exampleHelper.h.

◆ hasDict()

bool hasDict ( void ) const

inline

Returns whether this property defines a translation dictionary or not.

Returns

true if this property defines a translation table
false otherwise

Examples: exampleHelper.h.

◆ hasMaxValue()

bool hasMaxValue ( void ) const

inline

Checks if a maximum value is defined for this property.

Since: 1.12.63

Returns

true if this property defines a maximum value
false otherwise

Examples: ContinuousCapture.linux.cpp, and exampleHelper.h.

◆ hasMinValue()

bool hasMinValue ( void ) const

inline

Checks if a minimum value is defined for this property.

Since: 1.12.63

Returns

true if this property defines a minimum value
false otherwise

Examples: exampleHelper.h.

◆ hasStepWidth()

bool hasStepWidth ( void ) const

inline

Checks if a step width is defined for this property.

Since: 1.12.63

Returns

true if this property defines a step width
false otherwise

Examples: exampleHelper.h.

◆ hObj()

HOBJ hObj ( void ) const

inlineinherited

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

Returns: A unique identifier for the component referenced by this object.

◆ isConstDefined()

bool isConstDefined ( TPropertyLimits constant ) const

Checks if a certain constant is defined for this property(deprecated).

Deprecated: This function has been declared deprecated and will be removed in future versions of this interface. Use mvIMPACT::acquire::Property::hasMaxValue(), mvIMPACT::acquire::Property::hasMinValue() and mvIMPACT::acquire::Property::hasStepWidth() instead and see the corresponding 'Porting existing code' section in the documentation.

Valid values for constant are defined by the enum mvIMPACT::acquire::TPropertyLimits.

Parameters

constant [in] The constant whose existence is in question

Returns

true if this property defines this constant
false otherwise

◆ isDefault()

bool isDefault ( void ) const

inlineinherited

Checks if this component is currently referencing the default for this component.

This function will return true only for derived components that have not been modified.

Returns

true if the component is currently set to its default value
false otherwise.

◆ isList()

bool isList ( void ) const

inlineinherited

Checks if this component is of type mvIMPACT::acquire::ComponentList.

Returns

true if the component references a list
false otherwise

Examples: GenericInterfaceLayout.cpp, GenericInterfaceLayout.legacy.cpp, Properties.cpp, and Properties.legacy.cpp.

◆ isMeth()

bool isMeth ( void ) const

inlineinherited

Checks if this component is of type mvIMPACT::acquire::Method.

Returns

true if the component references a method
false otherwise

◆ isProp()

bool isProp ( void ) const

inlineinherited

Checks if this component is of type mvIMPACT::acquire::Property or a derived type.

Returns

true if the component references a property
false otherwise

Examples: GenICamCallbackOnEvent.cpp, GenericInterfaceLayout.cpp, GenericInterfaceLayout.legacy.cpp, Properties.cpp, and Properties.legacy.cpp.

◆ isValid()

bool isValid ( void ) const

inlineinherited

Checks if the internal component referenced by this object is still valid.

This function can be used to verify whether a referenced component is still valid or not. When e.g. referencing a driver property after mvIMPACT::acquire::Device::close has been called this function would return false. Calling any other function that tries to access the referenced component in that case would raise an exception.

Returns

true if this object currently references a valid component
false otherwise.

◆ isVisible()

bool isVisible ( void ) const

inlineinherited

Checks if the component is currently shadowed due to a settings made elsewhere or not.

Settings applied to certain components might affect the behaviour of others. For example an activated automatic gain control might shadow the value written to the gain property by the user as the gain is calculated internally. In order to check if modifying the actual component will affect the behaviour of the system this function may be used. When it returns true, the mvIMPACT::acquire::Component will have an impact on the system, if false is returned, the feature might be modified, but this will currently NOT influence the acquisition process or the overall behaviour of the device or driver.

This is what is called visibility. The user still might modify or read the current mvIMPACT::acquire::Component when it's not visible however the actual data will be used only if the Component is visible (mvIMPACT::acquire::cfInvisible must NOT be set).

The visibility of a mvIMPACT::acquire::Component object will change only if other mvIMPACT::acquire::Component objects are modified and NEVER when a program runs but does not change any mvIMPACT::acquire::Component.

◆ isWriteable()

bool isWriteable ( void ) const

inlineinherited

Checks if the caller has write/modify access to the component.

Returns

true if the caller is allowed to call write/modify operation for this component.
false otherwise.

Examples: exampleHelper.h.

◆ lastSibling()

Component lastSibling ( void ) const

inlineinherited

Moves to the last sibling(the last feature in the current list of features).

Since: 1.10.64

Returns: A new mvIMPACT::acquire::Component object

◆ maxValCount()

unsigned int maxValCount ( void ) const

inline

Returns maximum number of values that can be managed by this property.

For the majority of properties this function will return '1', but as properties might manage more than a single value, this value might be interesting from time to time.

Returns: the maximum number of values that can be managed by this property.

◆ name()

std::string name ( void ) const

inlineinherited

Returns the name of the component referenced by this object.

Returns: The name of the component referenced by this object.

◆ nextSibling()

Component nextSibling ( void )

inlineinherited

Moves to the next sibling(the next feature in the current list of features).

Returns: A new mvIMPACT::acquire::Component object

◆ operator HOBJ()

operator HOBJ ( ) const

inlineinherited

Allows implicit conversion to a HOBJ.

◆ operator++() [1/2]

Component operator++ ( int )

inlineinherited

Moves to the next sibling(the next feature in the current list of features).

Returns: A new mvIMPACT::acquire::Component object

◆ operator++() [2/2]

Component & operator++ ( void )

inlineinherited

Moves to the next sibling(the next feature in the current list of features).

Returns: A self reference

◆ parent()

Component parent ( void ) const

inlineinherited

Moves to the parent of this component(moves up one level).

Returns: A new mvIMPACT::acquire::Component object

◆ readS()

std::string readS	(	int	index = 0,
		const std::string &	format = "" ) const

inline

Reads data from this property as a string.

Note: If the caller does not have the needed rights this function might throw an exception of the type mvIMPACT::acquire::ImpactAcquireException.

Returns: A string containing the data questioned.

Parameters

[in]	index	The index of the desired value(only necessary for properties containing more than one value)
[in]	format	The format string telling the function how to format the result. If left empty the property uses its standard way of converting its data into a string

Examples: CaptureToMegaBuffer.cpp, CaptureToOpenGLMemory.cpp, CaptureToUserMemory.cpp, CaptureToUserMemory.legacy.cpp, ContinuousCapture.cpp, ContinuousCapture.linux.cpp, ContinuousCapture.win32.cpp, ContinuousCaptureAllDevices.cpp, ContinuousCaptureAllDevices.linux.cpp, ContinuousCaptureAllDevices.win32.cpp, ContinuousCaptureAllFormats.cpp, ContinuousCaptureAllFormats.win32.cpp, ContinuousCaptureFFmpeg.cpp, ContinuousCaptureGenDC.cpp, ContinuousCaptureMultiPart.cpp, ContinuousCaptureMultiPart.legacy.cpp, ContinuousCaptureOnlyProcessLatest.cpp, ContinuousCaptureOnlyProcessLatest.legacy.cpp, ContinuousCaptureToAVIFile.cpp, ContinuousCapture_BVS-3D-RV0.cpp, ContinuousCapture_BVS-3D-RV1.cpp, FirmwareUpdate.cpp, GenICamCallbackOnEvent.cpp, GenICamCommonSettingsUsage.cpp, GenICamCommonSettingsUsage.legacy.cpp, GenICamInterfaceLayout.cpp, GenICamInterfaceLayout.legacy.cpp, GenICamSequencerUsage.cpp, GenICamSequencerUsage.legacy.cpp, GenICamSequencerUsageWithPaths.cpp, GenICamSequencerUsageWithPaths.legacy.cpp, GenICamSmartFrameRecallUsage.cpp, GenICamSmartFrameRecallUsage.legacy.cpp, GenericInterfaceLayout.cpp, GenericInterfaceLayout.legacy.cpp, GigEVisionActionFeatures.cpp, Properties.cpp, Properties.legacy.cpp, SequenceCapture.cpp, SequenceCapture.win32.cpp, SingleCapture.cpp, SingleCaptureMasterSlave.cpp, SingleCaptureMasterSlave.legacy.cpp, SingleCaptureStorage.cpp, TimestampFeatures.cpp, and exampleHelper.h.

◆ readSArray()

std::string readSArray	(	const std::string &	format = "",
		const std::string &	delimiter = "",
		int	startIndex = 0,
		int	endIndex = INT_MAX,
		int	mode = 0 ) const

inline

Reads data from this property as a string.

This function can be used to query a set of values if this property stores more than a single value which might be useful for GUI applications.

PropertyI p = getPropFromSomewhere();
p.write( 1 );
p.write( 2, 1 );
p.write( 666, 2 );
std::string s = p.readSArray( "%d", "&&:", 1 );
// now s should contain '2&&:666'
s = p.readSArray( "%4d", " ", 0, 1 );
// now s should contain '   1,   2'

Note: If the caller does not have the needed rights this function might throw an exception of the type mvIMPACT::acquire::ImpactAcquireException.

Returns: A string containing the data questioned.

Parameters

[in]	format	The format string telling the function how to format the result. If left empty the property uses its standard way of converting its data into a string
[in]	delimiter	This string is used to separate the individual values from one another. If left empty, a single blank will separate the data.
[in]	startIndex	The index of the first of the desired values
[in]	endIndex	The index of the last of the desired values. If INT_MAX is passed, every from startIndex to the last value stored by the property will be returned.
[in]	mode	Specifies the mode this function operates in. Currently only the LSB affects the behaviour of this function. When the LSB is set, the translation dictionary (if defined) will be ignored for this call.

◆ removeValue()

const Property & removeValue ( int index = 0 ) const

inline

Removes a certain value from the property's data.

Returns: A const reference to the calling property.

Parameters

[in] index The index of the value to be removed

◆ representation()

TComponentRepresentation representation ( void ) const

inlineinherited

Returns the recommended representation for this component.

The representation can be used e.g. to develop a GUI that creates convenient controls for certain features.

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

Since: 2.14.0

Returns: The recommended representation for this component.

◆ representationAsString() [1/2]

static std::string representationAsString ( TComponentRepresentation representation )

inlinestaticinherited

Returns the recommended representation converted to a string.

Since: 2.14.0

Returns: The recommended representation converted to a string.

Parameters

[in] representation The representation to query the string representation for

◆ representationAsString() [2/2]

std::string representationAsString ( void ) const

inlineinherited

Returns the recommended representation of the referenced component as a string.

Since: 2.14.0

Returns: The recommended representation of the referenced component as a string.

◆ resizeValArray()

const Property & resizeValArray ( unsigned int newSize ) const

inline

Resizes the property's data array.

This function resizes the internal data array of this property. The size of this array represents the number of values, which can be stored within the property. This function will only succeed, if the mvIMPACT::acquire::cfFixedSize is NOT set for this property and the user has "write rights" for this property. Otherwise an exception will be thrown. Whenever the user successfully writes an array of values to a property and this array contains more elements than the current internal data array can accommodate at the desired offset the internal data array will be increased automatically.

Note: If the caller does not have the needed rights this function might throw an exception of the type mvIMPACT::acquire::ImpactAcquireException.; In order to be allowed to modify the number of values a property can store, the mvIMPACT::acquire::cfFixedSize flag must NOT be set.

See also: mvIMPACT::acquire::Component::isWriteable

Returns: A const reference to the calling property.

Parameters

[in] newSize The new number of values this property shall be allowed to store

◆ restoreDefault()

const Component & restoreDefault ( void ) const

inlineinherited

Restores the default for the referenced component.

Calling this function will restore the default value for the component referenced by this object.

If this function is called for an object of type mvIMPACT::acquire::ComponentList every component in that list is restored to the default value.

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

Returns: A const reference to the component.

◆ selectedFeature()

Component selectedFeature ( unsigned int index ) const

inlineinherited

Retrieves a component that is selected by the current one.

This function retrieves a component that is selected by the current one. This information is mainly useful for GUI applications that want to arrange features in a way that dependencies between features can easily been spotted.

When a component 'selects' other components, this indicates that selected components may change whenever the selecting component changes. An example for a selector might be a property defining the index within a LUT while the value of a particular LUT entry could be a selected feature. Assuming 2 properties LUTIndex and LUTValue then changing LUTIndex will invalidate and possibly change LUTValue.

C++ offers the more efficient function mvIMPACT::acquire::Component::selectedFeatures to obtain this information.

To find out how many mvIMPACT::acquire::Component objects are selected by the current one call mvIMPACT::acquire::Component::selectedFeatureCount. This value minus 1 will also be the max. value for index.

See also: mvIMPACT::acquire::Component::selectedFeatureCount,
mvIMPACT::acquire::Component::selectedFeatures

Since: 1.11.20

Returns: A mvIMPACT::acquire::Component that is selected by the current one.

Parameters

[in] index The index for the component to query.

◆ selectedFeatureCount()

unsigned int selectedFeatureCount ( void ) const

inlineinherited

Returns the number of features selected by the current one.

See also: mvIMPACT::acquire::Component::selectedFeatures,
mvIMPACT::acquire::Component::selectedFeature

Since: 1.11.20

Returns: The number of features selected by the current one.

Examples: exampleHelper.h.

◆ selectedFeatures()

unsigned int selectedFeatures ( std::vector< Component > & v ) const

inlineinherited

Retrieves the list of components that are selected by the current one.

This function retrieves the list of components that are selected by the current one. This information is mainly useful for GUI applications that want to arrange features in a way that dependencies between features can easily been spotted.

When a component 'selects' other components, this indicates that selected components may change whenever the selecting component changes. An example for a selector might be a property defining the index within a LUT while the value of a particular LUT entry could be a selected feature. Assuming 2 properties LUTIndex and LUTValue then changing LUTIndex will invalidate and possibly change LUTValue.

See also: mvIMPACT::acquire::Component::selectedFeatureCount,
mvIMPACT::acquire::Component::selectedFeature

Since: 1.11.20

Returns: The number of features selected by the current one.

Parameters

[out] v An array that will retrieve the list of components that are selected by the current one.

Examples: exampleHelper.h.

◆ selectingFeature()

Component selectingFeature ( unsigned int index ) const

inlineinherited

Retrieves a component that is selecting the current one.

This function retrieves a component that is selecting the current one. This information is mainly useful for GUI applications that want to arrange features in a way that dependencies between features can easily been spotted.

When a component 'selects' other components, this indicates that selected components may change whenever the selecting component changes. An example for a selector might be a property defining the index within a LUT while the value of a particular LUT entry could be a selected feature. Assuming 2 properties LUTIndex and LUTValue then changing LUTIndex will invalidate and possibly change LUTValue.

C++ offers the more efficient function mvIMPACT::acquire::Component::selectingFeatures to obtain this information.

To find out how many mvIMPACT::acquire::Component objects are selecting the current one call mvIMPACT::acquire::Component::selectingFeatureCount. This value minus 1 will also be the max. value for index.

See also: mvIMPACT::acquire::Component::selectingFeatureCount,
mvIMPACT::acquire::Component::selectingFeatures

Since: 1.11.20

Returns: A mvIMPACT::acquire::Component that is selecting the current one.

Parameters

[in] index The index for the component to query.

◆ selectingFeatureCount()

unsigned int selectingFeatureCount ( void ) const

inlineinherited

Returns the number of features selecting the current one.

See also: mvIMPACT::acquire::Component::selectingFeatures,
mvIMPACT::acquire::Component::selectingFeature

Since: 1.11.20

Returns: The number of features selecting the current one.

Examples: exampleHelper.h.

◆ selectingFeatures()

unsigned int selectingFeatures ( std::vector< Component > & v ) const

inlineinherited

Retrieves the list of components that are selecting the current one.

This function retrieves the list of components that are selecting the current one. This information is mainly useful for GUI applications that want to arrange features in a way that dependencies between features can easily been spotted.

When a component 'selects' other components, this indicates that selected components may change whenever the selecting component changes. An example for a selector might be a property defining the index within a LUT while the value of a particular LUT entry could be a selected feature. Assuming 2 properties LUTIndex and LUTValue then changing LUTIndex will invalidate and possibly change LUTValue.

See also: mvIMPACT::acquire::Component::selectingFeatureCount,
mvIMPACT::acquire::Component::selectingFeature

Since: 1.11.20

Returns: The number of features selecting the current one.

Parameters

[out] v An array that will retrieve the list of components that are selecting the current one.

Examples: exampleHelper.h.

◆ stringAllocator()

static char * stringAllocator	(	const char *	pBuf,
		size_t	reqBufSize )

inlinestaticprotectedinherited

An internal helper function for fast string allocation.

◆ stringFormatString()

std::string stringFormatString ( void ) const

inline

Returns the internal format string this property uses to convert data to strings.

Returns: A string containing the format string internally used by the property whenever the user reads a value as a string without specifying a format string and the property is not a string type one.

◆ type() [1/2]

static TComponentType type ( HOBJ hObj )

inlinestaticinherited

Returns the type of the component referenced by hObj.

Returns: The type of the component referenced by hObj.

Parameters

[in] hObj The component the type shall be retrieved for

◆ type() [2/2]

TComponentType type ( void ) const

inlineinherited

Returns the type of the referenced component.

Returns: The type of the referenced component.

Examples: exampleHelper.h.

◆ typeAsString()

std::string typeAsString ( void ) const

inlineinherited

Returns the type of the referenced component as a string.

Returns: The type of the referenced component as a string.

Examples: exampleHelper.h.

◆ valCount()

unsigned int valCount ( void ) const

inline

Returns the current number of values managed by this property.

For the majority of properties this function will return '1', but as properties might manage more than a single value, this value might be interesting from time to time.

Returns: the current number of values managed by this property.

Examples: exampleHelper.h.

◆ valuesToRead()

int valuesToRead	(	int	start,
		int	end ) const

inlineprotected

◆ visibility()

TComponentVisibility visibility ( void ) const

inlineinherited

Returns the recommended visibility for this component.

The visibility can be used e.g. to develop a GUI that displays a crucial subset of features only.

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

Returns: The recommended visibility for this component.

◆ visibilityAsString() [1/2]

static std::string visibilityAsString ( TComponentVisibility visibility )

inlinestaticinherited

Returns the recommended visibility converted to a string.

Returns: The recommended visibility converted to a string.

Parameters

[in] visibility The visibility to query the string representation for

◆ visibilityAsString() [2/2]

std::string visibilityAsString ( void ) const

inlineinherited

Returns the recommended visibility of the referenced component as a string.

Returns: The recommended visibility of the referenced component as a string.

◆ writeS() [1/2]

const Property & writeS	(	const std::string &	value,
		int	index = 0 ) const

inline

Assigns a new value to this property.

The user caller have "write rights" for this property in order to be able to modify its value. Also if index is greater than the current internal data array size of this property the user must be allowed to change to size of the properties internal data array (the mvIMPACT::acquire::cfFixedSize flag must NOT be set).

Note: If the caller does not have the needed rights this function might throw an exception of the type mvIMPACT::acquire::ImpactAcquireException.

See also: mvIMPACT::acquire::Component::isWriteable,
mvIMPACT::acquire::Component::flags,
mvIMPACT::acquire::Property::writeS

Returns: A const reference to the calling property.

Parameters

[in]	value	The new value for this property at the given index.
[in]	index	The index of the value to modify

Examples: GenICamCallbackOnEvent.cpp, and exampleHelper.h.

◆ writeS() [2/2]

const Property & writeS	(	const std::vector< std::string > &	sequence,
		int	index = 0 ) const

inline

Assigns new values to this property.

The user must have "write rights" for this property in order to be able to modify its values. Also if index is greater than the current internal data array size of this property the user must be allowed to change to size of the properties internal data array (the mvIMPACT::acquire::cfFixedSize flag must NOT be set). This function behaves exactly like mvIMPACT::acquire::Property::writeS except that is can be used to assign more than one value at the same time. The parameter index here serves as an offset. If for example a property holds 3 values 'one', 'two' and 'three' before this call and the function is then called with an array containing the string 'orange' and 'blue' and index = 2 then after a successful call to this function the property will hold the data 'one', 'two', 'orange' and 'blue'.

Note: If the caller does not have the needed rights this function might throw an exception of the type mvIMPACT::acquire::ImpactAcquireException.

See also: mvIMPACT::acquire::Component::isWriteable,
mvIMPACT::acquire::Component::flags,
mvIMPACT::acquire::Property::writeS

Returns: A const reference to the calling property.

Parameters

[in]	sequence	A constant reference to an array containing the strings to be assigned to the property
[in]	index	The offset from where to start to assign the values

Member Data Documentation

◆ m_hObj

HOBJ m_hObj

protectedinherited

A unique identifier for the internal driver object referenced by this instance of mvIMPACT::acquire::ComponentAccess.

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ Property() [1/3]

◆ Property() [2/3]

◆ Property() [3/3]

Member Function Documentation

◆ allowsValueCombinations()

◆ changedCounter()

◆ changedCounterAttr()

◆ compGetStringParam()

◆ dictSize()

◆ displayName()

◆ docString()

◆ firstChild()

◆ firstSibling()

◆ flags()

◆ flagsAsString()

◆ hasDict()

◆ hasMaxValue()

◆ hasMinValue()

◆ hasStepWidth()

◆ hObj()

◆ isConstDefined()

◆ isDefault()

◆ isList()

◆ isMeth()

◆ isProp()

◆ isValid()

◆ isVisible()

◆ isWriteable()

◆ lastSibling()

◆ maxValCount()

◆ name()

◆ nextSibling()

◆ operator HOBJ()

◆ operator++() [1/2]

◆ operator++() [2/2]

◆ parent()

◆ readS()

◆ readSArray()

◆ removeValue()

◆ representation()

◆ representationAsString() [1/2]

◆ representationAsString() [2/2]

◆ resizeValArray()

◆ restoreDefault()

◆ selectedFeature()

◆ selectedFeatureCount()

◆ selectedFeatures()

◆ selectingFeature()

◆ selectingFeatureCount()

◆ selectingFeatures()

◆ stringAllocator()

◆ stringFormatString()

◆ type() [1/2]

◆ type() [2/2]

◆ typeAsString()

◆ valCount()

◆ valuesToRead()

◆ visibility()

◆ visibilityAsString() [1/2]

◆ visibilityAsString() [2/2]

◆ writeS() [1/2]

◆ writeS() [2/2]

Member Data Documentation

◆ m_hObj