DISTRHO
/
JUCE
mirror of https://github.com/DISTRHO/JUCE
1
0
Fork 0
Code Releases 1 Activity
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.
1097 Commits
11 Branches
3.6GB
Tree: 7cf5140eb2
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '7cf5140eb2'
${ noResults }
JUCE/extras/Jucer (experimental)/Source/model/Project/jucer_Project.h

307 lines
16KB
Raw Blame History 

  1. /*

  2.   ==============================================================================

  3. 

  4.    This file is part of the JUCE library - "Jules' Utility Class Extensions"

  5.    Copyright 2004-10 by Raw Material Software Ltd.

  6. 

  7.   ------------------------------------------------------------------------------

  8. 

  9.    JUCE can be redistributed and/or modified under the terms of the GNU General

  10.    Public License (Version 2), as published by the Free Software Foundation.

  11.    A copy of the license is included in the JUCE distribution, or can be found

  12.    online at www.gnu.org/licenses.

  13. 

  14.    JUCE is distributed in the hope that it will be useful, but WITHOUT ANY

  15.    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR

  16.    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

  17. 

  18.   ------------------------------------------------------------------------------

  19. 

  20.    To release a closed-source product which uses JUCE, commercial licenses are

  21.    available: visit www.rawmaterialsoftware.com/juce for more information.

  22. 

  23.   ==============================================================================

  24. */

  25. 

  26. #ifndef __JUCER_PROJECT_JUCEHEADER__

  27. #define __JUCER_PROJECT_JUCEHEADER__

  28. 

  29. #include "../../jucer_Headers.h"

  30. class ProjectExporter;

  31. 

  32. //==============================================================================

  33. class Project  : public FileBasedDocument,

  34.                  public ValueTree::Listener

  35. {

  36. public:

  37.     //==============================================================================

  38.     Project (const File& file);

  39.     ~Project();

  40. 

  41.     //==============================================================================

  42.     // FileBasedDocument stuff..

  43.     const String getDocumentTitle();

  44.     const String loadDocument (const File& file);

  45.     const String saveDocument (const File& file);

  46.     const File getLastDocumentOpened();

  47.     void setLastDocumentOpened (const File& file);

  48. 

  49.     void setTitle (const String& newTitle);

  50. 

  51.     //==============================================================================

  52.     ValueTree getProjectRoot() const                    { return projectRoot; }

  53.     Value getProjectName()                              { return getMainGroup().getName(); }

  54.     const String getProjectFilenameRoot()               { return File::createLegalFileName (getDocumentTitle()); }

  55.     const String getProjectUID() const                  { return projectRoot ["id"]; }

  56. 

  57.     //==============================================================================

  58.     bool shouldBeAddedToBinaryResourcesByDefault (const File& file);

  59.     const File resolveFilename (const String& filename) const;

  60.     const String getRelativePathForFile (const File& file) const;

  61. 

  62.     //==============================================================================

  63.     // Creates editors for the project settings

  64.     void createPropertyEditors (Array <PropertyComponent*>& properties);

  65. 

  66.     //==============================================================================

  67.     // project type info

  68.     enum ProjectType

  69.     {

  70.         application     = 1, // must all be sequntial, starting from 1, so that combo boxes can update correctly

  71.         commandLineApp  = 2,

  72.         audioPlugin     = 3,

  73.         library         = 4,

  74.         browserPlugin   = 5

  75.     };

  76. 

  77.     const StringArray getProjectTypes() const;

  78.     Value getProjectType() const;

  79. 

  80.     bool isLibrary() const                              { return (int) getProjectType().getValue() == (int) library; }

  81.     bool isGUIApplication() const                       { return (int) getProjectType().getValue() == (int) application; }

  82.     bool isCommandLineApp() const                       { return (int) getProjectType().getValue() == (int) commandLineApp; }

  83.     bool isAudioPlugin() const                          { return (int) getProjectType().getValue() == (int) audioPlugin; }

  84.     bool isBrowserPlugin() const                        { return (int) getProjectType().getValue() == (int) browserPlugin; }

  85. 

  86.     Value getVersion() const                            { return getProjectValue ("version"); }

  87.     Value getBundleIdentifier() const                   { return getProjectValue ("bundleIdentifier"); }

  88.     void setBundleIdentifierToDefault()                 { getBundleIdentifier() = "com.yourcompany." + makeValidCppIdentifier (getProjectName().toString(), false, true, false); }

  89. 

  90.     //==============================================================================

  91.     enum JuceLinkage

  92.     {

  93.         notLinkedToJuce = 1,   // must all be sequntial, starting from 1, so that combo boxes can update correctly

  94.         useLinkedJuce = 2,

  95.         useAmalgamatedJuce = 3,

  96.         useAmalgamatedJuceViaSingleTemplate = 4,

  97.         useAmalgamatedJuceViaMultipleTemplates = 5,

  98.     };

  99. 

  100.     const StringArray getJuceLinkageModes() const;

  101.     Value getJuceLinkageModeValue() const;

  102.     JuceLinkage getJuceLinkageMode() const              { return (JuceLinkage) (int) getJuceLinkageModeValue().getValue(); }

  103. 

  104.     bool isUsingWrapperFiles() const                    { return isUsingFullyAmalgamatedFile() || isUsingSingleTemplateFile() || isUsingMultipleTemplateFiles(); }

  105.     bool isUsingFullyAmalgamatedFile() const            { return getJuceLinkageMode() == useAmalgamatedJuce; }

  106.     bool isUsingSingleTemplateFile() const              { return getJuceLinkageMode() == useAmalgamatedJuceViaSingleTemplate; }

  107.     bool isUsingMultipleTemplateFiles() const           { return getJuceLinkageMode() == useAmalgamatedJuceViaMultipleTemplates; }

  108. 

  109.     //==============================================================================

  110.     Value getProjectValue (const var::identifier& name) const       { return projectRoot.getPropertyAsValue (name, getUndoManagerFor (projectRoot)); }

  111. 

  112.     Value shouldBuildVST() const                        { return getProjectValue ("buildVST"); }

  113.     Value shouldBuildRTAS() const                       { return getProjectValue ("buildRTAS"); }

  114.     Value shouldBuildAU() const                         { return getProjectValue ("buildAU"); }

  115.     bool shouldAddVSTFolderToPath()                     { return (isAudioPlugin() && (bool) shouldBuildVST().getValue()) || (int) getJuceConfigFlag ("JUCE_PLUGINHOST_VST").getValue() == 1; }

  116. 

  117.     Value getPluginName() const                         { return getProjectValue ("pluginName"); }

  118.     Value getPluginDesc() const                         { return getProjectValue ("pluginDesc"); }

  119.     Value getPluginManufacturer() const                 { return getProjectValue ("pluginManufacturer"); }

  120.     Value getPluginManufacturerCode() const             { return getProjectValue ("pluginManufacturerCode"); }

  121.     Value getPluginCode() const                         { return getProjectValue ("pluginCode"); }

  122.     Value getPluginChannelConfigs() const               { return getProjectValue ("pluginChannelConfigs"); }

  123.     Value getPluginIsSynth() const                      { return getProjectValue ("pluginIsSynth"); }

  124.     Value getPluginWantsMidiInput() const               { return getProjectValue ("pluginWantsMidiIn"); }

  125.     Value getPluginProducesMidiOut() const              { return getProjectValue ("pluginProducesMidiOut"); }

  126.     Value getPluginSilenceInProducesSilenceOut() const  { return getProjectValue ("pluginSilenceInIsSilenceOut"); }

  127.     Value getPluginTailLengthSeconds() const            { return getProjectValue ("pluginTailLength"); }

  128.     Value getPluginEditorNeedsKeyFocus() const          { return getProjectValue ("pluginEditorRequiresKeys"); }

  129.     Value getPluginAUExportPrefix() const               { return getProjectValue ("pluginAUExportPrefix"); }

  130.     Value getPluginAUCocoaViewClassName() const         { return getProjectValue ("pluginAUViewClass"); }

  131.     Value getPluginRTASCategory() const                 { return getProjectValue ("pluginRTASCategory"); }

  132. 

  133.     //==============================================================================

  134.     const File getAppIncludeFile() const                { return getWrapperFolder().getChildFile (getJuceSourceHFilename()); }

  135.     const File getWrapperFolder() const                 { return getFile().getSiblingFile ("JuceLibraryCode"); }

  136.     const File getPluginCharacteristicsFile() const     { return getWrapperFolder().getChildFile (getPluginCharacteristicsFilename()); }

  137. 

  138.     //==============================================================================

  139.     const String getAmalgamatedHeaderFileName() const       { return "juce_amalgamated.h"; }

  140.     const String getAmalgamatedMMFileName() const           { return "juce_amalgamated.mm"; }

  141.     const String getAmalgamatedCppFileName() const          { return "juce_amalgamated.cpp"; }

  142. 

  143.     const String getAppConfigFilename() const               { return "AppConfig.h"; }

  144.     const String getJuceSourceFilenameRoot() const          { return "JuceLibraryCode"; }

  145.     int getNumSeparateAmalgamatedFiles() const              { return 4; }

  146.     const String getJuceSourceHFilename() const             { return "JuceHeader.h"; }

  147.     const String getJuceCodeGroupName() const               { return "Juce Library Code"; }

  148.     const String getPluginCharacteristicsFilename() const   { return "JucePluginCharacteristics.h"; }

  149. 

  150.     //==============================================================================

  151.     class Item

  152.     {

  153.     public:

  154.         //==============================================================================

  155.         Item (Project& project, const ValueTree& itemNode);

  156.         Item (const Item& other);

  157.         ~Item();

  158. 

  159.         //==============================================================================

  160.         const ValueTree& getNode() const throw()        { return node; }

  161.         ValueTree& getNode() throw()                    { return node; }

  162.         Project& getProject() const throw()             { return project; }

  163.         bool operator== (const Item& other) const       { return node == other.node && &project == &other.project; }

  164.         bool operator!= (const Item& other) const       { return ! operator== (other); }

  165. 

  166.         //==============================================================================

  167.         bool isFile() const;

  168.         bool isGroup() const;

  169.         bool isMainGroup() const;

  170. 

  171.         const String getID() const;

  172.         void createUIDIfMissing();

  173. 

  174.         //==============================================================================

  175.         Value getName() const;

  176.         const File getFile() const;

  177.         void setFile (const File& file);

  178.         const File determineGroupFolder() const;

  179. 

  180.         bool shouldBeAddedToTargetProject() const;

  181.         bool shouldBeCompiled() const;

  182.         Value getShouldCompileValue() const;

  183.         bool shouldBeAddedToBinaryResources() const;

  184.         Value getShouldAddToResourceValue() const;

  185. 

  186.         //==============================================================================

  187.         bool canContain (const Item& child) const;

  188.         int getNumChildren() const                      { return node.getNumChildren(); }

  189.         const Item getChild (int index) const           { return Item (project, node.getChild (index)); }

  190.         void addChild (const Item& newChild, int insertIndex);

  191.         bool addFile (const File& file, int insertIndex);

  192.         void removeItemFromProject();

  193.         void sortAlphabetically();

  194. 

  195.         Item getParent() const;

  196. 

  197.         Image* getIcon() const;

  198. 

  199.     private:

  200.         //==============================================================================

  201.         Project& project;

  202.         ValueTree node;

  203. 

  204.         UndoManager* getUndoManager() const              { return project.getUndoManagerFor (node); }

  205.         Item& operator= (const Item&);

  206.     };

  207. 

  208.     Item getMainGroup();

  209.     Item createNewGroup();

  210.     Item createNewItem (const File& file);

  211. 

  212.     //==============================================================================

  213.     class BuildConfiguration

  214.     {

  215.     public:

  216.         BuildConfiguration (const BuildConfiguration&);

  217.         const BuildConfiguration& operator= (const BuildConfiguration&);

  218.         ~BuildConfiguration();

  219. 

  220.         //==============================================================================

  221.         Project& getProject() const                         { return *project; }

  222. 

  223.         void createPropertyEditors (Array <PropertyComponent*>& properties);

  224. 

  225.         //==============================================================================

  226.         Value getName() const                               { return config.getPropertyAsValue ("name", getUndoManager()); }

  227.         Value isDebug() const                               { return config.getPropertyAsValue ("isDebug", getUndoManager()); }

  228.         Value getTargetBinaryName() const                   { return config.getPropertyAsValue ("targetName", getUndoManager()); }

  229.         // the path relative to the build folder in which the binary should go

  230.         Value getTargetBinaryRelativePath() const           { return config.getPropertyAsValue ("binaryPath", getUndoManager()); }

  231.         Value getOptimisationLevel() const                  { return config.getPropertyAsValue ("optimisation", getUndoManager()); }

  232.         const String getGCCOptimisationFlag() const;

  233.         Value getPreprocessorDefs() const                   { return config.getPropertyAsValue ("defines", getUndoManager()); }

  234.         const StringArray parsePreprocessorDefs() const;

  235.         Value getHeaderSearchPath() const                   { return config.getPropertyAsValue ("headerPath", getUndoManager()); }

  236.         const StringArray getHeaderSearchPaths() const;

  237.         Value getMacSDKVersion() const;

  238.         Value getMacCompatibilityVersion() const;

  239. 

  240.         //==============================================================================

  241.     private:

  242.         friend class Project;

  243.         Project* project;

  244.         ValueTree config;

  245. 

  246.         UndoManager* getUndoManager() const                 { return project->getUndoManagerFor (config); }

  247. 

  248.         BuildConfiguration (Project* project, const ValueTree& configNode);

  249.     };

  250. 

  251.     int getNumConfigurations() const;

  252.     BuildConfiguration getConfiguration (int index);

  253.     void addNewConfiguration (BuildConfiguration* configToCopy);

  254.     void deleteConfiguration (int index);

  255.     bool hasConfigurationNamed (const String& name) const;

  256.     const String getUniqueConfigName (String name) const;

  257. 

  258.     //==============================================================================

  259.     ValueTree getExporters();

  260.     int getNumExporters();

  261.     ProjectExporter* createExporter (int index);

  262.     void addNewExporter (int exporterIndex);

  263.     void deleteExporter (int index);

  264.     void createDefaultExporters();

  265. 

  266.     //==============================================================================

  267.     struct JuceConfigFlag

  268.     {

  269.         String symbol, description;

  270.         Value value;   // 1 = true, 2 = false, anything else = use default

  271.     };

  272. 

  273.     void getJuceConfigFlags (OwnedArray <JuceConfigFlag>& flags);

  274.     Value getJuceConfigFlag (const String& name);

  275. 

  276.     //==============================================================================

  277.     const String getFileTemplate (const String& templateName);

  278. 

  279.     //==============================================================================

  280.     void valueTreePropertyChanged (ValueTree& tree, const var::identifier& property);

  281.     void valueTreeChildrenChanged (ValueTree& tree);

  282.     void valueTreeParentChanged (ValueTree& tree);

  283. 

  284.     //==============================================================================

  285.     UndoManager* getUndoManagerFor (const ValueTree& node) const             { return 0; }

  286. 

  287.     //==============================================================================

  288.     static const char* projectFileExtension;

  289. 

  290. private:

  291.     ValueTree projectRoot;

  292.     static File lastDocumentOpened;

  293. 

  294.     const File getLocalJuceFolder();

  295.     void updateProjectSettings();

  296.     void setMissingDefaultValues();

  297.     ValueTree getConfigurations() const;

  298.     void createDefaultConfigs();

  299.     ValueTree getJuceConfigNode();

  300. 

  301.     Project (const Project&);

  302.     const Project& operator= (const Project&);

  303. };

  304. 

  305. 

  306. #endif   // __JUCER_PROJECT_JUCEHEADER__