HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HOM_ParmTuple.h
Go to the documentation of this file.
1 /*
2  * PROPRIETARY INFORMATION. This software is proprietary to
3  * Side Effects Software Inc., and is not to be reproduced,
4  * transmitted, or disclosed in any way without written permission.
5  *
6  * COMMENTS:
7  */
8 
9 #ifndef __HOM_ParmTuple_h__
10 #define __HOM_ParmTuple_h__
11 
12 #include "HOM_API.h"
13 #include "HOM_Defines.h"
14 #include "HOM_Errors.h"
15 #include "HOM_BaseKeyframe.h"
16 #include "HOM_PtrOrNull.h"
17 #include <string>
18 #include <vector>
19 #include <stdexcept>
20 class HOM_ParmTemplate;
21 class HOM_Parm;
22 class HOM_Ramp;
23 
24 SWIGOUT(%rename(ParmTuple) HOM_ParmTuple;)
25 
27 {
28 public:
30  { HOM_CONSTRUCT_OBJECT(this) }
31  HOM_ParmTuple(const HOM_ParmTuple &parm_tuple)
32  { HOM_CONSTRUCT_OBJECT(this) }
33  virtual ~HOM_ParmTuple()
34  { HOM_DESTRUCT_OBJECT(this) }
35 
36  virtual bool operator==(HOM_PtrOrNull<HOM_ParmTuple> parm_tuple) = 0;
37  virtual bool operator!=(HOM_PtrOrNull<HOM_ParmTuple> parm_tuple) = 0;
38 
39  virtual int __hash__() = 0;
40  virtual std::string __repr__() = 0;
41 
42  SWIGOUT(%newobject node;)
43  virtual HOM_Node *node() = 0;
44 
45  SWIGOUT(%newobject parmTemplate;)
46  virtual HOM_ParmTemplate *parmTemplate() = 0;
47 
48  virtual std::string name() = 0;
49  virtual std::string description() = 0;
50 
51  // Wrapping a version of set() that takes a vector of doubles will
52  // let you pass a vector of doubles or a vector of ints to it. So,
53  // we don't bother to provide a version that takes a vector of ints.
54  virtual void _set(const std::vector<double> &float_values) = 0;
55  virtual void setPending(const std::vector<double> &float_values) = 0;
56  virtual void _set(const std::vector<std::string> &string_values) = 0;
57  virtual void setPending(const std::vector<std::string> &string_values) = 0;
58  virtual void _set(const std::vector<HOM_Ramp *> &ramp_values) = 0;
59  virtual void setPending(const std::vector<HOM_Ramp *> &ramp_values) = 0;
60 
61  virtual void overwriteDefaults() = 0;
62  virtual void revertToDefaults() = 0;
63  virtual void revertToAndRestorePermanentDefaults() = 0;
64 
65  SWIGOUT(%kwargs isAtDefault;)
66  virtual bool isAtDefault(bool compare_temporary_defaults=true,
67  bool compare_expressions=true) = 0;
68  virtual bool isAtRampDefault() = 0;
69 
70  virtual std::vector<double> evalAsFloats() = 0;
71 
72  virtual std::vector<double> evalAsFloatsAtFrame(double frame) = 0;
73 
74  virtual std::vector<int> evalAsInts() = 0;
75 
76  virtual std::vector<int> evalAsIntsAtFrame(double frame) = 0;
77 
78  virtual std::vector<std::string> evalAsStrings() = 0;
79 
80  virtual std::vector<std::string> evalAsStringsAtFrame(double frame) = 0;
81 
82  virtual std::vector<HOM_ElemPtr<HOM_Ramp> > evalAsRamps() = 0;
83 
84  SWIGOUT(%newobject evalAsRampAtFrame;)
85  virtual std::vector<HOM_ElemPtr<HOM_Ramp> > evalAsRampsAtFrame(double frame) = 0;
86 
87  SWIGOUT(%newobject evalAsGeometries;)
88  virtual std::vector<HOM_ElemPtr<HOM_Geometry> > evalAsGeometries() = 0;
89 
90  SWIGOUT(%newobject evalAsGeometriesAtFrame;)
91  virtual std::vector<HOM_ElemPtr<HOM_Geometry> > evalAsGeometriesAtFrame(double frame) = 0;
92 
93  SWIGOUT(%newobject evalAsImageLayers;)
94  virtual std::vector<HOM_ElemPtr<HOM_ImageLayer> > evalAsImageLayers() = 0;
95 
96  SWIGOUT(%newobject evalAsImageLayersAtFrame;)
97  virtual std::vector<HOM_ElemPtr<HOM_ImageLayer> > evalAsImageLayersAtFrame(double frame) = 0;
98 
99  SWIGOUT(%newobject evalAsNanoVDBs;)
100  virtual std::vector<HOM_ElemPtr<HOM_NanoVDB> > evalAsNanoVDBs() = 0;
101 
102  SWIGOUT(%newobject evalAsNanoVDBsAtFrame;)
103  virtual std::vector<HOM_ElemPtr<HOM_NanoVDB> > evalAsNanoVDBsAtFrame(double frame) = 0;
104 
105  virtual std::vector<std::map<std::string, std::string> >
106  evalAsJSONMaps() = 0;
107  virtual std::vector<std::map<std::string, std::string> >
108  evalAsJSONMapsAtFrame(double frame) = 0;
109 
110 
111  virtual void lock(bool on) = 0;
112  virtual void lock(const std::vector<bool> &bool_values) = 0;
113  virtual void setAutoscope(const std::vector<bool> &bool_values) = 0;
114 
115  virtual bool isSpare() = 0;
116 
117  virtual bool isTimeDependent() = 0;
118 
119  virtual bool isMultiParmInstance() = 0;
120  virtual bool isMultiParmParent() = 0;
121  SWIGOUT(%newobject parentMultiParm;)
122  virtual HOM_Parm *parentMultiParm() = 0;
123  virtual std::vector<int> multiParmInstanceIndices() = 0;
124 
125  virtual int multiParmInstancesPerItem() = 0;
126  virtual int multiParmInstancesCount() = 0;
127  virtual int multiParmStartOffset() = 0;
128 
129  virtual std::vector<HOM_ElemPtr<HOM_ParmTuple> > multiParmInstances() = 0;
130 
131  virtual std::vector<std::string> containingFolders() = 0;
132  virtual std::vector<int> containingFolderIndices() = 0;
133  virtual std::vector<HOM_ElemPtr<HOM_ParmTuple> >
134  containingFolderSetParmTuples() = 0;
135 
136  virtual void setKeyframe(const std::vector<HOM_BaseKeyframe *> &keyframes) = 0;
137  virtual void deleteKeyframeAtFrame(double frame) = 0;
138  virtual void deleteAllKeyframes() = 0;
139 
140  SWIGOUT(%newobject __getitem__;)
141  virtual HOM_Parm *__getitem__(int index) = 0;
142  virtual int __len__() = 0;
143  virtual bool __bool__() = 0;
144 
145  SWIGOUT(%newobject createClip;)
146  virtual HOM_Node *createClip(HOM_Node &parent_node,
147  const char *name,
148  bool create_new,
149  bool apply_immediately,
150  bool current_value_only=false,
151  bool create_locked=false,
152  bool set_value_to_default=false) = 0;
153 
154  virtual void appendClip(HOM_Node &chop_node,
155  bool apply_immediately,
156  bool current_value_only=false,
157  bool create_locked=false,
158  bool set_value_to_default=false) = 0;
159 
160  virtual HOM_BinaryString _clipData(double start,
161  double end,
162  bool binary = true,
163  bool use_blosc_compression = true,
164  double sample_rate = 0) = 0;
165 
166  SWIGOUT(%kwargs _setClipData;)
167  virtual void _setClipData(HOM_BinaryString data,
168  bool binary = true,
169  bool blosc_compressed = true,
170  double sample_rate = 0,
171  double start = HOM_MIN_NEGATIVE_DOUBLE) = 0;
172 
173  virtual void _saveClip(std::string file_name,
174  double start,
175  double end,
176  double sample_rate = 0) = 0;
177 
178  SWIGOUT(%kwargs _loadClip;)
179  virtual void _loadClip(std::string file_name,
180  double sample_rate = 0,
181  double start = HOM_MIN_NEGATIVE_DOUBLE) = 0;
182 
183  virtual void copyToParmClipboard() = 0;
184 
185  virtual void *_asVoidPointer() = 0;
186 
187  SWIGOUT(%kwargs asCode;)
188  virtual std::string asCode(bool brief=false, bool save_values=true,
189  bool save_keyframes=true,
190  bool save_keys_in_frames=false,
191  bool save_flag_values=true,
192  bool save_aliases=true,
193  const char *function_name=NULL) = 0;
194 
195  // You can get the parm data type with parmTemplate().dataType().
196  // However, we need a way to get the parm data type's enum value
197  // from C++ code without creating a temporary ParmTemplate object,
198  // so that's why parmDataTypeEnumId() exists.
199  SWIGOUT(%ignore parmDataTypeEnumId;)
200  virtual int parmDataTypeEnumId() = 0;
201 
202  // For data parameters only.
203  // You can get the data parm type with parmTemplate().dataParmType().
204  // However, we need a way to get the data parm type's enum value
205  // from C++ code without creating a temporary ParmTemplate object,
206  // so that's why dataParmTypeEnumId() exists.
207  SWIGOUT(%ignore dataParmTypeEnumId;)
208  virtual int dataParmTypeEnumId() = 0;
209 
210  virtual std::string help() = 0;
211  virtual std::string helpUrl() = 0;
212 
213  virtual bool isDisabled() = 0;
214 
215  virtual void disable(bool on) = 0;
216 
217  virtual bool isHidden() = 0;
218 
219  virtual void hide(bool on) = 0;
220 
221  virtual bool isConstrained() = 0;
222 
223  virtual bool isShowingExpression() = 0;
224  virtual void showExpression(bool value) = 0;
225 
226 #ifdef SWIG
227 %extend
228 {
229  %warnfilter(321) eval;
230  InterpreterObject eval()
231  {
232  return HOMevalParmTuple(*self);
233  }
234 
235  InterpreterObject evalAtFrame(double frame)
236  {
237  return HOMevalParmTupleAtFrame(*self, frame);
238  }
239 
240  InterpreterObject evalAtTime(double time)
241  {
242  return HOMevalParmTupleAtFrame(*self, HOM().timeToFrame(time));
243  }
244 }
245 #endif
246 };
247 
248 #endif
#define HOM_DESTRUCT_OBJECT(pointer)
Definition: HOM_Module.h:1343
GT_API const UT_StringHolder time
GLuint start
Definition: glcorearb.h:475
GLsizei const GLfloat * value
Definition: glcorearb.h:824
const GLuint GLenum const void * binary
Definition: glcorearb.h:1924
#define SWIGOUT(x)
Definition: HOM_Defines.h:24
string __repr__(VtArray< T > const &self)
Definition: wrapArray.h:312
std::string help(const App *app, const Error &e)
Printout the full help string on error (if this fn is set, the old default for CLI11) ...
Definition: CLI11.h:8978
#define HOM_API
Definition: HOM_API.h:13
void ignore(T const &) VULKAN_HPP_NOEXCEPT
Definition: vulkan.hpp:6508
GLuint GLuint end
Definition: glcorearb.h:475
#define HOM_CONSTRUCT_OBJECT(pointer)
Definition: HOM_Module.h:1342
bool operator!=(const Mat3< T0 > &m0, const Mat3< T1 > &m1)
Inequality operator, does exact floating point comparisons.
Definition: Mat3.h:556
#define HOM_MIN_NEGATIVE_DOUBLE
Definition: HOM_Defines.h:50
HUSD_API bool eval(VtValue &val, T &ret_val)
GLuint const GLchar * name
Definition: glcorearb.h:786
void * _asVoidPointer()
Definition: HOM_Ramp.h:68
OIIO_UTIL_API bool rename(string_view from, string_view to, std::string &err)
GLuint index
Definition: glcorearb.h:786
virtual ~HOM_ParmTuple()
Definition: HOM_ParmTuple.h:33
HOM_API HOM_Module & HOM()
bool operator==(const Mat3< T0 > &m0, const Mat3< T1 > &m1)
Equality operator, does exact floating point comparisons.
Definition: Mat3.h:542
Definition: format.h:1821
HOM_ParmTuple(const HOM_ParmTuple &parm_tuple)
Definition: HOM_ParmTuple.h:31