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.
2995 Commits
9 Branches
625MB
Tree: 25c70643e3
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '25c70643e3'
${ noResults }
JUCE/extras/Introjucer/Source/Project Saving/jucer_ProjectExport_MSVC.h

1529 lines
66KB
Raw Blame History 

  1. /*

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

  3. 

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

  5.    Copyright 2004-11 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_PROJECTEXPORT_MSVC_JUCEHEADER__

  27. #define __JUCER_PROJECTEXPORT_MSVC_JUCEHEADER__

  28. 

  29. #include "jucer_ProjectExporter.h"

  30. #include "jucer_ProjectSaver.h"

  31. 

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

  33. class MSVCProjectExporterBase   : public ProjectExporter

  34. {

  35. public:

  36.     MSVCProjectExporterBase (Project& p, const ValueTree& t, const char* const folderName)

  37.         : ProjectExporter (p, t)

  38.     {

  39.         if (getTargetLocationString().isEmpty())

  40.             getTargetLocationValue() = getDefaultBuildsRootFolder() + folderName;

  41. 

  42.         projectGUID = createGUID (project.getProjectUID());

  43.         updateOldSettings();

  44.     }

  45. 

  46.     //==============================================================================

  47.     bool usesMMFiles() const                    { return false; }

  48.     bool isVisualStudio() const                 { return true; }

  49.     bool canCopeWithDuplicateFiles()            { return false; }

  50. 

  51.     bool launchProject()

  52.     {

  53.        #if JUCE_WINDOWS

  54.         return getSLNFile().startAsProcess();

  55.        #else

  56.         return false;

  57.        #endif

  58.     }

  59. 

  60.     void createExporterProperties (PropertyListBuilder&)

  61.     {

  62.     }

  63. 

  64. protected:

  65.     String projectGUID;

  66.     mutable File rcFile, iconFile;

  67. 

  68.     File getProjectFile (const String& extension) const   { return getTargetFolder().getChildFile (project.getProjectFilenameRoot()).withFileExtension (extension); }

  69.     File getSLNFile() const     { return getProjectFile (".sln"); }

  70. 

  71.     bool isLibraryDLL() const   { return msvcIsDLL || projectType.isDynamicLibrary(); }

  72. 

  73.     static String prependIfNotAbsolute (const String& file, const char* prefix)

  74.     {

  75.         if (File::isAbsolutePath (file) || file.startsWithChar ('$'))

  76.             prefix = "";

  77. 

  78.         return prefix + FileHelpers::windowsStylePath (file);

  79.     }

  80. 

  81.     static String getIntDirFile (const String& file)  { return prependIfNotAbsolute (file, "$(IntDir)\\"); }

  82.     static String getOutDirFile (const String& file)  { return prependIfNotAbsolute (file, "$(OutDir)\\"); }

  83. 

  84.     void updateOldSettings()

  85.     {

  86.         {

  87.             const String oldStylePrebuildCommand (getSettingString (Ids::prebuildCommand));

  88.             settings.removeProperty (Ids::prebuildCommand, nullptr);

  89. 

  90.             if (oldStylePrebuildCommand.isNotEmpty())

  91.                 for (ConfigIterator config (*this); config.next();)

  92.                     dynamic_cast <MSVCBuildConfiguration&> (*config).getPrebuildCommand() = oldStylePrebuildCommand;

  93.         }

  94. 

  95.         {

  96.             const String oldStyleLibName (getSettingString ("libraryName_Debug"));

  97.             settings.removeProperty ("libraryName_Debug", nullptr);

  98. 

  99.             if (oldStyleLibName.isNotEmpty())

  100.                 for (ConfigIterator config (*this); config.next();)

  101.                     if (config->isDebug())

  102.                         config->getTargetBinaryName() = oldStyleLibName;

  103.         }

  104. 

  105.         {

  106.             const String oldStyleLibName (getSettingString ("libraryName_Release"));

  107.             settings.removeProperty ("libraryName_Release", nullptr);

  108. 

  109.             if (oldStyleLibName.isNotEmpty())

  110.                 for (ConfigIterator config (*this); config.next();)

  111.                     if (! config->isDebug())

  112.                         config->getTargetBinaryName() = oldStyleLibName;

  113.         }

  114.     }

  115. 

  116.     //==============================================================================

  117.     class MSVCBuildConfiguration  : public BuildConfiguration

  118.     {

  119.     public:

  120.         MSVCBuildConfiguration (Project& p, const ValueTree& settings)

  121.             : BuildConfiguration (p, settings)

  122.         {

  123.             if (getWarningLevel() == 0)

  124.                 getWarningLevelValue() = 4;

  125. 

  126.             setValueIfVoid (shouldGenerateManifestValue(), true);

  127.         }

  128. 

  129.         Value getWarningLevelValue()                { return getValue (Ids::winWarningLevel); }

  130.         int getWarningLevel() const                 { return config [Ids::winWarningLevel]; }

  131. 

  132.         Value getPrebuildCommand()                  { return getValue (Ids::prebuildCommand); }

  133.         String getPrebuildCommandString() const     { return config [Ids::prebuildCommand]; }

  134.         Value getPostbuildCommand()                 { return getValue (Ids::postbuildCommand); }

  135.         String getPostbuildCommandString() const    { return config [Ids::postbuildCommand]; }

  136. 

  137.         Value shouldGenerateDebugSymbolsValue()     { return getValue (Ids::alwaysGenerateDebugSymbols); }

  138.         bool shouldGenerateDebugSymbols() const     { return config [Ids::alwaysGenerateDebugSymbols]; }

  139. 

  140.         Value shouldGenerateManifestValue()         { return getValue (Ids::generateManifest); }

  141.         bool shouldGenerateManifest() const         { return config [Ids::generateManifest]; }

  142. 

  143.         Value getWholeProgramOptValue()             { return getValue (Ids::wholeProgramOptimisation); }

  144.         bool shouldDisableWholeProgramOpt() const   { return static_cast<int> (config [Ids::wholeProgramOptimisation]) > 0; }

  145. 

  146.         Value getUsingRuntimeLibDLL()               { return getValue (Ids::useRuntimeLibDLL); }

  147.         bool isUsingRuntimeLibDLL() const           { return config [Ids::useRuntimeLibDLL]; }

  148. 

  149.         String getIntermediatesPath() const         { return config [Ids::intermediatesPath].toString(); }

  150.         Value getIntermediatesPathValue()           { return getValue (Ids::intermediatesPath); }

  151. 

  152.         String getOutputFilename (const String& suffix, bool forceSuffix) const

  153.         {

  154.             const String target (File::createLegalFileName (getTargetBinaryNameString().trim()));

  155. 

  156.             if (forceSuffix || ! target.containsChar ('.'))

  157.                 return target.upToLastOccurrenceOf (".", false, false) + suffix;

  158. 

  159.             return target;

  160.         }

  161. 

  162.         void createConfigProperties (PropertyListBuilder& props)

  163.         {

  164.             props.add (new TextPropertyComponent (getIntermediatesPathValue(), "Intermediates path", 2048, false),

  165.                        "An optional path to a folder to use for the intermediate build files. Note that Visual Studio allows "

  166.                        "you to use macros in this path, e.g. \"$(TEMP)\\MyAppBuildFiles\\$(Configuration)\", which is a handy way to "

  167.                        "send them to the user's temp folder.");

  168. 

  169.             const char* const warningLevelNames[] = { "Low", "Medium", "High", nullptr };

  170.             const int warningLevels[] = { 2, 3, 4 };

  171. 

  172.             props.add (new ChoicePropertyComponent (getWarningLevelValue(), "Warning Level",

  173.                                                     StringArray (warningLevelNames), Array<var> (warningLevels, numElementsInArray (warningLevels))));

  174. 

  175.             {

  176.                 const char* const runtimeNames[] = { "(Default)", "Use static runtime", "Use DLL runtime", nullptr };

  177.                 const var runtimeValues[] = { var(), var (false), var (true) };

  178. 

  179.                 props.add (new ChoicePropertyComponent (getUsingRuntimeLibDLL(), "Runtime Library",

  180.                                                         StringArray (runtimeNames), Array<var> (runtimeValues, numElementsInArray (runtimeValues))));

  181.             }

  182. 

  183.             {

  184.                 const char* const wpoNames[] = { "Enable link-time code generation when possible",

  185.                                                  "Always disable link-time code generation", nullptr };

  186.                 const var wpoValues[] = { var(), var (1) };

  187. 

  188.                 props.add (new ChoicePropertyComponent (getWholeProgramOptValue(), "Whole Program Optimisation",

  189.                                                         StringArray (wpoNames), Array<var> (wpoValues, numElementsInArray (wpoValues))));

  190.             }

  191. 

  192.             if (! isDebug())

  193.                 props.add (new BooleanPropertyComponent (shouldGenerateDebugSymbolsValue(), "Debug Symbols", "Force generation of debug symbols"));

  194. 

  195.             props.add (new TextPropertyComponent (getPrebuildCommand(),  "Pre-build Command",  2048, false));

  196.             props.add (new TextPropertyComponent (getPostbuildCommand(), "Post-build Command", 2048, false));

  197.             props.add (new BooleanPropertyComponent (shouldGenerateManifestValue(), "Manifest", "Generate Manifest"));

  198.         }

  199.     };

  200. 

  201.     BuildConfiguration::Ptr createBuildConfig (const ValueTree& v) const

  202.     {

  203.         return new MSVCBuildConfiguration (project, v);

  204.     }

  205. 

  206.     static int getWarningLevel (const BuildConfiguration& config)

  207.     {

  208.         return dynamic_cast <const MSVCBuildConfiguration&> (config).getWarningLevel();

  209.     }

  210. 

  211.     //==============================================================================

  212.     String getConfigTargetPath (const BuildConfiguration& config) const

  213.     {

  214.         const String binaryPath (config.getTargetBinaryRelativePathString().trim());

  215.         if (binaryPath.isEmpty())

  216.             return prependDot (File::createLegalFileName (config.getName().trim()));

  217. 

  218.         RelativePath binaryRelPath (binaryPath, RelativePath::projectFolder);

  219. 

  220.         if (binaryRelPath.isAbsolute())

  221.             return binaryRelPath.toWindowsStyle();

  222. 

  223.         return prependDot (binaryRelPath.rebased (projectFolder, getTargetFolder(), RelativePath::buildTargetFolder)

  224.                                         .toWindowsStyle());

  225.     }

  226. 

  227.     String getPreprocessorDefs (const BuildConfiguration& config, const String& joinString) const

  228.     {

  229.         StringPairArray defines (msvcExtraPreprocessorDefs);

  230.         defines.set ("WIN32", "");

  231.         defines.set ("_WINDOWS", "");

  232. 

  233.         if (config.isDebug())

  234.         {

  235.             defines.set ("DEBUG", "");

  236.             defines.set ("_DEBUG", "");

  237.         }

  238.         else

  239.         {

  240.             defines.set ("NDEBUG", "");

  241.         }

  242. 

  243.         defines = mergePreprocessorDefs (defines, getAllPreprocessorDefs (config));

  244. 

  245.         StringArray result;

  246. 

  247.         for (int i = 0; i < defines.size(); ++i)

  248.         {

  249.             String def (defines.getAllKeys()[i]);

  250.             const String value (defines.getAllValues()[i]);

  251.             if (value.isNotEmpty())

  252.                 def << "=" << value;

  253. 

  254.             result.add (def);

  255.         }

  256. 

  257.         return result.joinIntoString (joinString);

  258.     }

  259. 

  260.     StringArray getHeaderSearchPaths (const BuildConfiguration& config) const

  261.     {

  262.         StringArray searchPaths (extraSearchPaths);

  263.         searchPaths.addArray (config.getHeaderSearchPaths());

  264.         searchPaths.removeDuplicates (false);

  265.         return searchPaths;

  266.     }

  267. 

  268.     virtual String createConfigName (const BuildConfiguration& config) const

  269.     {

  270.         return config.getName() + "|Win32";

  271.     }

  272. 

  273.     //==============================================================================

  274.     void writeSolutionFile (OutputStream& out, const String& versionString, String commentString, const File& vcProject) const

  275.     {

  276.         if (commentString.isNotEmpty())

  277.             commentString += newLine;

  278. 

  279.         out << "Microsoft Visual Studio Solution File, Format Version " << versionString << newLine

  280.             << commentString

  281.             << "Project(\"" << createGUID (projectName + "sln_guid") << "\") = \"" << projectName << "\", \""

  282.             << vcProject.getFileName() << "\", \"" << projectGUID << '"' << newLine

  283.             << "EndProject" << newLine

  284.             << "Global" << newLine

  285.             << "\tGlobalSection(SolutionConfigurationPlatforms) = preSolution" << newLine;

  286. 

  287.         for (ConstConfigIterator i (*this); i.next();)

  288.         {

  289.             const String configName (createConfigName (*i));

  290.             out << "\t\t" << configName << " = " << configName << newLine;

  291.         }

  292. 

  293.         out << "\tEndGlobalSection" << newLine

  294.             << "\tGlobalSection(ProjectConfigurationPlatforms) = postSolution" << newLine;

  295. 

  296.         for (ConstConfigIterator i (*this); i.next();)

  297.         {

  298.             const String configName (createConfigName (*i));

  299.             out << "\t\t" << projectGUID << "." << configName << ".ActiveCfg = " << configName << newLine;

  300.             out << "\t\t" << projectGUID << "." << configName << ".Build.0 = " << configName << newLine;

  301.         }

  302. 

  303.         out << "\tEndGlobalSection" << newLine

  304.             << "\tGlobalSection(SolutionProperties) = preSolution" << newLine

  305.             << "\t\tHideSolutionNode = FALSE" << newLine

  306.             << "\tEndGlobalSection" << newLine

  307.             << "EndGlobal" << newLine;

  308.     }

  309. 

  310.     //==============================================================================

  311.     static void writeBMPImage (const Image& image, const int w, const int h, MemoryOutputStream& out)

  312.     {

  313.         const int maskStride = (w / 8 + 3) & ~3;

  314. 

  315.         out.writeInt (40); // bitmapinfoheader size

  316.         out.writeInt (w);

  317.         out.writeInt (h * 2);

  318.         out.writeShort (1); // planes

  319.         out.writeShort (32); // bits

  320.         out.writeInt (0); // compression

  321.         out.writeInt ((h * w * 4) + (h * maskStride)); // size image

  322.         out.writeInt (0); // x pixels per meter

  323.         out.writeInt (0); // y pixels per meter

  324.         out.writeInt (0); // clr used

  325.         out.writeInt (0); // clr important

  326. 

  327.         const Image::BitmapData bitmap (image, Image::BitmapData::readOnly);

  328.         const int alphaThreshold = 5;

  329. 

  330.         int y;

  331.         for (y = h; --y >= 0;)

  332.         {

  333.             for (int x = 0; x < w; ++x)

  334.             {

  335.                 const Colour pixel (bitmap.getPixelColour (x, y));

  336. 

  337.                 if (pixel.getAlpha() <= alphaThreshold)

  338.                 {

  339.                     out.writeInt (0);

  340.                 }

  341.                 else

  342.                 {

  343.                     out.writeByte ((char) pixel.getBlue());

  344.                     out.writeByte ((char) pixel.getGreen());

  345.                     out.writeByte ((char) pixel.getRed());

  346.                     out.writeByte ((char) pixel.getAlpha());

  347.                 }

  348.             }

  349.         }

  350. 

  351.         for (y = h; --y >= 0;)

  352.         {

  353.             int mask = 0, count = 0;

  354. 

  355.             for (int x = 0; x < w; ++x)

  356.             {

  357.                 const Colour pixel (bitmap.getPixelColour (x, y));

  358. 

  359.                 mask <<= 1;

  360.                 if (pixel.getAlpha() <= alphaThreshold)

  361.                     mask |= 1;

  362. 

  363.                 if (++count == 8)

  364.                 {

  365.                     out.writeByte ((char) mask);

  366.                     count = 0;

  367.                     mask = 0;

  368.                 }

  369.             }

  370. 

  371.             if (mask != 0)

  372.                 out.writeByte ((char) mask);

  373. 

  374.             for (int i = maskStride - w / 8; --i >= 0;)

  375.                 out.writeByte (0);

  376.         }

  377.     }

  378. 

  379.     static void writeIconFile (const Array<Image>& images, MemoryOutputStream& out)

  380.     {

  381.         out.writeShort (0); // reserved

  382.         out.writeShort (1); // .ico tag

  383.         out.writeShort ((short) images.size());

  384. 

  385.         MemoryOutputStream dataBlock;

  386. 

  387.         const int imageDirEntrySize = 16;

  388.         const int dataBlockStart = 6 + images.size() * imageDirEntrySize;

  389. 

  390.         for (int i = 0; i < images.size(); ++i)

  391.         {

  392.             const size_t oldDataSize = dataBlock.getDataSize();

  393. 

  394.             const Image& image = images.getReference (i);

  395.             const int w = image.getWidth();

  396.             const int h = image.getHeight();

  397. 

  398.             if (w >= 256 || h >= 256)

  399.             {

  400.                 PNGImageFormat pngFormat;

  401.                 pngFormat.writeImageToStream (image, dataBlock);

  402.             }

  403.             else

  404.             {

  405.                 writeBMPImage (image, w, h, dataBlock);

  406.             }

  407. 

  408.             out.writeByte ((char) w);

  409.             out.writeByte ((char) h);

  410.             out.writeByte (0);

  411.             out.writeByte (0);

  412.             out.writeShort (1); // colour planes

  413.             out.writeShort (32); // bits per pixel

  414.             out.writeInt ((int) (dataBlock.getDataSize() - oldDataSize));

  415.             out.writeInt (dataBlockStart + oldDataSize);

  416.         }

  417. 

  418.         jassert (out.getPosition() == dataBlockStart);

  419.         out << dataBlock;

  420.     }

  421. 

  422.     bool hasResourceFile() const

  423.     {

  424.         return ! projectType.isStaticLibrary();

  425.     }

  426. 

  427.     void createResourcesAndIcon() const

  428.     {

  429.         if (hasResourceFile())

  430.         {

  431.             Array<Image> images;

  432.             const int sizes[] = { 16, 32, 48, 256 };

  433. 

  434.             for (int i = 0; i < numElementsInArray (sizes); ++i)

  435.             {

  436.                 Image im (getBestIconForSize (sizes[i], true));

  437.                 if (im.isValid())

  438.                     images.add (im);

  439.             }

  440. 

  441.             if (images.size() > 0)

  442.             {

  443.                 iconFile = getTargetFolder().getChildFile ("icon.ico");

  444. 

  445.                 MemoryOutputStream mo;

  446.                 writeIconFile (images, mo);

  447.                 overwriteFileIfDifferentOrThrow (iconFile, mo);

  448.             }

  449. 

  450.             createRCFile();

  451.         }

  452.     }

  453. 

  454.     void createRCFile() const

  455.     {

  456.         rcFile = getTargetFolder().getChildFile ("resources.rc");

  457. 

  458.         const String version (project.getVersionString());

  459. 

  460.         MemoryOutputStream mo;

  461. 

  462.         mo << "#ifdef JUCE_USER_DEFINED_RC_FILE" << newLine

  463.            << " #include JUCE_USER_DEFINED_RC_FILE" << newLine

  464.            << "#else" << newLine

  465.            << newLine

  466.            << "#undef  WIN32_LEAN_AND_MEAN" << newLine

  467.            << "#define WIN32_LEAN_AND_MEAN" << newLine

  468.            << "#include <windows.h>" << newLine

  469.            << newLine

  470.            << "VS_VERSION_INFO VERSIONINFO" << newLine

  471.            << "FILEVERSION  " << getCommaSeparatedVersionNumber (version) << newLine

  472.            << "BEGIN" << newLine

  473.            << "  BLOCK \"StringFileInfo\"" << newLine

  474.            << "  BEGIN" << newLine

  475.            << "    BLOCK \"040904E4\"" << newLine

  476.            << "    BEGIN" << newLine;

  477. 

  478.         writeRCValue (mo, "CompanyName", project.getCompanyName().toString());

  479.         writeRCValue (mo, "FileDescription", project.getTitle());

  480.         writeRCValue (mo, "FileVersion", version);

  481.         writeRCValue (mo, "ProductName", project.getTitle());

  482.         writeRCValue (mo, "ProductVersion", version);

  483. 

  484.         mo << "    END" << newLine

  485.            << "  END" << newLine

  486.            << newLine

  487.            << "  BLOCK \"VarFileInfo\"" << newLine

  488.            << "  BEGIN" << newLine

  489.            << "    VALUE \"Translation\", 0x409, 65001" << newLine

  490.            << "  END" << newLine

  491.            << "END" << newLine

  492.            << newLine

  493.            << "#endif" << newLine;

  494. 

  495.         if (iconFile != File::nonexistent)

  496.            mo << newLine

  497.               << "IDI_ICON1 ICON DISCARDABLE " << iconFile.getFileName().quoted()

  498.               << newLine

  499.               << "IDI_ICON2 ICON DISCARDABLE " << iconFile.getFileName().quoted();

  500. 

  501.         overwriteFileIfDifferentOrThrow (rcFile, mo);

  502.     }

  503. 

  504.     static void writeRCValue (MemoryOutputStream& mo, const String& name, const String& value)

  505.     {

  506.         if (value.isNotEmpty())

  507.             mo << "      VALUE \"" << name << "\",  \""

  508.                << CodeHelpers::addEscapeChars (value) << "\\0\"" << newLine;

  509.     }

  510. 

  511.     static String getCommaSeparatedVersionNumber (const String& version)

  512.     {

  513.         StringArray versionParts;

  514.         versionParts.addTokens (version, ",.", "");

  515.         versionParts.trim();

  516.         versionParts.removeEmptyStrings();

  517.         while (versionParts.size() < 4)

  518.             versionParts.add ("0");

  519. 

  520.         return versionParts.joinIntoString (",");

  521.     }

  522. 

  523.     static String prependDot (const String& filename)

  524.     {

  525.         return FileHelpers::isAbsolutePath (filename) ? filename

  526.                                                       : (".\\" + filename);

  527.     }

  528. 

  529.     JUCE_DECLARE_NON_COPYABLE (MSVCProjectExporterBase)

  530. };

  531. 

  532. 

  533. //==============================================================================

  534. class MSVCProjectExporterVC2008   : public MSVCProjectExporterBase

  535. {

  536. public:

  537.     //==============================================================================

  538.     MSVCProjectExporterVC2008 (Project& project_, const ValueTree& settings_,

  539.                                const char* folderName = "VisualStudio2008")

  540.         : MSVCProjectExporterBase (project_, settings_, folderName)

  541.     {

  542.         name = getName();

  543.     }

  544. 

  545.     static const char* getName()                    { return "Visual Studio 2008"; }

  546.     static const char* getValueTreeTypeName()       { return "VS2008"; }

  547.     int getVisualStudioVersion() const              { return 9; }

  548. 

  549.     static MSVCProjectExporterVC2008* createForSettings (Project& project, const ValueTree& settings)

  550.     {

  551.         if (settings.hasType (getValueTreeTypeName()))

  552.             return new MSVCProjectExporterVC2008 (project, settings);

  553. 

  554.         return nullptr;

  555.     }

  556. 

  557.     //==============================================================================

  558.     void create (const OwnedArray<LibraryModule>&) const

  559.     {

  560.         createResourcesAndIcon();

  561. 

  562.         if (hasResourceFile())

  563.         {

  564.             for (int i = 0; i < getAllGroups().size(); ++i)

  565.             {

  566.                 Project::Item& group = getAllGroups().getReference(i);

  567. 

  568.                 if (group.getID() == ProjectSaver::getGeneratedGroupID())

  569.                 {

  570.                     if (iconFile != File::nonexistent)

  571.                     {

  572.                         group.addFile (iconFile, -1, true);

  573.                         group.findItemForFile (iconFile).getShouldAddToResourceValue() = false;

  574.                     }

  575. 

  576.                     group.addFile (rcFile, -1, true);

  577.                     group.findItemForFile (rcFile).getShouldAddToResourceValue() = false;

  578. 

  579.                     break;

  580.                 }

  581.             }

  582.         }

  583. 

  584.         {

  585.             XmlElement projectXml ("VisualStudioProject");

  586.             fillInProjectXml (projectXml);

  587.             writeXmlOrThrow (projectXml, getVCProjFile(), "UTF-8", 10);

  588.         }

  589. 

  590.         {

  591.             MemoryOutputStream mo;

  592.             writeSolutionFile (mo, getSolutionVersionString(), String::empty, getVCProjFile());

  593. 

  594.             overwriteFileIfDifferentOrThrow (getSLNFile(), mo);

  595.         }

  596.     }

  597. 

  598. protected:

  599.     virtual String getProjectVersionString() const    { return "9.00"; }

  600.     virtual String getSolutionVersionString() const   { return "10.00" + newLine + "# Visual C++ Express 2008"; }

  601. 

  602.     File getVCProjFile() const    { return getProjectFile (".vcproj"); }

  603. 

  604.     //==============================================================================

  605.     void fillInProjectXml (XmlElement& projectXml) const

  606.     {

  607.         projectXml.setAttribute ("ProjectType", "Visual C++");

  608.         projectXml.setAttribute ("Version", getProjectVersionString());

  609.         projectXml.setAttribute ("Name", projectName);

  610.         projectXml.setAttribute ("ProjectGUID", projectGUID);

  611.         projectXml.setAttribute ("TargetFrameworkVersion", "131072");

  612. 

  613.         {

  614.             XmlElement* platforms = projectXml.createNewChildElement ("Platforms");

  615.             XmlElement* platform = platforms->createNewChildElement ("Platform");

  616.             platform->setAttribute ("Name", "Win32");

  617.         }

  618. 

  619.         projectXml.createNewChildElement ("ToolFiles");

  620.         createConfigs (*projectXml.createNewChildElement ("Configurations"));

  621.         projectXml.createNewChildElement ("References");

  622.         createFiles (*projectXml.createNewChildElement ("Files"));

  623.         projectXml.createNewChildElement ("Globals");

  624.     }

  625. 

  626.     //==============================================================================

  627.     void addFile (const RelativePath& file, XmlElement& parent, const bool excludeFromBuild, const bool useStdcall) const

  628.     {

  629.         jassert (file.getRoot() == RelativePath::buildTargetFolder);

  630. 

  631.         XmlElement* fileXml = parent.createNewChildElement ("File");

  632.         fileXml->setAttribute ("RelativePath", file.toWindowsStyle());

  633. 

  634.         if (excludeFromBuild || useStdcall)

  635.         {

  636.             for (ConstConfigIterator i (*this); i.next();)

  637.             {

  638.                 XmlElement* fileConfig = fileXml->createNewChildElement ("FileConfiguration");

  639.                 fileConfig->setAttribute ("Name", createConfigName (*i));

  640. 

  641.                 if (excludeFromBuild)

  642.                     fileConfig->setAttribute ("ExcludedFromBuild", "true");

  643. 

  644.                 XmlElement* tool = createToolElement (*fileConfig, "VCCLCompilerTool");

  645. 

  646.                 if (useStdcall)

  647.                     tool->setAttribute ("CallingConvention", "2");

  648.             }

  649.         }

  650.     }

  651. 

  652.     XmlElement* createGroup (const String& groupName, XmlElement& parent) const

  653.     {

  654.         XmlElement* filter = parent.createNewChildElement ("Filter");

  655.         filter->setAttribute ("Name", groupName);

  656.         return filter;

  657.     }

  658. 

  659.     void addFiles (const Project::Item& projectItem, XmlElement& parent) const

  660.     {

  661.         if (projectItem.isGroup())

  662.         {

  663.             XmlElement* filter = createGroup (projectItem.getName(), parent);

  664. 

  665.             for (int i = 0; i < projectItem.getNumChildren(); ++i)

  666.                 addFiles (projectItem.getChild(i), *filter);

  667.         }

  668.         else if (projectItem.shouldBeAddedToTargetProject())

  669.         {

  670.             const RelativePath path (projectItem.getFile(), getTargetFolder(), RelativePath::buildTargetFolder);

  671. 

  672.             addFile (path, parent,

  673.                      projectItem.shouldBeAddedToBinaryResources()

  674.                        || (shouldFileBeCompiledByDefault (path) && ! projectItem.shouldBeCompiled()),

  675.                      shouldFileBeCompiledByDefault (path) && (bool) projectItem.shouldUseStdCall());

  676.         }

  677.     }

  678. 

  679.     void createFiles (XmlElement& files) const

  680.     {

  681.         for (int i = 0; i < getAllGroups().size(); ++i)

  682.         {

  683.             const Project::Item& group = getAllGroups().getReference(i);

  684. 

  685.             if (group.getNumChildren() > 0)

  686.                 addFiles (group, files);

  687.         }

  688.     }

  689. 

  690.     //==============================================================================

  691.     XmlElement* createToolElement (XmlElement& parent, const String& toolName) const

  692.     {

  693.         XmlElement* const e = parent.createNewChildElement ("Tool");

  694.         e->setAttribute ("Name", toolName);

  695.         return e;

  696.     }

  697. 

  698.     void createConfig (XmlElement& xml, const MSVCBuildConfiguration& config) const

  699.     {

  700.         const bool isDebug = config.isDebug();

  701. 

  702.         xml.setAttribute ("Name", createConfigName (config));

  703.         xml.setAttribute ("OutputDirectory", FileHelpers::windowsStylePath (getConfigTargetPath (config)));

  704. 

  705.         if (config.getIntermediatesPath().isNotEmpty())

  706.             xml.setAttribute ("IntermediateDirectory", FileHelpers::windowsStylePath (config.getIntermediatesPath()));

  707. 

  708.         xml.setAttribute ("ConfigurationType", isLibraryDLL() ? "2" : (projectType.isStaticLibrary() ? "4" : "1"));

  709.         xml.setAttribute ("UseOfMFC", "0");

  710.         xml.setAttribute ("ATLMinimizesCRunTimeLibraryUsage", "false");

  711.         xml.setAttribute ("CharacterSet", "2");

  712. 

  713.         if (! (isDebug || config.shouldDisableWholeProgramOpt()))

  714.             xml.setAttribute ("WholeProgramOptimization", "1");

  715. 

  716.         XmlElement* preBuildEvent = createToolElement (xml, "VCPreBuildEventTool");

  717. 

  718.         if (config.getPrebuildCommandString().isNotEmpty())

  719.         {

  720.             preBuildEvent->setAttribute ("Description", "Pre-build");

  721.             preBuildEvent->setAttribute ("CommandLine", config.getPrebuildCommandString());

  722.         }

  723. 

  724.         createToolElement (xml, "VCCustomBuildTool");

  725.         createToolElement (xml, "VCXMLDataGeneratorTool");

  726.         createToolElement (xml, "VCWebServiceProxyGeneratorTool");

  727. 

  728.         if (! projectType.isStaticLibrary())

  729.         {

  730.             XmlElement* midl = createToolElement (xml, "VCMIDLTool");

  731.             midl->setAttribute ("PreprocessorDefinitions", isDebug ? "_DEBUG" : "NDEBUG");

  732.             midl->setAttribute ("MkTypLibCompatible", "true");

  733.             midl->setAttribute ("SuppressStartupBanner", "true");

  734.             midl->setAttribute ("TargetEnvironment", "1");

  735.             midl->setAttribute ("TypeLibraryName", getIntDirFile (config.getOutputFilename (".tlb", true)));

  736.             midl->setAttribute ("HeaderFileName", "");

  737.         }

  738. 

  739.         {

  740.             XmlElement* compiler = createToolElement (xml, "VCCLCompilerTool");

  741. 

  742.             compiler->setAttribute ("Optimization", getOptimisationLevelString (config.getOptimisationLevelInt()));

  743. 

  744.             if (isDebug)

  745.             {

  746.                 compiler->setAttribute ("BufferSecurityCheck", "");

  747.                 compiler->setAttribute ("DebugInformationFormat", projectType.isStaticLibrary() ? "3" : "4");

  748.             }

  749.             else

  750.             {

  751.                 compiler->setAttribute ("InlineFunctionExpansion", "1");

  752.                 compiler->setAttribute ("StringPooling", "true");

  753.             }

  754. 

  755.             compiler->setAttribute ("AdditionalIncludeDirectories", replacePreprocessorTokens (config, getHeaderSearchPaths (config).joinIntoString (";")));

  756.             compiler->setAttribute ("PreprocessorDefinitions", getPreprocessorDefs (config, ";"));

  757.             compiler->setAttribute ("RuntimeLibrary", config.isUsingRuntimeLibDLL() ? (isDebug ? 3 : 2) // MT DLL

  758.                                                                                     : (isDebug ? 1 : 0)); // MT static

  759.             compiler->setAttribute ("RuntimeTypeInfo", "true");

  760.             compiler->setAttribute ("UsePrecompiledHeader", "0");

  761.             compiler->setAttribute ("PrecompiledHeaderFile", getIntDirFile (config.getOutputFilename (".pch", true)));

  762.             compiler->setAttribute ("AssemblerListingLocation", "$(IntDir)\\");

  763.             compiler->setAttribute ("ObjectFile", "$(IntDir)\\");

  764.             compiler->setAttribute ("ProgramDataBaseFileName", "$(IntDir)\\");

  765.             compiler->setAttribute ("WarningLevel", String (getWarningLevel (config)));

  766.             compiler->setAttribute ("SuppressStartupBanner", "true");

  767. 

  768.             const String extraFlags (replacePreprocessorTokens (config, getExtraCompilerFlagsString()).trim());

  769.             if (extraFlags.isNotEmpty())

  770.                 compiler->setAttribute ("AdditionalOptions", extraFlags);

  771.         }

  772. 

  773.         createToolElement (xml, "VCManagedResourceCompilerTool");

  774. 

  775.         {

  776.             XmlElement* resCompiler = createToolElement (xml, "VCResourceCompilerTool");

  777.             resCompiler->setAttribute ("PreprocessorDefinitions", isDebug ? "_DEBUG" : "NDEBUG");

  778.         }

  779. 

  780.         createToolElement (xml, "VCPreLinkEventTool");

  781. 

  782.         if (! projectType.isStaticLibrary())

  783.         {

  784.             XmlElement* linker = createToolElement (xml, "VCLinkerTool");

  785. 

  786.             linker->setAttribute ("OutputFile", getOutDirFile (config.getOutputFilename (msvcTargetSuffix, false)));

  787.             linker->setAttribute ("SuppressStartupBanner", "true");

  788. 

  789.             linker->setAttribute ("IgnoreDefaultLibraryNames", isDebug ? "libcmt.lib, msvcrt.lib" : "");

  790.             linker->setAttribute ("GenerateDebugInformation", (isDebug || config.shouldGenerateDebugSymbols()) ? "true" : "false");

  791.             linker->setAttribute ("ProgramDatabaseFile", getIntDirFile (config.getOutputFilename (".pdb", true)));

  792.             linker->setAttribute ("SubSystem", msvcIsWindowsSubsystem ? "2" : "1");

  793. 

  794.             const StringArray librarySearchPaths (config.getLibrarySearchPaths());

  795.             if (librarySearchPaths.size() > 0)

  796.                 linker->setAttribute ("AdditionalLibraryDirectories", librarySearchPaths.joinIntoString (";"));

  797. 

  798.             linker->setAttribute ("GenerateManifest", config.shouldGenerateManifest() ? "true" : "false");

  799. 

  800.             if (! isDebug)

  801.             {

  802.                 linker->setAttribute ("OptimizeReferences", "2");

  803.                 linker->setAttribute ("EnableCOMDATFolding", "2");

  804.             }

  805. 

  806.             linker->setAttribute ("TargetMachine", "1"); // (64-bit build = 5)

  807. 

  808.             if (msvcDelayLoadedDLLs.isNotEmpty())

  809.                 linker->setAttribute ("DelayLoadDLLs", msvcDelayLoadedDLLs);

  810. 

  811.             if (config.config [Ids::msvcModuleDefinitionFile].toString().isNotEmpty())

  812.                 linker->setAttribute ("ModuleDefinitionFile", config.config [Ids::msvcModuleDefinitionFile].toString());

  813. 

  814.             String externalLibraries (getExternalLibrariesString());

  815.             if (externalLibraries.isNotEmpty())

  816.                 linker->setAttribute ("AdditionalDependencies", replacePreprocessorTokens (config, externalLibraries).trim());

  817. 

  818.             String extraLinkerOptions (getExtraLinkerFlagsString());

  819.             if (extraLinkerOptions.isNotEmpty())

  820.                 linker->setAttribute ("AdditionalOptions", replacePreprocessorTokens (config, extraLinkerOptions).trim());

  821.         }

  822.         else

  823.         {

  824.             if (isLibraryDLL())

  825.             {

  826.                 XmlElement* linker = createToolElement (xml, "VCLinkerTool");

  827. 

  828.                 String extraLinkerOptions (getExtraLinkerFlagsString());

  829.                 extraLinkerOptions << " /IMPLIB:" << getOutDirFile (config.getOutputFilename (".lib", true));

  830.                 linker->setAttribute ("AdditionalOptions", replacePreprocessorTokens (config, extraLinkerOptions).trim());

  831. 

  832.                 String externalLibraries (getExternalLibrariesString());

  833.                 if (externalLibraries.isNotEmpty())

  834.                     linker->setAttribute ("AdditionalDependencies", replacePreprocessorTokens (config, externalLibraries).trim());

  835. 

  836.                 linker->setAttribute ("OutputFile", getOutDirFile (config.getOutputFilename (msvcTargetSuffix, false)));

  837.                 linker->setAttribute ("IgnoreDefaultLibraryNames", isDebug ? "libcmt.lib, msvcrt.lib" : "");

  838.             }

  839.             else

  840.             {

  841.                 XmlElement* librarian = createToolElement (xml, "VCLibrarianTool");

  842. 

  843.                 librarian->setAttribute ("OutputFile", getOutDirFile (config.getOutputFilename (msvcTargetSuffix, false)));

  844.                 librarian->setAttribute ("IgnoreDefaultLibraryNames", isDebug ? "libcmt.lib, msvcrt.lib" : "");

  845.             }

  846.         }

  847. 

  848.         createToolElement (xml, "VCALinkTool");

  849.         createToolElement (xml, "VCManifestTool");

  850.         createToolElement (xml, "VCXDCMakeTool");

  851. 

  852.         {

  853.             XmlElement* bscMake = createToolElement (xml, "VCBscMakeTool");

  854.             bscMake->setAttribute ("SuppressStartupBanner", "true");

  855.             bscMake->setAttribute ("OutputFile", getIntDirFile (config.getOutputFilename (".bsc", true)));

  856.         }

  857. 

  858.         createToolElement (xml, "VCFxCopTool");

  859. 

  860.         if (! projectType.isStaticLibrary())

  861.             createToolElement (xml, "VCAppVerifierTool");

  862. 

  863.         XmlElement* postBuildEvent = createToolElement (xml, "VCPostBuildEventTool");

  864. 

  865.         if (config.getPostbuildCommandString().isNotEmpty())

  866.         {

  867.             postBuildEvent->setAttribute ("Description", "Post-build");

  868.             postBuildEvent->setAttribute ("CommandLine", config.getPostbuildCommandString());

  869.         }

  870.     }

  871. 

  872.     void createConfigs (XmlElement& xml) const

  873.     {

  874.         for (ConstConfigIterator config (*this); config.next();)

  875.             createConfig (*xml.createNewChildElement ("Configuration"),

  876.                           dynamic_cast <const MSVCBuildConfiguration&> (*config));

  877.     }

  878. 

  879.     static const char* getOptimisationLevelString (int level)

  880.     {

  881.         switch (level)

  882.         {

  883.             case optimiseMaxSpeed:  return "3";

  884.             case optimiseMinSize:   return "1";

  885.             default:                return "0";

  886.         }

  887.     }

  888. 

  889.     //==============================================================================

  890.     JUCE_DECLARE_NON_COPYABLE (MSVCProjectExporterVC2008)

  891. };

  892. 

  893. 

  894. //==============================================================================

  895. class MSVCProjectExporterVC2005   : public MSVCProjectExporterVC2008

  896. {

  897. public:

  898.     MSVCProjectExporterVC2005 (Project& p, const ValueTree& t)

  899.         : MSVCProjectExporterVC2008 (p, t, "VisualStudio2005")

  900.     {

  901.         name = getName();

  902.     }

  903. 

  904.     static const char* getName()                    { return "Visual Studio 2005"; }

  905.     static const char* getValueTreeTypeName()       { return "VS2005"; }

  906.     int getVisualStudioVersion() const              { return 8; }

  907. 

  908.     static MSVCProjectExporterVC2005* createForSettings (Project& project, const ValueTree& settings)

  909.     {

  910.         if (settings.hasType (getValueTreeTypeName()))

  911.             return new MSVCProjectExporterVC2005 (project, settings);

  912. 

  913.         return nullptr;

  914.     }

  915. 

  916. protected:

  917.     String getProjectVersionString() const    { return "8.00"; }

  918.     String getSolutionVersionString() const   { return "9.00" + newLine + "# Visual C++ Express 2005"; }

  919. 

  920.     JUCE_DECLARE_NON_COPYABLE (MSVCProjectExporterVC2005)

  921. };

  922. 

  923. //==============================================================================

  924. class MSVCProjectExporterVC2010   : public MSVCProjectExporterBase

  925. {

  926. public:

  927.     MSVCProjectExporterVC2010 (Project& p, const ValueTree& t, const char* folderName = "VisualStudio2010")

  928.         : MSVCProjectExporterBase (p, t, folderName)

  929.     {

  930.         name = getName();

  931.     }

  932. 

  933.     static const char* getName()                { return "Visual Studio 2010"; }

  934.     static const char* getValueTreeTypeName()   { return "VS2010"; }

  935.     int getVisualStudioVersion() const          { return 10; }

  936.     virtual String getPlatformToolset() const   { return "Windows7.1SDK"; }

  937.     virtual String getSolutionComment() const   { return "# Visual Studio 2010"; }

  938. 

  939.     static MSVCProjectExporterVC2010* createForSettings (Project& project, const ValueTree& settings)

  940.     {

  941.         if (settings.hasType (getValueTreeTypeName()))

  942.             return new MSVCProjectExporterVC2010 (project, settings);

  943. 

  944.         return nullptr;

  945.     }

  946. 

  947.     //==============================================================================

  948.     void create (const OwnedArray<LibraryModule>&) const

  949.     {

  950.         createResourcesAndIcon();

  951. 

  952.         {

  953.             XmlElement projectXml ("Project");

  954.             fillInProjectXml (projectXml);

  955.             addPlatformToolsetToPropertyGroup (projectXml);

  956. 

  957.             writeXmlOrThrow (projectXml, getVCProjFile(), "utf-8", 100);

  958.         }

  959. 

  960.         {

  961.             XmlElement filtersXml ("Project");

  962.             fillInFiltersXml (filtersXml);

  963.             writeXmlOrThrow (filtersXml, getVCProjFiltersFile(), "utf-8", 100);

  964.         }

  965. 

  966.         {

  967.             MemoryOutputStream mo;

  968.             writeSolutionFile (mo, "11.00", getSolutionComment(), getVCProjFile());

  969. 

  970.             overwriteFileIfDifferentOrThrow (getSLNFile(), mo);

  971.         }

  972.     }

  973. 

  974. protected:

  975.     //==============================================================================

  976.     class VC2010BuildConfiguration  : public MSVCBuildConfiguration

  977.     {

  978.     public:

  979.         VC2010BuildConfiguration (Project& p, const ValueTree& settings)

  980.             : MSVCBuildConfiguration (p, settings)

  981.         {

  982.             if (getArchitectureType().toString().isEmpty())

  983.                 getArchitectureType() = get32BitArchName();

  984.         }

  985. 

  986.         //==============================================================================

  987.         static const char* get32BitArchName()   { return "32-bit"; }

  988.         static const char* get64BitArchName()   { return "x64"; }

  989. 

  990.         Value getArchitectureType()             { return getValue (Ids::winArchitecture); }

  991.         bool is64Bit() const                    { return config [Ids::winArchitecture].toString() == get64BitArchName(); }

  992. 

  993.         //==============================================================================

  994.         void createConfigProperties (PropertyListBuilder& props)

  995.         {

  996.             MSVCBuildConfiguration::createConfigProperties (props);

  997. 

  998.             const char* const archTypes[] = { get32BitArchName(), get64BitArchName() };

  999. 

  1000.             props.add (new ChoicePropertyComponent (getArchitectureType(), "Architecture",

  1001.                                                     StringArray (archTypes, numElementsInArray (archTypes)),

  1002.                                                     Array<var> (archTypes, numElementsInArray (archTypes))));

  1003.         }

  1004.     };

  1005. 

  1006.     virtual void addPlatformToolsetToPropertyGroup (XmlElement&) const {}

  1007. 

  1008.     BuildConfiguration::Ptr createBuildConfig (const ValueTree& v) const

  1009.     {

  1010.         return new VC2010BuildConfiguration (project, v);

  1011.     }

  1012. 

  1013.     static bool is64Bit (const BuildConfiguration& config)

  1014.     {

  1015.         return dynamic_cast <const VC2010BuildConfiguration&> (config).is64Bit();

  1016.     }

  1017. 

  1018.     //==============================================================================

  1019.     File getVCProjFile() const            { return getProjectFile (".vcxproj"); }

  1020.     File getVCProjFiltersFile() const     { return getProjectFile (".vcxproj.filters"); }

  1021. 

  1022.     String createConfigName (const BuildConfiguration& config) const

  1023.     {

  1024.         return config.getName() + (is64Bit (config) ? "|x64"

  1025.                                                     : "|Win32");

  1026.     }

  1027. 

  1028.     void setConditionAttribute (XmlElement& xml, const BuildConfiguration& config) const

  1029.     {

  1030.         xml.setAttribute ("Condition", "'$(Configuration)|$(Platform)'=='" + createConfigName (config) + "'");

  1031.     }

  1032. 

  1033.     //==============================================================================

  1034.     void fillInProjectXml (XmlElement& projectXml) const

  1035.     {

  1036.         projectXml.setAttribute ("DefaultTargets", "Build");

  1037.         projectXml.setAttribute ("ToolsVersion", "4.0");

  1038.         projectXml.setAttribute ("xmlns", "http://schemas.microsoft.com/developer/msbuild/2003");

  1039. 

  1040.         {

  1041.             XmlElement* configsGroup = projectXml.createNewChildElement ("ItemGroup");

  1042.             configsGroup->setAttribute ("Label", "ProjectConfigurations");

  1043. 

  1044.             for (ConstConfigIterator config (*this); config.next();)

  1045.             {

  1046.                 XmlElement* e = configsGroup->createNewChildElement ("ProjectConfiguration");

  1047.                 e->setAttribute ("Include", createConfigName (*config));

  1048.                 e->createNewChildElement ("Configuration")->addTextElement (config->getName());

  1049.                 e->createNewChildElement ("Platform")->addTextElement (is64Bit (*config) ? "x64" : "Win32");

  1050.             }

  1051.         }

  1052. 

  1053.         {

  1054.             XmlElement* globals = projectXml.createNewChildElement ("PropertyGroup");

  1055.             globals->setAttribute ("Label", "Globals");

  1056.             globals->createNewChildElement ("ProjectGuid")->addTextElement (projectGUID);

  1057.         }

  1058. 

  1059.         {

  1060.             XmlElement* imports = projectXml.createNewChildElement ("Import");

  1061.             imports->setAttribute ("Project", "$(VCTargetsPath)\\Microsoft.Cpp.Default.props");

  1062.         }

  1063. 

  1064.         for (ConstConfigIterator i (*this); i.next();)

  1065.         {

  1066.             const MSVCBuildConfiguration& config = dynamic_cast <const MSVCBuildConfiguration&> (*i);

  1067. 

  1068.             XmlElement* e = projectXml.createNewChildElement ("PropertyGroup");

  1069.             setConditionAttribute (*e, config);

  1070.             e->setAttribute ("Label", "Configuration");

  1071.             e->createNewChildElement ("ConfigurationType")->addTextElement (getProjectType());

  1072.             e->createNewChildElement ("UseOfMfc")->addTextElement ("false");

  1073.             e->createNewChildElement ("CharacterSet")->addTextElement ("MultiByte");

  1074. 

  1075.             if (! (config.isDebug() || config.shouldDisableWholeProgramOpt()))

  1076.                 e->createNewChildElement ("WholeProgramOptimization")->addTextElement ("true");

  1077. 

  1078.             if (is64Bit (config))

  1079.                 e->createNewChildElement ("PlatformToolset")->addTextElement (getPlatformToolset());

  1080.         }

  1081. 

  1082.         {

  1083.             XmlElement* e = projectXml.createNewChildElement ("Import");

  1084.             e->setAttribute ("Project", "$(VCTargetsPath)\\Microsoft.Cpp.props");

  1085.         }

  1086. 

  1087.         {

  1088.             XmlElement* e = projectXml.createNewChildElement ("ImportGroup");

  1089.             e->setAttribute ("Label", "ExtensionSettings");

  1090.         }

  1091. 

  1092.         {

  1093.             XmlElement* e = projectXml.createNewChildElement ("ImportGroup");

  1094.             e->setAttribute ("Label", "PropertySheets");

  1095.             XmlElement* p = e->createNewChildElement ("Import");

  1096.             p->setAttribute ("Project", "$(UserRootDir)\\Microsoft.Cpp.$(Platform).user.props");

  1097.             p->setAttribute ("Condition", "exists('$(UserRootDir)\\Microsoft.Cpp.$(Platform).user.props')");

  1098.             p->setAttribute ("Label", "LocalAppDataPlatform");

  1099.         }

  1100. 

  1101.         {

  1102.             XmlElement* e = projectXml.createNewChildElement ("PropertyGroup");

  1103.             e->setAttribute ("Label", "UserMacros");

  1104.         }

  1105. 

  1106.         {

  1107.             XmlElement* props = projectXml.createNewChildElement ("PropertyGroup");

  1108.             props->createNewChildElement ("_ProjectFileVersion")->addTextElement ("10.0.30319.1");

  1109. 

  1110.             for (ConstConfigIterator i (*this); i.next();)

  1111.             {

  1112.                 const MSVCBuildConfiguration& config = dynamic_cast <const MSVCBuildConfiguration&> (*i);

  1113. 

  1114.                 {

  1115.                     XmlElement* outdir = props->createNewChildElement ("OutDir");

  1116.                     setConditionAttribute (*outdir, config);

  1117.                     outdir->addTextElement (FileHelpers::windowsStylePath (getConfigTargetPath (config)) + "\\");

  1118.                 }

  1119. 

  1120.                 if (config.getIntermediatesPath().isNotEmpty())

  1121.                 {

  1122.                     XmlElement* intdir = props->createNewChildElement ("IntDir");

  1123.                     setConditionAttribute (*intdir, config);

  1124.                     intdir->addTextElement (FileHelpers::windowsStylePath (config.getIntermediatesPath()) + "\\");

  1125.                 }

  1126. 

  1127.                 {

  1128.                     XmlElement* targetName = props->createNewChildElement ("TargetName");

  1129.                     setConditionAttribute (*targetName, config);

  1130.                     targetName->addTextElement (config.getOutputFilename (String::empty, true));

  1131.                 }

  1132. 

  1133.                 {

  1134.                     XmlElement* manifest = props->createNewChildElement ("GenerateManifest");

  1135.                     setConditionAttribute (*manifest, config);

  1136.                     manifest->addTextElement (config.shouldGenerateManifest() ? "true" : "false");

  1137.                 }

  1138. 

  1139.                 const StringArray librarySearchPaths (config.getLibrarySearchPaths());

  1140. 

  1141.                 if (librarySearchPaths.size() > 0)

  1142.                 {

  1143.                     XmlElement* libPath = props->createNewChildElement ("LibraryPath");

  1144.                     setConditionAttribute (*libPath, config);

  1145.                     libPath->addTextElement ("$(LibraryPath);" + librarySearchPaths.joinIntoString (";"));

  1146.                 }

  1147.             }

  1148.         }

  1149. 

  1150.         for (ConstConfigIterator i (*this); i.next();)

  1151.         {

  1152.             const MSVCBuildConfiguration& config = dynamic_cast <const MSVCBuildConfiguration&> (*i);

  1153. 

  1154.             const bool isDebug = config.isDebug();

  1155. 

  1156.             XmlElement* group = projectXml.createNewChildElement ("ItemDefinitionGroup");

  1157.             setConditionAttribute (*group, config);

  1158. 

  1159.             {

  1160.                 XmlElement* midl = group->createNewChildElement ("Midl");

  1161.                 midl->createNewChildElement ("PreprocessorDefinitions")->addTextElement (isDebug ? "_DEBUG;%(PreprocessorDefinitions)"

  1162.                                                                                                  : "NDEBUG;%(PreprocessorDefinitions)");

  1163.                 midl->createNewChildElement ("MkTypLibCompatible")->addTextElement ("true");

  1164.                 midl->createNewChildElement ("SuppressStartupBanner")->addTextElement ("true");

  1165.                 midl->createNewChildElement ("TargetEnvironment")->addTextElement ("Win32");

  1166.                 midl->createNewChildElement ("HeaderFileName");

  1167.             }

  1168. 

  1169.             bool isUsingEditAndContinue = false;

  1170. 

  1171.             {

  1172.                 XmlElement* cl = group->createNewChildElement ("ClCompile");

  1173. 

  1174.                 cl->createNewChildElement ("Optimization")->addTextElement (getOptimisationLevelString (config.getOptimisationLevelInt()));

  1175. 

  1176.                 if (isDebug && config.getOptimisationLevelInt() <= optimisationOff)

  1177.                 {

  1178.                     isUsingEditAndContinue = ! is64Bit (config);

  1179. 

  1180.                     cl->createNewChildElement ("DebugInformationFormat")

  1181.                             ->addTextElement (isUsingEditAndContinue ? "EditAndContinue"

  1182.                                                                      : "ProgramDatabase");

  1183.                 }

  1184. 

  1185.                 StringArray includePaths (getHeaderSearchPaths (config));

  1186.                 includePaths.add ("%(AdditionalIncludeDirectories)");

  1187.                 cl->createNewChildElement ("AdditionalIncludeDirectories")->addTextElement (includePaths.joinIntoString (";"));

  1188.                 cl->createNewChildElement ("PreprocessorDefinitions")->addTextElement (getPreprocessorDefs (config, ";") + ";%(PreprocessorDefinitions)");

  1189.                 cl->createNewChildElement ("RuntimeLibrary")->addTextElement (config.isUsingRuntimeLibDLL() ? (isDebug ? "MultiThreadedDebugDLL" : "MultiThreadedDLL")

  1190.                                                                                                             : (isDebug ? "MultiThreadedDebug"    : "MultiThreaded"));

  1191.                 cl->createNewChildElement ("RuntimeTypeInfo")->addTextElement ("true");

  1192.                 cl->createNewChildElement ("PrecompiledHeader");

  1193.                 cl->createNewChildElement ("AssemblerListingLocation")->addTextElement ("$(IntDir)\\");

  1194.                 cl->createNewChildElement ("ObjectFileName")->addTextElement ("$(IntDir)\\");

  1195.                 cl->createNewChildElement ("ProgramDataBaseFileName")->addTextElement ("$(IntDir)\\");

  1196.                 cl->createNewChildElement ("WarningLevel")->addTextElement ("Level" + String (getWarningLevel (config)));

  1197.                 cl->createNewChildElement ("SuppressStartupBanner")->addTextElement ("true");

  1198.                 cl->createNewChildElement ("MultiProcessorCompilation")->addTextElement ("true");

  1199. 

  1200.                 const String extraFlags (replacePreprocessorTokens (config, getExtraCompilerFlagsString()).trim());

  1201.                 if (extraFlags.isNotEmpty())

  1202.                     cl->createNewChildElement ("AdditionalOptions")->addTextElement (extraFlags + " %(AdditionalOptions)");

  1203.             }

  1204. 

  1205.             {

  1206.                 XmlElement* res = group->createNewChildElement ("ResourceCompile");

  1207.                 res->createNewChildElement ("PreprocessorDefinitions")->addTextElement (isDebug ? "_DEBUG;%(PreprocessorDefinitions)"

  1208.                                                                                                 : "NDEBUG;%(PreprocessorDefinitions)");

  1209.             }

  1210. 

  1211.             {

  1212.                 XmlElement* link = group->createNewChildElement ("Link");

  1213.                 link->createNewChildElement ("OutputFile")->addTextElement (getOutDirFile (config.getOutputFilename (msvcTargetSuffix, false)));

  1214.                 link->createNewChildElement ("SuppressStartupBanner")->addTextElement ("true");

  1215.                 link->createNewChildElement ("IgnoreSpecificDefaultLibraries")->addTextElement (isDebug ? "libcmt.lib; msvcrt.lib;;%(IgnoreSpecificDefaultLibraries)"

  1216.                                                                                                         : "%(IgnoreSpecificDefaultLibraries)");

  1217.                 link->createNewChildElement ("GenerateDebugInformation")->addTextElement ((isDebug || config.shouldGenerateDebugSymbols()) ? "true" : "false");

  1218.                 link->createNewChildElement ("ProgramDatabaseFile")->addTextElement (getIntDirFile (config.getOutputFilename (".pdb", true)));

  1219.                 link->createNewChildElement ("SubSystem")->addTextElement (msvcIsWindowsSubsystem ? "Windows" : "Console");

  1220. 

  1221.                 if (! is64Bit (config))

  1222.                     link->createNewChildElement ("TargetMachine")->addTextElement ("MachineX86");

  1223. 

  1224.                 if (isUsingEditAndContinue)

  1225.                     link->createNewChildElement ("ImageHasSafeExceptionHandlers")->addTextElement ("false");

  1226. 

  1227.                 if (! isDebug)

  1228.                 {

  1229.                     link->createNewChildElement ("OptimizeReferences")->addTextElement ("true");

  1230.                     link->createNewChildElement ("EnableCOMDATFolding")->addTextElement ("true");

  1231.                 }

  1232. 

  1233.                 const StringArray librarySearchPaths (config.getLibrarySearchPaths());

  1234.                 if (librarySearchPaths.size() > 0)

  1235.                     link->createNewChildElement ("AdditionalLibraryDirectories")->addTextElement (replacePreprocessorTokens (config, librarySearchPaths.joinIntoString (";"))

  1236.                                                                                                     + ";%(AdditionalLibraryDirectories)");

  1237. 

  1238.                 link->createNewChildElement ("LargeAddressAware")->addTextElement ("true");

  1239. 

  1240.                 String externalLibraries (getExternalLibrariesString());

  1241.                 if (externalLibraries.isNotEmpty())

  1242.                     link->createNewChildElement ("AdditionalDependencies")->addTextElement (replacePreprocessorTokens (config, externalLibraries).trim()

  1243.                                                                                               + ";%(AdditionalDependencies)");

  1244. 

  1245.                 String extraLinkerOptions (getExtraLinkerFlagsString());

  1246.                 if (extraLinkerOptions.isNotEmpty())

  1247.                     link->createNewChildElement ("AdditionalOptions")->addTextElement (replacePreprocessorTokens (config, extraLinkerOptions).trim()

  1248.                                                                                          + " %(AdditionalOptions)");

  1249. 

  1250.                 if (msvcDelayLoadedDLLs.isNotEmpty())

  1251.                     link->createNewChildElement ("DelayLoadDLLs")->addTextElement (msvcDelayLoadedDLLs);

  1252. 

  1253.                 if (config.config [Ids::msvcModuleDefinitionFile].toString().isNotEmpty())

  1254.                     link->createNewChildElement ("ModuleDefinitionFile")

  1255.                         ->addTextElement (config.config [Ids::msvcModuleDefinitionFile].toString());

  1256.             }

  1257. 

  1258.             {

  1259.                 XmlElement* bsc = group->createNewChildElement ("Bscmake");

  1260.                 bsc->createNewChildElement ("SuppressStartupBanner")->addTextElement ("true");

  1261.                 bsc->createNewChildElement ("OutputFile")->addTextElement (getIntDirFile (config.getOutputFilename (".bsc", true)));

  1262.             }

  1263. 

  1264.             if (config.getPrebuildCommandString().isNotEmpty())

  1265.                 group->createNewChildElement ("PreBuildEvent")

  1266.                      ->createNewChildElement ("Command")

  1267.                      ->addTextElement (config.getPrebuildCommandString());

  1268. 

  1269.             if (config.getPostbuildCommandString().isNotEmpty())

  1270.                 group->createNewChildElement ("PostBuildEvent")

  1271.                      ->createNewChildElement ("Command")

  1272.                      ->addTextElement (config.getPostbuildCommandString());

  1273.         }

  1274. 

  1275.         ScopedPointer<XmlElement> otherFilesGroup (new XmlElement ("ItemGroup"));

  1276. 

  1277.         {

  1278.             XmlElement* cppFiles    = projectXml.createNewChildElement ("ItemGroup");

  1279.             XmlElement* headerFiles = projectXml.createNewChildElement ("ItemGroup");

  1280. 

  1281.             for (int i = 0; i < getAllGroups().size(); ++i)

  1282.             {

  1283.                 const Project::Item& group = getAllGroups().getReference(i);

  1284. 

  1285.                 if (group.getNumChildren() > 0)

  1286.                     addFilesToCompile (group, *cppFiles, *headerFiles, *otherFilesGroup);

  1287.             }

  1288.         }

  1289. 

  1290.         if (iconFile != File::nonexistent)

  1291.         {

  1292.             XmlElement* e = otherFilesGroup->createNewChildElement ("None");

  1293.             e->setAttribute ("Include", prependDot (iconFile.getFileName()));

  1294.         }

  1295. 

  1296.         if (otherFilesGroup->getFirstChildElement() != nullptr)

  1297.             projectXml.addChildElement (otherFilesGroup.release());

  1298. 

  1299.         if (hasResourceFile())

  1300.         {

  1301.             XmlElement* rcGroup = projectXml.createNewChildElement ("ItemGroup");

  1302.             XmlElement* e = rcGroup->createNewChildElement ("ResourceCompile");

  1303.             e->setAttribute ("Include", prependDot (rcFile.getFileName()));

  1304.         }

  1305. 

  1306.         {

  1307.             XmlElement* e = projectXml.createNewChildElement ("Import");

  1308.             e->setAttribute ("Project", "$(VCTargetsPath)\\Microsoft.Cpp.targets");

  1309.         }

  1310. 

  1311.         {

  1312.             XmlElement* e = projectXml.createNewChildElement ("ImportGroup");

  1313.             e->setAttribute ("Label", "ExtensionTargets");

  1314.         }

  1315.     }

  1316. 

  1317.     String getProjectType() const

  1318.     {

  1319.         if (projectType.isGUIApplication() || projectType.isCommandLineApp())   return "Application";

  1320.         if (isLibraryDLL())                                                     return "DynamicLibrary";

  1321.         if (projectType.isStaticLibrary())                                      return "StaticLibrary";

  1322. 

  1323.         jassertfalse;

  1324.         return String::empty;

  1325.     }

  1326. 

  1327.     static const char* getOptimisationLevelString (int level)

  1328.     {

  1329.         switch (level)

  1330.         {

  1331.             case optimiseMaxSpeed:  return "Full";

  1332.             case optimiseMinSize:   return "MinSpace";

  1333.             default:                return "Disabled";

  1334.         }

  1335.     }

  1336. 

  1337.     //==============================================================================

  1338.     void addFilesToCompile (const Project::Item& projectItem, XmlElement& cpps, XmlElement& headers, XmlElement& otherFiles) const

  1339.     {

  1340.         if (projectItem.isGroup())

  1341.         {

  1342.             for (int i = 0; i < projectItem.getNumChildren(); ++i)

  1343.                 addFilesToCompile (projectItem.getChild(i), cpps, headers, otherFiles);

  1344.         }

  1345.         else if (projectItem.shouldBeAddedToTargetProject())

  1346.         {

  1347.             const RelativePath path (projectItem.getFile(), getTargetFolder(), RelativePath::buildTargetFolder);

  1348. 

  1349.             jassert (path.getRoot() == RelativePath::buildTargetFolder);

  1350. 

  1351.             if (path.hasFileExtension ("cpp;cc;cxx;c"))

  1352.             {

  1353.                 XmlElement* e = cpps.createNewChildElement ("ClCompile");

  1354.                 e->setAttribute ("Include", path.toWindowsStyle());

  1355. 

  1356.                 if (! projectItem.shouldBeCompiled())

  1357.                     e->createNewChildElement ("ExcludedFromBuild")->addTextElement ("true");

  1358. 

  1359.                 if (projectItem.shouldUseStdCall())

  1360.                     e->createNewChildElement ("CallingConvention")->addTextElement ("StdCall");

  1361.             }

  1362.             else if (path.hasFileExtension (headerFileExtensions))

  1363.             {

  1364.                 headers.createNewChildElement ("ClInclude")->setAttribute ("Include", path.toWindowsStyle());

  1365.             }

  1366.             else if (! path.hasFileExtension ("mm;m"))

  1367.             {

  1368.                 otherFiles.createNewChildElement ("None")->setAttribute ("Include", path.toWindowsStyle());

  1369.             }

  1370.         }

  1371.     }

  1372. 

  1373.     //==============================================================================

  1374.     void addFilterGroup (XmlElement& groups, const String& path) const

  1375.     {

  1376.         XmlElement* e = groups.createNewChildElement ("Filter");

  1377.         e->setAttribute ("Include", path);

  1378.         e->createNewChildElement ("UniqueIdentifier")->addTextElement (createGUID (path + "_guidpathsaltxhsdf"));

  1379.     }

  1380. 

  1381.     void addFileToFilter (const RelativePath& file, const String& groupPath,

  1382.                           XmlElement& cpps, XmlElement& headers, XmlElement& otherFiles) const

  1383.     {

  1384.         XmlElement* e;

  1385. 

  1386.         if (file.hasFileExtension (headerFileExtensions))

  1387.             e = headers.createNewChildElement ("ClInclude");

  1388.         else if (file.hasFileExtension (sourceFileExtensions))

  1389.             e = cpps.createNewChildElement ("ClCompile");

  1390.         else

  1391.             e = otherFiles.createNewChildElement ("None");

  1392. 

  1393.         jassert (file.getRoot() == RelativePath::buildTargetFolder);

  1394.         e->setAttribute ("Include", file.toWindowsStyle());

  1395.         e->createNewChildElement ("Filter")->addTextElement (groupPath);

  1396.     }

  1397. 

  1398.     void addFilesToFilter (const Project::Item& projectItem, const String& path,

  1399.                            XmlElement& cpps, XmlElement& headers, XmlElement& otherFiles, XmlElement& groups) const

  1400.     {

  1401.         if (projectItem.isGroup())

  1402.         {

  1403.             addFilterGroup (groups, path);

  1404. 

  1405.             for (int i = 0; i < projectItem.getNumChildren(); ++i)

  1406.                 addFilesToFilter (projectItem.getChild(i),

  1407.                                   (path.isEmpty() ? String::empty : (path + "\\")) + projectItem.getChild(i).getName(),

  1408.                                   cpps, headers, otherFiles, groups);

  1409.         }

  1410.         else if (projectItem.shouldBeAddedToTargetProject())

  1411.         {

  1412.             addFileToFilter (RelativePath (projectItem.getFile(), getTargetFolder(), RelativePath::buildTargetFolder),

  1413.                              path.upToLastOccurrenceOf ("\\", false, false), cpps, headers, otherFiles);

  1414.         }

  1415.     }

  1416. 

  1417.     void addFilesToFilter (const Array<RelativePath>& files, const String& path,

  1418.                            XmlElement& cpps, XmlElement& headers, XmlElement& otherFiles, XmlElement& groups)

  1419.     {

  1420.         if (files.size() > 0)

  1421.         {

  1422.             addFilterGroup (groups, path);

  1423. 

  1424.             for (int i = 0; i < files.size(); ++i)

  1425.                 addFileToFilter (files.getReference(i), path, cpps, headers, otherFiles);

  1426.         }

  1427.     }

  1428. 

  1429.     void fillInFiltersXml (XmlElement& filterXml) const

  1430.     {

  1431.         filterXml.setAttribute ("ToolsVersion", "4.0");

  1432.         filterXml.setAttribute ("xmlns", "http://schemas.microsoft.com/developer/msbuild/2003");

  1433. 

  1434.         XmlElement* groupsXml  = filterXml.createNewChildElement ("ItemGroup");

  1435.         XmlElement* cpps       = filterXml.createNewChildElement ("ItemGroup");

  1436.         XmlElement* headers    = filterXml.createNewChildElement ("ItemGroup");

  1437.         ScopedPointer<XmlElement> otherFilesGroup (new XmlElement ("ItemGroup"));

  1438. 

  1439.         for (int i = 0; i < getAllGroups().size(); ++i)

  1440.         {

  1441.             const Project::Item& group = getAllGroups().getReference(i);

  1442. 

  1443.             if (group.getNumChildren() > 0)

  1444.                 addFilesToFilter (group, group.getName(), *cpps, *headers, *otherFilesGroup, *groupsXml);

  1445.         }

  1446. 

  1447.         if (iconFile.exists())

  1448.         {

  1449.             XmlElement* e = otherFilesGroup->createNewChildElement ("None");

  1450.             e->setAttribute ("Include", prependDot (iconFile.getFileName()));

  1451.             e->createNewChildElement ("Filter")->addTextElement (ProjectSaver::getJuceCodeGroupName());

  1452.         }

  1453. 

  1454.         if (otherFilesGroup->getFirstChildElement() != nullptr)

  1455.             filterXml.addChildElement (otherFilesGroup.release());

  1456. 

  1457.         if (hasResourceFile())

  1458.         {

  1459.             XmlElement* rcGroup = filterXml.createNewChildElement ("ItemGroup");

  1460.             XmlElement* e = rcGroup->createNewChildElement ("ResourceCompile");

  1461.             e->setAttribute ("Include", prependDot (rcFile.getFileName()));

  1462.             e->createNewChildElement ("Filter")->addTextElement (ProjectSaver::getJuceCodeGroupName());

  1463.         }

  1464.     }

  1465. 

  1466.     JUCE_DECLARE_NON_COPYABLE (MSVCProjectExporterVC2010)

  1467. };

  1468. 

  1469. //==============================================================================

  1470. class MSVCProjectExporterVC2012 : public MSVCProjectExporterVC2010

  1471. {

  1472. public:

  1473.     MSVCProjectExporterVC2012 (Project& p, const ValueTree& t)

  1474.         : MSVCProjectExporterVC2010 (p, t, "VisualStudio2012")

  1475.     {

  1476.         name = getName();

  1477.     }

  1478. 

  1479.     static const char* getName()                { return "Visual Studio 2012"; }

  1480.     static const char* getValueTreeTypeName()   { return "VS2012"; }

  1481.     int getVisualStudioVersion() const          { return 11; }

  1482.     String getSolutionComment() const           { return "# Visual Studio 2012"; }

  1483. 

  1484.     String getPlatformToolset() const

  1485.     {

  1486.         const String s (settings [Ids::toolset].toString());

  1487.         return s.isNotEmpty() ? s : "v110";

  1488.     }

  1489. 

  1490.     Value getPlatformToolsetValue()             { return getSetting (Ids::toolset); }

  1491. 

  1492.     static MSVCProjectExporterVC2012* createForSettings (Project& project, const ValueTree& settings)

  1493.     {

  1494.         if (settings.hasType (getValueTreeTypeName()))

  1495.             return new MSVCProjectExporterVC2012 (project, settings);

  1496. 

  1497.         return nullptr;

  1498.     }

  1499. 

  1500.     void createExporterProperties (PropertyListBuilder& props)

  1501.     {

  1502.         MSVCProjectExporterVC2010::createExporterProperties (props);

  1503. 

  1504.         const char* const toolsetNames[] = { "(default)", "v110", "v110_xp", "Windows7.1SDK", nullptr };

  1505.         const var toolsets[]             = { var(),       "v110", "v110_xp", "Windows7.1SDK" };

  1506. 

  1507.         props.add (new ChoicePropertyComponent (getPlatformToolsetValue(), "Platform Toolset",

  1508.                                                 StringArray (toolsetNames),

  1509.                                                 Array<var> (toolsets, numElementsInArray (toolsets))));

  1510.     }

  1511. 

  1512. private:

  1513.     void addPlatformToolsetToPropertyGroup (XmlElement& p) const

  1514.     {

  1515.         forEachXmlChildElementWithTagName (p, e, "PropertyGroup")

  1516.         {

  1517.             XmlElement* platformToolset (new XmlElement ("PlatformToolset"));

  1518.             platformToolset->addTextElement (getPlatformToolset());

  1519. 

  1520.             e->addChildElement (platformToolset);

  1521.         }

  1522.     }

  1523. 

  1524.     JUCE_DECLARE_NON_COPYABLE (MSVCProjectExporterVC2012)

  1525. };

  1526. 

  1527. 

  1528. #endif   // __JUCER_PROJECTEXPORT_MSVC_JUCEHEADER__