This is the Readme to the POVRAY3.0 files I used to generate
the "HiFi-X" Skin for the "Power PlugIn".

These files may be interresting to you if you want to generate your
own skins. E.g. the "magnet2.pov" and "magnet2.inc" files you want to use
(or use it slighlty changed) to generate speakers of your own size.

You may use or modify these files as long as you do not remove or change the copyright
notice on top of the files. If you modify one/some of the files and you want to
offer them, you must not remove or change the copyright notice, but you may explain
which parts of the file(s) you did alter.
In eighter case, if you want to offer one/some of these files, modified or not,
you must offer them for free !


Files:

  boxes.pov           The main PovRay scene file.
                       With this file, all images for the "HiFi-X" skin can be generated.
  boxes.ini           The INI file used for rendering non-animated images.
                       Use this to render
                       the 3Way-Box,
                       the Slider-Box,
                       the BigWoofer-Box (these are the 2 boxes on the left and right
                       of the music player window),
                       and the LightOrgan-Box (which I placed on top of the player window)
                       as well as the Organ-Boxes (which I placed on top of the player window).
  magnet.ini          Use this to animate the speakers for
                       the 3Way-Box (which has a Tweeter, a Medium Speaker and a Woofer),
                       and for the BigWoofer-Box.
  spklamps.ini        This file is not used any more. It was intended for lamps around
                       the speakers.
  subwf.ini           Use this to render the SubWoofer-Box (which I placed on bottom
                       of the music player window).
  subwfmagnet.ini     Use this to animate the speaker for the SubWoofer-Box.
  vlight.ini          Use this to animate the vertical lamps (on the left and right
                       side) of the 3Way-Box.
  readme.txt          this file
Following is a list of PovRay scene files which each will generate an 3D-object
to be included in "boxes.pov" (or you can use it in your own PovRay scene files):
See the description in those files (at the top of each file).
  conesec.pov
  ellamps1.pov
  ellcone.pov
  ellring.pov
  elltorus.pov
  lamps1.pov
  magnet2.inc
  magnet2.pov
  multcrnr.pov
  rndrect.pov
  rndtorus.pov
  roundbox.pov
  roundcyl.pov
  sinarea.pov
  torussec.pov









How I did generate the images for the "HiFi-X" skin:


In "boxes.pov" all variables named DRAW_* and ANIM_* which you can find on top
of the file before the first "------------------------------------------"
line, must be altered. All these variables are boolean variables (0 means false
and 1 means true).
Following is a list of the images or animations I did generate for the "HiFi-X"
skin. The list describes, which values these variables must have, and which
INI files to use.
The DRAW_* and ANIM_* variables which are not listed for a specific rendering
will be ignored and therefore you can set them to any value you want.

PLUS: The variables named WORLD_* which follow the DRAW_* and ANIM_* variables
also must be set or remarked out. Do *not* change their values because I did
adjust them so that they fit perfectly for the ModPlug and WinAmp player window
size. See the descriptions at the WORLD_* variables.

PLUS: The ASPECT_RATIO declaration must be *marked out* (so that it is not defined).
Except for generating images for the SubWoofer-Box, it should be declared, because
for the SubWoofer-Box, the INI file ("subwf.ini" and "subwfmagnet.ini") use
a width of 400 (or 800) which the height is not changed. This is be done because
the SubWoofer-Box has a large width.

NOTE: In all the ini files used below, you can set the "Output_File_Name" to
specify the filename(s) of the generated image(s).

- - - - - - - - - - - - - - - - - - - - - - - - -

3Way-Box

    variables:
      DRAW_AS_MASK = 0

      DRAW_3WAY_BOX = 1
      DRAW_BIGWOOFER_BOX = 0
      DRAW_SLIDER_BOX = 0
      DRAW_SUBWOOFER_BOX = 0
      DRAW_LIGHTORGAN = 0

      DRAW_3WAY_TWEETER = 1
      DRAW_3WAY_TWEETER_MAGNET = 0
      DRAW_3WAY_TWEETER_RING = 1
      DRAW_3WAY_TWEETER_LAMPS = 0
      DRAW_3WAY_MEDIUM = 1
      DRAW_3WAY_MEDIUM_MAGNET = 0
      DRAW_3WAY_MEDIUM_RING = 1
      DRAW_3WAY_MEDIUM_LAMPS = 0
      DRAW_3WAY_WOOFER = 1
      DRAW_3WAY_WOOFER_MAGNET = 0
      DRAW_3WAY_WOOFER_RING = 1
      DRAW_3WAY_WOOFER_LAMPS = 0
      DRAW_3WAY_HIGHPART = 1
      DRAW_3WAY_LOWPART = 1
      DRAW_3WAY_CASE = 1
      DRAW_3WAY_CASE_LEFT_LAMPS = 0
      DRAW_3WAY_CASE_RIGHT_LAMPS = 0
      ANIM_3WAY_CASE_LAMPS = 0

      ANIM_3WAY_SPK_LAMPS = 0

      DRAW_LAMPS_ON = 1

      DRAW_BLACK_BKGND = 0
      DRAW_DARK_RINGS = 0

      ANIM_MAGNET = 0

    INI File:
      Use "boxes.ini" and set

      Width = 320
      Height = 240
      ( or 640, 480 for WinAmp double size -> see WORLD_* variables )

      Antialias = On

