stencilTableFactory.h

Go to the documentation of this file.

//
//   Copyright 2013 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_FAR_STENCILTABLE_FACTORY_H
#define OPENSUBDIV3_FAR_STENCILTABLE_FACTORY_H

#include "../version.h"

#include "../far/patchTable.h"

#include <vector>

namespace OpenSubdiv {
namespace OPENSUBDIV_VERSION {

namespace Far {

class TopologyRefiner;

class Stencil;
class StencilTable;
class LimitStencil;
class LimitStencilTable;

class StencilTableFactory {

public:

    enum Mode {
        INTERPOLATE_VERTEX=0,
        INTERPOLATE_VARYING
    };

    struct Options {

        Options() : interpolationMode(INTERPOLATE_VERTEX),
                    generateOffsets(false),
                    generateControlVerts(false),
                    generateIntermediateLevels(true),
                    factorizeIntermediateLevels(true),
                    maxLevel(10) { }

        unsigned int interpolationMode           : 2, 
                     generateOffsets             : 1, 
                     generateControlVerts        : 1, 
                     generateIntermediateLevels  : 1, 
                     factorizeIntermediateLevels : 1, 
                     maxLevel                    : 4; 
    };

    static StencilTable const * Create(TopologyRefiner const & refiner,
        Options options = Options());


    static StencilTable const * Create(int numTables, StencilTable const ** tables);


    static StencilTable const * AppendLocalPointStencilTable(
        TopologyRefiner const &refiner,
        StencilTable const *baseStencilTable,
        StencilTable const *localPointStencilTable,
        bool factorize = true);

private:

    // Generate stencils for the coarse control-vertices (single weight = 1.0f)
    static void generateControlVertStencils(int numControlVerts, Stencil & dst);
};

class LimitStencilTableFactory {

public:

    struct LocationArray {

        LocationArray() : ptexIdx(-1), numLocations(0), s(0), t(0) { }

        int ptexIdx,        
            numLocations;   

        float const * s,    
                    * t;    
    };

    typedef std::vector<LocationArray> LocationArrayVec;

    static LimitStencilTable const * Create(TopologyRefiner const & refiner,
        LocationArrayVec const & locationArrays,
            StencilTable const * cvStencils=0,
                PatchTable const * patchTable=0);
};


} // end namespace Far

} // end namespace OPENSUBDIV_VERSION
using namespace OPENSUBDIV_VERSION;

} // end namespace OpenSubdiv

#endif // OPENSUBDIV3_FAR_STENCILTABLE_FACTORY_H