de.quippy.sidplay.libsidplay.common

Class SIDEndian

java.lang.Object

de.quippy.sidplay.libsidplay.common.SIDEndian

public class SIDEndian
extends Object

NOTE: The optimizations in this file rely on the structure of memory e.g. 2 shorts being contained in 1 long. Although these sizes are checked to make sure the optimization is ok, gcc 2.96 (and above) introduced better Optimizations. This results in caching of values in internal registers and therefore writes to ram through the aliases not being reflected in the CPU regs. The use of the volatile keyword fixes this.
Labeling:

• 0 - Low Word / Low Byte
• 1 - Low Word / High Byte
• 2 - High Word / Low Byte
• 3 - High Word / High Byte

Author:

Ken Händel

Field Summary

Fields

Modifier and Type	Field and Description
static int	SID_WORDS SID_WORDS_LITTLEENDIAN or SID_WORDS_BIGENDIAN
static int	SID_WORDS_BIGENDIAN byte-order: HIHI..3210..LO
static int	SID_WORDS_LITTLEENDIAN byte-order: LO..0123..HIHI

Constructor Summary

Constructors

Constructor and Description
SIDEndian()

Method Summary

Methods

Modifier and Type	Method and Description
static void	endian_16(char[] ptr, int pos, int word)
static void	endian_16(short[] ptr, int pos, int word) Convert high-byte and low-byte to 16-bit little endian word.
static int	endian_16(short hi, short lo) Convert high-byte and low-byte to 16-bit word.
static short	endian_16hi8(int word) Get the hi byte (8 bit) in a word (16 bit)
static int	endian_16hi8(int word, short thebyte) Set the hi byte (8 bit) in a word (16 bit)
static short	endian_16lo8(int word) Get the lo byte (8 bit) in a word (16 bit)
static int	endian_16lo8(int word, short thebyte) Set the lo byte (8 bit) in a word (16 bit)
static int	endian_16swap8(int word) Swap word endian.
static long	endian_32(short hihi, short hilo, short hi, short lo) Convert high-byte and low-byte to 32-bit word.
static int	endian_32hi16(long dword) Get the hi word (16bit) in a dword (32 bit)
static long	endian_32hi16(long dword, int word) Set the hi word (16bit) in a dword (32 bit)
static short	endian_32hi8(long dword) Get the hi byte (8 bit) in a dword (32 bit)
static long	endian_32hi8(long dword, short theByte) Set the hi byte (8 bit) in a dword (32 bit)
static int	endian_32lo16(long dword) Get the lo word (16bit) in a dword (32 bit)
static long	endian_32lo16(long dword, int word) Set the lo word (16bit) in a dword (32 bit)
static short	endian_32lo8(long dword) Get the lo byte (8 bit) in a dword (32 bit)
static long	endian_32lo8(long dword, short theByte) Set the lo byte (8 bit) in a dword (32 bit)
static long	endian_32swap16(long dword) Swap hi and lo words endian in 32 bit dword.
static long	endian_32swap8(long dword) Swap word endian.
static int	endian_big16(short[] ptr, int pos) Convert high-byte and low-byte to 16-bit big endian word.
static void	endian_big16(short[] ptr, int pos, int word) Write a big-endian 16-bit word to two bytes in memory.
static long	endian_big32(short[] ptr, int pos) Convert high-byte and low-byte to 32-bit big endian word.
static void	endian_big32(short[] ptr, int pos, long dword) Write a big-endian 32-bit word to four bytes in memory.
static int	endian_little16(short[] ptr, int pos) Convert high-byte and low-byte to 16-bit little endian word.
static void	endian_little16(short[] ptr, int pos, int word) Write a little-endian 16-bit word to two bytes in memory.
static long	endian_little32(short[] ptr, int pos) Convert high-byte and low-byte to 32-bit little endian word.
static void	endian_little32(short[] ptr, int pos, long dword) Write a little-endian 32-bit word to four bytes in memory.

Methods inherited from class java.lang.Object

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

Field Detail

SID_WORDS_BIGENDIAN

public static final int SID_WORDS_BIGENDIAN

byte-order: HIHI..3210..LO

See Also:

Constant Field Values

SID_WORDS_LITTLEENDIAN

public static final int SID_WORDS_LITTLEENDIAN

byte-order: LO..0123..HIHI

See Also:

Constant Field Values

SID_WORDS

public static final int SID_WORDS

SID_WORDS_LITTLEENDIAN or SID_WORDS_BIGENDIAN

See Also:

Constant Field Values

Constructor Detail

SIDEndian

public SIDEndian()

Method Detail

endian_16lo8