- - - - - - - - - - - - - - - - - - - - - - - - -

Mask for 3Way-Box

    variables and like for "3Way-Box" except:
      DRAW_AS_MASK = 1

    INI File like for "3Way-Box" except:
      Antialias = Off

- - - - - - - - - - - - - - - - - - - - - - - - -

BigWoofer-Box

    Variables:
      DRAW_AS_MASK = 0

      DRAW_3WAY_BOX = 0
      DRAW_BIGWOOFER_BOX = 1
      DRAW_SLIDER_BOX = 0
      DRAW_SUBWOOFER_BOX = 0
      DRAW_LIGHTORGAN = 0

      DRAW_BIGWF_SPEAKER = 1
      DRAW_BIGWF_SPEAKER_MAGNET = 1
      DRAW_BIGWF_SPEAKER_RING = 1
      DRAW_BIGWF_SPEAKER_LAMPS = 0
      DRAW_BIGWF_PART = 0
      DRAW_BIGWF_CASE = 0

      ANIM_BIGWF_SPK_LAMPS = 0

      DRAW_LAMPS_ON = 1

      DRAW_BLACK_BKGND = 0
      DRAW_DARK_RINGS = 0

      ANIM_MAGNET = 0

    INI File:
      Use "boxes.ini" and set

      Width = 320
      Height = 240
      ( or 640, 480 for WinAmp double size -> see WORLD_* variables )

      Antialias = On

- - - - - - - - - - - - - - - - - - - - - - - - -

Mask for BigWoofer-Box

    variables and like for "BigWoofer-Box" except:
      DRAW_AS_MASK = 1

    INI File like for "BigWoofer-Box" except:
      Antialias = Off

- - - - - - - - - - - - - - - - - - - - - - - - -

Slider-Box

    Variables:
      DRAW_AS_MASK = 0

      DRAW_3WAY_BOX = 0
      DRAW_BIGWOOFER_BOX = 0
      DRAW_SLIDER_BOX = 1
      DRAW_SUBWOOFER_BOX = 0
      DRAW_LIGHTORGAN = 0

      DRAW_SLIDER_CASE = 1

      DRAW_BLACK_BKGND = 0

    INI File:
      Use "boxes.ini" and set

      Width = 320
      Height = 240
      ( or 640, 480 for WinAmp double size -> see WORLD_* variables )

      Antialias = On

- - - - - - - - - - - - - - - - - - - - - - - - -

Mask for Slider-Box

    variables and like for "Slider-Box" except:
      DRAW_AS_MASK = 1

    INI File like for "Slider-Box" except:
      Antialias = Off

- - - - - - - - - - - - - - - - - - - - - - - - -

SubWoofer-Box

    Variables:
      DRAW_AS_MASK = 0

      DRAW_3WAY_BOX = 0
      DRAW_BIGWOOFER_BOX = 0
      DRAW_SLIDER_BOX = 0
      DRAW_SUBWOOFER_BOX = 1
      DRAW_LIGHTORGAN = 0

      DRAW_SUBWF_SPEAKER = 1
      DRAW_SUBWF_SPEAKER_MAGNET = 0
      DRAW_SUBWF_SPEAKER_RING = 1
      DRAW_SUBWF_PART = 1
      DRAW_SUBWF_CASE = 1

      DRAW_BLACK_BKGND = 0
      DRAW_DARK_RINGS = 0

      ANIM_MAGNET = 0

    INI File:
      Use "subwf.ini" and set

      Width = 400
      Height = 240
      ( or 800, 480 for WinAmp double size -> see WORLD_* variables )

      Antialias = On

    Plus:
      The ASPECT_RATIO variables must be set to 400/240

