dst_data.c

/***********************************************************************
MPEG-4 Audio RM Module
Lossless coding of 1-bit oversampled audio - DST (Direct Stream Transfer)

This software was originally developed by:

* Aad Rijnberg 
  Philips Digital Systems Laboratories Eindhoven 
  <aad.rijnberg@philips.com>

* Fons Bruekers
  Philips Research Laboratories Eindhoven
  <fons.bruekers@philips.com>
   
* Eric Knapen
  Philips Digital Systems Laboratories Eindhoven
  <h.w.m.knapen@philips.com> 

And edited by:

* Richard Theelen
  Philips Digital Systems Laboratories Eindhoven
  <r.h.m.theelen@philips.com>

* Maxim Anisiutkin
  ICT Group
  <maxim.anisiutkin@gmail.com>

in the course of development of the MPEG-4 Audio standard ISO-14496-1, 2 and 3.
This software module is an implementation of a part of one or more MPEG-4 Audio
tools as specified by the MPEG-4 Audio standard. ISO/IEC gives users of the
MPEG-4 Audio standards free licence to this software module or modifications
thereof for use in hardware or software products claiming conformance to the
MPEG-4 Audio standards. Those intending to use this software module in hardware
or software products are advised that this use may infringe existing patents.
The original developers of this software of this module and their company,
the subsequent editors and their companies, and ISO/EIC have no liability for
use of this software module or modifications thereof in an implementation.
Copyright is not released for non MPEG-4 Audio conforming products. The
original developer retains full right to use this code for his/her own purpose,
assign or donate the code to a third party and to inhibit third party from
using the code for non MPEG-4 Audio conforming products. This copyright notice
must be included in all copies of derivative works.

Copyright  2004.

Source file: DSTData.c (DSTData object)

Required libraries: <none>

Authors:
RT:  Richard Theelen, PDSL-labs Eindhoven <r.h.m.theelen@philips.com>
MA:  Maxim Anisiutkin, ICT Group <maxim.anisiutkin@gmail.com>

Changes:
08-Mar-2004 RT  Initial version
29-Jun-2011 MA  Modified to run in multithreaded environment

************************************************************************/


/*============================================================================*/
/*       INCLUDES                                                             */
/*============================================================================*/

#include <malloc.h>
#include <memory.h>
#include <stdio.h>
#include <stdlib.h>
#include "types.h"
#include "dst_data.h"


/***********************************************************************
 * Forward declaration function prototype
 ***********************************************************************/

int getbits(StrData* S, long *outword, int out_bitptr);


/***********************************************************************
 * GetDSTDataPointer
 ***********************************************************************/

int GetDSTDataPointer (StrData* SD, uint8_t** pBuffer)
{
  int hr = 0;

  *pBuffer = SD->DSTdata;

  return (hr);
}


/***********************************************************************
 * ResetReadingIndex
 ***********************************************************************/

int ResetReadingIndex(StrData* SD)
{
  int hr = 0;

  SD->BitPosition = 0;
  SD->ByteCounter = 0;
  SD->DataByte    = 0;

  return (hr);
}


/***********************************************************************
 * CreateBuffer
 ***********************************************************************/

int CreateBuffer(StrData* SD, int32_t Size) {
	int hr = 0;
	if (Size > sizeof(SD->DSTdata)) {
		SD->TotalBytes = sizeof(SD->DSTdata);
		hr = -1;
	}
	else {
		SD->TotalBytes = Size;
	}
  return hr;
}


/***********************************************************************
 * DeleteBuffer
 ***********************************************************************/

int DeleteBuffer(StrData* SD)
{
  int hr = 0;

  SD->TotalBytes = 0;

  ResetReadingIndex(SD);

  return (hr);
}


/***********************************************************************
 * FillBuffer
 ***********************************************************************/

int FillBuffer(StrData* SD, uint8_t* pBuf, int32_t Size) {
	int hr = 0;

	hr = CreateBuffer(SD, Size);
	memcpy(SD->DSTdata, pBuf, SD->TotalBytes);
  ResetReadingIndex(SD);
  return hr;
}


/***************************************************************************/
/*                                                                         */
/* name     : FIO_BitGetChrUnsigned                                        */
/*                                                                         */
/* function : Read a character as an unsigned number from file with a      */
/*            given number of bits.                                        */
/*                                                                         */
/* pre      : Len, x, output file must be open by having used getbits_init */
/*                                                                         */
/* post     : The second variable in function call is filled with the      */
/*            unsigned character read                                      */
/*                                                                         */
/* uses     : stdio.h, stdlib.h                                            */
/*                                                                         */
/***************************************************************************/

int FIO_BitGetChrUnsigned(StrData* SD, int Len, unsigned char *x)
{
  int   return_value;
  long  tmp;

  return_value = -1;
  if (Len > 0)
  {
    return_value = getbits(SD, &tmp, Len);
    *x = (unsigned char)tmp;
  }
  else if (Len == 0)
  {
    *x = 0;
    return_value = 0;
  }
  else
  {
    fprintf(stderr, "\nERROR: a negative number of bits allocated\n");
  }
  return return_value;
}


/***************************************************************************/
/*                                                                         */
/* name     : FIO_BitGetIntUnsigned                                        */
/*                                                                         */
/* function : Read an integer as an unsigned number from file with a       */
/*            given number of bits.                                        */
/*                                                                         */
/* pre      : Len, x, output file must be open by having used getbits_init */
/*                                                                         */
/* post     : The second variable in function call is filled with the      */
/*            unsigned integer read                                        */
/*                                                                         */
/* uses     : stdio.h, stdlib.h                                            */
/*                                                                         */
/***************************************************************************/

