Easy3DObject - Extracting 3D Objects¶

Easy3DObject extracts objects and their features from a ZMap.

The E3DObjectExtractor ^.NET ^Python class uses a set of criteria to select the objects to extract.
The extracted objects are instances of the E3DObject ^.NET ^Python class.

../../../_images/setting_objects_02.webp — Representation of 3D objects.¶

The basic workflow is as follows:

Load or build a ZMap (from an image or a point cloud).
Construct an E3DObjectExtractor ^.NET ^Python instance.
Set the selection criteria of the E3DObjectExtractor ^.NET ^Python instance.
Extract the 3D objects, with or without an ERegion ^.NET ^Python.
Get and process the extracted objects list.

C++

#include <eVision/Easy3D/Easy3DObject/E3DObjectExtractor.h>

using namespace eVision;
using namespace eVision::Easy3D;
// EZmap constructor
EZMap8 zMap;

// Extractor constructor
E3DObjectExtractor extractor;

// Setting a selection criterion
extractor.SetWidthRange(EFloatRange(10, 500));

// Extracts the objects from the EZMap
int regionNB = extractor.Extract(zMap);

// Retrieve the extracted objects
std::vector<E3DObject> objects = extractor.GetObjects();

using eVision;
using eVision.Easy3D;

// EZmap constructor
EZMap8 zMap = new EZMap8();

// Extractor constructor
E3DObjectExtractor extractor = new E3DObjectExtractor();

// Setting a selection criterion
extractor.WidthRange = new EFloatRange(10, 500);

// Extracts the objects from the EZMap
int regionNB = extractor.Extract(zMap);

// Retrieve the extracted objects
E3DObject[] objects = extractor.Objects;

Python

import eVision
from eVision import Easy3D
# EZmap constructor
zmap = Easy3D.EZMap8()

# Extractor constructor
extractor = Easy3D.E3DObjectExtractor()

# Setting a selection criterion
extractor.WidthRange = eVision.EFloatRange(10, 500)

# Extracts the objects from the EZMap
regionNB = extractor.Extract(zmap)

# Retrieve the extracted objects
objects = extractor.Objects