Fg3Sam.hpp

//
// Copyright (c) Singular Inversions Inc. 2012
//
// Authors:     Andrew Beatty
// Created:     Feb 14, 2012
//
// IBFCS := Internal Base Face Coordinate System
//      Defined for 'InternalBaseFace.tri' (and photofit 'si.tri' for Full SDK).
//      X   - face's downward (roughly, head tilted up about 20 degrees)
//      Y   - face's left
//      Z   - face's forward (roughly, head tilted up about 20 degrees)
//      Origin is arbitrary, units are slightly smaller than millimetres
//
 
#ifndef FG3SAM_HPP
#define FG3SAM_HPP
 
#include "Fg3Scm.hpp"
#include "Fg3Face.hpp"
#include "FgImage.hpp"
#include "Fg3dMeshIo.hpp"
#include "FgTransform.hpp"
#include "FgBounds.hpp"
 
namespace Fg {
 
uint32              loadEgm_(String8 const & fname,Vec3Fss & symm,Vec3Fss & asym);
void                saveEgm(String8 const & fname,Vec3Fss const & symm,Vec3Fss const & asym);
 
struct      Ssm3
{
    Vec3Fs              meanVerts;      
    Vec3Fss             symmModes;      
    Vec3Fss             asymModes;      
    FG_SER3(meanVerts,symmModes,asymModes)
 
    Ssm3() {}
    explicit            Ssm3(String8 const & baseName);
    explicit            Ssm3(Vec3Fs const & allVerts) : meanVerts{allVerts} {}
    Ssm3(Vec3Fs const & allVerts,String8 const & egmFile);
    Ssm3(Vec3Fs const & allVerts,size_t numSymm,size_t numAsym) : meanVerts(allVerts), symmModes(numSymm), asymModes(numAsym) {}
 
    bool                empty() const {return meanVerts.empty(); }
    size_t              numModes() const {return symmModes.size() + asymModes.size(); }
    void                applyCoord_(Floats const & coord,Vec3Fs & allVerts) const;
    void                applyCoord_(Floats const & symm,Floats const & asym,Vec3Fs & allVerts) const;
    void                applyCoord_(Sam3Coord const & coord,Vec3Fs & allVerts) const;
    Vec3Fs              applyCoord(Sam3Coord const & coord) const
    {
        Vec3Fs      ret;
        applyCoord_(coord,ret);
        return ret;
    }
    void                saveModes(String8 const &   filename) const;    
    void                loadModes(String8 const & filename);            // meanVerts must be loaded first
    void                transform(SimilarityD const & sim);             // ! Transform all coordinates
};
typedef Svec<Ssm3>  Ssm3s;
 
struct      Sam3
{
    Mesh        mesh;       
    Ssm3        ssm;        
    Scm3s       scms;       
 
    Sam3() {}
    Sam3(Mesh const & m,Ssm3 const & s,Scm3s const & cs) : mesh{m}, ssm{s}, scms{cs} {}
    explicit Sam3(String8 const & baseName);
    Sam3(String8 const & ssmBase,String8 const & scmBase);
    Sam3(String8 const & ssmBase,String8s const & scmBases);
 
    void            applyFace(Face3 const & face);
    void            applyFace(Sam3Coord const & coord,ImgRgba8 const & xfDetail);   // Must be 0 or 1 SCMs
    void            transform(SimilarityD const & sim) {mesh.transform_(sim); ssm.transform(sim); }
};
typedef Svec<Sam3>      Sam3s;
 
void                applyFace_(Face3 const & face,Sam3s & sams);
Mesh                applyPose(std::map<String8,float> pose,Sam3 const & sam);
Meshes              applyPose(std::map<String8,float> pose,Sam3s const & sam3s);
Mat32F              cBounds(Sam3s const &);
 
struct      MeshSsm3
{
    Mesh            mesh;       // Verts used as output, mean verts stored in 'ssm' below:
    Ssm3            ssm;
 
    MeshSsm3() {}
    explicit MeshSsm3(String8 const & baseName) :
        mesh {loadMeshAnyFormat(baseName)},
        ssm {mesh.allVerts(),baseName+".egm"}
    {}
    MeshSsm3(String8 const & meshName,String8 const & egmName) :
        mesh {loadMesh(meshName)},
        ssm {mesh.allVerts(),egmName}
    {}
 
    // Updates the vertex list (and stat morphs) of mesh for the given shape coord (symm + asym):
    void            applyCoord(Floats const & coord);
    void            transform(SimilarityD const & sim) {mesh.transform_(sim); ssm.transform(sim); }
    // Save mesh with base shape to <baseName>.fgmesh and stats to <baseName>.egm:
    void            save(String8 const & baseName) const;
};
 
SimilarityD         cIbfcsToHcsi();
Rigid3D             cIbfcsToFccs();
SimilarityD         cIbfcsToFhcs();
SimilarityD         cIbfcsToClientCS(Vec3Fs const & ibfClientVerts);
SimilarityD         cIbfcsToClientCS(String8 const & clientInternalBaseFaceFname);
void                cmdGetInternal(CLArgs const &); // Make a local copy of the FaceGen internal base face mesh
 
}
 
#endif