de.quippy.sidplay.libsidplay.components.xsid

Class XSID

java.lang.Object

de.quippy.sidplay.libsidplay.common.SIDEmu

de.quippy.sidplay.libsidplay.components.xsid.XSID

All Implemented Interfaces:

IComponent

Direct Known Subclasses:

C64XSID

public abstract class XSID
extends SIDEmu

Effectively there is only 1 channel, which can either perform Galway Noise or Sampling. However, to achieve all the effects on a C64, 2 sampling channels are required. No divide by 2 is required and is compensated for automatically in the C64 machine code.

Confirmed by Warren Pilkington using the tune Turbo Outrun: A new sample must interrupt an existing sample running on the same channel.

Confirmed by Michael Schwendt and Antonia Vera using the tune Game Over: A Galway Sample or Noise sequence cannot interrupt any other. However the last of these new requested sequences will be played after the current sequence ends.

Lastly playing samples through the SIDs volume is not as clean as playing them on their own channel. Playing through the SID will effect the volume of the other channels and this will be most noticable at low frequencies. These effects are however present in the original SID music.

Some SIDs put values directly into the volume register. Others play samples with respect to the current volume. We can't for definate know which the author has chosen originally. We must just make a guess based on what the volume is initially at the start of a sample sequence and from the details xSID has been programmed with.

Author:

Ken Händel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XSID.Channel

Constructor Summary

Constructors

Constructor and Description
XSID(IEventContext context)

Method Summary

Methods

Modifier and Type	Method and Description
String	credits()
boolean	isMuted()
void	mute(boolean enable) By muting samples they will start and play the at the appropriate time but no sound is produced.
long	output(short bits)
short	read(int addr)
short	read(short addr)
protected abstract short	readMemByte(int addr)
void	reset()
void	reset(short volume)
void	sidSamples(boolean enable)
boolean	storeSidData0x18(short data) Return whether we care it was changed.
void	suppress(boolean enable) Use Suppress to delay the samples and start them later.
void	write(int addr, short data)
void	write(short addr, short data)
protected abstract void	writeMemByte(short data)

Methods inherited from class de.quippy.sidplay.libsidplay.common.SIDEmu

builder, gain, optimisation, voice

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.quippy.sidplay.libsidplay.common.IComponent

error

Constructor Detail

XSID

public XSID(IEventContext context)

Method Detail

readMemByte

protected abstract short readMemByte(int addr)

writeMemByte

protected abstract void writeMemByte(short data)

reset

public void reset()

Specified by:

reset in interface IComponent

Overrides:

reset in class SIDEmu

reset

public void reset(short volume)

Specified by:

reset in class SIDEmu

read

public short read(short addr)

Specified by:

read in interface IComponent

Specified by:

read in class SIDEmu

write

public void write(short addr,
         short data)

Specified by:

write in interface IComponent

Specified by:

write in class SIDEmu

credits

public final String credits()

Specified by:

credits in interface IComponent

Specified by:

credits in class SIDEmu

read

public short read(int addr)

write

public void write(int addr,
         short data)

output

public long output(short bits)

Specified by:

output in class SIDEmu

mute

public void mute(boolean enable)

By muting samples they will start and play the at the appropriate time but no sound is produced. Un-muting will cause sound output from the current play position.

Parameters:

enable -

isMuted

public boolean isMuted()

suppress

public void suppress(boolean enable)

Use Suppress to delay the samples and start them later. Effectivly allows running samples in a frame based mode.

Parameters:

enable -

sidSamples

public void sidSamples(boolean enable)

storeSidData0x18

public boolean storeSidData0x18(short data)

Return whether we care it was changed.

Parameters:

data -

Returns: