HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
dynamicFileFormatContext.h
Go to the documentation of this file.
1 //
2 // Copyright 2019 Pixar
3 //
4 // Licensed under the Apache License, Version 2.0 (the "Apache License")
5 // with the following modification; you may not use this file except in
6 // compliance with the Apache License and the following modification to it:
7 // Section 6. Trademarks. is deleted and replaced with:
8 //
9 // 6. Trademarks. This License does not grant permission to use the trade
10 // names, trademarks, service marks, or product names of the Licensor
11 // and its affiliates, except as required to comply with Section 4(c) of
12 // the License and to reproduce the content of the NOTICE file.
13 //
14 // You may obtain a copy of the Apache License at
15 //
16 // http://www.apache.org/licenses/LICENSE-2.0
17 //
18 // Unless required by applicable law or agreed to in writing, software
19 // distributed under the Apache License with the above modification is
20 // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21 // KIND, either express or implied. See the Apache License for the specific
22 // language governing permissions and limitations under the Apache License.
23 //
24 #ifndef PXR_USD_PCP_DYNAMIC_FILE_FORMAT_CONTEXT_H
25 #define PXR_USD_PCP_DYNAMIC_FILE_FORMAT_CONTEXT_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/usd/pcp/api.h"
29 #include "pxr/usd/pcp/node.h"
30 
32 
33 class PcpPrimIndex_StackFrame;
34 class PcpCache;
35 
36 /// \class PcpDynamicFileFormatContext
37 ///
38 /// Context object for the current state of a prim index that is being built
39 /// that allows implementations of PcpDynamicFileFormatInterface to compose
40 /// field values when generating dynamic file format arguments. The context
41 /// allows us to iterate over all nodes that have already been composed looking
42 /// for the strongest opinion for a relevant field.
44 {
45 public:
46  using VtValueVector = std::vector<VtValue>;
47 
48  PCP_API
49  ~PcpDynamicFileFormatContext() = default;
50 
51  /// Compose the \p value of the given \p field and return its current
52  /// strongest opinion. For dictionary valued fields this will be a
53  /// dictionary containing the strongest value for each individual key.
54  /// Returns true if a value for the field was found.
55  PCP_API
56  bool ComposeValue(const TfToken &field, VtValue *value) const;
57 
58  /// Compose the \p values of the given \p field returning all available
59  /// opinions ordered from strongest to weakest. For dictionary valued
60  /// fields, the dictionaries from each opinion are not composed together
61  /// at each step and are instead returned in the list as is.
62  /// Returns true if a value for the field was found.
63  ///
64  /// Note that this is slower than ComposeValue, especially for
65  /// non-dictionary valued fields, and should only be used if knowing more
66  /// than just the strongest value is necessary.
67  PCP_API
68  bool ComposeValueStack(const TfToken &field,
69  VtValueVector *values) const;
70 
71  /// Compose the \p value of the default field of the attribute with the
72  /// given \p attributeName and return its current strongest opinion.
73  /// Returns true if a value for the field was found.
74  PCP_API
76  const TfToken &attributeName, VtValue *value) const;
77 
78 private:
79  /// Constructs a context.
80  /// \p parentNode and \p previousFrame are used to traverse the
81  /// current state of the prim index graph when composing the opinions on
82  /// fields. \p composedFieldNames is the set of field names that is
83  /// to be updated with the names of fields that ComposeValue and
84  /// ComposeValueStack are called on for dependency tracking.
86  const PcpNodeRef &parentNode,
87  PcpPrimIndex_StackFrame *previousFrame,
88  TfToken::Set *composedFieldNames,
89  TfToken::Set *composedAttributeNames);
90 
91  /// Access to private constructor. Should only be called by prim indexing.
93  const PcpNodeRef &, PcpPrimIndex_StackFrame *,
95 
96  /// Returns whether the given \p field is allowed to be used to generate
97  /// file format arguments. It can also return whether the value type of
98  /// the field is a dictionary if needed.
99  bool _IsAllowedFieldForArguments(
100  const TfToken &field, bool *fieldValueIsDictionary = nullptr) const;
101 
102 private:
103  PcpNodeRef _parentNode;
104  PcpPrimIndex_StackFrame *_previousStackFrame;
105 
106  // Cached names of fields that had values composed by this context.
107  TfToken::Set *_composedFieldNames;
108 
109  // Cached names of attributes that had default values composed by this
110  // context.
111  TfToken::Set *_composedAttributeNames;
112 
113  // Declare private helper.
114  class _ComposeValueHelper;
115 };
116 
118 
119 #endif // PXR_USD_PCP_DYNAMIC_FILE_FORMAT_CONTEXT_H
PCP_API bool ComposeValue(const TfToken &field, VtValue *value) const
Definition: cache.h:93
friend PcpDynamicFileFormatContext Pcp_CreateDynamicFileFormatContext(const PcpNodeRef &, PcpPrimIndex_StackFrame *, TfToken::Set *, TfToken::Set *)
Access to private constructor. Should only be called by prim indexing.
std::vector< VtValue > VtValueVector
Definition: token.h:87
PCP_API ~PcpDynamicFileFormatContext()=default
PCP_API bool ComposeValueStack(const TfToken &field, VtValueVector *values) const
PCP_API bool ComposeAttributeDefaultValue(const TfToken &attributeName, VtValue *value) const
PXR_NAMESPACE_CLOSE_SCOPE PXR_NAMESPACE_OPEN_SCOPE
Definition: path.h:1441
GLenum GLsizei GLsizei GLint * values
Definition: glcorearb.h:1602
#define PXR_NAMESPACE_CLOSE_SCOPE
Definition: pxr.h:91
Definition: core.h:1131
Definition: value.h:167
std::set< TfToken, TfTokenFastArbitraryLessThan > Set
Definition: token.h:183
#define PCP_API
Definition: api.h:40