sdl stb font下載-SDL sdl stb font源代碼下載

SDL STB字體渲染器

僅使用STB_TRUETYPE在純SDL2中渲染文本的僅標題庫。這是繪製的，即允許快速文本渲染的字形。它還提供了幾種簡單的方法來渲染一個字符串以使紋理以使更快的文本渲染。

新（2022）！可以使用producerConsumerFrontend.h的多線程環境中的prerender！

新（2021）！也可以使用bgfxFrontend.h在BGFX中渲染！

示例圖像：

示例文本測試

示例文本來自http://www.columbia.edu/~fdc/utf8/index.html

示例格式

接觸：

liam twigger- @snapperthetwig

特徵：

單頭庫 - 無需構建系統。只需包括然後走！
以純SDL運行 - 不需要openGL（儘管它可以與OpenGL一起使用）
簡單的文本渲染fc.drawText(x, y, string)
呈現紋理fc.renderTextToTexture(string, &widthOut, &heightOut)
形成的文本（如果您有字體！）。請參閱末端附近的格式部分
渲染到紋理對象 - 請參見示例
可以將鼠標的位置轉換為字符串中的Caret位置（僅沒有新線的字符串）
UTF-8支持
處理新線和標籤
後備字體支持 - 可以一次支持許多語言！
僅約1000行代碼
除了STB_TRUETYPE，SDL和標準庫，沒有依賴關係
自動或手動內存管理
可以通過擴展一些課程來支持其他前端（例如DirectX/OpenGL/Vulkan/Whthing Apple推翻我們的喉嚨）
公共領域

表現：

在英特爾I7-8750H上：

如果使用紋理（ renderTextToTexture / renderTextToObject ），則示例圖像需要0.7ms渲染（〜1400 fps）。速度將是SDL2使您可以在紋理上翻轉紋理的最大值。

如果直接呈現（ drawText ），則示例圖像需要約5ms渲染（〜200 fps）（〜200 fps）

對於持續多個幀的文本，您應該使用renderTextToTexture或renderTextToObject緩存。

我怎麼樣？

使用這個庫？
加載字體並繪製文本？
獲取字體指標
使用後備字體（用於多儀支持）
獲取文字的大小
將文字適應寬度
管理內存
緩存導致質地
以白色以外的顏色打印
到達用戶單擊的字符串中的位置
處理標籤
預生化字形
編寫自定義前端
從一個線程中生成文本並在另一個線程中渲染
鎖定免費生產者消費者隊列

格式化文字：

打印格式的文字？
負載粗體/斜體字體變體？
限制

非SDL前端：

BGFX

使用這個庫？

這是一個僅標題庫 - 無需構建系統

在任何標題中：

# include " path/to/sdlStbFont/sdlStbFont.h "

一個.cpp：

# define SDL_STB_FONT_IMPL
# include " path/to/sdlStbFont/sdlStbFont.h "

該庫對STB_TRUETYPE具有依賴性。它將自動包含此。如果您不希望它自動包含它，請使用#define STB_TRUETYPE_INCLUDE_HANDLED ，並處理您自己的stb_truetype.h。

加載字體並繪製文本？

# define SDL_STB_FONT_IMPL
# include " sdlStbFont.h "

...

// Load font
char * ttfFontFromMemory = loadFontFileSomehow( " path/to/file.ttf " );

sdl_stb_font_cache fc;
fc.faceSize = 24 ; // Must be set before loadFont()!
fc.tabWidthInSpaces = 8 ; // Optional
fc.loadFont(ttfFontFromMemory);

...

// Setup renderer
SDL_Renderer * mSdlRenderer = SDL_CreateRenderer( mWindow , SDL_RENDERER_SOFTWARE, 0 );
fc.bindRenderer( mSdlRenderer ); // Must bind a renderer before generating any glyphs

...

// Main loop
SDL_SetRenderDrawColor ( mSdlRenderer , 125 , 125 , 125 , 255 );
SDL_RenderClear ( mSdlRenderer );
fc.drawText( 5 , 5 , " Hello world! " );
SDL_RenderPresent ( mSdlRenderer );

