Added javadoc comments to staff functions

This commit is contained in:
2025-10-23 13:47:42 +02:00
parent 632dc68ea0
commit 71080e2ddf
3 changed files with 39 additions and 3 deletions

View File

@@ -1,7 +1,23 @@
/**
* @file staffFunctions.cpp
* @author Lyubomir Penev
* @brief Here are all the implementations of the staff functions
* @version 1.0
* @date 2025-10-23
*
* @copyright Copyright (c) 2025
*
*/
#include <staffFunctions.h>
#include <constants.h>
#include <potControlls.h>
/**
* @brief Used to increase the maximum staff volume
*
* @param maxVolume Pointer to the variable used to keep track of staff volume
*/
void staffVolumeUp(int *maxVolume)
{
if (*maxVolume < 64)
@@ -10,6 +26,13 @@ void staffVolumeUp(int *maxVolume)
}
}
/**
* @brief Used to decrease the maximum staff volume. If the max volume is set lower than what the current user volume is, then the user volume will also be lowered.
*
* @param maxVolume Variable used to keep track of the max volume
* @param userVolume Pointer to the variable used to keep track of the user volume
* @param oldUserVolume Pointer to the variable used to keep track of the user volume when in mute or lowered
*/
void staffVolumeDown(int maxVolume, int *userVolume, int *oldUserVolume)
{
if (maxVolume > STAFF_STEPS)