Lothario
/
axmol
mirror of https://github.com/axmolengine/axmol.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
axmol/README_CN.md

96 lines
6.3 KiB
Markdown
Raw Normal View History

Update logo [skip ci]
2022-12-17 16:32:20 +08:00
<p align="center"><a href="https://axmolengine.github.io/axmol" target="_blank" rel="noopener noreferrer"><img width="160" src="docs/logo.png" alt="axmol logo"></a></p>
Update readme & ci files
2023-03-25 11:18:21 +08:00
# Axmol引擎
Add license badge
2020-11-15 17:56:03 +08:00
Merge: f9b6553e57 94be720d3f Merge branch '1.x' into dev
2023-08-25 16:57:54 +08:00
## A Multi-platform Engine for Desktop, XBOX (UWP) and Mobile games. (A fork of Cocos2d-x-4.0)
Media engine video texture (#1133) * VideoPlayer based on new MediaEngine[Win32/UWP] * Improve MediaEngine interface * Update readme * Improve pixel format * Improve MediaEngine interface * Ready for PR UWP/Win32 * Ready for PR UWP,Win32 * Update reademe files * Update readme files * Update UIVideoPlayer-android.cpp [skip ci] * Update UIVideoPlayer-ios.mm * Update MFUtils.cpp * Fix ci
2023-03-25 08:37:51 +08:00
Final migrate (#876)
2022-10-01 16:24:52 +08:00
[![dev](https://img.shields.io/github/v/release/axmolengine/axmol?include_prereleases&label=release)](https://github.com/axmolengine/axmol/releases)
[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/axmolengine/axmol/blob/master/LICENSE)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/81fa1aba09ab41a98b949064b928d06e)](https://www.codacy.com/gh/axmolengine/axmol/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=axmolengine/axmol&amp;utm_campaign=Badge_Grade)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-blue.svg)](https://github.com/axmolengine/axmol/pulls)
Merge: f9b6553e57 94be720d3f Merge branch '1.x' into dev
2023-08-25 16:57:54 +08:00
[![QQ Group](https://img.shields.io/badge/QQGroup-join-green.svg)](https://jq.qq.com/?_wv=1027&k=nvNmzOIY)
Add cmake option AX_GLES_PROFILE Valid value of AX_GLES_PROFILE: 0, 200, 300 By default, the AX_GLES_PROFILE is: - android: 200, allow axmol apps runs on: API 17 Android 4.2+ devices - winuwp: 300 - Win32/linux/osx/ios/tvos: 0 For ios/tvos, will forcing AX_GLES_PROFILE to 300 if AX_GLES_PROFILE not 0
2023-08-13 23:56:58 +08:00
Update readme & ci files
2023-03-25 11:18:21 +08:00
**[English](README.md)**
Update build status badges
2023-03-11 23:34:10 +08:00
## 支持平台列表
| Build | Status (github) |
|-------|-----------------|
Reduce ci checks
2023-07-01 21:54:12 +08:00
| Windows(win32,winuwp,win32-clang)|[![Win32 CI](https://github.com/axmolengine/axmol/actions/workflows/windows.yml/badge.svg)](https://github.com/axmolengine/axmol/actions/workflows/windows.yml)|
Update build status badges
2023-03-11 23:34:10 +08:00
| Android | [![Android Build Status](https://github.com/axmolengine/axmol/workflows/android/badge.svg)](https://github.com/axmolengine/axmol/actions?query=workflow%3Aandroid)|
| iOS |[![iOS Build Status](https://github.com/axmolengine/axmol/workflows/ios/badge.svg)](https://github.com/axmolengine/axmol/actions?query=workflow%3Aios)|
| tvOS |[![tvOS Build Status](https://github.com/axmolengine/axmol/workflows/tvos/badge.svg)](https://github.com/axmolengine/axmol/actions?query=workflow%3Atvos)|
| Linux |[![Linux Build Status](https://github.com/axmolengine/axmol/workflows/linux/badge.svg)](https://github.com/axmolengine/axmol/actions?query=workflow%3Alinux)|
| macOS |[![macOS Build Status](https://github.com/axmolengine/axmol/workflows/osx/badge.svg)](https://github.com/axmolengine/axmol/actions?query=workflow%3Aosx)|
WASM: Don't build HelloLua due to appveyor limits
2023-09-11 23:27:52 +08:00
| WASM(experimental) |[![WASM Build Status](https://ci.appveyor.com/api/projects/status/4slq965fwhbaidnc?svg=true&passingText=wasm%20-%20passing)](https://ci.appveyor.com/project/halx99/axmol)|
Migrate to github ci (#247)
2020-10-24 18:41:20 +08:00
ImGui: Clear emscripten's MouseWheel callback before shutdown. refer: https://github.com/ocornut/imgui/pull/6790
2023-09-06 19:15:05 +08:00
## 构建
请查看: [Dev setup instructions](docs/DevSetup.md).
Merge: 41714a04fd 2631c8405b Merge branch '1.x' into dev
2023-09-02 19:56:50 +08:00
## 渲染后端
- Metal: macOS, iOS
- OpenGL 3.3+: Linux, macOS, Win32
- OpenGL ES 2.0+: Android
- OpenGL ES 3.0+: iOS
- ANGLE GLES 3.0+: Win32, WinUWP
ImGui: Clear emscripten's MouseWheel callback before shutdown. refer: https://github.com/ocornut/imgui/pull/6790
2023-09-06 19:15:05 +08:00
- WebGL 2.0(OpenGL ES 3.0): WASM (experimental)
Merge: 41714a04fd 2631c8405b Merge branch '1.x' into dev
2023-09-02 19:56:50 +08:00
Update readme files
2023-06-12 11:12:39 +08:00
## 新的媒体播放器
新的媒体播放器`ui::MediaPlayer`(原命: `ui::VideoPlayer`) 将视频渲染为纹理，使得游戏对视频渲染控制更加灵活，就像普通UI一样，而无需考虑层级问题。这得益于重新升级的跨平台`MediaEngine`, 灵感来自微软的媒体基础库(Microsoft Media Foundation): `IMFMediaEngine`，目前已支持axmol引擎支持的所有平台。
Update readme
2023-04-01 16:07:55 +08:00
Reduce ci checks
2023-07-01 21:54:12 +08:00
| Target Platform | Video Compress Format | Video Pixel Format | Container Format | Backend |
Update readme files [skip ci]
2023-06-19 16:06:37 +08:00
|-----------------------|-----------------------|----------------------|----------------- |--------------------|
| Windows Desktop | H264, HEVC, VP90 | YUY2, NV12, RGB32 | .mp4,.mkv,.webm | IMFMediaSession |
| Windows UWP | H264, HEVC, VP90 | BGR32 | .mp4,.mkv,.webm | IMFMediaEngine |
| Apple macOS | H264, HEVC(hvc1) | NV12, BGR32 | .mp4 | AVFoundation |
| Apple tvOS | H264, HEVC(hvc1) | NV12, BGR32 | .mp4 | AVFoundation |
| Apple iOS | H264, HEVC(hvc1) | NV12, BGR32 | .mp4 | AVFoundation |
| Android | H264, HEVC | NV12 | .mp4,.mkv,.webm | ExoPlayer2 |
| Linux | H264, HEVC | NV12 | .mp4,.mkv,.webm | libVLC |
Updat readme [skip travis][skip appveyor]
2020-08-04 16:48:47 +08:00
### 主要特性:
Update readme files
2023-03-11 23:08:08 +08:00
Update readme files[skip ci][skip appveyor]
2023-09-09 01:07:47 +08:00
- WebAssembly支持（实验性的）by @nowasm
- Windows UWP 支持，请参考: https://github.com/axmolengine/axmol/pull/1108
- 增加tvos支持
- 增强Windows下工作流，支持链接引擎预编译库, 用法请查看: [windows workflow guide](https://github.com/axmolengine/axmol/issues/564)
- Windows 视频播放支持
- Windows x64编译支持
- 基于yasio重构HttpClient以支持并发Http请求，不再需要sendImmidate接口
- 重构AudioEngine, 全平台OpenAL
- [openal-soft](https://github.com/kcat/openal-soft), pass -DAX_USE_ALSOFT=ON to cmake to force enable it
- [OpenAL.framework](https://opensource.apple.com/tarballs/OpenAL), if no and ```AX_USE_ALSOFT``` option specified, cmake script will choose it on osx/ios, even through it was mark as deprecated, but still avaiable.
- 重构UserDefault, 全平台基于内存映射文件 [mio](https://github.com/mandreyel/mio), 性能提升百倍
- 模块化所有引擎扩展库, 所有扩展库放到extensions目录下，如cocostudio, spine
- AudioEngine实现wav所有 ```openal-soft``` 支持的封装格式, 例如MS-ADPCM, ADPCM等
- 使用现代化的GL加载器glad代替glew
- 增加google angle渲染后端支持
- C++最低标准要求: C++17/20
- 设置ios下最低目标平台为ios11.0
- 使用更快的xml解析库pugixml代替tinyxml2
- Downloader全平台统一实现，均基于curl
- 全平台统一使用XML SAX解析plist文件, 移除Apple平台的实现
- Spine 3.8支持
- 新增FairyGUI支持
- 新增硬件压缩纹理格式ASTC 4x4/6x6/8x8支持，支持软解
- 新增硬件压缩纹理格式ETC2 RGB/RGBA支持，支持软解
- **ImGui集成，非常方便写游戏内嵌小工具，用法详见[ImGui](extensions/ImGui/README.md)**
- 完整改动列表，请查看[CHANGELOG.md](CHANGELOG.md)
Merge: f9b6553e57 94be720d3f Merge branch '1.x' into dev
2023-08-25 16:57:54 +08:00
Merge: 7b034c4d5f 88d6c48d98 Merge pull request #138 from halx99/moduls Modularize all optional extensions
2020-08-04 11:23:36 +08:00
### 参考链接
Merge: f9b6553e57 94be720d3f Merge branch '1.x' into dev
2023-08-25 16:57:54 +08:00
- axmol引擎预编译库生成工具: [build1k](https://github.com/axmolengine/build1k),
Merge: 41714a04fd 2631c8405b Merge branch '1.x' into dev
2023-09-02 19:56:50 +08:00
- axmol专用shader编译工具: [axmolengine/glslcc](https://github.com/axmolengine/glslcc),
Merge: f9b6553e57 94be720d3f Merge branch '1.x' into dev
2023-08-25 16:57:54 +08:00
- 一些基于axmol引擎的开源项目: https://github.com/axmolengine/axmol/discussions/694
- official v4: https://gitee.com/mirrors/cocos2d-x
- Git快速手册: https://github.com/axmolengine/axmol/discussions/411
Update readme
2021-05-26 14:46:15 +08:00
Final migrate (#876)
2022-10-01 16:24:52 +08:00
### axmol项目活跃状态
Update readme
2021-05-26 14:46:15 +08:00
Update README_CN.md
2022-11-09 11:41:17 +08:00
![Alt](https://repobeats.axiom.co/api/embed/6fcb8168a3af91ba9e797a1f14a3c2edc42ac56a.svg "Repobeats analytics image")