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中的信息。

包装纸

If you wish to use a language other than C to work with Notcurses, numerous wrappers are available.该存储库中包括一些，而其他则包括外部。

语言	铅	存储库
艾达	杰里米·格罗斯（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模式的唯一原因是，如果您要让其他程序垃圾邮件来提高您的显示。

直接模式听起来很快！因为它是直接的。

直接模式比渲染模式慢得多。 Rendered mode assumes it knows what's on the screen, and uses this information to generate optimized sequences of escapes and glyphs. 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（） 。这不太艰难。谢谢 - 您的周到的评论和欣赏的语气就是为什么我从事免费软件的原因。