diff --git a/thirdparty/libass/HPKBUILD b/thirdparty/libass/HPKBUILD new file mode 100644 index 0000000000000000000000000000000000000000..fecd49194a164d8e08a7037c7950bcde72557b2e --- /dev/null +++ b/thirdparty/libass/HPKBUILD @@ -0,0 +1,81 @@ +# Contributor: 小肉头君 +# Maintainer: 小肉头君 + +pkgname=libass +pkgver=0.17.1 +pkgrel=0 +pkgdesc="libass is a portable subtitle renderer for the ASS/SSA (Advanced Substation Alpha/Substation Alpha) subtitle format." +url="https://github.com/libass/libass" +archs=("armeabi-v7a" "arm64-v8a") +license=("ISC License") +depends=("freetype2" "fribidi" "harfbuzz" "libpng" "zlib" "fontconfig") # fontconfig是测试需要的三方库 +makedepends=() +source="https://github.com/$pkgname/$pkgname/archive/refs/tags/$pkgver.tar.gz" + +autounpack=true +downloadpackage=true +buildtools="configure" + +builddir=$pkgname-$pkgver +packagename=$builddir.tar.gz + +source envset.sh +autogenflag=true +host= +prepare() { + mkdir -p $builddir/$ARCH-build + if [ $ARCH == "armeabi-v7a" ] + then + setarm32ENV + host=arm-linux + fi + if [ $ARCH == "arm64-v8a" ] + then + setarm64ENV + host=aarch64-linux + fi + + if $autogenflag + then + cd $builddir + ./autogen.sh > `pwd`/build.log 2>&1 + cd $OLDPWD + autogenflag=false + fi +} + +build() { + cd $builddir/$ARCH-build + FREETYPE_CFLAGS="-I${LYCIUM_ROOT}/usr/freetype2/$ARCH/include/freetype2 ${LYCIUM_ROOT}/usr/bzip2/$ARCH/lib/libbz2.a ${LYCIUM_ROOT}/usr/brotli/$ARCH/lib/libbrotlicommon.so ${LYCIUM_ROOT}/usr/brotli/$ARCH/lib/libbrotlienc.so ${LYCIUM_ROOT}/usr/brotli/$ARCH/lib/libbrotlidec.so -lz" FREETYPE_LIBS="${LYCIUM_ROOT}/usr/freetype2/$ARCH/lib/libfreetype.a" FONTCONFIG_CFLAGS="-I${LYCIUM_ROOT}/usr/fontconfig/$ARCH/include/ ${LYCIUM_ROOT}/usr/libxml2/$ARCH/lib/libxml2.so" FONTCONFIG_LIBS="${LYCIUM_ROOT}/usr/fontconfig/$ARCH/lib/libfontconfig.so" PKG_CONFIG_PATH="${pkgconfigpath}" ../configure "$@" --enable-test --enable-static --host=$host > `pwd`/build.log 2>&1 + make -j4 >> `pwd`/build.log 2>&1 + # 对最关键一步的退出码进行判断 + ret=$? + cd $OLDPWD + return $ret +} + +package() { + cd $builddir/$ARCH-build + make install >> `pwd`/build.log 2>&1 + cd $OLDPWD + if [ $ARCH == "armeabi-v7a" ] + then + unsetarm32ENV + fi + if [ $ARCH == "arm64-v8a" ] + then + unsetarm64ENV + fi + unset host +} + +check() { + echo "The test must be on an OpenHarmony device!" + # real test + # 测试时需要把Unbutu中的usr/share/fonts打包推送到ohos设备中,放在ohos设备同一路径中 + # ./test/test testass.png ../compare/test/sub1.ass 0.03 +} + +cleanbuild(){ + rm -rf ${PWD}/$builddir #${PWD}/$packagename +} \ No newline at end of file diff --git a/thirdparty/libass/README.OpenSource b/thirdparty/libass/README.OpenSource new file mode 100644 index 0000000000000000000000000000000000000000..10b00c35ebb6545e4b3cddb9502534e18fa1075b --- /dev/null +++ b/thirdparty/libass/README.OpenSource @@ -0,0 +1,11 @@ +[ + { + "Name": "libass", + "License": "ISC License", + "License File": "COPYING", + "Version Number": "0.17.1", + "Owner": "chenbaodi@huawei.com", + "Upstream URL": "https://github.com/libass/libass/releases/download/0.17.1/libass-0.17.1.tar.gz", + "Description": "libass is a portable subtitle renderer for the ASS/SSA (Advanced Substation Alpha/Substation Alpha) subtitle format." + } +] diff --git a/thirdparty/libass/README_zh.md b/thirdparty/libass/README_zh.md new file mode 100644 index 0000000000000000000000000000000000000000..587801aaf94d1b065bbf6bb8525794562b2da1e3 --- /dev/null +++ b/thirdparty/libass/README_zh.md @@ -0,0 +1,12 @@ +# kissfft三方库说明 +## 功能简介 +libass库则是一个轻量级的对ASS/SSA格式字幕进行渲染的开源库。 +## 使用约束 +- IDE版本:DevEco Studio 3.1 Beta2 +- SDK版本:ohos_sdk_public 3.2.11.9 (API Version 9 Release) +- 三方库版本:0.17.1 +- 当前适配的功能:支持ASS/SSA格式字幕进行渲染 +- [ISC License](https://github.com/libass/libass/blob/master/COPYING) + +## 集成方式 ++ [应用hap包集成](docs/hap_integrate.md) diff --git a/thirdparty/libass/SHA512SUM b/thirdparty/libass/SHA512SUM new file mode 100644 index 0000000000000000000000000000000000000000..e0bd7712fb83bc3014f60c47c1606710651457a0 --- /dev/null +++ b/thirdparty/libass/SHA512SUM @@ -0,0 +1 @@ +8bc83347c87c47577cd52230b3698c34301250e9a23f190a565c913defcd47a05695a4f7d9cd2e9a6ad0cfc6341e8ea2d6d779b1d714b2d6144466d2dea53951 libass-0.17.1.tar.gz diff --git a/thirdparty/libass/docs/hap_integrate.md b/thirdparty/libass/docs/hap_integrate.md new file mode 100644 index 0000000000000000000000000000000000000000..71451a3d22c1aceaac24bff3116def30e076c048 --- /dev/null +++ b/thirdparty/libass/docs/hap_integrate.md @@ -0,0 +1,102 @@ +# libass 集成到应用hap + +本库是在RK3568开发板上基于OpenHarmony3.2 Release版本的镜像验证的,如果是从未使用过RK3568,可以先查看[润和RK3568开发板标准系统快速上手](https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/rk3568_helloworld)。 + +## 开发环境 + +- ubuntu20.04 +- [OpenHarmony3.2Release镜像](https://gitee.com/link?target=https%3A%2F%2Frepo.huaweicloud.com%2Fopenharmony%2Fos%2F3.2-Release%2Fdayu200_standard_arm32.tar.gz) +- [ohos_sdk_public 3.2.11.9 (API Version 9 Release)](https://gitee.com/link?target=https%3A%2F%2Frepo.huaweicloud.com%2Fopenharmony%2Fos%2F3.2-Release%2Fohos-sdk-windows_linux-public.tar.gz) +- [DevEco Studio 3.1 Beta2](https://gitee.com/link?target=https%3A%2F%2Fcontentcenter-vali-drcn.dbankcdn.cn%2Fpvt_2%2FDeveloperAlliance_package_901_9%2Ff3%2Fv3%2FuJyuq3syQ2ak4hE1QZmAug%2Fdevecostudio-windows-3.1.0.400.zip%3FHW-CC-KV%3DV1%26HW-CC-Date%3D20230408T013335Z%26HW-CC-Expire%3D315360000%26HW-CC-Sign%3D96262721EDC9B34E6F62E66884AB7AE2A94C2A7B8C28D6F7FC891F46EB211A70) +- [准备三方库构建环境](../../../tools/README.md#编译环境准备) +- [准备三方库测试环境](../../../tools/README.md#ci环境准备) + +## 编译三方库 + +- 下载本仓库 + + ```shell + git clone https://gitee.com/openharmony-sig/tpc_c_cplusplus.git --depth=1 + ``` + +- 三方库目录结构 + + ``` + tpc_c_cplusplus/thirdparty/libass #三方库libass的目录结构如下 + ├── docs #三方库相关文档的文件夹 + ├── HPKBUILD #构建脚本 + ├── SHA512SUM #三方库校验文件 + ├── README.OpenSource #说明三方库源码的下载地址,版本,license等信息 + ├── README_zh.md + ``` + +- 将libass拷贝至tools/main目录下 + + ``` + cd tpc_c_cplusplus + cp thirdparty/libass tools/main -rf + ``` + +- 在tools目录下编译三方库 + + 编译环境的搭建参考[准备三方库构建环境](../../../tools/README.md#编译环境准备) + + ``` + cd tools + ./build.sh libass + ``` + +- 三方库头文件及生成的库 + + 在tools目录下会生成usr目录,该目录下存在已编译完成的32位和64位三方库 + + ``` + libass/arm64-v8a libass/armeabi-v7a + ``` + +- [测试三方库](#测试三方库) + +## 应用中使用三方库 + +- 在IDE的cpp目录下新增thirdparty目录,将编译生成的库拷贝到该目录下,如下图所示: + +  ![thirdparty_install_dir](pic/libass_install_dir.png) + +- 拷贝动态库到`\\entry\libs\${OHOS_ARCH}\`目录: + + 动态库需要在`\\entry\libs\${OHOS_ARCH}\`目录,才能集成到hap包中,所以需要将对应的so文件拷贝到对应CPU架构的目录: + +  ![thirdparty_install_dir](pic/libass_install_dir2.png) + +- 在最外层(cpp目录下)CMakeLists.txt中添加如下语句: + + ``` + #将三方库加入工程中,libass是对应的三方库名 + target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/fribidi/${OHOS_ARCH}/lib/libfribidi.so.0) + target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/harfbuzz/${OHOS_ARCH}/lib/libharfbuzz.so.0) + target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libass/${OHOS_ARCH}/lib/libass.so.9) + #将三方库的头文件加入工程中,libass是对应的三方库名 + target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/fribidi/${OHOS_ARCH}/include) + target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/harfbuzz/${OHOS_ARCH}/include) + target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/libass/${OHOS_ARCH}/include) + ``` + ![libass_usage](pic/libass_usage.png) + +## 测试三方库 + +三方库的测试使用原库自带的可执行文件来做测试 + +进入到构建目录,再进入test目录,执行 +``` +# 测试时需要把Unbutu中的usr/share/fonts打包推送到ohos设备中,放在ohos设备同一路径中 +./test testass.png sub1.ass 0.03 +``` + + ![libass_test](pic/libass_test.png) + +## 参考资料 + +- [润和RK3568开发板标准系统快速上手](https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/rk3568_helloworld) +- [OpenHarmony三方库地址](https://gitee.com/openharmony-tpc) +- [OpenHarmony知识体系](https://gitee.com/openharmony-sig/knowledge) +- [通过DevEco Studio开发一个NAPI工程](https://gitee.com/openharmony-sig/knowledge_demo_temp/blob/master/docs/napi_study/docs/hello_napi.md) \ No newline at end of file diff --git a/thirdparty/libass/docs/pic/libass_install_dir.png b/thirdparty/libass/docs/pic/libass_install_dir.png new file mode 100644 index 0000000000000000000000000000000000000000..d2054fc4a655b7ce4458a7bee7dac95038a3bfe1 Binary files /dev/null and b/thirdparty/libass/docs/pic/libass_install_dir.png differ diff --git a/thirdparty/libass/docs/pic/libass_install_dir2.png b/thirdparty/libass/docs/pic/libass_install_dir2.png new file mode 100644 index 0000000000000000000000000000000000000000..b0826cce0d0a8eddfe89533b32c206554a3cdd75 Binary files /dev/null and b/thirdparty/libass/docs/pic/libass_install_dir2.png differ diff --git a/thirdparty/libass/docs/pic/libass_test.png b/thirdparty/libass/docs/pic/libass_test.png new file mode 100644 index 0000000000000000000000000000000000000000..2566484c70f493774247f45ee683f9bc1fd2fd48 Binary files /dev/null and b/thirdparty/libass/docs/pic/libass_test.png differ diff --git a/thirdparty/libass/docs/pic/libass_usage.png b/thirdparty/libass/docs/pic/libass_usage.png new file mode 100644 index 0000000000000000000000000000000000000000..4e65bd9d3024e17c77498f16ce499b6b3e59a89f Binary files /dev/null and b/thirdparty/libass/docs/pic/libass_usage.png differ