hlsl51: unify shader input semantics and update docs

Author: halx99

1k/build.profiles

@@ -6,7 +6,7 @@
 # --- region platfom:common
 
 # The Axmol HLSL-first cross-platform shader compiler
-axslcc=3.99.2
+axslcc=3.99.0
 
 # The cmake, @gradle @axmol-cmdline
 # as latest as possible

axmol/renderer/shaders/base.hlsli

@@ -45,43 +45,38 @@
 //------------------------------------------------------------------------------
 
 // --- Linear sampling ---
-SamplerState LinearClamp : register(s0, space1);
-SamplerState LinearWrap : register(s1, space1);
-SamplerState LinearMirror : register(s2, space1);
-SamplerState LinearBorder : register(s3, space1);
+SamplerState LinearClamp;
+SamplerState LinearWrap;
+SamplerState LinearMirror;
+SamplerState LinearBorder;
 
 // --- Point sampling ---
-SamplerState PointClamp : register(s4, space1);
-SamplerState PointWrap : register(s5, space1);
-SamplerState PointMirror : register(s6, space1);
-SamplerState PointBorder : register(s7, space1);
+SamplerState PointClamp;
+SamplerState PointWrap;
+SamplerState PointMirror;
+SamplerState PointBorder;
 
 // --- Linear + Mipmap ---
-SamplerState LinearMipClamp : register(s8, space1);
-SamplerState LinearMipWrap : register(s9, space1);
-SamplerState LinearMipMirror : register(s10, space1);
-SamplerState LinearMipBorder : register(s11, space1);
+SamplerState LinearMipClamp;
+SamplerState LinearMipWrap;
+SamplerState LinearMipMirror;
+SamplerState LinearMipBorder;
 
 // --- Anisotropic filtering ---
-SamplerState AnisoClamp : register(s12, space1);
-SamplerState AnisoWrap : register(s13, space1);
-SamplerState AnisoMirror : register(s14, space1);
-SamplerState AnisoBorder : register(s15, space1);
+SamplerState AnisoClamp;
+SamplerState AnisoWrap;
+SamplerState AnisoMirror;
+SamplerState AnisoBorder;
 
 // --- Depth comparison samplers ---
-SamplerComparisonState ShadowCmpClamp : register(s16, space1);
-SamplerComparisonState ShadowCmpWrap : register(s17, space1);
-SamplerComparisonState ShadowCmpMirror : register(s18, space1);
-SamplerComparisonState ShadowCmpBorder : register(s19, space1);
+SamplerComparisonState ShadowCmpClamp;
+SamplerComparisonState ShadowCmpWrap;
+SamplerComparisonState ShadowCmpMirror;
+SamplerComparisonState ShadowCmpBorder;
 
 // --- Special cases ---
-SamplerState LinearNoMipClamp : register(s20, space1);
-SamplerState PointNoMipClamp : register(s21, space1);
-
-// s0-s21: predefined shader samplers
-// s22-s31: reserved
-// s32+: texture-owned samplers
-#define AX_TEXTURE_SAMPLER_BASE 32
+SamplerState LinearNoMipClamp;
+SamplerState PointNoMipClamp;
 
 //------------------------------------------------------------------------------
 // GPU Instancing

axmol/renderer/shaders/cameraClear_vs.hlsl

@@ -12,7 +12,7 @@ struct VS_OUT {
     float4 position : SV_Position;
 };
 
-cbuffer vs_ub : register(b0, space0) {
+cbuffer vs_ub {
     float depth;
 };
 

axmol/renderer/shaders/colorNormalTexture_fs.hlsl

@@ -15,13 +15,13 @@ struct PS_IN {
 #endif
 };
 
-Texture2D u_tex0 : register(t0, space1);
+Texture2D u_tex0;
 
 #ifdef USE_NORMAL_MAPPING
-Texture2D u_normalTex : register(t1, space1);
+Texture2D u_normalTex;
 #endif
 
-cbuffer fs_ub : register(b1, space0) {
+cbuffer fs_ub {
     vvec3_def(u_DirLightSourceColor, MAX_DIRECTIONAL_LIGHT_NUM);
     vvec3_def(u_DirLightSourceDirection, MAX_DIRECTIONAL_LIGHT_NUM);
     vvec3_def(u_PointLightSourceColor, MAX_POINT_LIGHT_NUM);

axmol/renderer/shaders/colorNormal_fs.hlsl

@@ -7,7 +7,7 @@ struct PS_IN {
     float3 v_normal : NORMAL;
 };
 
-cbuffer fs_ub : register(b1, space0) {
+cbuffer fs_ub {
     vvec3_def(u_DirLightSourceColor, MAX_DIRECTIONAL_LIGHT_NUM);
     vvec3_def(u_DirLightSourceDirection, MAX_DIRECTIONAL_LIGHT_NUM);
     vvec3_def(u_PointLightSourceColor, MAX_POINT_LIGHT_NUM);

axmol/renderer/shaders/colorTexture_fs.hlsl

@@ -4,11 +4,11 @@ struct PS_IN {
     float2 v_texCoord : TEXCOORD0;
 };
 
-cbuffer fs_ub : register(b1, space0) {
+cbuffer fs_ub {
     float4 u_color;
 };
 
-Texture2D u_tex0 : register(t0, space1);
+Texture2D u_tex0;
 
 float4 main(PS_IN input) : SV_Target0
 {

axmol/renderer/shaders/color_fs.hlsl

@@ -1,4 +1,4 @@
-cbuffer fs_ub : register(b1, space0) {
+cbuffer fs_ub {
     float4 u_color;
 };
 

axmol/renderer/shaders/dualSampler_fs.hlsl

@@ -5,7 +5,7 @@ struct PS_IN {
     float2 v_texCoord : TEXCOORD0;
 };
 
-Texture2DArray u_tex0 : register(t0, space1);
+Texture2DArray u_tex0;
 
 float4 main(PS_IN input) : SV_Target0
 {

axmol/renderer/shaders/dualSampler_gray_fs.hlsl

@@ -5,7 +5,7 @@ struct PS_IN {
     float2 v_texCoord : TEXCOORD0;
 };
 
-Texture2DArray u_tex0 : register(t0, space1);
+Texture2DArray u_tex0;
 
 float4 main(PS_IN input) : SV_Target0
 {

axmol/renderer/shaders/dualSampler_hsv_fs.hlsl

@@ -7,9 +7,9 @@ struct PS_IN {
     float2 v_texCoord : TEXCOORD0;
 };
 
-Texture2DArray u_tex0 : register(t0, space1);
+Texture2DArray u_tex0;
 
-cbuffer fs_ub : register(b1, space0) {
+cbuffer fs_ub {
     float3 u_hsv;
 };