notcurses下載 - notcurses源代碼下載

notcurses

C#源碼

v3.0.11—the frogurt is also cursed

下載

NotCurses：Blingful Tuis和角色圖形

它是：一個庫，促進現代終端模擬器上的複合物TUIS，以最大程度地支持生動的色彩，多媒體，線和Unicode。可以用Ncurses無法完成的NotCurs來完成事情。此外，這是狗屎的速度。不是：與源兼容的X/Open Curss實現，也不是對現有系統上的Ncurses的替換。

有關更多信息，請參見Dankwiki和The Man Pages。另外，還有doxygen輸出。要訂閱郵件列表，請發送電子郵件至[email protected]（電子郵件內容無關緊要）。我寫了一本連貫的指南，可以免費下載（或平裝購買）。

我還沒有添加許多記錄的示例，但是SRC/ POC/和SRC/ POCPP/分別包含許多小型C和C ++程序。 notcurses-demo涵蓋了NotCurses的大多數功能。

如果您在Docker中運行NotCurs，請諮詢下面的“環境筆記”。

Linux macos

介紹

NotCurses放棄了X/OPEN的curss API捆綁為單個Unix規範的一部分。有關某些必要的背景，請諮詢Thomas E. Dickey的出色和權威的Ncurses常見問題。因此，NotCurses並不是臨時詛咒的替代品。

盡可能地，NotCurses利用了帶有Ncurses的終端庫，從其可移植性和徹底性中受益匪淺。

NotCurses在工作站，電話，筆記本電腦和平板電腦上為交互式用戶打開了高級功能，可能是以工業和零售終端為代價的。從根本上講，詛咒假設最低限度，並允許您（努力）加強，而NotCurses則在必要時（本身）假設最大和逐步下降。後一種方法可能會破壞一些較舊的硬件，但前者的方法使新軟件看起來像舊硬件。

為什麼要使用這個非標準庫？

從一開始，線程安全性且在並行程序中有效使用。
比X/Open編碼的更有序的表面：將導出的標識符置於前綴，以避免常用名稱空間碰撞。在合理的情況下，使用static inline標準代碼。這有助於編譯器的優化，並減少加載時間。可以在沒有其多媒體功能的情況下構建NotCurses，這需要明顯較小的依賴項。
所有API本地支持通用字符集（UNICODE）。 nccell API基於Unicode的擴展石墨群概念。
視覺功能，包括圖像，字體，視頻，高對比度文本，精靈和透明區域。所有API本地支持的24位顏色，根據端子的必要性進行量化。
使用Sixel，Kitty甚至Linux Framebuffer控制台對位圖圖形的便攜式支持。
支持明確的鍵盤協議。
“ TUI模式”有助於高性能，非滾動，全屏應用。 “ CLI模式”支持Shell實用程序的滾動輸出，但具有NotCurses的全部功能。
它的全部許可是APACHE2的全部許可，而不是在幾個ACT中的戲劇（即Ncurses許可證）（後者總結為“ MIT-X11的重述”）。

以上大部分可以使用Ncurses，但它們不是Ncurses設計的目的。另一方面，如果您是針對工業或關鍵應用程序，或者希望從經過時間考驗的可靠性和可移植性中受益，則應一定要使用該精美的庫。

要求

最低版本通常表示我測試過的最古老的版本；很可能可以使用較舊的版本。讓我知道任何成功！

（構建）CMAKE 3.14.0+和C11編譯器
（可選）（openimageio，測試，C ++綁定）：A C ++ 17編譯器
（構建+運行時）來自ncurses：terminfo 6.1+
（構建+運行時）gnu libunistring 0.9.10+
（可選）（構建+運行時）libgpm 1.20+
（可選）（構建+運行時）來自qr-code-enerator：libqrcodegen 1.5.0+
（可選）（構建+運行時）來自ffmpeg：libswscale 5.0+，libavformat 57.0+，libavutil 56.0+，libavdevice 57.0+
（可選）（構建+運行時）OpenImageio 2.15.0+，需要C ++
（可選）（測試）醫生2.3.5+
（可選）（文檔）Pandoc 1.19.2+
（可選）（Python綁定）：Python 3.7+，CFFI 1.13.2+，Pypandoc 1.5+
（運行時）Linux 2.6+，FreeBSD 11+，Dragonfly BSD 5.9+，Windows 10 V1093+或MacOS 11.4+

