* \param db_gain the dB gain to convert (in 0.01dB unit)
* \param value the pointer to store the converted raw volume value
* \param xdir the direction for round-up. The value is round up
- * when this is positive.
+ * when this is positive. A negative value means round down.
+ * Zero means round-up to nearest.
* \return 0 if successful, or a negative error code
*/
int snd_tlv_convert_from_dB(unsigned int *tlv, long rangemin, long rangemax,
long v = (db_gain - min) * (rangemax - rangemin);
if (xdir > 0)
v += (max - min) - 1;
+ else if (xdir == 0)
+ v += ((max - min) + 1) / 2;
v = v / (max - min) + rangemin;
*value = v;
}
long v = (db_gain - min) * (rangemax - rangemin);
if (xdir > 0)
v += (max - min) - 1;
+ else if (xdir == 0)
+ v += ((max - min) + 1) / 2;
v = v / (max - min) + rangemin;
*value = v;
}
v = (v - vmin) * (rangemax - rangemin) / (vmax - vmin);
if (xdir > 0)
v = ceil(v);
+ else if (xdir == 0)
+ v = lrint(v);
*value = (long)v + rangemin;
}
return 0;
* \brief Return corresponding integer playback volume for given dB value for a mixer simple element
* \param elem Mixer simple element handle
* \param value value to be converted to dB range
- * \param dir rounding mode - rounds up if dir > 0, otherwise rounds down
+ * \param dir rounding mode - rounds up if dir > 0, round to nearest if dir == 0,
+ * rounds down if dir < 0
* \param dBvalue pointer to returned dB value
* \return 0 on success otherwise a negative error code
*/
* \param elem Mixer simple element handle
* \param channel mixer simple element channel identifier
* \param value control value in dB * 100
- * \param dir rounding mode - rounds up if dir > 0, otherwise rounds down
+ * \param dir rounding mode - rounds up if dir > 0, round to nearest if dir == 0,
+ * rounds down if dir < 0
* \return 0 on success otherwise a negative error code
*/
int snd_mixer_selem_set_playback_dB(snd_mixer_elem_t *elem, snd_mixer_selem_channel_id_t channel, long value, int dir)
* \brief Set value in dB of playback volume control for all channels of a mixer simple element
* \param elem Mixer simple element handle
* \param value control value in dB * 100
- * \param dir rounding mode - rounds up if dir > 0, otherwise rounds down
+ * \param dir rounding mode - rounds up if dir > 0, round to nearest if dir == 0,
+ * rounds down if dir < 0
* \return 0 on success otherwise a negative error code
*/
int snd_mixer_selem_set_playback_dB_all(snd_mixer_elem_t *elem, long value, int dir)
* \param elem Mixer simple element handle
* \param dBvalue dB value to be converted to integer range
* \param value pointer to returned integer value
- * \param dir rounding mode - rounds up if dir > 0, otherwise rounds down
+ * \param dir rounding mode - rounds up if dir > 0, round to nearest if dir == 0,
+ * rounds down if dir < 0
* \return 0 on success otherwise a negative error code
*/
int snd_mixer_selem_ask_capture_dB_vol(snd_mixer_elem_t *elem, long dBvalue, int dir, long *value)
* \param elem Mixer simple element handle
* \param channel mixer simple element channel identifier
* \param value control value in dB * 100
- * \param dir rounding mode - rounds up if dir > 0, otherwise rounds down
+ * \param dir rounding mode - rounds up if dir > 0, round to nearest if dir == 0,
+ * rounds down if dir < 0
* \return 0 on success otherwise a negative error code
*/
int snd_mixer_selem_set_capture_dB(snd_mixer_elem_t *elem, snd_mixer_selem_channel_id_t channel, long value, int dir)
* \brief Set value in dB of capture volume control for all channels of a mixer simple element
* \param elem Mixer simple element handle
* \param value control value in dB * 100
- * \param dir rounding mode - rounds up if dir > 0, otherwise rounds down
+ * \param dir rounding mode - rounds up if dir > 0, round to nearest if dir == 0,
+ * rounds down if dir < 0
* \return 0 on success otherwise a negative error code
*/
int snd_mixer_selem_set_capture_dB_all(snd_mixer_elem_t *elem, long value, int dir)