deploy: eabf7ee

about/faq/index.html

@@ -5,4 +5,4 @@
 <a href=https://github.com/hexops/mach class=svg-item><img alt=GitHub class=svg-icon src=https://machengine.org//img/github.svg></a>
 <a href=https://discord.gg/XNG3NZgCqp class=svg-item><img alt=Discord class=svg-icon src=https://machengine.org//img/discord.svg></a>
 <a href=https://github.com/sponsors/slimsag class=donate-button><img alt=Heart class=svg-icon src=https://machengine.org//img/heart.svg>
-&nbsp;Donate</a></div></div></div><div class=alert><span><strong>Mach v0.2 has been released!</strong> For all the details check out <a href=https://devlog.hexops.com/2023/mach-v0.2-released/>the announcement</a></span></div><div id=content><link rel=stylesheet href=https://machengine.org/layouts/docs.eba24e7b90282072fe2e748d2511c23c5000ad5f00b0ef3bf03f8ee20348f6e6.css><main aria-role=main class="main-docs with-alert"><aside><ul><li><a href=https://machengine.org/about><span>About the project</span></a></li><li><a href=https://machengine.org/about/goals><span>Project goals</span></a></li><li><a href=https://machengine.org/about/platforms><span>Platform support</span></a></li><li><a href=https://machengine.org/about/zig-version><span>Zig version</span></a></li><li><a href=https://machengine.org/about/known-issues><span>Known issues</span></a></li><li><a href=https://machengine.org/about/stability><span>Stability</span></a></li><li><a href=https://machengine.org/about/style><span>Style guide</span></a></li><li><a href=https://machengine.org/about/faq><span>FAQ</span></a></li><li><h3><span>Key components</span></h3></li><ul class=sub-menu><li><a href=https://machengine.org/engine>Engine ⮕</a></li><li><a href=https://machengine.org/core>Core ⮕</a></li><li><a href=https://machengine.org/pkg>Packages ⮕</a></li></ul></ul></aside><div class=docs><h1 id=frequently-asked-questions>Frequently asked questions</h1><h2 id=when-will-the-engine-be-released>When will the engine be released?</h2><p>There won&rsquo;t be one major event, rather it will be a bunch of small/incremental releases building up to it. You can look at the <a href=https://machengine.org/engine/roadmap/>engine roadmap</a> to get an idea of what we&rsquo;re working on currently, and what will come later.</p><h2 id=can-i-use-mach-to-make-a-simple-2d-game>Can I use Mach to make a simple 2D game?</h2><p>Using the <em>engine</em>? Definitely not today.</p><p>Using <em>Mach core</em>, maybe:</p><ul><li>There is a <a href=https://machengine.org/core/examples/#sprite2d>sprite2d example</a> which lets you load a JSON texture atlas and draws sprites on the screen you could use as a starting point. However, it is ~400 lines of code, a good amount of that is low-level graphics programming.</li><li>You will need to bring your own:<ul><li>Math library</li><li>Physics library</li><li>GUI library</li><li>Text rendering (though we have freetype bindings you can use, text rendering is quite involved.)</li></ul></li></ul><p>If what you are looking for is a high-level simple 2D graphics API, we don&rsquo;t have that today. I suggest you look elsewhere for right now; I&rsquo;m a big fan of <a href=https://www.raylib.com>Raylib</a> and there are people using it from Zig.</p><p>We are actively working on higher-level engine APIs that will make simple 2D games nice to build in Zig, but they&rsquo;re not ready for use yet. See the <a href=https://machengine.org/engine/roadmap/>engine roadmap</a> for details.</p><h2 id=can-i-use-mach-to-make-a-simple-3d-game>Can I use Mach to make a simple 3D game?</h2><p>Using the <em>engine</em>? Definitely not today.</p><p>Using <em>Mach core</em>, maybe:</p><ul><li>There are examples for 3D model loading, however the examples for this are ~1000 lines of code and a good amount of the code is low-level graphics programming.</li><li>You will need to bring your own:<ul><li>Math library</li><li>Physics library</li><li>GUI library</li><li>Text rendering (though we have freetype bindings you can use, text rendering is quite involved.)</li></ul></li></ul><p>It will be a while before we have good high-level 3D graphics support; a lot of other pieces need to land first. See the <a href=https://machengine.org/engine/roadmap/>engine roadmap</a> for details.</p></div><div class=toc><h3>Table of contents</h3><nav id=TableOfContents><ul><li><a href=#when-will-the-engine-be-released>When will the engine be released?</a></li><li><a href=#can-i-use-mach-to-make-a-simple-2d-game>Can I use Mach to make a simple 2D game?</a></li><li><a href=#can-i-use-mach-to-make-a-simple-3d-game>Can I use Mach to make a simple 3D game?</a></li></ul></nav></div></main><div class=footer><a href=https://hexops.com/privacy>Privacy matters</a><p><a href=https://github.com/hexops/machengine.org/archive/refs/heads/gh-pages.zip>offline version of this site</a> | <a href=https://machengine.org//about#improve-this-site>Improve this site</a> | <a href=https://github.com/sponsors/slimsag>Sponsor on GitHub</a> | <a href=https://devlog.hexops.com/>Hexops' devlog</a></p></div></div></body></html>
+&nbsp;Donate</a></div></div></div><div class=alert><span><strong>Mach v0.2 has been released!</strong> For all the details check out <a href=https://devlog.hexops.com/2023/mach-v0.2-released/>the announcement</a></span></div><div id=content><link rel=stylesheet href=https://machengine.org/layouts/docs.1c549ac5e9eaa1dc4997cd957caa9afec046a45d465b64074e1ec4f88737dd7b.css><main aria-role=main class="main-docs with-alert"><aside><ul><li><a href=https://machengine.org/about><span>About the project</span></a></li><li><a href=https://machengine.org/about/goals><span>Project goals</span></a></li><li><a href=https://machengine.org/about/platforms><span>Platform support</span></a></li><li><a href=https://machengine.org/about/zig-version><span>Zig version</span></a></li><li><a href=https://machengine.org/about/known-issues><span>Known issues</span></a></li><li><a href=https://machengine.org/about/stability><span>Stability</span></a></li><li><a href=https://machengine.org/about/style><span>Style guide</span></a></li><li><a href=https://machengine.org/about/faq><span>FAQ</span></a></li><li><h3><span>Key components</span></h3></li><ul class=sub-menu><li><a href=https://machengine.org/engine>Engine ⮕</a></li><li><a href=https://machengine.org/core>Core ⮕</a></li><li><a href=https://machengine.org/pkg>Packages ⮕</a></li></ul></ul></aside><div class=docs><h1 id=frequently-asked-questions>Frequently asked questions</h1><h2 id=when-will-the-engine-be-released>When will the engine be released?</h2><p>There won&rsquo;t be one major event, rather it will be a bunch of small/incremental releases building up to it. You can look at the <a href=https://machengine.org/engine/roadmap/>engine roadmap</a> to get an idea of what we&rsquo;re working on currently, and what will come later.</p><h2 id=can-i-use-mach-to-make-a-simple-2d-game>Can I use Mach to make a simple 2D game?</h2><p>Using the <em>engine</em>? Definitely not today.</p><p>Using <em>Mach core</em>, maybe:</p><ul><li>There is a <a href=https://machengine.org/core/examples/#sprite2d>sprite2d example</a> which lets you load a JSON texture atlas and draws sprites on the screen you could use as a starting point. However, it is ~400 lines of code, a good amount of that is low-level graphics programming.</li><li>You will need to bring your own:<ul><li>Math library</li><li>Physics library</li><li>GUI library</li><li>Text rendering (though we have freetype bindings you can use, text rendering is quite involved.)</li></ul></li></ul><p>If what you are looking for is a high-level simple 2D graphics API, we don&rsquo;t have that today. I suggest you look elsewhere for right now; I&rsquo;m a big fan of <a href=https://www.raylib.com>Raylib</a> and there are people using it from Zig.</p><p>We are actively working on higher-level engine APIs that will make simple 2D games nice to build in Zig, but they&rsquo;re not ready for use yet. See the <a href=https://machengine.org/engine/roadmap/>engine roadmap</a> for details.</p><h2 id=can-i-use-mach-to-make-a-simple-3d-game>Can I use Mach to make a simple 3D game?</h2><p>Using the <em>engine</em>? Definitely not today.</p><p>Using <em>Mach core</em>, maybe:</p><ul><li>There are examples for 3D model loading, however the examples for this are ~1000 lines of code and a good amount of the code is low-level graphics programming.</li><li>You will need to bring your own:<ul><li>Math library</li><li>Physics library</li><li>GUI library</li><li>Text rendering (though we have freetype bindings you can use, text rendering is quite involved.)</li></ul></li></ul><p>It will be a while before we have good high-level 3D graphics support; a lot of other pieces need to land first. See the <a href=https://machengine.org/engine/roadmap/>engine roadmap</a> for details.</p></div><div class=toc><h3>Table of contents</h3><nav id=TableOfContents><ul><li><a href=#when-will-the-engine-be-released>When will the engine be released?</a></li><li><a href=#can-i-use-mach-to-make-a-simple-2d-game>Can I use Mach to make a simple 2D game?</a></li><li><a href=#can-i-use-mach-to-make-a-simple-3d-game>Can I use Mach to make a simple 3D game?</a></li></ul></nav></div></main><div class=footer><a href=https://hexops.com/privacy>Privacy matters</a><p><a href=https://github.com/hexops/machengine.org/archive/refs/heads/gh-pages.zip>offline version of this site</a> | <a href=https://machengine.org//about#improve-this-site>Improve this site</a> | <a href=https://github.com/sponsors/slimsag>Sponsor on GitHub</a> | <a href=https://devlog.hexops.com/>Hexops' devlog</a></p></div></div></body></html>

