pucutil Namespace API (C++)

PUCUTIL.h provides exactly the same functionality as the PUC_-prefixed C functions described in Image Decoding API, callable as functions within the C++ pucutil:: namespace. By writing using namespace pucutil;, you can call PUC_DecodeData more concisely as DecodeData.

Not an object-oriented wrapper class

pucutil:: is a collection of C-style functions grouped into a namespace; no class instantiation (such as new) is required. Continue to use the PUC_ functions from PUCLIB.h directly for opening/closing the camera and controlling streaming (PUC_OpenDevice2 / PUC_BeginXferData, etc.).

---

1. Decoding (pucutil versions of PUC_DecodeData, etc.)

namespace pucutil {
    PUCRESULT WINAPI ExtractSequenceNo(const PUCHAR pData, UINT32 nWidth, UINT32 nHeight, PUSHORT pSeqNo);
    PUCRESULT WINAPI DecodeData(PUINT8 pDst, UINT32 nX, UINT32 nY, UINT32 nWidth, UINT32 nHeight, UINT32 nLineBytes, const PUINT8 pSrc, const PUSHORT pQVals);
    PUCRESULT WINAPI DecodeDataMultiThread(PUINT8 pDst, UINT32 nX, UINT32 nY, UINT32 nWidth, UINT32 nHeight, UINT32 nLineBytes, const PUINT8 pSrc, const PUSHORT pQVals, UINT32 nThreadCount);
    PUCRESULT WINAPI DecodeDCTData(PINT16 pDst, UINT32 nX, UINT32 nY, UINT32 nWidth, UINT32 nHeight, UINT32 nLineBytes, const PUINT8 pSrc, const PUSHORT pQVals);
    PUCRESULT WINAPI DecodeDCData(PUINT8 pDst, UINT32 nBlockX, UINT32 nBlockY, UINT32 nBlockCountX, UINT32 nBlockCountY, const PUINT8 pSrc);
    PUCRESULT WINAPI SetWhiteBalanceGain(double nGainR, double nGainG, double nGainB);
    PUCRESULT WINAPI GetTimeCode2EPOC(PUINT8 pSrc, time_t* time);
}

The meaning of each function’s arguments and return value is identical to the corresponding PUC_ function described in Image Decoding API (for example, pucutil::DecodeData ⇔ PUC_DecodeData).

Usage example

#include "PUCUTIL.h"
using namespace pucutil;

PUCRESULT ret = DecodeData(pDst, 0, 0, width, height, lineBytes, pSrc, qVals);

---

2. GPU (CUDA) decoding (pucutil versions)

namespace pucutil {
    PUCRESULT WINAPI GetAvailableGPUProcess();
    PUCRESULT WINAPI SetupGPUDecode(PUC_GPU_SETUP_PARAM param);
    PUCRESULT WINAPI TeardownGPUDecode();
    PUCRESULT WINAPI DecodeGPU(bool download, unsigned char* pSrc, unsigned char** pDst, UINT32 lineBytes);
    PUCRESULT WINAPI GetGPULastError(int& errorCode);
    PUCRESULT WINAPI IsSetupGPUDecode(bool& status);
}

Here too, the meaning of the arguments and return values is identical to the PUC_ functions described in the GPU decoding section of Image Decoding API.

Which should I use, the C function version or the pucutil version?

The behavior is completely identical. Use the PUC_ functions if you want to match an existing C codebase or C calling conventions, or use the pucutil:: namespace if you want more concise code in a C++ project.

---

Related pages

Image Decoding APIThe complete API reference for the C-language version, including PUC_DecodeData