primHints.h
Go to the documentation of this file.
1 //
2 // Copyright 2025 Pixar
3 //
4 // Licensed under the terms set forth in the LICENSE.txt file available at
5 // https://openusd.org/license.
6 //
7 
8 #ifndef PXR_USD_USDUI_PRIM_HINTS_H
9 #define PXR_USD_USDUI_PRIM_HINTS_H
10 
12 
14 #include "pxr/usd/usd/prim.h"
15 
16 #include "pxr/base/vt/dictionary.h"
17 
18 PXR_NAMESPACE_OPEN_SCOPE
19 
34 {
35 public:
40  USDUI_API
42 
44  USDUI_API
45  explicit UsdUIPrimHints(const UsdPrim& prim);
46 
48  UsdPrim GetPrim() const { return _prim; }
49 
54  USDUI_API
56 
64  USDUI_API
65  bool SetDisplayGroupsExpanded(const VtDictionary& expanded);
66 
69  USDUI_API
70  bool GetDisplayGroupExpanded(const std::string& group) const;
71 
74  USDUI_API
76  const std::string& group,
77  bool expanded);
78 
86  USDUI_API
88 
98  USDUI_API
99  bool SetDisplayGroupsShownIf(const VtDictionary& shownIf);
100 
102  USDUI_API
103  std::string GetDisplayGroupShownIf(const std::string& group) const;
104 
107  USDUI_API
109  const std::string& group,
110  const std::string& shownIf);
111 
112 private:
113  UsdPrim _prim;
114 };
115 
116 PXR_NAMESPACE_CLOSE_SCOPE
117 
118 #endif
USDUI_API bool SetDisplayGroupsShownIf(const VtDictionary &shownIf)
Set the prim's display group "shown if" dictionary to shownIf.
USDUI_API VtDictionary GetDisplayGroupsShownIf() const
Return the prim's display group "shown if" dictionary.
A map with string keys and VtValue values.
Definition: dictionary.h:52
USDUI_API bool SetDisplayGroupExpanded(const std::string &group, bool expanded)
Set whether the display group named by group should be expanded by default.
USDUI_API bool SetDisplayGroupsExpanded(const VtDictionary &expanded)
Set the prim's display group expansion dictionary.
USDUI_API std::string GetDisplayGroupShownIf(const std::string &group) const
Return the "shown if" expression string for the named group.
USDUI_API UsdUIPrimHints()
Default constructor that creates an invalid hints object.
USDUI_API bool SetDisplayGroupShownIf(const std::string &group, const std::string &shownIf)
Set the "shown if" expression string for the named group to shownIf.
A "schema-like" wrapper that provides API for retrieving and authoring UI hint values within the uiHi...
Definition: primHints.h:33
UsdPrim is the sole persistent scenegraph object on a UsdStage, and is the embodiment of a "Prim" as ...
Definition: prim.h:116
A "schema-like" wrapper that provides API for retrieving and authoring UI hint values within the uiHi...
Definition: objectHints.h:59
UsdPrim GetPrim() const
Return the prim that this hints instance is interpreting.
Definition: primHints.h:48
USDUI_API VtDictionary GetDisplayGroupsExpanded() const
Return the prim's display group expansion dictionary.
USDUI_API bool GetDisplayGroupExpanded(const std::string &group) const
Return whether the display group named by group should be expanded by default.