parameterization.h

Go to the documentation of this file.

//
//   Copyright 2021 Pixar
//
//   Licensed under the terms set forth in the LICENSE.txt file available at
//   https://opensubdiv.org/license.
//
 
#ifndef OPENSUBDIV3_BFR_PARAMETERIZATION_H
#define OPENSUBDIV3_BFR_PARAMETERIZATION_H
 
#include "../version.h"
 
#include "../sdc/types.h"
 
namespace OpenSubdiv {
namespace OPENSUBDIV_VERSION {
 
namespace Bfr {

class Parameterization {
public:
    enum Type { QUAD,          
                TRI,           
                QUAD_SUBFACES  
    };
 
public:


    Parameterization(Sdc::SchemeType scheme, int faceSize);

    Parameterization(Type type, int numSubFaces = 0);

    bool IsValid() const { return (_faceSize > 0); }

    Parameterization() : _type(0), _uDim(0), _faceSize(0) { }
 
    Parameterization(Parameterization const &) = default;
    Parameterization & operator=(Parameterization const &) = default;
    ~Parameterization() = default;



    Type GetType() const { return (Type) _type; }

    int  GetFaceSize() const { return _faceSize; }
 
public:


    template <typename REAL>
    void GetVertexCoord(int vertexIndex, REAL uvCoord[2]) const;

    template <typename REAL>
    void GetEdgeCoord(int edgeIndex, REAL t, REAL uvCoord[2]) const;

    template <typename REAL>
    void GetCenterCoord(REAL uvCoord[2]) const;
 
public:


    bool HasSubFaces() const;

    template <typename REAL>
    int GetSubFace(REAL const uvCoord[2]) const;

    template <typename REAL>
    int ConvertCoordToSubFace(
                REAL const uvCoord[2], REAL subFaceCoord[2]) const;

    template <typename REAL>
    void ConvertSubFaceToCoord(int subFace,
                REAL const subFaceCoord[2], REAL uvCoord[2]) const;

    template <typename REAL>
    int ConvertCoordToNormalizedSubFace(
                REAL const uvCoord[2], REAL subFaceCoord[2]) const;

    template <typename REAL>
    void ConvertNormalizedSubFaceToCoord(int subFace,
                REAL const subFaceCoord[2], REAL uvCoord[2]) const;
 
private:
    template <typename REAL>
    int convertCoordToSubFace(bool normalized,
                REAL const uvCoord[2], REAL subFaceCoord[2]) const;
    template <typename REAL>
    void convertSubFaceToCoord(bool normalized, int subFace,
                REAL const subFaceCoord[2], REAL uvCoord[2]) const;
 
private:
    unsigned char  _type;
    unsigned char  _uDim;
    unsigned short _faceSize;
};
 
//
//  Inline sub-face coordinate conversion methods:
//
inline bool
Parameterization::HasSubFaces() const {
    return (_type == QUAD_SUBFACES);
}
 
template <typename REAL>
inline int
Parameterization::GetSubFace(REAL const uvCoord[2]) const {
 
    if (!HasSubFaces()) return 0;
 
    int uTile = (int) uvCoord[0];
    int vTile = (int) uvCoord[1];
    return (vTile + ((uvCoord[1] - (REAL) vTile) > 0.75f)) * _uDim +
           (uTile + ((uvCoord[0] - (REAL) uTile) > 0.75f));
}
 
//  Conversions to unnormalized sub-face coordinates:
template <typename REAL>
inline int
Parameterization::ConvertCoordToSubFace(
        REAL const uvCoord[2], REAL subCoord[2]) const {
    return convertCoordToSubFace<REAL>(false, uvCoord, subCoord);
}
template <typename REAL>
inline void
Parameterization::ConvertSubFaceToCoord(
        int subFace, REAL const subCoord[2], REAL uvCoord[2]) const {
    convertSubFaceToCoord<REAL>(false, subFace, subCoord, uvCoord);
}
 
//  Conversions to normalized sub-face coordinates:
template <typename REAL>
inline int
Parameterization::ConvertCoordToNormalizedSubFace(
        REAL const uvCoord[2], REAL subCoord[2]) const {
    return convertCoordToSubFace<REAL>(true, uvCoord, subCoord);
}
template <typename REAL>
inline void
Parameterization::ConvertNormalizedSubFaceToCoord(
        int subFace, REAL const subCoord[2], REAL uvCoord[2]) const {
    convertSubFaceToCoord<REAL>(true, subFace, subCoord, uvCoord);
}
 
} // end namespace Bfr
 
} // end namespace OPENSUBDIV_VERSION
using namespace OPENSUBDIV_VERSION;
 
} // end namespace OpenSubdiv
 
#endif /* OPENSUBDIV3_BFR_PARAMETERIZATION */