You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<p><imgsrc="https://raw.githubusercontent.com/nthnn/goblin3d/main/assets/goblin3d_sdl2.png" alt="Goblin3D port with SDL2" class="inline"/><br/>
133
133
Goblin3D port with SDL2 </p>
134
-
<h2><aclass="anchor" id="autotoc_md1"></a>
134
+
<h2><aclass="anchor" id="autotoc_md2"></a>
135
135
Installation</h2>
136
-
<h3><aclass="anchor" id="autotoc_md2"></a>
136
+
<h3><aclass="anchor" id="autotoc_md3"></a>
137
137
Arduino Library Manager</h3>
138
138
<oltype="1">
139
139
<li>Open the Arduino IDE.</li>
140
140
<li>Go to <b>Sketch</b> > <b>Include Library</b> > <b>Manage Libraries...</b></li>
141
141
<li>Search for <b>Goblin3D</b>.</li>
142
142
<li>Click <b>Install</b>.</li>
143
143
</ol>
144
-
<h3><aclass="anchor" id="autotoc_md3"></a>
144
+
<h3><aclass="anchor" id="autotoc_md4"></a>
145
145
Manual Installation</h3>
146
146
<oltype="1">
147
147
<li>Download the latest release from the <ahref="https://github.com/nthnn/goblin3d/releases">Releases</a> page.</li>
148
148
<li>Unzip the downloaded file.</li>
149
149
<li>Move the <code>Goblin3D</code> folder to your Arduino libraries directory (typically <code>~/Documents/Arduino/libraries/</code> on Windows and Linux, <code>~/Documents/Arduino/libraries/</code> on macOS).</li>
150
150
<li>Restart the Arduino IDE.</li>
151
151
</ol>
152
-
<h2><aclass="anchor" id="autotoc_md4"></a>
152
+
<h2><aclass="anchor" id="autotoc_md5"></a>
153
153
Getting Started</h2>
154
-
<h3><aclass="anchor" id="autotoc_md5"></a>
154
+
<h3><aclass="anchor" id="autotoc_md6"></a>
155
155
Quick Start</h3>
156
156
<p>Goblin3D SDL2 port example is availble on Docker to try it out.</p>
<divclass="line">docker run -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix goblin3d</div>
159
-
</div><!-- fragment --><h3><aclass="anchor" id="autotoc_md6"></a>
159
+
</div><!-- fragment --><h3><aclass="anchor" id="autotoc_md7"></a>
160
160
Basic Usage</h3>
161
161
<p>Here’s a simple example of how to use Goblin3D to load an <code>*.obj</code> file from SD card to TFT ILI9341 display.</p>
162
162
<divclass="fragment"><divclass="line"><spanclass="preprocessor">#include <SPI.h></span><spanclass="comment">// Include the SPI library for SPI communication</span></div>
<pclass="startli">When saving, you do not need to include the Material File (*.mtl) since Goblin3D only renders the wireframe, and materials are not required for this purpose. Simply save the OBJ file, and it's ready for use with Goblin3D.</p>
<pclass="startli">Goblin3D can be used to develop retro-style 3D games on resource-constrained devices, where wireframe graphics give a nostalgic feel while minimizing resource usage.</p>
271
271
</li>
272
272
</ol>
273
-
<h2><aclass="anchor" id="autotoc_md9"></a>
273
+
<h2><aclass="anchor" id="autotoc_md10"></a>
274
274
Contribution and Feedback</h2>
275
275
<p>Contributions and feedback are all welcome to enhance this library. If you encounter any issues, have suggestions for improvements, or would like to contribute code, please do so.</p>
276
-
<h2><aclass="anchor" id="autotoc_md10"></a>
276
+
<h2><aclass="anchor" id="autotoc_md11"></a>
277
277
License</h2>
278
278
<p>Copyright 2024 - Nathanne Isip</p>
279
279
<p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p>
0 commit comments