mirror of
				https://github.com/PabloMK7/citra.git
				synced 2025-10-31 22:00:05 +00:00 
			
		
		
		
	gl_shader_gen: Add additional function documentation.
This commit is contained in:
		
							parent
							
								
									2a0a86f629
								
							
						
					
					
						commit
						4b5141954e
					
				
					 2 changed files with 18 additions and 0 deletions
				
			
		|  | @ -11,6 +11,7 @@ using TevStageConfig = Regs::TevStageConfig; | |||
| 
 | ||||
| namespace GLShader { | ||||
| 
 | ||||
| /// Detects if a TEV stage is configured to be skipped (to avoid generating unnecessary code)
 | ||||
| static bool IsPassThroughTevStage(const TevStageConfig& stage) { | ||||
|     return (stage.color_op             == TevStageConfig::Operation::Replace && | ||||
|             stage.alpha_op             == TevStageConfig::Operation::Replace && | ||||
|  | @ -22,6 +23,7 @@ static bool IsPassThroughTevStage(const TevStageConfig& stage) { | |||
|             stage.GetAlphaMultiplier() == 1); | ||||
| } | ||||
| 
 | ||||
| /// Writes the specified TEV stage source component(s)
 | ||||
| static void AppendSource(std::string& out, TevStageConfig::Source source, | ||||
|         const std::string& index_name) { | ||||
|     using Source = TevStageConfig::Source; | ||||
|  | @ -62,6 +64,7 @@ static void AppendSource(std::string& out, TevStageConfig::Source source, | |||
|     } | ||||
| } | ||||
| 
 | ||||
| /// Writes the color components to use for the specified TEV stage color modifier
 | ||||
| static void AppendColorModifier(std::string& out, TevStageConfig::ColorModifier modifier, | ||||
|         TevStageConfig::Source source, const std::string& index_name) { | ||||
|     using ColorModifier = TevStageConfig::ColorModifier; | ||||
|  | @ -118,6 +121,7 @@ static void AppendColorModifier(std::string& out, TevStageConfig::ColorModifier | |||
|     } | ||||
| } | ||||
| 
 | ||||
| /// Writes the alpha component to use for the specified TEV stage alpha modifier
 | ||||
| static void AppendAlphaModifier(std::string& out, TevStageConfig::AlphaModifier modifier, | ||||
|         TevStageConfig::Source source, const std::string& index_name) { | ||||
|     using AlphaModifier = TevStageConfig::AlphaModifier; | ||||
|  | @ -165,6 +169,7 @@ static void AppendAlphaModifier(std::string& out, TevStageConfig::AlphaModifier | |||
|     } | ||||
| } | ||||
| 
 | ||||
| /// Writes the combiner function for the color components for the specified TEV stage operation
 | ||||
| static void AppendColorCombiner(std::string& out, TevStageConfig::Operation operation, | ||||
|         const std::string& variable_name) { | ||||
|     using Operation = TevStageConfig::Operation; | ||||
|  | @ -201,6 +206,7 @@ static void AppendColorCombiner(std::string& out, TevStageConfig::Operation oper | |||
|     } | ||||
| } | ||||
| 
 | ||||
| /// Writes the combiner function for the alpha component for the specified TEV stage operation
 | ||||
| static void AppendAlphaCombiner(std::string& out, TevStageConfig::Operation operation, | ||||
|         const std::string& variable_name) { | ||||
|     using Operation = TevStageConfig::Operation; | ||||
|  | @ -236,6 +242,7 @@ static void AppendAlphaCombiner(std::string& out, TevStageConfig::Operation oper | |||
|     } | ||||
| } | ||||
| 
 | ||||
| /// Writes the if-statement condition used to evaluate alpha testing
 | ||||
| static void AppendAlphaTestCondition(std::string& out, Regs::CompareFunc func) { | ||||
|     using CompareFunc = Regs::CompareFunc; | ||||
|     switch (func) { | ||||
|  | @ -270,6 +277,7 @@ static void AppendAlphaTestCondition(std::string& out, Regs::CompareFunc func) { | |||
|     } | ||||
| } | ||||
| 
 | ||||
| /// Writes the code to emulate the specified TEV stage
 | ||||
| static void WriteTevStage(std::string& out, const ShaderCacheKey& config, unsigned index) { | ||||
|     auto& stage = config.tev_stages[index]; | ||||
|     if (!IsPassThroughTevStage(stage)) { | ||||
|  |  | |||
|  | @ -10,8 +10,18 @@ | |||
| 
 | ||||
| namespace GLShader { | ||||
| 
 | ||||
| /**
 | ||||
|  * Generates the GLSL vertex shader program source code for the current Pica state | ||||
|  * @returns String of the shader source code | ||||
|  */ | ||||
| std::string GenerateVertexShader(); | ||||
| 
 | ||||
| /**
 | ||||
|  * Generates the GLSL fragment shader program source code for the current Pica state | ||||
|  * @param config ShaderCacheKey object generated for the current Pica state, used for the shader | ||||
|  *               configuration (NOTE: Use state in this struct only, not the Pica registers!) | ||||
|  * @returns String of the shader source code | ||||
|  */ | ||||
| std::string GenerateFragmentShader(const ShaderCacheKey& config); | ||||
| 
 | ||||
| } // namespace GLShader
 | ||||
|  |  | |||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue