INodeMapHandle/INodeMapHandle2 Interface

<< Click to Display Table of Contents >>

Navigation:  Image Manager > CVB Technology > Acquisition device drivers and CVB Programming Interfaces >

INodeMapHandle/INodeMapHandle2 Interface

 

INodeMapHandle Interface : access to the Nodemap

 

This interface is used to obtain access to the Device NodeMap.

INodeMapHandle interface is part of the CVB Driver Library and provides functions to set and retrieve values from the NodeMap for the current device (e.g. a GigE Vision camera).

 

Sample Code in C++

// Check if INodemap interface is available

if (CanNodeMapHandle((IMG)m_cvImg.GetImage()))

{

  NODEMAP nodeMap = nullptr;

  // Get NodeMap from Camera

  cvbres_t result = NMHGetNodeMap(reinterpret_cast<IMG>(m_cvImg.GetImage()), nodeMap);

  if (result >= 0)

  {

    NODE exposureTimeNode = nullptr;

    result = NMGetNode(nodeMap, "ExposureTime", exposureTimeNode);

    if (result >= 0)

    {

      // Set the Exposuretime to 20ms

      result = NSetAsFloat(exposureTimeNode, 20000);

 

      ReleaseObject(exposureTimeNode);

    }

 

    ReleaseObject(nodeMap);

  }

 

  // TODO result < 0 => error

}

 

 

For testing purposes, please use the CVB GenICam Tutorial : VCSimpleDemo or CSGenICamExample (%CVB%Tutorial\Hardware\GenICam).

DeviceNodeMap

 

INodeMapHandle2 Interface description : access to different Nodemaps

 

A GenICam transport layer (GenTL) exports a number of separate NodeMaps to access logical parts of the driver.

Beside the well known Device Nodemap a GenTL Producer provides a NodeMap to configure the DataStream and to get statistical data.

Other technologies might as well have multiple NodeMaps.

INodemapHandle2 interface is part of the CVB Driver Library and allows to enumerate the various NodeMpas and to get access.

 

NodeMap access can be used inside GenICam browser:

 

NodeMaps