有關構建和安裝的更多信息，請提供install.md中的信息。

包裝紙

如果您希望使用C與NotCurses一起使用以外的其他語言，則可以使用許多包裝紙。該存儲庫中包括一些，而其他則包括外部。

語言	鉛	存儲庫
艾達	傑里米·格羅斯（Jeremy Grosser）	JeremyGrosser/NotCursesada
C ++	Marek Habersack，尼克·布萊克	內部的
鏢	納爾遜·費爾南德斯（Nelson Fernandez）	kascote/dart_notcurses
朱莉婭	Dheepak Krishnamurthy	kdheepak/notcurses.jl
尼姆	小邁克爾·布拉德利（Michael S. Bradley）	Michaelsbradleyjr/Nim-Notcurses
Python	尼克·布萊克	內部的
Python	IGO95862	內部的
銹	何塞·路易斯·克魯茲（JoséLuisCruz）	dankamongmen/libnotcurses-sys
ZIG	Jakub Dundalek	Dundalek/notcurses-Zig-example

包括工具

將九個可執行文件安裝為NotCurses的一部分：

ncls ：在終端中顯示多媒體的ls
ncneofetch ：neofetch Ripoff
ncplayer ：渲染視覺媒體（圖像/視頻）
nctetris ：俄羅斯俄羅斯克隆
notcurses-demo ：一些演示代碼
notcurses-info ：檢測和打印終端功能/診斷
notcurses-input ：解碼和打印關鍵
notcurses-tester ：單位測試
tfman ：彎曲的手動瀏覽器

要從結帳中運行notcurses-demo ，請通過-p參數提供data目錄。需要數據文件的演示將中止。可以使用-d更改notcurses-demo中使用的基本延遲，接受浮點乘數。小於1的值將加快演示，而大於1的值將減慢其速度。

同樣notcurses-tester要求使用-p指定帶有必要數據文件的data 。它可以單獨運行，也可以通過make test 。

文件

使用-DUSE_PANDOC=on （默認），將通過doc/man構建完整的人頁和XHTML。以下降價文檔直接包括：

包裝商，開發人員和用戶的每次發布新聞。
TERM環境變量和各種終端模擬器。
關於貢獻和黑客的註釋。
有一個半完整的參考指南。
其他TUI庫的列表。
縮寫的歷史和感謝。
與詛咒和適應詛咒計劃的差異。

如果您（可以理解的是）想避免使用大型pandoc堆棧，但仍然喜歡手動頁面，我將發布帶有生成的男人/xhtml的tarball以及每個發行版。下載它，並按照您認為合適的方式安裝內容。

環境筆記

如果您的TERM變量是錯誤的，或者該終端定義是過時的，那麼您的時間將非常糟糕。僅使用適合終端的TERM值。如果此變量未定義，或者NotCurses無法加載指定的終點站條目，則它將拒絕啟動，並且您今天不會去太空。
NotCurses在啟動時查詢終端，從而基於確定的終端（甚至版本）啟用一些高級功能。但是，基本功能取自Terminfo。因此，如果您有小貓，但是TERM=vt100 ，您將能夠繪製RGBA位圖圖形（儘管這些東西對VT100來說只是一個夢想），但無法使用替代屏幕（儘管每個小貓版本都支持它）。因此， TERM和最新的終端數據庫仍然很重要。
確保將LANG環境變量設置為UTF8編碼的語言環境，並生成該語言環境。這通常意味著"[language]_[Countrycode].UTF-8" ，即en_US.UTF-8 。第一部分（ en_US ）應該作為/usr/share/locales中的目錄或符號鏈接存在。這通常需要編輯/etc/locale.gen和運行的locale-gen 。在Debian Systems上，可以通過dpkg-reconfigure locales來實現，並啟用所需的語言環境。默認的語言環境存儲在/etc/default/locale之類的地方。
如果您的終端可以選擇“模棱兩可的字符”（實際上是Unicode的技術術語）的默認解釋，請確保將其設置為寬而不是狹窄（如果不起作用，請確保將其設置為狹窄，heh）。
如果您的終端通過setaf和setbf （大多數現代終端）支持3x8bit RGB顏色，但是既不導出RGB和Tc終端功能，則可以將COLORTERM Environment變量導出為truecolor或24bit 。請注意，有些終端接受24位規範，但將其映射到更少的顏色。每當確定大多數現代終端時，RGB都是無條件啟用的。

