Blame src/enc/token_enc.c

Packit 9c6abc
// Copyright 2011 Google Inc. All Rights Reserved.
Packit 9c6abc
//
Packit 9c6abc
// Use of this source code is governed by a BSD-style license
Packit 9c6abc
// that can be found in the COPYING file in the root of the source
Packit 9c6abc
// tree. An additional intellectual property rights grant can be found
Packit 9c6abc
// in the file PATENTS. All contributing project authors may
Packit 9c6abc
// be found in the AUTHORS file in the root of the source tree.
Packit 9c6abc
// -----------------------------------------------------------------------------
Packit 9c6abc
//
Packit 9c6abc
// Paginated token buffer
Packit 9c6abc
//
Packit 9c6abc
//  A 'token' is a bit value associated with a probability, either fixed
Packit 9c6abc
// or a later-to-be-determined after statistics have been collected.
Packit 9c6abc
// For dynamic probability, we just record the slot id (idx) for the probability
Packit 9c6abc
// value in the final probability array (uint8_t* probas in VP8EmitTokens).
Packit 9c6abc
//
Packit 9c6abc
// Author: Skal (pascal.massimino@gmail.com)
Packit 9c6abc
Packit 9c6abc
#include <assert.h>
Packit 9c6abc
#include <stdlib.h>
Packit 9c6abc
#include <string.h>
Packit 9c6abc
Packit 9c6abc
#include "src/enc/cost_enc.h"
Packit 9c6abc
#include "src/enc/vp8i_enc.h"
Packit 9c6abc
#include "src/utils/utils.h"
Packit 9c6abc
Packit 9c6abc
#if !defined(DISABLE_TOKEN_BUFFER)
Packit 9c6abc
Packit 9c6abc
// we use pages to reduce the number of memcpy()
Packit 9c6abc
#define MIN_PAGE_SIZE 8192          // minimum number of token per page
Packit 9c6abc
#define FIXED_PROBA_BIT (1u << 14)
Packit 9c6abc
Packit 9c6abc
typedef uint16_t token_t;  // bit #15: bit value
Packit 9c6abc
                           // bit #14: flags for constant proba or idx
Packit 9c6abc
                           // bits #0..13: slot or constant proba
