add .gitignore, Readme and license

Author: jmairboeck

.gitignore

@@ -0,0 +1,3 @@
+.vs/
+Debug/
+Release/

CreateEmbedLangTransform.sln

@@ -1,10 +1,16 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 14
-VisualStudioVersion = 14.0.25123.0
+# Visual Studio Version 17
+VisualStudioVersion = 17.6.33712.159
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "CreateEmbedLangTransform", "CreateEmbedLangTransform\CreateEmbedLangTransform.vcxproj", "{A2FA3A92-E08B-4593-A042-B3F693B2AF53}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{56C4810E-1A32-4D4B-82F4-FF97596B52CB}"
+	ProjectSection(SolutionItems) = preProject
+		LICENSE.txt = LICENSE.txt
+		Readme.md = Readme.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Win32 = Debug|Win32
@@ -19,4 +25,7 @@ Global
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {66BA9CFA-3945-4178-B876-314F0FF97F05}
+	EndGlobalSection
 EndGlobal

CreateEmbedLangTransform/main.cpp

@@ -1,3 +1,11 @@
+/*
+ * Copyright 2016-2023, RISC Software GmbH. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ * 
+ * Authors:
+ *  Joachim Mairböck <joachim.mairboeck@risc-software.at>
+ */
+
 #include <Windows.h>
 #include <tchar.h>
 #include <MsiQuery.h>

LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2016-2023 RISC Software GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Readme.md

@@ -0,0 +1,46 @@
+# CreateEmbedLangTransform
+
+CreateEmbedLangTransform is a tool for post-processing Windows Installer packages to create a single multi-lingual package from multiple individual packages, as they are created by the [WiX Toolset](https://wixtoolset.org/).
+
+This could also be done using a combination of a few scripts from the Windows Installer SDK. This combines that task into a single C++ command line tool using the Windows Installer database API.
+
+## Usage
+
+The tool takes 3 command line arguments:
+
+```bat
+CreateEmbedLangTransform.exe <target-and-reference-msi> <source-msi> <language-identifier>
+```
+
+Example:
+
+To embed the German translation into an English installer, call the tool like this:
+
+```bat
+CreateEmbedLangTransform.exe Setup.msi Setup_de-de.msi 1031
+```
+
+For a WiX MSBuild project (.wixproj), the following can be added as post-build event:
+
+```bat
+rem Copy the English installer into a language-neutral folder. It will become the multilingual one.
+copy en-us\$(TargetFileName) .
+
+rem Create and embed the German transform into the final installer.
+CreateEmbedLangTransform.exe $(TargetFileName) de-de\$(TargetFileName) 1031
+
+rem Other languages can be added by multiple invocations of CreateEmbedLangTransform.
+```
+
+## What this does
+
+1. The tool creates a Windows Installer transform as the difference between the first and second argument and stores it as a temporary file (equivalent to the `WiGenXfm.vbs` script from the Windows Installer SDK).
+1. It embeds the transform as a substorage under the name equal to the language ID (the third argument) (equivalent to the `WiSubStg.vbs` script).
+1. To support WiX v.4, the tool also adds the language ID to the Summary information property "Template" if it isn't already, so that the MSI package is recognized as multilingual by Windows Installer (equivalent to the `WiLangId.vbs` script).
+1. The temporary file created in step 1 is deleted again.
+
+**Note:** This is an *undocumented* feature of Windows Installer. It is therefore not officially supported by Microsoft, and not supported by WiX!
+
+## Building
+
+The tool is currently built with Visual Studio 2022. It requires the "C++ Desktop" workload. It can probably be built with older versions as long as C++17 is supported.