字體

字形寬度，以及是否完全可以顯示字形，部分取決於字體配置。理想情況下，您的字體配置具有每個Unicode EGC的字形，並且每個字形的寬度與POSIX函數的wcswidth()結果匹配EGC。如果不是這種情況，您可能會因缺少字符而獲得空白或�（U+FFFD，替換字符），並且行上的後續字符可能會放錯位置。

值得知道幾個終端直接繪製塊字符，而不是從字體上加載它們。這通常是可取的。象限和六分子並不是展示您的設計品格的地方。要檢查您的環境對繪圖字符的渲染，請運行notcurses-info 。所需的輸出看起來應該像這樣：

常見問題解答

如果事情破裂或看起來不足，請諮詢環境筆記部分！您需要正確的TERM和LANG定義，並且可能需要COLORTERM 。

我可以在我的封閉源程序中使用NotCurses嗎？

NotCurses已在Apache2下獲得許可，這是我已經超越了您的物質商品，法定貨幣和封閉資源的小世界。在其中實現Microsoft Bob。為此充電。將其放入您的彈道導彈中，以便您可以很好地顯示上述導彈的速度和預計的產量；就在撞擊之前，在世界上所有的語言中滾動“他媽的你”，然後以智能調色板淡出將其關閉。將編譯的物體雕刻到磚塊上，然後將其郵寄給Richard Stallman，並在您的情況下嘲笑他。

我可以用notcurs編寫一個CLI程序（滾動，與外殼一樣）嗎？

是的！使用NCOPTION_CLI_MODE標誌（幾個真實標誌的別名；有關更多信息，請參見notcurses_init(1) 。您仍然必須明確渲染。

沒有這個巨大的多媒體堆棧，我可以沒有庫。

再次是！使用-DUSE_MULTIMEDIA=none 。

如果沒有上述多媒體堆棧，我可以構建這個單獨的NotCurses程序嗎？

幾乎令人難以置信，是的！使用notcurses_core_init()或ncdirect_core_init()代替notcurses_init() / ncdirect_init() ，並與-lnotcurses-core鏈接。您的應用程序可能會更快地啟動幾毫秒；更重要的是，它將針對最小的NotCurses安裝鏈接。

我們是通過電子付款的，沒有C ++編譯器。我們還能享受“毫無意義”的善良嗎？

其中一些！您將無法構建幾個可執行文件，也無法使用NCPP C ++包裝器，也無法使用OpenImageio Multimedia後端（OIIO Ships C ++標頭）構建。但是，您將能夠構建主庫，以及notcurses-demo （也許還有其他一些程序）。使用-DUSE_CXX=off 。

我想要FFMPEG還是OpenImageio？

雖然OpenImageio是一個出色的圖書館，用於處理單幀圖像，但其視頻支持並不完美（怪我；我一直保證Larry我會重寫它幾個月），並且在任何情況下都在... FFMPEG上實現。 FFMPEG是首選的多媒體後端。

它可以與硬件終端配合使用嗎？

有了正確的TERM值，支持許多硬件終端。通常，如果Terminfo數據庫條目表示強制性延遲，則NotCurses當前不會正確支持該終端。眾所周知，NotCurses可以驅動VT320和VT340，包括後者的六元圖。

如果我嘗試在不支持它們的終端上打開位圖圖形，會發生什麼？

除非終端對其表示支持，否則NotCurses不會使用位圖協議，即使已要求NCBLIT_PIXEL 。同樣，如果沒有Unicode 13支持等，則六月（ NCBLIT_3x2 ）將不會使用。NCVISUAL_BLIT ncvisual_blit()將使用可用的最佳空白，除非提供NCVISUAL_OPTION_NODEGRADE （在這種情況下會失敗）。

NotCurses看起來像是絕對的screen上的廢話。

screen不支持RGB顏色（至少截至4.08.00）；如果您定義了COLORTERM ，那麼您會有糟糕的時光。如果您的screen與--enable-colors256編輯，請嘗試導出TERM=screen-256color而不是TERM=screen 。

NotCurses在mosh中看起來像是絕對的廢話。

是的，確實如此。我還不確定發生了什麼。

在Windows終端中，NotCurses看起來像是絕對的廢話。

