[FSD] Doxygen

This commit is contained in:
Mat Sutcliffe
2019-10-03 19:09:26 +01:00
parent 6eb008c0a0
commit 2dbc347bd7
3 changed files with 19 additions and 13 deletions

View File

@@ -91,7 +91,8 @@ namespace BlackCore
//! Reference to voice client //! Reference to voice client
BlackCore::Afv::Clients::CAfvClient &voiceClient() { return m_voiceClient; } BlackCore::Afv::Clients::CAfvClient &voiceClient() { return m_voiceClient; }
//! Audio devices @{ //! Audio devices
//! @{
BlackMisc::Audio::CAudioDeviceInfoList getAudioDevices() const; BlackMisc::Audio::CAudioDeviceInfoList getAudioDevices() const;
BlackMisc::Audio::CAudioDeviceInfoList getAudioInputDevices() const { return this->getAudioDevices().getInputDevices(); } BlackMisc::Audio::CAudioDeviceInfoList getAudioInputDevices() const { return this->getAudioDevices().getInputDevices(); }
BlackMisc::Audio::CAudioDeviceInfoList getAudioOutputDevices() const { return this->getAudioDevices().getOutputDevices(); } BlackMisc::Audio::CAudioDeviceInfoList getAudioOutputDevices() const { return this->getAudioDevices().getOutputDevices(); }
@@ -105,7 +106,8 @@ namespace BlackCore
//! \param audioDevice can be input or audio device //! \param audioDevice can be input or audio device
void setCurrentAudioDevices(const BlackMisc::Audio::CAudioDeviceInfo &audioDevice, const BlackMisc::Audio::CAudioDeviceInfo &outputDevice); void setCurrentAudioDevices(const BlackMisc::Audio::CAudioDeviceInfo &audioDevice, const BlackMisc::Audio::CAudioDeviceInfo &outputDevice);
//! Volume @{ //! Volume
//! @{
void setVoiceOutputVolume(int volume); void setVoiceOutputVolume(int volume);
int getVoiceOutputVolume() const; int getVoiceOutputVolume() const;
void setMute(bool muted); void setMute(bool muted);
@@ -118,12 +120,14 @@ namespace BlackCore
//! Notification sounds //! Notification sounds
void playNotification(BlackMisc::Audio::CNotificationSounds::NotificationFlag notification, bool considerSettings, int volume = -1); void playNotification(BlackMisc::Audio::CNotificationSounds::NotificationFlag notification, bool considerSettings, int volume = -1);
//! Loopback @{ //! Loopback
//! @{
void enableAudioLoopback(bool enable = true); void enableAudioLoopback(bool enable = true);
bool isAudioLoopbackEnabled() const; bool isAudioLoopbackEnabled() const;
//! @} //! @}
//! Voice setup @{ //! Voice setup
//! @{
BlackMisc::Audio::CVoiceSetup getVoiceSetup() const; BlackMisc::Audio::CVoiceSetup getVoiceSetup() const;
void setVoiceSetup(const BlackMisc::Audio::CVoiceSetup &setup); void setVoiceSetup(const BlackMisc::Audio::CVoiceSetup &setup);
//! @} //! @}
@@ -161,20 +165,19 @@ namespace BlackCore
// ------------- DBus --------------- // ------------- DBus ---------------
//! \addtogroup swiftdotcommands //! \addtogroup swiftdotcommands
//! @{
//! <pre> //! <pre>
//! .mute mute BlackCore::Context::CContextAudio //! .mute mute BlackCore::Context::CContextAudio
//! .unmute unmute BlackCore::Context::CContextAudio //! .unmute unmute BlackCore::Context::CContextAudio
//! .vol .volume volume 0..100 set volume BlackCore::Context::CContextAudio //! .vol .volume volume 0..100 set volume BlackCore::Context::CContextAudio
//! </pre> //! </pre>
//! @}
//! \copydoc IContextAudio::parseCommandLine //! \copydoc IContextAudio::parseCommandLine
virtual bool parseCommandLine(const QString &commandLine, const BlackMisc::CIdentifier &originator) override; virtual bool parseCommandLine(const QString &commandLine, const BlackMisc::CIdentifier &originator) override;
// ------------- DBus --------------- // ------------- DBus ---------------
private: private:
//! Enable/disable voice transmission, nornally used with hotkey @{ //! Enable/disable voice transmission, nornally used with hotkey
//! @{
void setVoiceTransmission(bool enable, BlackMisc::Audio::PTTCOM com); void setVoiceTransmission(bool enable, BlackMisc::Audio::PTTCOM com);
void setVoiceTransmissionCom1(bool enabled); void setVoiceTransmissionCom1(bool enabled);
void setVoiceTransmissionCom2(bool enabled); void setVoiceTransmissionCom2(bool enabled);
@@ -187,7 +190,8 @@ namespace BlackCore
//! Changed audio settings //! Changed audio settings
void onChangedAudioSettings(); void onChangedAudioSettings();
//! Audio increase/decrease volume @{ //! Audio increase/decrease volume
//! @{
void audioIncreaseVolume(bool enabled); void audioIncreaseVolume(bool enabled);
void audioDecreaseVolume(bool enabled); void audioDecreaseVolume(bool enabled);
//! @} //! @}

View File

@@ -37,13 +37,13 @@ namespace BlackMisc
//! Constructor //! Constructor
CConnectionStatus(ConnectionStatus status) : m_connectionStatus(status) {} CConnectionStatus(ConnectionStatus status) : m_connectionStatus(status) {}
//! Query status
//! @{
bool isConnected() const { return m_connectionStatus == Connected; } bool isConnected() const { return m_connectionStatus == Connected; }
bool isConnecting() const { return m_connectionStatus == Connecting; } bool isConnecting() const { return m_connectionStatus == Connecting; }
bool isDisconnecting() const { return m_connectionStatus == Disconnecting; } bool isDisconnecting() const { return m_connectionStatus == Disconnecting; }
bool isDisconnected() const { return m_connectionStatus == Disconnected; } bool isDisconnected() const { return m_connectionStatus == Disconnected; }
//! @}
//! Get status //! Get status
ConnectionStatus getConnectionStatus() const { return m_connectionStatus; } ConnectionStatus getConnectionStatus() const { return m_connectionStatus; }

View File

@@ -35,14 +35,16 @@ namespace BlackMisc
//! Constructor //! Constructor
CLoginMode(LoginMode mode) : m_loginMode(mode) {} CLoginMode(LoginMode mode) : m_loginMode(mode) {}
//! Is login as pilot?
bool isPilot() const { return m_loginMode == Pilot; } bool isPilot() const { return m_loginMode == Pilot; }
//! Is login as observer?
bool isObserver() const { return m_loginMode == Observer; } bool isObserver() const { return m_loginMode == Observer; }
//! Get status //! Get login mode
LoginMode getLoginMode() const { return m_loginMode; } LoginMode getLoginMode() const { return m_loginMode; }
//! Set status //! Set login mode
void setLoginMode(LoginMode mode) { m_loginMode = mode; } void setLoginMode(LoginMode mode) { m_loginMode = mode; }
//! \copydoc BlackMisc::Mixin::String::toQString //! \copydoc BlackMisc::Mixin::String::toQString