Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FVWMANIMATE(1)			  Fvwm Modules			  FVWMANIMATE(1)

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 Fvw-
     mAnimate  module,	you don't really have to know what any of the configura-
     tion commands are. This section describes them anyway.

     FvwmAnimate gets configuration info from fvwm's module configuration  data-
     base (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" (ex-
	 clusive ORed) onto the background. Depending on the  display  type  you
	 are  using,  the effect this causes will vary. Especially on 8-bit dis-
	 plays, it helps if the background is a solid color. You have to experi-
	 ment 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 ani-
	 mation.

     *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  au-
	 tomatically 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 num-
     bers 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

				   2026-06-27			  FVWMANIMATE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=FvwmAnimate&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help