/*+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
#+
#+     Glade / Gtk Programming
#+
#+     Copyright (C) 2019 - 2025 by Kevin C. O'Kane
#+
#+     Kevin C. O'Kane
#+     kc.okane@gmail.com
#+     https://www.cs.uni.edu/~okane
#+     http://threadsafebooks.com/
#+
#+ This program is free software; you can redistribute it and/or modify
#+ it under the terms of the GNU General Public License as published by
#+ the Free Software Foundation; either version 2 of the License, or
#+ (at your option) any later version.
#+
#+ This program is distributed in the hope that it will be useful,
#+ but WITHOUT ANY WARRANTY; without even the implied warranty of
#+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#+ GNU General Public License for more details.
#+
#+ You should have received a copy of the GNU General Public License
#+ along with this program; if not, write to the Free Software
#+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#+
#++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*/

April 10, 2025

Possible Error Condition

If you have more than one microphone one your system, be sure the correct 
mic is designated as the default mic.

Installation

To run the installer, sgr-meters-amd64.deb, normally, from an explorer 
window, double click on the .deb file and this will start the installer.
The istaller will resolve any missing system libraries.

Alternatively, from the command line, use one of the followin:

    1. sudo dpkg -i sgr-meters-amd64.deb
       sudo apt install -f

    2. sudo apt install gdebi (if not already installed)
       sudo gdebi sgr-meters-amd64.deb

Installation results in the following files being paced on your system:

    /share/man/man1/sgr-meters.1.gz
    /share/applications/sgr-meters.desktop
    /local/share/sgr-meters
    /local/share/sgr-meters/sgr-meters.png
    /local/bin/sgr-meters

sgr-meters.desktop is a launcher that may be copied to your desktop. It
uses the file sgr-meters.png as its icon.

Alternatively, to compile from source code, you will need to first install 
any library software probably not already on your system. To do this, 
please run GeneralInstall.script as root. This will install (via apt install) 
any standard system packages you may be missing. These include graphical and 
audio libraries. Without these, the code will not compile or work.

You must be root when running GeneralInstall.script.

The script file uses apt-install which should work on any system that 
uses same. Fedora, Manjaro  and other distros use different installation apps 
and this script will not work with them. 

The code has been developed using 'out-of-the-box' default desktop themes on 
Mint Mate 21.3 with the Mint-X theme. Desktop themes may influence the way 
graphical objects render. 

To compile the source code, after installing any needed packages, type:

    make

To execute the binary, type

    sgr-meters

The file part1.glade contains the Glade layout code in the event you want to make 
changes.

The file icons/meter.png contains the background for the classic fu meter layout. 
You may replace this with an identical dimensioned image of the same name and 
re-compile. 

Updates

When you upgrade to a newer version, you may need to remove the old version first.
This can be done in the Synaptic pachage manner or with the following command
line code:

    sudo dpkg --remove sgr-meters

Command Line Options

The command line options for vumeter-bin are:

Usage: -ablBwh?s
-a	show arcs
-A	no show arcs [default]
-c	centered spectrum
-C	not centered spectrum [default]
-g	spectrum graph only
-l	connecting lines
-l	no connecting lines [default]
-m	meters only - no spectrum graph
-w	wide spectrum
-v	vu meters
-s val	sample rate [50]
-h	help
-?	help

Not all combinations work!

Examples

    sgr-meters -v
        Show legacy VU meters only.

    sgr-meters -m
        Show digital meters only with arcs not filled in.

    sgr-meters -ma
        Show digital meters only with arcs filled in.

    sgr-meters 
        Show digital meters and non-centered spectrum (0 Hz to 12 kHz).

    sgr-meters -c
        Show digital meters and centered spectrum (0 Hz to 12 kHz).

    sgr-meters -g
        Show non-centered spectrum (0 Hz to 12 kHz) only.

    sgr-meters -gc
        Show non-centered spectrum (0 Hz to 12 kHz) only.

    sgr-meters -gcL
        Show non-centered spectrum (0 Hz to 12 kHz) only without connecting 
        lines.

    sgr-meters -gcLw
        Show non-centered wide spectrum (0 Hz to 23 kHz) only without 
        connecting lines.