M3diaLib 3DS: Difference between revisions

m3diaLib
m3diaLib
General
Author	m3diaLib-Team
Type	Developments
Version	0.2.2-beta
License	Mixed
Last Updated	2018/10/09
Links
	Download
	Website
	Source

Latest revision as of 04:23, 6 Mayıs 2024

m3diaLib (spelled media-lib) is a fast, extensive and powerful allround media and game library for the Nintendo 3DS, written in C++. The library is split into multiple modules, which can then be split into smaller parts.

Note: This library is deprecated. You should use libctru and citro3d/2d directly, if possible.

Features

Core:
- A class for running your homebrew app.
- Easy interaction with the system itself.
- Starting and running applets.
- Time measurement.
- Support for the RomFS.
- Multithreading and concurrency.
Input:
- Handling button input.
- Handling touch input.
Graphics:
- Support for the top and bottom screen.
- Support for stereoscopic 3D.
- Easy-to-use interface for fast rendering on both screens.
- Support for transformation of textures and sprites.
- Pre-coded shapes as well as a shape class for easily rendering your own shapes.
- Easy-to-use color system.
- Collision detection.
Audio:
- Loading or streaming audio files directly from the file system.
- Support for .wav and .mp3.
- Two different classes, sound and music, which have features that can be helpful specific in their use case.
Utils:
- Basic encryption.

Installation

To install the library, download the latest build and then execute the command:

make install

If you want to build it from the source, download the latest release and then execute the following commands:

make
make install

Note: Make sure, to have the latest version of the devkitPro-toolchain installed, before building the lib or any examples.

User guide

How to use

The barebones of a homebrew app using the m3diaLib would look like this:

#include <m3dia.hpp>
int main() {
m3d::Applet app;
while (app.isRunning()) {
if (m3d::buttons::buttonPressed(m3d::buttons::Button::Start)) {
app.exit(); // exit if start is pressed
}
}
}

Dependencies

To compile a m3diaLib-app, you need the following dependencies installed (install via devkitPro-pacman):

3dstools
picasso
libctru
citro3d
citro2d
3ds-tinyxml2
3ds-zlib
3ds-mpg123
3ds-libpng
3ds-freetype
tex3ds (if you want to use spritesheets)

Use this command to automatically install all necessary dependencies:

sudo dkp-pacman -S 3ds-dev 3ds-zlib 3ds-tinyxml2 3ds-mpg123 3ds-libpng

Useful links

Documentation.
Examples.

Credits

External links

GitHub - https://github.com/m3diaLib-Team/m3diaLib-CTR
Documentation - https://docs.stunthacks.eu/m3dialib (archived)
GBAtemp - https://gbatemp.net/threads/release-m3dialib-a-c-library-for-easier-homebrew-development-for-the-nintendo-3ds.517929
Reddit - https://www.reddit.com/r/3dshacks/comments/9fgmkc/release_m3dialib_a_c_library_for_easier_homebrew

