Changes

== Geometry shader Shader registers ==

=== GPUREG_GSH_BOOLUNIFORM GPUREG_''SH''_BOOLUNIFORM ===

| unsigned, Value of geometry shader unit's Boolean register b0 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b1 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b2 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b3 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b4 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b5 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b6 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b7 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b8 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b9 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b10 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b11 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b12 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b13 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b14 boolean register. value (0=truefalse, 1=falsetrue)

| unsigned, Value of geometry shader unit's Boolean register b15 boolean register. value (0=truefalse, 1=falsetrue)

| Unknown. This seems to always be set to 0x7FFF, and other values may cause the GPU to hang

This register is used to set the geometry a shader unit's boolean registers.

=== GPUREG_GSH_INTUNIFORM_I0 GPUREG_''SH''_INTUNIFORM_I''i'' ===

| unsigned, Value for geometry shaderInteger register i's i0.x'i'' X value

| unsigned, Value for geometry shaderInteger register i's i0.y'i'' Y value

| unsigned, Value for geometry shaderInteger register i's i0.z'i'' Z value

| unsigned, Value for geometry shaderInteger register i's i0.w'i'' W value

This register is These registers are used to set the geometry a shaderunit's i0 integer registerregisters.

=== GPUREG_GSH_INTUNIFORM_I1 GPUREG_''SH''_INPUTBUFFER_CONFIG ===

| 0-73| unsigned, Value for geometry shader's i1.xInput vertex attributes - 1

