This is the November 2021 Update (v2.10.0)

README.md

@@ -1,5 +1,6 @@
+<!-- Begin exclude from NuGet readme. -->
 <h1 align="center">
- <a href="#"><img align="center" src="documentation/readme/wordmark480.png" height="96"></a>
+ <a href="#"><img align="center" src="documentation/readme/silkdotnet_v3_horizontal_96.svg"></a>
  <br />
 </h1>
 <div align="center">
@@ -12,6 +13,10 @@
 </div>
 
 <div> 
+<!-- End exclude from NuGet readme. -->
+<!-- Begin include in NuGet readme.
+![Silk.NET Logo](https://raw.githubusercontent.com/dotnet/Silk.NET/main/documentation/readme/silkdotnet_v3_horizontal_96.svg)
+End include in NuGet readme. -->
 
 Silk.NET is your one-stop-shop for high-speed .NET multimedia, graphics, and compute; providing bindings to popular low-level APIs such as OpenGL, OpenCL, OpenAL, OpenXR, GLFW, SDL, Vulkan, Assimp, and DirectX.
 
@@ -22,12 +27,20 @@ Silk.NET works on any .NET Standard 2.0 compliant platform, including .NET 5.0,
 </div>
 <br />
 <div>
- <a href="https://dotnetfoundation.org" align="right"><img src="https://dotnetfoundation.org/img/logo_v4.svg" alt=".NET Foundation" class="logo-footer" width="72" align="left">
- <a><br/>
- Proud to be an official project under the benevolent <a href="https://dotnetfoundation.org">.NET Foundation</a> umbrella. </a>
+<!-- Begin exclude from NuGet readme. -->
+<a href="https://dotnetfoundation.org" align="right"><img src="https://dotnetfoundation.org/img/logo_v4.svg" alt=".NET Foundation" class="logo-footer" width="72" align="left">
+<!-- End exclude from NuGet readme. -->
+<!-- Begin include in NuGet readme.
+![.NET Foundation](https://raw.githubusercontent.com/dotnet/Silk.NET/main/documentation/readme/dotnetfoundation_v4_horizontal_64.svg)
+End include in NuGet readme. -->
+</a>
+<br />
+
+Proud to be an official project under the benevolent [.NET Foundation](https://dotnetfoundation.org) umbrella.
+
 </div>
 
-<br />
+<!-- Package description inserted here automatically. -->
 
 <h1 align="center">Features</h1>
 
@@ -43,6 +56,8 @@ In addition to providing high-speed, direct, and transparent bindings, we provid
 ### Good-to-go
 Silk.NET caters for anything you could need in swift development of multimedia, graphics, compute applications. Silk.NET is an all-in-one solution, complete with Graphics, Compute, Audio, Input, and Windowing.
 
+<!-- Begin exclude from NuGet readme. -->
+
 <h1 align="center">The team</h1>
 
 We currently have the following maintainers:
@@ -79,7 +94,9 @@ Silk.NET uses and encourages [Early Pull Requests](https://medium.com/practical-
 3. Once you've pushed a commit, open a [**draft pull request**](https://github.blog/2019-02-14-introducing-draft-pull-requests/). Do this **before** you actually start working.
 4. Make your commits in small, incremental steps with clear descriptions.
 5. Tag a maintainer when you're done and ask for a review!
-
+
+<!-- End exclude from NuGet readme. -->
+
 <h2 align="center">Funding</h2>
 Silk.NET requires significant effort to maintain, as such we greatly appreciate any financial support you are able to provide!
 
@@ -96,11 +113,16 @@ Silk.NET is distributed under the very permissive MIT/X11 license and all depend
 
 Silk.NET is a [.NET Foundation](https://www.dotnetfoundation.org/projects) project, and has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/) to clarify expected behavior in our community. For more information, see the [.NET Foundation Code of Conduct](http://www.dotnetfoundation.org/code-of-conduct).
 
+<!-- Begin exclude from NuGet readme. -->
+
 ---
 
 <div>
- <a href="https://www.jetbrains.com/?from=Silk.NET" align="right"><img src="documentation/readme/jetbrains.svg" alt="JetBrains" class="logo-footer" width="72" align="left">
+ <a href="https://www.jetbrains.com/?from=Silk.NET" align="right"><img src="https://raw.githubusercontent.com/dotnet/Silk.NET/main/documentation/readme/jetbrains.svg" alt="JetBrains" class="logo-footer" width="72" align="left">
  <a><br/>
 
 Special thanks to [JetBrains](https://www.jetbrains.com/?from=Silk.NET) for supporting us with open-source licenses for their IDEs. </a>
 </div>
+
+<!-- End exclude from NuGet readme. -->
+

Silk.NET.sln

@@ -33,7 +33,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Build Properties", "Build P
 	ProjectSection(SolutionItems) = preProject
  build\props\bindings.props = build\props\bindings.props
  build\props\common.props = build\props\common.props
- build\props\common.targets = build\props\common.targets
  build\csharp_typemap.json = build\csharp_typemap.json
  build\dx_typemap.json = build\dx_typemap.json
  generator.json = generator.json

build/props/common.props

@@ -1,50 +1,95 @@
 <!--suppress CheckTagEmptyBody -->
-<Project>
+<Project InitialTargets="SilkAddIcon;SilkGenerateNuGetReadme">
  <PropertyGroup>
- <PackageIconUrl>https://static.ultz.co.uk/img/SilkDotNet.png</PackageIconUrl>
  <PackageLicenseExpression>MIT</PackageLicenseExpression>
  <LangVersion>preview</LangVersion>
  <Authors>.NET Foundation and Contributors</Authors>
  <PackageReleaseNotes>
- Silk.NET October 2021 Update
-
- - Add bindings for DirectX Video Acceleration (DXVA)
- - Add bindings for D3D9Ex
- - Add bindings for extra core Win32 APIs (as required by DXVA)
- - Add a .NET 6 code path for GlobalMemory using NativeMemory
- - Add more TFMs in addition to .NET Standard 2.0 for DirectX bindings 
- - Add enhanced anonymous struct support with ref-returning properties on .NET Standard 2.1 and up
- - Update to Vulkan 1.2.194
- - Update to latest OpenCL specifications
- - Fix MarshalDirectiveException when a struct containing a char passes across a native boundary
- - Fix Vulkan out parameters not having their structure type set before passing across the native boundary
- - Fix native libraries not being found in some cases for self-contained executables
+ Silk.NET November 2021 Update
+
+ - Added support for BigInteger and Complex in the Silk.NET.Maths.Scalar APIs. (thanks @WhiteBlackGoose)
+ - Added helper constructors for maths types (Rectangle, Box2D, Box3D, etc). (thanks @nathan-alden-sr)
+ - Added bitwise APIs to Silk.NET.Maths.Scalar. (thanks @WhiteBlackGoose)
+ - Added support for configuring OpenGL multisamping.
+ - Updated to Vulkan 1.2.197.
+ - Updated to latest OpenCL specifications.
+ - Updated to latest OpenGL specifications.
+ - Updated DirectX and Win32 bindings to Windows 11 SDK.
+ - Removed redundant references with no DLLs (i.e. BCL/legacy packages not needed on newer platforms, thanks @nathan-alden-sr @WhiteBlackGoose)
+ - Removed problematic implicit-in OpenGL overloads (fixes the infamous VertexAttribPointer bug)
+ - Fixed incorrect character encoding of keyboard (text) input on the SDL backend. (thanks @roeyskoe)
+ - Fixed native libraries not being resolved despite being present in the "runtimes" folder.
+ - Miscellaneous documentation fixes and improvements.
  </PackageReleaseNotes>
  <PackageTags Condition="'$(PackageTags)' == ''">OpenCL;OpenGL;OpenAL;OpenGLES;GLES;Vulkan;Assimp;DirectX;GLFW;SDL;Windowing;Input;Gamepad;Joystick;Keyboard;Mouse;SilkTouch;Source;Generator;C#;F#;.NET;DotNet;Mono;Vector;Math;Maths;Numerics;Game;Graphics;Compute;Audio;Sound;Engine;Silk;Silk.NET;Slim.NET;ElgarTK;GPU;Sharp;Science;Scientific;Visualization;Visual;Audiovisual;Windows;macOS;Linux;Android;Bindings;OSX;Wrapper;Native</PackageTags>
  <GenerateDocumentationFile>true</GenerateDocumentationFile>
  <PackageOutputPath>$(MSBuildThisFileDirectory)/../output_packages</PackageOutputPath>
  <RepositoryUrl>https://github.com/dotnet/Silk.NET</RepositoryUrl>
  <RepositoryType>Git</RepositoryType>
- <VersionPrefix>2.9.0</VersionPrefix>
+ <VersionPrefix>2.10.0</VersionPrefix>
  <VersionSuffix Condition="'$(VersionSuffix)' == ''"></VersionSuffix>
  <Description Condition="'$(Description)' == ''">
  Silk.NET is a high-speed, advanced library, providing bindings to popular low-level APIs such as OpenGL, OpenCL, OpenAL, OpenXR, GLFW, SDL, Vulkan, Assimp, and DirectX.
  </Description>
  </PropertyGroup>
  <!-- SourceLink -->
- <PropertyGroup Condition="'$(SilkEnableSourceLink)' != '' And '$(SilkSourceLinkExempt)' == ''">
- <PublishRepositoryUrl>true</PublishRepositoryUrl>
- <EmbedUntrackedSources>true</EmbedUntrackedSources>
- <IncludeSymbols>true</IncludeSymbols>
- <SymbolPackageFormat>snupkg</SymbolPackageFormat>
- <IncludePackageReferencesDuringMarkupCompilation>true</IncludePackageReferencesDuringMarkupCompilation>
- <Deterministic>true</Deterministic>
+ <PropertyGroup Condition="'$(SilkSourceLinkExempt)' == ''">
+ <DebugType>portable</DebugType>
  </PropertyGroup>
- <ItemGroup Condition="'$(SilkEnableSourceLink)' != '' And '$(SilkSourceLinkExempt)' == ''">
- <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.0.0" PrivateAssets="All"/>
+ <ItemGroup Condition="'$(SilkSourceLinkExempt)' == ''">
+ <PackageReference Include="DotNet.ReproducibleBuilds" Version="0.1.66" PrivateAssets="All"/>
+ <PackageReference Include="DotNet.ReproducibleBuilds.Isolated" Version="0.1.66" PrivateAssets="All"/>
  </ItemGroup>
- <PropertyGroup Condition="'$(SilkSourceLinkExempt)' != ''">
- <IncludeSymbols>false</IncludeSymbols>
- <SymbolPackageFormat></SymbolPackageFormat>
- </PropertyGroup>
+ <!-- Nuget Icon - done as a target so it doesn't appear in the IDE -->
+ <Target Name="SilkAddIcon" Condition="'$(SilkIconExempt)' == ''">
+ <ItemGroup>
+ <None Include="$(MSBuildThisFileDirectory)../../documentation/readme/silkdotnet_v3.png"
+ Pack="true"
+ PackagePath="\" />
+ </ItemGroup>
+ <PropertyGroup>
+ <PackageIcon>silkdotnet_v3.png</PackageIcon>
+ </PropertyGroup>
+ </Target>
+ <!-- NuGet README -->
+ <Target Name="SilkGenerateNuGetReadme" Condition="'$(SilkReadmeExempt)' == ''">
+ <PropertyGroup>
+ <SilkReadme>$([System.IO.File]::ReadAllText("$(MSBuildThisFileDirectory)../../README.md"))</SilkReadme>
+ <SilkReadme>$([System.String]::Copy($(SilkReadme))
+ .Replace('&lt;!-- Begin exclude from NuGet readme. --&gt;','&lt;!--')
+ .Replace('&lt;!-- End exclude from NuGet readme. --&gt;','--&gt;')
+ .Replace('&lt;!-- Begin include in NuGet readme.','')
+ .Replace('End include in NuGet readme. --&gt;','')
+ .Replace('&lt;h1 align=&quot;center&quot;&gt;', '# ')
+ .Replace('&lt;h2 align=&quot;center&quot;&gt;', '# ')
+ .Replace('&lt;/h1&gt;', '').Replace('&lt;/h2&gt;', '')
+ .Replace('&lt;br /&gt;', '%0a%0a').Replace('&lt;br/&gt;', '%0a%0a')
+ .Replace('&lt;div&gt;', '').Replace('&lt;/div&gt;', '')
+ .Replace('&lt;a&gt;', '').Replace('&lt;/a&gt;', ''))
+ </SilkReadme>
+ <SilkReadmePath>$(IntermediateOutputPath)README.md</SilkReadmePath>
+ </PropertyGroup>
+ <PropertyGroup Condition="'$(SilkDescription)' != ''">
+ <Description>$(SilkDescription) $(Description)</Description>
+ <SilkExtendedDescription>$(SilkDescription) $(SilkExtendedDescription)%0a%0a</SilkExtendedDescription>
+ <SilkReadme>$([System.String]::Copy($(SilkReadme))
+ .Replace('&lt;!-- Package description inserted here automatically. --&gt;',
+ '# About This Package%0a%0a$(SilkExtendedDescription)'))
+ </SilkReadme>
+ </PropertyGroup>
+ <ItemGroup>
+ <SilkReadmeLines Include="$(SilkReadme)" />
+ <SilkReadmeGenerated Include="$(SilkReadmePath)" />
+ </ItemGroup>
+ <WriteLinesToFile File="@(SilkReadmeGenerated)" 
+ Lines="@(SilkReadmeLines)" 
+ Overwrite="true" 
+ Encoding="UTF-8" />
+ <PropertyGroup>
+ <PackageReadmeFile>README.md</PackageReadmeFile>
+ </PropertyGroup>
+ <ItemGroup>
+ <None Include="$(SilkReadmePath)" Pack="true" PackagePath="\" />
+ </ItemGroup>
+ </Target>
 </Project>