Man Linux: Main Page and Category List

NAME

       FvwmAnimate - the fvwm animate module

SYNOPSIS

       Module FvwmAnimate [ModuleAlias]

       FvwmAnimate  can  only  be invoked by fvwm.  Command line invocation of
       the FvwmAnimate module will not work.

       From within the .fvwm2rc file, FvwmAnimate is spawned as follows:

       Module FvwmAnimate

       or from within an fvwm pop-up menu:

       DestroyMenu Module-Popup
       AddToMenu   Module-Popup "Modules" Title
       + "Fvwm Animate Icons" Module FvwmAnimate ModuleAlias

DESCRIPTION

       The FvwmAnimate module animates iconification and  de-iconification  or
       on command.  There are currently 6 different animation effects.

INVOCATION

       FvwmAnimate  must  be invoked by the fvwm window manager.  When invoked
       with the  OptionalName  argument,  the  ModuleAlias  is  used  to  find
       configuration  commands,  configuration  files, and name the internally
       generated menus and forms instead of  "FvwmAnimate".   During  startup,
       FvwmAnimate  defines  menus  and  forms for configuring and controlling
       FvwmAnimate.  The default menu name is "MenuFvwmAnimate" and  the  form
       name  is  "FormFvwmAnimate".   If  the  optional name is used, the menu
       would be "Menu<ModuleAlias>" and the form would be "Form<ModuleAlias>".

       Assuming  you  already  had  a  builtin menu called "Module-Popup", you
       could use FvwmAnimate by configuring it like this:

       AddToFunc "StartFunction" "I" Module FvwmAnimate
       AddToMenu "Module-Popup" "Control Animation" Popup MenuFvwmAnimate

CONFIGURATION OPTIONS

       Since the pop up menu "MenuFvwmAnimate" allows complete control of  the
       FvwmAnimate  module,  you  don’t  really  have  to know what any of the
       configuration commands are.  This section describes them anyway.

       FvwmAnimate gets configuration info from  fvwm’s  module  configuration
       database   (see   fvwm(1),  section  MODULE  COMMANDS).   In  addition,
       FvwmAnimate reads the file  $HOME/.FvwmAnimate,  and  accepts  commands
       from fvwm and its modules as it runs.

       If ModuleAlias is used to  start FvwmAnimate, the optional name is used
       in all commands,  messages, menus and forms generated  by   FvwmAnimate
       and  in the configuration file name.   Unlike other fvwm modules, there
       is little reason to use the optional name.

       *FvwmAnimate: Color color
              Tells FvwmAnimate  what  color  to  draw  with.   The  color  is
              "XOR’ed" (exclusive ORed) onto the background.  Depending on the
              display type you are using,  the effect this causes  will  vary.
              Especially  on  8-bit  displays, it helps if the background is a
              solid color.  You have to experiment with this  to  see  how  it
              works.

              The  default  color  is not really a color and can be entered as
              "Black^White", or more simply "None".  This is the same  as  the
              default XOR mask used by fvwm for move and resize frames.

              Other  colors  can be specified using standard X color notation.
              Ie. color names like "LightBlue", or RGB values like  "#FFFFFF".

       *FvwmAnimate: Pixmap pixmap
              Tells FvwmAnimate to use pixmap to draw with. This can be useful
              if *FvwmAnimate: Color gives poor results.

       *FvwmAnimate: Delay msecs
              Tells FvwmAnimate how many milliseconds to sleep between  frames
              of animation.

       *FvwmAnimate: Iterations iterations
              Tells FvwmAnimate how many steps to break the animation into.

       *FvwmAnimate: Twist twist
              Tells   FvwmAnimate   how   many   revolutions   to   twist  the
              iconification frame.

       *FvwmAnimate: Width width
              Tells FvwmAnimate how wide a line to  draw  with.   The  default
              width of 0 (zero) is a fast line of Width 1.

       *FvwmAnimate: Effect mode
              Tells  FvwmAnimate which animation effect to use.  Currently the
              effects are: Frame, Lines, Flip, Turn, Zoom3D, Twist Random, and
              None.   None  is normally set in the configuration file, in-case
              FvwmAnimate is started automatically,  but  an  individual  user
              doesn’t want it running.

       *FvwmAnimate: Stop
              Tells FvwmAnimate to stop.

       *FvwmAnimate: Save
              Tells  FvwmAnimate  to  save the current configuration in a file
              named ".FvwmAnimate" in the users  home  directory.   This  same
              file is read automatically by FvwmAnimate during startup.

COMMANDS

       FvwmAnimate   can   be   asked   to   produce  an  animation  thru  the
       "SendToModule" command.  The format of the command is:

            SendToModule FvwmAnimate animate sx sy sw sh dx dy dw dh

       The second word must match the name FvwmAnimate is started with.  The 8
       fields  after  animate must be numbers.  The first 4 are for the source
       (or starting) location of the  animation.   The  last  4  are  for  the
       destination  of  the  animation.   The  2 pairs of 4 numbers, represent
       rectangles.  The first 2 numbers are the x and y location of the  upper
       right  corner.   The  next  2 numbers are the width and height.  One or
       more spaces can separate the fields in the command.

       Modules can use the "SendToModule" command to animate "NoIcon" windows,
       or  you  can  think up your own ways to have all kinds of fun with this
       command.

       Additional available commands are: pause, play, push,  pop  and  reset.
       These may be space separated.

       pause  causes a module to not temporarily produce any animations.  play
       causes a module to produce an animation again.  push stores the current
       playing  state  for  a  future  and pop restores it.  reset removes all
       stored states and sets playing on.

       Suppose, we don’t want to wait for all 40 xterms to be animated:

            SendToModule FvwmAnimate pause
            All (XTerm) Iconify on

       And if we don’t want to damage the current playing state, then:

            SendToModule FvwmAnimate push pause
            All (XTerm) Iconify on
            SendToModule FvwmAnimate pop

ORIGIN

       FvwmAnimate is based on the  Animate  module  from  Afterstep  1.5pre6.
       Porting  to  fvwm  and  lots  of  other  changes were done by Dan Espen
       <despen@telcordia.com>.    Below   are   the   original   author    and
       acknowledgments.

AUTHOR

       Alfredo Kengi Kojima <kojima@inf.ufrgs.br>

ACKNOWLEDGMENTS

       These people have contributed to FvwmAnimate:

       Kaj Groner <kajg@mindspring.com>
              Twisty iconification, configuration file parsing, man page.

       Frank Scheelen <scheelen@worldonline.nl>