# The &kenvy24gui; Handbook

Valentin Rusu

    kenvy24@rusu.info

2007
2007
Valentin Rusu
&FDLNotice;
2007-09-06
0.1

&kenvy24gui; is a VIA Envy24 based sound cards control utility, for the KDE environment.

KDE
kenvy24gui
envy24
envy24control
mixer
m-audio delta 2496

## Introduction

&kenvy24gui; is a sound card control utility. The sound card has to be based on VIA Envy24 chipset. This chip processes audio on 24 bit at 48 kHz and has an amazing internal multitrack mixer.

This control utility is based on the envy24control utility, part of alsa-tools. However, envy24control is no longer maintained and it's GTK based user interface is quite cumbersome. That is because of the design and not GTK, though. The tab-oriented GUI is misleading and prevent an overall view of the cards operation.

&kenvy24gui; provide all controls and level-meters in a single screen. Ther user can quickly adjust the knobs and can use as many profiles to store the settings for a later retrieval.

In the future, &kenvy24gui; will provide a kicker applet, allowing quick access to it while reducing the number of windows on the desktop.

## Using &kenvy24gui;

Here's a screenshot of &kenvy24gui; Screenshot

### More &kenvy24gui; features

It slices! It dices! and it comes with a free toaster!

The Squiggle Tool Squiggle is used to draw squiggly lines all over the &kenvy24gui; main window. It's not a bug, it's a feature!

## Command Reference

### The main &kenvy24gui; window

#### The File Menu

&Ctrl;N File New

  Creates a new document

&Ctrl;S File Save

  Saves the document

&Ctrl;Q File Quit

  Quits &kenvy24gui;

#### The Help Menu

&help.menu.documentation;

## Developer's Guide to &kenvy24gui;

Programming &kenvy24gui; plugins is a joy to behold. Just read through the next 66 pages of API's to learn how!

XtUnmanageChildren
Xt - Geometry Management

### XtUnmanageChildren

remove a list of children from a parent widget's managed list.
4 March 1996

    void XtUnmanageChildren(children, num_children)
        WidgetList children;
        Cardinal num_children;

#### Inputs

children

  Specifies an array of child widgets. Each child must be of class RectObj or any subclass thereof.

num_children

  Specifies the number of elements in children.

#### Description

`XtUnmanageChildren()` unmaps the specified widgets and removes them from their parent's geometry management. The widgets will disappear from the screen, and (depending on its parent) may no longer have screen space allocated for them.

Each of the widgets in the children array must have the same parent.

See the “Algorithm” section below for full details of the widget unmanagement procedure.

#### Usage

Unmanaging widgets is the usual method for temporarily making them invisible. They can be re-managed with `XtManageChildren()`.

You can unmap a widget, but leave it under geometry management by calling `XtUnmapWidget()`. You can destroy a widget's window without destroying the widget by calling `XtUnrealizeWidget()`. You can destroy a widget completely with `XtDestroyWidget()`.

If you are only going to unmanage a single widget, it is more convenient to call `XtUnmanageChild()`. It is often more convenient to call `XtUnmanageChild()` several times than it is to declare and initialize an array of widgets to pass to `XtUnmanageChildren()`. Calling `XtUnmanageChildren()` is more efficient, however, because it only calls the parent's `change_managed()` method once.

#### Algorithm

`XtUnmanageChildren()` performs the following:

-

  Ignores the child if it already is unmanaged or is being destroyed.

-

  Otherwise, if the child is realized, it makes it nonvisible by unmapping it.

#### Structures

The WidgetList type is simply an array of widgets:

    typedef Widget *WidgetList;

## Questions and Answers

&reporting.bugs; &updating.documentation;

My Mouse doesn't work. How do I quit &kenvy24gui;?

You silly goose! Check out the Commands Section for the answer.

Why can't I twiddle my documents?

You can only twiddle your documents if you have the foobar.lib installed.

## Credits and License

&kenvy24gui;

Program copyright 2007 Valentin Rusu kenvy24@rusu.info

Contributors:

- Konqui the KDE Dragon konqui@kde.org

- Tux the Linux Penguin tux@linux.org

Documentation copyright 2007 Valentin Rusu kenvy24@rusu.info

&underFDL;

&underGPL; &underBSDLicense; &underArtisticLicense; &underX11License;

## kenvy24gui compared to ALSA Envy24 Control Utility

kenvy24gui envy24control ==========--------------============= MUTE Mute with "L/R Gang" On

## Installation

### How to obtain &kenvy24gui;

&install.intro.documentation;

### Requirements

In order to successfully use &kenvy24gui;, you need &kde; 1.1. Foobar.lib is required in order to support the advanced &kenvy24gui; features. &kenvy24gui; uses about 5 megs of memory to run, but this may vary depending on your platform and configuration.

All required libraries as well as &kenvy24gui; itself can be found on The &kenvy24gui; home page.

You can find a list of changes at http://apps.kde.org/kenvy24gui.

### Compilation and Installation

&install.compile.documentation;

### Configuration

Don't forget to tell your system to start the `dtd` dicer-toaster daemon first, or &kenvy24gui; won't work !

&documentation.index;