TpImage 类
V0.2.1TpUtils
2025-11-14
介绍
图像处理类；用于加载图片资源，提供缩放、模糊等功能
基础信息
| 头文件: | include <TpImage.h> |
|---|---|
| Cmake: | None |
| 发布版本: | V0.2.1 |
| 继承类: | |
| 派生类: |
Public 类型
enum TpImage::ImageType
| 名称 | 值 | 描述 |
|---|---|---|
| SVG_FMT | 0 | |
| JPG_FMT | 1 | |
| PNG_FMT | 2 | |
| WEBP_FMT | 3 |
Public 成员函数
| TpImage(const TpString &fileName="") | ||
|---|---|---|
| TpImage(const TpImage &other) | ||
| ~TpImage() | ||
| load(const TpString &filename) | 加载图片资源文件，支持png, jpg, webp, SVG | |
| load(void *martix, const TpSize &size, const TpRect &clipRect=TpRect()) | 指定资源buffer加载数据；当前仅支持ARGB格式 | |
| TpImage TpImage::scaled | scaled(const TpSize &size, bool keepAspectRatio=true) | 指定size对图片进行缩放 |
| TpImage TpImage::scaled | scaled(const int32_t &width, const int32_t &height, bool keepAspectRatio=true) | 指定size对图片进行缩放 |
| width() const | 获取surface的宽度 | |
| height() const | 获取surface的高度 | |
| isNull() | 图片资源是否为空；是否加载了图片 | |
| virtual TpImage TpImage::copy | copy(const TpRect &rect) | 指定矩形拷贝对象 |
| virtual TpImage TpImage::copy | copy(int32_t x, int32_t y, int32_t w, int32_t h) | 指定矩形拷贝对象 |
| virtual TpImage TpImage::rotate | rotate(const float &angle) | 指定文件绝对路径保存资源文件数据 |
| rotateAngle() const | 获取旋转角度 | |
| isRotated() const | 获取图片是否旋转 | |
| TpImage & TpImage::operator= | operator=(const TpImage &others) |
成员函数说明
TpImage::TpImage(const TpString &fileName="")
暂无注释...
TpImage::TpImage(const TpImage &other)
暂无注释...
virtual TpImage::~TpImage()
暂无注释...
virtual bool TpImage::load(const TpString &filename)
加载图片资源文件，支持png, jpg, webp, SVG...
加载图片资源文件，支持png, jpg, webp, SVG
参数：filename: 资源文件路径
返回值：加载结果
virtual bool TpImage::load(void *martix, const TpSize &size, const TpRect &clipRect=TpRect())
指定资源buffer加载数据；当前仅支持ARGB格式...
指定资源buffer加载数据；当前仅支持ARGB格式
参数：martix: 数据buffer
参数：size: 资源图片尺寸
参数：rect: 裁剪矩形；为空则默认全部加载
返回值：加载结果
TpImage TpImage::scaled(const TpSize &size, bool keepAspectRatio=true)
指定size对图片进行缩放...
指定size对图片进行缩放
参数：size: 缩放后的尺寸
参数：keepAspectRatio: 是否保持纵横比
返回值：缩放后的资源对象
TpImage TpImage::scaled(const int32_t &width, const int32_t &height, bool keepAspectRatio=true)
指定size对图片进行缩放...
指定size对图片进行缩放
参数：width: 缩放后的宽度
参数：height: 缩放后的高度
参数：keepAspectRatio: 是否保持纵横比
返回值：缩放后的资源对象
virtual int32_t TpImage::width() const
获取surface的宽度...
获取surface的宽度
返回值：宽度值
virtual int32_t TpImage::height() const
获取surface的高度...
获取surface的高度
返回值：高度值
virtual bool TpImage::isNull()
图片资源是否为空；是否加载了图片...
图片资源是否为空；是否加载了图片
返回值：加载结果
virtual TpImage TpImage::copy(const TpRect &rect)
指定矩形拷贝对象...
指定矩形拷贝对象
参数：rect: 拷贝矩形，将原始图片裁剪此矩形后返回新对象
返回值：新的图像管理对象
virtual TpImage TpImage::copy(int32_t x, int32_t y, int32_t w, int32_t h)
指定矩形拷贝对象...
指定矩形拷贝对象
参数：x: 裁剪X坐标
参数：y: 裁剪Y坐标
参数：w: 裁剪宽度
参数：h: 裁剪高度
返回值：新的图像管理对象
virtual TpImage TpImage::rotate(const float &angle)
指定文件绝对路径保存资源文件数据...
指定文件绝对路径保存资源文件数据
旋转图片；返回新对象，不会修改原始对象
参数：filename: 文件绝对路径
参数：type: 新存储文件类型
参数：jpguality: 存储质量,取值范围[0, 100]
参数：angle: 旋转角度；顺时针旋转，3点钟方向为0°
返回值：保存结果
返回值：旋转后的新对象
virtual float TpImage::rotateAngle() const
获取旋转角度...
获取旋转角度
返回值：旋转角度
virtual bool TpImage::isRotated() const
获取图片是否旋转...
获取图片是否旋转
返回值：旋转的返回true，否则返回false
