Skip to content

Pylon::CPixelTypeMapper#

A simple pixeltypemapper (maps device specific pixelformats read from device-node map to pylon pixeltypes by their name). More…

#include <pylon/PixelTypeMapper.h>

Inherited by Pylon::CCameraPixelTypeMapperT< EnumT >

Public Functions#

Name
CPixelTypeMapper(void )
CPixelTypeMapper(GenApi::IEnumeration * pEnum)
create and initialize a mapper by using the enum node passed.
virtual ~CPixelTypeMapper(void )
default d'tor
bool IsValid() const
Checks the objects validity.
void SetPixelFormatEnumNode(GenApi::IEnumeration * pEnum)
Lazy initialization of the object.
EPixelType GetPylonPixelTypeFromNodeValue(int64_t nodeValue) const
Converts an enumeration node value to a Pylon::EPixelType enum.
EPixelType GetPylonPixelTypeByName(const char * pszSymbolicName)
Returns a Pylon::EPixelType for a given symbolic name.
EPixelType GetPylonPixelTypeByName(const String_t & symbolicName)
Returns a Pylon::EPixelType for a given symbolic name.
const char * GetNameByPixelType(EPixelType pixelType, SFNCVersion sfncVer =SFNCVersion_pre2_0)
Static function that returns a string representation of the given EPixelType.

Detailed Description#

class Pylon::CPixelTypeMapper;

A simple pixeltypemapper (maps device specific pixelformats read from device-node map to pylon pixeltypes by their name).

Use this mapper to convert a device specifc Pylon::PixelFormat value to a Pylon::EPixelType used for PixelFormatConverters. When passing the symbolic name of the pixeltype you can use the static function CPixelTypeMapper::GetPylonPixelTypeByName(). If you want to convert a nodeValue you must first create a CPixelTypeMapper instance and pass the constructor a pointer the PixelFormat node of the device you want the node value to be converted. Then call CPixelTypeMapper::GetPylonPixelTypeFromNodeValue() to get the corresponding Pylon::EPixelType.

Public Functions Documentation#

CPixelTypeMapper#

CPixelTypeMapper(
    void 
)

Create an empty mapper. Before calling any non-static function you must call SetPixelFormatEnumNode to initialize the mapper.

CPixelTypeMapper#

explicit CPixelTypeMapper(
    GenApi::IEnumeration * pEnum
)

create and initialize a mapper by using the enum node passed.

~CPixelTypeMapper#

virtual ~CPixelTypeMapper(
    void 
)

default d'tor

IsValid#

bool IsValid() const

Checks the objects validity.

Return: Returns true if the object is initialized properly.

Essentially this function checks whether you've called SetPixelFormatEnumNode.

SetPixelFormatEnumNode#

void SetPixelFormatEnumNode(
    GenApi::IEnumeration * pEnum
)

Lazy initialization of the object.

Parameters:

  • pEnum Pointer to the enumeration node containing the PixelFormats.

Call this function initialize the mapper when using the default c'tor.

GetPylonPixelTypeFromNodeValue#

EPixelType GetPylonPixelTypeFromNodeValue(
    int64_t nodeValue
) const

Converts an enumeration node value to a Pylon::EPixelType enum.

Parameters:

Return: Returns the Pylon::EPixelType for a given pixelformat enum value defined in the Enum passed in c'tor

Converts a enumeration node value to a Pylon::EPixelType enum. You must have initialized the mapper before you can call this function.

GetPylonPixelTypeByName#

static EPixelType GetPylonPixelTypeByName(
    const char * pszSymbolicName
)

Returns a Pylon::EPixelType for a given symbolic name.

Parameters:

  • pszSymbolicName pointer to the symbolic name. Note: Symbolic names are case sensitive. You can obtain the symbolic name by calling GenApi::IEnumEntry::GetSymbolic()

Return: Returns the Pylon_PixelType for a given symbolic name.

Static version which does the lookup soley by symbolic string comparison. Passing "Mono16" will return Pylon::PixelType_Mono16. If the name is not found Pylon::PixelType_Undefined will be returned.

GetPylonPixelTypeByName#

static inline EPixelType GetPylonPixelTypeByName(
    const String_t & symbolicName
)

Returns a Pylon::EPixelType for a given symbolic name.

Parameters:

Return: Returns the Pylon_PixelType for a given symbolic name.

Static version which does the lookup solely by symbolic string comparison. Passing "Mono16" will return Pylon::PixelType_Mono16. If the name is not found Pylon::PixelType_Undefined will be returned.

GetNameByPixelType#

static const char * GetNameByPixelType(
    EPixelType pixelType,
    SFNCVersion sfncVer =SFNCVersion_pre2_0
)

Static function that returns a string representation of the given EPixelType.

Parameters:

  • pixelType The pixel type to return the name for.
  • sfncVer SFNC Version to use when doing the mapping. Some names have been changed in SFNC 2.0

Return: Returns the pointer to a null terminated string representing the symbolic name of the pixel type.

Note: The returned name cannot be used to parameterize the pixel format of a camera device, because the camera's pixel format name can be different. The camera's pixel format name depends on the used standard feature naming convention (SFNC).

Passing Pylon::PixelType_Mono16 will return "Mono16" will be returned. If the pixel type is not known an empty string is returned.


Updated on 5 July 2022 at 15:30:00