Fever & FvAsWing update ( rev 194 )

New update for Fever & FvAsWing frameworks.

I don't have many time to work on Fever currently... but I have implemented some new things and fix others.
Today we have few new classes ( BitmapGrid, BitmapClip,... ) and some updates for Dialog and FileSystem factories, new FvTree properties and more...

API Documentation is updated too : documentation.

Let's discover this new version now...

Fever framework

• Fever.application ( class name CoreApplication ) have new methods :
  • openDocument ( path : String ) :
    • allow to open external document with context associated application
      • For example in SWF Studio context, a PDF file will be opened using Adobe Acrobat Reader ( if installed )
        Where as in a Web Browser context we call the Browser Reader plugin
        
        
  • runProcess ( app : String, args : String, workingDir : String, hidden : Boolean, waitFor : Boolean )
    • launch external application ( throw exception in Browser context )
      
      
  • protect() and unprotect()
    • just a shortcut to FeverController#onLockInteractionEVENT boolean event broadcasting
      
      
      
• FileFilter and FileFilterList now implements FileFilterCollection interface.
  • getFilterIterator() returns correctly the filter list definition
    
    
    
• IDailog and all Dialog fFactory classes are updated with new FileFilterCollection type
  
  
  
• FileSystem
  • getTempDirectory()
    • returns a directory to save / write temporay files
      
      
  • getAppDirectory()
    • returns path where application is run
      
      
  • BrowserContext.remoteFileSystem property added to indicates if, in Browser context, we have to use the SOFileSystem ( FileSystem simulation using SharedObjects ) or a complete HTTPFileSystem ( using remoting and Ajax for a real time communication )
    
    
    
• BrowserFrame and BrowserPopup are available ( came from old implementations; updated for Fever now )
  • allow creation and control of Iframe in browser
  • allow creation and control of popup window
    
    
    
• BitmapGrid class added
  • allow definition and control of picture cells in a main picture file. ( alpha supported )
  • There is a sample image to use with BitmapGrid class
    
    
    
    
  • when BitmapGrid take control, we can see it like this :
    
    
    
    
  • differents access are available :
    • getBitmapAt( p : Point )
    • getBitmapRow( index : Number )
    • getBitmapColumn( index : Number )
    • getBitmap()
      
      
  • Here is a complete example :
    
    
    
    1.   public function run() : Void
    2.   {
    3.       var bl : BitmapLib =  new BitmapLib();
    4.       bl.addEventListener( BitmapLib.onLoadInitEVENT, this, _onLoad );
    5.       bl.load( 'lib.png' );
    6.   }
    7.   
    8.   private function _onLoad( ev : BitmapLibEvent ) : Void
    9.   {
    10.      // creates the grid using receive bitmap data
    11.      // In our sample, cell width == cell height, so we only pass 
    12.      // the width size.
    13.      var bg : BitmapGrid = new BitmapGrid( event.getBitmap(), 64 );
    14.     
    15.      // creates a empty MovieClip
    16.      var mc : MovieClip = Fever.stage.createEmptyMovieClip( 't' );
    17.     
    18.      // just attach specific cell now
    19.      mc1.attachBitmap( bg.getBitmapAt( new Point( 2, 0 ) ), 1 );
    20.      mc1._y = 100;
    21.  }
    
    
    
• BitmapClip class added
  • allow desinger to create "frame by frame" animation in image format. Developer retreive it using class and can control
    animation ( like MovieClip ) using public methods. ( alpha supported )
  • Here is image sample ( image counter )
    
  • when BitmapClip take control, imagine your clip like this ( MovieClip timeline )
    
    
    
    
  • control methods are :
    • play()
    • stop()
    • gotoAndPlay( index : Number )
    • gotoAndStop( index : Number )
    • prevFrame()
    • nextFrame()
      
      
  • BitmapClip wait for a MovieClip target as constructor parameter.
    As she doesn't extends MovieClip class ( I love composition ), we can access target MovieClip using getView() method.
    
    
  • Example :
    
    
    
    1.   public function run() : Void
    2.   {
    3.       var bl : BitmapLib =  new BitmapLib();
    4.       bl.addEventListener( BitmapLib.onLoadInitEVENT, this, _onLoad );
    5.       bl.load( 'animation.png' );
    6.   }
    7.   
    8.   private function _onLoad( ev : BitmapLibEvent ) : Void
    9.   {
    10.      // creates the clip using receive bitmap data
    11.      // In our sample, animation contains 5 frames
    12.      var ba : BitmapClip = new BitmapClip( Fever.stage.createEmptyMovieClip( 't' ), event.getBitmap(), 5 );
    13.     
    14.      //now play the animation ( loop mode is automatic )
    15.      ba.play();
    16.     
    17.     
    18.      // accessing target MovieClip
    19.      ba.getView()._x = 300;
    20.  }
    
    
  • 2 methods allow "script call" during animation on specific frame ( like Actionscript placed in MovieClip timeline frame )
    • addFrameScript( frameNum : Number, handler )
    • removeFrameScript( frameNum : Number )
    • A third method named addFrameStop( frameNum : Number ) exist as shortcut to place a "stop();" script on frame.
      
      
  • Example :
    
    
    
    1.   private function _onLoad( ev : BitmapLibEvent ) : Void
    2.   {
    3.       var ba : BitmapClip = new BitmapClip( Fever.stage.createEmptyMovieClip( 't' ), event.getBitmap(), 5 );
    4.       ba.addFrameScript( 2, this, _onFrame );
    5.       ba.addFrameStop( 5 );
    6.       ba.play(); // animation doesn't loop as we place a "stop" on frame 5.
    7.   }
    8.   
    9.   private function _onFrame( event : FrameEvent ) : Void
    10.  {
    11.      trace( 'Action on frame ' + event.getFrameNum() );
    12.      // output : "Action on frame 2"
    13.  }
    
    As you can see, a FrameEvent is broadcasted to retreive necessaries event properties ( target, type and frame number )
    
    
    
• MCFrameController class added
  • As BitmapClip class MCFrameController give access to MovieClip frames to execute dedicated function at specific frame.
  • Example :
    
    
    
    1.   public function run() : Void
    2.   {
    3.       var bl : BitmapLib =  new BitmapLib();
    4.       bl.addEventListener( BitmapLib.onLoadInitEVENT, this, _onLoad );
    5.       bl.load( 'animated.swf' );
    6.   }
    7.   
    8.   private function _onLoad( ev : BitmapLibEvent ) : Void
    9.   {
    10.      // retreive MovieClip content from BitmapLib
    11.      var mc : MovieClip = event.getView().square;
    12.     
    13.      // retreive MCFrameController instance ( singleton )
    14.      var mb : MCFrameController = MCFrameController.getInstance();
    15.     
    16.      // add scripts to specific frames
    17.      mb.addFrameScript( mc, 5, this, _onFrame );
    18.     
    19.      // or like this
    20.      // mb.addFrameScript( mc, 10, this );
    21.  }
    
    
    
• Some fixes now
  
  
  • FvContextMenuEvent.getTarget() correctly return the FvContextMenu target
  • Remoting gateway url parsing from configuration file is updated
  • MathUtils.random() accept a new 3rd parameter to allow rounded result ( default is false )
    • MathUtils.random( 10, 600, true )

FvAsWing framework

• FvTree ( and tree package ) update
  • The FvTreeNode has 3 new properties ( enable FvTree properties overriding for node and not only for the whole tree )
    • isDraggable
    • isDeletable
    • isEditable
      
      
  • FvTree.isEditable() is overrided to check tree or node edition status ( depending of current tree selection )
  • FvTree.isValidEditingValue() added to enable ( or not ) node value edition checking
    
    
• FvFileChooser is updated to be compliant with IDialog interface and thus can be used to open HTTP File System dialog.

Downloads

• Main SVN : http://as2fever.googlecode.com/svn/trunk/
• Fever repository : http://as2fever.googlecode.com/svn/trunk/fever/
• FvAsWing repository : http://as2fever.googlecode.com/svn/trunk/fvaswing/
• Template project : http://as2fever.googlecode.com/svn/trunk/template_project/


• Frameworks documentation : http://fever.customactions.net/doc/

 

Have a nice day ;)
Romain.