Viewnior 技术文档

1. 安装指南

1.1 系统要求

Viewnior 是一个轻量级的图像查看器，适用于大多数 Linux 发行版。安装前，请确保系统已安装以下依赖模块：

• glib
• GTK+
• gio
• shared-mime-info

这些模块可以从 GNOME 官方镜像站点或其他分发源获取。

1.2 安装方式

1.2.1 通过包管理器安装

对于大多数 Linux 发行版，可以通过包管理器直接安装 Viewnior。例如，在 Arch Linux 上，可以使用以下命令：

sudo pacman -S viewnior

1.2.2 从源码安装

如果需要从源码安装，可以按照以下步骤操作：

1. 下载源码包：

   wget https://github.com/hellosiyan/Viewnior/archive/viewnior-1.8.tar.gz
   

2. 解压源码包：

   tar zxvf viewnior-1.8.tar.gz
   

3. 进入源码目录：

   cd Viewnior-viewnior-1.8
   

4. 配置构建环境：

   meson --prefix=/usr builddir
   

5. 编译并安装：

   cd builddir
   ninja
   sudo ninja install
   

2. 项目使用说明

2.1 启动 Viewnior

安装完成后，可以通过命令行或桌面环境中的应用程序菜单启动 Viewnior。启动后，界面简洁，主要功能按钮位于顶部工具栏。

2.2 主要功能

• 全屏与幻灯片模式：支持全屏查看图像，并可设置幻灯片播放。
• 图像操作：支持旋转、翻转、裁剪、保存和删除图像。
• 动画支持：支持查看 GIF 等动画图像。
• 导航窗口：提供图像导航窗口，方便快速切换图像。
• 设置壁纸：支持将图像设置为桌面壁纸，适用于多种桌面环境。
• 元数据查看：支持查看 EXIF 和 IPTC 元数据。

2.3 配置鼠标动作

Viewnior 允许用户自定义鼠标动作，以提高操作效率。可以在设置中配置鼠标滚轮、双击等动作对应的功能。

3. 项目 API 使用文档

Viewnior 的核心功能基于 GtkImageView 库，并进行了优化和简化。以下是一些关键 API 的使用说明：

3.1 图像加载与显示

uni_image_view_new(); // 创建一个新的图像视图
uni_image_view_set_image(view, image); // 设置要显示的图像

3.2 图像操作

uni_image_view_rotate(view, angle); // 旋转图像
uni_image_view_flip(view, direction); // 翻转图像
uni_image_view_crop(view, rect); // 裁剪图像

3.3 全屏与幻灯片模式

uni_image_view_set_fullscreen(view, true); // 设置全屏模式
uni_image_view_start_slideshow(view); // 启动幻灯片播放

4. 项目安装方式

Viewnior 支持多种安装方式，包括通过包管理器安装和从源码编译安装。具体步骤请参考 安装指南。

---

通过以上文档，用户可以快速了解 Viewnior 的安装、使用及 API 调用方法，帮助用户更好地使用这一轻量级图像查看器。