CPCWiki - THE Amstrad CPC encyclopedia! - User contributions [en]

Exomizer

2017-08-31T02:50:12Z

Ervin: /* Links */

'''''Exomizer''''' is a file compression utility which is designed so that files can be compressed quickly and efficiently on a PC and decompressed on 8-bit machines, such as the Amstrad CPC, where memory and processing power are much more limited. Across the 8-bit programming scene, it is generally regarded as the most efficient compressor that is currently available.

== Tutorial ==

=== Installing ''Exomizer'' ===

Firstly, download ''Exomizer'' from the home page; the link is at the bottom of this article.

For Windows:

Unzip the ZIP file to a folder of your choice (e.g. <tt>C:\exomizer</tt>). The Windows binaries are located in the <tt>win32\</tt> subfolder. For ease of use, copy the <tt>exomizer.exe</tt> file in this subfolder to the main folder (i.e. <tt>C:\exomizer</tt>).

This tutorial also assumes that ''[[ManageDsk]]'' (a Windows utility for manipulating DSK files) is installed on your PC.

For Linux:

You need to download the zip, extract it and build it from source. You will gnu C installed.

<tt>unzip exomizer202.zip</tt>
<tt>cd exomizer202/src</tt>
<tt>make</tt>

When you are done you will have b2membuf, exobasic, exomizer and exoraw in the same directory as the source.

=== Compression ===

For this example, the game code for Mirrorsoft's classic game ''[[Boulder Dash]]'' will be used as the file to decompress. Its start address is &200, its length is &7520 bytes (29,984 bytes in decimal), its execution address is &1F52, and the file name is <tt>BOULDER.BIN</tt>.

Start ''ManageDsk'', and select the DSK file that <tt>BOULDER.BIN</tt> is saved on. Export <tt>BOULDER.BIN</tt> to the ''Exomizer'' folder. You must ensure that you export it without an AMSDOS header.

Now open a command prompt and go to the ''Exomizer'' folder by typing:

<kbd>cd C:\exomizer</kbd>

Then type the following command to compress <tt>BOULDER.BIN</tt> and save the compressed file as <tt>BOULDERC.BIN</tt>:

<kbd>exomizer raw boulder.bin -o boulderc.bin</kbd>

This produces the following output:

<pre>Crunching infile "boulder.bin" to outfile "boulderc.bin".

Phase 1: Instrumenting file
-----------------------------
Length of indata: 29984 bytes.
[building.directed.acyclic.graph.building.directed.acyclic.graph.]
Instrumenting file, done.

Phase 2: Calculating encoding
-----------------------------
pass 1: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 88005.0 bits ~11001 bytes
pass 2: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
pass 3: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
Calculating encoding, done.

Phase 3: Generating output file
------------------------------
Encoding: 11222454573A2071,1012,1100233355666788,1232234457819AAD
Length of crunched data: 10968 bytes.
Literal sequences are not used and the safety offset is 2.</pre>

This information shows that ''Exomizer'' has managed to compress <tt>BOULDER.BIN</tt> from 29,984 bytes to just 10,968 bytes (&2AD8 in hexadecimal) - around 37% of its original size! The safety offset refers to the minimum number of bytes that must separate the final byte of the compressed file and the final byte of the decompressed data - more about this below.

=== Decompression ===

Now that the file has been compressed, use ''ManageDsk'' to import <tt>BOULDERC.BIN</tt> back to a DSK file. You must ensure that you import it as a binary file, and not an ASCII file, as ''ManageDsk'' will need to add an AMSDOS header. The program will ask for the start address and entry point of the file.

Remember the safety offset that was mentioned earlier? The game code starts at &200 and is &7520 bytes long, so the final byte is located at address &200 + &7520 - 1 = &771F. As the safety offset for <tt>BOULDERC.BIN</tt> is 2 bytes, this means that the final byte of this file can be located at any address from &771F + 2 = &7721 or above. This means that the lowest start address that the file can be loaded to is &7721 - &2AD8 + 1 = &4C4A (or 0x4C4A), so enter this value as the start address. The entry point should be left at 0x0000.

The Z80 assembler source code for decompressing files is located in the <tt>rawdecrs\z80\</tt> subfolder, and the file name is <tt>deexo.asm</tt>. The decompression routine is 198 bytes long, and it also requires a buffer of 156 bytes. The buffer is labelled <code>exo_mapbasebits</code>, and it is located immediately after the decompression routine, but you can alter it (by adding the line <code>exo_mapbasebits equ &xxxx</code>) so that it is located anywhere in memory - as long as it doesn't overwrite the compressed file or the decompressed data! Assemble the decompression routine to a suitable address in memory using an assembler of your choice (e.g. ''[[Pasmo]]'' or ''[[WinAPE]]'''s built-in assembler); again, ensure that it doesn't overwrite the compressed file or the decompressed data. The code supplied with ''Exomizer'' may need to be edited to suit the syntax of your assembler.

Now you will need to add some code to load <tt>BOULDERC.BIN</tt> into memory and decompress it. Add the following code before the decompression routine:

<pre>load_file:
ld hl,filename ;HL = file name address
ld de,&4c4a ;DE = start address to load file to
ld b,12 ;B = length of file name
call &bc77 ;Open the file header

ex de,hl ;Now HL = start address
push hl ;Store it
call &bc83 ;Load the file
call &bc7a ;Close the file

decompress_file:
pop hl ;HL = start address of compressed file
ld de,&0200 ;DE = start address of decompressed data
call deexo ;Decompress the data

start_game:
jp &1f52 ;Start the game

filename:
db "BOULDERC.BIN" ;Name of file containing compressed data</pre>

Finally, run this code, and if you have done everything correctly, you should see the ''Boulder Dash'' title screen!

== Bugs ==

''Exomizer'' can sometimes fail to decompress files correctly for no apparent reason, causing the CPC to crash. Unfortunately there is no known way to overcome this problem, other than to use a different compressor.

[Added 31-August-2017 by ervin] The above claim is questionable. The *only* times I've ever encountered such Exomizer crashes were due to errors on my part (for example, an incorrect data type for an array in C). In my experience, Exomizer itself has never caused any problems.

== Links ==

* [https://bitbucket.org/magli143/exomizer/wiki/Home/ ''Exomizer'' home page]

[[Category:CrossDev]]

Exomizer

2017-08-31T02:49:34Z

Ervin: /* Links */

'''''Exomizer''''' is a file compression utility which is designed so that files can be compressed quickly and efficiently on a PC and decompressed on 8-bit machines, such as the Amstrad CPC, where memory and processing power are much more limited. Across the 8-bit programming scene, it is generally regarded as the most efficient compressor that is currently available.

== Tutorial ==

=== Installing ''Exomizer'' ===

Firstly, download ''Exomizer'' from the home page; the link is at the bottom of this article.

For Windows:

Unzip the ZIP file to a folder of your choice (e.g. <tt>C:\exomizer</tt>). The Windows binaries are located in the <tt>win32\</tt> subfolder. For ease of use, copy the <tt>exomizer.exe</tt> file in this subfolder to the main folder (i.e. <tt>C:\exomizer</tt>).

This tutorial also assumes that ''[[ManageDsk]]'' (a Windows utility for manipulating DSK files) is installed on your PC.

For Linux:

You need to download the zip, extract it and build it from source. You will gnu C installed.

<tt>unzip exomizer202.zip</tt>
<tt>cd exomizer202/src</tt>
<tt>make</tt>

When you are done you will have b2membuf, exobasic, exomizer and exoraw in the same directory as the source.

=== Compression ===

For this example, the game code for Mirrorsoft's classic game ''[[Boulder Dash]]'' will be used as the file to decompress. Its start address is &200, its length is &7520 bytes (29,984 bytes in decimal), its execution address is &1F52, and the file name is <tt>BOULDER.BIN</tt>.

Start ''ManageDsk'', and select the DSK file that <tt>BOULDER.BIN</tt> is saved on. Export <tt>BOULDER.BIN</tt> to the ''Exomizer'' folder. You must ensure that you export it without an AMSDOS header.

Now open a command prompt and go to the ''Exomizer'' folder by typing:

<kbd>cd C:\exomizer</kbd>

Then type the following command to compress <tt>BOULDER.BIN</tt> and save the compressed file as <tt>BOULDERC.BIN</tt>:

<kbd>exomizer raw boulder.bin -o boulderc.bin</kbd>

This produces the following output:

<pre>Crunching infile "boulder.bin" to outfile "boulderc.bin".

Phase 1: Instrumenting file
-----------------------------
Length of indata: 29984 bytes.
[building.directed.acyclic.graph.building.directed.acyclic.graph.]
Instrumenting file, done.

Phase 2: Calculating encoding
-----------------------------
pass 1: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 88005.0 bits ~11001 bytes
pass 2: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
pass 3: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
Calculating encoding, done.

Phase 3: Generating output file
------------------------------
Encoding: 11222454573A2071,1012,1100233355666788,1232234457819AAD
Length of crunched data: 10968 bytes.
Literal sequences are not used and the safety offset is 2.</pre>

This information shows that ''Exomizer'' has managed to compress <tt>BOULDER.BIN</tt> from 29,984 bytes to just 10,968 bytes (&2AD8 in hexadecimal) - around 37% of its original size! The safety offset refers to the minimum number of bytes that must separate the final byte of the compressed file and the final byte of the decompressed data - more about this below.

=== Decompression ===

Now that the file has been compressed, use ''ManageDsk'' to import <tt>BOULDERC.BIN</tt> back to a DSK file. You must ensure that you import it as a binary file, and not an ASCII file, as ''ManageDsk'' will need to add an AMSDOS header. The program will ask for the start address and entry point of the file.

Remember the safety offset that was mentioned earlier? The game code starts at &200 and is &7520 bytes long, so the final byte is located at address &200 + &7520 - 1 = &771F. As the safety offset for <tt>BOULDERC.BIN</tt> is 2 bytes, this means that the final byte of this file can be located at any address from &771F + 2 = &7721 or above. This means that the lowest start address that the file can be loaded to is &7721 - &2AD8 + 1 = &4C4A (or 0x4C4A), so enter this value as the start address. The entry point should be left at 0x0000.

The Z80 assembler source code for decompressing files is located in the <tt>rawdecrs\z80\</tt> subfolder, and the file name is <tt>deexo.asm</tt>. The decompression routine is 198 bytes long, and it also requires a buffer of 156 bytes. The buffer is labelled <code>exo_mapbasebits</code>, and it is located immediately after the decompression routine, but you can alter it (by adding the line <code>exo_mapbasebits equ &xxxx</code>) so that it is located anywhere in memory - as long as it doesn't overwrite the compressed file or the decompressed data! Assemble the decompression routine to a suitable address in memory using an assembler of your choice (e.g. ''[[Pasmo]]'' or ''[[WinAPE]]'''s built-in assembler); again, ensure that it doesn't overwrite the compressed file or the decompressed data. The code supplied with ''Exomizer'' may need to be edited to suit the syntax of your assembler.

Now you will need to add some code to load <tt>BOULDERC.BIN</tt> into memory and decompress it. Add the following code before the decompression routine:

<pre>load_file:
ld hl,filename ;HL = file name address
ld de,&4c4a ;DE = start address to load file to
ld b,12 ;B = length of file name
call &bc77 ;Open the file header

ex de,hl ;Now HL = start address
push hl ;Store it
call &bc83 ;Load the file
call &bc7a ;Close the file

decompress_file:
pop hl ;HL = start address of compressed file
ld de,&0200 ;DE = start address of decompressed data
call deexo ;Decompress the data

start_game:
jp &1f52 ;Start the game

filename:
db "BOULDERC.BIN" ;Name of file containing compressed data</pre>

Finally, run this code, and if you have done everything correctly, you should see the ''Boulder Dash'' title screen!

== Bugs ==

''Exomizer'' can sometimes fail to decompress files correctly for no apparent reason, causing the CPC to crash. Unfortunately there is no known way to overcome this problem, other than to use a different compressor.

[Added 31-August-2017 by ervin] The above claim is questionable. The *only* times I've ever encountered such Exomizer crashes were due to errors on my part (for example, an incorrect data type for an array in C). In my experience, Exomizer itself has never caused any problems.

== Links ==

* [http://hem.bredband.net/magli143/exo/ Old ''Exomizer'' home page]
* [https://bitbucket.org/magli143/exomizer/wiki/Home/ New ''Exomizer'' home page]

[[Category:CrossDev]]

Exomizer

2017-08-31T02:48:04Z

Ervin: /* Bugs */

'''''Exomizer''''' is a file compression utility which is designed so that files can be compressed quickly and efficiently on a PC and decompressed on 8-bit machines, such as the Amstrad CPC, where memory and processing power are much more limited. Across the 8-bit programming scene, it is generally regarded as the most efficient compressor that is currently available.

== Tutorial ==

=== Installing ''Exomizer'' ===

Firstly, download ''Exomizer'' from the home page; the link is at the bottom of this article.

For Windows:

Unzip the ZIP file to a folder of your choice (e.g. <tt>C:\exomizer</tt>). The Windows binaries are located in the <tt>win32\</tt> subfolder. For ease of use, copy the <tt>exomizer.exe</tt> file in this subfolder to the main folder (i.e. <tt>C:\exomizer</tt>).

This tutorial also assumes that ''[[ManageDsk]]'' (a Windows utility for manipulating DSK files) is installed on your PC.

For Linux:

You need to download the zip, extract it and build it from source. You will gnu C installed.

<tt>unzip exomizer202.zip</tt>
<tt>cd exomizer202/src</tt>
<tt>make</tt>

When you are done you will have b2membuf, exobasic, exomizer and exoraw in the same directory as the source.

=== Compression ===

For this example, the game code for Mirrorsoft's classic game ''[[Boulder Dash]]'' will be used as the file to decompress. Its start address is &200, its length is &7520 bytes (29,984 bytes in decimal), its execution address is &1F52, and the file name is <tt>BOULDER.BIN</tt>.

Start ''ManageDsk'', and select the DSK file that <tt>BOULDER.BIN</tt> is saved on. Export <tt>BOULDER.BIN</tt> to the ''Exomizer'' folder. You must ensure that you export it without an AMSDOS header.

Now open a command prompt and go to the ''Exomizer'' folder by typing:

<kbd>cd C:\exomizer</kbd>

Then type the following command to compress <tt>BOULDER.BIN</tt> and save the compressed file as <tt>BOULDERC.BIN</tt>:

<kbd>exomizer raw boulder.bin -o boulderc.bin</kbd>

This produces the following output:

<pre>Crunching infile "boulder.bin" to outfile "boulderc.bin".

Phase 1: Instrumenting file
-----------------------------
Length of indata: 29984 bytes.
[building.directed.acyclic.graph.building.directed.acyclic.graph.]
Instrumenting file, done.

Phase 2: Calculating encoding
-----------------------------
pass 1: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 88005.0 bits ~11001 bytes
pass 2: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
pass 3: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
Calculating encoding, done.

Phase 3: Generating output file
------------------------------
Encoding: 11222454573A2071,1012,1100233355666788,1232234457819AAD
Length of crunched data: 10968 bytes.
Literal sequences are not used and the safety offset is 2.</pre>

This information shows that ''Exomizer'' has managed to compress <tt>BOULDER.BIN</tt> from 29,984 bytes to just 10,968 bytes (&2AD8 in hexadecimal) - around 37% of its original size! The safety offset refers to the minimum number of bytes that must separate the final byte of the compressed file and the final byte of the decompressed data - more about this below.

=== Decompression ===

Now that the file has been compressed, use ''ManageDsk'' to import <tt>BOULDERC.BIN</tt> back to a DSK file. You must ensure that you import it as a binary file, and not an ASCII file, as ''ManageDsk'' will need to add an AMSDOS header. The program will ask for the start address and entry point of the file.

Remember the safety offset that was mentioned earlier? The game code starts at &200 and is &7520 bytes long, so the final byte is located at address &200 + &7520 - 1 = &771F. As the safety offset for <tt>BOULDERC.BIN</tt> is 2 bytes, this means that the final byte of this file can be located at any address from &771F + 2 = &7721 or above. This means that the lowest start address that the file can be loaded to is &7721 - &2AD8 + 1 = &4C4A (or 0x4C4A), so enter this value as the start address. The entry point should be left at 0x0000.

The Z80 assembler source code for decompressing files is located in the <tt>rawdecrs\z80\</tt> subfolder, and the file name is <tt>deexo.asm</tt>. The decompression routine is 198 bytes long, and it also requires a buffer of 156 bytes. The buffer is labelled <code>exo_mapbasebits</code>, and it is located immediately after the decompression routine, but you can alter it (by adding the line <code>exo_mapbasebits equ &xxxx</code>) so that it is located anywhere in memory - as long as it doesn't overwrite the compressed file or the decompressed data! Assemble the decompression routine to a suitable address in memory using an assembler of your choice (e.g. ''[[Pasmo]]'' or ''[[WinAPE]]'''s built-in assembler); again, ensure that it doesn't overwrite the compressed file or the decompressed data. The code supplied with ''Exomizer'' may need to be edited to suit the syntax of your assembler.

Now you will need to add some code to load <tt>BOULDERC.BIN</tt> into memory and decompress it. Add the following code before the decompression routine:

<pre>load_file:
ld hl,filename ;HL = file name address
ld de,&4c4a ;DE = start address to load file to
ld b,12 ;B = length of file name
call &bc77 ;Open the file header

ex de,hl ;Now HL = start address
push hl ;Store it
call &bc83 ;Load the file
call &bc7a ;Close the file

decompress_file:
pop hl ;HL = start address of compressed file
ld de,&0200 ;DE = start address of decompressed data
call deexo ;Decompress the data

start_game:
jp &1f52 ;Start the game

filename:
db "BOULDERC.BIN" ;Name of file containing compressed data</pre>

Finally, run this code, and if you have done everything correctly, you should see the ''Boulder Dash'' title screen!

== Bugs ==

''Exomizer'' can sometimes fail to decompress files correctly for no apparent reason, causing the CPC to crash. Unfortunately there is no known way to overcome this problem, other than to use a different compressor.

[Added 31-August-2017 by ervin] The above claim is questionable. The *only* times I've ever encountered such Exomizer crashes were due to errors on my part (for example, an incorrect data type for an array in C). In my experience, Exomizer itself has never caused any problems.

== Links ==

* [http://hem.bredband.net/magli143/exo/ ''Exomizer'' home page]

[[Category:CrossDev]]

Exomizer

2017-08-31T02:47:26Z

Ervin: /* Bugs */

'''''Exomizer''''' is a file compression utility which is designed so that files can be compressed quickly and efficiently on a PC and decompressed on 8-bit machines, such as the Amstrad CPC, where memory and processing power are much more limited. Across the 8-bit programming scene, it is generally regarded as the most efficient compressor that is currently available.

== Tutorial ==

=== Installing ''Exomizer'' ===

Firstly, download ''Exomizer'' from the home page; the link is at the bottom of this article.

For Windows:

Unzip the ZIP file to a folder of your choice (e.g. <tt>C:\exomizer</tt>). The Windows binaries are located in the <tt>win32\</tt> subfolder. For ease of use, copy the <tt>exomizer.exe</tt> file in this subfolder to the main folder (i.e. <tt>C:\exomizer</tt>).

This tutorial also assumes that ''[[ManageDsk]]'' (a Windows utility for manipulating DSK files) is installed on your PC.

For Linux:

You need to download the zip, extract it and build it from source. You will gnu C installed.

<tt>unzip exomizer202.zip</tt>
<tt>cd exomizer202/src</tt>
<tt>make</tt>

When you are done you will have b2membuf, exobasic, exomizer and exoraw in the same directory as the source.

=== Compression ===

For this example, the game code for Mirrorsoft's classic game ''[[Boulder Dash]]'' will be used as the file to decompress. Its start address is &200, its length is &7520 bytes (29,984 bytes in decimal), its execution address is &1F52, and the file name is <tt>BOULDER.BIN</tt>.

Start ''ManageDsk'', and select the DSK file that <tt>BOULDER.BIN</tt> is saved on. Export <tt>BOULDER.BIN</tt> to the ''Exomizer'' folder. You must ensure that you export it without an AMSDOS header.

Now open a command prompt and go to the ''Exomizer'' folder by typing:

<kbd>cd C:\exomizer</kbd>

Then type the following command to compress <tt>BOULDER.BIN</tt> and save the compressed file as <tt>BOULDERC.BIN</tt>:

<kbd>exomizer raw boulder.bin -o boulderc.bin</kbd>

This produces the following output:

<pre>Crunching infile "boulder.bin" to outfile "boulderc.bin".

Phase 1: Instrumenting file
-----------------------------
Length of indata: 29984 bytes.
[building.directed.acyclic.graph.building.directed.acyclic.graph.]
Instrumenting file, done.

Phase 2: Calculating encoding
-----------------------------
pass 1: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 88005.0 bits ~11001 bytes
pass 2: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
pass 3: optimizing ..
[finding.cheapest.path.finding.cheapest.path.finding.cheapest.pat]
size 87512.0 bits ~10939 bytes
Calculating encoding, done.

Phase 3: Generating output file
------------------------------
Encoding: 11222454573A2071,1012,1100233355666788,1232234457819AAD
Length of crunched data: 10968 bytes.
Literal sequences are not used and the safety offset is 2.</pre>

This information shows that ''Exomizer'' has managed to compress <tt>BOULDER.BIN</tt> from 29,984 bytes to just 10,968 bytes (&2AD8 in hexadecimal) - around 37% of its original size! The safety offset refers to the minimum number of bytes that must separate the final byte of the compressed file and the final byte of the decompressed data - more about this below.

=== Decompression ===

Now that the file has been compressed, use ''ManageDsk'' to import <tt>BOULDERC.BIN</tt> back to a DSK file. You must ensure that you import it as a binary file, and not an ASCII file, as ''ManageDsk'' will need to add an AMSDOS header. The program will ask for the start address and entry point of the file.

Remember the safety offset that was mentioned earlier? The game code starts at &200 and is &7520 bytes long, so the final byte is located at address &200 + &7520 - 1 = &771F. As the safety offset for <tt>BOULDERC.BIN</tt> is 2 bytes, this means that the final byte of this file can be located at any address from &771F + 2 = &7721 or above. This means that the lowest start address that the file can be loaded to is &7721 - &2AD8 + 1 = &4C4A (or 0x4C4A), so enter this value as the start address. The entry point should be left at 0x0000.

The Z80 assembler source code for decompressing files is located in the <tt>rawdecrs\z80\</tt> subfolder, and the file name is <tt>deexo.asm</tt>. The decompression routine is 198 bytes long, and it also requires a buffer of 156 bytes. The buffer is labelled <code>exo_mapbasebits</code>, and it is located immediately after the decompression routine, but you can alter it (by adding the line <code>exo_mapbasebits equ &xxxx</code>) so that it is located anywhere in memory - as long as it doesn't overwrite the compressed file or the decompressed data! Assemble the decompression routine to a suitable address in memory using an assembler of your choice (e.g. ''[[Pasmo]]'' or ''[[WinAPE]]'''s built-in assembler); again, ensure that it doesn't overwrite the compressed file or the decompressed data. The code supplied with ''Exomizer'' may need to be edited to suit the syntax of your assembler.

Now you will need to add some code to load <tt>BOULDERC.BIN</tt> into memory and decompress it. Add the following code before the decompression routine:

<pre>load_file:
ld hl,filename ;HL = file name address
ld de,&4c4a ;DE = start address to load file to
ld b,12 ;B = length of file name
call &bc77 ;Open the file header

ex de,hl ;Now HL = start address
push hl ;Store it
call &bc83 ;Load the file
call &bc7a ;Close the file

decompress_file:
pop hl ;HL = start address of compressed file
ld de,&0200 ;DE = start address of decompressed data
call deexo ;Decompress the data

start_game:
jp &1f52 ;Start the game

filename:
db "BOULDERC.BIN" ;Name of file containing compressed data</pre>

Finally, run this code, and if you have done everything correctly, you should see the ''Boulder Dash'' title screen!

== Bugs ==

''Exomizer'' can sometimes fail to decompress files correctly for no apparent reason, causing the CPC to crash. Unfortunately there is no known way to overcome this problem, other than to use a different compressor.

[31-August-2017] The above claim is questionable. The *only* times I've ever encountered such Exomizer crashes were due to errors on my part (for example, an incorrect data type for an array in C). In my experience, Exomizer itself has never caused any problems.

== Links ==

* [http://hem.bredband.net/magli143/exo/ ''Exomizer'' home page]

[[Category:CrossDev]]

File:RuncpcTitle.png

2015-10-21T03:06:34Z

Ervin:

ACU Type Ins

2010-02-24T13:56:49Z

Ervin:

The ACU Type Ins Project aims to document and preserve disk images of the type-ins from all issues of [[Amstrad Computer User]]. 
This project was originally started by '''Michael Till''', aka '''..The Devil's Phoenix..''' 
It has continued thanks to the efforts of '''tastefulmrship''', '''Johnny Olsen''' and a number of others, and is now headed by '''Ervin Pajor'''. 
'''19 March 2009''' - All .dsk files have now been prepared, and uploading/creation of content will begin again shortly. 
'''23 March 2009''' - 1984 complete. 
'''27 March 2009''' - January-February 1985 complete. 
'''27 April 2009''' - March 1985 complete. 
'''23 September 2009''' - April 1985 complete. 
'''4 October 2009''' - May 1985 complete. 
'''23 December 2009''' - June 1985 complete. 
'''15 January 2010''' - July 1985 complete. 
'''27 January 2010''' - August 1985 complete. 
'''19 February 2010''' - September 1985 complete. 
'''25 February 2010''' - October 1985 complete. 
 
__TOC__
=1984=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU August-September 1984 - Type-ins}} http://www.cpcwiki.eu/imgs/3/39/Acu8408thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October-November 1984 - Type-ins}} http://www.cpcwiki.eu/imgs/d/da/Acu8410thumb.png]
|-
|align="center"|[[ACU August-September 1984 - Type-ins|August September]]
|align="center"|[[ACU October-November 1984 - Type-ins|October November]]
|-
|}

=1985=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January-February 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/2/2b/Acu8501thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/7/7f/Acu8503thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/a/ad/Acu8504thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/a/a4/Acu8505thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/6/64/Acu8506thumb.png]
|-
|align="center"|[[ACU January-February 1985 - Type-ins|January February]]
|align="center"|[[ACU March 1985 - Type-ins|March]]
|align="center"|[[ACU April 1985 - Type-ins|April]]
|align="center"|[[ACU May 1985 - Type-ins|May]]
|align="center"|[[ACU June 1985 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/d/d3/Acu8507thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/7/7a/Acu8508thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/5/5b/Acu8509thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/e/e3/Acu8510thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/9/9c/Acu8511thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1985 - Type-ins}} http://www.cpcwiki.eu/imgs/7/75/Acu8512thumb.png]
|-
|align="center"|[[ACU July 1985 - Type-ins|July]]
|align="center"|[[ACU August 1985 - Type-ins|August]]
|align="center"|[[ACU September 1985 - Type-ins|September]]
|align="center"|[[ACU October 1985 - Type-ins|October]]
|align="center"|[[ACU November 1985 - Type-ins|November]]
|align="center"|[[ACU December 1985 - Type-ins|December]]
|-
|}

=1986=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/f/f4/Acu8601thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/7/74/Acu8602thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/7/77/Acu8603thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/1/1b/Acu8604thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/1/1f/Acu8605thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/c/cf/Acu8606thumb.png]
|-
|align="center"|[[ACU January 1986 - Type-ins|January]]
|align="center"|[[ACU February 1986 - Type-ins|February]]
|align="center"|[[ACU March 1986 - Type-ins|March]]
|align="center"|[[ACU April 1986 - Type-ins|April]]
|align="center"|[[ACU May 1986 - Type-ins|May]]
|align="center"|[[ACU June 1986 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/7/7e/Acu8607thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/1/11/Acu8608thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/e/ed/Acu8609thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/a/a0/Acu8610thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/6/6b/Acu8611thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1986 - Type-ins}} http://www.cpcwiki.eu/imgs/7/75/Acu8612thumb.png]
|-
|align="center"|[[ACU July 1986 - Type-ins|July]]
|align="center"|[[ACU August 1986 - Type-ins|August]]
|align="center"|[[ACU September 1986 - Type-ins|September]]
|align="center"|[[ACU October 1986 - Type-ins|October]]
|align="center"|[[ACU November 1986 - Type-ins|November]]
|align="center"|[[ACU December 1986 - Type-ins|December]]
|-
|}

