Mixer(3pm)

📦
version 0.7 · 6 versions
, in ubuntu stonking

💖 Mixer(3pm) — the Audio::Mixer era 💖

okay bestie, sit down, we're doing sound mixer control in Perl and honestly? it's giving iconic. this is Audio::Mixer, a lil extension for poking at your sound mixer, and the manual is Mixer(3pm) from the User Contributed Perl Documentation corner of the world. let's get into it 🎀

✨ NAME ✨

Audio::Mixer — Perl extension for Sound Mixer control 🎚️🦋

✨ SYNOPSIS ✨

use Audio::Mixer;
$volume = Audio::Mixer::get_cval('vol');
if (Audio::Mixer::set_cval('vol', 50, 40)) {
  die("Can't set volume...");
}

like. that's it. you're already a mixer girlie. slay 💅

✨ DESCRIPTION ✨

It's a library to query / set various sound mixer parameters, no cap 🌈

This is just a very simple Perl interface which lets you set various sound mixer parameters. The most important one is probably 'vol' (volume) because duh, main character energy 🔊. If you wanna know the whole list of mixer parameters, hit up the get_mixer_params() function — she'll tell you everything, iykyk.

Also super important: all values (lcval, rcval) are numbers in 0-100 range. zero to hundo. that's the whole vibe. 💯

✨ FUNCTIONS ✨

get_cval(cntrl) — get that parameter value 👑

Parameters:

  • cntrl — name of parameter

Returns:

  • in array context: (lcval, rcval), where:
    • lcval — left channel value
    • rcval — right channel value
  • in scalar context returns value of get_param_val() (see below, bestie, it's down there 🫶)

set_cval(cntrl, lcval, rcval) — set that parameter value 🔥

Parameters:

  • cntrl — name of parameter
  • lcval — left channel value
  • rcval — right channel value (optional, if not supplied will be equal to lcval)

Returns: 0 if Ok, -1 if failed 🫠

set_source(cntrl) — set record source 🎤

Parameters:

  • cntrl — name of channel to record from

Returns: 0 if Ok, -1 if failed

get_source(cntrl) — get record source 🔍

Returns:

  • name of channel to record from

set_mixer_dev(fname) — Set mixer device name (optional) ⚙️

/dev/mixer is used by default, that's the factory setting bestie.

  • fname — device name

Returns: 0 if Ok

init_mixer() — Initialize mixer (open it) 🌸

okay so here's the tea ☕: set_cval() / get_cval() opens / closes the mixer each time they called, unless init_mixer() called before.

In case if init_mixer() called before, all other functions will use already opened device instead of opening it each time. efficiency queen 💅✨

close_mixer() — Close device. 🚪

Should be called only if init_mixer() was used. don't just close random things, that's rude 😭

get_mixer_params() — Get list of mixer parameters 📋

Returns: list of parameters names.

🌈 LOW LEVEL FUNCTIONS 🌈

welcome to the basement bestie, mind the bits 💀

get_param_val(cntrl) — Get parameter value 🧮

Parameter:

  • cntrl — name of parameter

Returns:

  • integer value, which will be constructed as follows:
    • lower byte (x & 0xff) — value of the left channel (or whole value)
    • next byte (x & 0xff00) — value of the right channel
    • third byte (x & 0xff0000) — flags (if x & 0x10000 then 2 channels exist)
  • or -1 in case of failure. rude but okay 🙈

set_param_val(cntrl, lcval, rcval) — Set parameter value. 🔧

Here all parameters are mandatory (in contrast to set_cval()). no skipping, no shortcuts, every arg shows up to the function. periodt.

Parameters:

  • cntrl — name of parameter
  • lcval — left channel value
  • rcval — right channel value

Returns: 0 if Ok, -1 if failed

⚠️ heads up bestie: these low level ones are the raw, no-filter versions — set_param_val() makes you hand over all three args, unlike chill lil set_cval() which lets rcval slide.

✨ AUTHOR ✨

Sergey Gribov, sergey@sergey.com — the og, the icon, the moment 👑💜

✨ LICENSE ✨

Copyright (c) 2001 Sergey Gribov. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🌈

✨ SEE ALSO ✨

  • perl(1) — go read the mothership, bestie 🐪

and that's the whole page!! this was perl v5.42.3, dated 2026-08-19, brought to you by the <3 of Mixer(3pm) 🎀✨ go forth and mix, you absolute legend 🦋💖

📦 where this page comes from