videoutilities.h

Go to the documentation of this file.

/* SPDX-License-Identifier: MIT */
#ifndef AJA_VIDEOUTILS_H
#define AJA_VIDEOUTILS_H

#include "public.h"
#include "videotypes.h"

#define DEFAULT_PATT_GAIN  0.9      // some patterns pay attention to this...
#define HD_NUMCOMPONENTPIXELS_2K  2048
#define HD_NUMCOMPONENTPIXELS_1080_2K  2048
#define HD_NUMCOMPONENTPIXELS_1080  1920
#define CCIR601_10BIT_BLACK  64
#define CCIR601_10BIT_WHITE  940
#define CCIR601_10BIT_CHROMAOFFSET  512

#define CCIR601_8BIT_BLACK  16
#define CCIR601_8BIT_WHITE  235
#define CCIR601_8BIT_CHROMAOFFSET  128

#define MIN_RGB_8BIT 0
#define MAX_RGB_8BIT 255
#define MIN_RGB_10BIT 0
#define MAX_RGB_10BIT 1023
#define MIN_RGB_16BIT 0
#define MAX_RGB_16BIT 65535

// line pitch is in bytes.
#define FRAME_0_BASE (0x0)
#define FRAME_1080_10BIT_LINEPITCH (1280*4)
#define FRAME_1080_8BIT_LINEPITCH (1920*2)
#define FRAME_QUADHD_10BIT_SIZE (FRAME_1080_10BIT_LINEPITCH*2160)
#define FRAME_QUADHD_8BIT_SIZE (FRAME_1080_8BIT_LINEPITCH*2160)
#define FRAME_BASE(__frameNum__,__frameSize__)  ((__frameNum__)*(__frameSize__))

//  NOTE:   Changed the "(__x__) < MIN_RGB_nBIT" comparisons to "(__x__) <= MIN_RGB_nBIT"
//          in the following three macros to eliminate gcc "comparison always true" warnings
//          when __x__ is an unsigned value.
#if !defined(ClipRGB_8BIT)
    #define ClipRGB_8BIT(__x__)         ((__x__) > MAX_RGB_8BIT   ?  (MAX_RGB_8BIT)                                 \
                                                                  :  ((__x__) <= MIN_RGB_8BIT   ?  (MIN_RGB_8BIT)   \
                                                                                                :  (__x__)))
#endif
#if !defined(ClipRGB_10BIT)
    #define ClipRGB_10BIT(__x__)        ((__x__) > MAX_RGB_10BIT  ?  (MAX_RGB_10BIT)                                \
                                                                  :  ((__x__) <= MIN_RGB_10BIT  ?  (MIN_RGB_10BIT)  \
                                                                                                :  (__x__)))
#endif

#define MIN_YCBCR_10BIT 4
#define MAX_YCBCR_10BIT 1019
#define ClipYCbCr_10BIT(X) ((X) > MAX_YCBCR_10BIT ? (MAX_YCBCR_10BIT) : ((X) < MIN_YCBCR_10BIT ? (MIN_YCBCR_10BIT) : (X)))


typedef enum { 
    AJA_SIGNALMASK_NONE=0,     // Output Black.
    AJA_SIGNALMASK_Y=1 ,       // Output Y if set, else Output Y=0x40
    AJA_SIGNALMASK_Cb=2 ,      // Output Cb if set, elso Output Cb to 0x200
    AJA_SIGNALMASK_Cr=4 ,       // Output Cr if set, elso Output Cr to 0x200
    AJA_SIGNALMASK_ALL=1+2+4   // Output Cr if set, elso Output Cr to 0x200
} AJASignalMask;

typedef struct {
    uint8_t Blue;
    uint8_t Green;
    uint8_t Red;
    uint8_t Alpha;
} AJA_RGBAlphaPixel;

typedef struct {
    uint8_t Alpha;
    uint8_t Red;
    uint8_t Green;
    uint8_t Blue;
} AJA_AlphaRGBPixel;

typedef struct {
    uint16_t Blue;
    uint16_t Green;
    uint16_t Red;
    uint16_t Alpha;
} AJA_RGBAlpha10BitPixel;

typedef struct {
    uint16_t Blue;
    uint16_t Green;
    uint16_t Red;
    uint16_t Alpha;
} AJA_RGBAlpha16BitPixel;

typedef struct
{
    uint16_t Alpha;
    uint16_t cb;
    uint16_t y;
    uint16_t cr;
} AJA_YCbCr10BitAlphaPixel;

