Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jenly1314/libyuv

:rainbow: 基于Google的libyuv编译封装的YUV转换工具库，主要用途是在各种YUV与RGB之间进行相互转换、裁减、旋转、缩放、镜像等。（用法超简单）
https://github.com/jenly1314/libyuv

fourcc fourcc-codes i420 nv21 rgb2yuv yuv yuv-tool yuv2rgb yuv420

Last synced: 2 months ago
JSON representation

:rainbow: 基于Google的libyuv编译封装的YUV转换工具库，主要用途是在各种YUV与RGB之间进行相互转换、裁减、旋转、缩放、镜像等。（用法超简单）

Host: GitHub
URL: https://github.com/jenly1314/libyuv
Owner: jenly1314
License: apache-2.0
Created: 2023-04-30T11:56:28.000Z (over 1 year ago)
Default Branch: master
Last Pushed: 2024-01-27T14:53:30.000Z (12 months ago)
Last Synced: 2024-01-27T15:50:50.172Z (12 months ago)
Topics: fourcc, fourcc-codes, i420, nv21, rgb2yuv, yuv, yuv-tool, yuv2rgb, yuv420
Language: C++
Homepage:
Size: 5.99 MB
Stars: 8
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # LibYuv

[![Download](https://img.shields.io/badge/download-App-blue.svg)](https://raw.githubusercontent.com/jenly1314/libyuv/master/app/release/app-release.apk)

[![MavenCentral](https://img.shields.io/maven-central/v/com.github.jenly1314/libyuv)](https://repo1.maven.org/maven2/com/github/jenly1314/libyuv)

[![JitPack](https://jitpack.io/v/jenly1314/libyuv.svg)](https://jitpack.io/#jenly1314/libyuv)

[![CI](https://github.com/jenly1314/libyuv/workflows/build/badge.svg)](https://github.com/jenly1314/libyuv/actions)

[![CircleCI](https://circleci.com/gh/jenly1314/libyuv.svg?style=svg)](https://circleci.com/gh/jenly1314/libyuv)

[![API](https://img.shields.io/badge/API-21%2B-blue.svg?style=flat)](https://android-arsenal.com/api?level=21)

[![License](https://img.shields.io/badge/license-Apche%202.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)

LibYuv：基于Google的libyuv编译封装的YUV转换工具库，主要用途是在各种YUV与RGB之间进行相互转换、裁减、旋转、缩放、镜像等。

## Gif 展示

![Image](GIF.gif)

> 你也可以直接下载 [演示App](https://raw.githubusercontent.com/jenly1314/libyuv/master/app/release/app-release.apk) 体验效果

## 引入

### Gradle:

1. 在Project的 **build.gradle** 或 **setting.gradle** 中添加远程仓库

    ```gradle

    repositories {

        //...

        mavenCentral()

    }

    ```

2. 在Module的 **build.gradle** 里面添加引入依赖项

    ```gradle

    // AndroidX 

    implementation 'com.github.jenly1314:libyuv:1.0.0'

    ```

## 使用

### 使用概要

LibYuv中的功能方法主要包括：格式转换、裁减、旋转、缩放、镜像等；下面就以文档注释的形式对一些主要的方法做个简要说明。

#### 格式转换

```java

/**

 * 将Image转换为I420

 *

 * @param image   图像；{@link Image}

 * @param degrees 需要旋转的角度

 * @return 返回I420数据

 */

LibYuv.imageToI420(image, degrees)

```

```java

/**

 * NV21转I420

 *

 * @param nv21Data 源NV21数据

 * @param width    图像宽度

 * @param height   图像高度

 * @return 返回I420数据

 */

LibYuv.nv21ToI420(nv21Data, width, height)

```

```java

/**

 * I420转NV21

 *

 * @param i420Data 源I420数据

 * @param width    图像宽度

 * @param height   图像高度

 * @return 返回NV21数据

 */

LibYuv.i420ToNv21(i420Data, width, height)

```

##### 通用格式转换（各种YUV与RGB之间相互转换）

```java

/**

 * 将I420数据转换为指定格式的数据

 *

 * @param i420Data 源I420数据

 * @param width    图像宽度

 * @param height   图像高度

 * @param fourcc   指定数据格式；{@link FourCC}

 * @return 返回转换成指定格式后的数据

 */

LibYuv.convertFromI420(i420Data, width, height, fourcc)

```

```java

/**

 * 将指定格式的数据转换为I420数据

 *

 * @param srcData 源数据

 * @param width   图像宽度

 * @param height  图像高度

 * @param fourcc  指定数据格式；{@link FourCC}

 * @return 返回I420数据

 */

LibYuv.convertToI420(dstData, width, height, fourcc)

```

#### 旋转

```java

/**

 * 将指定格式的数据进行旋转

 *

 * @param srcData 源数据

 * @param width   图像宽度

 * @param height  图像高度

 * @param degrees 需要旋转的角度；{@link  RotationMode}

 * @param fourcc  指定数据格式；{@link FourCC}

 * @return 返回旋转后的数据

 */

LibYuv.rotate(srcData, width, height, degrees, fourcc)

```

#### 缩放

```java

/**

 * 将指定格式的数据进行缩放

 *

 * @param srcData    源数据

 * @param width      图像宽度

 * @param height     图像高度

 * @param dstWidth   目标宽

 * @param dstHeight  目标高

 * @param fourcc     指定数据格式；{@link FourCC}

 * @param filterMode 压缩过滤模式；{@link  FilterMode}

 * @return 返回缩放后的数据

 */

LibYuv.scale(srcData, width, height, dstWidth, dstHeight, fourcc, filterMode)

```

#### 裁减

```java

/**

 * 将指定格式的数据进行裁减

 *

 * @param srcData  源数据

 * @param width    图像宽度

 * @param height   图像高度

 * @param cropRect 裁减的矩形区域

 * @param fourcc   指定数据格式；{@link FourCC}

 * @return 返回裁减后的数据

 */

LibYuv.crop(srcData, width, height, cropRect, fourcc)

```

#### 镜像

```java

/**

 * 将指定格式的数据进行镜像翻转

 *

 * @param srcData 源数据

 * @param width   图像宽度

 * @param height  图像高度

 * @param fourcc  指定数据格式；{@link FourCC}

 * @return 返回镜像翻转后的数据

 */

LibYuv.mirror(srcData, width, height, fourcc)

```

更多使用详情，请查看[app](app)中的源码使用示例或直接查看 [API帮助文档](https://jitpack.io/com/github/jenly1314/libyuv/latest/javadoc/)

**温馨提示**

* 关于**FourCC** 说明；在 **[FourCC](libyuv/src/main/java/com/king/libyuv/FourCC.java)** 中定义了很多数据格式类型（各种YUV与RGB格式；例如：I420、I422、NV21、NV12、ARGB、BGRA等）；

> 在使用各转换方法时，明确转换前和转换后的数据格式类型，这一点很重要。

* 还有个小细节需要注意，如果在转换过程中出现转换结果图像的颜色与源图像颜色不一致时，很大可能是数据格式的问题；也就是数据的排列顺序不对，这时只需修改下入参的数据格式就行。

> 比如：当使用 **RGBA** 数据进行转换操作时，在使用LibYuv时数据的排列顺序是反的，这时需使用 **ABGR** 来表示这个排列（即：指定数据格式为：`FourCC.FOURCC_ABGR`）

## 相关推荐

#### [CameraScan](https://github.com/jenly1314/CameraScan) 一个简化扫描识别流程的通用基础库

## 版本记录

#### v1.0.0：2023-4-30

* libyuv初始版本

## 赞赏

如果您喜欢libyuv，或感觉libyuv帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢 :smiley:

您也可以扫描下面的二维码，请作者喝杯咖啡 :coffee:



   



## 关于我

| 我的博客                                                                                | GitHub                                                                                  | Gitee                                                                                  | CSDN                                                                                 | 博客园                                                                            |

|:------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------|

| Jenly's Blog | jenly1314 | jenly1314  | jenly121  | jenly  |

## 联系我

| 微信公众号        | Gmail邮箱                                                                          | QQ邮箱                                                                              | QQ群                                                                                                                       | QQ群                                                                                                                       |

|:-------------|:---------------------------------------------------------------------------------|:----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|

| [Jenly666](http://weixin.qq.com/r/wzpWTuPEQL4-ract92-R) | jenly1314 | jenly1314 | 20867961 | 64020761 |