Page 1






VkMovieButton(3x)					     VkMovieButton(3x)

NAME    [Toc]    [Back]

     VkMovieButton - A multimedia button component that	plays a	movie

INHERITS FROM    [Toc]    [Back]

     VkComponent : VkCallbackObject

HEADER FILE    [Toc]    [Back]

     #include <Vk/VkMovieButton.h>

MAKE REQUIREMENTS    [Toc]    [Back]

     -lmovieGL -laudio -lcl -ldmedia -lGL -lGLw	-lGLU

PUBLIC PROTOCOL	SUMMARY
   Constructor/Destructor
	   VkMovieButton(const char *name,
			 Widget	parent,
			 char *movieFileName = NULL,
			 char *label=NULL);

	   virtual void	~VkMovieButton(void);


   Set Text Label Value    [Toc]    [Back]
	   void	setLabel(char* labelString);


   Specifying a	movie
	  void VkMovieButton::setMovieFileName(const char *file)

   Turn	Off Sound
	   void	setMute(Boolean	bMuteOn);

CLASS DESCRIPTION    [Toc]    [Back]

	   This	class displays a movie within a	pushable button. When the
	  movie	is single- or double-clicked, the movie	plays (complete	with
	  an audio track, if available)	and any	callback associated with the
	  button is invoked. This class	is most	effective with a short movie
	  that acts as an animation. A series of VkMovieButton objects could
	  be used to act as a multimedia "launchpad", whereby the latency
	  period for running an	associated application is spent	viewing	the
	  particular movie the user clicked on.

	  The size of the button is determined by the size of the specified
	  movie.  The ideal size of a movie is approximately 64	pixels wide by
	  64 pixels high. A movie can be resized or scaled using makemovie(1).









									Page 2






VkMovieButton(3x)					     VkMovieButton(3x)



FUNCTION DESCRIPTIONS
   VkMovieButton()
	   VkMovieButton(const char *name, Widget parent,
		      char *movieFileName = NULL, char *label =	NULL);


	  Initialize a VkMovieButton. "movieFileName" specifies	a valid	movie
	  file,	while label specifies an optional label	to be displayed	below
	  the movie.


   ~VkMovieButton()
	   virtual void	~VkMovieButton(void);


	  Free any memory allocated by a VkMovieButton instance.


   setLabel
	   virtual void	setLabel(const char *label);


	  Change the label displayed by	the button.


   setMovieFile
	   virtual void	setMovieFile(const char	*movieFile);


	  Change the movie to be played	when the button	is pushed.

INHERITED MEMBER FUNCTIONS    [Toc]    [Back]

   Inherited from VkComponent
	  installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
	  setDefaultResources(), getResources(), manage(), unmanage(),
	  baseWidget(),	okToQuit(), _name, _baseWidget,	_w, deleteCallback


   Inherited from VkCallbackObject    [Toc]    [Back]
	  callCallbacks(), addCallback(), removeCallback(),
	  removeAllCallbacks()


CLASSES	USED BY	THIS CLASS
     VkApp

SEE ALSO    [Toc]    [Back]

     VkComponent
     makemovie
     /usr/share/src/ViewKit/ComponentDemos/moviebutton
     ViewKit Programmer's Guide
     The X Window System, DEC Press, Bob Sheifler and Jim Gettys



									Page 3






VkMovieButton(3x)					     VkMovieButton(3x)



     The X Window System Toolkit, DEC Press, Paul Asente and Ralph Swick
     The OSF/Motif Programmers Reference, Prentice Hall, OSF


									PPPPaaaaggggeeee 4444