Changeset 61 in pacpusframework for trunk/include/Pacpus/DbitePlayer


Ignore:
Timestamp:
Jan 9, 2013, 1:40:39 PM (12 years ago)
Author:
Marek Kurdej
Message:

Added: some documentation and doc todo comments.

Location:
trunk/include/Pacpus/DbitePlayer
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • trunk/include/Pacpus/DbitePlayer/DbtPlyEngine.h

    r31 r61  
    7171    void reset();
    7272
     73    /// @todo Documentation
    7374    void speedUp();
     75    /// @todo Documentation
    7476    void speedDown();
     77    /// @todo Documentation
    7578    void setLastTNow(road_time_t newTNow)
    7679    {
     
    7982
    8083protected:
    81     // The 3 virtual methods relative to the ComponentBase inheritance
     84    /// @todo Documentation
    8285    virtual void startActivity();
     86    /// @todo Documentation
    8387    virtual void stopActivity();
     88    /// @todo Documentation
    8489    virtual COMPONENT_CONFIGURATION configureComponent(XmlComponentConfig config);
    8590
     
    122127
    123128Q_SIGNALS:
     129    /// @todo Documentation
    124130    void play(road_time_t timeToPlay, road_time_t actualTime, bool direction);
     131    /// @todo Documentation
    125132    void stopfile();
     133    /// @todo Documentation
    126134    void displayStateSig(DbtPlyEngineState * state, float speed);
     135    /// @todo Documentation
    127136    void timeMinMax(road_time_t tMin, road_time_t tMax);
     137    /// @todo Documentation
    128138    void curReplayTime(road_time_t time);
    129139
    130140public Q_SLOTS:
     141    /// @todo Documentation
    131142    void engReceiver();
     143    /// @todo Documentation
    132144    void changeDirection(bool reverse);
     145    /// @todo Documentation
    133146    void tMinMax(road_time_t tMin, road_time_t tMax);
    134147
     148    /// @todo Documentation
    135149    void playEvent();
     150    /// @todo Documentation
    136151    void pauseEvent();
     152    /// @todo Documentation
    137153    void stopEvent();
     154    /// @todo Documentation
    138155    void speedUpEvent();
     156    /// @todo Documentation
    139157    void speedDownEvent();
    140158};
  • trunk/include/Pacpus/DbitePlayer/DbtPlyFileManager.h

    r31 r61  
    4141
    4242public:
    43     // constructor
     43    /// constructor
    4444    DbtPlyFileManager(QString name);
    45     // destructor
     45    /// destructor
    4646    virtual ~DbtPlyFileManager();
    4747
    48     // the player replays only the last data that has not been yet replayed
     48    /// the player replays only the last data that has not been yet replayed
     49    /// @todo Rename
    4950    void playMode1 (road_time_t tDbt, bool reverse);
    50     // the player replays all the data that have not been yet replayed
     51    /// the player replays all the data that have not been yet replayed
     52    /// @todo Rename
    5153    void playMode2 (road_time_t tDbt, bool reverse);
    5254
    53     // virtual method: call when new DBT data are replayed
     55    /// virtual method: call when new DBT data are replayed
    5456    virtual void processData(road_time_t time, road_timerange_t timeRange, void * data) = 0;
    5557    virtual void displayUI();
    5658
    57     // 3 Virtual methods relative to the ComponentBase inheritance
     59    /// 3 Virtual methods relative to the ComponentBase inheritance
    5860    virtual COMPONENT_CONFIGURATION configureComponent(XmlComponentConfig config);
     61    /// @todo Documentation
    5962    virtual void startActivity();
     63    /// @todo Documentation
    6064    virtual void stopActivity();
    6165
    62     // The loop of the thread
     66    /// The loop of the thread
    6367    virtual void run();
    6468
    6569public Q_SLOTS:
    66     // slot activated by the engine when it computes new DBT time
     70    /// slot activated by the engine when it computes new DBT time
    6771    void  playData(road_time_t tDbt,road_time_t tNow, bool reverse);
    6872
    69     // put the file descriptor to the beginning of the file
     73    /// put the file descriptor to the beginning of the file
    7074    void beginfile();
    7175
    7276Q_SIGNALS:
    73     // signal sent to the engine to provide to it the tmin and tmax of the file
     77    /// signal sent to the engine to provide to it the tmin and tmax of the file
    7478    void tMinMaxIs(road_time_t tmin, road_time_t tmax);
    7579
     
    7882    int mVerbose;
    7983
    80     // a pointer on the player engine
     84    /// a pointer on the player engine
    8185    DbtPlyEngine * mEngine;
    8286
    83     // the absolute path of the DBT file
     87    /// the absolute path of the DBT file
    8488    QString dbtProperty_;
    8589    QStringList mDbtFilenameList;
    8690
    87     // The directory where the DBT file is located
     91    /// The directory where the DBT file is located
    8892    QString mDbtDataPath;
    8993
    90     // Display or not the graphical interface
     94    /// Display or not the graphical interface
    9195    bool mShowGui;
    9296
     97    /// @todo Documentation
    9398    struct dbtStruct
    9499    {
     
    98103    };
    99104
     105    /// @todo Documentation
    100106    struct dbtStructFile
    101107    {
     
    112118
    113119private:
     120    /// @todo Documentation
    114121    bool processDbtFileHdfile(dbtStructFile & dbtFile, pacpus::DbiteFile::ReadDirection direction);
    115122
     
    118125    bool reverse_;
    119126
    120     // the estimated DBT time sent by the engine and computed relatively to the state of the player
     127    /// the estimated DBT time sent by the engine and computed relatively to the state of the player
    121128    road_time_t timeToRead_;
    122129
    123     // The mode of replay
    124     // see playModeN method
     130    /// The mode of replay
     131    /// @see playMode1, playMode2 methods
    125132    int mode_;
    126133
    127     // The minimum and maximum time of the data contained in the file
     134    /// The minimum and maximum time of the data contained in the file
    128135    road_time_t tMin_, tMax_;
    129136
    130     // the synchronization semaphore with the engine
     137    /// the synchronization semaphore with the engine
    131138    QSemaphore * sync_;
    132139
    133     // For statistics purpose - delta time between the instant when the tDbt is computed and the instant when it is
    134     // taken into account by the file manager
     140    /// For statistics purpose - delta time between the instant when the tDbt is computed and the instant when it is
     141    /// taken into account by the file manager
    135142    int deltaTDbtTab_[1000];
    136143    int deltaTDbtTabLoop_;
  • trunk/include/Pacpus/DbitePlayer/DbtPlyTrigger.h

    r31 r61  
    3535
    3636public:
     37    /// @todo Documentation
    3738    DbtPlyTrigger(QString name);
     39    /// @todo Documentation
    3840    virtual ~DbtPlyTrigger();
    3941
     42    /// @todo Documentation
    4043    virtual ComponentBase::COMPONENT_CONFIGURATION configureComponent(XmlComponentConfig config);
    4144
     45    /// @todo Documentation
    4246    virtual void run();
    4347
    4448Q_SIGNALS:
     49    /// @todo Documentation
    4550    void triggerSig();
    4651
    4752protected:
     53    /// @todo Documentation
    4854    virtual void startActivity();
     55    /// @todo Documentation
    4956    virtual void stopActivity();
    5057
Note: See TracChangeset for help on using the changeset viewer.