| unsigned, Value for Use reserved geometry shadersubdivision (0 = don's i1.yt use, 1 = use) (always 0 for vertex shaders)

| unsigned, Value for geometry shader's i1.z0x0

| unsigned, Value for Use geometry shader(0x8 = use, 0xA0 = don's i1.wt use) (always 0xA0 for vertex shaders)

This register is used to set the geometry configure a shaderunit's i1 integer registerinput buffer.

=== GPUREG_GSH_INTUNIFORM_I2 GPUREG_''SH''_ENTRYPOINT ===

| 0-715| unsigned, Value for geometry shader's i2.xCode entry point offset, in 32-bit words

| 8-15| unsigned, Value for geometry shader's i2.y|-| 16-23| unsigned, Value for geometry shader's i2.z|-| 24-31| unsigned, Value for geometry shader's i2.w|} This register is used to set the geometry shader's i2 integer register. === GPUREG_GSH_INTUNIFORM_I3 === {| class="wikitable" border="1"! Bits! Description|-| 0-7| unsigned, Value for geometry shader's i3.x|-| 8-15| unsigned, Value for geometry shader's i3.y|-| 16-23| unsigned, Value for geometry shader's i3.z|-| 24-31| unsigned, Value for geometry shader's i3.w|} This register is used to set the geometry shader's i3 integer register. === GPUREG_GSH_INPUTBUFFER_CONFIG === {| class="wikitable" border="1"! Bits! Description|-| 0-7| unsigned, Input buffer stride minus 1, in float vec4 registers. (value 0 means a stride of 1 float vec4 register)|-| 8-23| Unknown. These bits typically aren't updated by games.|-| 24-31| Unknown. This is typically set to 8 for geometry shaders.0x7FFF

This register is used to configure the geometry sets a shaderunit's input buffer. In the context of a geometry shader, the stride parameter can be interpreted as the input primitive size in registers, though it is not a limit on the number of input registers which can be accessed from the geometry shadercode entry point.

=== GPUREG_GSH_ENTRYPOINT === {| class="wikitable" border="1"! Bits! Description|-| 0-15| unsignedFor vertex shaders, Geometry shader unit entrypoint, in words.|-| 16-31| Unknown. This seems to always be set to 0x7FFF, and other values may cause the GPU to hang|} This this sets the entrypoint entry point for the program running on the single shader unit which can be dedicated units set to running geometry shaders, regardless of vertex shader mode. Depending on the current geometry stage mode. This is means that while this register is normally used to set the geometry shader entrypoint, it can also be used to set this single shader unit to run from a different entrypoint than the other three even when running a vertex include either all 4 shaderunits or just 3 of them.

=== GPUREG_GSH_ATTRIBUTES_PERMUTATION_LOW GPUREG_''SH''_ATTRIBUTES_PERMUTATION_LOW ===

| unsigned, Index of geometry shader Vertex attribute 0 input register which the 1st attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 1 input register which the 2nd attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 2 input register which the 3rd attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 3 input register which the 4th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 4 input register which the 5th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 5 input register which the 6th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 6 input register which the 7th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 7 input register which the 8th attribute will be stored in.index

This register sets the geometry shader unit input register index which will correspond to each attribute contained by the input buffer (which in the case of geometry shaders is the vertex shader output buffer) for the first 8 attributes.For example, having bits 0-3 set to 5 means that, in the geometry shader program, v5 will contain the input buffer's 1st attribute.

=== GPUREG_GSH_ATTRIBUTES_PERMUTATION_HIGH GPUREG_''SH''_ATTRIBUTES_PERMUTATION_HIGH ===

| unsigned, Index of geometry shader Vertex attribute 8 input register which the 9th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 9 input register which the 10th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 10 input register which the 11th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 11 input register which the 12th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 12 input register which the 13th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 13 input register which the 14th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 14 input register which the 15th attribute will be stored in.index

| unsigned, Index of geometry shader Vertex attribute 15 input register which the 16th attribute will be stored in.index

This register sets the geometry shader unit input register index which will correspond to each attribute contained by the input buffer (which in the case of geometry shaders is the vertex shader output buffer) for attributes 8 through 15.For example, having bits 0-3 set to 5 means that, in the geometry shader program, v5 will contain the input buffer's 9th attribute.

=== GPUREG_GSH_OUTMAP_MASK GPUREG_''SH''_OUTMAP_MASK ===

| unsigned, Enable bit for geometry shader's o0 output Output register. (1 = o0 enabled, (0 = o0 disabled, 1 = enabled)

| unsigned, Enable bit for geometry shader's o1 output Output register. (1 = o1 enabled, (0 = o1 disabled, 1 = enabled)

| unsigned, Enable bit for geometry shader's o2 output Output register. (1 = o2 enabled, (0 = o2 disabled, 1 = enabled)

| unsigned, Enable bit for geometry shader's o3 output Output register. (1 = o3 enabled, (0 = o3 disabled, 1 = enabled)

| unsigned, Enable bit for geometry shader's o4 output Output register. (1 = o4 enabled, (0 = o4 disabled, 1 = enabled)

| unsigned, Enable bit for geometry shader's o5 output Output register. (1 = o5 enabled, (0 = o5 disabled, 1 = enabled)

| unsigned, Enable bit for geometry Output register o6 enabled (0 = disabled, 1 = enabled)|-| 7| unsigned, Output register o7 enabled (0 = disabled, 1 = enabled) (vertex shader only)|-| 8| unsigned, Output register o8 enabled (0 = disabled, 1 = enabled) (vertex shader's o6 output only)|-| 9| unsigned, Output register o9 enabled (0 = disabled, 1 = enabled) (vertex shader only)|-| 10| unsigned, Output register o10 enabled (0 = disabled, 1 = enabled) (vertex shader only)|-| 11| unsigned, Output register o11 enabled (0 = disabled, 1 = enabled) (vertex shader only)|-| 12| unsigned, Output register o12 enabled (0 = disabled, 1 = enabled) (vertex shader only)|-| 13| unsigned, Output register o13 enabled (0 = disabled, 1 = enabled) (vertex shader only)|-| 14| unsigned, Output register. o14 enabled (0 = disabled, 1 = o6 enabled) (vertex shader only)|-| 15| unsigned, Output register o15 enabled (0 = o6 disabled, 1 = enabled) (vertex shader only)|-| 16-31| 0x0

This register toggles the geometry a shader unit's output registers.

=== GPUREG_GSH_CODETRANSFER_END GPUREG_''SH''_CODETRANSFER_END ===

| 0-31| unsigned, Code data Signal transfer end (0 = idle, non-zero = signal bit.)

This register's value should be set to 1 in order to finalize the transfer of geometry shader code. It is unknown whether this register is used for other functions.

=== GPUREG_GSH_FLOATUNIFORM_CONFIG GPUREG_''SH''_FLOATUNIFORM_INDEX ===

| 0-67| unsigned, Target float vec4 geometry shader uniform ID for transfer. floating-point register index (range 0-95, where 0 = c0 and 95 = c95)

| unsigned, Float vec4 geometry shader uniform data transfer Transfer mode. (0 = float24float1.7.16, 1 = float32float1.8.23)

This register sets the shader unit's target float vec4 geometry shader uniform ID floating-point register and transfer mode for the data transfer system. As such it is typically used right before [[#GPUREG_GSH_FLOATUNIFORM_DATAGPUREG_SH_FLOATUNIFORM_DATAi|GPUREG_GSH_FLOATUNIFORM_DATAGPUREG_''SH''_FLOATUNIFORM_DATA''i'']], though writing to one register does not make writing to the other mandatory.

=== GPUREG_GSH_FLOATUNIFORM_DATA GPUREG_''SH''_FLOATUNIFORM_DATA''i'' ===

| Float vec4 geometry shader uniform Floating-point register component data. (format depends on transfer mode, see below for details)

This register is used to set the value components of float vec4 geometry a shader uniform unit's floating-point registers, each having 4 components. The data format which should be written to it depends on the transfer mode set with [[#GPUREG_GSH_FLOATUNIFORM_CONFIGGPUREG_SH_FLOATUNIFORM_INDEX|GPUREG_GSH_FLOATUNIFORM_CONFIGGPUREG_''SH''_FLOATUNIFORM_INDEX]]. This register functions as a FIFO queue : after each time a 4-component uniform register is successfully set, the target uniform ID value register index is incremented, meaning that groups of uniforms with contiguous register IDs can be set with only one initial write to [[#GPUREG_GSH_FLOATUNIFORM_CONFIGGPUREG_SH_FLOATUNIFORM_INDEX|GPUREG_GSH_FLOATUNIFORM_CONFIGGPUREG_''SH''_FLOATUNIFORM_INDEX]].

* In the case of float24 transfer mode, data should be sent by writing three words which are the concatenation of the float24 value of the uniform register's 4 components, in the reverse order. Assuming each letter corresponds to 4 bits, the format becomes :

=== GPUREG_GSH_CODETRANSFER_CONFIG GPUREG_''SH''_CODETRANSFER_INDEX ===

| unsigned, Target geometry shader code offset for data transfer.

This register is used to set the offset at which upcoming geometry shader code data transferred through [[#GPUREG_GSH_CODETRANSFER_DATAGPUREG_SH_CODETRANSFER_DATAi|GPUREG_GSH_CODETRANSFER_DATAGPUREG_''SH''_CODETRANSFER_DATA''i'']] should be written. NOTE : as we do not yet know what a shader program's maximum size is yet, we also do not know how many bits the code offset parameter holds. The biggest shader binary observed so far was 2422 instructions long. The [[Shader_Instruction_Set#Instruction_formats|shader control flow instructions]] only have room to address 12 bits though, so it's likely that the maximum is 4095.

=== GPUREG_GSH_CODETRANSFER_DATA GPUREG_''SH''_CODETRANSFER_DATA''i'' ===

| unsigned, Geometry shader Shader instruction data.

This register is used to transfer geometry shader code data. This register behaves as a FIFO queue : each write to this register writes the provided value to the GPU geometry shader code memory bank at the offset initially set by [[#GPUREG_GSH_CODETRANSFER_CONFIGGPUREG_SH_CODETRANSFER_INDEX|GPUREG_GSH_CODETRANSFER_CONFIGGPUREG_''SH''_CODETRANSFER_INDEX]]. The offset in question is incremented after each write to this register.

=== GPUREG_GSH_OPDESCS_CONFIG GPUREG_''SH''_OPDESCS_INDEX ===

| 0-611| unsigned, Target geometry shader operand descriptor offset for data transfer.

This register is used to set the offset at which upcoming geometry shader operand descriptor data transferred through [[#GPUREG_GSH_OPDESCS_DATAGPUREG_SH_OPDESCS_DATAi|GPUREG_GSH_OPDESCS_DATAGPUREG_''SH''_OPDESCS_DATA''i'']] should be written.

=== GPUREG_GSH_OPDESCS_DATA GPUREG_''SH''_OPDESCS_DATA''i'' ===

| unsigned, Geometry shader Shader operand descriptor data.

This register is used to transfer geometry shader operand descriptor data. This register behaves as a FIFO queue : each write to this register writes the provided value to the GPU geometry shader operand descriptor memory bank at the offset initially set by [[#GPUREG_GSH_OPDESCS_CONFIGGPUREG_SH_OPDESCS_INDEX|GPUREG_GSH_OPDESCS_CONFIGGPUREG_''SH''_OPDESCS_INDEX]]. The offset in question is incremented after each write to this register.