parameterization.h

Go to the documentation of this file.

//
//   Copyright 2021 Pixar
//
//   Licensed under the Apache License, Version 2.0 (the "Apache License")
//   with the following modification; you may not use this file except in
//   compliance with the Apache License and the following modification to it:
//   Section 6. Trademarks. is deleted and replaced with:
//
//   6. Trademarks. This License does not grant permission to use the trade
//      names, trademarks, service marks, or product names of the Licensor
//      and its affiliates, except as required to comply with Section 4(c) of
//      the License and to reproduce the content of the NOTICE file.
//
//   You may obtain a copy of the Apache License at
//
//       http://www.apache.org/licenses/LICENSE-2.0
//
//   Unless required by applicable law or agreed to in writing, software
//   distributed under the Apache License with the above modification is
//   distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//   KIND, either express or implied. See the Apache License for the specific
//   language governing permissions and limitations under the Apache 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);

    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 */