about/goals/index.html

@@ -5,7 +5,7 @@
 <a href=https://github.com/hexops/mach class=svg-item><img alt=GitHub class=svg-icon src=https://machengine.org//img/github.svg></a>
 <a href=https://discord.gg/XNG3NZgCqp class=svg-item><img alt=Discord class=svg-icon src=https://machengine.org//img/discord.svg></a>
 <a href=https://github.com/sponsors/slimsag class=donate-button><img alt=Heart class=svg-icon src=https://machengine.org//img/heart.svg>
-&nbsp;Donate</a></div></div></div><div class=alert><span><strong>Mach v0.2 has been released!</strong> For all the details check out <a href=https://devlog.hexops.com/2023/mach-v0.2-released/>the announcement</a></span></div><div id=content><link rel=stylesheet href=https://machengine.org/layouts/docs.eba24e7b90282072fe2e748d2511c23c5000ad5f00b0ef3bf03f8ee20348f6e6.css><main aria-role=main class="main-docs with-alert"><aside><ul><li><a href=https://machengine.org/about><span>About the project</span></a></li><li><a href=https://machengine.org/about/goals><span>Project goals</span></a></li><li><a href=https://machengine.org/about/platforms><span>Platform support</span></a></li><li><a href=https://machengine.org/about/zig-version><span>Zig version</span></a></li><li><a href=https://machengine.org/about/known-issues><span>Known issues</span></a></li><li><a href=https://machengine.org/about/stability><span>Stability</span></a></li><li><a href=https://machengine.org/about/style><span>Style guide</span></a></li><li><a href=https://machengine.org/about/faq><span>FAQ</span></a></li><li><h3><span>Key components</span></h3></li><ul class=sub-menu><li><a href=https://machengine.org/engine>Engine ⮕</a></li><li><a href=https://machengine.org/core>Core ⮕</a></li><li><a href=https://machengine.org/pkg>Packages ⮕</a></li></ul></ul></aside><div class=docs><h1 id=mach-project-goals>Mach project goals</h1><p>This page covers more broad project goals that apply to all Mach projects, code, standalone libraries, etc.</p><h2 id=engine-goals>Engine goals</h2><p>See <a href=../../engine>this page</a>.</p><h2 id=zero-fuss-installation>Zero-fuss installation</h2><div><img alt="no more apt-get install" src=https://machengine.org/img/not-this-anything-but-this.png style=width:20rem;float:left;padding-right:2rem></img><p>All too often we see people get a sudden burst of inspiration: "I'm going to finally start my game/app this weekend!" only to see them utlimately get bogged down by setting up their dev environment, ending their weekend with "well.. at least I got the hello world running" - there is no greater drain on human inspiration.</p><p>This is why Mach focuses so heavily on zero-fuss installation: <strong>you only need Zig, Git, and Curl to use Mach. Nothing else.</strong> No more `apt-get install` lists. No more cmake/ninja/dependency-hell.</p></div><p>Mach is able to achieve this by doing the heavy lifting of compiling C/C++ dependencies by source for you, using Zig as the C/C++ compiler. We build GLFW, Google Chrome&rsquo;s WebGPU implementation, and much more using just Zig as a C/C++ compiler and avoid make/cmake/ninja/etc by taking on the hard work of using Zig as the build system too.</p><p>In some cases building from source can take a few minutes (like building Google Chrome&rsquo;s WebGPU implementation) and we don&rsquo;t want you to have to wait, so we provide binaries by default in that specific case which are used when you execute <code>zig build</code>. We understand the importance of 100% from-source builds, however, and so we make them possible at the flip of a switch <code>DAWN_FROM_SOURCE=true zig build</code></p><h2 id=seamless-cross-compilation>Seamless cross-compilation</h2><p>At the flip of a switch it is possible to cross-compile to nearly any target:</p><pre tabindex=0><code>$ zig build -Dtarget=x86_64-windows
+&nbsp;Donate</a></div></div></div><div class=alert><span><strong>Mach v0.2 has been released!</strong> For all the details check out <a href=https://devlog.hexops.com/2023/mach-v0.2-released/>the announcement</a></span></div><div id=content><link rel=stylesheet href=https://machengine.org/layouts/docs.1c549ac5e9eaa1dc4997cd957caa9afec046a45d465b64074e1ec4f88737dd7b.css><main aria-role=main class="main-docs with-alert"><aside><ul><li><a href=https://machengine.org/about><span>About the project</span></a></li><li><a href=https://machengine.org/about/goals><span>Project goals</span></a></li><li><a href=https://machengine.org/about/platforms><span>Platform support</span></a></li><li><a href=https://machengine.org/about/zig-version><span>Zig version</span></a></li><li><a href=https://machengine.org/about/known-issues><span>Known issues</span></a></li><li><a href=https://machengine.org/about/stability><span>Stability</span></a></li><li><a href=https://machengine.org/about/style><span>Style guide</span></a></li><li><a href=https://machengine.org/about/faq><span>FAQ</span></a></li><li><h3><span>Key components</span></h3></li><ul class=sub-menu><li><a href=https://machengine.org/engine>Engine ⮕</a></li><li><a href=https://machengine.org/core>Core ⮕</a></li><li><a href=https://machengine.org/pkg>Packages ⮕</a></li></ul></ul></aside><div class=docs><h1 id=mach-project-goals>Mach project goals</h1><p>This page covers more broad project goals that apply to all Mach projects, code, standalone libraries, etc.</p><h2 id=engine-goals>Engine goals</h2><p>See <a href=../../engine>this page</a>.</p><h2 id=zero-fuss-installation>Zero-fuss installation</h2><div><img alt="no more apt-get install" src=https://machengine.org/img/not-this-anything-but-this.png style=width:20rem;float:left;padding-right:2rem></img><p>All too often we see people get a sudden burst of inspiration: "I'm going to finally start my game/app this weekend!" only to see them utlimately get bogged down by setting up their dev environment, ending their weekend with "well.. at least I got the hello world running" - there is no greater drain on human inspiration.</p><p>This is why Mach focuses so heavily on zero-fuss installation: <strong>you only need Zig, Git, and Curl to use Mach. Nothing else.</strong> No more `apt-get install` lists. No more cmake/ninja/dependency-hell.</p></div><p>Mach is able to achieve this by doing the heavy lifting of compiling C/C++ dependencies by source for you, using Zig as the C/C++ compiler. We build GLFW, Google Chrome&rsquo;s WebGPU implementation, and much more using just Zig as a C/C++ compiler and avoid make/cmake/ninja/etc by taking on the hard work of using Zig as the build system too.</p><p>In some cases building from source can take a few minutes (like building Google Chrome&rsquo;s WebGPU implementation) and we don&rsquo;t want you to have to wait, so we provide binaries by default in that specific case which are used when you execute <code>zig build</code>. We understand the importance of 100% from-source builds, however, and so we make them possible at the flip of a switch <code>DAWN_FROM_SOURCE=true zig build</code></p><h2 id=seamless-cross-compilation>Seamless cross-compilation</h2><p>At the flip of a switch it is possible to cross-compile to nearly any target:</p><pre tabindex=0><code>$ zig build -Dtarget=x86_64-windows
 $ zig build -Dtarget=x86_64-linux-gnu
 $ zig build -Dtarget=x86_64-macos
 $ zig build -Dtarget=aarch64-macos