added support for special media buttons on Amazon Fire TV remote control
[rocksndiamonds.git] / src / libgame / image.c
index d4fa1d8703fc398ef9b914ae1001e8267e927eeb..699093b7b7ebb718e6a6d74144ba3c5b81caada8 100644 (file)
-/***********************************************************
-* Artsoft Retro-Game Library                               *
-*----------------------------------------------------------*
-* (c) 1994-2000 Artsoft Entertainment                      *
-*               Holger Schemel                             *
-*               Detmolder Strasse 189                      *
-*               33604 Bielefeld                            *
-*               Germany                                    *
-*               e-mail: info@artsoft.org                   *
-*----------------------------------------------------------*
-* image.c                                                  *
-***********************************************************/
+// ============================================================================
+// Artsoft Retro-Game Library
+// ----------------------------------------------------------------------------
+// (c) 1995-2014 by Artsoft Entertainment
+//                         Holger Schemel
+//                 info@artsoft.org
+//                 http://www.artsoft.org/
+// ----------------------------------------------------------------------------
+// image.c
+// ============================================================================
 
 #include "image.h"
-#include "pcx.h"
 #include "misc.h"
+#include "setup.h"
 
 
-#if defined(TARGET_X11)
+struct ImageInfo
+{
+  char *source_filename;
+  int num_references;
+
+  Bitmap *bitmaps[NUM_IMG_BITMAP_POINTERS];
+
+  int original_width;                  /* original image file width */
+  int original_height;                 /* original image file height */
+
+  boolean contains_small_images;       /* set after adding small images */
+  boolean contains_textures;           /* set after adding GPU textures */
+  boolean scaled_up;                   /* set after scaling up */
 
-/* for MS-DOS/Allegro, exclude all except newImage() and freeImage() */
+  int conf_tile_size;                  /* tile size as defined in config */
+  int game_tile_size;                  /* tile size as resized for game */
 
-Image *newImage(unsigned int width, unsigned int height, unsigned int depth)
+  char *leveldir;                      /* level set when image was loaded */
+};
+typedef struct ImageInfo ImageInfo;
+
+static struct ArtworkListInfo *image_info = NULL;
+
+static void *Load_Image(char *filename)
 {
-  Image *image;
-  const unsigned int bytes_per_pixel = 1;
-  int i;
+  ImageInfo *img_info = checked_calloc(sizeof(ImageInfo));
+
+  if ((img_info->bitmaps[IMG_BITMAP_STANDARD] = LoadImage(filename)) == NULL)
+  {
+    Error(ERR_WARN, "cannot load image file '%s': LoadImage() failed: %s",
+         filename, GetError());
+
+    free(img_info);
+
+    return NULL;
+  }
+
+  img_info->source_filename = getStringCopy(filename);
 
-  if (depth > 8)
-    Error(ERR_EXIT, "images with more than 256 colors are not supported");
+  img_info->original_width  = img_info->bitmaps[IMG_BITMAP_STANDARD]->width;
+  img_info->original_height = img_info->bitmaps[IMG_BITMAP_STANDARD]->height;
 
-  depth = 8;
-  image = checked_malloc(sizeof(Image));
-  image->data = checked_malloc(width * height * bytes_per_pixel);
-  image->width = width;
-  image->height = height;
-  image->depth = depth;
-  image->rgb.used = 0;
-  for (i=0; i<MAX_COLORS; i++)
-    image->rgb.color_used[i] = FALSE;
+  img_info->contains_small_images = FALSE;
+  img_info->contains_textures = FALSE;
+  img_info->scaled_up = FALSE;
 
-  return image;
+  img_info->conf_tile_size = 0;                // will be set later
+  img_info->game_tile_size = 0;                // will be set later
+
+  img_info->leveldir = NULL;           // will be set later
+
+  return img_info;
 }
 
-void freeImage(Image *image)
+static void FreeImage(void *ptr)
 {
-  free(image->data);
+  ImageInfo *image = (ImageInfo *)ptr;
+  int i;
+
+  if (image == NULL)
+    return;
+
+  for (i = 0; i < NUM_IMG_BITMAPS; i++)
+    if (image->bitmaps[i])
+      FreeBitmap(image->bitmaps[i]);
+
+  if (image->source_filename)
+    free(image->source_filename);
+
   free(image);
 }
 
-#if defined(PLATFORM_UNIX)
+int getImageListSize()
+{
+  return (image_info->num_file_list_entries +
+         image_info->num_dynamic_file_list_entries);
+}
+
+struct FileInfo *getImageListEntryFromImageID(int pos)
+{
+  int num_list_entries = image_info->num_file_list_entries;
+  int list_pos = (pos < num_list_entries ? pos : pos - num_list_entries);
 
-/* extra colors to try allocating in private color maps to minimize flashing */
-#define NOFLASH_COLORS 256
+  return (pos < num_list_entries ? &image_info->file_list[list_pos] :
+         &image_info->dynamic_file_list[list_pos]);
+}
 
-/* architecture independent value-to-memory conversion
-   note: the internal format is big endian */
+static ImageInfo *getImageInfoEntryFromImageID(int pos)
+{
+  int num_list_entries = image_info->num_file_list_entries;
+  int list_pos = (pos < num_list_entries ? pos : pos - num_list_entries);
+  ImageInfo **img_info =
+    (ImageInfo **)(pos < num_list_entries ? image_info->artwork_list :
+                  image_info->dynamic_artwork_list);
 
-#define value_to_memory(value, ptr, length) (                          \
-(length) == 1 ? (*( (byte *)(ptr)   ) = ( value     ) ) :              \
-(length) == 2 ? (*( (byte *)(ptr)   ) = (((unsigned long)(value))>> 8),        \
-                *(((byte *)(ptr))+1) = ( value     ) ) :               \
-(length) == 3 ? (*( (byte *)(ptr)   ) = (((unsigned long)(value))>>16),        \
-                *(((byte *)(ptr))+1) = (((unsigned long)(value))>> 8), \
-                *(((byte *)(ptr))+2) = ( value     ) ) :               \
-                (*( (byte *)(ptr)   ) = (((unsigned long)(value))>>24),        \
-                *(((byte *)(ptr))+1) = (((unsigned long)(value))>>16), \
-                *(((byte *)(ptr))+2) = (((unsigned long)(value))>> 8), \
-                *(((byte *)(ptr))+3) = ( value     ) ))
+  return img_info[list_pos];
+}
 
-static Pixmap Image_to_Mask(Image *image, Display *display, Window window)
+Bitmap **getBitmapsFromImageID(int pos)
 {
-  byte *src_ptr, *dst_ptr, *dst_ptr2;
-  unsigned int bytes_per_row;
-  unsigned int x, y;
-  byte bitmask;
-  byte *mask_data;
-  Pixmap mask_pixmap;
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
 
-  bytes_per_row = (image->width + 7) / 8;
-  mask_data = checked_calloc(bytes_per_row * image->height);
+  return (img_info != NULL ? img_info->bitmaps : NULL);
+}
 
-  src_ptr = image->data;
-  dst_ptr = mask_data;
+int getOriginalImageWidthFromImageID(int pos)
+{
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
 
-  /* create bitmap data which can be used by 'XCreateBitmapFromData()'
-   * directly to create a pixmap of depth 1 for use as a clip mask for
-   * the corresponding image pixmap
-   */
+  return (img_info != NULL ? img_info->original_width : 0);
+}
 
-  for (y=0; y<image->height; y++)
-  {
-    bitmask = 0x01;            /* start with leftmost bit in the byte     */
-    dst_ptr2 = dst_ptr;                /* start with leftmost byte in the row     */
+int getOriginalImageHeightFromImageID(int pos)
+{
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
 
-    for (x=0; x<image->width; x++)
-    {
-      if (*src_ptr++)          /* source pixel solid? (pixel index != 0)  */
-       *dst_ptr2 |= bitmask;   /* then write a bit into the image mask    */
+  return (img_info != NULL ? img_info->original_height : 0);
+}
 
-      if ((bitmask <<= 1) == 0)        /* bit at rightmost byte position reached? */
-      {
-       bitmask = 0x01;         /* start again with leftmost bit position  */
-       dst_ptr2++;             /* continue with next byte in image mask   */
-      }
-    }
+char *getTokenFromImageID(int graphic)
+{
+  struct FileInfo *file_list = getImageListEntryFromImageID(graphic);
 
-    dst_ptr += bytes_per_row;  /* continue with leftmost byte of next row */
-  }
+  return (file_list != NULL ? file_list->token : NULL);
+}
 
-  mask_pixmap = XCreateBitmapFromData(display, window, (char *)mask_data,
-                                     image->width, image->height);
-  free(mask_data);
+char *getFilenameFromImageID(int graphic)
+{
+  struct FileInfo *file_list = getImageListEntryFromImageID(graphic);
 
-  return mask_pixmap;
+  return (file_list != NULL ? file_list->filename : NULL);
 }
 
-static int bitsPerPixelAtDepth(Display *display, int screen, int depth)
+int getImageIDFromToken(char *token)
 {
-  XPixmapFormatValues *pixmap_format;
-  int i, num_pixmap_formats, bits_per_pixel = -1;
+  struct FileInfo *file_list = image_info->file_list;
+  int num_list_entries = image_info->num_file_list_entries;
+  int i;
 
-  /* get Pixmap formats supported by the X server */
-  pixmap_format = XListPixmapFormats(display, &num_pixmap_formats);
+  for (i = 0; i < num_list_entries; i++)
+    if (strEqual(file_list[i].token, token))
+      return i;
 
-  /* find format that matches the given depth */
-  for (i=0; i<num_pixmap_formats; i++)
-    if (pixmap_format[i].depth == depth)
-      bits_per_pixel = pixmap_format[i].bits_per_pixel;
+  return -1;
+}
 
-  XFree(pixmap_format);
+char *getImageConfigFilename()
+{
+  return getCustomArtworkConfigFilename(image_info->type);
+}
 
-  if (bits_per_pixel == -1)
-    Error(ERR_EXIT, "cannot find pixmap format for depth %d", depth);
+int getImageListPropertyMappingSize()
+{
+  return image_info->num_property_mapping_entries;
+}
 
-  return bits_per_pixel;
+struct PropertyMapping *getImageListPropertyMapping()
+{
+  return image_info->property_mapping;
 }
 
-XImageInfo *Image_to_Pixmap(Display *display, int screen, Visual *visual,
-                           Window window, GC gc, int depth, Image *image)
+void InitImageList(struct ConfigInfo *config_list, int num_file_list_entries,
+                  struct ConfigTypeInfo *config_suffix_list,
+                  char **base_prefixes, char **ext1_suffixes,
+                  char **ext2_suffixes, char **ext3_suffixes,
+                  char **ignore_tokens)
 {
-  static XColor xcolor_private[NOFLASH_COLORS];
-  static int colorcell_used[NOFLASH_COLORS];
-  static Colormap global_cmap = 0;
-  static Pixel *global_cmap_index;
-  static int num_cmap_entries, free_cmap_entries;
-  static boolean private_cmap = FALSE;
-  Pixel *redvalue, *greenvalue, *bluevalue;
-  unsigned int a, c = 0, x, y, bytes_per_pixel, bits_per_pixel;
-  XColor xcolor;
-  XImage *ximage;
-  XImageInfo *ximageinfo;
-  byte *src_ptr, *dst_ptr;
-
-  if (!global_cmap)
-  {
-    if (visual == DefaultVisual(display, screen))
-      global_cmap = DefaultColormap(display, screen);
-    else
-    {
-      global_cmap = XCreateColormap(display, RootWindow(display, screen),
-                                   visual, AllocNone);
-      private_cmap = TRUE;
-    }
-  }
+  int i;
 
-  xcolor.flags = DoRed | DoGreen | DoBlue;
-  redvalue = greenvalue = bluevalue = NULL;
-  ximageinfo = checked_malloc(sizeof(XImageInfo));
-  ximageinfo->display = display;
-  ximageinfo->depth = depth;
+  image_info = checked_calloc(sizeof(struct ArtworkListInfo));
+  image_info->type = ARTWORK_TYPE_GRAPHICS;
 
-  switch (visual->class)
-  {
-    case TrueColor:
-    case DirectColor:
-    {
-      Pixel pixval;
-      unsigned int redcolors, greencolors, bluecolors;
-      unsigned int redstep, greenstep, bluestep;
-      unsigned int redbottom, greenbottom, bluebottom;
-      unsigned int redtop, greentop, bluetop;
+  /* ---------- initialize file list and suffix lists ---------- */
 
-      redvalue = (Pixel *)checked_malloc(sizeof(Pixel) * 256);
-      greenvalue = (Pixel *)checked_malloc(sizeof(Pixel) * 256);
-      bluevalue = (Pixel *)checked_malloc(sizeof(Pixel) * 256);
+  image_info->num_file_list_entries = num_file_list_entries;
+  image_info->num_dynamic_file_list_entries = 0;
 
-      ximageinfo->cmap = global_cmap;
+  image_info->file_list =
+    getFileListFromConfigList(config_list, config_suffix_list, ignore_tokens,
+                             num_file_list_entries);
+  image_info->dynamic_file_list = NULL;
 
-      retry_direct: /* tag we hit if a DirectColor allocation fails on
-                    * default colormap */
+  image_info->num_suffix_list_entries = 0;
+  for (i = 0; config_suffix_list[i].token != NULL; i++)
+    image_info->num_suffix_list_entries++;
 
-      /* calculate number of distinct colors in each band */
+  image_info->suffix_list = config_suffix_list;
 
-      redcolors = greencolors = bluecolors = 1;
-      for (pixval=1; pixval; pixval <<= 1)
-      {
-       if (pixval & visual->red_mask)
-         redcolors <<= 1;
-       if (pixval & visual->green_mask)
-         greencolors <<= 1;
-       if (pixval & visual->blue_mask)
-         bluecolors <<= 1;
-      }
-      
-      /* consistency check */
-      if (redcolors > visual->map_entries ||
-         greencolors > visual->map_entries ||
-         bluecolors > visual->map_entries)
-       Error(ERR_WARN, "inconsistency in color information");
-
-      redstep = 256 / redcolors;
-      greenstep = 256 / greencolors;
-      bluestep = 256 / bluecolors;
-      redbottom = greenbottom = bluebottom = 0;
-      redtop = greentop = bluetop = 0;
-      for (a=0; a<visual->map_entries; a++)
-      {
-       if (redbottom < 256)
-         redtop = redbottom + redstep;
-       if (greenbottom < 256)
-         greentop = greenbottom + greenstep;
-       if (bluebottom < 256)
-         bluetop = bluebottom + bluestep;
-
-       xcolor.red = (redtop - 1) << 8;
-       xcolor.green = (greentop - 1) << 8;
-       xcolor.blue = (bluetop - 1) << 8;
-       if (!XAllocColor(display, ximageinfo->cmap, &xcolor))
-       {
-         /* if an allocation fails for a DirectColor default visual then
-            we should create a private colormap and try again. */
-
-         if ((visual->class == DirectColor) &&
-             (visual == DefaultVisual(display, screen)))
-         {
-           global_cmap = XCopyColormapAndFree(display, global_cmap);
-           ximageinfo->cmap = global_cmap;
-           private_cmap = TRUE;
-
-           goto retry_direct;
-         }
-
-         /* something completely unexpected happened */
-
-         fprintf(stderr, "imageToXImage: XAllocColor failed on a TrueColor/Directcolor visual\n");
-          free(redvalue);
-          free(greenvalue);
-          free(bluevalue);
-          free(ximageinfo);
-         return NULL;
-       }
-
-       /* fill in pixel values for each band at this intensity */
-
-       while ((redbottom < 256) && (redbottom < redtop))
-         redvalue[redbottom++] = xcolor.pixel & visual->red_mask;
-       while ((greenbottom < 256) && (greenbottom < greentop))
-         greenvalue[greenbottom++] = xcolor.pixel & visual->green_mask;
-       while ((bluebottom < 256) && (bluebottom < bluetop))
-         bluevalue[bluebottom++] = xcolor.pixel & visual->blue_mask;
-      }
-      break;
-    }
+  /* ---------- initialize base prefix and suffixes lists ---------- */
 
-    case PseudoColor:
+  image_info->num_base_prefixes = 0;
+  for (i = 0; base_prefixes[i] != NULL; i++)
+    image_info->num_base_prefixes++;
 
-      ximageinfo->cmap = global_cmap;
+  image_info->num_ext1_suffixes = 0;
+  for (i = 0; ext1_suffixes[i] != NULL; i++)
+    image_info->num_ext1_suffixes++;
 
-      for (a=0; a<MAX_COLORS; a++)
-      {
-       XColor xcolor2;
-       unsigned short mask;
-       int color_found;
-       int i;
-
-       if (!image->rgb.color_used[a])
-         continue;
-
-       xcolor.red = *(image->rgb.red + a);
-       xcolor.green = *(image->rgb.green + a);
-       xcolor.blue = *(image->rgb.blue + a);
-  
-       /* look if this color already exists in our colormap */
-       if (!XAllocColor(display, ximageinfo->cmap, &xcolor))
-       {
-         if (!private_cmap)
-         {
-           if (options.verbose)
-             Error(ERR_RETURN, "switching to private colormap");
-
-           /* we just filled up the default colormap -- get a private one
-              which contains all already allocated colors */
-
-           global_cmap = XCopyColormapAndFree(display, global_cmap);
-           ximageinfo->cmap = global_cmap;
-           private_cmap = TRUE;
-
-           /* allocate the rest of the color cells read/write */
-           global_cmap_index =
-             (Pixel *)checked_malloc(sizeof(Pixel) * NOFLASH_COLORS);
-           for (i=0; i<NOFLASH_COLORS; i++)
-             if (!XAllocColorCells(display, global_cmap, FALSE, NULL, 0,
-                                   global_cmap_index + i, 1))
-               break;
-           num_cmap_entries = free_cmap_entries = i;
-
-           /*
-           printf("We've got %d free colormap entries.\n", free_cmap_entries);
-           */
-
-           /* to minimize colormap flashing, copy default colors and try
-              to keep them as near as possible to the old values */
-
-           for(i=0; i<num_cmap_entries; i++)
-           {
-             xcolor2.pixel = *(global_cmap_index + i);
-             XQueryColor(display, DefaultColormap(display, screen), &xcolor2);
-             XStoreColor(display, global_cmap, &xcolor2);
-             xcolor_private[xcolor2.pixel] = xcolor2;
-             colorcell_used[xcolor2.pixel] = FALSE;
-           }
-
-           /* now we have the default colormap private: all colors we
-              successfully allocated so far are read-only, which is okay,
-              because we don't want to change them anymore -- if we need
-              an existing color again, we get it by XAllocColor; all other
-              colors are read/write and we can set them by XStoreColor,
-              but we will try to overwrite those color cells with our new
-              color which are as close as possible to our new color */
-         }
-
-         /* look for an existing default color close the one we want */
-
-         mask = 0xf000;
-         color_found = FALSE;
-
-         while (!color_found)
-         {
-           for (i=num_cmap_entries-1; i>=0; i--)
-           {
-             xcolor2.pixel = *(global_cmap_index + i);
-             xcolor2 = xcolor_private[xcolor2.pixel];
-
-             if (colorcell_used[xcolor2.pixel])
-               continue;
-
-             if ((xcolor.red & mask) == (xcolor2.red & mask) &&
-                 (xcolor.green & mask) == (xcolor2.green & mask) &&
-                 (xcolor.blue & mask) == (xcolor2.blue & mask))
-             {
-               /*
-               printf("replacing color cell %ld with a close color\n",
-                      xcolor2.pixel);
-                      */
-               color_found = TRUE;
-               break;
-             }
-           }
-
-           if (mask == 0x0000)
-             break;
-
-           mask = (mask << 1) & 0xffff;
-         }
-
-         if (!color_found)             /* no more free color cells */
-           Error(ERR_EXIT, "cannot allocate enough color cells");
-
-         xcolor.pixel = xcolor2.pixel;
-         xcolor_private[xcolor.pixel] = xcolor;
-         colorcell_used[xcolor.pixel] = TRUE;
-         XStoreColor(display, ximageinfo->cmap, &xcolor);
-         free_cmap_entries--;
-       }
-
-       *(ximageinfo->index + a) = xcolor.pixel;
-      }
+  image_info->num_ext2_suffixes = 0;
+  for (i = 0; ext2_suffixes[i] != NULL; i++)
+    image_info->num_ext2_suffixes++;
 
-      /*
-      printf("still %d free colormap entries\n", free_cmap_entries);
-      */
-
-      ximageinfo->no = a;      /* number of pixels allocated for this image */
-      break;
-  
-    default:
-      Error(ERR_RETURN, "display class not supported");
-      Error(ERR_EXIT, "DirectColor, TrueColor or PseudoColor display needed");
-      break;
-  }
+  image_info->num_ext3_suffixes = 0;
+  for (i = 0; ext3_suffixes[i] != NULL; i++)
+    image_info->num_ext3_suffixes++;
+
+  image_info->num_ignore_tokens = 0;
+  for (i = 0; ignore_tokens[i] != NULL; i++)
+    image_info->num_ignore_tokens++;
+
+  image_info->base_prefixes = base_prefixes;
+  image_info->ext1_suffixes = ext1_suffixes;
+  image_info->ext2_suffixes = ext2_suffixes;
+  image_info->ext3_suffixes = ext3_suffixes;
+  image_info->ignore_tokens = ignore_tokens;
 
-#if DEBUG_TIMING
-  debug_print_timestamp(2, "   ALLOCATING IMAGE COLORS:   ");
-#endif
+  image_info->num_property_mapping_entries = 0;
 
-  /* create XImage from internal image structure and convert it to Pixmap */
+  image_info->property_mapping = NULL;
 
-  bits_per_pixel = bitsPerPixelAtDepth(display, screen, depth);
-  bytes_per_pixel = (bits_per_pixel + 7) / 8;
+  /* ---------- initialize artwork reference and content lists ---------- */
 
-  ximage = XCreateImage(display, visual, depth, ZPixmap, 0,
-                       NULL, image->width, image->height,
-                       8, image->width * bytes_per_pixel);
-  ximage->data =
-    checked_malloc(image->width * image->height * bytes_per_pixel);
-  ximage->byte_order = MSBFirst;
+  image_info->sizeof_artwork_list_entry = sizeof(ImageInfo *);
 
-  src_ptr = image->data;
-  dst_ptr = (byte *)ximage->data;
+  image_info->artwork_list =
+    checked_calloc(num_file_list_entries * sizeof(ImageInfo *));
+  image_info->dynamic_artwork_list = NULL;
 
-  switch (visual->class)
+  image_info->content_list = NULL;
+
+  /* ---------- initialize artwork loading/freeing functions ---------- */
+
+  image_info->load_artwork = Load_Image;
+  image_info->free_artwork = FreeImage;
+}
+
+void ReloadCustomImages()
+{
+  print_timestamp_init("ReloadCustomImages");
+
+  LoadArtworkConfig(image_info);
+  print_timestamp_time("LoadArtworkConfig");
+
+  ReloadCustomArtworkList(image_info);
+  print_timestamp_time("ReloadCustomArtworkList");
+
+  print_timestamp_done("ReloadCustomImages");
+}
+
+static boolean CheckIfImageContainsSmallImages(ImageInfo *img_info,
+                                              int tile_size)
+{
+  if (!img_info->contains_small_images)
+    return FALSE;
+
+  // at this point, small images already exist for this image;
+  // now do some checks that may require re-creating small (or in-game) images
+
+  // special case 1:
+  //
+  // check if the configured tile size for an already loaded image has changed
+  // from one level set to another; this should usually not happen, but if a
+  // custom artwork set redefines classic (or default) graphics with wrong tile
+  // size (by mistake or by intention), it will be corrected to its original
+  // tile size here by forcing complete re-creation of all small images again
+
+  if (!strEqual(img_info->leveldir, leveldir_current->identifier) &&
+      img_info->conf_tile_size != tile_size)
   {
-    case DirectColor:
-    case TrueColor:
+    int bitmap_nr = GET_BITMAP_ID_FROM_TILESIZE(img_info->conf_tile_size);
+    int i;
+
+    // free all calculated, resized bitmaps, but keep last configured size
+    for (i = 0; i < NUM_IMG_BITMAPS; i++)
     {
-      Pixel pixval;
+      if (i == bitmap_nr)
+       continue;
 
-      for (y=0; y<image->height; y++)          /* general case */
+      if (img_info->bitmaps[i])
       {
-       for (x=0; x<image->width; x++)
-       {
-         pixval = *src_ptr++;
-         pixval =
-           redvalue[image->rgb.red[pixval] >> 8] |
-           greenvalue[image->rgb.green[pixval] >> 8] |
-           bluevalue[image->rgb.blue[pixval] >> 8];
-         value_to_memory(pixval, dst_ptr, bytes_per_pixel);
-         dst_ptr += bytes_per_pixel;
-       }
+       FreeBitmap(img_info->bitmaps[i]);
+
+       img_info->bitmaps[i] = NULL;
       }
-      break;
     }
 
-    case PseudoColor:
+    // re-create small bitmaps from last configured size as new default size
+    if (bitmap_nr != IMG_BITMAP_STANDARD)
     {
-      if (bytes_per_pixel == 1)                        /* (common) special case */
-      {
-       for (y=0; y<image->height; y++)
-         for (x=0; x<image->width; x++)
-           *dst_ptr++ = ximageinfo->index[c + *src_ptr++];
-      }
-      else                                     /* general case */
-      {
-       for (y=0; y<image->height; y++)
-       {
-         for (x=0; x<image->width; x++)
-         {
-           value_to_memory(ximageinfo->index[c + *src_ptr++],
-                           dst_ptr, bytes_per_pixel);
-           dst_ptr += bytes_per_pixel;
-         }
-       }
-      }
-      break;
+      img_info->bitmaps[IMG_BITMAP_STANDARD] = img_info->bitmaps[bitmap_nr];
+      img_info->bitmaps[bitmap_nr] = NULL;
     }
 
-    default:
-      Error(ERR_RETURN, "display class not supported");
-      Error(ERR_EXIT, "DirectColor, TrueColor or PseudoColor display needed");
-      break;
-  }
+    img_info->contains_small_images = FALSE;
 
-  if (redvalue)
-  {
-    free((byte *)redvalue);
-    free((byte *)greenvalue);
-    free((byte *)bluevalue);
+    return FALSE;
   }
 
-#if DEBUG_TIMING
-  debug_print_timestamp(2, "   CONVERTING IMAGE TO XIMAGE:");
-#endif
+  // special case 1 (continued):
+  //
+  // if different tile sizes are used in same image file (usually by mistake,
+  // like forgetting option ".tile_size" for one or more graphic definitions),
+  // make sure to use only the first tile size that is processed for this image
+  // (and ignore all subsequent, potentially different tile size definitions
+  // for this image within the current level set by disabling the above check)
 
-  ximageinfo->pixmap = XCreatePixmap(display, window,
-                                    ximage->width, ximage->height,
-                                    ximageinfo->depth);
+  setString(&img_info->leveldir, leveldir_current->identifier);
 
-  XPutImage(ximageinfo->display, ximageinfo->pixmap, gc,
-           ximage, 0, 0, 0, 0, ximage->width, ximage->height);
+  // special case 2:
+  //
+  // graphic config setting "game.tile_size" has changed since last level set;
+  // this may require resizing image to new size required for in-game graphics
 
-  free(ximage->data);
-  ximage->data = NULL;
-  XDestroyImage(ximage);
+  if (img_info->game_tile_size != gfx.game_tile_size)
+  {
+    ReCreateGameTileSizeBitmap(img_info->bitmaps);
 
-  return(ximageinfo);
+    img_info->game_tile_size = gfx.game_tile_size;
+  }
+
+  return TRUE;
 }
 
-void freeXImage(Image *image, XImageInfo *ximageinfo)
+void CreateImageWithSmallImages(int pos, int zoom_factor, int tile_size)
 {
-  if (ximageinfo->index != NULL && ximageinfo->no > 0)
-    XFreeColors(ximageinfo->display, ximageinfo->cmap, ximageinfo->index,
-               ximageinfo->no, 0);
-  /* this       ^^^^^^^^^^^^^^ is wrong, because the used color cells
-   * are somewhere between 0 and MAX_COLORS; there are indeed 'ximageinfo->no'
-   * used color cells, but they are not at array position 0 - 'ximageinfo->no'
-   */
-
-  free(ximageinfo);
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
+
+  if (img_info == NULL)
+    return;
+
+  if (CheckIfImageContainsSmallImages(img_info, tile_size))
+    return;
+
+  CreateBitmapWithSmallBitmaps(img_info->bitmaps, zoom_factor, tile_size);
+
+  img_info->contains_small_images = TRUE;
+  img_info->scaled_up = TRUE;                  // scaling was also done here
+
+  img_info->conf_tile_size = tile_size;
+  img_info->game_tile_size = gfx.game_tile_size;
+
+  setString(&img_info->leveldir, leveldir_current->identifier);
 }
 
-int Read_PCX_to_Pixmap(Display *display, Window window, GC gc, char *filename,
-                      Pixmap *pixmap, Pixmap *pixmap_mask)
+void CreateImageTextures(int pos)
 {
-  Image *image;
-  XImageInfo *ximageinfo;
-  int screen;
-  Visual *visual;
-  int depth;
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
 
-#if DEBUG_TIMING
-  debug_print_timestamp(2, NULL);      /* initialize timestamp function */
-#endif
+  if (img_info == NULL || img_info->contains_textures)
+    return;
 
-  /* read the graphic file in PCX format to image structure */
-  if ((image = Read_PCX_to_Image(filename)) == NULL)
-    return errno_pcx;
+  CreateBitmapTextures(img_info->bitmaps);
 
-#if DEBUG_TIMING
-  printf("%s:\n", filename);
-  debug_print_timestamp(2, "   READING PCX FILE TO IMAGE: ");
-#endif
+  img_info->contains_textures = TRUE;
+}
 
-  screen = DefaultScreen(display);
-  visual = DefaultVisual(display, screen);
-  depth = DefaultDepth(display, screen);
+void FreeImageTextures(int pos)
+{
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
 
-  /* convert image structure to X11 Pixmap */
-  if (!(ximageinfo = Image_to_Pixmap(display, screen, visual,
-                                    window, gc, depth, image)))
-    Error(ERR_EXIT, "cannot convert Image to Pixmap");
+  if (img_info == NULL || !img_info->contains_textures)
+    return;
 
-  /* if a private colormap has been created, install it */
-  if (ximageinfo->cmap != DefaultColormap(display, screen))
-    XSetWindowColormap(display, window, ximageinfo->cmap);
+  FreeBitmapTextures(img_info->bitmaps);
 
-#if DEBUG_TIMING
-  debug_print_timestamp(2, "   CONVERTING IMAGE TO PIXMAP:");
-#endif
+  img_info->contains_textures = FALSE;
+}
 
-  /* create clip mask for the image */
-  ximageinfo->pixmap_mask = Image_to_Mask(image, display, window);
+void FreeAllImageTextures()
+{
+  int num_images = getImageListSize();
+  int i;
 
-#if DEBUG_TIMING
-  debug_print_timestamp(2, "   CONVERTING IMAGE TO MASK:  ");
-#endif
+  for (i = 0; i < num_images; i++)
+    FreeImageTextures(i);
+}
+
+void ScaleImage(int pos, int zoom_factor)
+{
+  ImageInfo *img_info = getImageInfoEntryFromImageID(pos);
 
-  *pixmap = ximageinfo->pixmap;
-  *pixmap_mask = ximageinfo->pixmap_mask;
+  if (img_info == NULL || img_info->scaled_up)
+    return;
 
-  return PCX_Success;
+  if (zoom_factor != 1)
+    ScaleBitmap(img_info->bitmaps, zoom_factor);
+
+  img_info->scaled_up = TRUE;
 }
 
-#endif /* PLATFORM_UNIX */
-#endif /* TARGET_X11 */
+void FreeAllImages()
+{
+  FreeCustomArtworkLists(image_info);
+}