All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.scijava.java3d.utils.applet.MainFrame Maven / Gradle / Ivy

The newest version!
/*
 * Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistribution of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 *
 * - Redistribution in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in
 *   the documentation and/or other materials provided with the
 *   distribution.
 *
 * Neither the name of Sun Microsystems, Inc. or the names of
 * contributors may be used to endorse or promote products derived
 * from this software without specific prior written permission.
 *
 * This software is provided "AS IS," without a warranty of any
 * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
 * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
 * EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
 * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
 * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
 * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
 * ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
 * CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
 * REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
 * INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGES.
 *
 * You acknowledge that this software is not designed, licensed or
 * intended for use in the design, construction, operation or
 * maintenance of any nuclear facility.
 *
 */

// MainFrame - run an Applet as an application
//
// Copyright (C) 1996 by Jef Poskanzer .  All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions
// are met:
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
// 2. Redistributions in binary form must reproduce the above copyright
//    notice, this list of conditions and the following disclaimer in the
//    documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
// FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
// OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
// OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
// SUCH DAMAGE.
//
// Visit the ACME Labs Java page for up-to-date versions of this and other
// fine Java utilities: http://www.acme.com/java/

// ---------------------------------------------------------------------

package org.scijava.java3d.utils.applet;

import java.applet.Applet;
import java.applet.AppletContext;
import java.applet.AppletStub;
import java.applet.AudioClip;
import java.awt.BorderLayout;
import java.awt.Dimension;
import java.awt.Frame;
import java.awt.Image;
import java.awt.Label;
import java.awt.Toolkit;
import java.awt.Window;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.awt.image.ImageProducer;
import java.io.File;
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.Enumeration;
import java.util.Properties;
import java.util.StringTokenizer;
import java.util.Vector;

/// Run an Applet as an application.
// 

// Using this class you can add a trivial main program to any Applet // and run it directly, as well as from a browser or the appletviewer. // And unlike some versions of this concept, MainFrame implements both // images and sound. //

// Sample main program: //

// public static void main( String[] args )
//     {
//     new Acme.MainFrame( new ThisApplet(), args, 400, 400 );
//     }
// 
// The only methods you need to know about are the constructors. //

// You can specify Applet parameters on the command line, as name=value. // For instance, the equivalent of: //

// <PARAM NAME="pause" VALUE="200">
// 
// would just be: //
// pause=200
// 
// You can also specify three special parameters: //
// width=N          Width of the Applet.
// height=N         Height of the Applet.
// barebones=true   Leave off the menu bar and status area.
// 
//

