CameraHandler Class Reference

The CameraHandler class is responsible for managing all of the camera feeds that Autonomy_Software uses for computer vision. Whether it be a USB webcam, a MJPEG stream, or a ZED camera, this class is responsible for initializing that camera and configuring it. More...

#include <CameraHandler.h>

Public Types
enum class	ZEDCamName { ZEDCAM_START , eHeadMainCam , ZEDCAM_END }
enum class	BasicCamName { BASICCAM_START , eHeadGroundCam , BASICCAM_END }

Public Member Functions
	CameraHandler ()
	Construct a new Camera Handler Thread:: Camera Handler Thread object.
	~CameraHandler ()
	Destroy the Camera Handler Thread:: Camera Handler Thread object.
void	StartAllCameras ()
	Signals all cameras to start their threads.
void	StartRecording ()
	Signal the RecordingHandler to start recording video feeds from the CameraHandler.
void	StopAllCameras ()
	Signals all cameras to stop their threads.
void	StopRecording ()
	Signal the RecordingHandler to stop recording video feeds from the CameraHandler.
std::shared_ptr< ZEDCamera >	GetZED (ZEDCamName eCameraName)
	Accessor for ZED cameras.
std::shared_ptr< BasicCamera >	GetBasicCam (BasicCamName eCameraName)
	Accessor for Basic cameras.

Private Attributes
std::shared_ptr< ZEDCamera >	m_pMainCam
std::shared_ptr< BasicCamera >	m_pGroundCam
std::unique_ptr< RecordingHandler >	m_pRecordingHandler

Detailed Description

The CameraHandler class is responsible for managing all of the camera feeds that Autonomy_Software uses for computer vision. Whether it be a USB webcam, a MJPEG stream, or a ZED camera, this class is responsible for initializing that camera and configuring it.

Author

ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-08-17

Member Enumeration Documentation

ZEDCamName

enum class CameraHandler::ZEDCamName

strong

        {
            ZEDCAM_START,
            eHeadMainCam,
            ZEDCAM_END
        };

BasicCamName

enum class CameraHandler::BasicCamName

strong

        {
            BASICCAM_START,
            eHeadGroundCam,
            BASICCAM_END
        };

Constructor & Destructor Documentation

CameraHandler()

CameraHandler::CameraHandler

(

)

Construct a new Camera Handler Thread:: Camera Handler Thread object.

Author

ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-08-17

{
    // Check if we are in simulation mode.
    if (!constants::MODE_SIM)
    {
        // Initialize main ZED camera.
        m_pMainCam = std::make_shared<ZEDCam>(constants::ZED_MAINCAM_RESOLUTIONX,
                                              constants::ZED_MAINCAM_RESOLUTIONY,
                                              constants::ZED_MAINCAM_FPS,
                                              constants::ZED_MAINCAM_HORIZONTAL_FOV,
                                              constants::ZED_MAINCAM_VERTICAL_FOV,
                                              constants::ZED_MAINCAM_ENABLE_RECORDING,
                                              constants::ZED_MAINCAM_EXPORT_SVO_RECORDING,
                                              constants::ZED_DEFAULT_MINIMUM_DISTANCE,
                                              constants::ZED_DEFAULT_MAXIMUM_DISTANCE,
                                              constants::ZED_MAINCAM_USE_GPU_MAT,
                                              constants::ZED_MAINCAM_USE_HALF_PRECISION_DEPTH,
                                              constants::ZED_MAINCAM_FUSION_MASTER,
                                              constants::ZED_MAINCAM_FRAME_RETRIEVAL_THREADS,
                                              constants::ZED_MAINCAM_SERIAL);
 
        // Always enable positional tracking.
        m_pMainCam->EnablePositionalTracking();
 
        // Additional setup for main ZED camera.
        if (constants::ZED_MAINCAM_EXPORT_SPATIAL_MAP)
        {
            m_pMainCam->EnableSpatialMapping();
        }
    }
    else
    {
        m_pMainCam = std::make_shared<SIMZEDCam>("ws://" + constants::SIM_IP_ADDRESS + ":" + std::to_string(constants::SIM_WEBSOCKET_PORT),
                                                 constants::ZED_MAINCAM_RESOLUTIONX,
                                                 constants::ZED_MAINCAM_RESOLUTIONY,
                                                 constants::ZED_MAINCAM_FPS,
                                                 constants::ZED_MAINCAM_HORIZONTAL_FOV,
                                                 constants::ZED_MAINCAM_VERTICAL_FOV,
                                                 constants::ZED_MAINCAM_ENABLE_RECORDING,
                                                 constants::ZED_MAINCAM_FRAME_RETRIEVAL_THREADS,
                                                 constants::ZED_MAINCAM_SERIAL);
    }
 
    // Initialize ground eye.
    m_pGroundCam = std::make_shared<BasicCam>(constants::BASICCAM_GROUNDCAM_INDEX,
                                              constants::BASICCAM_GROUNDCAM_RESOLUTIONX,
                                              constants::BASICCAM_GROUNDCAM_RESOLUTIONY,
                                              constants::BASICCAM_GROUNDCAM_FPS,
                                              constants::BASICCAM_GROUNDCAM_PIXELTYPE,
                                              constants::BASICCAM_GROUNDCAM_HORIZONTAL_FOV,
                                              constants::BASICCAM_GROUNDCAM_VERTICAL_FOV,
                                              constants::BASICCAM_GROUNDCAM_ENABLE_RECORDING,
                                              constants::BASICCAM_GROUNDCAM_FRAME_RETRIEVAL_THREADS);
 
    // Initialize recording handler for cameras.
    m_pRecordingHandler = std::make_unique<RecordingHandler>(RecordingHandler::RecordingMode::eCameraHandler);
}

