The JUCE cross-platform C++ framework, with DISTRHO/KXStudio specific changes
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

133 lines
4.8KB

  1. /*
  2. ==============================================================================
  3. This file is part of the JUCE library.
  4. Copyright (c) 2017 - ROLI Ltd.
  5. JUCE is an open source library subject to commercial or open-source
  6. licensing.
  7. By using JUCE, you agree to the terms of both the JUCE 5 End-User License
  8. Agreement and JUCE 5 Privacy Policy (both updated and effective as of the
  9. 27th April 2017).
  10. End User License Agreement: www.juce.com/juce-5-licence
  11. Privacy Policy: www.juce.com/juce-5-privacy-policy
  12. Or: You may also use this code under the terms of the GPL v3 (see
  13. www.gnu.org/licenses).
  14. JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
  15. EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
  16. DISCLAIMED.
  17. ==============================================================================
  18. */
  19. #pragma once
  20. //==============================================================================
  21. const char* getPreferredLinefeed();
  22. String joinLinesIntoSourceFile (StringArray& lines);
  23. var parseJUCEHeaderMetadata (const File&);
  24. String trimCommentCharsFromStartOfLine (const String& line);
  25. String hexString8Digits (int value);
  26. String createAlphaNumericUID();
  27. String createGUID (const String& seed); // Turns a seed into a windows GUID
  28. String escapeSpaces (const String& text); // replaces spaces with blackslash-space
  29. String addQuotesIfContainsSpaces (const String& text);
  30. StringPairArray parsePreprocessorDefs (const String& defs);
  31. StringPairArray mergePreprocessorDefs (StringPairArray inheritedDefs, const StringPairArray& overridingDefs);
  32. String createGCCPreprocessorFlags (const StringPairArray& defs);
  33. String replacePreprocessorDefs (const StringPairArray& definitions, String sourceString);
  34. StringArray getCleanedStringArray (StringArray);
  35. StringArray getSearchPathsFromString (const String& searchPath);
  36. StringArray getCommaOrWhitespaceSeparatedItems (const String&);
  37. void setValueIfVoid (Value value, const var& defaultValue);
  38. void addPlistDictionaryKey (XmlElement* xml, const String& key, const String& value);
  39. void addPlistDictionaryKeyBool (XmlElement* xml, const String& key, bool value);
  40. void addPlistDictionaryKeyInt (XmlElement* xml, const String& key, int value);
  41. bool fileNeedsCppSyntaxHighlighting (const File& file);
  42. StringArray getJUCEModules() noexcept;
  43. bool isJUCEModule (const String& moduleID) noexcept;
  44. StringArray getModulesRequiredForConsole() noexcept;
  45. StringArray getModulesRequiredForComponent() noexcept;
  46. StringArray getModulesRequiredForAudioProcessor() noexcept;
  47. bool isPIPFile (const File&) noexcept;
  48. bool isValidJUCEExamplesDirectory (const File&) noexcept;
  49. //==============================================================================
  50. int indexOfLineStartingWith (const StringArray& lines, const String& text, int startIndex);
  51. void autoScrollForMouseEvent (const MouseEvent& e, bool scrollX = true, bool scrollY = true);
  52. //==============================================================================
  53. struct PropertyListBuilder
  54. {
  55. void add (PropertyComponent* propertyComp)
  56. {
  57. components.add (propertyComp);
  58. }
  59. void add (PropertyComponent* propertyComp, const String& tooltip)
  60. {
  61. propertyComp->setTooltip (tooltip);
  62. add (propertyComp);
  63. }
  64. void addSearchPathProperty (const Value& value, const String& name, const String& mainHelpText)
  65. {
  66. add (new TextPropertyComponent (value, name, 16384, true),
  67. mainHelpText + " Use semi-colons or new-lines to separate multiple paths.");
  68. }
  69. void addSearchPathProperty (ValueWithDefault& value, const String& name, const String& mainHelpText)
  70. {
  71. add (new TextPropertyComponent (value, name, 16384, true),
  72. mainHelpText + " Use semi-colons or new-lines to separate multiple paths.");
  73. }
  74. void setPreferredHeight (int height)
  75. {
  76. for (int j = components.size(); --j >= 0;)
  77. components.getUnchecked(j)->setPreferredHeight (height);
  78. }
  79. Array<PropertyComponent*> components;
  80. };
  81. //==============================================================================
  82. // A ValueSource which takes an input source, and forwards any changes in it.
  83. // This class is a handy way to create sources which re-map a value.
  84. class ValueSourceFilter : public Value::ValueSource,
  85. public Value::Listener
  86. {
  87. public:
  88. ValueSourceFilter (const Value& source) : sourceValue (source)
  89. {
  90. sourceValue.addListener (this);
  91. }
  92. void valueChanged (Value&) override { sendChangeMessage (true); }
  93. protected:
  94. Value sourceValue;
  95. JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (ValueSourceFilter)
  96. };