// fc will clean itself up when it falls out of scope
delete[] ttfFontFromMemory; // You must manually remove the char buff when done
// if you want auto management use fc.loadFontManaged(), which will transfer
// ownership of ttfFontFromMemory to fc and be freed when done.

您還可以獲取渲染字符串的寬度和高度：

 fc.drawText(5, 5, widthOut, heightOut, "Hello world!");
// Draws "hello world" and sets widthOut and heightOut to the size of the string

獲取字體指標

 class sdl_stb_font_cache {
...
public:
  int ascent;
  int descent;
  int lineGap;
  int baseline;
  int rowSize;
  int tabWidth;  // May be changed later
  float scale;
  float underlineThickness;
  float strikethroughThickness;
  float underlinePosition;
  float strikethroughPosition;
  // Must be set before loadFont() is called. Cannot be changed after
  int faceSize;      // Default is 20. All the parameters are calcualted based on this
  int tabWidthInSpaces;  // Default is 8, set this before loadFont(). Max 128. Sets tabWidth when font is loaded
...
  }

使用後備字體（用於多儀支持）

fc.loadFont(ttfFontFromMemory);
fc.addFont(someSecondFontFromMemory);
fc.addFont(someThirdFontFromMemory);
...
etc

首先加載的字體必須帶有“ LoadFont”。

請注意，在調用任何繪圖功能之前，必須加載所有字體。如果在第一字體中找不到字形，則將搜索第二個字體，等等。

獲取文字的大小

 int w, h;
fc.getTextSize(w, h, " Text " ); // Get width and height at same time

// Also
h = fc.getTextHeight( " Text " ); // Faster, if only height is needed
w = fc.getTextWidth( " Text " ); // Internally just a wrapper for getTextSize
int nRows = fc.getTextRows( " Text n More text " ); // UTF8 safe, returns the number of rows of text - here it's 2
int numNewlines = fc.getNumNewLines

提示： drawText()返回繪製字符串或格式的文本對象的末端的X坐標。

將文字適應寬度

對於線條包裝，請使用fc.breakString(stringIn, arrayOut, width)功能。這將字符串或格式的文本對象轉換為字符串或格式的文本對象的向量每個小於寬度。這將嘗試首先打破新線和空格，然後將單詞拆分，如果該單詞比指定的寬度更長。這是UTF8安全。

管理內存

手冊管理：

 char * mFontData = loadFontFromFileSomehow( " path/to/file.ttf " );
fc.loadFont( mFontData );
// You will have to free mFontData when you are done with it
// fc does not copy mFontData internally
// using fc after free'ing mFontData will result in undefined behaviour

自動管理：

filep * file = openFile( " path/to/file " );
sttfont_memory mFontData ;
mFontData .alloc(file_size);
fread (file, & mFontData .data);
fc.loadFontManaged( mFontData );
// fc now owns mFontData's contents and will free it when fc is destroyed
// You can safely let mFontData fall out of scope
// Also addFontManaged is avaliable for adding fallback fonts

緩存導致質地

第一種方法：

 // creating
int RTw, RTh;
SDL_Texture * RT;
RT = fc.renderTextToTexture ( " Text " , &RTw, &RTh);

// Rendering
SDL_Rect r;
r.x = 5 ;
r.y = 5 ;
r.w = RTw;
r.h = RTh;
SDL_RenderCopy ( mSdlRenderer , RT , NULL , &r);

第二種方式（相同效果，但更乾淨）

 // creating
sdl_stb_prerendered_text prt;
prt. mRenderer = your__SDL_Render__instance;
fc.renderTextToObject(&prt, " Text " ); 
		
// Rendering
prt.draw(x, y);

// Rendering in colour & alpha
prt.drawWithColor(x, y, 255 , 185 , 85 , 255 );

// Cleanup
prt.freeTexture();

提示： prt.draw()返回對象末端的X坐標。

以白色以外的顏色打印

使用帶有緩存紋理的SDL_SetTextureColorMod 。或使用sdl_stb_prerendered_text::drawWithColor 。

到達用戶單擊的字符串中的位置