~CameraHandler()

CameraHandler::~CameraHandler

(

)

Destroy the Camera Handler Thread:: Camera Handler Thread object.

Author

ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-08-17

{
    // Signal and wait for cameras to stop.
    this->StopAllCameras();
}

Here is the call graph for this function:

Member Function Documentation

StartAllCameras()

void CameraHandler::StartAllCameras

(

)

Signals all cameras to start their threads.

Author

ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-09-09

{
    // Start ZED cams.
    m_pMainCam->Start();
 
    // Start basic cams.
    // m_pGroundCam->Start();
}

Here is the caller graph for this function:

StartRecording()

void CameraHandler::StartRecording

(

)

Signal the RecordingHandler to start recording video feeds from the CameraHandler.

Author

clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-12-31

{
    // Start recording handler.
    m_pRecordingHandler->Start();
}

Here is the caller graph for this function:

StopAllCameras()

void CameraHandler::StopAllCameras

(

)

Signals all cameras to stop their threads.

Author

ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-10-03

{
    // Stop recording handler.
    m_pRecordingHandler->RequestStop();
    m_pRecordingHandler->Join();
 
    // Stop ZED cams.
    m_pMainCam->RequestStop();
    m_pMainCam->Join();
 
    // Stop basic cams.
    // m_pGroundCam->RequestStop();
    // m_pGroundCam->Join();
}

Here is the caller graph for this function:

StopRecording()

void CameraHandler::StopRecording

(

)

Signal the RecordingHandler to stop recording video feeds from the CameraHandler.

Author

clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2024-01-01

{
    // Stop recording handler.
    m_pRecordingHandler->RequestStop();
    m_pRecordingHandler->Join();
}

GetZED()

std::shared_ptr< ZEDCamera > CameraHandler::GetZED

(

ZEDCamName

eCameraName

)

Accessor for ZED cameras.

Parameters

eCameraName

- The name of the camera to retrieve. An enum defined in and specific to this class.

Returns

std::shared_ptr<ZEDCamera> - A pointer to the zed camera pertaining to the given name.

Author

clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-09-01

{
    // Determine which camera should be returned.
    switch (eCameraName)
    {
        case ZEDCamName::eHeadMainCam: return m_pMainCam; break;    // Return the ZEDCam in the autonomy head.
        default: return m_pMainCam; break;
    }
}

Here is the caller graph for this function:

GetBasicCam()

std::shared_ptr< BasicCamera > CameraHandler::GetBasicCam

(

BasicCamName

eCameraName

)

Accessor for Basic cameras.

Parameters

eCameraName

- The name of the camera to retrieve. An enum defined in and specific to this class.

Returns

std::shared_ptr<BasicCamera> - A pointer to the basic camera pertaining to the given name.

Author

clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)

Date

2023-09-01

{
    // Determine which camera should be returned.
    switch (eCameraName)
    {
        case BasicCamName::eHeadGroundCam: return m_pGroundCam; break;    // Return the ground fisheye cam in the autonomy head.
        default: return m_pGroundCam; break;
    }
}

Here is the caller graph for this function:

---

The documentation for this class was generated from the following files:

• src/handlers/CameraHandler.h
• src/handlers/CameraHandler.cpp