1 /*****************************************************************************/
5 /* Bitmap definition for the sp65 sprite and bitmap utility */
9 /* (C) 2012, Ullrich von Bassewitz */
10 /* Roemerstrasse 52 */
11 /* D-70794 Filderstadt */
12 /* EMail: uz@cc65.org */
15 /* This software is provided 'as-is', without any expressed or implied */
16 /* warranty. In no event will the authors be held liable for any damages */
17 /* arising from the use of this software. */
19 /* Permission is granted to anyone to use this software for any purpose, */
20 /* including commercial applications, and to alter it and redistribute it */
21 /* freely, subject to the following restrictions: */
23 /* 1. The origin of this software must not be misrepresented; you must not */
24 /* claim that you wrote the original software. If you use this software */
25 /* in a product, an acknowledgment in the product documentation would be */
26 /* appreciated but is not required. */
27 /* 2. Altered source versions must be plainly marked as such, and must not */
28 /* be misrepresented as being the original software. */
29 /* 3. This notice may not be removed or altered from any source */
32 /*****************************************************************************/
46 /*****************************************************************************/
48 /*****************************************************************************/
52 Bitmap* NewBitmap (unsigned Width, unsigned Height)
53 /* Create a new bitmap. The type is set to unknown and the palette to NULL */
57 /* Calculate the size of the bitmap in pixels */
58 unsigned long Size = (unsigned long) Width * Height;
60 /* Some safety checks */
61 PRECONDITION (Size > 0 && Size <= BM_MAX_SIZE);
64 B = xmalloc (sizeof (*B) + (Size - 1) * sizeof (B->Data[0]));
66 /* Initialize the data */
73 /* Return the bitmap */
79 void FreeBitmap (Bitmap* B)
80 /* Free a dynamically allocated bitmap */
82 /* Free the palette */
88 int ValidBitmapSize (unsigned Width, unsigned Height)
89 /* Return true if this is a valid size for a bitmap */
91 /* Calculate the size of the bitmap in pixels */
92 unsigned long Size = (unsigned long) Width * Height;
95 return (Size > 0 && Size <= BM_MAX_SIZE);
100 Color GetPixelColor (const Bitmap* B, unsigned X, unsigned Y)
101 /* Get the color for a given pixel. For indexed bitmaps, the palette entry
105 /* Get the pixel at the given coordinates */
106 Pixel P = GetPixel (B, X, Y);
108 /* If the bitmap has a palette, return the color from the palette. For
109 * simplicity, we will only check the palette, not the type.
112 if (P.Index >= B->Pal->Count) {
113 /* Palette index is invalid */
114 Error ("Invalid palette index %u at position %u/%u of \"%*s\"",
115 P.Index, X, Y, SB_GetLen (&B->Name),
116 SB_GetConstBuf (&B->Name));
118 return B->Pal->Entries[P.Index];
126 Pixel GetPixel (const Bitmap* B, unsigned X, unsigned Y)
127 /* Return a pixel from the bitmap. The returned value may either be a color
128 * or a palette index, depending on the type of the bitmap.
131 /* Check the coordinates */
132 PRECONDITION (X < B->Width && Y < B->Height);
134 /* Return the pixel */
135 return B->Data[Y * B->Width + X];