Nintendo 3DS >> C/C++ >> GPU

Font

---

參考資訊：
1. citro2d
2. libctru doc
3. 3ds-examples

說明：

API
bool C3D_Init(size_t cmdBufSize)
bool C3D_FrameBegin(u8 flags)
void C3D_FrameEnd(u8 flags)
void C3D_Fini(void)
bool C2D_Init(size_t maxObjects)
void C2D_Prepare(void)
C3D_RenderTarget* C2D_CreateScreenTarget(gfxScreen_t screen, gfx3dSide_t side)
C2D_CONSTEXPR u32 C2D_Color32(u8 r, u8 g, u8 b, u8 a)
void C2D_TargetClear(C3D_RenderTarget *target, u32 color)
void C2D_SceneBegin(C3D_RenderTarget *target)
C2D_Font C2D_FontLoad(const char *filename)
C2D_TextBuf C2D_TextBufNew(size_t maxGlyphs)
const char *C2D_TextFontParse(C2D_Text *text, C2D_Font font, C2D_TextBuf buf, const char *str)
void C2D_TextOptimize(const C2D_Text *text)
void C2D_DrawText(const C2D_Text *text, u32 flags, float x, float y, float z, float scaleX, float scaleY, ...)
void C2D_TextBufDelete(C2D_TextBuf buf)
void C2D_FontFree(C2D_Font font)
void C2D_Fini(void)

main.c

#include <citro2d.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    gfxInitDefault();
    C3D_Init(C3D_DEFAULT_CMDBUF_SIZE);
    C2D_Init(C2D_DEFAULT_MAX_OBJECTS);
    C2D_Prepare();
    C3D_RenderTarget* top = C2D_CreateScreenTarget(GFX_TOP, GFX_LEFT);
 
    C2D_Text dynamicText = {0};
    C2D_Font font = C2D_FontLoad("sdmc:/3ds/font.bcfnt");
    C2D_TextBuf dynamicBuffer = C2D_TextBufNew(255);
    C2D_TextFontParse(&dynamicText, font, dynamicBuffer, "3ds Testing");
    C2D_TextOptimize(&dynamicText);
 
    C3D_FrameBegin(C3D_FRAME_SYNCDRAW);
    C2D_TargetClear(top, C2D_Color32(0x00, 0x00, 0x00, 0xff));
    C2D_SceneBegin(top);
    C2D_DrawText(&dynamicText, C2D_WithColor, 50, 50, 0, 1, 1, C2D_Color32(0x00, 0xff, 0x00, 0xff));
    C3D_FrameEnd(0);

    C2D_FontFree(font);
    C2D_TextBufDelete(dynamicBuffer);
    C2D_Fini();
    C3D_Fini();
 
    svcSleepThread(3000000000LL);
    gfxExit();
    return 0;
}

P.S. bcfnt字型可以透過/opt/devkitpro/tools/bin/mkbcfnt工具轉換

Makefile

include $(DEVKITARM)/3ds_rules

all:
	arm-none-eabi-gcc -mword-relocations -ffunction-sections -march=armv6k -mtune=mpcore -mfloat-abi=hard -mtp=soft -I/opt/devkitpro/libctru/include -I/opt/devkitpro/portlibs/3ds/include/ -I/opt/devkitpro/portlibs/3ds/include/opus/ -I/opt/devkitpro/portlibs/3ds/include/SDL -D__3DS__ -c main.c -o main.o 
	arm-none-eabi-gcc -specs=3dsx.specs -march=armv6k -mtune=mpcore -mfloat-abi=hard -mtp=soft main.o -L/opt/devkitpro/portlibs/3ds/lib -lopusfile -logg -lopus -L/opt/devkitpro/libctru/lib -lSDL_image -lSDL_mixer -lSDL_ttf -lSDL_gfx -lSDL -lfreetype -lbz2 -lpng -ljpeg -lz -lcitro2d -lcitro3d -lctru -lm -lstdc++ -o main.elf
	smdhtool --create "main" "devkitARM" "steward" /opt/devkitpro/libctru/default_icon.png main.smdh
	3dsxtool main.elf main.3dsx --smdh=main.smdh

clean:
	rm -rf main.o main.elf main.3dsx main.smdh

編譯、執行

$ sudo docker run --rm -it -v $(pwd):/source nds-env /bin/bash
root@c18881035cba:/source# make && exit
$ citra main.3dsx

完成

返回上一頁