轉到語言設置，單擊“管理語言設置”，單擊“更改系統語言環境”，然後檢查“ beta：使用Unicode UTF-8獲取全球語言支持”選項。重新啟動計算機。這應該有所幫助。嘗試使用字體播放-Cascadia Code和Cascadia Mono似乎都可以正常工作（象限和盲文都可以使用），而康斯拉斯和Courlas和Courier New都有一定的問題。

我變得奇怪和/或複制的輸入在小貓/腳上。

NotCurses支持Kitty功能強大的鍵盤協議，該協議包括關鍵發行事件和修飾符按鍵。這意味著，除其他外，這些終端中的程序通常會立即獲得NC_ENTER NCTYPE_RELEASE事件，並且每個按鍵通常將至少導致至少兩個輸入。

您為什麼不只是將所有內容渲染到位圖？

那不是tui；這是一個緩慢而僵化的GUI。許多終端模擬器不支持位圖。它們與鼠標選擇不佳。 Sixels的調色板有限。話雖如此，Sixel和Kitty位圖協議都得到了很好的支持。

在按下其他鍵之前，我的多線程程序不會看到NCKEY_RESIZE 。

幾乎可以肯定，您無法在某個線程中掩蓋SIGWINCH ，並且該線程正在接收信號，而不是稱為notcurses_getc_blocking()的線程。結果， poll()不會中斷。在產生任何線程之前，請致電pthread_sigmask() 。

使用C ++包裝器，當我從main()返回時，如何確保運行NotCurses destructor？

如C ++常見問題解答中所述，將其包裹在人工範圍中（假設您的NotCurses示意為main() ）。

我如何隱藏以後要製作的飛機？

按照大多數性能的順序：使用ncplane_move_yx()將其移開屏幕，將其移動到帶有ncplane_move_below()的不透明平面下方，或使用ncplane_reparent()將其移動。

為什麼沒有ncplane_box_yx() ？你討厭正交，你呆板嗎？

ncplane_box()和朋友已經有太多論點，你是怪物。

為什麼不支持10或16位顏色？

NotCurses支持24位顏色，分佈在三個八位通道上。您大概是指每個通道的10位顏色。我需要這六個部分。當終端支持它時，NotCurses可能會支持它。

這個名字是愚蠢的。

那不是問題嗎？

儘管已經安裝了graphics/qr-code-generator ，但我並沒有在BSD上找到QRCodegen。

嘗試cmake -DCMAKE_REQUIRED_INCLUDES=/usr/local/include 。這是由bsd.port.mk通過的。

您支持Musl嗎？

我嘗試！您至少需要1.20。

我似乎只在ASCII中閃閃發光，並且/或總體上不能發出Unicode。

您的LANG環境變量未定義或錯誤地定義，或者您的機器上不存在必要的位置（您也可能明確提供NCOPTION_INHIBIT_SETLOCALE ，但從未稱為setlocale(3) ，在這種情況下不這樣做）。

使用nccell時，我幾乎總是需要ncplane 。後者為什麼不為前者提供指針？

除了巨大的冗餘之外， nccell還需要保持盡可能小，如果您無論如何都需要提及有效的ncplane nccell則幾乎總是便利的。

我在valgrind /asan下運行了我的NotCurses程序，它顯示了libtinfo.so的內存洩漏。因此，這是怎麼回事？

是的，除非彙編了一種特殊的，非標準的方式，否則NCURSES終端會洩漏內存（請參閱NCURSES FAQ）。這不應該是大量的；建議您不要擔心它。

我跑了notcurses-demo ，但是我的表號碼與charlatan的notcurs橫幅號碼不符。

notcurses-demo呈現出實際演示以外的幾個框架。

當我的程序退出時，我沒有光標，或者文字是看不見的，或者顏色很奇怪，噁心。

確保您在所有出口路徑上（包括致命的信號）上調用notcurses_stop() / ncdirect_stop() （默認情況下，默認情況下，notCurses安裝處理程序以使大多數致命信號完全執行此操作）。

如何將直接模式與libreadline結合使用？

您不能再過（直到2.4.1，但是新的輸入系統與之根本不兼容）。但是， ncdirect_readline()仍然存在，現在即使沒有庫，現在實際上也可以工作，儘管它當然不是庫。無論如何，使用ncreader使用CLI模式可能會更好。

那麼直接模式是棄用還是什麼？