=1987=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/5/5b/Acu8701thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/d/db/Acu8702thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/9/91/Acu8703thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/5/53/Acu8704thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/2/2a/Acu8705thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/5/50/Acu8706thumb.png]
|-
|align="center"|[[ACU January 1987 - Type-ins|January]]
|align="center"|[[ACU February 1987 - Type-ins|February]]
|align="center"|[[ACU March 1987 - Type-ins|March]]
|align="center"|[[ACU April 1987 - Type-ins|April]]
|align="center"|[[ACU May 1987 - Type-ins|May]]
|align="center"|[[ACU June 1987 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/4/44/Acu8707thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/5/5a/Acu8708thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/f/f5/Acu8709thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/8/84/Acu8710thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/9/91/Acu8711thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1987 - Type-ins}} http://www.cpcwiki.eu/imgs/f/f2/Acu8712thumb.png]
|-
|align="center"|[[ACU July 1987 - Type-ins|July]]
|align="center"|[[ACU August 1987 - Type-ins|August]]
|align="center"|[[ACU September 1987 - Type-ins|September]]
|align="center"|[[ACU October 1987 - Type-ins|October]]
|align="center"|[[ACU November 1987 - Type-ins|November]]
|align="center"|[[ACU December 1987 - Type-ins|December]]
|-
|}

