HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
UT_EnvControl.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  * NAME: UT_EnvControl.h ( UT Library, C++)
7  *
8  * COMMENTS: In Houdini applications, there are many environment variables
9  * which control the behaviour of certain features/capabilities.
10  * This class provides a centralized place to efficiently query
11  * these variables. The reason for the centralization is so that
12  * we can easily get a list of these control variables. As well,
13  * this mechanism provides ways of changing the control settings
14  * from environment variables to disk file to registry entry.
15  * Currently only environment variable control is supported.
16  *
17  *
18  * When adding a new environment variable, please document the variable in
19  * $SHD/ref/env.txt
20  */
21 
22 #ifndef __UT_EnvControl__
23 #define __UT_EnvControl__
24 
25 #include "UT_API.h"
26 #include "UT_StringHolder.h"
27 #include <SYS/SYS_StaticAssert.h>
28 #include <SYS/SYS_Types.h>
29 
30 class UT_StringArray;
31 class UT_Variant;
32 
33 namespace UT_Package
34 {
35  class Loader;
36  class Package;
37 }
38 
39 // This define declares a fixed size of array for holding our cached
40 // environment variable values. It should be larger than any of our actual
41 // requirements so that we can add new enum values to the end of these
42 // tables without breaking ABI compatibility (as long as we don't actually
43 // exceed this value and need to increase it).
44 #define MAX_CONTROLS_WITH_BUFFER 512
45 
47 {
48  // UT library: Public interface
66 
67  // UT: Internal controls
79 
80  // Houdini Environment File Control
83 
84  // FS: Public interface
92 
93  // GA: Public interface
95 
96  // IMG3D: Public interface
98 
99  // IMG: Public interface
128  // IMG: Private interface
137 
138  // MV: Public interface
140 
141  // VEX: Public interface
152 
153  // VEX: Private interface
155 
156  // RE: Public interface
166 
167  // CMD
170 
171  // OP
175 
176  // GEO
180 
181  // GU
183 
184  // RAY
195 
199 
222 
225 
226  // COP2
229 
230  // IFD
234 
235  // MAT
237 
238  // UI
260 
261  // OPUI
267 
268  // DM
271 
272  // MATUI
274 
275  // Custom
280 
281  // LM
292 
293  // CHOP
295 
296  // SHOP
299 
300  // VOP
302 
303  // SHLF
306 
307  // Other
313 
314  // Backwards Compatability
323 
336 
338  // Have houdini check process fallback to the old deprecated API
342 
344 
345  // hscript
349 
351 
352  // This is for "internal use" only. It turns on features that are not
353  // ready for prime-time.
355 
356  // Maximum number of files to keep in the backup directory
358 
360 
362 
364 
367 
370 
372 
373  // Controls the number of complete FBX scenes to
374  // keep cached in memory after import. Defaults to 1.
376 
377  // Controls whether to transform the results of evaluating a MotionClip
378  // by the intrinsic matrix of the packed primitive.
380 
385 
388 
389  // OpenGL
393 
394  // OpenCL
398  ENV_HOUDINI_OCL_OGL_INTEROP, // Use CE_Context::shouldUseOCLOGLInterop instead of raw access to this that does additional compatability checks
401  // Can be used to force disable the use of images for advection by the Gas
402  // Advect CL 2.0 DOP.
404  // Can be used to force use of SwiftShader by the Rasterize Geometry COP.
406  // The rasterizer COP can use interop to copy from vulkan memory to OpenCL
407  // memory without leaving the GPU. However, this causes a memory leak on
408  // some NVIDIA drivers. This environment variable controls that
409  // functionality (0 means no interop, 1 means do it if we can).
412 
416 
418 
419  // Maximum megabytes in write buffer.
421 
423 
427 
430 
432 
434 
436 
438 
440 
443 
445 
447 
448  // Used to force regular LM checks on Steam builds
450 
451  // OptiX
453 
455 
456  // Package
459 
460  // Viewer state
462 
464 
466 
468 
469  // TOP
482 
483  // HAPI
485 
486  // LOP
490 
492 
494 
495  // HDA plugin for USD geometry cache size
497 
499 
501 
503 
504  // Send python panel erros to the console
506 
508 
510 
512 
513  // Specify whether or not Houdini GL should use Mtlx materials
515 
516  // New op viewer, defaults to on.
518 
520 
522 
524 
526 
527  ENV_KARMA_DICING_LEGACY, // Karma legacy dicing behaviour
528  ENV_KARMA_VARYING_ARRAY_PRIMVARS, // Varying length array primvars
531 
532  // Save HDA internal sections alphabetically (where it makes sens)
534 
536 
537  // MV
539 
541 
543 
544  // microfacet conductor fresnel to fix glowing issue with rough metals
546 
547  // texturing issues relating to bad derivatives
549 
551 
553 
555 
557 
560 
561  // Suppress creation of the non-critical files when expanding an HDA
563 
564  // Tells Houdini to prefer "last cooked" context options over "global"
565  // options when a node is asked to cook with its last cooked options.
567 
569 
571 
573 
575 
580 
582 
584 
585  // Change to behavior of primitive sub-patterns. New behavior is
586  // definitely more correct, but might change things in unexpected ways.
588 
591 
593 
594  ENV_MAX_INT_CONTROLS // <- Must be last
595 };
596 
598 {
599  // UT: Public interface
603 
604  // UT: Internal variables
606 
607  // IMG: Public interface
610 
611  // RE
613 
614  // UI
617 
618  // GR
620 
621  // Custom
623 
624  // ROP: Internal variables
626 
627  // OpenCL: Memory pool size, as percentage of GPU memory.
629 
630  // OpenCL: amount of VRAM that IMX layers are allowed to use.
632 
633  // CH
635 
636  // LOP interactive selection redraw time
638 
639  // Percent grey that shows as a zero exposure value when displaying
640  // pixel luminance in log terms. Values outside (0, 1) cause us to
641  // not calculate or display luminance in log terms.
643 
644  ENV_MAX_FLT_CONTROLS // <- Must be last
645 };
646 
648 {
649  // UT: Public interface
669 
670  // UT: Internal variables
674 
675  // external tools
677 
678  // IMG: Public interface
681 
682  // VEX(VMAT)
691 
692  // HOM
694 
695  // OP
696  ENV_HOUDINI_HIP_DEFAULT_NAME, // "untitled.hip"
699 
700  // VOP
702 
703  // GEO
705 
706  // COP
713 
714  // CHOP
716 
717  // TOP
719 
720  // LOP
722 
723  // IFD
729 
730  // UI
741 
742  // FUI
745 
746  // CHUI
748 
749  // OPUI
753 
754  // VEX(VCC)
756 
757  // Custom
765  ENV_HOUDINI_VIEW_METACAM, //OTLs that lock to view in a special way
766 
767  // Path variables
770 
801 
805 
807 
810 
812 
818 
820 
822 
827 
834 
837 
839 
841 
842  // These are here so we can have them show up in hconfig and provide
843  // help. They should only be used implicitly.
844  ENV_HSITE, // Between HFS and HOME.
845  ENV_JOB, // We should not use JOB!
846 
848 
851 
853 
854  // OPENGL
861 
862  // OPENCL
869 
870  // Orbolt
872 
873  // Anonymous Usage Statistics
875 
877 
879 
881 
882  // Optix
884 
886 
887  // BGEO plugin for USD default load arguments
889 
890  // LM
908 
909  // Python
911 
912  // Logging
916 
917  // Default asset/material catalog databases
921 
922  // Networking
925 
926  // HQueue
932 
933  // Render delegate to use by default on new Houdini clones
938 
939  // Render Product Types that should not show their AOVs in the list
940  // that shows up in the viewport menu.
942 
945 
947 
948  // When a loaded HDA changes on disk, perform this action by default
949  // instead of showing the interactive message.
951 
952  // Compression method to specify a default compression method for
953  // .hip files
955 
956  ENV_MAX_STR_CONTROLS // <- Must be last
957 };
958 
959 // If these constraints are ever violated in a HEAD branch, it's time to
960 // increase MAX_CONTROLS_WITH_BUFFER. If these constraints are violated in
961 // a released build, get rid of the "+50" part, and if they are exceeded
962 // again then we must increate MAX_CONTROLS_WITH_BUFFER in a daily build and
963 // break ABI compatiblity. But hopefully that won't happen...
967 
969 {
970 public:
971  UT_EnvControl();
972  ~UT_EnvControl();
973 
974  UT_EnvControl(const UT_EnvControl &) = delete;
975  UT_EnvControl &operator=(const UT_EnvControl &) = delete;
976 
977  void init();
978 
979  static int getInt(UT_IntControl i)
980  { return getControl().myIValues[i]; }
982  { return getControl().myFValues[i]; }
983  static const char *getString(UT_StrControl i)
984  { return getControl().mySValues[i]; }
985 
986  // Look up the appropriate variable name for the token
987  static const char *getIntVar(UT_IntControl i);
988  static const char *getFloatVar(UT_FltControl i);
989  static const char *getStringVar(UT_StrControl i);
990 
991  static void setStringVar(UT_StrControl i, const char *value);
992 
993  // Look up the appropriate old style variable name for the token. This can
994  // be used to check for old environment variables.
995  static const char *getOldIntVar(UT_IntControl i);
996  static const char *getOldFloatVar(UT_FltControl i);
997  static const char *getOldStringVar(UT_StrControl i);
998 
999  /// Indicate that the given variable changed and update our cached values.
1000  /// If varname is NULL, then all variables are updated.
1001  static void varChanged(const char *varname)
1002  { varChanged(varname, nullptr); }
1003 
1004  /// Update the cached varname value with the given value so that we can
1005  /// avoid an extraneous HoudiniGetenv() for the equivalent code snippet:
1006  /// @code
1007  /// HoudiniSetenv(name, value);
1008  /// UT_EnvControl::varChanged(name);
1009  /// @endcode
1010  /// @return true if name was found and value is non-null, in which case the
1011  /// HoudiniSetenv() was called, else false is returned.
1012  static bool varChanged(const char *varname, const char *value);
1013 
1014  static void changeExistLookupDefault(UT_IntControl i, int new_def);
1015 
1016  /// Queries the cached variable value. Unrecognized variables are
1017  /// returned as UT_Variant::Type::Unknown. String values are returned
1018  /// as UT_Variant::Type::Pointer to allow distinguishing between null
1019  /// pointers and empty strings. If you intend to hold onto the string
1020  /// value beyond immediately using it, you must make your own copy!
1021  static UT_Variant getVarValue(const char *varname);
1022 
1023  /// Set all additional .env files to be parsed for env variable values.
1024  /// It is best to call getAdditionalEnvironmentFiles() first and then
1025  /// append to the list because this function will overwrite all the
1026  /// additional paths that were previously set.
1027  /// You can still use the HOUDINI_NO_ENV_FILE_OVERRIDES to disallow
1028  /// overwrites, knowing that these files get applied AFTER the default
1029  /// houdini.env file in the user's home directory.
1030  /// That said, HOUDINI_NO_ENV_FILE will have no effect on this function.
1031  /// If additional files are set, they will be used, regardless of the
1032  /// value of HOUDINI_NO_ENV_FILE.
1033  static void setAdditionalEnvironmentFiles(
1034  const UT_StringArray &files);
1035 
1036  /// Return the current list of additional environment files.
1037  static const UT_StringArray&
1038  getAdditionalEnvironmentFiles();
1039 
1040  // Print messages collected during init phase to console
1041  static void logMessages()
1042  {
1043  getControl().logMessagesToConsole();
1044  }
1045 
1046  // Package loader management
1047  // Load the pakages located in the folders specified by pkg_paths.
1048  // Use this method for loading package dynamically
1049  static void loadPackages(UT_StringArray const &pkg_paths, UT_Package::Loader& pkg_loader);
1050  static UT_Package::Package & loadPackage(char const * pkg_filepath, UT_Package::Loader& pkg_loader);
1051 
1052  // Returns the main package loader, this loader contains all
1053  // packages loaded at runtime.
1054  static UT_Package::Loader& packageLoader();
1055 
1056 private:
1057  void doInit(bool init_defaults);
1058  void setDefaults();
1059  bool loadEnvironmentFile(const char *path,
1060  bool allow_overrides);
1061  void loadDefaultEnvironmentFile();
1062  void loadEnvironmentFiles();
1063  void loadEnvironment(bool init_defaults);
1064 
1065  void updateExistLookup(int i, const char *value = nullptr);
1066  void updateIntLookup(int i, const char *value = nullptr);
1067  void updateFltLookup(int i, const char *value = nullptr);
1068  void updateStrLookup(int i, bool fix_path,
1069  const char *value = nullptr);
1070 
1071  void updateVarTables(UT_Package::Loader const& pkg_loader);
1072 
1073  void loadPackageConfig();
1074  void logMessagesToConsole() const;
1075 
1076  int myIValues[MAX_CONTROLS_WITH_BUFFER];
1077  float myFValues[MAX_CONTROLS_WITH_BUFFER];
1078  char *mySValues[MAX_CONTROLS_WITH_BUFFER];
1079 
1080  static UT_EnvControl &getControl()
1081  {
1082  if (!theControl)
1083  {
1084  theControl = new UT_EnvControl();
1085  theControl->init();
1086 
1087  }
1088  return *theControl;
1089  }
1090  static UT_EnvControl *theControl;
1091 
1092  UT_StringHolder myLogMessages;
1093 };
1094 
1095 #endif
static void varChanged(const char *varname)
static const char * getString(UT_StrControl i)
GLsizei const GLfloat * value
Definition: glcorearb.h:824
GLsizei const GLchar *const * path
Definition: glcorearb.h:3341
#define UT_API
Definition: UT_API.h:14
static void logMessages()
UT_StrControl
static int getInt(UT_IntControl i)
static fpreal getFloat(UT_FltControl i)
fpreal64 fpreal
Definition: SYS_Types.h:278
LeafData & operator=(const LeafData &)=delete
SYS_STATIC_ASSERT(ENV_MAX_INT_CONTROLS+50< MAX_CONTROLS_WITH_BUFFER)
UT_FltControl
#define MAX_CONTROLS_WITH_BUFFER
Definition: UT_EnvControl.h:44
UT_IntControl
Definition: UT_EnvControl.h:46