public static final int endian_16lo8(int word,
               short thebyte)

Set the lo byte (8 bit) in a word (16 bit)

Parameters:

word -

thebyte -

Returns:

endian_16lo8

public static final short endian_16lo8(int word)

Get the lo byte (8 bit) in a word (16 bit)

Parameters:

word -

Returns:

endian_16hi8

public static final int endian_16hi8(int word,
               short thebyte)

Set the hi byte (8 bit) in a word (16 bit)

Parameters:

word -

thebyte -

Returns:

endian_16hi8

public static final short endian_16hi8(int word)

Get the hi byte (8 bit) in a word (16 bit)

Parameters:

word -

Returns:

endian_16swap8

public static final int endian_16swap8(int word)

Swap word endian.

Parameters:

word -

Returns:

endian_16

public static final int endian_16(short hi,
            short lo)

Convert high-byte and low-byte to 16-bit word.

Parameters:

hi -

lo -

Returns:

endian_16

public static final void endian_16(short[] ptr,
             int pos,
             int word)

Convert high-byte and low-byte to 16-bit little endian word.

Parameters:

ptr -

pos -

endian_16

public static final void endian_16(char[] ptr,
             int pos,
             int word)

endian_little16

public static final int endian_little16(short[] ptr,
                  int pos)

Convert high-byte and low-byte to 16-bit little endian word.

Parameters:

ptr -

pos -

Returns:

endian_little16

public static final void endian_little16(short[] ptr,
                   int pos,
                   int word)

Write a little-endian 16-bit word to two bytes in memory.

Parameters:

ptr -

pos -

word -

endian_big16

public static final int endian_big16(short[] ptr,
               int pos)

Convert high-byte and low-byte to 16-bit big endian word.

Parameters:

ptr -

Returns:

endian_big16

public static final void endian_big16(short[] ptr,
                int pos,
                int word)

Write a big-endian 16-bit word to two bytes in memory.

Parameters:

ptr -

pos -

word -

endian_32lo16

public static final long endian_32lo16(long dword,
                 int word)

Set the lo word (16bit) in a dword (32 bit)

Parameters:

dword -

word -

Returns:

endian_32lo16

public static final int endian_32lo16(long dword)

Get the lo word (16bit) in a dword (32 bit)

Parameters:

dword -

Returns:

endian_32hi16

public static final long endian_32hi16(long dword,
                 int word)

Set the hi word (16bit) in a dword (32 bit)

Parameters:

dword -

word -

Returns:

endian_32hi16

public static final int endian_32hi16(long dword)

Get the hi word (16bit) in a dword (32 bit)

Parameters:

dword -

Returns:

endian_32lo8

public static final long endian_32lo8(long dword,
                short theByte)

Set the lo byte (8 bit) in a dword (32 bit)

Parameters:

dword -

theByte -

Returns:

endian_32lo8

public static final short endian_32lo8(long dword)

Get the lo byte (8 bit) in a dword (32 bit)

Parameters:

dword -

Returns:

endian_32hi8

public static final long endian_32hi8(long dword,
                short theByte)

Set the hi byte (8 bit) in a dword (32 bit)

Parameters:

dword -

theByte -

Returns:

endian_32hi8

public static final short endian_32hi8(long dword)

Get the hi byte (8 bit) in a dword (32 bit)

Parameters:

dword -

Returns:

endian_32swap16

public static final long endian_32swap16(long dword)

Swap hi and lo words endian in 32 bit dword.

Parameters:

dword -

Returns:

endian_32swap8

public static final long endian_32swap8(long dword)

Swap word endian.

Parameters:

dword -

Returns:

endian_32

public static final long endian_32(short hihi,
             short hilo,
             short hi,
             short lo)

Convert high-byte and low-byte to 32-bit word.

Parameters:

hihi -

hilo -

hi -

lo -

Returns:

endian_little32

public static final long endian_little32(short[] ptr,
                   int pos)

Convert high-byte and low-byte to 32-bit little endian word.

Parameters:

ptr -

pos -

Returns:

endian_little32

public static final void endian_little32(short[] ptr,
                   int pos,
                   long dword)

Write a little-endian 32-bit word to four bytes in memory.

Parameters:

ptr -

pos -

dword -

endian_big32

public static final long endian_big32(short[] ptr,
                int pos)

Convert high-byte and low-byte to 32-bit big endian word.

Parameters:

ptr -

pos -

Returns:

endian_big32

public static final void endian_big32(short[] ptr,
                int pos,
                long dword)

Write a big-endian 32-bit word to four bytes in memory.

Parameters:

ptr -

pos -

dword -