emulib.plugins.memory

Class AbstractMemory

java.lang.Object

emulib.plugins.memory.AbstractMemory

All Implemented Interfaces:

Memory, Plugin

public abstract class AbstractMemory
extends Object
implements Memory

Abstract memory. It implements some fundamental methods which are usually shared across the most of memories.

Nested Class Summary

Nested classes/interfaces inherited from interface emulib.plugins.memory.Memory

Memory.MemoryListener

Field Summary

Fields

Modifier and Type	Field and Description
protected long	pluginID ID of the plug-in assigned by emuStudio

Constructor Summary

Constructors

Constructor and Description
AbstractMemory(Long pluginID) Sets up plug-in id.

Method Summary

Modifier and Type	Method and Description
int	getProgramStart() Get program starting address (memory location), as it was loaded by the method setProgramStart().
String	getTitle() Get run-time title of this plug-in.
void	initialize(SettingsManager settings) No-operation.
void	reset() No-operation.
void	setProgramStart(int address) Set program starting address (memory location).

Methods inherited from class java.lang.Object

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

Methods inherited from interface emulib.plugins.memory.Memory

getSize

Methods inherited from interface emulib.plugins.Plugin

destroy, getVersion, isShowSettingsSupported, showSettings

Field Detail

pluginID

protected final long pluginID

ID of the plug-in assigned by emuStudio

Constructor Detail

AbstractMemory

public AbstractMemory(Long pluginID)

Sets up plug-in id.

Parameters:

pluginID - plug-in identification number

Throws:

NullPointerException - if pluginID is null

Method Detail

initialize

public void initialize(SettingsManager settings)
                throws PluginInitializationException

No-operation. Should be overridden if needed.

Specified by:

initialize in interface Plugin

Parameters:

settings - settings manipulation object

Throws:

PluginInitializationException - never in the default implementation

getProgramStart

public int getProgramStart()

Get program starting address (memory location), as it was loaded by the method setProgramStart().

Specified by:

getProgramStart in interface Memory

Returns:

program starting address (memory location)

setProgramStart

public void setProgramStart(int address)

Set program starting address (memory location). Mostly it is called by the emuStudio after the compiler returns. When the compiler compiles the source, the emuStudio gets compiled program starting address (if unknown, it will be 0) and pass it here.

Specified by:

setProgramStart in interface Memory

Parameters:

address - program starting address (memory location)

getTitle

public String getTitle()

Description copied from interface: Plugin

Get run-time title of this plug-in. The title is a matter of change during runtime - for example there might be a device which might be used many times but it is called differently for each instance.

Specified by:

getTitle in interface Plugin

Returns:

run-time title of the plug-in

reset

public void reset()

No-operation. Should be overridden if needed.

Specified by:

reset in interface Plugin