- - - - - - - - - - - - - - - - - - - - - - - - -

Mask for SubWoofer-Box

    variables and like for "SubWoofer-Box" except:
      DRAW_AS_MASK = 1

    INI File like for "SubWoofer-Box" except:
      Antialias = Off

- - - - - - - - - - - - - - - - - - - - - - - - -

LightOrgan-Box

    Variables:
      DRAW_AS_MASK = 0

      DRAW_3WAY_BOX = 0
      DRAW_BIGWOOFER_BOX = 0
      DRAW_SLIDER_BOX = 0
      DRAW_SUBWOOFER_BOX = 0
      DRAW_LIGHTORGAN = 1

      DRAW_LTORG_CASE = 1

      DRAW_BLACK_BKGND = 0

    INI File:
      Use "boxes.ini" and set

      Width = 320
      Height = 240
      ( or 640, 480 for WinAmp double size -> see WORLD_* variables )

      Antialias = On

- - - - - - - - - - - - - - - - - - - - - - - - -

Mask for LightOrgan-Box

    variables and like for "LightOrgan-Box" except:
      DRAW_AS_MASK = 1

    INI File like for "LightOrgan-Box" except:
      Antialias = Off

-------------------------------------------------

And now for the animations:

To generate the animated speakers (the images itself
as well as the mask images),
you should use the variables and ini-file settings as
described for the appropriate box above, except:

      ANIM_MAGNET = 1

      Plus set the DRAW_*_CASE and DRAW_*_PART and
      DRAW_*_LOWPART and DRAW_*_HIGHPART varaibles to 0.

      DRAW_3WAY_TWEETER = 0
      DRAW_3WAY_MEDIUM = 0
      DRAW_3WAY_WOOFER = 0
      DRAW_BIGWF_SPEAKER = 0
      DRAW_SUBWF_SPEAKER = 0

      plus use the "magnet.ini" instead of the "boxes.ini".
      For SubWoofer-Box: Use "subwfmagnet.ini" instead of "subwf.ini".

  To generate the images (not the masks):

      DRAW_AS_MASK = 0

      Plus set the DRAW_*_MAGNET and DRAW_*_RING varaibles to 1.

      DRAW_BLACK_BKGND = 1
      DRAW_DARK_RINGS = 1

  To generate the masks:

      DRAW_AS_MASK = 1

      Plus set the DRAW_*_MAGNET variables to 1
      and DRAW_*_RING variables to 0.

      (Do not forget to switch off AntiAliasing because a
      mask image should contain only 2 colors: white and black).

- - - - - - - - - - - - - - - - - - - - - - - - -

To generate the animated vertical lamps on the left and right
of the 3Way-Box,
you should use the variables and ini-file settings as
described for the 3Way-Box above, except:

      DRAW_3WAY_TWEETER = 0
      DRAW_3WAY_TWEETER_MAGNET = 0
      DRAW_3WAY_TWEETER_RING = 0
      DRAW_3WAY_TWEETER_LAMPS = 0
      DRAW_3WAY_MEDIUM = 0
      DRAW_3WAY_MEDIUM_MAGNET = 0
      DRAW_3WAY_MEDIUM_RING = 0
      DRAW_3WAY_MEDIUM_LAMPS = 0
      DRAW_3WAY_WOOFER = 0
      DRAW_3WAY_WOOFER_MAGNET = 0
      DRAW_3WAY_WOOFER_RING = 0
      DRAW_3WAY_WOOFER_LAMPS = 0
      DRAW_3WAY_HIGHPART = 0
      DRAW_3WAY_LOWPART = 0
      DRAW_3WAY_CASE = 0

      ANIM_3WAY_CASE_LAMPS = 1

      DRAW_LAMPS_ON = 1

      DRAW_BLACK_BKGND = 1

      To generate the left lamps set
        DRAW_3WAY_CASE_LEFT_LAMPS = 1
        DRAW_3WAY_CASE_RIGHT_LAMPS = 0
      else for the right lamps set
        DRAW_3WAY_CASE_LEFT_LAMPS = 0
        DRAW_3WAY_CASE_RIGHT_LAMPS = 1

      Plus use "vlight.ini" instead of "boxes.ini"
      with AntiAliasing switched ON.

For these images, masks are not necessary because the total black background
color can be interpreted as transparent.

- - - - - - - - - - - - - - - - - - - - - - - - -