使用getCaretPos(text, relativeMouseX, relativeMouseY)

請注意，這僅當前僅支持沒有新線的字符串中的Carret查找 - 如果您使用多行字符串嘗試此操作，則可能會返回不正確的值。

處理標籤

TAB寬度由可變fc.tabWidth處理。選項卡之後的字符將與下一個標籤位置對齊。

您可以在調用fc.loadFont(...)之前將fc.tabWidthInSpaces = X ，將fc.tabWidth自動設置為空間寬度的某個倍數。默認情況下，字體設置為寬度8個空間。較低的值對單義字體更好，較高的值對於非單調字體的字體更好。

編寫自定義前端

該庫由兩個部分組成 - 字體處理後端（名為sttfont_* ）和SDL渲染前端（ sdl_stb_* ）。

為了使您自己的渲染前端擴展相關的sttfont_*類。有關詳細信息，請參見SDL實現。它約200行的代碼，您要做的就是取出特定的SDL特定內容並放入渲染器特定的內容中。在您的應用程序中，包括sttFont.h而不是sdlStbFont.h

預生化字形

您可以使用pregenGlyphs function ：

std::vector<sttfont_uint32_t_range> codepoint_ranges;
sttfont_uint32_t_range customRange;
customRange.start = 1337 ; customRange.end = 1444 ; // end is inclusive

sttfont_uint32_t_range::populateRangesLatin (codepoint_ranges); // add the Latin character set
sttfont_uint32_t_range::populateRangesCyrillic (codepoint_ranges); // add the Cyrillic character set
fc.pregenGlyphs(codepoint_ranges, 0 ); // generatess the glyps

如果您是在SDL中渲染的軟件，則不需要，只會放慢啟動。如果您使用的是使用紋理圖集（例如BGFX）的自定義前端，則建議這樣做。

從一個線程中生成文本並在另一個線程中渲染

使用producerConsumerExample.h 。有關工作示例，請參見producerConsumerExample.cpp 。

想法是，您實例化生產者和消費者線程之間共享的producer_consumer_font_cache對象。該對象的成員指向消費者使用的實際前端：

近活化：

producer_consumer_font_cache mPcCache ;
sdl_stb_font_cache mSdlFontCache ;


mPcCache .consumer_font_cache = & mSdlFontCache ;
	
sttfont_memory m;
m.data = &fontData[ 0 ];
m.size = fontData.size();
m.ownsData = false ;
	
mPcCache .faceSize = 24 ;		
mPcCache .loadFontManagedBoth(m); // Loads the font into both frontends

生產：

pcfc_prerendered_text prt;
mPcCache .renderTextToObject(&prt, " Prerendered text from Producer Thread! " ); // prt.handle now holds a handle
pcfc_handle h = mPcCache .pushText( 5 , 5 , " Hello World! " ); // use this instead of "drawText"
mPcCache .submitToConsumer(); // sends to consumer

消費：

 // <somehow send prt.handle and h to consumer thread>
// Suggestion: use a concurrentqueue (https://github.com/cameron314/concurrentqueue)
// and/or some kind of command buffer (https://github.com/SnapperTT/nanovg_command_buffer)
mPcCache .receiveFromProducer();
mPcCache .dispatchPrerenderJobs<sdl_stb_prerendered_text>(); // takes the prerended text and creates sdl_stb_prerended_text objects (invokes mPcCache.consumer_font_cache->renderTextToObject)

mPcCache .dispatchSinglePrerendered(prt.handle, 5 , 5 ); // actually draws the prerendered text
mPcCache .dispatchSingleText(h); // Renders "hello world" at 5,5

清理：

 // Cleanup - just let mPcCache fall out of scope
mPcCache .freeStoredPrerenderedText( true ); // deletes all prerendered text objects stored. true == also calls prt->freeTexture() for all prerendered text
										  // this is manual destruction as destroying a large number of objects can be expensive, esp. when you want to exit quickly
// Don't forget to delete mPcCache.consumer_font_cache if it was heap allocated
delete mPcCache .consumer_font_cache;

USERDATA：您可以和文本一起提交原始指針。

 mPcCahce.pushUserdata(void*); // producer
