C O M R E D 3DS

C_O_M_R_E_D
File:C O M R E D.jpg
General
Author	BEPISMAN2
Type	Other Apps
Version	alpha 0.1
License	Mixed
Last Updated	2016/10/04
Links
Download
Website
Source

C_O_M_R_E_D is an open source theme-able comic reader for the 3DS. The project is no longer in development and only a test theme is loaded from the SD Card.

Features

• Read a folder full of images as a comic (supported extensions are .jpg, .png, and .bmp).
• Orientation options: Hold the 3DS Upright and Sideways (Left- and Right-Hand Support).
• Zooming.
• Page Selection (jump to a certain page in the comic).
• Partial theme support.

Installation

Available in CIA and 3DSX formats.

• 3DSX - Put it in your /3ds/ folder and launch with Homebrew Launcher.
• CIA - Install it using a CIA installer of your choice.

Copy the /data/ folder and put it at the root of your SD Card. Your comics/mangas should go in /data/C_O_M_R_E_D/comics/. Setup is similar to Manga Reader:

• Create a directory, and make sure the images are in numerical order.
• The number of zeroes and file extensions in a directory are auto-detected.
• Make sure all images have the same number of zeroes in front of them, or else the images won't be detected.
• However, the images can have a different file format and still work fine.

User guide

How to use

To switch the 3DS Orientation you're in while reading, press the icon next to the Next Page Icon.

In the Default theme, this should look like a DS Icon.

Creating a Theme

Replace the images in /data/C_O_M_R_E_D/themes/test/ with your own.

Make sure the images are the right dimensions, and that they use the PNG format.

Buttons that are displayed at the main menu (53x30px):

• read_btn
• download_btn
• options_btn
• exit_btn

The image displayed on the top screen when in the main menu and sub-menus (400x240px):

• mm_top_scr_bg
• opt_top_scr_bg

Same as above, but with the bottom screen instead (320x240px):

• mm_bot_scr_bg
• opt_bot_scr_bg

Buttons that perform their respective functions while reading (35x35px):

• zoom_in
• zoom_out
• next_pg
• prev_pg
• switch_pg
• menu

Font used in sub-menus, make sure it's in .ttf format:

• font.ttf

Specifies the colors used in sub-menus, as well as other info:

• theme.txt

More on theme

theme.txt uses headers to denote the type of info being read. Below each header should contain the content to be used by the program. Here are the following headers used by C_O_M_R_E_D:

• [themeName]
• [themeDescription]
• [themeCreator]
• [topScreenFontColor]
• [bottomScreenFontColor]
• [selectionFontColor]

The names should be self-explanatory. The font colors are used in the sub-menus.

• [themeName], [themeDescription], and [themeCreator] should have simple text strings on the next line after the header. These strings should take up exactly one line in the file.
• [topScreenFont], [bottomScreenFont], and [selectionFontColor] should have the R, G, and B values directly after the header, in that order. Each line should have the corresponding color value, in hexadecimal.

Here's an example of a valid theme.txt:

[bottomScreenFontColor]
0x00
0x00
0x00

[themeName]
Test

[themeDescription]
Test theme

[themeCreator]
B_E_P_I_S_M_A_N

[topScreenFontColor]
0x00
0xFF
0x00

[selectionFontColor]
0x80
0x80
0x80

Screenshots

Known issues

There's a slight bug with the page selection that will kick you out of the comic if you jump to the last page. This should be fixed in later releases

Due to the limitations of the 3DS, images larger than 1024x1024px will load up distorted. In the future, I'll try to add automatic scaling for said images so they'll load in-tact on the 3DS. However, for now, use Fotosizer to manually resize your images.

(CIA Release only) If you try to exit by closing the app from the Home Menu, the 3DS will freeze. This is probably due to the fact that the RSF is unoptimized, this will be fixed later

Slight bug with zeroes. Make sure each page has exactly the same number of zeroes, disregarding the number of digits in front. This will be fixed soon.

Credits

Everyone on the 3DS Hacking Discord for helping me with this project's development.

• @MarcusD for his File System Wrapper.
• @Kartik for granting permission to use code from his 3DS Multidownload app to use in the Comic/Manga Downloading feature (not implemented in C_O_M_E_R_D yet).
• @MyLegGuy for the inspiration to write this application in the first place, as well as for his original Manga Reader.

External links

• GitHub - https://github.com/SaturnSH2x2/C_O_M_R_E_D
• GBAtemp - https://gbatemp.net/threads/alpha-release-c_o_m_r_e_d-open-source-comic-manga-reader-for-your-3ds.440387