falcon4:file_formats:apl_fileformat
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
falcon4:file_formats:apl_fileformat [2009-02-06 22:47] lightning created |
falcon4:file_formats:apl_fileformat [2009-02-06 22:50] (current) |
||
|---|---|---|---|
| Line 6: | Line 6: | ||
| APL file format: | APL file format: | ||
| ^Data Type^Width(Bytes)^Field Name^Description^ | ^Data Type^Width(Bytes)^Field Name^Description^ | ||
| - | |DWORD|4|MAGIC| = 0x030870, the magic number that identifies this file as an .APL file)| | + | |DWORD|4|MAGIC| = ''%%0x030870%%'', the magic number that identifies this file as an .APL file)| |
| |WORD|2|WIDTH|width of the image in pixels| | |WORD|2|WIDTH|width of the image in pixels| | ||
| |WORD|2|HEIGHT|height of the image in pixels| | |WORD|2|HEIGHT|height of the image in pixels| | ||
| - | |DWORD[256]|1024|PALETTE| every 4 bytes (i.e. each DWORD) represents a single palette entry; a palette therefore holds 256 entries, numbered 0-255.\\ The high byte = ALPHA, and the next 3 bytes are Red, Green, and Blue, respectively. | | + | |DWORD[256]|1024|PALETTE| every 4 bytes (i.e. each DWORD) represents a single palette entry; a palette therefore holds 256 entries, numbered 0-255.\\ The high-order byte = ALPHA, and the next lower-order 3 bytes are Red, Green, and Blue, respectively. | |
| |BYTE[]|WIDTH*HEIGHT|IMAGEDATA|Each byte in the IMAGEDATA section represents one pixel in the image; each byte's value is an offset into the palette array (0-255)| | |BYTE[]|WIDTH*HEIGHT|IMAGEDATA|Each byte in the IMAGEDATA section represents one pixel in the image; each byte's value is an offset into the palette array (0-255)| | ||
| ===== Reading an .APL file ===== | ===== Reading an .APL file ===== | ||
| - | * check the first DWORD (4 bytes) to see that it equals 0x030870; if so, this is an APL file\\ | + | * check the first DWORD (4 bytes) to see that it equals ''%%0x030870%%''; if so, this is an APL file\\ |
| * then check the next WORD (2 bytes), this is the width, in pixels, of the image\\ | * then check the next WORD (2 bytes), this is the width, in pixels, of the image\\ | ||
| * then check the next WORD (2 bytes), this is the height, in pixels, of the image\\ | * then check the next WORD (2 bytes), this is the height, in pixels, of the image\\ | ||
| Line 19: | Line 19: | ||
| * the next (width * height) bytes represent the image data itself, one byte per pixel, with one row's worth of pixel data coming first, then the next row's worth of pixel data, etc. The first byte represents the upper-left pixel in the image/texture; the last byte represents the lower-left pixel in the image/texture. | * the next (width * height) bytes represent the image data itself, one byte per pixel, with one row's worth of pixel data coming first, then the next row's worth of pixel data, etc. The first byte represents the upper-left pixel in the image/texture; the last byte represents the lower-left pixel in the image/texture. | ||
| - | The byte value associated with each pixel, provides an index into the palette array, telling you which palette entry to use for determining the color to use for rendering that pixel. Just look up the corresponding palette entry to get the color data for that pixel, as well as the alpha channel value. If the alpha component is set to 0x80, then this magic value means do not use ALPHA. | + | The byte value associated with each pixel, provides an index into the palette array, telling you which palette entry to use for determining the color to use for rendering that pixel. Just look up the corresponding palette entry to get the color data for that pixel, as well as the alpha channel value. If the alpha component is set to ''%%0x80%%'', then this magic value means do not use ALPHA. |
falcon4/file_formats/apl_fileformat.1233960479.txt.gz ยท Last modified: 2009-02-06 22:47 (external edit)
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
