FgPhotoFit.h

//
// Copyright (c) 2023 Singular Inversions Inc. (facegen.com)
// Created: May 28, 2003.
// Authors: John Leung, Andrew Beatty
//
// FaceGen 3 Photofit
//
// USE:
//
// This DLL should only ever be used by a single thread at a time - it is
// not re-entrant or multi-thread safe.
//
// DESIGN:
//
// The API function calls are C-style using only simple data structures to keep the DLL binary
// interface compatible across different compilers. Structure sizes are multiples of 4 bytes so
// there should be no padding issues between compilers. Data structure member functions do not
// affect the function ABI and the data structures do not contain implementation-dependent type
// structures such as std::vector. And of course this API returns error codes instead of throwing
// exceptions.
//
// HCSI := Head Coordinate System in Inches.
//      Origin at centre of face
//      X - face left (viewer's right)
//      Y - face up
//      Z - face forward
// 
 
#ifndef FG_PHOTOFIT_H
#define FG_PHOTOFIT_H
 
#include "FgDynLib.h"
#include "FgTransform.hpp"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <string.h>
 
struct FgppUserDataS
{
    unsigned int    width;
    unsigned int    height;
    unsigned int    widthStep;
    const void      *imageData;
    unsigned int    numPoints;
    unsigned int    pointX[11];
    unsigned int    pointY[11];
};
 
struct FgppFgCPackS
{
    float           coordGS[50];
    float           coordGA[30];
    float           coordTS[50];
    unsigned long long  detailSize;     // Just in case compiled with 64 bit padding
    void            *detailTexPtr;
    void            *transforms;    // C++ type Mat44D[]
};
 
FG_DLL_DECLARE
void
fgppDiagnostics(int outputOn);
 
FG_DLL_DECLARE
void
fgppDiagnosticIndent(int level);
 
FG_DLL_DECLARE
void
fgppLogFile(char const * fnameUtf8);
 
#ifdef _WIN32
FG_DLL_DECLARE
void
fgppLogFileW(const wchar_t * fnameUtf);
#endif
 
FG_DLL_DECLARE
void
fgppSetCancelCallback(
    int (*cancelCheck)(int milestone));
 
FG_DLL_DECLARE
int
fgppNumberOfMilestones();
 
FG_DLL_DECLARE
void
fgppSetNumThreads(
    unsigned int numThreads);
 
FG_DLL_DECLARE
int
fgppInitialize(char const *fitDataDirectory);
 
#ifdef _WIN32
FG_DLL_DECLARE
int
fgppInitializeW(
    const wchar_t *fitDataDirectory);
#endif
 
FG_DLL_DECLARE
int
fgppSetCameraDistance(
    float dist);
 
FG_DLL_DECLARE
void
fgppSetMirrorSideDetail(
    int     msd);
 
FG_DLL_DECLARE
void
fgppSetSpeedup(
    int level);
 
FG_DLL_DECLARE
int
fgppValidatePoints(
    const FgppUserDataS *   pointsData);
 
FG_DLL_DECLARE
int
fgppFitImages(
    unsigned int        numPhotos,          
    const FgppUserDataS *userDataArray,     
    long                withHair,
    long                frontDetailOnly,
    FgppFgCPackS        *fgCPack            
);
 
FG_DLL_DECLARE
void
fgppDeallocate();
 
#ifdef __cplusplus
}
#endif
 
#endif      // #ifndef FG_PHOTOFIT_H