Frequently Asked Questions
- What is WhiteCap?
- WhiteCap graphically visualizes music, producing video in real-time that's
responsive to an audio signal. WhiteCap exists as an add-on to audio players
(ie "plugin") and as a standalone application that uses "line-in" input. WhiteCap
is designed to entertain you on its own but allows many ways for you to customize
it.
- What are the system requirements?
- WhiteCap only requires a fast computer and doesn't require 3D or other special
video hardware. It's recommended you have at least a PII or G3 processor.
If you plan to use WhiteCap as a plugin to your audio player, you need to
have the player already installed, and if you plan to use the standalone version
of WhiteCap (to visualize line-in audio) then you don't need anything more.
- Can WhiteCap visualize "line-in" audio?
- Yes. The first method is to simply use the standalone version of WhiteCap
that's included. See the WhiteCap Standalone
section for more. The second method to visualize line-in audio is some audio
players allow you monitor line-in audio. For example, in Winamp go to "Open
Location" and enter "linein://", and in SoundJam select "Play From Sound Input".
- How do I customize WhiteCap?
- After you run WhiteCap for the first time, search for a text file named
"WhiteCap Prefs". This file is a list of parameters that determine
WhiteCap's behavior in a text format that allows you to edit it. Use any text
editor to view the prefs file, and you'll easily see the kinds of parameters
found in it. Examples are: the most recent window position, the default font,
and how often track text information appears. All the parameters are listed
and described in the Customizing WhiteCap
section.
-
- How do I change the fullscreen resolution settings?
- Your display device may show WhiteCap best in a resolution other than the
default fullscreen resolution (640 x480). 640 x 480 was chosen as the default
because most monitors and projectors show it well, it's the most compatible,
and it's a fair burden for a typical PC setup. If you have a faster setup
or use a display device that only supports a certain resolution, you'll want
to change your fullscreen resolution settings. Quit WhiteCap, search your
system for the "WhiteCap Prefs" file, open it in a text editor,
carefully edit the values in FS_X and FS_Y to the dimensions you desire, and
save the changes. Note: FS_X and FS_Y specify a device resolution, so you
can't set them to any values you feel like (common display resolutions are
800 x 600, 1024 x 768, and 1280 x 1024). The Customizing
WhiteCap section contains related information and discusses the prefs
file in full. Also see the following two questions.
-
- How do I select what display device G-Force uses for fullscreen mode?
- Whatever display device the centerpoint of the WhiteCap window sits on is
the device WhiteCap will use for fullscreen mode. For example, if you have
a LCD projector and want WhiteCap to use it as the fullscreen device (ie,
not the monitor), first drag the WhiteCap window so it's in the projector
screen rectangle, then start fullscreen mode.
- How do I undo/reset changes I've made to WhiteCap?
- You may accidentally edit some settings in the prefs file that causes problems.
If you delete the prefs file, WhiteCap will create a fresh prefs file with
"factory" settings the next time it starts. Because WhiteCap writes its prefs
file when it exits, you must delete the prefs file when WhiteCap isn't running.
- How do I store a good looking config and recall it?
- Sometimes, you may spot a config you really like. WhiteCap allows you to
"save" the current config for later recall by writing out a script
that switches to the given config when the script run.
- To save the currently running config as a key on your keyboard, press
CTRL+SHIFT and the key you want associated with the script.
- To run the script, press CTRL and the key you used to store the script.
For example, suppose you chose '8' to be associated with a config (ie, you
pressed CTRL+SHIFT+8). The above steps makes WhiteCap generate a text file
named "8 Key" inside your "Scripts" folder. When you now press CTRL+8, WhiteCap
will search for a script named "8 Key" to run. Scripts are capable of much
more, but this method is meant to be an easy way to store and recall appealing
combinations of configs. See the Scripting WhiteCap
section for more.
- Where can I get more WhiteCap config files?
- The folder "More WhiteCap Configs" inside the "WhiteCap Files"
folder contains more configs users have sent in. Now that there's so many
configs for WhiteCap, only the sharpest and most original submitted configs
make it to the "Configs" folder, but the ones in "More WhiteCap
Configs" still definitely stand out. You can try these configs by simply moving
them into the "Configs" folder.
- Can I make WhiteCap into a screensaver?
- First become familiar with the Customizing
G-Force section. The 'SSvr' parameter tells WhiteCap to go fullscreen
after a given number of idle minutes, so edit your "WhiteCap Prefs"
file accordingly.
- Can I make my own WhiteCap config files?
- If you want to learn the language G-Force and WhiteCap use in their config
files, you should already have some familiarity with programming or script
writing of some sort. The more programming or script experience you have,
the easier you'll learn the config language. See the Config
Programming section.
- What color depth is best?
- In window mode, you get the best color quality from 32 (or 24--same thing)
bit mode). You set what depth WhiteCap attempts to set your display to when
it goes fulscreen via the 'FS_D' parameter in your prefs file. By default,
FS_D is set to 16, yielding a slightly higher frame rates at the cost of some
color quality. Try setting FS_D to 32 for a little better color quality, but
be aware some audio players force plugins to 32 bit mode anyway. Remember
to avoid having changes to your prefs file overwritten by editing it only
when WhiteCap is closed.
- Can I resize the WhiteCap window?
- Drag near the bottom right of the window.
- Why should I send in feedback, bug reports, or configs?
- WhiteCap can't improve unless you send me ideas, feedback, and bug reports.
Most of the features added to WhiteCap and G-Force in the last year started
out as user comments. When WhiteCap was first released, it came with about
20 configs. Today, thanks to users who sent in configs they made, 160 configs
now come with WhiteCap. If you submit new configs, you'll make WhiteCap that
much better for everyone else.
- Can I control how much of my CPU goes to WhiteCap?
- The 'FPS' parameter in your preferences allows you to specify a desired
frame rate. Note that it takes several seconds for WhiteCap to approach the
frame rate you have set in the FPS parameter, so be patient when you resize
its window (or do anything that significantly changes its load on your system).
See the Customizing WhiteCap section.
- How do I pre-plan/script a WhiteCap performance for a particular audio
track?
- Using WhiteCap's scripting services provides some exciting ways to synchronize
events in WhiteCap with events in audio tracks. See the following question
and read the Scripting WhiteCap section.
- How do I coordinate the start of an audio track or WhiteCap capture with
a script?
- Whenever a new audio file is played in your audio player, WhiteCap will
look for a script or config file with a matching name. If the audio track
is an mp3 file and internally defines the track name (ex, ID tag data), then
WhiteCap will use that instead of its filename. For example, suppose you have
a script that's made to go with a file named "Andy Sings Opera.wav", and it's
written so that 0:00 corresponds to the start of the audio file. Rename your
script to "Andy Sings Opera" (remember: extensions are ignored in WhiteCap),
restart WhiteCap, play the audio file, and WhiteCap will automatically start
the script. The Scripting WhiteCap section describes
scripts in detail, allowing you to coordinate WhiteCap with an audio track
in exciting ways.
-
- How do I display multiple configs at the same time?
- Make a folder in the "Configs" folder and move the config files you want
to be displayed at the same time inside that folder. See "RGB Rave" as an
example.
- Can I edit configs while WhiteCap is running?
- If you develop your own configs, you'll need to test them out as you go
along. However, WhiteCap caches its files when it starts up, so changes to
config files won't have any affect until you restart WhiteCap. However, you
can get WhiteCap to load a fresh copy of a config from disk by pressing the
key that "reloads current configs." Pressing this key will cause WhiteCap
to reload the currently running config from disk.
- Could G-Force benefit from MMX (for Pentiums) or Altivec (for G4s)?
- Two-thirds of the CPU power that goes to WhiteCap is spent mostly running
WhiteCap's virtual machine (the thing that makes "running" configs possible).
These hardware technologies can't be used here to get an increase in performance.
However, 3D hardware could aid in the 3D rendering, but it the overhead wouldn't
be worthwhile for just wireframe rendering. In other words, until WhiteCap
uses intensive 3D effects (surface rendering, etc), 3D hardware isn't worth
using. Also, understand that OpenGL is a professional technology. To use it
properly, professionally, and effectively one needs a lot of experience. When
you use commercial 3D software, remember you're using software made by an
army of highly paid engineers.
- What was used to make G-Force and WhiteCap?
- Both are written in C++ and compiled using Metrowerks
Codewarrior, a C/C++ development environment that beats the pants of Microsoft
Visual Studio. Both G-Force and WhiteCap have evolved over the course of two
years and contain many intricate parts.
-