Added a few more macros for API constants, updated comments (close #395)

Author: MikhailGorobets

Graphics/GraphicsEngine/interface/Constants.h

@@ -50,10 +50,10 @@ DILIGENT_BEGIN_NAMESPACE(Diligent)
 /// The maximum number of queues in graphics adapter description.
 #define DILIGENT_MAX_ADAPTER_QUEUES 16
 
-/// The special constant for a default adapter index.
+/// Special constant for the default adapter index.
 #define DILIGENT_DEFAULT_ADAPTER_ID 0xFFFFFFFFU
 
-/// The special constant for a default queue index.
+/// Special constant for the default queue index.
 #define DILIGENT_DEFAULT_QUEUE_ID 0xFF
 
 /// The maximum number of shading rate modes.

Graphics/GraphicsEngine/interface/DeviceContext.h

@@ -1264,7 +1264,10 @@ typedef struct BuildBLASAttribs BuildBLASAttribs;
 ///         Instance.ContributionToHitGroupIndex = InstanceOffset;
 ///         if (BindingMode == HIT_GROUP_BINDING_MODE_PER_GEOMETRY) InstanceOffset += Instance.pBLAS->GeometryCount() * HitGroupStride;
 ///         if (BindingMode == HIT_GROUP_BINDING_MODE_PER_INSTANCE) InstanceOffset += HitGroupStride;
-static const Uint32 TLAS_INSTANCE_OFFSET_AUTO = ~0u;
+
+#define DILIGENT_TLAS_INSTANCE_OFFSET_AUTO 0xFFFFFFFFU
+
+static const Uint32 TLAS_INSTANCE_OFFSET_AUTO = DILIGENT_TLAS_INSTANCE_OFFSET_AUTO;
 
 
 /// Row-major matrix
@@ -1354,7 +1357,10 @@ typedef struct TLASBuildInstanceData TLASBuildInstanceData;
 
 /// Top-level AS instance size in bytes in GPU side.
 /// Used to calculate size of BuildTLASAttribs::pInstanceBuffer.
-static const Uint32 TLAS_INSTANCE_DATA_SIZE = 64;
+
+#define DILIGENT_TLAS_INSTANCE_DATA_SIZE 64
+
+static const Uint32 TLAS_INSTANCE_DATA_SIZE = DILIGENT_TLAS_INSTANCE_DATA_SIZE;
 
 
 /// This structure is used by IDeviceContext::BuildTLAS().
@@ -1861,10 +1867,10 @@ struct BindSparseResourceMemoryAttribs
 };
 typedef struct BindSparseResourceMemoryAttribs BindSparseResourceMemoryAttribs;
 
-/// The special constant for all remaining mipmap levels.
+/// Special constant for all remaining mipmap levels.
 #define DILIGENT_REMAINING_MIP_LEVELS 0xFFFFFFFFU
 
-/// The special constant for all remaining array slices.
+/// Special constant for all remaining array slices.
 #define DILIGENT_REMAINING_ARRAY_SLICES 0xFFFFFFFFU
 
 static const Uint32 REMAINING_MIP_LEVELS   = DILIGENT_REMAINING_MIP_LEVELS;

Graphics/GraphicsEngine/interface/InputLayout.h

@@ -39,10 +39,10 @@ DILIGENT_BEGIN_NAMESPACE(Diligent)
 /// The maximum number of layout elements.
 #define DILIGENT_MAX_LAYOUT_ELEMENTS 16
 
-/// See Diligent::LayoutElement::RelativeOffset for details.
+/// Compute layout element offset automatically, see Diligent::LayoutElement::RelativeOffset for details.
 #define DILIGENT_LAYOUT_ELEMENT_AUTO_OFFSET 0xFFFFFFFFU
 
-/// See Diligen::LayoutElement::Stride for details.
+/// Compute layout element stride automatically, see Diligen::LayoutElement::Stride for details.
 #define DILIGENT_LAYOUT_ELEMENT_AUTO_STRIDE 0xFFFFFFFFU
 
 static const Uint32 MAX_LAYOUT_ELEMENTS        = DILIGENT_MAX_LAYOUT_ELEMENTS;

Graphics/GraphicsEngine/interface/RenderPass.h

@@ -149,7 +149,7 @@ struct RenderPassAttachmentDesc
 };
 typedef struct RenderPassAttachmentDesc RenderPassAttachmentDesc;
 
-/// The special constant indicating that a render pass attachment is not used.
+/// Special constant indicating that the render pass attachment is not used.
 #define DILIGENT_ATTACHMENT_UNUSED 0xFFFFFFFFU
 
 static const Uint32 ATTACHMENT_UNUSED = DILIGENT_ATTACHMENT_UNUSED;
@@ -355,7 +355,7 @@ struct SubpassDesc
 };
 typedef struct SubpassDesc SubpassDesc;
 
-/// The special subpass index value expanding synchronization scope outside a subpass.
+/// Special subpass index value expanding synchronization scope outside a subpass.
 #define DILIGENT_SUBPASS_EXTERNAL 0xFFFFFFFFU
 
 static const Uint32 SUBPASS_EXTERNAL = DILIGENT_SUBPASS_EXTERNAL;