Ab4d.SharpEngine 3.1.9300-rc3

• net6.0

  • No dependencies.

• net8.0

  • No dependencies.

• net9.0

  • No dependencies.

Ab4d.SharpEngine v3.1.9300-RC3:
- Fixed disposing Vulkan DescriptorSets in PixelEffect when pixels with textures are rendered.    

   
Ab4d.SharpEngine v3.1.9299 (RC2):
- Fixed applying pre-multiplied alpha value when using StandardEffect. Before the semi-transparent colors may be rendered too dark when using black background color.
- Fixed using KeyboardModifiers for Shift and Alt in PointerCameraController. This bug was introduced in v3.1.9287-RC1.
- Prevented zooming with PointerCameraController when using horizontal scroll wheel.
- Prevented creating too many Vulkan Semaphore and Fence objects when using Avalonia with Vulkan backend.
- Fixed rendering rapidly changing texture that is set to a SolidColorMaterial. Before such texture may be blinking.ž
- By defautl the VK_EXT_custom_border_color extension is not enabled. This may be needed when using ExpandPostProcess and when the SceneView's BackgroundColor is not transparent, white or black but some other custom color. In this case the extension can be enabled by setting the EngineCreateOptions.EnableCustomBorderColors to true.
- Added a default implementation for PngBitmapIO.FileNotFoundResolver that tries to resolve the file name by combining it with the base directory of the application. This can help to load texture from samples if they are specified relative to the output folder and the samples app is not started from the output folder, for example from "dotnet run ." that preserves the CurrentDirectory to the csproj path.
- Improved rendering lines with line caps (e.g. arrows and other line endings): fixed hiding lines with line caps when Visibility is set to Hidden; prevented renderning only line cap when line cap when LineThickness is set to 0; fixed transforming the line with line caps when Transformation is set after the line was already rendered.
- When float color value in Color3 and Color4 is converted into byte value, the byte value is now rounded (using ToArgb, ToBgra, and similar methods). For example, before the 0.25f value was converted into 63 (0.25f * 255f = 63.75f) and now it is converted into 64 (rounded value); now the 0.25f is converted to 64 which is closer to 1/4 * 255.
- Fixed rendering pixles with PixelsNode when per-pixel colors with semi-transparent colors are used. The PixelColors should not be alpha pre-multiplied because they are now pre-multiplied in the shader.

- Improved glTFImporter from Ab4d.SharpEngine.glTF library to support using thrid-party draco compression decoder (for example Openize.Drako). See the updated Importers/GltfImporterExporterSample on how to support Draco compressed glTF files.
   
   
Ab4d.SharpEngine v3.1.9287 (RC1):
- Added support for PostProcess effects. The following post-process effects are included in this version: SobelEdgeDetectionPostProcess, BlackAndWhitePostProcess, ToonShadingPostProcess, GammaCorrectionPostProcess, ColorOverlayPostProcess, ExpandPostProcess and GaussianBlurPostProcess. HsvColorPostProcess is available with full source code in the samples project. To add a post-proces effect, create an instance of a post process class and add it to SceneView.PostProcesses collection.
- Added support for rendering object outlines that can be shown over rendered objects. See the new "Advanced / Outlines over objects" sample.
- Added InstancedTextNode that can render millions of characters by using very efficient mesh instancing.
- Added support for rendering textures on instanced models. To use texture, call the new SetDiffuseTexture method on InstancedMeshNode.
- Added support for rendering textures for each pixel that is rendered by PixelsNode. This can be used to render millions of billboards.
- Added StlImporter and StlExporter that can import and export .stl files.
- Added ObjExporter that can export the Scene or individual SceneNodes to .obj file (note: ObjImporter was already available).
- Added new overloads to GetAllHitObjects method in SceneView and Scene objects. The new overloads take a List of RayHitTestResult as the first parameter. This allows reusing the list and prevents creating a new list on each hit test.
- Added new overload to Scene.GetHitSceneNodeBounds that takes a List of SceneNode as the first parameter.
- Added ModelOptimizer class that can be used to optimize the GroupNode by combining meshes in SceneNodes with the same materials. This can significantly reduce the number of draw calls.
- Added support for rendering wide lines when using macOS. This requires a special build of libMoltenVK.dylib that supports wide lines (see https://github.com/KhronosGroup/MoltenVK#metal_private_api). You can get the precompiled dylib file from the "lib\MoltenVK\macos-arm64_x86_64\widelines-v1.3 folder" in the sample repo.
- Improved VulkanDevice.GetMemoryBudget method to return a list of MemoryHeapBudget records. Each record contains information about the memory heap, its size, used size and available size. The previous method returned the PhysicalDeviceMemoryBudgetPropertiesEXT struct that required unsafe code to be read.
- Added VulkanDevice.GetDeviceLocalMemoryBudget and GetHostVisibleMemoryBudget to easily query for the available memory.
- Improved PointerCameraController when Orthographic camera is used, ZoomMode is set to PointerPosition and the user zooms to an area without any 3D object. Now, the PointerCameraController zooms to a 3D point under the mouse instead of zooming to the center.
- Added CameraController.CustomRotationCenterPositionProvider Func that can be used to provide custom rotation center position and zoom to position when using PointerCameraController. It can be used instead of overriding the virtual GetRotationCenterPositionFromPointerPosition method.
- Improved allocating host memory when GPU runs out of device local memory.
- Added TextureLoader.CreateTextureAsync that takes RawImageData instead of a file name or file stream.
- Improved CreateHeightMapSurfaceMesh method so it correctly defines the Y value for the BoudingBox. Also, the generated mesh is now precisely the required size. Before, the size was smaller for 1 / segments_count.
- Show an error message with detailed instructions when the Vulkan device is not available (for example, when MoltenVK is not present on macOS or iOS).
- Added GpuDevice.OutOfMemoryOccured event. It is triggered when a memory allocation fails with OutOfMemory error. The user can subscribe to this event and manually free the required memory and then set the IsMemoryFreed property to true. This will try to allocate the memory again.
- Added SceneView.DisposeBackBuffers method that can be used to dispose the back buffers (GPU images that are used as render targets).
- Added SharpEngineSceneView.DisposeBackBuffersWhenHidden property that can be used to dispose the back buffers when the control is hidden. This can be used to free memory when the control is not visible. The default value is true.
- To improve memory usage, allocate images bigger than 64 MB to a dedicated memory block (instead of using a shared memory block for multiple images - in this case, some memory may be left unused). The default threshold value is 64 MB. This can be adjusted by changing the static EngineRuntimeOptions.ImageDedicatedMemoryAllocationThreshold.
- Removed setter from Transform.Value property. To set the matrix, use the MatrixTransform and its SetMatrix method.
- Added PngBitmapIO.FileNotSupportedResolver property that can be assigned to a callback function that replaces the unsupported file (not in .png format) to an alternative file in .png file format.
- Added MeshUtils.GetStandardVerticesArray method.
- Added ModelUtils.MakeTwoSidedMaterial and ModelUtils.SetAlphaClipThreshold methods.
- Improved CircleModelNode: added InnerRadius, StartAngle, HeightScaleFactor and TextureMapping properties and set default values to Normal and UpDirection. Added CreateRectangle method to create a rectangle from CircleModelNode. The InnerRadius can be used to create a circle that is hollow in the center. The StartAngle specified the start angle of the first position. HeightScaleFactor can be used to create an ellipse or rectangle (when Segments = 4) with different width and height. The TextureMapping can changed from default Rectangular to RadialFromCenter or RadialFromInnerRadius that can be used to create a radial gradient effect.
- Added an optional isHorizontal parameter to TextureFactory.CreateGradientTexture. It can be set to false to create a vertical texture (size: 1 x textureSize). This is needed to create a radial gradient effect on CircleModelNode.
- Improved MeshFactory.CreateCircleMesh methods by adding innerRadius, startAngle, heightScaleFactor and textureMapping properties
- Added UseTwoSidedMaterials property to ObjImporter.
- Improved LineUtils.GetWireframeLinePositions and EdgeLinesFactory to generate line positions also when the mesh does not have TriangleIndices defined.
- Added static BitmapTextCreator.GetDefaultBitmapFont and BitmapTextCreator.GetDefaultBitmapFontAsync methods.
- Added BitmapFont.GetFontPageGpuImage and BitmapFont.GetFontPageGpuImageAsync methods that can be used to get the GpuImage for the specified font page.
- Added PushConstantsBytes to RenderingItem. It can be used to easily assign push constants that can be used in the shader for a custom effect.
- Added Utilities.GpuSamplerManager.DefaultSampler that can be used to change the default texture sampler (the default semper is set to Mirror).
- Added ToRbgaArray, ToBgraArray and ToArgbArray methods to Color4 and Color3 classes. Also added ToRbgArray and ToBgrArray to Color3 class. Those methods return an array of 4 or 3 bytes with red, green, blue and alpha colors.
- Improved RawImageData by adding a constructor that takes a fillColor and creates a RawImageData with the specified color. Also, added a Clear method to clear the RawImageData and DrawImage method that can draw pixels from one RawImageData to another.

- Improved async methods to run on the UI thread when background upload is not supported (when SynchronizationContext is null).
- Fixed WireBoxNode, CornerWireBoxNode, WireCrossNode, RectangleNode, CircleLineNode, EllipseLineNode and EllipseArcLineNode when only a constructor was used to create the object (no property was set). In this case, the positions were not defined and no object was rendered.
- Fixed rendering MultiLineNode that uses PositionColoredLineMaterial with transparent colors.
- Swap the enum values for the KeyboardModifiers.ShiftKey and KeyboardModifiers.AltKey to match the values in WPF (ModifierKeys) and Avalonia (KeyModifiers). ShiftKey now has a value of 4, and AltKey has a value of 1.
- Fixed MeshFactory.SetBoxVerticesArray method.
- When VK_EXT_pageable_device_local_memory extension is available, then the "No compatible memory type" exception was prevented when resizing the SceneView control, and the GPU ran out of the device's local memory.
- Fixed PngBitmapIO to prevent throwing an exception if there are some invalid chunks present after the "IEND" chunk.
- Fixed PngBitmapIO.SaveBitmap when saving to a file name of an existing file. The new method always creates a new file and does not overwrite the data in the existing file. This prevents that if the exiting file is longer than the new file, then some data are left from the previous file.
- Fixed rendering MultiLineNode with PositionColoredLineMaterial that defines transparent line colors.
- Fixed positioning text when using VectorFontFactory.CreateIndividualTextMeshes and when positionType is not Baseline.
- Fixed rendering SubMeshes in MultiMaterialModelNode when some of them are removed and then added again.
- Fixed ReaderObj when the obj file does not define normals. In this case, they are automatically calculated (this prevents showing black models).
- Fixed setting VertexCount and IndexCount in ModelNode when the positions and triangle indices are defined and not only when the VertexBuffer and IndexBuffer are created.
- Fixed reporting a duplicate number of draw calls, vertex count and some other statistics in RenderingStatistics when CameraAxisPanel or some other Overlay Panel was rendered.
- Fixed using SharpEngineSceneView for WPF when PresentationType is set to OverlayTexture and when SharpEngineSceneView's Visibility is set to Collapsed or Hidden and then back to Visible.
- Prevent "Index out of bounds" exception in EdgeLinesFactory if triangle indices count is not dividable by 3.
- Removed CameraLight when the camera object that created the CameraLight is removed from the SceneView.Camera.
- GpuImage.Resize now resets the CurrentImageLayout, CurrentImageAccessMask and CurrentImageStageMask.

- Renamed parameter name checkMaterials to removeUnusedMaterials in MultiMaterialModelNode.RemoveSubMesh method.
- Renamed the textureWidth to textureSize parameter name in the TextureFactory.CreateGradientTexture method.
- ReaderObj was renamed to ObjImporter. Also, its ReadSceneNodes method was renamed to Import method. This makes the names more consistent with AssimpImporter and glTFImporter. The ReaderObj class and its ReadSceneNodes method are still available but are marked as obsolete.