Autonomy Software C++ 24.5.1
Welcome to the Autonomy Software repository of the Mars Rover Design Team (MRDT) at Missouri University of Science and Technology (Missouri S&T)! API reference contains the source code and other resources for the development of the autonomy software for our Mars rover. The Autonomy Software project aims to compete in the University Rover Challenge (URC) by demonstrating advanced autonomous capabilities and robust navigation algorithms.
Loading...
Searching...
No Matches
Camera< T > Class Template Referenceabstract

This interface class serves as a base for all other classes that will implement and interface with a type of camera. More...

#include <Camera.hpp>

Inheritance diagram for Camera< T >:
Collaboration diagram for Camera< T >:

Public Member Functions

 Camera (const int nPropResolutionX, const int nPropResolutionY, const int nPropFramesPerSecond, const PIXEL_FORMATS ePropPixelFormat, const double dPropHorizontalFOV, const double dPropVerticalFOV, const bool bEnableRecordingFlag, const int nNumFrameRetrievalThreads=5)
 Construct a new Camera object.
 
virtual ~Camera ()
 Destroy the Camera object.
 
cv::Size GetPropResolution () const
 Accessor for the Prop Resolution private member.
 
int GetPropFramesPerSecond () const
 Accessor for the Prop Frames Per Second private member.
 
PIXEL_FORMATS GetPropPixelFormat () const
 Accessor for the Prop Pixel Format private member.
 
double GetPropHorizontalFOV () const
 Accessor for the Prop Horizontal F O V private member.
 
double GetPropVerticalFOV () const
 Accessor for the Prop Vertical F O V private member.
 
bool GetEnableRecordingFlag () const
 Accessor for the Enable Recording Flag private member.
 
void SetEnableRecordingFlag (const bool bEnableRecordingFlag)
 Mutator for the Enable Recording Flag private member.
 
virtual bool GetCameraIsOpen ()=0
 Accessor for the Camera Is Open private member.
 
- Public Member Functions inherited from AutonomyThread< void >
 AutonomyThread ()
 Construct a new Autonomy Thread object.
 
virtual ~AutonomyThread ()
 Destroy the Autonomy Thread object. If the parent object or main thread is destroyed or exited while this thread is still running, a race condition will occur. Stopping and joining the thread here insures that the main program can't exit if the user forgot to stop and join the thread.
 
void Start ()
 When this method is called, it starts a new thread that runs the code within the ThreadedContinuousCode method. This is the users main code that will run the important and continuous code for the class.
 
void RequestStop ()
 Signals threads to stop executing user code, terminate. DOES NOT JOIN. This method will not force the thread to exit, if the user code is not written properly and contains WHILE statement or any other long-executing or blocking code, then the thread will not exit until the next iteration.
 
void Join ()
 Waits for thread to finish executing and then closes thread. This method will block the calling code until thread is finished.
 
bool Joinable () const
 Check if the code within the thread and all pools created by it are finished executing and the thread is ready to be closed.
 
AutonomyThreadState GetThreadState () const
 Accessor for the Threads State private member.
 
IPSGetIPS ()
 Accessor for the Frame I P S private member.
 

Protected Member Functions

virtual std::future< bool > RequestFrameCopy (T &tFrame)=0
 
- Protected Member Functions inherited from AutonomyThread< void >
void RunPool (const unsigned int nNumTasksToQueue, const unsigned int nNumThreads=2, const bool bForceStopCurrentThreads=false)
 When this method is called, it starts/adds tasks to a thread pool that runs nNumTasksToQueue copies of the code within the PooledLinearCode() method using nNumThreads number of threads. This is meant to be used as an internal utility of the child class to further improve parallelization. Default value for nNumThreads is 2.
 
void RunDetachedPool (const unsigned int nNumTasksToQueue, const unsigned int nNumThreads=2, const bool bForceStopCurrentThreads=false)
 When this method is called, it starts a thread pool full of threads that don't return std::futures (like a placeholder for the thread return type). This means the thread will not have a return type and there is no way to determine if the thread has finished other than calling the Join() method. Only use this if you want to 'set and forget'. It will be faster as it doesn't return futures. Runs PooledLinearCode() method code. This is meant to be used as an internal utility of the child class to further improve parallelization.
 
void ParallelizeLoop (const int nNumThreads, const N tTotalIterations, F &&tLoopFunction)
 Given a ref-qualified looping function and an arbitrary number of iterations, this method will divide up the loop and run each section in a thread pool. This function must not return anything. This method will block until the loop has completed.
 
void ClearPoolQueue ()
 Clears any tasks waiting to be ran in the queue, tasks currently running will remain running.
 
void JoinPool ()
 Waits for pool to finish executing tasks. This method will block the calling code until thread is finished.
 
bool PoolJoinable () const
 Check if the internal pool threads are done executing code and the queue is empty.
 
void SetMainThreadIPSLimit (int nMaxIterationsPerSecond=0)
 Mutator for the Main Thread Max I P S private member.
 
int GetPoolNumOfThreads ()
 Accessor for the Pool Num Of Threads private member.
 
int GetPoolQueueLength ()
 Accessor for the Pool Queue Size private member.
 
std::vector< void > GetPoolResults ()
 Accessor for the Pool Results private member. The action of getting results will destroy and remove them from this object. This method blocks if the thread is not finished, so no need to call JoinPool() before getting results.
 
int GetMainThreadMaxIPS () const
 Accessor for the Main Thread Max I P S private member.
 

Protected Attributes

int m_nPropResolutionX
 
int m_nPropResolutionY
 
