Function GetTextureBitmap

Descent3/gametexture.cpp:471–540

Given a texture handle, returns that textures bitmap If the texture is animated, returns framenum mod num_of_frames in the animation Force is to force the evaluation of a procedural Also figures in gametime

// Force is to force the evaluation of a procedural
// Also figures in gametime
int GetTextureBitmap(int handle, int framenum, bool force) {
  int src_bitmap;

  if (!GameTextures[handle].used)
    return 0;

  if (GameTextures[handle].flags & TF_ANIMATED) {
    float cur_frametime;
    int int_frame;
    texture *tex = &GameTextures[handle];
    PageInVClip(GameTextures[handle].bm_handle);

    vclip *vc = &GameVClips[GameTextures[handle].bm_handle];
    ASSERT(vc->used >= 1);

    if (GameTextures[handle].flags & TF_PING_PONG) {
      // Ping pong this texture

      float frametime = tex->speed / vc->num_frames;
      cur_frametime = Gametime / frametime;
      int_frame = cur_frametime;
      int_frame += framenum;

      int_frame %= (vc->num_frames * 2);
      if (int_frame >= vc->num_frames)
        int_frame = (vc->num_frames - 1) - (int_frame % vc->num_frames);
      else
        int_frame %= vc->num_frames;
      src_bitmap = vc->frames[int_frame];
    } else {
      float frametime = tex->speed / vc->num_frames;
      cur_frametime = Gametime / frametime;
      int_frame = cur_frametime;
      int_frame += framenum;
      src_bitmap = vc->frames[int_frame % vc->num_frames];
    }
  } else {
    src_bitmap = GameTextures[handle].bm_handle;
  }

  if (GameTextures[handle].flags & TF_PROCEDURAL) // Do a procedural
  {
    int do_eval = 1;

    if (GameTextures[handle].procedural == NULL)
      AllocateProceduralForTexture(handle);

    if (GameTextures[handle].procedural->last_procedural_frame == FrameCount)
      do_eval = 0;
    if (timer_GetTime() <
        GameTextures[handle].procedural->last_evaluation_time + GameTextures[handle].procedural->evaluation_time)
      do_eval = 0;

    if (!force && !Detail_settings.Procedurals_enabled) {
      if (timer_GetTime() < GameTextures[handle].procedural->last_evaluation_time + 10.0)
        do_eval = 0;
    }