Прежде, чем изучать этот FAQ, убедитесь, что у вас последняя версия AVS (на данный момент v.2.8.1 - проверьте plug-ins лист или AVS about, чтобы увидеть какую версию Вы имеете). Вы можете получить эту версию AVS, загрузив последнюю версию Winamp (Standard или Full).

AVS - это плагин визуализации, который не ограничен встроенными эффектами: пользователь может без ограничений комбинировать библиотеку эффектов, чтобы создать, так называемый, пресет. Есть множество пресетов, доступных для загрузки в интернете, большинство из которых намного лучше, чем default пресеты (they're a bit outdated). Чтобы увидеть пресеты, запустите AVS как любой другой плагин и кликните правой кнопкой на дисплее. Затем Вы можете выбрать из всех установленных пресетов.

Прежде всего, Вы должны быть в Windowed или Docked режиме (не Fullscreen). Затем, кликните мышью и выберите AVS Editor: должен будет открыться диалог конфигурации. Из меню Вы можете получить доступ ко всем опциям, которыми обеспечивается AVS. Они, по большей части, не требут разъяснений. Сложные опции включены в раздел специфических вопросов.

Чтобы включить/выключить это, Вы должны сначала открыть диалог конфигурации (см. #2). Затем, перейти в меню Settings, и нажать Presets/Hotkeys. Теперь измените on/off переключатель Randomly switch presets. Имейте в виду, что AVS никогда не станет менять пресет, пока открыт диалог конфигурации, даже когда это включено. Убедитесь, что это выключено, во всяком случае, когда создаёте пресет, из-за того, что Вы таким образом можете легко потерять несохранённый пресет.

Сначала запустить AVS и открыть диалог конфигурации (см. #2). Теперь нажмите меню Settings, и затем Display. Справа должен появиться бокс Оверлейный режим (Overlay mode). Отметьте его, и включите Set desktop to color, теперь Вы должны видеть фон AVS на рабочем столе. Если Вы ничего не видите, попробуйте убрать обои с рабочего стола, и отключите Active Desktop. Обе настройки могут быть сделаны через Display panel на Панели управления. Если Вы видите AVS, но это выглядит как смесь точек, Вы вероятно работаете в 16-bit цветовом режиме (High Colour). Overlay-colour не может правильно отображаться в 16-bit, и Windows показывает точки ближайших цветов, чтобы дать Вам впечатление правильного цвета. Попробуйте другой (немного более яркий или более темный) оверлейный цвет, или переключите на 24-bit/32-bit (True Colour).

Откройте диалог конфигурации (см. #2). Слева Вы должны увидеть древовидную структуру - это описание загруженного в данный момент пресета: AVS применяет каждый эффект сверху вниз, и затем отображает результат. Результат направляется обратно вверх для следующего фрейма.
Есть 3 кнопки: "+,-,x2" - они для добавления, удаления и дублирования выбранного эффекта.

Каждый эффект AVS отличается. Большинство довольно просты, но другие нет. Некоторые даже позволяют Вам программировать ваши собственные математические уравнения для движения, цвета или формы. Полное изучение использования AVS - занятие требующее времени, и Вы не должны ожидать, что узнаете всё это за один день.

The Superscope
http://forums.winamp.com/showthread.php?threadid=61119
The Dynamic Movement
http://forums.winamp.com/showthread.php?threadid=64660
Variables in AVS code (Superscopes, Dynamic Movements, etc.)
http://forums.winamp.com/showthread.php?threadid=68527
Explanation of some concepts of 3D SuperScopes, and the relationship between AVS code and mathematical equations
http://forums.winamp.com/showthread.php?threadid=66395
Short refresher of trigonometry
http://forums.winamp.com/showthread.php?threadid=61847
Huge thread containing lots of code and some beginner tutorials:
http://forums.winamp.com/showthread.php?threadid=87661
Code that approximates the built-in movements (useful for learning to code):
http://forums.winamp.com/showthread.php?threadid=70899

APE - это сокращение от AVS Plug-in Effect. Как предполагает название, они есть дополнительные эффекты для AVS, сделанные другими программистами. Нет официального набора APE, но Вы можете найти список большинства APE здесь. Проверьте последнюю страницу этого обсуждения для получения самых последних версий:
http://forums.winamp.com/showthread.php?threadid=90097

Ответ простой: никак. AVS использует только CPU, так что 3D графическая карта не поможет. Вот некоторые способы ускорения:
- Работайте в 32-bit режиме. Это может звучать странно, но 32-bit глубина цвета намного быстрее, чем 16-bit в AVS. Дело в том, что всё вычисляется непосредственно в 32-bit, так что любой другой режим требует преобразовывания каждого фрейма изображения.
- Работайте в низком разрешении. Если ваша видео-карта не поддерживает разрешения вида 320x240 или 400x300 в 32-bit, то Вы можете использовать pixel-doubling. Это эффективно уменьшает вдвое фактическое разрешение (например, 640x480 pixel-doubled - это то же самое, что 320x240).
- Выключите другие программы или работающие фоновые процессы.

Короткий ответ: Аппаратное ускорение AVS не производится. Не сейчас, и не в ближайшее время. Длинный ответ: Это не просто... изготовители видео карт хотели бы, что Вы верили, что ваша новая карта может что-нибудь делать, но истина в том, что она все ещё "dumb" машина, разработанная для специфических целей. Есть множество графических-заданий, которые графические карты делать не могут, например raytracing или voxel rendering. И в первую очередь, это AVS's component model, где каждый компонент может делать всё, что хочет, а это не подходит для графических карт. Hardware accelerated приложения требуют специфического направление потока в программы, которое использует их. В противном случае программны выполняются также медленно, как software графика. Не возможно просто добавить аппаратное ускорение к AVS, а именно различные части приложения должны быть переписаны и пересмотрены. Результат более бы не был совместимым со старым AVS, и это было бы крупным проектом, требующим массы умения, времени и средств.

AVS не имеет эту функцию как встроенную, но к настоящему времени есть два APE, которые могут захватить видео AVS в файл AVI. После вставки APE в конце пресета, который Вы хотите захватить, Вы можете конфигурировать и управлять им через диалог конфигурации (на правой стороне). Имейте в виду, что они позволят Вам захватывать только один пресет за один раз, и не захватит переходы transitions. Если у вас есть проблема с одним из этих APE, Вы должны вероятно обращаться к автору APE, а не спрашивать в форумах.

Легчайший путь - использовать для этого PimpBot by Yathosho (Jan T. Sott). Эта программа упакует ваши пресеты автоматически. Если Вы начинающий художник, то наилучший способ отправить вашу работу в форум AVS Presets - это обычный zip пакет. Люди, которые также являются AVS художниками, могут дать полезные рекомендации как улучшить ваши пресеты.

Создать APE не легко, так что Вы, в первую очередь, должны быть хорошим программистом. APE написаны в C++ и являются Windows DLL файлами. Прежде всего, Вам нужна APE SDK, которую Вы можете загрузить здесь. Это базовый пример APE. Загрузите код в вашу программу разработки (вероятно Visual Studio), создайте DLL проект и откомпилируйте его. Переименуйте ваш файл DLL в файл APE и скопируйте его в директорию AVS. Если Вы хотите более сложный пример, то можете загрузить source code Render / Picture II APE. Он содержит некоторые оптимизации для SDK (как, например, configuration handling) и fast MMX assembly code для всех режимов AVS blend. И, наконец, запомните, что сила AVS в способности подключать всё вместе. Попытайтесь не делать APE, который работает только на одном конкретном эффекте, лучше сделать нечто, что полезно во многих ситуациях и/или настраивается во многих случаях.

Из описания AVS function:
getkbmouse(which_parm)
= returns information about the location and state of the keyboard or mouse
which_parm = 1: mouse X position (-1..1 is onscreen)
which_parm = 2: mouse Y position (-1..1 is onscreen)
which_parm = 3: mouse left button state (0 up, 1 down)
which_parm = 4: mouse right button state (0 up, 1 down)
which_parm = 5: mouse middle button state (0 up, 1 down)
which_parm > 5: (GetAsyncKeyState(which_parm)&0x8000)?1:0

Последняя часть вероятно не ясна. Чтобы это использовать, Вам нужно искать virtual key code для particular key. Величина return value будет 0 для "key is up" и 1 для "key is down". Вы можете загрузить список всех ключевых кодов здесь. Имейте ввиду, что этот список использует hexadecimal шестнадцатеричные величины, так что вам понадобится преобразовывать их в decimal десятичные (в голове или используя калькулятор).

Question #1a: What is AVS?
Question #1b: I downloaded a bunch of AVS plug-ins/presets, but they don't show up in the Winamp plug-ins list!
AVS is a visualisation plug-in that isn't limited to predefined effects: the user can combine the library of built-in effects in endless ways to create so-called presets. There are tons of presets available for download on the web, most of which are a lot better than the default presets (they're a bit outdated).
To view these presets, start AVS like any other plug-in and right-click the display. You can then choose from all the presets installed.

Question #2: How can I configure AVS?
First of all, you need to be in Windowed or Docked mode (not Fullscreen). Then, right-click the AVS display and choose 'AVS Editor': the configuration dialog should open up. From the menus available, you can access all the options that AVS provides. These are mostly self-explanatory, but the difficult ones are covered in specific questions.

Question #4a: AVS keeps changing the visuals every X seconds. How can I turn this off?
Question #4b: AVS keeps showing the same visual. How can I make it change presets regularly?
To turn this on/off, you have to open the configuration dialog first (see Question #2). Then, go to the 'Settings' menu at the top, click 'Presets/Hotkeys'. Now, turn on/off the checkbox marked 'Randomly switch presets'.
Note that AVS will never cycle presets while the configuration dialog is open, even when this is turned on. Make sure that this is turned off anyway when creating presets, because you could easily lose an unsaved preset this way.

Question #5: I saw someone who had AVS running as his animated desktop background! How is this possible?
First, start AVS and open up the configuration dialog (see Q#2). Now, click the 'Settings' menu, and then 'Display'. On the right-hand side, a box labeled 'Overlay mode' should appear. Enable this, and check 'set desktop to color', you should now have an AVS desktop background.
If you don't see anything, try removing any desktop wallpaper you may have and turning off Active Desktop. Both can be done through the Display panel in the Windows Control Panel.
If you do see AVS, but it's covered in a bunch of dots, you're probably running in 16-bit colour mode (High Colour). The overlay-colour that is used can't be properly displayed in 16-bit, and so Windows draws dots of the nearest colours to give you the impression of the right colour. Try a different (slightly brighter or darker) overlay colour, or switch to 24-bit/32-bit (True Colour).

Question #6: How can I make my own presets?
Open the configuration dialog (see Q#2). In the configuration dialog, you should see a tree-view on the left hand side. This is an overview of the currently loaded preset: AVS will apply each effect from top to bottom, and then display the result. The result is fed back into the top for the next frame.
There are 3 buttons (+, -, x2): these are for adding an effect, removing an effect and duplicating the currently selected effect. See Q#5 for details about the effects.

Question #7: I don't understand what a particular effect does! Where can I find an explanation?
Every AVS effect is quite different. Most are fairly straightforward, but others aren't. Some even allow you to program your own mathematical equations for movement, colour or shape.
Beginners should read the excellent AVS tutorial by pIR. It contains a detailed explanation of every AVS effect:
http://perso.club-internet.fr/pcharpen/avs/avs2_tut_en.pdf
Here are some guides on various topics that should help you as well. Learning how to use AVS to its fullest is a time consuming hobby, and you shouldn't expect to know all of it in one day.

Question #9: AVS is incredibly slow on my computer! How can I speed it up?
The answer is simple: you can't. AVS only uses your CPU, so having a fast 3D graphics card won't help much. Here are some tips in speeding it up:
- Run in 32-bit mode. This might sound weird, but 32-bit color depth is a lot faster than 16-bit in AVS. This is because everything is calculated at 32-bit internally, so any other mode requires the image to be converted each frame.
- Run in a low resolution. If your video-card doesn't support resolutions like 320x240 or 400x300 at 32-bit, you can use pixel-doubling. This effectively halves the actual resolution (e.g. 640x480 pixel-doubled is the same as 320x240).
- Turn off any other programs or background processes that are running.

Question #10: This is stupid. Why doesn't AVS use my videocard? It's a graphics program, isn't it?
Short answer: Hardware accelerated AVS isn't going to happen. Not now, and not anytime soon.
Long answer:
It's not that simple... video-card manufacturers would like you to believe that your shiny new card can do anything, but the truth is that it is still a 'dumb' machine designed for specific purposes. There are many graphics-tasks that graphics cards can't do, for example raytracing or voxel rendering.
On top of that, AVS's component model (where every component can do anything it wants) is not suited for graphics cards. Hardware accelerated applications require specific streamlining in the programs that use them: otherwise the program runs just as slowly as software graphics.
It is not possible to simply add hardware acceleration to AVS: several portions would need to be rewritten and rethought. The result would not be compatible with the old AVS anymore. And it would be a major project requiring lots of skill, time and dedication.
For more in-depth discussions on the hardware acceleration issue, check the following topics:
http://forums.winamp.com/showthread.php?threadid=159933
http://forums.winamp.com/showthread.php?threadid=87279
http://forums.winamp.com/showthread.php?threadid=70823
http://forums.winamp.com/showthread.php?threadid=77753
http://forums.winamp.com/showthread.php?threadid=66004

Question #12: How can I capture the output of AVS as a video/movie file?
AVS doesn't have this function built-in, but there are currently 2 APEs (AVS plug-in effects, see Question #5) that can capture the video of AVS to an .AVI file. After inserting one them at the end of the preset you want to capture, you can configure and control it through the component's configuration dialog (on the right hand side).
Note that these will only allow you to capture one preset at a time and will not capture transitions. If you have a problem with one of these, you should probably contact the author of the APE rather than posting your question in these forums.

Question #14: I'd like to distribute my presets as a downloadable pack. How can I create a self-installing EXE?
The easiest way to do this is to use PimpBot, by Yathosho (Jan T. Sott). This program will package your presets automatically:
http://forums.winamp.com/showthread.php?threadid=156861
Note: if you are a beginning artist, it's best to post your work in the AVS Presets forum as a regular zipped package first. The people there are also AVS artists and can give you useful tips on how to improve your presets.

Question #15: I'd like to develop my own APEs. How can I get started?
Making an APE is not easy, so you have to be a good programmer first. APEs are written in C++ and are Windows DLL files. First of all, you'll need the APE SDK, which you can download here
This is an example of a very basic APE. Load up the code in your development program (probably Visual Studio), create a DLL project and compile it. Rename your DLL file to a .APE file and copy it into the AVS directory.
If you want a more complicated example, you can download the source code of the Render / Picture II APE here. It contains some optimizations to the SDK (such as configuration handling) and fast MMX assembly code for all the AVS blend modes.
And finally, remember that the power of AVS lies in its ability to plug stuff together. Try not to make an APE that is only suited to one particular effect, but rather make something that is useful in a lot of situations and/or is customizable in many ways.

Question #16: How does the getkbmouse() function work? What does the parameter mean?
From the AVS function reference:
getkbmouse(which_parm)
= returns information about the location and state of the keyboard or mouse
which_parm = 1: mouse X position (-1..1 is onscreen)
which_parm = 2: mouse Y position (-1..1 is onscreen)
which_parm = 3: mouse left button state (0 up, 1 down)
which_parm = 4: mouse right button state (0 up, 1 down)
which_parm = 5: mouse middle button state (0 up, 1 down)
which_parm > 5: (GetAsyncKeyState(which_parm)&0x8000)?1:0
The last part is probably unclear. To use it you need to look up the virtual key code for a particular key. The return value will be 0 for 'key is up' and 1 for 'key is down'.
You can download a list of all key codes here. Note that this list uses hexadecimal values, so you will need to convert them to decimal (in your head, or using Windows's calculator).