Importing images into the Dragon - Revision history

Polluks: /* Step 4 : Displaying Image */

2021-09-29T20:24:49Z

‎Step 4 : Displaying Image

Jedie at 14:50, 5 August 2014

2014-08-05T14:50:01Z

Robcfg: Added missing explanation

2011-01-31T18:29:11Z

Added missing explanation

Robcfg: Created page and uploaded pictures

2011-01-28T00:27:33Z

Created page and uploaded pictures

New page

This tutorial shows how to convert an image on your PC to a .CAS file that you can load in your emulator, or convert it to a .WAV file so you can load it in your real Dragon machine.

== Step 1 : Preparing your image ==

First, choose the image you'd like to convert. I've chosen this one:

[[file:Spacecouv1_dry.JPG|250px]]

Which is a wonderful art by ELLioT (http://www.elliotek.net).

First, we rotate the image 90 degrees to the left to fit the screen better.

Then, we crop the image from 800x554 to 738x554 to keep the 4:3 aspect ratio of the TV or monitor screen.

If you'd like to have your image in PMODE4 (256x192 2 colors), you have to scale the image to 256x192, convert it to grayscale image and then to black and white bitmap (choose the dithering method you like most).
You should get an image like this:

[[file:PMODE4_RAW.gif]]

On the other hand, if you'd like your image in PMODE3 (128x192 4 colors), you have to scale the image to 128x192 and convert it to indexed color with one of the two palettes for this mode. You'll find the palette information in the downloads section below.
With this procedure, you should get an image like this:

[[file:PMODE3_RAW.gif]]

Now, you only have to save your image as .RAW file with no header. If everything's gone ok, your PMODE4 image should be 49152 bytes in size, or 24576 bytes if the image was processed as PMODE3.

== Step 2 : Packing the data in Dragon format ==

The Dragon computer packs 8 pixels per byte in PMODE4 and 4 pixels per byte in PMODE3. So, the .RAW files must be packed according to the PMODE in which you'd like to display them.

This is done by using the tools Raw2PMODE3 or Raw2PMODE4, which can be downloaded below.

Their usage is quite easy. To convert a PMODE4 raw image, type "'''Raw2PMODE4 image.raw'''", and to convert a PMODE3 raw image, type "'''Raw2PMODE3 image.raw'''". This will create a packed file in the correct format with extension .PM4 or .PM3 (depending on the tool used).

== Step 3 : Converting the image to .CAS or .WAV file ==

This step is super easy too.

You only need to use the DrBinCas tool (see the downloads section below) to generate the final file you need to see your image.

Just type "'''DrBinCas image.PM3 name 1536 1536'''" or "'''DrBinCas image.PM4 name 1536 1536'''".

For example, if we want the image to have the name "SPACE" in the .CAS file, you should type "'''DrBinCas image.PM4 SPACE 1536 1536'''".

To convert the .CAS file to a .WAV file, use the DC.EXE utility. Download link below.

== Step 4 : Displaying Image ==

Now that you have your .CAS or .WAV file, you can load it in your favorite emulator or your Dragon with this simple program:

For PMODE4 images:

10 PMODE 4,1:SCREEN 1,1 
20 PCLS 
30 CLOADM 
40 GOTO 40

For PMODE3 images:

10 PMODE 3,1:SCREEN 1,0 
20 PCLS 
30 CLOADM 
40 GOTO 40

The converted images should look like this on the XRoar emulator: 
[[file:PMODE4_FINAL.GIF|256px]][[file:PMODE3_FINAL.GIF|256px]]

And that's it. I hope you'll find this tutorial helpful. You can find the palettes and utilities right below.

== Downloads ==
* Utilities, palettes and source code: http://www.mediafire.com/?a32y1uvcd3ep228
* PMODE3 Palettes (RGB Values):
0 - Blue (0,0,255 or 0x0000FF)
1 - Green (0,255,0 or 0x00FF00)
2 - Yellow (255,255,0 or 0xFFFF00)
3 - Red (255,0,0 or 0xFF0000)

or

0 - Magenta (255,0,255 or 0xFF00FF)
1 - Cyan (0,255,255 or 0x00FFFF)
2 - Orange (255,166,0 or 0xFFA600)
3 - White (255,255,255 or 0xFFFFFF)

@@ Line 54: / Line 54: @@
 For PMODE4 images:
-PMODE 4,1:SCREEN 1,1<br>
+<pre>
-PCLS<br>
+PMODE 4,1:SCREEN 1,1
-CLOADM<br>
+PCLS
 GOTO 40
 For PMODE3 images:
-PMODE 3,1:SCREEN 1,0<br>
+<pre>
-PCLS<br>
+PMODE 3,1:SCREEN 1,0
-CLOADM<br>
+PCLS
 GOTO 40
-The converted images should look like this on the XRoar emulator:<br>
+The converted images should look like this on the [[XRoar]] emulator:<br>
 [[file:PMODE4_FINAL.GIF|256px]][[file:PMODE3_FINAL.GIF|256px]]

← Older revision		Revision as of 14:50, 5 August 2014
Line 85:		Line 85:
	2 - Orange (255,166,0 or 0xFFA600)		2 - Orange (255,166,0 or 0xFFA600)
	3 - White (255,255,255 or 0xFFFFFF)		3 - White (255,255,255 or 0xFFFFFF)
		+
		+
		+
		+	[[Category:Documentation]] [[Category:Software]] [[Category:Development]]

← Older revision		Revision as of 18:29, 31 January 2011
Line 17:		Line 17:

	[[file:PMODE4_RAW.gif]]		[[file:PMODE4_RAW.gif]]
		+
		+	Please remember to convert it back to grayscale image (with an 1:1 ratio) before saving, as Photoshop doesn't allow to save 1 bit raw images and the Raw2PMODE4 tool is designed to deal with each pixel as a byte.
		+	<br>

	On the other hand, if you'd like your image in PMODE3 (128x192 4 colors), you have to scale the image to 128x192 and convert it to indexed color with one of the two palettes for this mode. You'll find the palette information in the downloads section below.		On the other hand, if you'd like your image in PMODE3 (128x192 4 colors), you have to scale the image to 128x192 and convert it to indexed color with one of the two palettes for this mode. You'll find the palette information in the downloads section below.