@@ Line 1: / Line 1: @@
-{{Infobox-3DS-Homebrews
+{{Infobox 3DS Homebrews
-| title = m3diaLib
+|title=m3diaLib
-| type = PC Utilities
+|image=M3dialib2.png
-| version=v0.2.2-beta
+|description=A C++ library for easier homebrew development for the Nintendo 3DS.
-| lastupdated = 2018/10/09
+|author=m3diaLib-Team
-| licence = Mixed
+|lastupdated=2018/10/09
-| author = m3diaLib-Team
+|type=Developments
-| website = https://github.com/m3diaLib-Team/m3diaLib-CTR
+|version=0.2.2-beta
-| download = https://dlhb.gamebrew.org/3dshomebrew/m3diaLib.rar
+|license=Mixed
-| source = https://github.com/m3diaLib-Team/m3diaLib-CTR
+|download=https://dlhb.gamebrew.org/3dshomebrews/m3dialib.7z
+|website=https://github.com/m3diaLib-Team/m3diaLib-CTR
+|source=https://github.com/m3diaLib-Team/m3diaLib-CTR
 }}
-== m3diaLib ==
+{{Obsolete}}
-A fast, extensive and powerful allround media and game library for the Nintendo 3DS, written in C++.
-'''This library is still in beta! If you have any issues or find any bugs, please report them!'''
+m3diaLib (spelled media-lib) is a fast, extensive and powerful allround media and game library for the Nintendo 3DS, written in C++. The library is split into multiple modules, which can then be split into smaller parts.
-== Features ==
+'''Note:''' This library is deprecated. You should use libctru and citro3d/2d directly, if possible.
-The m3diaLib (spelled media-lib) is split into multiple modules, which can then be split into smaller parts:
-=== Core ===
+==Features==
-The core module contains all functionality for interacting with the system. Its features range from running and handling the app itself to displaying errors and running system applets.
+* Core:
+** A class for running your homebrew app.
+** Easy interaction with the system itself.
+** Starting and running applets.
+** Time measurement.
+** Support for the RomFS.
+** Multithreading and concurrency.
+* Input:
+** Handling button input.
+** Handling touch input.
+* Graphics:
+** Support for the top and bottom screen.
+** Support for stereoscopic 3D.
+** Easy-to-use interface for fast rendering on both screens.
+** Support for transformation of textures and sprites.
+** Pre-coded shapes as well as a shape class for easily rendering your own shapes.
+** Easy-to-use color system.
+** Collision detection.
+* Audio:
+** Loading or streaming audio files directly from the file system.
+** Support for .wav and .mp3.
+** Two different classes, sound and music, which have features that can be helpful specific in their use case.
+* Utils:
+** Basic encryption.
-'''Its main features are:'''
+===Installation===
+To install the library, download the latest build and then execute the command:
-* A class for running your homebrew app
+ make install
-* Easy interaction with the system itself
-* Starting and running applets
-* Time measurement
-* Support for the RomFS
-* Multithreading and concurrency
-=== Input ===
+If you want to build it from the source, download the latest release and then execute the following commands:
-The input module does what its name says: It handles each and every input for interacting with the user.
-'''Its main features are:'''
+ make
+ make install
-* Handling button input
+'''Note:''' Make sure, to have the latest version of the devkitPro-toolchain installed, before building the lib or any examples.
-* Handling touch input
-=== Graphics ===
-The graphics module is by far the biggest module. It handles anything graphic-wise, from rendering simple shapes to rendering and animating high-quality textures.
-'''Its main features are:'''
-* Support for the top and bottom screen
-* Support for stereoscopic 3D
-* Easy-to-use interface for fast rendering on both screens
-* Support for transformation of textures and sprites
-* Pre-coded shapes as well as a shape class for easily rendering your own shapes
-* Easy-to-use color system
-* Collision detection
-=== Audio ===
-The audio module can be used for both music and sound effects.
-'''Its main features are:'''
-* Loading or streaming audio files directly from the file system
-* '''Support for .wav and .mp3 (more to come!)'''
-* Two different classes, sound and music, which have features that can be helpful specific in their use case
-=== Utils ===
+==User guide==
-The utils module contains all kind of useful utilities. Some of its functionalities are the following:
+===How to use===
-* Basic encryption
-All features are well documented [https://docs.stunthacks.eu/m3dialib/ here]. Examples can be viewed [https://github.com/StuntHacks/m3d-examples here].
-== How to use it ==
 The barebones of a homebrew app using the m3diaLib would look like this:
 <source lang="cpp">#include <m3dia.hpp>
@@ Line 78: / Line 69: @@
 }
 </source>
-Easy, isn't it?
-== Planned features: ==
+===Dependencies===
-==== Audio: ====
-* Microphone support
-* More file formats
-==== Core: ====
-* Support for all availiable os and system functionality
-==== Graphics: ====
-* Animation
-* RenderTargets
-* More file formats for textures
-* 3D support
-==== Networking: ====
-This module isn't availiable at the moment. However, it's planned features are:
-* A simple HTTP and WebSocket client and server
-* Socket support
-* A 3DS-download-game alternative (more on that at a later point)
-==== Utils: ====
-* ZIP compression and decompression
-* JSON and XML parsing
-* Secure random numbers ...and anything that strikes my mind in the future.
-== Installation ==
-To install the library, download the latest build and then execute the command <code>make install</code>. If you want to build it from the source, download the latest release and then execute the following commands:
-<pre>make
-make install
-</pre>
-'''Note:''' Make sure, to have the latest version of the devkitPro-toolchain installed, before building the lib or any examples.
-== Dependencies ==
 To compile a m3diaLib-app, you need the following dependencies installed (install via [https://devkitpro.org/wiki/devkitPro_pacman devkitPro-pacman]):
 * 3dstools
@@ Line 117: / Line 82: @@
 * 3ds-libpng
 * 3ds-freetype
-* tex3ds (if you want to use spritesheets) Use this command to automatically install all necessary dependencies: <code>sudo dkp-pacman -S 3ds-dev 3ds-zlib 3ds-tinyxml2 3ds-mpg123 3ds-libpng</code>
+* tex3ds (if you want to use spritesheets)
-== Credits ==
+Use this command to automatically install all necessary dependencies:
+ sudo dkp-pacman -S 3ds-dev 3ds-zlib 3ds-tinyxml2 3ds-mpg123 3ds-libpng
+===Useful links===
+* [https://docs.stunthacks.eu/m3dialib Documentation].
+* [https://github.com/StuntHacks/m3d-examples Examples].
+==Credits==
 * [https://github.com/smealum/ctrulib/ ctrulib]
 * [https://github.com/fincs/citro3d citro3d] (zLib)
@@ Line 124: / Line 97: @@
 * [https://github.com/Bly7/OBJ-Loader OBJ-Loader] (MIT)
 * [https://github.com/mariohackandglitch/ctr-led-brary ctr-led-brary]
+==External links==
+* GitHub - https://github.com/m3diaLib-Team/m3diaLib-CTR
+* Documentation - [https://web.archive.org/web/20181028151709/https://docs.stunthacks.eu/m3dialib/ https://docs.stunthacks.eu/m3dialib] (archived)
+* GBAtemp - https://gbatemp.net/threads/release-m3dialib-a-c-library-for-easier-homebrew-development-for-the-nintendo-3ds.517929
+* Reddit - https://www.reddit.com/r/3dshacks/comments/9fgmkc/release_m3dialib_a_c_library_for_easier_homebrew