2013-05-17 16:47:44 +00:00
|
|
|
//
|
2013-09-26 19:04:57 +00:00
|
|
|
// Copyright 2013 Pixar
|
2013-05-17 16:47:44 +00:00
|
|
|
//
|
2013-09-26 19:04:57 +00:00
|
|
|
// 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:
|
2013-05-17 16:47:44 +00:00
|
|
|
//
|
2013-09-26 19:04:57 +00:00
|
|
|
// 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.
|
2013-05-17 16:47:44 +00:00
|
|
|
//
|
2013-09-26 19:04:57 +00:00
|
|
|
// You may obtain a copy of the Apache License at
|
2013-05-17 16:47:44 +00:00
|
|
|
//
|
2013-09-26 19:04:57 +00:00
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
2013-07-18 21:19:50 +00:00
|
|
|
//
|
2013-09-26 19:04:57 +00:00
|
|
|
// 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.
|
2013-05-17 16:47:44 +00:00
|
|
|
//
|
|
|
|
|
2015-05-19 18:22:37 +00:00
|
|
|
#ifndef OPENSUBDIV3_FAR_PATCH_PARAM_H
|
|
|
|
#define OPENSUBDIV3_FAR_PATCH_PARAM_H
|
2013-05-17 16:47:44 +00:00
|
|
|
|
2013-06-12 00:25:54 +00:00
|
|
|
#include "../version.h"
|
|
|
|
|
2014-10-09 21:48:50 +00:00
|
|
|
#include "../far/types.h"
|
|
|
|
|
2013-05-17 16:47:44 +00:00
|
|
|
namespace OpenSubdiv {
|
|
|
|
namespace OPENSUBDIV_VERSION {
|
|
|
|
|
2014-09-05 22:07:46 +00:00
|
|
|
namespace Far {
|
|
|
|
|
2013-05-17 16:47:44 +00:00
|
|
|
/// \brief Local patch parameterization descriptor
|
|
|
|
///
|
|
|
|
/// Coarse mesh faces are split into sets of patches in both uniform and feature
|
|
|
|
/// adaptive modes. In order to maintain local patch parameterization, it is
|
|
|
|
/// necessary to retain some information, such as level of subdivision, face-
|
|
|
|
/// winding status... This parameterization is directly applicable to ptex textures,
|
|
|
|
/// but has to be remapped to a specific layout for uv textures.
|
|
|
|
///
|
|
|
|
/// Bitfield layout :
|
2014-11-25 20:41:19 +00:00
|
|
|
///
|
2015-06-11 20:18:25 +00:00
|
|
|
/// Field0 | Bits | Content
|
2013-07-11 01:51:43 +00:00
|
|
|
/// -----------|:----:|------------------------------------------------------
|
2015-06-11 20:18:25 +00:00
|
|
|
/// faceId | 28 | the faceId of the patch
|
|
|
|
/// transition | 4 | transition edge mask encoding
|
|
|
|
///
|
|
|
|
/// Field1 | Bits | Content
|
|
|
|
/// -----------|:----:|------------------------------------------------------
|
|
|
|
/// level | 4 | the subdivision level of the patch
|
2014-11-25 20:41:19 +00:00
|
|
|
/// nonquad | 1 | whether the patch is the child of a non-quad face
|
2015-06-11 20:18:25 +00:00
|
|
|
/// unused | 3 | transition edge mask encoding
|
2015-04-17 14:42:53 +00:00
|
|
|
/// boundary | 4 | boundary edge mask encoding
|
2014-11-25 20:41:19 +00:00
|
|
|
/// v | 10 | log2 value of u parameter at first patch corner
|
|
|
|
/// u | 10 | log2 value of v parameter at first patch corner
|
|
|
|
///
|
2013-05-17 16:47:44 +00:00
|
|
|
/// Note : the bitfield is not expanded in the struct due to differences in how
|
|
|
|
/// GPU & CPU compilers pack bit-fields and endian-ness.
|
|
|
|
///
|
2014-09-05 22:07:46 +00:00
|
|
|
struct PatchParam {
|
2013-07-11 01:51:43 +00:00
|
|
|
/// \brief Sets the values of the bit fields
|
2013-05-17 16:47:44 +00:00
|
|
|
///
|
2015-06-11 20:18:25 +00:00
|
|
|
/// @param faceid face index
|
2013-05-17 16:47:44 +00:00
|
|
|
///
|
|
|
|
/// @param u value of the u parameter for the first corner of the face
|
|
|
|
/// @param v value of the v parameter for the first corner of the face
|
|
|
|
///
|
|
|
|
/// @param depth subdivision level of the patch
|
|
|
|
/// @param nonquad true if the root face is not a quad
|
2015-06-22 20:45:55 +00:00
|
|
|
//
|
|
|
|
/// @param boundary 4-bits identifying boundary edges
|
|
|
|
/// @param transition 4-bits identifying transition edges
|
2013-05-17 16:47:44 +00:00
|
|
|
///
|
2015-06-11 20:18:25 +00:00
|
|
|
void Set( Index faceid, short u, short v,
|
|
|
|
unsigned short depth, bool nonquad ,
|
2015-04-17 14:42:53 +00:00
|
|
|
unsigned short boundary, unsigned short transition );
|
2014-11-25 20:41:19 +00:00
|
|
|
|
2013-07-11 01:51:43 +00:00
|
|
|
/// \brief Resets everything to 0
|
2015-06-11 20:18:25 +00:00
|
|
|
void Clear() { field0 = field1 = 0; }
|
|
|
|
|
|
|
|
/// \brief Retuns the faceid
|
|
|
|
Index GetFaceId() const { return Index(field0 & 0xfffffff); }
|
|
|
|
|
|
|
|
/// \brief Returns the log2 value of the u parameter at the top left corner of
|
|
|
|
/// the patch
|
|
|
|
unsigned short GetU() const { return (unsigned short)((field1 >> 22) & 0x3ff); }
|
|
|
|
|
|
|
|
/// \brief Returns the log2 value of the v parameter at the top left corner of
|
|
|
|
/// the patch
|
|
|
|
unsigned short GetV() const { return (unsigned short)((field1 >> 12) & 0x3ff); }
|
|
|
|
|
|
|
|
/// \brief Returns the transition edge encoding for the patch.
|
|
|
|
unsigned short GetTransition() const { return (unsigned short)((field0 >> 28) & 0xf); }
|
|
|
|
|
|
|
|
/// \brief Returns the boundary edge encoding for the patch.
|
|
|
|
unsigned short GetBoundary() const { return (unsigned short)((field1 >> 8) & 0xf); }
|
|
|
|
|
|
|
|
/// \brief True if the parent coarse face is a non-quad
|
|
|
|
bool NonQuadRoot() const { return (field1 >> 4) & 0x1; }
|
|
|
|
|
|
|
|
/// \brief Returns the fraction of normalized parametric space covered by the
|
|
|
|
/// sub-patch.
|
|
|
|
float GetParamFraction() const;
|
|
|
|
|
|
|
|
/// \brief Returns the level of subdivision of the patch
|
|
|
|
unsigned short GetDepth() const { return (unsigned short)(field1 & 0xf); }
|
|
|
|
|
|
|
|
/// The (u,v) pair is normalized to this sub-parametric space.
|
|
|
|
///
|
|
|
|
/// @param u u parameter
|
|
|
|
/// @param v v parameter
|
|
|
|
///
|
|
|
|
void Normalize( float & u, float & v ) const;
|
|
|
|
|
|
|
|
unsigned int field0:32;
|
|
|
|
unsigned int field1:32;
|
2013-05-17 16:47:44 +00:00
|
|
|
};
|
|
|
|
|
2014-11-25 20:41:19 +00:00
|
|
|
typedef std::vector<PatchParam> PatchParamTable;
|
|
|
|
|
2014-12-15 18:23:13 +00:00
|
|
|
typedef Vtr::Array<PatchParam> PatchParamArray;
|
|
|
|
typedef Vtr::ConstArray<PatchParam> ConstPatchParamArray;
|
2014-11-25 20:41:19 +00:00
|
|
|
|
|
|
|
inline void
|
2015-06-11 20:18:25 +00:00
|
|
|
PatchParam::Set( Index faceid, short u, short v,
|
|
|
|
unsigned short depth, bool nonquad,
|
|
|
|
unsigned short boundary, unsigned short transition ) {
|
|
|
|
field0 = (((unsigned int)faceid) & 0xfffffff) |
|
|
|
|
((transition & 0xf) << 28);
|
|
|
|
field1 = ((u & 0x3ff) << 22) |
|
|
|
|
((v & 0x3ff) << 12) |
|
|
|
|
((boundary & 0xf) << 8) |
|
|
|
|
((nonquad ? 1:0) << 4) |
|
|
|
|
(nonquad ? depth+1 : depth);
|
2014-11-25 20:41:19 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
inline float
|
2015-06-11 20:18:25 +00:00
|
|
|
PatchParam::GetParamFraction( ) const {
|
2013-06-05 18:44:30 +00:00
|
|
|
if (NonQuadRoot()) {
|
2013-06-11 22:59:43 +00:00
|
|
|
return 1.0f / float( 1 << (GetDepth()-1) );
|
2013-06-05 18:44:30 +00:00
|
|
|
} else {
|
2013-06-11 22:59:43 +00:00
|
|
|
return 1.0f / float( 1 << GetDepth() );
|
2013-06-05 18:44:30 +00:00
|
|
|
}
|
2013-06-11 22:59:43 +00:00
|
|
|
}
|
|
|
|
|
2013-06-13 20:58:23 +00:00
|
|
|
inline void
|
2015-06-11 20:18:25 +00:00
|
|
|
PatchParam::Normalize( float & u, float & v ) const {
|
2013-06-11 22:59:43 +00:00
|
|
|
|
|
|
|
float frac = GetParamFraction();
|
2013-06-05 18:44:30 +00:00
|
|
|
|
2013-06-13 20:58:23 +00:00
|
|
|
// top left corner
|
2013-06-05 18:44:30 +00:00
|
|
|
float pu = (float)GetU()*frac;
|
|
|
|
float pv = (float)GetV()*frac;
|
|
|
|
|
|
|
|
// normalize u,v coordinates
|
|
|
|
u = (u - pu) / frac,
|
|
|
|
v = (v - pv) / frac;
|
|
|
|
}
|
|
|
|
|
2014-09-05 22:07:46 +00:00
|
|
|
} // end namespace Far
|
|
|
|
|
2013-05-17 16:47:44 +00:00
|
|
|
} // end namespace OPENSUBDIV_VERSION
|
|
|
|
using namespace OPENSUBDIV_VERSION;
|
|
|
|
|
|
|
|
} // end namespace OpenSubdiv
|
|
|
|
|
2015-05-19 18:22:37 +00:00
|
|
|
#endif /* OPENSUBDIV3_FAR_PATCH_PARAM */
|