Unity3D-Easy-Image-Viewer

English | 中文

---

一种快速的、轻量的、简单的 UGUI 图片查看器插件

---

  

_{查看效果与三种类型图片}

---

功能特性

• 点击任意带纹理的 UI 图片，一键呼出全屏查看器
• 放大倍率调整（滑条控制，实时显示倍率）
• 顺时针 / 逆时针 90 度旋转
• 水平 / 垂直翻转
• 一键恢复初始状态
• 放大后支持滚动浏览图片任意区域
• 小地图导航：右上角归一化显示整图 + 当前可视区域指示框（纯可视化）
• 兼容 Android / PC 等平台（纯 UGUI，无平台差异）

---

快速开始

Step 1 · 放置查看器

将预制体 Assets/Plugins/WPZ0325/EasyImageViewer/Resources/Canvas-image viewer.prefab 拖入场景（一个场景仅允许放置一个实例，运行时自动隐藏，点击图片时呼出）。

Step 2 · 标记可查看图片

在场景中任意带 Image / RawImage 的 UI 对象上挂载 EasyImageTag 组件，该图片即变为"可查看"，运行时点击它即可呼出查看器并显示其引用的纹理。

提示：不要求图片纹理必须加载自 Resources/StreamingAssets，直接引用即可。

运行！点击标记图片即可查看，按钮与滑条开箱即用。

---

组件说明

组件	挂载位置	职责
EasyImageTag	任意带 Image/RawImage 的 UI 对象	标记图片可查看，点击呼出查看器
EasyImageViewerCore	查看器预制体根节点	查看器核心：显示、缩放、旋转、翻转、复位、关闭、小地图
EasyImageViewerSetting	ScriptableObject 资产	查看器参数配置

参数配置

EasyImageViewerSetting（创建路径：Assets/Create/WPZ0325/Create SO/EasyImageViewer/EasyImageViewerSetting），可配置：

参数	默认值	说明
MinZoom	0.1	放大倍率最小值
MaxZoom	10	放大倍率最大值
InitialZoom	1	打开图片时的初始倍率（1 = 原始尺寸）

插件自带默认配置资产 EasyImageViewerSetting.asset，直接拖给 _setting 即可；不配置则使用内置默认值。