org.wandora.application.gui.previews.formats

Class ApplicationZMachine

java.lang.Object

org.wandora.application.gui.previews.formats.ApplicationZMachine

All Implemented Interfaces:

java.awt.event.ActionListener, java.util.EventListener, PreviewPanel

public class ApplicationZMachine
extends java.lang.Object
implements java.awt.event.ActionListener, PreviewPanel

Uses and is based on Wei-ju Wu's ZMMP (The Z-machine Preservation) Project.

Author:

akivela

Field Summary

Fields

Modifier and Type	Field and Description
private org.zmpp.swingui.ZmppPanel	gamePanel
private java.lang.String	locator
private org.zmpp.vm.Machine	machine
private javax.swing.JPanel	ui

Constructor Summary

Constructors

Constructor and Description
ApplicationZMachine(java.lang.String loc)

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e)
static boolean	canView(java.lang.String url)
void	finish()
java.awt.Component	getGui() Is called to get the actual preview component.
protected javax.swing.JComponent	getJToolBar()
boolean	isHeavy() This is a deprecated method to tell the preview is a heavy weight AWT component.
private javax.swing.JPanel	makeUI()
void	runStory(java.lang.String locator)
private static java.io.File	searchForResources(java.io.File storyfile) Tries to find a resource file in Blorb format.
void	stop() Called whenever the PreviewPanel should stop i.e.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

locator

private java.lang.String locator

ui

private javax.swing.JPanel ui

gamePanel

private org.zmpp.swingui.ZmppPanel gamePanel

machine

private org.zmpp.vm.Machine machine

Constructor Detail

ApplicationZMachine

public ApplicationZMachine(java.lang.String loc)

Method Detail

runStory

public void runStory(java.lang.String locator)

searchForResources

private static java.io.File searchForResources(java.io.File storyfile)

Tries to find a resource file in Blorb format.

Parameters:

storyfile - the storyfile

Returns:

the blorb file if one exists or null

makeUI

private javax.swing.JPanel makeUI()

getJToolBar

protected javax.swing.JComponent getJToolBar()

stop

public void stop()

Description copied from interface: PreviewPanel

Called whenever the PreviewPanel should stop i.e. exit. This is usually called whenever the user closes the preview by closing the topic or by opening another topic. The PreviewPanel should release all resources while stopping. This method is usually called from the PreviewWrapper's stop method.

Specified by:

stop in interface PreviewPanel

finish

public void finish()

Specified by:

finish in interface PreviewPanel

getGui

public java.awt.Component getGui()

Description copied from interface: PreviewPanel

Is called to get the actual preview component. Wandora places the preview component into the user interface of the application. Usually the returned component is JPanel containing various other components such as images and buttons. This method is usually called from the PreviewWrapper. Running the method has no time limit. PreviewWrapper views a loading message and uses a separate thread to call the getGui, preventing the application to freeze.

Specified by:

getGui in interface PreviewPanel

isHeavy

public boolean isHeavy()

Description copied from interface: PreviewPanel

This is a deprecated method to tell the preview is a heavy weight AWT component. These days Java can mix heavy weight and swing component, and the isHeavy is not that important any more. Notice, returning a true value actually triggers some additional wrapping for the component returned by the getGui method. See AWTWrapper class for details.

Specified by:

isHeavy in interface PreviewPanel

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Specified by:

actionPerformed in interface java.awt.event.ActionListener

canView

public static boolean canView(java.lang.String url)