mirror of
https://github.com/Lime3DS/Lime3DS.git
synced 2024-11-14 05:55:13 +01:00
gl_shader_gen: Add additional function documentation.
This commit is contained in:
parent
2a0a86f629
commit
4b5141954e
@ -11,6 +11,7 @@ using TevStageConfig = Regs::TevStageConfig;
|
|||||||
|
|
||||||
namespace GLShader {
|
namespace GLShader {
|
||||||
|
|
||||||
|
/// Detects if a TEV stage is configured to be skipped (to avoid generating unnecessary code)
|
||||||
static bool IsPassThroughTevStage(const TevStageConfig& stage) {
|
static bool IsPassThroughTevStage(const TevStageConfig& stage) {
|
||||||
return (stage.color_op == TevStageConfig::Operation::Replace &&
|
return (stage.color_op == TevStageConfig::Operation::Replace &&
|
||||||
stage.alpha_op == TevStageConfig::Operation::Replace &&
|
stage.alpha_op == TevStageConfig::Operation::Replace &&
|
||||||
@ -22,6 +23,7 @@ static bool IsPassThroughTevStage(const TevStageConfig& stage) {
|
|||||||
stage.GetAlphaMultiplier() == 1);
|
stage.GetAlphaMultiplier() == 1);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Writes the specified TEV stage source component(s)
|
||||||
static void AppendSource(std::string& out, TevStageConfig::Source source,
|
static void AppendSource(std::string& out, TevStageConfig::Source source,
|
||||||
const std::string& index_name) {
|
const std::string& index_name) {
|
||||||
using Source = TevStageConfig::Source;
|
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,
|
static void AppendColorModifier(std::string& out, TevStageConfig::ColorModifier modifier,
|
||||||
TevStageConfig::Source source, const std::string& index_name) {
|
TevStageConfig::Source source, const std::string& index_name) {
|
||||||
using ColorModifier = TevStageConfig::ColorModifier;
|
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,
|
static void AppendAlphaModifier(std::string& out, TevStageConfig::AlphaModifier modifier,
|
||||||
TevStageConfig::Source source, const std::string& index_name) {
|
TevStageConfig::Source source, const std::string& index_name) {
|
||||||
using AlphaModifier = TevStageConfig::AlphaModifier;
|
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,
|
static void AppendColorCombiner(std::string& out, TevStageConfig::Operation operation,
|
||||||
const std::string& variable_name) {
|
const std::string& variable_name) {
|
||||||
using Operation = TevStageConfig::Operation;
|
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,
|
static void AppendAlphaCombiner(std::string& out, TevStageConfig::Operation operation,
|
||||||
const std::string& variable_name) {
|
const std::string& variable_name) {
|
||||||
using Operation = TevStageConfig::Operation;
|
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) {
|
static void AppendAlphaTestCondition(std::string& out, Regs::CompareFunc func) {
|
||||||
using CompareFunc = Regs::CompareFunc;
|
using CompareFunc = Regs::CompareFunc;
|
||||||
switch (func) {
|
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) {
|
static void WriteTevStage(std::string& out, const ShaderCacheKey& config, unsigned index) {
|
||||||
auto& stage = config.tev_stages[index];
|
auto& stage = config.tev_stages[index];
|
||||||
if (!IsPassThroughTevStage(stage)) {
|
if (!IsPassThroughTevStage(stage)) {
|
||||||
|
@ -10,8 +10,18 @@
|
|||||||
|
|
||||||
namespace GLShader {
|
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();
|
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);
|
std::string GenerateFragmentShader(const ShaderCacheKey& config);
|
||||||
|
|
||||||
} // namespace GLShader
|
} // namespace GLShader
|
||||||
|
Loading…
Reference in New Issue
Block a user