Added macros for API constants (#393)

Author: MikhailGorobets

Graphics/GraphicsEngine/interface/BottomLevelAS.h

@@ -44,8 +44,9 @@ static const INTERFACE_ID IID_BottomLevelAS =
 
 // clang-format off
 
-static const Uint32 INVALID_INDEX = ~0u;
+#define DILIGENT_INVALID_INDEX 0xFFFFFFFFU
 
+static const Uint32 INVALID_INDEX = DILIGENT_INVALID_INDEX;
 
 /// Defines bottom level acceleration structure triangles description.
 

Graphics/GraphicsEngine/interface/Constants.h

@@ -50,6 +50,12 @@ 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.
+#define DILIGENT_DEFAULT_ADAPTER_ID 0xFFFFFFFFU
+
+/// The special constant for a default queue index.
+#define DILIGENT_DEFAULT_QUEUE_ID 0xFF
+
 /// The maximum number of shading rate modes.
 #define DILIGENT_MAX_SHADING_RATES 9
 
@@ -61,8 +67,8 @@ static const Uint32 MAX_RENDER_TARGETS      = DILIGENT_MAX_RENDER_TARGETS;
 static const Uint32 MAX_VIEWPORTS           = DILIGENT_MAX_VIEWPORTS;
 static const Uint32 MAX_RESOURCE_SIGNATURES = DILIGENT_MAX_RESOURCE_SIGNATURES;
 static const Uint32 MAX_ADAPTER_QUEUES      = DILIGENT_MAX_ADAPTER_QUEUES;
-static const Uint32 DEFAULT_ADAPTER_ID      = 0xFFFFFFFFU;
-static const Uint8  DEFAULT_QUEUE_ID        = 0xFF;
+static const Uint32 DEFAULT_ADAPTER_ID      = DILIGENT_DEFAULT_ADAPTER_ID;
+static const Uint8  DEFAULT_QUEUE_ID        = DILIGENT_DEFAULT_QUEUE_ID;
 static const Uint32 MAX_SHADING_RATES       = DILIGENT_MAX_SHADING_RATES;
 static const Uint32 SHADING_RATE_X_SHIFT    = DILIGENT_SHADING_RATE_X_SHIFT;
 

Graphics/GraphicsEngine/interface/DeviceContext.h

@@ -1861,9 +1861,14 @@ struct BindSparseResourceMemoryAttribs
 };
 typedef struct BindSparseResourceMemoryAttribs BindSparseResourceMemoryAttribs;
 
+/// The special constant for all remaining mipmap levels.
+#define DILIGENT_REMAINING_MIP_LEVELS 0xFFFFFFFFU
 
-static const Uint32 REMAINING_MIP_LEVELS   = ~0u;
-static const Uint32 REMAINING_ARRAY_SLICES = ~0u;
+/// The special constant for all remaining array slices.
+#define DILIGENT_REMAINING_ARRAY_SLICES 0xFFFFFFFFU
+
+static const Uint32 REMAINING_MIP_LEVELS   = DILIGENT_REMAINING_MIP_LEVELS;
+static const Uint32 REMAINING_ARRAY_SLICES = DILIGENT_REMAINING_ARRAY_SLICES;
 
 /// Resource state transition flags.
 DILIGENT_TYPED_ENUM(STATE_TRANSITION_FLAGS, Uint8)

Graphics/GraphicsEngine/interface/InputLayout.h

@@ -36,10 +36,18 @@
 
 DILIGENT_BEGIN_NAMESPACE(Diligent)
 
+/// The maximum number of layout elements.
+#define DILIGENT_MAX_LAYOUT_ELEMENTS 16
 
-static const Uint32 MAX_LAYOUT_ELEMENTS        = 16;
-static const Uint32 LAYOUT_ELEMENT_AUTO_OFFSET = 0xFFFFFFFF;
-static const Uint32 LAYOUT_ELEMENT_AUTO_STRIDE = 0xFFFFFFFF;
+/// See Diligent::LayoutElement::RelativeOffset for details.
+#define DILIGENT_LAYOUT_ELEMENT_AUTO_OFFSET 0xFFFFFFFFU
+
+/// See Diligen::LayoutElement::Stride for details.
+#define DILIGENT_LAYOUT_ELEMENT_AUTO_STRIDE 0xFFFFFFFFU
+
+static const Uint32 MAX_LAYOUT_ELEMENTS        = DILIGENT_MAX_LAYOUT_ELEMENTS;
+static const Uint32 LAYOUT_ELEMENT_AUTO_OFFSET = DILIGENT_LAYOUT_ELEMENT_AUTO_OFFSET;
+static const Uint32 LAYOUT_ELEMENT_AUTO_STRIDE = DILIGENT_LAYOUT_ELEMENT_AUTO_STRIDE;
 
 /// Input frequency
 DILIGENT_TYPED_ENUM(INPUT_ELEMENT_FREQUENCY, Uint8)

Graphics/GraphicsEngine/interface/RenderPass.h

@@ -149,7 +149,10 @@ struct RenderPassAttachmentDesc
 };
 typedef struct RenderPassAttachmentDesc RenderPassAttachmentDesc;
 
-#define ATTACHMENT_UNUSED (~0U)
+/// The special constant indicating that a render pass attachment is not used.
+#define DILIGENT_ATTACHMENT_UNUSED 0xFFFFFFFFU
+
+static const Uint32 ATTACHMENT_UNUSED = DILIGENT_ATTACHMENT_UNUSED;
 
 /// Attachment reference description.
 struct AttachmentReference
@@ -352,8 +355,10 @@ struct SubpassDesc
 };
 typedef struct SubpassDesc SubpassDesc;
 
+/// The special subpass index value expanding synchronization scope outside a subpass.
+#define DILIGENT_SUBPASS_EXTERNAL 0xFFFFFFFFU
 
-#define SUBPASS_EXTERNAL (~0U)
+static const Uint32 SUBPASS_EXTERNAL = DILIGENT_SUBPASS_EXTERNAL;
 
 /// Subpass dependency description
 struct SubpassDependencyDesc