int FIO_BitGetIntUnsigned(StrData* SD, int Len, int *x)
{
  int   return_value;
  long  tmp;

  return_value = -1;
  if (Len > 0)
  {
    return_value = getbits(SD, &tmp, Len);
    *x = (int)tmp;
  }
  else if (Len == 0)
  {
    *x = 0;
    return_value = 0;
  }
  else
  {
    fprintf(stderr, "\nERROR: a negative number of bits allocated\n");
  }
  return return_value;
}

/***************************************************************************/
/*                                                                         */
/* name     : FIO_BitGetIntSigned                                          */
/*                                                                         */
/* function : Read an integer as a signed number from file with a          */
/*            given number of bits.                                        */
/*                                                                         */
/* pre      : Len, x, output file must be open by having used getbits_init */
/*                                                                         */
/* post     : The second variable in function call is filled with the      */
/*            signed integer read                                          */
/*                                                                         */
/* uses     : stdio.h, stdlib.h                                            */
/*                                                                         */
/***************************************************************************/

int FIO_BitGetIntSigned(StrData* SD, int Len, int *x)
{
  int   return_value;
  long  tmp;

  return_value = -1;
  if (Len > 0)
  {
    return_value = getbits(SD, &tmp, Len);
    *x = (int)tmp;
    
    if (*x >= (1 << (Len - 1)))
    {
      *x -= (1 << Len);
    }
  }
  else if (Len == 0)
  {
    *x = 0;
    return_value = 0;
  }
  else
  {
    fprintf(stderr, "\nERROR: a negative number of bits allocated\n");
  }
  return return_value;
}


/***************************************************************************/
/*                                                                         */
/* name     : FIO_BitGetShortSigned                                        */
/*                                                                         */
/* function : Read a short integer as a signed number from file with a     */
/*            given number of bits.                                        */
/*                                                                         */
/* pre      : Len, x, output file must be open by having used getbits_init */
/*                                                                         */
/* post     : The second variable in function call is filled with the      */
/*            signed short integer read                                    */
/*                                                                         */
/* uses     : stdio.h, stdlib.h                                            */
/*                                                                         */
/***************************************************************************/

int FIO_BitGetShortSigned(StrData* SD, int Len, short *x)
{
  int   return_value;
  long  tmp;

  return_value = -1;
  if (Len > 0)
  {
    return_value = getbits(SD, &tmp, Len);
    *x = (short)tmp;
    
    if (*x >= (1 << (Len - 1)))
    {
      *x -= (1 << Len);
    }
  }
  else if (Len == 0)
  {
    *x = 0;
    return_value = 0;
  }
  else
  {
    fprintf(stderr, "\nERROR: a negative number of bits allocated\n");
  }
  return return_value;
}


/***************************************************************************/
/*                                                                         */
/* name     : getbits                                                      */
/*                                                                         */
/* function : Read bits from the bitstream and decrement the counter.      */
/*                                                                         */
/* pre      : out_bitptr                                                   */
/*                                                                         */
/* post     : m_ByteCounter, outword, returns EOF on EOF or 0 otherwise.   */
/*                                                                         */
/* uses     : stdio.h                                                      */
/*                                                                         */
/***************************************************************************/

static int masks[] = { 0, 1, 3, 7, 0xf, 0x1f, 0x3f, 0x7f, 0xff };

int getbits(StrData* SD, long *outword, int out_bitptr)
{
    if (out_bitptr == 1)
    {
        if (SD->BitPosition == 0)
        {
            SD->DataByte = SD->DSTdata[SD->ByteCounter++];
            if (SD->ByteCounter > SD->TotalBytes)
            {
                return (-1); /* EOF */
            }
            SD->BitPosition = 8;
        }

        SD->BitPosition--;
        *outword = (SD->DataByte >> SD->BitPosition) & 1;

        return 0;
    }

    *outword = 0;
    while(out_bitptr > 0)
    {
        int thisbits, mask, shift;

        if (!SD->BitPosition)
        {
            SD->DataByte = SD->DSTdata[SD->ByteCounter++];
            if (SD->ByteCounter > SD->TotalBytes)
            {
                return (-1); /* EOF */
            }
            SD->BitPosition = 8;
        }

        thisbits = min(SD->BitPosition, out_bitptr);
        shift = (SD->BitPosition - thisbits);
        mask = masks[thisbits] << shift;

        shift = (out_bitptr - thisbits) - shift;
        if (shift <= 0)
            *outword |= ((SD->DataByte & mask) >> -shift);
        else
            *outword |= ((SD->DataByte & mask) << shift);

        out_bitptr -= thisbits;
        SD->BitPosition -= thisbits;
    }

    return 0;
}

/***************************************************************************/
/*                                                                         */
/* name     : get_bitcount                                                 */
/*                                                                         */
/* function : Reset the bits-written counter.                              */
/*                                                                         */
/* pre      : None                                                         */
/*                                                                         */
/* post     : Returns the number of bits written after an init_bitcount.   */
/*                                                                         */
/* uses     : -                                                            */
/*                                                                         */
/***************************************************************************/

int get_in_bitcount(StrData* SD)
{
  return SD->ByteCounter * 8 - SD->BitPosition;
}