=1988=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/1/14/Acu8801thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/4/46/Acu8802thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/a/a2/Acu8803thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/8/85/Acu8804thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/e/ed/Acu8805thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/b/bf/Acu8806thumb.png]
|-
|align="center"|[[ACU January 1988 - Type-ins|January]]
|align="center"|[[ACU February 1988 - Type-ins|February]]
|align="center"|[[ACU March 1988 - Type-ins|March]]
|align="center"|[[ACU April 1988 - Type-ins|April]]
|align="center"|[[ACU May 1988 - Type-ins|May]]
|align="center"|[[ACU June 1988 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/4/45/Acu8807thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/d/d7/Acu8808thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/7/71/Acu8809thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/1/1a/Acu8810thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/f/ff/Acu8811thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1988 - Type-ins}} http://www.cpcwiki.eu/imgs/9/92/Acu8812thumb.png]
|-
|align="center"|[[ACU July 1988 - Type-ins|July]]
|align="center"|[[ACU August 1988 - Type-ins|August]]
|align="center"|[[ACU September 1988 - Type-ins|September]]
|align="center"|[[ACU October 1988 - Type-ins|October]]
|align="center"|[[ACU November 1988 - Type-ins|November]]
|align="center"|[[ACU December 1988 - Type-ins|December]]
|-
|}

=1989=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/f/f0/Acu8901thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/f/f9/Acu8902thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/2/2b/Acu8903thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/4/41/Acu8904thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/9/94/Acu8905thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/2/29/Acu8906thumb.png]
|-
|align="center"|[[ACU January 1989 - Type-ins|January]]
|align="center"|[[ACU February 1989 - Type-ins|February]]
|align="center"|[[ACU March 1989 - Type-ins|March]]
|align="center"|[[ACU April 1989 - Type-ins|April]]
|align="center"|[[ACU May 1989 - Type-ins|May]]
|align="center"|[[ACU June 1989 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/0/0f/Acu8907thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/0/06/Acu8908thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/b/b1/Acu8909thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/3/38/Acu8910thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/c/c9/Acu8911thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1989 - Type-ins}} http://www.cpcwiki.eu/imgs/a/a0/Acu8912thumb.png]
|-
|align="center"|[[ACU July 1989 - Type-ins|July]]
|align="center"|[[ACU August 1989 - Type-ins|August]]
|align="center"|[[ACU September 1989 - Type-ins|September]]
|align="center"|[[ACU October 1989 - Type-ins|October]]
|align="center"|[[ACU November 1989 - Type-ins|November]]
|align="center"|[[ACU December 1989 - Type-ins|December]]
|-
|}