它目前尚未棄用，並且肯定會收到錯誤相框。您可能會使用CLI模式（見上文）為您提供更好的服務，這在NotCurses開發（2.3.x系列）中較晚，但幾乎在各個方面都優於直接模式。使用Direct模式的唯一原因是，如果您要讓其他程序垃圾郵件來提高您的顯示。

直接模式聽起來很快！因為它是直接的。

直接模式比渲染模式慢得多。渲染模式假設它知道屏幕上的內容，並使用此信息來生成優化的逃生和字形序列。 Direct Mode編寫了被告知寫的所有內容。此外，它的能力差得多 - 所有小部件等都可以用於渲染模式，並且絕對不會擴展到直接模式。

會有爪哇包裝紙嗎？

我希望不要。如果您想要Java解決方案，請嘗試 @Klamonte的Jexer。秋天是個好女人，徹底。我們似乎已經整潔地分配了語言空間。

鑑於字形通道初始化為平面的透明，難道不應該將前景和背景初始化為透明嗎？

可能（默認情況下它們是初始化為不透明的）。不過，這將改變一些不曲的最長期行為，因此不會發生。

靜態鏈接時，我會發現鏈接器錯誤。

您是否要鏈接所有必要的庫？使用pkg-config --static --libs notcurses （或--libs notcurses-core ）來發現它們。

NotCurses立即在MSYS2/CYGWIN中退出。

NotCurses需要Windows Conpty層。從3.2.0起，默認情況下在Cygwin中可以使用，但默認情況下是MSYS的禁用。使用-P on啟動mintty在參數上，或在啟動它之前導出MSYS=enable_pcon 。

我可以避免手動出口COLORTERM=24bit嗎？

當然。將SendEnv COLORTERM添加到.ssh/config ，然後在遠程服務器上的sshd_config AcceptEnv COLORTERM 。是的，這可能需要在遠程服務器上root。不要怪我，伙計；我沒有這樣做。

在這裡的任意圖像操縱功能如何？

我不會擊敗ImageMagick等人。在圖像操作中，您可以使用ncvisual_from_rgba()從RGBA內存中加載ncvisual 。

我的程序在初始化過程中鎖定。

NotCurses詢問終端。如果終端未回复標準詢問，請提交一個notcurses錯誤，在補丁上游發送或使用其他終端。沒有已知的末端模擬器表現出這種行為。

我如何繪製一架大平面，只能使其中一部分可見？

最簡單的方法可能是在平面上方上方的相同尺寸的平面中創建一個平面，並保持其透明的區域和其餘的不透明。如果您希望可見的區域停留在顯示屏上的同一位置，但是看到的部分要變化，請嘗試在每個維度中製造一架飛機的大兩倍。使所需的區域透明，其餘不透明。現在，將原始平面移動到該平面後面，以使所需的區域與“孔”對齊。

為什麼沒有NCSTYLE_REVERSE ？

它會消耗寶貴的一點。您可以使用ncchannels_reverse()正確地倒轉前後顏色。

如何混合渲染模式？

你真的不想。您可以將子過程流到帶有ncsubproc小部件的平面上。

當不使用備用屏幕時，如何在渲染模式下以啟動模式清除屏幕？

notcurses_init notcurses_refresh() notcurses_init() 。

為什麼統計數據顯示編寫的Linux Framebuffer位圖字節要比寫入終端的總字節更多？當我SSH時，Linux控制台圖形為什麼不起作用？

Linux FrameBuffer圖形不是通過終端寫入實現的，而是直接寫入內存圖。該內存圖在遠程計算機上沒有可用，標準統計信息並未跟踪這些寫入。

NotCurses的所有格形式是什麼？

NotCurses'。我在第三版中引用了Garner的現代英語用法：“所有佔有主義。有人問：不是聖經的，還是古典？的確，這是兩者。

我只想在終端上顯示一個位圖。您的圖書館複雜而愚蠢。你很簡單又愚蠢。

如果您願意調用二進製文件，請使用NCPlayer在屏幕上的任何位置都放置圖像，並帶有所需的縮放圖片，並將其稱為一天。否則，請致電notcurses_init（） ， ncvisual_from_file（） ， ncvisual_blit（） ， notcurses_render（）和notcurses_stop（） 。這不太艱難。謝謝 - 您的周到的評論和欣賞的語氣就是為什麼我從事免費軟件的原因。