rx site git book
一款现代简约的像素（pixel）编辑器。
一款开源的免费软件，由 rust-lang 编程语言开发。
- 绘图,对称绘图， 多帧绘图
- 视图编辑
- 调色版
- 脚本
安装
使用命令行安装
cargo install \
--git https://github.com/cloudhead/rx \
--tag v0.4.0
或者获取源码编译安装，需要安装rust环境。
git clone https://github.com/cloudhead/rx
cd rx
cargo install --path .
命令软件会自动安装到 ~/.cargo/bin/ 文件夹中，需要将该路径加入 环境变量 $PATH 中。
使用
rx 命令来打开编辑器,这是一个基于命令的编辑器，现阶段类似于 vim 方式来操作。
rx
默认的配置文件夹 ~/.config/rx 。
~/.config/rx/palettes/ 中可以放置 palette 配色版，然后可以在编辑器中调用。
模式
- normal 默认模式， 其他模式下按
ESC来退入到 normal 模式。 - visual 视图模式, 输入
:visual或者快捷键v进入视图模式。 - command 命令模式 , 类似vim 输入
:进入命令模式，输入命令后回车执行。
| mode | command | shortcuts | note |
|---|---|---|---|
| N,V | :zoom - | , | 缩小视图 |
| N,V | :zoom + | . | 放大视图 |
| N | :zoom 1.0 | / | 默认大小视图 |
| N | :pan <x> <y> | 空间移动 | |
| up,down,left,right | 移动视图 | ||
| space | 鼠标移动视图 | ||
| N,V | :v/center | z | 居中活动视图 |
| N | :v/prev | tab | 上一个视图 |
| N | :v/next | 下一个视图 |
绘图
| mode | command | shortcuts | note |
|---|---|---|---|
| N | :brush/size - | [ | 画笔缩小 |
| N | :brush/size + | ] | 画笔放大 |
| N | :brush/set <m> | 设置模式（可叠加） | |
| N | :brush/set multi | shift | 同时多个帧处理 |
| N | :brush/set perfect | = | |
| N | :brush/unset <m> | 取消行文模式 | |
| N | :brush/toggle <m> | 切换模式 | |
| N | ctrl | 取色 | |
| N | :swap | x | 前景色背景色互换 |
| N | :undo | u | 取消 |
| N | :redo | r | 充值 |
| N | :set checker=on | 打开检查器 |
- erase: 擦除像素，实际为设置透明像素
- multi: 在多帧视图上同时操作 , 使用
shift按键可以实现 - xsym: x轴 水平对称绘画
- ysym: y轴 垂直对称绘画
- perfect: "pixel-perfect" mode.
- xray: see the underlying pixel color at all times.
网格 Grid
| mode | command | shortcuts | note |
|---|---|---|---|
| N | :set grid | 打开网格 | |
| N | :set grid/spacing = <w> <h> | 网格大小 | |
| N | :set grid/color = #ff0000 | 网格颜色 |
动画 Animation
| mode | command | shortcuts | note |
|---|---|---|---|
| N | :set animation/delay = 250 | 设定时间 millisconds | |
| N | :f/add | return | 为当前视图追加帧 |
| N | :f/remove | backspace | 删除 |
| N | :f/clone | 当前视图复制帧 |
常按
shift实现:brush/set multi多帧绘制模式。
视图模式
视图边框变为红色，鼠标可以选择，移动操作。
| mode | command | shortcuts | note |
|---|---|---|---|
| N | :visual | v | 视图模式进入 |
| V | :selection/expand | \ | 向上选择视图 |
| V | :selection/jump | w, b | 视图切换帧 |
| V | :selection/jump | h,j,k,l | 像素单位移动 |
| V | :selection/yank | y | 复制选择的范围 |
| V | :selection/paste | p | 粘贴复制的范围 |
| V | [ | 缩小选择的范围 | |
| V | ] | 放大选择的范围 | |
| V | f | 前景色填充选择的范围 | |
| V | d | 剪切选择的范围 | |
| V | e | 删除选择的范围 |
esc 退出
视图模式下十分类似vim操作
文件保存和加载
| command | note |
|---|---|
:e <file> | 保存文件，默认 png |
:w [<file>] | 新建/编辑文件 |
:slice <size> | 文件视图分割 |
:f/resize <size> <size> | 文件视图帧尺寸 |
:cd <dir> | 切换目录 |
| :q | 退出视图 |
| :q! | 强制退出视图 |
| :qa! | 强制退出所有视图 |
设定
| command | note |
|---|---|
:set <command> [= value] | 设定, on/off 可以省略 |
:unset <command> | 取消设定 |
:set background = <color> | 十六进制背景色 |
:set vsync = <bool> | 垂直刷新 on/off |
:toggle <command> | on/off 命令的反选 |
:echo <command> | 显示设定的值 |
:source <file.rx> | 加载脚本 |
| :help | 帮助 |
- config/dir 配置所在
map 映射快捷键
语法
-- 设定快捷键执行命令
:map <key> <:command>
-- 设定快捷键 按下(pressed) 执行命令1，released(松开按键) 执行命令2
:map <key> <:command1> {<:command2>}
-- 清除命令映射
:map/clear!
例如
map e :brush/set erase {:brush/unset erase}
palettes 调色板
| command | note |
|---|---|
| :p/clear | 清空调色板 |
:p/add <color> | 追加色彩 |
| :p/sample | 加载 |
| :p/sort | 排序 |
:p/write <path> | 保存调色板 |
rx 脚本
通过 :source xxx.rx 加载 rx 脚本，rx 命令是以 : 开始，脚本则不需要，注释使用 -- 开头。
set checker
p/clear
p/add #ff0000
p/add #00ff00
p/add #0000ff