int m_nPropFramesPerSecond
 
int m_nNumFrameRetrievalThreads
 
PIXEL_FORMATS m_ePropPixelFormat
 
double m_dPropHorizontalFOV
 
double m_dPropVerticalFOV
 
std::atomic_bool m_bEnableRecordingFlag
 
std::queue< containers::FrameFetchContainer< T > > m_qFrameCopySchedule
 
std::shared_mutex m_muPoolScheduleMutex
 
std::shared_mutex m_muFrameCopyMutex
 
- Protected Attributes inherited from AutonomyThread< void >
IPS m_IPS
 

Additional Inherited Members

- Public Types inherited from AutonomyThread< void >
enum  AutonomyThreadState
 

Detailed Description

template<class T>
class Camera< T >

This interface class serves as a base for all other classes that will implement and interface with a type of camera.

Author
ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-17

Constructor & Destructor Documentation

◆ Camera()

template<class T >
Camera< T >::Camera ( const int  nPropResolutionX,
const int  nPropResolutionY,
const int  nPropFramesPerSecond,
const PIXEL_FORMATS  ePropPixelFormat,
const double  dPropHorizontalFOV,
const double  dPropVerticalFOV,
const bool  bEnableRecordingFlag,
const int  nNumFrameRetrievalThreads = 5 
)
inline

Construct a new Camera object.

Parameters
nPropResolutionX- X res of camera.
nPropResolutionY- Y res of camera.
nPropFramesPerSecond- FPS camera is running at.
ePropPixelFormat- The pixel layout/format of the image.
dPropHorizontalFOV- The horizontal field of view.
dPropVerticalFOV- The vertical field of view.
bEnableRecordingFlag- Whether or not this camera should be recorded.
Author
ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-18
59 {
60 // Initialize member variables.
61 m_nPropResolutionX = nPropResolutionX;
62 m_nPropResolutionY = nPropResolutionY;
63 m_nPropFramesPerSecond = nPropFramesPerSecond;
64 m_ePropPixelFormat = ePropPixelFormat;
65 m_dPropHorizontalFOV = dPropHorizontalFOV;
66 m_dPropVerticalFOV = dPropVerticalFOV;
67 m_bEnableRecordingFlag = bEnableRecordingFlag;
68 m_nNumFrameRetrievalThreads = nNumFrameRetrievalThreads;
69 }

◆ ~Camera()

template<class T >
virtual Camera< T >::~Camera ( )
inlinevirtual

Destroy the Camera object.

Author
ClayJay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-18
78{}

Member Function Documentation

◆ GetPropResolution()

template<class T >
cv::Size Camera< T >::GetPropResolution ( ) const
inline

Accessor for the Prop Resolution private member.

Returns
cv::Size - The resolution of the camera stored in OpenCV's cv::Size.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-19
88{ return cv::Size(m_nPropResolutionX, m_nPropResolutionY); }
Size2i Size
Here is the caller graph for this function:

◆ GetPropFramesPerSecond()

template<class T >
int Camera< T >::GetPropFramesPerSecond ( ) const
inline

Accessor for the Prop Frames Per Second private member.

Returns
int - The FPS of the camera.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-19
98{ return m_nPropFramesPerSecond; }

◆ GetPropPixelFormat()

template<class T >
PIXEL_FORMATS Camera< T >::GetPropPixelFormat ( ) const
inline

Accessor for the Prop Pixel Format private member.

Returns
PIXEL_FORMATS - The layout/pixel format of the image returned from the camera.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-19
109{ return m_ePropPixelFormat; }

◆ GetPropHorizontalFOV()

template<class T >
double Camera< T >::GetPropHorizontalFOV ( ) const
inline

Accessor for the Prop Horizontal F O V private member.

Returns
double - The horizontal field of view of the camera.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-19
119{ return m_dPropHorizontalFOV; }

◆ GetPropVerticalFOV()

template<class T >
double Camera< T >::GetPropVerticalFOV ( ) const
inline

Accessor for the Prop Vertical F O V private member.

Returns
double - The vertical field of view of the camera.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-08-19
129{ return m_dPropVerticalFOV; }

◆ GetEnableRecordingFlag()

template<class T >
bool Camera< T >::GetEnableRecordingFlag ( ) const
inline

Accessor for the Enable Recording Flag private member.

Returns
true - Recording for this camera has been requested/flagged.
false - This camera should not be recorded.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-12-26
140{ return m_bEnableRecordingFlag; }
Here is the caller graph for this function:

◆ SetEnableRecordingFlag()

template<class T >
void Camera< T >::SetEnableRecordingFlag ( const bool  bEnableRecordingFlag)
inline

Mutator for the Enable Recording Flag private member.

Parameters
bEnableRecordingFlag- Whether or not recording should be enabled for this camera.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2023-12-26
150{ m_bEnableRecordingFlag = bEnableRecordingFlag; }

◆ GetCameraIsOpen()

template<class T >
virtual bool Camera< T >::GetCameraIsOpen ( )
pure virtual

Accessor for the Camera Is Open private member.

Returns
true - The camera is currently open.
false - The camera is not currently open.
Author
clayjay3 (clayt.nosp@m.onra.nosp@m.ycowe.nosp@m.n@gm.nosp@m.ail.c.nosp@m.om)
Date
2024-12-25

Implemented in BasicCam, SIMBasicCam, SIMZEDCam, and ZEDCam.

Here is the caller graph for this function:

◆ RequestFrameCopy()

template<class T >
virtual std::future< bool > Camera< T >::RequestFrameCopy ( T &  tFrame)
protectedpure virtual

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