// Fetch the software.
// Fetch the entire Acme package. public class MainFrame extends Frame implements Runnable, AppletStub, AppletContext { private String[] args = null; private static int instances = 0; private String name; private boolean barebones = true; private Applet applet; private Label label = null; private Dimension appletSize; private static final String PARAM_PROP_PREFIX = "parameter."; /// Constructor with everything specified. public MainFrame(Applet applet, String[] args, int width, int height) { build(applet, args, width, height); } /// Constructor with no default width/height. public MainFrame(Applet applet, String[] args ) { build(applet, args, -1, -1); } /// Constructor with no arg parsing. public MainFrame(Applet applet, int width, int height) { build( applet, null, width, height ); } // Internal constructor routine. private void build( Applet applet, String[] args, int width, int height) { ++instances; this.applet = applet; this.args = args; applet.setStub( this ); name = applet.getClass().getName(); setTitle( name ); // Set up properties. Properties props = System.getProperties(); props.put( "browser", "Acme.MainFrame" ); props.put( "browser.version", "11jul96" ); props.put( "browser.vendor", "Acme Laboratories" ); props.put( "browser.vendor.url", "http://www.acme.com/" ); // Turn args into parameters by way of the properties list. if ( args != null ) parseArgs( args, props ); // If width and height are specified in the parameters, override // the compiled-in values. String widthStr = getParameter( "width" ); if ( widthStr != null ) { width = Integer.parseInt( widthStr ); } String heightStr = getParameter( "height" ); if ( heightStr != null ) { height = Integer.parseInt( heightStr ); } // Were width and height specified somewhere? if ((width == -1) || (height == -1)) { System.err.println( "Width and height must be specified." ); return; } // Do we want to run bare-bones? String bonesStr = getParameter( "barebones" ); if ((bonesStr != null) && bonesStr.equals( "true" )) { barebones = true; } // Lay out components. setLayout( new BorderLayout() ); add( "Center", applet ); // Set up size. pack(); validate(); appletSize = applet.getSize(); applet.setSize( width, height ); setVisible(true); /* Added WindowListener inner class to detect close events. */ SecurityManager sm = System.getSecurityManager(); boolean doExit = true; if (sm != null) { try { sm.checkExit(0); } catch (SecurityException e) { doExit = false; } } final boolean _doExit = doExit; addWindowListener(new WindowAdapter() { @Override public void windowClosing(WindowEvent winEvent) { if (MainFrame.this.applet != null) { MainFrame.this.applet.destroy(); } Window w = winEvent.getWindow(); w.hide(); try { w.dispose(); } catch (IllegalStateException e) {} if (_doExit) { System.exit(0); } } }); // Start a separate thread to call the applet's init() and start() // methods, in case they take a long time. (new Thread( this )).start(); } // Turn command-line arguments into Applet parameters, by way of the // properties list. private static void parseArgs( String[] args, Properties props) { String arg; for (int i = 0; i < args.length; ++i) { arg = args[i]; int ind = arg.indexOf( '=' ); if ( ind == -1 ) { props.put(PARAM_PROP_PREFIX + arg.toLowerCase(), "" ); } else { props.put(PARAM_PROP_PREFIX + arg.substring( 0, ind ).toLowerCase(), arg.substring( ind + 1 ) ); } } } // Methods from Runnable. /// Separate thread to call the applet's init() and start() methods. @Override public void run() { showStatus( name + " initializing..." ); applet.init(); validate(); showStatus( name + " starting..." ); applet.start(); validate(); showStatus( name + " running..." ); } // Methods from AppletStub. @Override public boolean isActive() { return true; } @Override public URL getDocumentBase() { // Returns the current directory. String dir = System.getProperty( "user.dir" ); String urlDir = dir.replace( File.separatorChar, '/' ); try { return new URL( "file:" + urlDir + "/"); } catch ( MalformedURLException e ) { return null; } } @Override public URL getCodeBase() { // Hack: loop through each item in CLASSPATH, checking if // the appropriately named .class file exists there. But // this doesn't account for .zip files. String path = System.getProperty( "java.class.path" ); Enumeration st = new StringTokenizer( path, ":" ); while ( st.hasMoreElements() ) { String dir = (String) st.nextElement(); String filename = dir + File.separatorChar + name + ".class"; File file = new File( filename ); if (file.exists()) { String urlDir = dir.replace( File.separatorChar, '/' ); try { return new URL( "file:" + urlDir + "/" ); } catch (MalformedURLException e) { return null; } } } return null; } @Override public String getParameter(String name) { // Return a parameter via the munged names in the properties list. return System.getProperty( PARAM_PROP_PREFIX + name.toLowerCase() ); } @Override public void appletResize(int width, int height) { // Change the frame's size by the same amount that the applet's // size is changing. Dimension frameSize = getSize(); frameSize.width += width - appletSize.width; frameSize.height += height - appletSize.height; setSize( frameSize ); appletSize = applet.getSize(); } @Override public AppletContext getAppletContext() { return this; } // Methods from AppletContext. @Override public AudioClip getAudioClip( URL url ) { // This is an internal undocumented routine. However, it // also provides needed functionality not otherwise available. // I suspect that in a future release, JavaSoft will add an // audio content handler which encapsulates this, and then // we can just do a getContent just like for images. return new sun.applet.AppletAudioClip( url ); } @Override public Image getImage( URL url ) { Toolkit tk = Toolkit.getDefaultToolkit(); try { ImageProducer prod = (ImageProducer) url.getContent(); return tk.createImage( prod ); } catch ( IOException e ) { return null; } } @Override public Applet getApplet(String name) { // Returns this Applet or nothing. if (name.equals( this.name )) { return applet; } return null; } @Override public Enumeration getApplets() { // Just yields this applet. Vector v = new Vector(); v.addElement( applet ); return v.elements(); } @Override public void showDocument( URL url ) { // Ignore. } @Override public void showDocument( URL url, String target ) { // Ignore. } @Override public void showStatus( String status ) { if (label != null) { label.setText(status); } } @Override public void setStream( String key, java.io.InputStream stream ) { throw new RuntimeException("Not Implemented"); // TODO implement setStream method } @Override public java.io.InputStream getStream( String key ) { throw new RuntimeException("Not Implemented"); // TODO implement getStream method } @Override public java.util.Iterator getStreamKeys() { throw new RuntimeException("Not Implemented"); // TODO implement getStreamKeys method } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy