Function PPic_GetBitmapHandle

Descent3/PilotPicsAPI.cpp:420–468

---------------------------------------------------------- PPic_GetBitmapHandle Purpose: Given a pilot id, it will return a handle to the bitmap for the pilot. MAKE SURE YOU FREE THE BITMAP WITH bm_FreeBitmap(). Returns -1 if it was an illegal pilot id. Returns BAD_BITMAP_HANDLE if it couldn't open the bitmap. ----------------------------------------------------------

//	Returns BAD_BITMAP_HANDLE if it couldn't open the bitmap.
// ----------------------------------------------------------
int PPic_GetBitmapHandle(uint16_t pilot_id) {
  if (!PilotPic_init)
    return -1;

  int oldoffset = cftell(PilotPic_database_index_handle);

  int offset = PPic_GetOffsetByID(pilot_id);
  if (offset == -1)
    return -1;

  // jump to the offset
  // ------------------
  cfseek(PilotPic_database_index_handle, offset, SEEK_SET);
  if (cfeof(PilotPic_database_index_handle)) {
    cfseek(PilotPic_database_index_handle, oldoffset, SEEK_SET);
    return -1;
  }

  // read in the pilot name
  // ----------------------
  uint8_t name_size;
  char name_buffer[PILOT_STRING_SIZE];
  name_size = cf_ReadByte(PilotPic_database_index_handle);
  if (cfeof(PilotPic_database_index_handle)) {
    cfseek(PilotPic_database_index_handle, oldoffset, SEEK_SET);
    return -1;
  }
  cf_ReadBytes((uint8_t *)name_buffer, name_size, PilotPic_database_index_handle);
  name_buffer[name_size] = '\0';

  // next read in pilot_id
  uint16_t pid;
  pid = (uint16_t)cf_ReadShort(PilotPic_database_index_handle);

  // next read past the bitmap name
  uint8_t bmp_size;
  char bitmap_name[_MAX_PATH];
  bmp_size = cf_ReadByte(PilotPic_database_index_handle);
  cf_ReadBytes((uint8_t *)bitmap_name, bmp_size, PilotPic_database_index_handle);
  bitmap_name[bmp_size] = '\0';

  cfseek(PilotPic_database_index_handle, oldoffset, SEEK_SET);

  int bm_handle = bm_AllocLoadFileBitmap(IGNORE_TABLE(bitmap_name), 0);
  if (bm_handle <= BAD_BITMAP_HANDLE)
    return BAD_BITMAP_HANDLE;

  return bm_handle;
}

// ===============================================================================