chamberlain91 / heirloom Goto Github PK

Hi,

Would you consider changing Heirloom.MiniAudio from internal class es to public class?

This will give access for other project to used it, independently from Heirloom framework.

On a friends Mac it failed to get the "current" video mode from the known modes. This is strange behavior, but there are ways around this. Since discovering this bug, I rewrote the GLFW / Desktop infrastructure, so maybe this has been resolved. I do not however have a macOS machine at my disposal to validate.

Improve documentation by adding tutorials for getting started with both Visual Studio and dotnet. Need to provide a description of the dependencies/modules, what they do and what should be included for both CLI and IDE.

I noticed an unhandled exception when closing the window when using the Nuget packages after following the getting started tutorial.

Text rendering eventually needs features for vertical alignment. Currently this is possible by getting the computed text box size by font.MeasureText(...) and done manually in user code, but probably could and should be built into the rendering code to either or both:

1. Improve performance of that operation .
2. Simply be that much more convenient.

Eventually I would like to include a post effect / shader system into the the drawing API.

May look something like the following:

var myShader = new Shader(Files.OpenStream(...));
myShader.Set("thickness", 2);
...
ctx.Shader = myShader;
ctx.Draw(...)

Ideally the shader source will be GLSL or some simplistic DSL language. In either case, restrictions are placed on the shader for vertex input and texture systems. A DSL may be more complicated to implement, but I feel may make the act of writing shaders simpler. An additional benefit may be the DSL parser can emit GLSL, HLSL or Spir-V or whatever is consumed by the target platform.

simple.shader

Image image;
Color color;

Color frag_main(Vector uv) {
    return sampleImage(image, uv) * color;
}

The other option is to use an augmented version of GLSL with restrictions / requirements.

default.vert

#include "standard/standard.vert"

vec2 vert_main(vec2 position)
{
	// Simply forward vertex position
	return position;
}

default.frag

#include "standard/standard.frag"
 
vec4 frag_main(in vec2 uv) 
{ 
	// Simply sample image
	return sampleImage(uv);
}

Currently there is no way to construct a color from the HSB or HSV color space.

Suggested API:

• col = Color.FromHSV(h, s, v)
• col.ToHSV(out var h, out var s, out var v)
• col.Hue, col.Saturation, col.Value

Parameter h (Hue) in the range 0.0 to 360.0.
Parameter s (Saturation) in the range 0.0 to 1.0.
Parameter v (Value) in the range 0.0 to 1.0.

It seems that a call to ctx.ResetState() is necessary to properly configure the viewport and other internals before drawing anything. The user should not need to do this unless they are actually intending to "reset to default state" and not "initialize default state"

Drawing outline shapes, curves or 'poly line' are currently implemented with ctx.DrawLine(...). This is efficient, but can lead to visual breaks with thick lines or harsh angles.