patchDescriptor.h

Go to the documentation of this file.

//
//   Copyright 2013 Pixar
//
//   Licensed under the terms set forth in the LICENSE.txt file available at
//   https://opensubdiv.org/license.
//
 
#ifndef OPENSUBDIV3_FAR_PATCH_DESCRIPTOR_H
#define OPENSUBDIV3_FAR_PATCH_DESCRIPTOR_H
 
#include "../version.h"
 
#include "../far/types.h"
#include "../sdc/types.h"
 
#include <vector>
 
namespace OpenSubdiv {
namespace OPENSUBDIV_VERSION {
 
namespace Far {

class PatchDescriptor {
 
public:
 
    enum Type {
        NON_PATCH = 0,     
 
        POINTS,            
        LINES,             
 
        QUADS,             
        TRIANGLES,         
 
        LOOP,              
 
        REGULAR,           
        GREGORY,
        GREGORY_BOUNDARY,
        GREGORY_BASIS,
        GREGORY_TRIANGLE
    };
 
public:

    PatchDescriptor() :
        _type(NON_PATCH) { }

    PatchDescriptor(int type) :
        _type(type) { }

    PatchDescriptor( PatchDescriptor const & d ) :
        _type(d.GetType()) { }

    PatchDescriptor & operator=( PatchDescriptor const & d ) {
        _type = d.GetType();
        return *this;
    }

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

    static inline bool IsAdaptive(Type type) {
        return type > TRIANGLES;
    }

    bool IsAdaptive() const {
        return IsAdaptive( this->GetType() );
    }

    static inline short GetNumControlVertices( Type t );

    static inline short GetNumFVarControlVertices( Type t );

    short GetNumControlVertices() const {
        return GetNumControlVertices( this->GetType() );
    }

    short GetNumFVarControlVertices() const {
        return GetNumFVarControlVertices( this->GetType() );
    }

    static short GetRegularPatchSize() { return 16; }

    static short GetGregoryPatchSize() { return 4; }

    static short GetGregoryBasisPatchSize() { return 20; }
 

    static Vtr::ConstArray<PatchDescriptor> GetAdaptivePatchDescriptors(Sdc::SchemeType type);

    inline bool operator < ( PatchDescriptor const other ) const;

    inline bool operator == ( PatchDescriptor const other ) const;
 
    // debug helper
    void print() const;
 
private:
    unsigned int _type;
};
 
typedef Vtr::ConstArray<PatchDescriptor> ConstPatchDescriptorArray;
 
// Returns the number of control vertices expected for a patch of this type
inline short
PatchDescriptor::GetNumControlVertices( Type type ) {
    switch (type) {
        case REGULAR           : return GetRegularPatchSize();
        case LOOP              : return 12;
        case QUADS             : return 4;
        case GREGORY           :
        case GREGORY_BOUNDARY  : return GetGregoryPatchSize();
        case GREGORY_BASIS     : return GetGregoryBasisPatchSize();
        case GREGORY_TRIANGLE  : return 18;
        case TRIANGLES         : return 3;
        case LINES             : return 2;
        case POINTS            : return 1;
        default : return -1;
    }
}
 
// Returns the number of face-varying control vertices expected for a patch of this type
inline short
PatchDescriptor::GetNumFVarControlVertices( Type type ) {
    return PatchDescriptor::GetNumControlVertices(type);
}
 
// Allows ordering of patches by type
inline bool
PatchDescriptor::operator < ( PatchDescriptor const other ) const {
    return (_type < other._type);
}
 
// True if the descriptors are identical
inline bool
PatchDescriptor::operator == ( PatchDescriptor const other ) const {
    return _type == other._type;
}
 
 
 
} // end namespace Far
 
} // end namespace OPENSUBDIV_VERSION
using namespace OPENSUBDIV_VERSION;
 
} // end namespace OpenSubdiv
 
#endif /* OPENSUBDIV3_FAR_PATCH_DESCRIPTOR_H */