Adelie:基于Uxn的纯文本幻灯片制作工具

Adelie是一款基于Uxn的纯文本幻灯片工具,支持TGA图像、十六进制坐标定位、键盘/鼠标/游戏手柄控制,提供HEAD/TEXT文本绘制、LINK可点击区域、WAIT自动过渡等命令,适合技术演示和创意项目。

Adelie — 幻灯片程序

Adelie 是一款纯文本演示工具和格式。它用于通过 uxn 创建幻灯片。它具有少量命令,可快速在幻灯片上放置文本和图像,并可通过键盘、鼠标或游戏控制器操作。 该程序提供两种字体大小可选,并支持 TGA 图像。所有尺寸均使用十六进制数字。

快速开始

  • 命令
  • 控制
  • 制作幻灯片
  • 尺寸
  • Goto
  • 模式
  • 填充
  • 图片
  • 标题和文本
  • 链接
  • 演讲者视图
  • 演讲者备注
  • 停止
  • 等待
  • 矩形
  • 示例项目

快速开始

首先下载 adelie.rom(25kb)。如果您希望自行组装 rom,请参阅项目仓库。您必须拥有 Uxn 模拟器才能使用 Adelie。要运行幻灯片,请在终端窗口中导航到项目文件夹并输入:

1
uxnemu bin/adelie.rom slides.txt

命令

幻灯片文件每行包含一个命令或注释。

  • SIZE 设置幻灯片尺寸
  • NAME 设置幻灯片名称
  • GOTO 移动到绝对位置
  • LINK 创建链接区域
  • STOP 忽略幻灯片控制
  • WAIT 自动化幻灯片控制
  • MODE 设置文本颜色
  • PICT 绘制图片
  • HEAD 绘制标题
  • TEXT 绘制文本
  • FILL 填充背景
  • RECT 填充矩形

控制

  • mouse1 下一张幻灯片
  • mouse2 绘制标记
  • mouse3 上一张幻灯片
  • 上一张幻灯片
  • 下一张幻灯片
  • alt 上一张幻灯片
  • ctrl 下一张幻灯片
  • shift 切换链接视图

制作幻灯片

项目文本文件是一个纯文本文件,例如 myproject.txt,每行以 4 个大写字符的命令开头。 以下是一个全文本幻灯片(HEAD)的示例:

1
2
3
4
5
6
7
8
NAME Slide 1
FILL 00
GOTO 03,24
MODE 0f
HEAD Larger Header
MODE 08
MOVE 00,05
HEAD Smaller text`with a linebreak

这是一个包含文本和图像(PICT)的幻灯片:

1
2
3
4
5
6
NAME Slide 2
GOTO 00,00
PICT picture.tga
MOVE 30,02
MODE 0a
HEAD Picture name

尺寸

Adelie 使用十六进制数字,其中 10 到 15 的数字用字母 a 到 f 表示。因此,如果图像所需的文本位置在十进制中是 12,11,则十六进制等效值为 0c,0b。查看此十六进制表以获取转换帮助。 任何项目的默认比例为 768x448(30,1c)。在项目文本文件中指定尺寸(在文本文件顶部,幻灯片之前)将以该分辨率加载幻灯片。决定幻灯片大小时,必须使用 16 的倍数。

1
SIZE 30,1c ( 768 x 448 )

例如,如果所需尺寸为 720x480,则必须进行计算以获得 Adelie 的正确尺寸。720 和 480 必须分别除以 16,然后转换为十六进制。

1
2
3
720/16=45 十进制,或 0x2d 十六进制。
480/16=30 十进制,或 0x1e 十六进制。
结果:SIZE 2d,1e

Goto

命令 GOTO 用于在幻灯片中定位文本和图像。为了更轻松地在画布上放置图像,在幻灯片上中键单击将显示光标位置,在屏幕上以十字线和一组坐标标记。按 shift 键可从视图中移除标记。 在项目文本文件中,GOTO 命令必须位于其影响的文本或图像的正上方行。 示例:

1
2
GOTO 24,04
HEAD We began using`technology as little`as possible.

模式

MODE 命令指的是 uxn 中的“混合模式”。颜色由应用于项目的颜色主题确定。 Adelie 的颜色选项如下:

文本版本:

混合(DBCA)

0 4 8 c
1 5 9 d
2 6 a e
3 7 b f

填充

命令 FILL 将为幻灯片插入纯色背景。有关颜色信息,请参阅混合模式(上表)。 如果图像占据整个画布,则不需要填充,但如果图像在画布上重新定位,先前的幻灯片将在下方可见。添加填充将防止这种情况发生。

图片

命令 PICT 用于在幻灯片中添加图像。 Adelie 要求图像以 .tga 格式保存。将图像导出为 .tga 时,取消选中“RLE 压缩”框(如果出现该选项),并将“原点”下拉菜单中的“左下”更改为“左上”。 默认情况下,图像将在画布上居中(00,00),并可以使用 GOTO 后跟十六进制位置重新定位。

标题和文本

标题标记为 HEAD,子文本标记为 TEXT。标题文本较大,而子文本较小。 编写没有换行符 的文本将使文本保持连续短语,可能会溢出画布。不需要在 前后添加空格。 以下是用于制作上述幻灯片的文本:

1
2
3
4
5
6
7
8
NAME Power solutions
FILL 03
GOTO 04,03
PICT weeding.tga
GOTO 04,04
HEAD Doing away with`bloated toolchains.
GOTO 08,10
TEXT Weed out sources of waste.

链接