=1990=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/b/ba/Acu9001thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/b/b4/Acu9002thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/8/86/Acu9003thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/b/be/Acu9004thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/7/72/Acu9005thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/a/a0/Acu9006thumb.png]
|-
|align="center"|[[ACU January 1990 - Type-ins|January]]
|align="center"|[[ACU February 1990 - Type-ins|February]]
|align="center"|[[ACU March 1990 - Type-ins|March]]
|align="center"|[[ACU April 1990 - Type-ins|April]]
|align="center"|[[ACU May 1990 - Type-ins|May]]
|align="center"|[[ACU June 1990 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/1/10/Acu9007thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/e/e3/Acu9008thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/7/76/Acu9009thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/b/b0/Acu9010thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/4/43/Acu9011thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1990 - Type-ins}} http://www.cpcwiki.eu/imgs/7/7c/Acu9012thumb.png]
|-
|align="center"|[[ACU July 1990 - Type-ins|July]]
|align="center"|[[ACU August 1990 - Type-ins|August]]
|align="center"|[[ACU September 1990 - Type-ins|September]]
|align="center"|[[ACU October 1990 - Type-ins|October]]
|align="center"|[[ACU November 1990 - Type-ins|November]]
|align="center"|[[ACU December 1990 - Type-ins|December]]
|-
|}

=1991=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/7/7a/Acu9101thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/b/b0/Acu9102thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/3/30/Acu9103thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/7/70/Acu9104thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/e/ee/Acu9105thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU June 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/6/66/Acu9106thumb.png]
|-
|align="center"|[[ACU January 1991 - Type-ins|January]]
|align="center"|[[ACU February 1991 - Type-ins|February]]
|align="center"|[[ACU March 1991 - Type-ins|March]]
|align="center"|[[ACU April 1991 - Type-ins|April]]
|align="center"|[[ACU May 1991 - Type-ins|May]]
|align="center"|[[ACU June 1991 - Type-ins|June]]
|-
|}
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU July 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/0/03/Acu9107thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU August 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/7/7d/Acu9108thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU September 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/5/56/Acu9109thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU October 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/d/da/Acu9110thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU November 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/6/61/Acu9111thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU December 1991 - Type-ins}} http://www.cpcwiki.eu/imgs/9/9d/Acu9112thumb.png]
|-
|align="center"|[[ACU July 1991 - Type-ins|July]]
|align="center"|[[ACU August 1991 - Type-ins|August]]
|align="center"|[[ACU September 1991 - Type-ins|September]]
|align="center"|[[ACU October 1991 - Type-ins|October]]
|align="center"|[[ACU November 1991 - Type-ins|November]]
|align="center"|[[ACU December 1991 - Type-ins|December]]
|-
|}

=1992=
{|
|-
|align="center"|[{{SERVER}}{{localurl:ACU January 1992 - Type-ins}} http://www.cpcwiki.eu/imgs/8/8c/Acu9201thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU February 1992 - Type-ins}} http://www.cpcwiki.eu/imgs/7/74/Acu9202thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU March 1992 - Type-ins}} http://www.cpcwiki.eu/imgs/6/63/Acu9203thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU April 1992 - Type-ins}} http://www.cpcwiki.eu/imgs/9/96/Acu9204thumb.png]
|align="center"|[{{SERVER}}{{localurl:ACU May 1992 - Type-ins}} http://www.cpcwiki.eu/imgs/7/73/Acu9205thumb.png]
|-
|align="center"|[[ACU January 1992 - Type-ins|January]]
|align="center"|[[ACU February 1992 - Type-ins|February]]
|align="center"|[[ACU March 1992 - Type-ins|March]]
|align="center"|[[ACU April 1992 - Type-ins|April]]
|align="center"|[[ACU May 1992 - Type-ins|May]]
|-
|}
[[Category:Type Ins]]

ACU October 1985 - Type-ins

2010-02-24T13:55:45Z

2010-02-18T13:44:47Z

Ervin:

File:Acu8509sabotage4.png

2010-02-18T13:44:44Z

Ervin:

File:Acu8509sabotage3.png

2010-02-18T13:44:40Z

Ervin:

File:Acu8509sabotage2.png

2010-02-18T13:44:36Z

Ervin:

2010-02-18T13:29:59Z

Ervin: