 | |
Gpu | |
GpuImage represents an image that is stored in the graphics card's memory.
Inheritance HierarchySystemObject
Ab4d.SharpEngine.CoreComponentBase
Ab4d.SharpEngine.CoreGpuDeviceComponent
Ab4d.SharpEngine.CoreGpuImage
Ab4d.SharpEngine.CoreComponentBase
Ab4d.SharpEngine.CoreGpuDeviceComponent
Ab4d.SharpEngine.CoreGpuImage
Namespace: Ab4d.SharpEngine.Core
Assembly: Ab4d.SharpEngine (in Ab4d.SharpEngine.dll) Version: 1.0.8740+deb2991acfe86a95cca780cd4f82bcae2805c1a5
SyntaxC#
public class GpuImage : GpuDeviceComponent, IDisposable
The GpuImage type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | GpuImage(VulkanDevice, RawImageData, Boolean, String) | Constructor |
| GpuImage(VulkanDevice, RawImageData, Boolean, Boolean, ImageUsageFlags, AccessFlags, ImageLayout, PipelineStageFlags, String) | Constructor |
| GpuImage(VulkanDevice, Int32, Int32, Format, ImageUsageFlags, MemoryPropertyFlags, Int32, SampleCountFlags, ImageTiling, ImageLayout, ImageAspectFlags, Boolean, Int32, Boolean, String) | Constructor that created a gpu image and allocates its memory based on the image parameters. |
Properties| Name | Description | |
|---|---|---|
 | HasTransparentPixels | Gets or sets (only at init time) a Boolean that indicates that the GpuImage has some transparent pixels, e. g. pixels with alpha color smaller than 1. This means that to show this GpuImage correctly some alpha-blending technique is required. |
| Height | Height of the image in pixels |
| Image | Gets the Vulkan Image. |
| ImageMemory | Gets the VulkanMemoryInfo that represents the memory location of the buffer |
| ImageView | Gets the Vulkan ImageView. |
| IsGpuDeviceCached | Gets a Boolean that indicates that this GpuImage is cashed by the GpuDevice objects and cannot be disposed by calling Dispose method. This means the GpuImage can be shared without worrying that someone will dispose this GpuImage or that it will be disposed when the Scene is disposed. This flag is set when the GpuImage is cached by calling CacheObject(String, Object) method. By default the Source is used as the cache key. The GpuImage will be disposed when the GpuDevice will be disposed or if it is removed from the cache and then disposed. |
| IsPreMultipliedAlpha | Gets or sets (only at init time) a Boolean that indicates that the colors in this GpuImage are alpha-premultiplied. This means that the red, green and blue values are multiplied by the alpha value. |
| IsSceneCached | Gets a Boolean that indicates that this GpuImage is cashed by Scene objects and cannot be disposed by calling Dispose method. This means the GpuImage can be shared without worrying that someone will dispose this GpuImage. This flag is set when the GpuImage is cached by calling Scene.CacheObject(String, Object) method. By default the Source is used as the cache key. The GpuImage will be disposed when the Scene will be disposed or if it is removed from the cache and then disposed. |
| MemorySize | User memory size in bytes |
| Source | Source can contain file name or other string that defines the source of this GpuImage. |
| Width | Width of the image in pixels |
Methods| Name | Description | |
|---|---|---|
| CopyDataFromImage | Copies data from image to the specified byte array. |
| CopyDataToImage(Byte) | Copies the data from the specified byte array to this image. |
| CopyDataToImage(Byte, Boolean) | Copies the data from the specified byte array to this image. |
| CopyDataToImage(Byte, ImageLayout, AccessFlags, PipelineStageFlags) | Copies the data from the specified byte array to this image and set the layout of the image to the specified values. |
| CopyDataToImageMipMaps | Copies the data from the array of byte array to the mip maps of this image. |
| Dispose | |
 | Dispose(Boolean) |
Dispose
(Overrides ComponentBaseDispose(Boolean)) |
| GetCurrentImageLayoutAndFlags | Gets the current image layout |
 | GetImageAspectFlags | Returns the ImageAspectFlags for the specified format. |
| GetImageLayout | Returns information about the layout of the image for the specified mip level. |
| GetImageRowStride | Returns a row stride (number of bytes in one row of image data) of the image for the specified mip level. |
| GetMappedMemoryPtr | Returns an IntPtr of the mapped memory. The IntPtr can be used to get the content of this image or to copy new content to that location. After using the memory call UnmapMemory method. |
| GetMappedMemoryPtr(Int64, Int64) | Returns an IntPtr of the mapped memory with specified offset and size. The IntPtr can be used to get the content of this image or to copy new content to that location. After using the memory call UnmapMemory method. |
| GetMappedMemorySpan | Returns a Span that can be used to get the content of this image or copy new content to that location. After using the memory call UnmapMemory method. |
| GetMappedMemorySpan(Void, Byte) | |
| Resize | Resizes this image |
| ToString | (Overrides ObjectToString) |
| UnmapMemory | Unmaps the memory that was mapped by calling GetMappedMemoryPtr. |
Fields| Name | Description | |
|---|---|---|
 | ImageCreateInfo | Gets the ImageCreateInfo that was used to create this GpuImage |
See Also