void* foo = mPcCahce.getUserdata(); // consumer

鎖定免費生產者消費者隊列

如果您不這樣做，則使用std::mutex將狀態從生產者傳遞到消費者。暫時緩衝區中只有一個插槽。您必須有一些機械設備才能停止，例如，生產商的運行速度比消費者快。

如果您想使用隊列，我建議Moodycamel :: ReaderWriterQueue。您可以使用producer_consumer_font_cache啟用它：

 #define SSF_CONCURRENT_QUEUE moodycamel::ReaderWriterQueue

進行更改的投票：

 if (mPcCache.receiveFromProducer()) { // wraps moodycamel::ReaderWriterQueue::try_dequeue()
	// have dequeued!
	}

清理（沖洗隊列）

 while (mPcCache.receiveFromProducer()) {
	// pulls stuff from the queue until its empty
	delete mPcCache.getUserdata(); // if we're using heap allocated userdata here is how to clear it
	}

格式的文字

打印格式的文字？

示例格式

首先創建一個sttfont_formatted_text 。上面的示例是由以下示例創建的：

sttfont_formatted_text formattedText;
formattedText << sttfont_format::black << " Plain text "
<< sttfont_format:: bold << " bold text "
<< sttfont_format:: italic << " italic text n "
<< sttfont_format:: underline << sttfont_format::green << " underline text t "
<< sttfont_format::strikethrough << " strikethrough text n "
<< sttfont_format::red << sttfont_format:: bold << " red bold t "
<< sttfont_format:: bold << " not red bold t "
<< sttfont_format::red << " red not bold n "
<< sttfont_format:: bold << sttfont_format:: italic		<< sttfont_format::colour( 255 , 127 , 50 ) << " custom colour t "
<< sttfont_format:: bold << sttfont_format::strikethrough	<< sttfont_format::colour( 127 , 255 , 50 ) << " bold strikethrough n "
<< sttfont_format:: bold << sttfont_format:: underline		<< sttfont_format::colour(  0 , 50 , 200 ) << " bold underline t "
<< sttfont_format:: italic << sttfont_format::strikethrough	<< sttfont_format::colour( 255 , 255 , 50 ) << " italic strikethrough n "
<< sttfont_format:: italic << sttfont_format:: underline		<< sttfont_format::colour( 127 , 50 , 255 ) << " italic underline "

您可以將格式選項與<<運算符相結合。插入字符串後重置格式。

然後，您可以使用用於簡單字符串（ drawText(x, y, formattedText)等）的相同功能渲染。這包括使用renderTextToObject呈現紋理。您可以使用一個簡單的字符串可以使用相同命名函數（ getTextSize ， getNumRows ， getCaretPos等）來完成的所有操作）

負載粗體/斜體字體變體？

為了使BOLD/斜體變體工作，您必須加載字體的粗體/斜體變體。對於粗體+斜體，您必須加載字體的粗體+斜體變體！該庫自動生成了下劃線和罷工。

加載變體後，加載基本字體後，使用addFormatFont或addFormatFontManaged 。如果您關心這些字體在BOLD/ITALIC中可用，則也應該為後備字體（用於多語言支持）進行此操作。

fc.loadFontManaged(notoSans);	// First font - loadFont
	fc.addFormatFontManaged(sttfont_format::FORMAT_BOLD, notoSansBold);
	fc.addFormatFontManaged(sttfont_format::FORMAT_ITALIC, notoSansItalic);
	fc.addFormatFontManaged(sttfont_format::FORMAT_BOLD | sttfont_format::FORMAT_ITALIC, notoSansBoldItalic);
fc.addFontManaged(notoSansArmenian);	// Fallback fonts - addFont
	fc.addFormatFontManaged(sttfont_format::FORMAT_BOLD, notoSansArmenianBold);
	fc.addFormatFontManaged(sttfont_format::FORMAT_ITALIC, notoSansArmenianItalic);
	fc.addFormatFontManaged(sttfont_format::FORMAT_BOLD | sttfont_format::FORMAT_ITALIC, notoSansArmenianBoldItalic);