mirror of
https://github.com/Lime3DS/Lime3DS
synced 2024-12-26 00:52:46 -06: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…
Reference in a new issue