home *** CD-ROM | disk | FTP | other *** search
/ Netscape Plug-Ins Developer's Kit / Netscape_Plug-Ins_Developers_Kit.iso / source / Chap15 / npavi / AVIPLAYE.JAV < prev    next >
Encoding:
Text File  |  1996-05-03  |  2.6 KB  |  64 lines
  1. import netscape.plugin.Plugin;
  2. import AviObserver;
  3.  
  4. public class AviPlayer extends Plugin {
  5.  
  6.     // used to fire avi asynchronous events like OnStop or OnPositionChange.
  7.     // AviObserver is an interface (see AviObserver.java)
  8.     private AviObserver observer;
  9.  
  10.     public AviObserver getObserver() {
  11.         return observer;
  12.     }
  13.  
  14.     // the object interested in listening the avi must register here.
  15.     // timeout defines the time that occurs beetwen two OnPositionChange events
  16.     public boolean advise(AviObserver o, int timeout) {
  17.         System.err.println("called advise "+o+" "+timeout);
  18.         if (observer == null)
  19.             observer = o;
  20.         else
  21.             return false;
  22.  
  23.         setTimeOut(timeout);
  24.         return true;
  25.     }
  26.  
  27.     //\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//.
  28.     // those are all native.
  29.     // check AviPlayer.c/.h for stubs and prototypes information
  30.     // check avijava.cpp for native implementation
  31.  
  32.     // set the timeout for the position checking timer
  33.     public native void setTimeOut(int timeout);
  34.  
  35.     //\\//\\// WARNING - WARNING - WARNING 
  36.     // avi methods
  37.     // with MCI drivers, an instance of an AVI driver belongs to the thread
  38.     // which created it. When an applet try to call one of the following
  39.     // functions MCI fails to execute the command because the applet is in a 
  40.     // different thread than the one where the AVI instance was created (which is
  41.     // the main thread when it loads the plugin)
  42.     // The isAsync argument is used to see wheather the function can be called
  43.     // directly (isAsync = false) or a message needs to be posted in order
  44.     // to execute the function.
  45.     // This problem may happen every time, in some applet, you have thread-safe data 
  46.     // that you try to access (directly or not) from within another thread.
  47.     // I guess usually this doesn't happen since your data is in the java class
  48.     // and so it's available from other applets, but when you have native functions
  49.     // hiding data (the plugin is a very good example of this) this problem might occur.
  50.     // I wish the MCI drivers were not so strict (and I wonder why they need to be)
  51.     // NOTE:    in this example this is true only becouse of the MCI driver instance,
  52.     //            any other data is accessible and maybe if we use VFW API this problem
  53.     //            vanishes
  54.  
  55.     public native boolean play(boolean isAsync);
  56.     public native boolean stop(boolean isAsync);
  57.     public native boolean seek (boolean isAsync, int position);
  58.     public native boolean rewind (boolean isAsync);
  59.     public native boolean forward (boolean isAsync);
  60.     public native boolean frameForward (boolean isAsync);
  61.     public native boolean frameBack (boolean isAsync);
  62. }
  63.  
  64.