The Blue Agave

VU Meter Plugin

Version 1.2
Copyright 2000, Craig Schimmel, all rights reserved



About The Plugin

The VU Meter plugin is a simulated analog VU meter visualization plugin for CL-Amp. It is intended for entertainment purposes only.

By default, it looks like this



but you can use your own bitmaps to change the appearance to something like this for example:



The outstanding example above has been provided by Mario Buchichio (moldava@chasque.apc.org). You can find Mario's graphics in the Samples directory - the files moldavaVU_back.jpg and moldavaVU_front.tga.




Requirements

  1. BeOS 5 or higher. It may or may not work with earlier versions.
  2. CL-Amp. It has been tested with version 3.6.



Installation and Use

Installation is pretty simple, just copy the plugin vis_VU Meter to the CL-Amp Plugins directory. Then, in CL-Amp, open the Plugins window (ALT-P or from the right click menu) and select the Visual tab. You should see an entry called A VU Meter. Activate the plugin and you're good to go.

If CL-Amp is running when you copy the plugin, you will need to restart it before the plugin will show up in the Visual Plugins window.

Once running, you can drag the window anywhere you like using the left mouse button. The right mouse button brings up the menu, which gives you quick access to the meter preferences and lets you close the meter. Aside from that, you just watch it.




Preferences

The preferences panel lets you control the needle movement, and the foreground and background bitmaps.

Performance Tab

Preferences Panel 1

Needle Rise/Fall Velocity
These sliders determine how fast the needles move toward the current signal value. The velocity values, along with the dampening value, control how quickly the needles respond to a change in the signal.


Lock Needle Velocities
If checked, it locks the two velocity sliders together so that rise and fall velocities are the same.


Responsiveness
This is essentially a frame rate control. Setting it on the "More" responsive side produces higher framerates, and higher CPU load. Setting it on the "Less" responsive side gives you less of both.


Dampening
The VU meter displays an averaged RMS value over time. This slider controls the time period used for the averaging. The resulting effect is to dampen the needle movement.


Gain
Increases the signal strength used to drive the needles.


Defaults
The Defaults button resets all values, including the default bitmaps on the Appearance tab, back to the factory fresh settings.


Appearance Tab



Background Image
Use this to set the bitmap which will be used as the background image of the meter. If the default background is selected, this is disabled. See the Bitmap Notes below for details about the bitmaps.


Foreground Image
Select a foreground bitmap. This bitmap needs to have transparent areas so that the background bitmap and needles can be seen. If the default foreground is selected, this option is disabled. See the Bitmap Notes below for details about the bitmaps.


Needle Color
This button brings up a color selection window, which lets you change the needle color.


Use Default Background and Foreground
If checked, the default background and/or foreground are used instead of any bitmap you selected.


Use White as Transparent
If checked, any pure white (red=255, green=255, blue=255) in the foreground image will become transparent. There are several reasons for using this instead of using alpha transparency. First, if you just want a transparent area, the meter will render faster using this instead of alpha. Second, not all graphics formats and editors support alpha. Remember that only pure white is replaced, close doesn't count. If your foreground image has alpha, then do not check this box or the alpha will be ignored.



Bitmap Notes
  • Bitmaps must be 100 pixels high, and 300 pixels wide.
  • The foreground bitmap can either use alpha, or can use white to designate transparent areas. Either way, there needs to be some transparency so the background and needles can be seen.
  • The needle base points are at (74,95) and (224, 95). The needles are 80 pixels long and move from -45 to +45 from center.
  • There are some example bitmaps in the Samples directory. TicMarks.tga is a sample background, and the files Orange.tga and Purple.jpg are sample foregrounds. Orange.tga usese alpha, while Purple.jpg uses white as transparent. There is also a file named outline.tga that shows the needle movement areas. These aren't intended to be great works of art, just examples. For some attractive bitmaps, Mario Buchichio's bitmaps are also included in the Samples directory.




Etc.

  • Send bug reports, etc. to: Blue_Agave@worldnet.att.net
  • Thanks to Claes Löfqvist for writing CL-Amp.
  • Thanks to Mario Buchichio for contributing his graphics talents.
  • The software, vis_VU Meter, and the accompanying documentation and images are, unlesss otherwise noted, copyright 2000, Craig Schimmel, all rights reserved. All files may be used and distributed freely for non-commercial use, provided that all original contents are included in the distributed package in unmodified form.

    The files moldavaVU_back.jpg and moldavaVU_front.tga are copyright 2000, Mario Buchichio.

    The software is provided "As Is", there is no warranty of any kind.