LINK 命令使画布上的区域可点击。使用 LINK,可以在 Adelie 中制作小游戏。 LINK 需要一个尺寸。在上面的示例中,两个企鹅脸充当两个单独的链接,可点击区域的大小由您决定(在上面的示例中,它覆盖了企鹅的头部)。要链接到特定幻灯片,请在尺寸后输入该幻灯片的名称。按 shift 查看可点击区域和幻灯片名称,再次按 shift 使其消失。 与 HEAD、TEXT 或 PICT 命令一样,需要 GOTO 将可点击区域定位在画布的所需部分。 使用 LINK 命令时,建议同时使用 STOP 命令,以便只能通过单击链接来通过幻灯片。 来自 Adelie 教程的带有链接的幻灯片示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
NAME Links
FILL 03
MODE 0c
GOTO 04,10
PICT etc/adelie3.tga
GOTO 24,10
PICT etc/adelie3.tga
GOTO 20,0c
HEAD Adelie Links
MOVE 02,07
TEXT You can make part of a slide clickable using the LINK command.`Press shift to see a slide's links.
MODE 06
GOTO 08,24
LINK 1c,10 Introduction
GOTO 28,24
LINK 1c,10 Hidden Slide
STOP

演讲者视图

如果进行演示,按 SHIFT 会在左上角显示一个计时器,如果演示有时间限制,这很理想,并使当前和下一张幻灯片的信息可见。 在此模式下,还可以在幻灯片本身上绘制,以添加注释或滑稽的图画。

如果再次按 SHIFT,所有注释将被擦除。

演讲者备注

制作演示文稿时,我们喜欢为每张幻灯片保留备注,作为提醒。

备注打印在终端中,并随幻灯片更改。 备注应插入与幻灯片相同的文件中,每张幻灯片之后(在所有图像、文本和位置信息之后)。我们喜欢添加缩进以使文本更易于阅读。 示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
NAME [rek] Rek, Dev and Pino
FILL 03
GOTO auto
PICT media/rekdev.tga

  Im Rek, & this is Devine, and together we form the Hundred Rabbits artist collective.
  Since 2016, we have lived aboard a 10-meter long sailboat, named Pino,
  We make art, games, books, as well as tools for drawing, writing, composing music.
    Including this slideshow program.

NAME [rek] boat vivarium
FILL 03
GOTO 17,03
PICT media/pino.tga
GOTO 0a,12
MODE 05
HEAD Boat vivarium
GOTO 0a,18
TEXT At sea, a boat is an island.

  With our boat, we have circumnavigated the Pacific Ocean.
    We started in Western Canada, sailed to Mexico,
    then across all the South Pacific Islands to NZ,

停止

STOP 命令忽略所有幻灯片控制。 如果制作带有可点击链接的幻灯片,使用 STOP 会禁用幻灯片控制,以便用户无法在不选择链接的情况下前进。它还用于停止具有一些自动化幻灯片的幻灯片(使用 WAIT 命令)。

等待

WAIT 命令充当计时器,以自动化幻灯片之间的过渡,用于创建小动画序列等。 时间以十六进制表示。01 是 1/60 秒,02 是 2/60 秒,40 是 128 等。 示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
NAME Drawing Keywords
FILL 03
GOTO 2c,08
MODE 0c
PICT etc/adelie1.tga
GOTO 04,0d
HEAD Drawing Keywords
WAIT 40

NAME Drawing: Mode
GOTO 06,15
TEXT MODE
MOVE 09,00
TEXT mode
MOVE 09,00
TEXT set blending mode
WAIT 08

矩形

要在画布上绘制矩形,请使用命令 RECT 以及位置。

示例文件

这是一个 4 张幻灯片的项目示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
SIZE 2d,1e

NAME logo
GOTO 00,00
PICT media/nime.tga

NAME 100r logo
FILL 03
GOTO 00,00
PICT media/100r.tga

NAME Rek and Dev
FILL 03
GOTO 00,00
PICT media/rekdev.tga

NAME Setup
FILL 03
GOTO 0d,00
PICT media/sailing.tga
GOTO 04,05
MODE 05
HEAD Living & working`from a sailboat.
GOTO 08,12
TEXT Name: Pino`Make: Yamaha`Length: 10m`Made: 1982`Origin: Shizuoka, Japan

Adelie 能够处理更复杂的项目,可以使用 WAIT、STOP、PATT(未记录)制作动画幻灯片过渡。参见此示例项目(Mastodon)。 源代码:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
NAME --
PATT 81 00 00 00 00 00 00 81
FILL 0f
WAIT 08
NAME --
PATT c3 81 00 00 00 00 81 c3
FILL 0f
WAIT 08
NAME --
PATT e7 c3 81 00 00 81 c3 e7
FILL 0f
WAIT 08
NAME --
PATT ff e7 c3 81 81 c3 e7 ff
FILL 0f
WAIT 08
NAME --
PATT ff ff e7 c3 c3 e7 ff ff
FILL 0f
WAIT 08
NAME --
PATT ff ff ff e7 e7 ff ff ff
FILL 0f
WAIT 08
NAME --
PATT ff ff ff ff ff ff ff ff
FILL 0f
WAIT 08

许可证

该许可证适用于所有记录的项目、项目本身及其资产。本网站的源代码和我们的应用程序遵循 MIT 许可证,但本网站和我们的应用程序的资产和文本内容遵循 BY-NC-SA4.0 许可证。我们很高兴传递知识,其他人可以从我们的项目中学习、改进它们或将它们变成其他有用的东西。请勿转售或铸造我们的作品,这样做非常懒惰,并且对我们不尊重。 您可以在 Sourcehut 上找到我们最近的项目。

comments powered by Disqus
使用 Hugo 构建
主题 StackJimmy 设计