Packit 9c6abc
struct VP8Tokens {
Packit 9c6abc
  VP8Tokens* next_;        // pointer to next page
Packit 9c6abc
};
Packit 9c6abc
// Token data is located in memory just after the next_ field.
Packit 9c6abc
// This macro is used to return their address and hide the trick.
Packit 9c6abc
#define TOKEN_DATA(p) ((const token_t*)&(p)[1])
Packit 9c6abc
Packit 9c6abc
//------------------------------------------------------------------------------
Packit 9c6abc
Packit 9c6abc
void VP8TBufferInit(VP8TBuffer* const b, int page_size) {
Packit 9c6abc
  b->tokens_ = NULL;
Packit 9c6abc
  b->pages_ = NULL;
Packit 9c6abc
  b->last_page_ = &b->pages_;
Packit 9c6abc
  b->left_ = 0;
Packit 9c6abc
  b->page_size_ = (page_size < MIN_PAGE_SIZE) ? MIN_PAGE_SIZE : page_size;
Packit 9c6abc
  b->error_ = 0;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
void VP8TBufferClear(VP8TBuffer* const b) {
Packit 9c6abc
  if (b != NULL) {
Packit 9c6abc
    VP8Tokens* p = b->pages_;
Packit 9c6abc
    while (p != NULL) {
Packit 9c6abc
      VP8Tokens* const next = p->next_;
Packit 9c6abc
      WebPSafeFree(p);
Packit 9c6abc
      p = next;
Packit 9c6abc
    }
Packit 9c6abc
    VP8TBufferInit(b, b->page_size_);
Packit 9c6abc
  }
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
static int TBufferNewPage(VP8TBuffer* const b) {
Packit 9c6abc
  VP8Tokens* page = NULL;
Packit 9c6abc
  if (!b->error_) {
Packit 9c6abc
    const size_t size = sizeof(*page) + b->page_size_ * sizeof(token_t);
Packit 9c6abc
    page = (VP8Tokens*)WebPSafeMalloc(1ULL, size);
Packit 9c6abc
  }
Packit 9c6abc
  if (page == NULL) {
Packit 9c6abc
    b->error_ = 1;
Packit 9c6abc
    return 0;
Packit 9c6abc
  }
Packit 9c6abc
  page->next_ = NULL;
Packit 9c6abc
Packit 9c6abc
  *b->last_page_ = page;
Packit 9c6abc
  b->last_page_ = &page->next_;
Packit 9c6abc
  b->left_ = b->page_size_;
Packit 9c6abc
  b->tokens_ = (token_t*)TOKEN_DATA(page);
Packit 9c6abc
  return 1;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
//------------------------------------------------------------------------------
Packit 9c6abc
Packit 9c6abc
#define TOKEN_ID(t, b, ctx) \
Packit 9c6abc
    (NUM_PROBAS * ((ctx) + NUM_CTX * ((b) + NUM_BANDS * (t))))
Packit 9c6abc
Packit 9c6abc
static WEBP_INLINE uint32_t AddToken(VP8TBuffer* const b, uint32_t bit,
Packit 9c6abc
                                     uint32_t proba_idx,
Packit 9c6abc
                                     proba_t* const stats) {
Packit 9c6abc
  assert(proba_idx < FIXED_PROBA_BIT);
Packit 9c6abc
  assert(bit <= 1);
Packit 9c6abc
  if (b->left_ > 0 || TBufferNewPage(b)) {
Packit 9c6abc
    const int slot = --b->left_;
Packit 9c6abc
    b->tokens_[slot] = (bit << 15) | proba_idx;
Packit 9c6abc
  }
Packit 9c6abc
  VP8RecordStats(bit, stats);
Packit 9c6abc
  return bit;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
static WEBP_INLINE void AddConstantToken(VP8TBuffer* const b,
Packit 9c6abc
                                         uint32_t bit, uint32_t proba) {
Packit 9c6abc
  assert(proba < 256);
Packit 9c6abc
  assert(bit <= 1);
Packit 9c6abc
  if (b->left_ > 0 || TBufferNewPage(b)) {
Packit 9c6abc
    const int slot = --b->left_;
Packit 9c6abc
    b->tokens_[slot] = (bit << 15) | FIXED_PROBA_BIT | proba;
Packit 9c6abc
  }
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
int VP8RecordCoeffTokens(int ctx, const struct VP8Residual* const res,
Packit 9c6abc
                         VP8TBuffer* const tokens) {
Packit 9c6abc
  const int16_t* const coeffs = res->coeffs;
Packit 9c6abc
  const int coeff_type = res->coeff_type;
Packit 9c6abc
  const int last = res->last;
Packit 9c6abc
  int n = res->first;
Packit 9c6abc
  uint32_t base_id = TOKEN_ID(coeff_type, n, ctx);
Packit 9c6abc
  // should be stats[VP8EncBands[n]], but it's equivalent for n=0 or 1
Packit 9c6abc
  proba_t* s = res->stats[n][ctx];
Packit 9c6abc
  if (!AddToken(tokens, last >= 0, base_id + 0, s + 0)) {
Packit 9c6abc
    return 0;
Packit 9c6abc
  }
Packit 9c6abc
Packit 9c6abc
  while (n < 16) {
Packit 9c6abc
    const int c = coeffs[n++];
Packit 9c6abc
    const int sign = c < 0;
Packit 9c6abc
    const uint32_t v = sign ? -c : c;
Packit 9c6abc
    if (!AddToken(tokens, v != 0, base_id + 1, s + 1)) {
Packit 9c6abc
      base_id = TOKEN_ID(coeff_type, VP8EncBands[n], 0);  // ctx=0
Packit 9c6abc
      s = res->stats[VP8EncBands[n]][0];
Packit 9c6abc
      continue;
Packit 9c6abc
    }
Packit 9c6abc
    if (!AddToken(tokens, v > 1, base_id + 2, s + 2)) {
Packit 9c6abc
      base_id = TOKEN_ID(coeff_type, VP8EncBands[n], 1);  // ctx=1
Packit 9c6abc
      s = res->stats[VP8EncBands[n]][1];
Packit 9c6abc
    } else {
Packit 9c6abc
      if (!AddToken(tokens, v > 4, base_id + 3, s + 3)) {
Packit 9c6abc
        if (AddToken(tokens, v != 2, base_id + 4, s + 4)) {
Packit 9c6abc
          AddToken(tokens, v == 4, base_id + 5, s + 5);
Packit 9c6abc
        }
Packit 9c6abc
      } else if (!AddToken(tokens, v > 10, base_id + 6, s + 6)) {
Packit 9c6abc
        if (!AddToken(tokens, v > 6, base_id + 7, s + 7)) {
Packit 9c6abc
          AddConstantToken(tokens, v == 6, 159);
Packit 9c6abc
        } else {
Packit 9c6abc
          AddConstantToken(tokens, v >= 9, 165);
Packit 9c6abc
          AddConstantToken(tokens, !(v & 1), 145);
Packit 9c6abc
        }
Packit 9c6abc
      } else {
Packit 9c6abc
        int mask;
Packit 9c6abc
        const uint8_t* tab;
Packit 9c6abc
        uint32_t residue = v - 3;
Packit 9c6abc
        if (residue < (8 << 1)) {          // VP8Cat3  (3b)
Packit 9c6abc
          AddToken(tokens, 0, base_id + 8, s + 8);
Packit 9c6abc
          AddToken(tokens, 0, base_id + 9, s + 9);
Packit 9c6abc
          residue -= (8 << 0);
Packit 9c6abc
          mask = 1 << 2;
Packit 9c6abc
          tab = VP8Cat3;
Packit 9c6abc
        } else if (residue < (8 << 2)) {   // VP8Cat4  (4b)
Packit 9c6abc
          AddToken(tokens, 0, base_id + 8, s + 8);
Packit 9c6abc
          AddToken(tokens, 1, base_id + 9, s + 9);
Packit 9c6abc
          residue -= (8 << 1);
Packit 9c6abc
          mask = 1 << 3;
Packit 9c6abc
          tab = VP8Cat4;
Packit 9c6abc
        } else if (residue < (8 << 3)) {   // VP8Cat5  (5b)
Packit 9c6abc
          AddToken(tokens, 1, base_id + 8, s + 8);
Packit 9c6abc
          AddToken(tokens, 0, base_id + 10, s + 9);
Packit 9c6abc
          residue -= (8 << 2);
Packit 9c6abc
          mask = 1 << 4;
Packit 9c6abc
          tab = VP8Cat5;
Packit 9c6abc
        } else {                         // VP8Cat6 (11b)
Packit 9c6abc
          AddToken(tokens, 1, base_id + 8, s + 8);
Packit 9c6abc
          AddToken(tokens, 1, base_id + 10, s + 9);
Packit 9c6abc
          residue -= (8 << 3);
Packit 9c6abc
          mask = 1 << 10;
Packit 9c6abc
          tab = VP8Cat6;
Packit 9c6abc
        }
Packit 9c6abc
        while (mask) {
Packit 9c6abc
          AddConstantToken(tokens, !!(residue & mask), *tab++);
Packit 9c6abc
          mask >>= 1;
Packit 9c6abc
        }
Packit 9c6abc
      }
Packit 9c6abc
      base_id = TOKEN_ID(coeff_type, VP8EncBands[n], 2);  // ctx=2
Packit 9c6abc
      s = res->stats[VP8EncBands[n]][2];
Packit 9c6abc
    }
Packit 9c6abc
    AddConstantToken(tokens, sign, 128);
Packit 9c6abc
    if (n == 16 || !AddToken(tokens, n <= last, base_id + 0, s + 0)) {
Packit 9c6abc
      return 1;   // EOB
Packit 9c6abc
    }
Packit 9c6abc
  }
Packit 9c6abc
  return 1;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
#undef TOKEN_ID
Packit 9c6abc
Packit 9c6abc
//------------------------------------------------------------------------------
Packit 9c6abc
// Final coding pass, with known probabilities
Packit 9c6abc
Packit 9c6abc
int VP8EmitTokens(VP8TBuffer* const b, VP8BitWriter* const bw,
Packit 9c6abc
                  const uint8_t* const probas, int final_pass) {
Packit 9c6abc
  const VP8Tokens* p = b->pages_;
Packit 9c6abc
  assert(!b->error_);
Packit 9c6abc
  while (p != NULL) {
Packit 9c6abc
    const VP8Tokens* const next = p->next_;
Packit 9c6abc
    const int N = (next == NULL) ? b->left_ : 0;
Packit 9c6abc
    int n = b->page_size_;
Packit 9c6abc
    const token_t* const tokens = TOKEN_DATA(p);
Packit 9c6abc
    while (n-- > N) {
Packit 9c6abc
      const token_t token = tokens[n];
Packit 9c6abc
      const int bit = (token >> 15) & 1;
Packit 9c6abc
      if (token & FIXED_PROBA_BIT) {
Packit 9c6abc
        VP8PutBit(bw, bit, token & 0xffu);  // constant proba
Packit 9c6abc
      } else {
Packit 9c6abc
        VP8PutBit(bw, bit, probas[token & 0x3fffu]);
Packit 9c6abc
      }
Packit 9c6abc
    }
Packit 9c6abc
    if (final_pass) WebPSafeFree((void*)p);
Packit 9c6abc
    p = next;
Packit 9c6abc
  }
Packit 9c6abc
  if (final_pass) b->pages_ = NULL;
Packit 9c6abc
  return 1;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
// Size estimation
Packit 9c6abc
size_t VP8EstimateTokenSize(VP8TBuffer* const b, const uint8_t* const probas) {
Packit 9c6abc
  size_t size = 0;
Packit 9c6abc
  const VP8Tokens* p = b->pages_;
Packit 9c6abc
  assert(!b->error_);
Packit 9c6abc
  while (p != NULL) {
Packit 9c6abc
    const VP8Tokens* const next = p->next_;
Packit 9c6abc
    const int N = (next == NULL) ? b->left_ : 0;
Packit 9c6abc
    int n = b->page_size_;
Packit 9c6abc
    const token_t* const tokens = TOKEN_DATA(p);
Packit 9c6abc
    while (n-- > N) {
Packit 9c6abc
      const token_t token = tokens[n];
Packit 9c6abc
      const int bit = token & (1 << 15);
Packit 9c6abc
      if (token & FIXED_PROBA_BIT) {
Packit 9c6abc
        size += VP8BitCost(bit, token & 0xffu);
Packit 9c6abc
      } else {
Packit 9c6abc
        size += VP8BitCost(bit, probas[token & 0x3fffu]);
Packit 9c6abc
      }
Packit 9c6abc
    }
Packit 9c6abc
    p = next;
Packit 9c6abc
  }
Packit 9c6abc
  return size;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
//------------------------------------------------------------------------------
Packit 9c6abc
Packit 9c6abc
#else     // DISABLE_TOKEN_BUFFER
Packit 9c6abc
Packit 9c6abc
void VP8TBufferInit(VP8TBuffer* const b, int page_size) {
Packit 9c6abc
  (void)b;
Packit 9c6abc
  (void)page_size;
Packit 9c6abc
}
Packit 9c6abc
void VP8TBufferClear(VP8TBuffer* const b) {
Packit 9c6abc
  (void)b;
Packit 9c6abc
}
Packit 9c6abc
Packit 9c6abc
#endif    // !DISABLE_TOKEN_BUFFER
Packit 9c6abc