typedef struct
{
    uint16_t cb;
    uint16_t y;
    uint16_t cr;
} AJA_YCbCr10BitPixel;

void AJA_EXPORT createVideoFrame( uint32_t *buffer , uint64_t frameNumber, AJA_PixelFormat pixFmt, uint32_t lines, uint32_t pixels, uint32_t linepitch, uint16_t y, uint16_t cb, uint16_t cr );
uint32_t AJA_EXPORT AJA_CalcRowBytesForFormat(AJA_PixelFormat format, uint32_t width);
void AJA_EXPORT AJA_UnPack10BitYCbCrBuffer(uint32_t* packedBuffer, uint16_t* ycbcrBuffer, uint32_t numPixels);
void AJA_EXPORT AJA_PackTo10BitYCbCrBuffer(uint16_t *ycbcrBuffer, uint32_t *packedBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_PackTo10BitYCbCrDPXBuffer( uint16_t *ycbcrBuffer, uint32_t *packedBuffer,uint32_t numPixels ,bool bigEndian = true);
void AJA_EXPORT AJA_PackRGB10BitFor10BitRGB(AJA_RGBAlpha10BitPixel* rgba10BitBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_PackRGB10BitFor10BitRGBPacked(AJA_RGBAlpha10BitPixel* rgba10BitBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_PackRGB10BitFor10BitDPX(AJA_RGBAlpha10BitPixel* rgba10BitBuffer,uint32_t numPixels, bool bigEndian=true);
void AJA_EXPORT AJA_UnPack10BitDPXtoRGBAlpha10BitPixel(AJA_RGBAlpha10BitPixel* rgba10BitBuffer,uint32_t* DPXLinebuffer ,uint32_t numPixels, bool bigEndian=true);
void AJA_EXPORT AJA_UnPack10BitDPXtoRGBAlphaBitPixel(uint8_t* rgbaBuffer,uint32_t* DPXLinebuffer ,uint32_t numPixels, bool bigEndian=true);
void AJA_EXPORT AJA_RePackLineDataForYCbCrDPX(uint32_t *packedycbcrLine, uint32_t numULWords);
void AJA_EXPORT AJA_MakeUnPacked8BitYCbCrBuffer( uint8_t* buffer, uint8_t Y , uint8_t Cb , uint8_t Cr,uint32_t numPixels );
void AJA_EXPORT AJA_MakeUnPacked10BitYCbCrBuffer(uint16_t* buffer, uint16_t Y , uint16_t Cb , uint16_t Cr,uint32_t numPixels);
void AJA_EXPORT AJA_ConvertLineto8BitYCbCr(uint16_t * ycbcr10BitBuffer, uint8_t * ycbcr8BitBuffer,  uint32_t numPixels);
void AJA_EXPORT AJA_ConvertLineToYCbCr422(AJA_RGBAlphaPixel * RGBLine, uint16_t* YCbCrLine, int32_t numPixels , int32_t startPixel,  bool fUseSDMatrix);
void AJA_EXPORT AJA_ConvertLineto10BitRGB(uint16_t * ycbcrBuffer, AJA_RGBAlpha10BitPixel * rgbaBuffer,uint32_t numPixels,bool fUseSDMatrix);
void AJA_EXPORT AJA_ConvertLinetoRGB(uint8_t * ycbcrBuffer, AJA_RGBAlphaPixel * rgbaBuffer, uint32_t numPixels, bool fUseSDMatrix);
void AJA_EXPORT AJA_ConvertLinetoRGB(uint16_t * ycbcrBuffer, AJA_RGBAlphaPixel * rgbaBuffer, uint32_t numPixels, bool fUseSDMatrix);
void AJA_EXPORT AJA_ConvertLineto16BitRGB(uint16_t * ycbcrBuffer, AJA_RGBAlpha16BitPixel * rgbaBuffer, uint32_t numPixels, bool fUseSDMatrix);
void AJA_EXPORT AJA_Convert16BitRGBtoBayer10BitDPXLJ(AJA_RGBAlpha16BitPixel * rgbaBuffer, uint32_t * bayerBuffer, 
                                                     uint32_t numPixels, uint32_t line, AJA_BayerColorPhase phase = AJA_BayerColorPhase_RedGreen);
void AJA_EXPORT AJA_Convert16BitRGBtoBayer12BitDPXLJ(AJA_RGBAlpha16BitPixel * rgbaBuffer, uint32_t * bayerBuffer, 
                                                     uint32_t numPixels, uint32_t line, AJA_BayerColorPhase phase = AJA_BayerColorPhase_RedGreen);
void AJA_EXPORT AJA_Convert16BitRGBtoBayer10BitDPXPacked(AJA_RGBAlpha16BitPixel * rgbaBuffer, uint8_t * bayerBuffer, 
                                                         uint32_t numPixels, uint32_t line, AJA_BayerColorPhase phase = AJA_BayerColorPhase_RedGreen);
void AJA_EXPORT AJA_Convert16BitRGBtoBayer12BitDPXPacked(AJA_RGBAlpha16BitPixel * rgbaBuffer, uint8_t * bayerBuffer, 
                                                         uint32_t numPixels, uint32_t line, AJA_BayerColorPhase phase = AJA_BayerColorPhase_RedGreen);
void AJA_EXPORT AJA_ConvertARGBToRGBA(uint8_t* rgbaBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_ConvertARGBToABGR(uint8_t* rgbaBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_ConvertARGBToRGB(uint8_t* rgbaBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_ConvertARGBToBGR(uint8_t* rgbaBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_Convert16BitARGBTo16BitRGB(AJA_RGBAlpha16BitPixel *rgbaLineBuffer ,uint16_t * rgbLineBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_Convert16BitARGBTo12BitRGBPacked(AJA_RGBAlpha16BitPixel *rgbaLineBuffer ,uint8_t * rgbLineBuffer,uint32_t numPixels);
void AJA_EXPORT AJA_Convert8BitYCbCrToYUY2(uint8_t * ycbcrBuffer, uint32_t numPixels);
void AJA_EXPORT AJA_ConvertUnpacked10BitYCbCrToPixelFormat(uint16_t *unPackedBuffer, uint32_t *packedBuffer, uint32_t numPixels, AJA_PixelFormat pixelFormat);
void AJA_EXPORT AJA_ConvertPixelFormatToRGBA(uint32_t *buffer, AJA_RGBAlphaPixel* rgbBuffer, uint32_t numPixels, AJA_PixelFormat pixelFormat,bool  bIsSD = false);
void AJA_EXPORT AJA_MaskUnPacked10BitYCbCrBuffer(uint16_t* ycbcrUnPackedBuffer, uint16_t signalMask , uint32_t numPixels);

void AJA_EXPORT AJA_ReSampleLine(AJA_RGBAlphaPixel *Input, AJA_RGBAlphaPixel *Output, uint16_t startPixel, uint16_t endPixel, int32_t numInputPixels, int32_t numOutputPixels);
void AJA_EXPORT AJA_ReSampleLine(int16_t *Input, int16_t *Output, uint16_t startPixel, uint16_t endPixel, int32_t numInputPixels, int32_t numOutputPixels);
void AJA_EXPORT AJA_ReSampleYCbCrSampleLine(int16_t *Input, int16_t *Output, int32_t numInputPixels, int32_t numOutputPixels); 
void AJA_EXPORT AJA_ReSampleAudio(int16_t *Input, int16_t *Output, uint16_t startPixel, uint16_t endPixel, int32_t numInputPixels, int32_t numOutputPixels, int16_t channelInterleaveMulitplier=1);

void AJA_EXPORT WriteLineToBuffer(AJA_PixelFormat pixelFormat, uint32_t currentLine, uint32_t numPixels, uint32_t linePitch, 
                                  uint8_t* pOutputBuffer,uint32_t* pPackedLineBuffer);
void AJA_EXPORT WriteLineToBuffer(AJA_PixelFormat pixelFormat, AJA_BayerColorPhase bayerPhase, uint32_t currentLine,
                                  uint32_t numPixels, uint32_t linePitch, uint8_t* pOutputBuffer,uint32_t* pPackedLineBuffer);

void AJA_EXPORT AJA_ConvertRGBAlpha10LineToYCbCr422(AJA_RGBAlpha10BitPixel * RGBLine,
                                                                                 uint16_t* YCbCrLine,
                                                                                 int32_t numPixels ,
                                                                                 int32_t startPixel,
                                                                                 bool fUseRGBFullRange=false);

inline  int16_t AJA_FixedRound(int32_t inFix)
{ 
  int16_t retValue;
  
  if ( inFix < 0 ) 
  {
    retValue = (int16_t)(-((-inFix+0x8000)>>16));
  }
  else
  {
    retValue = (int16_t)((inFix + 0x8000)>>16);
  }
  return retValue;
}

inline  void AJA_SDConvert10BitYCbCrto10BitRGB(AJA_YCbCr10BitAlphaPixel *pSource,
                                           AJA_RGBAlpha10BitPixel *pTarget)
{
  int32_t Red,Green,Blue;
  int32_t ConvertedY;

  ConvertedY = 0x12A15*((int32_t)pSource->y - CCIR601_10BIT_BLACK);

  Red = AJA_FixedRound(ConvertedY +
           0x19895*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET)));

  pTarget->Red = (uint16_t)ClipRGB_10BIT(Red);

  Blue = AJA_FixedRound(ConvertedY +
            0x20469*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Blue = (uint16_t)ClipRGB_10BIT(Blue);

  Green = AJA_FixedRound(ConvertedY - 
             0x644A*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ) -
             0xD01F*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Green = (uint16_t)ClipRGB_10BIT(Green);

  pTarget->Alpha = pSource->Alpha;
}

inline  void AJA_HDConvert10BitYCbCrto10BitRGB(AJA_YCbCr10BitAlphaPixel *pSource,
                                           AJA_RGBAlpha10BitPixel *pTarget)
{
  int32_t Red,Green,Blue;
  int32_t ConvertedY;

  ConvertedY = 0x12ACF*((int32_t)pSource->y - CCIR601_10BIT_BLACK);

  Red = AJA_FixedRound(ConvertedY +
           0x1DF71*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET)));

  pTarget->Red = (uint16_t)ClipRGB_10BIT(Red);

  Blue = AJA_FixedRound(ConvertedY +
            0x22A86*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Blue = (uint16_t)ClipRGB_10BIT(Blue);

  Green = AJA_FixedRound(ConvertedY - 
             0x3806*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ) -
             0x8C32*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Green = (uint16_t)ClipRGB_10BIT(Green);

  pTarget->Alpha = pSource->Alpha;
}

inline  void AJA_SDConvert10BitYCbCrtoRGB(AJA_YCbCr10BitAlphaPixel *pSource,
                                      AJA_RGBAlphaPixel *pTarget)
{
  int32_t Red,Green,Blue;
  int32_t ConvertedY;

  ConvertedY = 0x4A86*((int32_t)pSource->y - CCIR601_10BIT_BLACK);

  Red = AJA_FixedRound(ConvertedY +
           0x6626*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET)));

  pTarget->Red = (uint8_t)ClipRGB_8BIT(Red);

  Blue = AJA_FixedRound(ConvertedY +
            0x811B*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Blue = (uint8_t)ClipRGB_8BIT(Blue);

  Green = AJA_FixedRound(ConvertedY - 
             0x1913*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ) -
             0x3408*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Green = (uint8_t)ClipRGB_8BIT(Green);

  pTarget->Alpha = (uint8_t)pSource->Alpha;
}

inline  void AJA_HDConvert10BitYCbCrtoRGB(AJA_YCbCr10BitAlphaPixel *pSource,
                                      AJA_RGBAlphaPixel *pTarget)
{
  int32_t Red,Green,Blue;
  int32_t ConvertedY;

  ConvertedY = (0x12ACF>>2)*((int32_t)pSource->y - CCIR601_10BIT_BLACK);

  Red = AJA_FixedRound(ConvertedY +
           (0x1DF71>>2)*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET)));

  pTarget->Red = (uint8_t)ClipRGB_8BIT(Red);

  Blue = AJA_FixedRound(ConvertedY +
            (0x22A86>>2)*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Blue = (uint8_t)ClipRGB_8BIT(Blue);

  Green = AJA_FixedRound(ConvertedY - 
             (0x3806>>2)*((int32_t)(pSource->cb-CCIR601_10BIT_CHROMAOFFSET) ) -
             (0x8C32>>2)*((int32_t)(pSource->cr-CCIR601_10BIT_CHROMAOFFSET) ));

  pTarget->Green = (uint8_t)ClipRGB_8BIT(Green);

  pTarget->Alpha = (uint8_t)pSource->Alpha;
}

typedef void (*AJA_ConvertRGBAlphatoYCbCr)(AJA_RGBAlphaPixel * pSource, AJA_YCbCr10BitPixel * pTarget);

inline void AJA_SDConvertRGBAlphatoYCbCr(AJA_RGBAlphaPixel * pSource, AJA_YCbCr10BitPixel * pTarget)
{
    int32_t Y,Cb,Cr;

    Y = CCIR601_10BIT_BLACK + (((int32_t)0x41BC*pSource->Red +
        (int32_t)0x810F*pSource->Green +
        (int32_t)0x1910*pSource->Blue )>>14);
    pTarget->y = (uint16_t)Y;

    Cb = CCIR601_10BIT_CHROMAOFFSET + (((int32_t)-0x25F1*pSource->Red -
        (int32_t)0x4A7E*pSource->Green +
        (int32_t)0x7070*pSource->Blue )>>14);

    pTarget->cb = uint16_t(Cb&0x3FF);

    Cr = CCIR601_10BIT_CHROMAOFFSET + (((int32_t)0x7070*pSource->Red -
        (int32_t)0x5E27*pSource->Green -
        (int32_t)0x1249*pSource->Blue )>>14);

    pTarget->cr = uint16_t(Cr&0x3FF);
}

inline void AJA_HDConvertRGBAlphatoYCbCr(AJA_RGBAlphaPixel * pSource, AJA_YCbCr10BitPixel * pTarget)
{
    int32_t Y,Cb,Cr;

    Y = CCIR601_10BIT_BLACK + (((int32_t)0x2E8A*pSource->Red +
        (int32_t)0x9C9F*pSource->Green +
        (int32_t)0x0FD2*pSource->Blue )>>14);
    pTarget->y = (uint16_t)Y;

    Cb = CCIR601_10BIT_CHROMAOFFSET + (((int32_t)-0x18F4*pSource->Red -
        (int32_t)0x545B*pSource->Green +
        (int32_t)0x6DA9*pSource->Blue )>>14);

    pTarget->cb = uint16_t(Cb&0x3FF);

    Cr = CCIR601_10BIT_CHROMAOFFSET + (((int32_t)0x6D71*pSource->Red -
        (int32_t)0x6305*pSource->Green -
        (int32_t)0x0A06*pSource->Blue )>>14);

    pTarget->cr = uint16_t(Cr&0x3FF);
}

inline void AJA_HDConvertRGBAlpha10toYCbCr(AJA_RGBAlpha10BitPixel * pSource, AJA_YCbCr10BitPixel * pTarget,bool rgbFullRange)
{
    double dY,dCb,dCr;
    int32_t Y,Cb,Cr;
    if ( rgbFullRange)
    {
        dY =    (double(pSource->Red  ) * 0.182068) +
                (double(pSource->Green) * 0.612427) +
                (double(pSource->Blue ) * 0.061829);
        Y = CCIR601_10BIT_BLACK + int32_t(dY); 
        pTarget->y = uint16_t(Y&0x3FF);

        dCb =   (double(pSource->Red  ) * (-0.100342)) +
                (double(pSource->Green) * (-0.337585)) +
                (double(pSource->Blue ) * (0.437927));
        Cb = CCIR601_10BIT_CHROMAOFFSET + int32_t(dCb);
        pTarget->cb = uint16_t(Cb&0x3FF);

        dCr =   (double(pSource->Red  ) * (0.437927)) +
                (double(pSource->Green) * (-0.397766)) +
                (double(pSource->Blue ) * (-0.040161));
        Cr = CCIR601_10BIT_CHROMAOFFSET + int32_t(dCr);
        pTarget->cr = uint16_t(Cr&0x3FF);

    }
    else
    {
        dY =    (double(pSource->Red  ) * 0.212585) +
                (double(pSource->Green) * 0.715210) +
                (double(pSource->Blue ) * 0.072205);
        Y = int32_t(dY);
        pTarget->y = uint16_t(Y&0x3FF);

        dCb =   (double(pSource->Red  ) * (-0.117188)) +
                (double(pSource->Green) * (-0.394226)) +
                (double(pSource->Blue ) * (0.511414));
        Cb = CCIR601_10BIT_CHROMAOFFSET + int32_t(dCb);
        pTarget->cb = uint16_t(Cb&0x3FF);

        dCr =   (double(pSource->Red  ) * (0.511414)) +
                (double(pSource->Green) * (-0.464508)) +
                (double(pSource->Blue ) * (-0.046906));
        Cr = CCIR601_10BIT_CHROMAOFFSET + int32_t(dCr);
        pTarget->cr = uint16_t(Cr&0x3FF);
    }
}

#endif  //  AJA_VIDEOUTILS_H