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

101 lines
6.9 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 Engine
Update badges
2021-12-28 21:50:41 +08:00
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
## A Multi-platform Engine for Desktop, XBOX (UWP) and Mobile games. (A radical fork of Cocos2d-x-4.0)
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)
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
[![vscode.dev](https://img.shields.io/badge/vscode.dev-green.svg)](https://vscode.dev/github/axmolengine/axmol)
Add license badge
2020-11-15 17:56:03 +08:00
Final migrate (#876)
2022-10-01 16:24:52 +08:00
![issues](https://img.shields.io/github/issues/axmolengine/axmol?style=plastic)
![forks](https://img.shields.io/github/forks/axmolengine/axmol?style=plastic)
![stars](https://img.shields.io/github/stars/axmolengine/axmol?style=plastic)
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/axmolengine/axmol?style=plastic)
Update build status badges
2023-03-11 23:34:10 +08:00
Update readme & ci files
2023-03-25 11:18:21 +08:00
**[简体中文](README_CN.md)**
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
Update build status badges
2023-03-11 23:34:10 +08:00
## Supported Platforms
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
Update build status badges
2023-03-11 23:34:10 +08:00
| Build | Status (github) |
|-------|-----------------|
Building with ninja + official llvm-clang-cl support (#1159) * Building with ninja + official llvm-clang-cl support * Update gh ci for clang * Fix ci * Fix ci * Fix ci * FIx dll copy [skip ci] * Fix ci warnings * Update ci files and readme * Update badges
2023-04-02 16:04:19 +08:00
| Windows Desktop|[![Win32 CI](https://github.com/axmolengine/axmol/actions/workflows/windows.yml/badge.svg)](https://github.com/axmolengine/axmol/actions/workflows/windows.yml)|
| Windows Desktop(Clang)|[![Win32 CI](https://github.com/axmolengine/axmol/actions/workflows/windows-clang.yml/badge.svg)](https://github.com/axmolengine/axmol/actions/workflows/windows-clang.yml)|
| Windows UWP|[![Win32 CI](https://github.com/axmolengine/axmol/actions/workflows/winuwp.yml/badge.svg)](https://github.com/axmolengine/axmol/actions/workflows/winuwp.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)|
Update README.md
2023-06-01 00:06:35 +08:00
## Reimplemented VideoPlayer(VideoTexture)
Update readme
2023-04-01 16:07:55 +08:00
| Platform | MediaEngine | Video Compress Format | Video Pixel Format | Backend |
|-----------------------|-------------------|-----------------------|----------------------|--------------------|
| Windows Desktop | complete | H264, HEVC, VP90 | YUY2, NV12, RGB32 | IMFMediaSession |
| Windows UWP | complete | H264, HEVC, VP90 | BGR32 | IMFMediaEngine |
Enable video player(VideoTexture) based on new MediaEngine for macOS and tvos (#1154) * Ready for PR macOS * Update videoTexture.frag * Fix compile * Fix h265 for mac [skip ci] * Fix compile error * Update readme [skip ci]
2023-04-02 01:51:36 +08:00
| Apple macOS | complete | H264, HEVC(hvc1) | NV12, BGR32 | AVFoundation |
[Video] Enable VideoTexture streaming for iOS
2023-06-01 12:48:40 +08:00
| Apple tvOS | complete | H264, HEVC(hvc1) | NV12, BGR32 | AVFoundation |
| Apple iOS | complete | H264, HEVC(hvc1) | NV12, BGR32 | AVFoundation |
Update readme
2023-04-01 16:07:55 +08:00
| Android | planned | H264 | RGB32 | |
Update README.md
2021-06-08 22:52:31 +08:00
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
## Highlighted Features
Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD (#987) * Update AXConfigDefine.cmake * Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD * Fix formatting * remov empty line * Update AXConfigDefine.cmake Fix typo
2022-12-20 11:31:52 +08:00
Update readme files
2023-03-11 23:08:08 +08:00
- Windows UWP support, refer to: https://github.com/axmolengine/axmol/pull/1108
Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD (#987) * Update AXConfigDefine.cmake * Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD * Fix formatting * remov empty line * Update AXConfigDefine.cmake Fix typo
2022-12-20 11:31:52 +08:00
- Add apple M1, android x64 support, contributed by @pietpukkel
- Improve windows workflow, support linking with engine prebuilt libs, read [windows workflow guide](https://github.com/axmolengine/axmol/issues/564)
- Windows video player support (based on microsoft media foundation)
- Windows x64 build support
Update README.md (#1207) Fix typo
2023-05-15 13:51:30 +08:00
- Reimplement HttpClient based on yasio for concurrent http requests processing.
Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD (#987) * Update AXConfigDefine.cmake * Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD * Fix formatting * remov empty line * Update AXConfigDefine.cmake Fix typo
2022-12-20 11:31:52 +08:00
- ['Upstream-Version-License'](thirdparty/README.md) Third-party
- Third-party license overview for easier publishing of your commercial apps based on axmol framework.
- Some links to third party libs which support axmol too.
- ['Upstream-Version-License'](extensions/README.md) Extensions
- Extensions license overview for easier publishing of your commercial apps based on axmol framework.
- Spine-3.8 support
- ```FairyGUI``` support
- DragonBones support
- Live2D support
- **ImGui integrated, easy to write game embedded tools, very easy to use, read [ImGui](extensions/ImGui/README.md) for more info**
- Refactor AudioEngine, OpenAL for all platforms
- [OpenAL Soft](https://github.com/kcat/openal-soft), pass -DAX_USE_ALSOFT=ON to cmake to force enabling it
- [OpenAL.framework](https://opensource.apple.com/tarballs/OpenAL), if no ```AX_USE_ALSOFT``` option specified, cmake script will choose it on osx/ios/tvos, even though it was marked as deprecated, but still available.
- Refactor UserDefault with [mio](https://github.com/mandreyel/mio)
- Modularize all optional extensions, move from engine core folder to an extensions folder
- Implement all .wav formats supported by ```OpenAL Soft```, such as MS-ADPCM, ADPCM, ...
- Use a modern GL loader ```Glad```
- Google [angle](https://github.com/google/angle) renderer backend support
- C++ 17/20
- IOS/TVOS SDK 9.0 as minimal deployment
- Use fast pugixml
- Use [curl](https://github.com/curl/curl) for transferring data with URL syntax
- Use SAX parser for all plist files
- ASTC 4x4/6x6/8x8 support (if hardware decoding is not supported, then software decoding is used)
- ETC2 RGB/RGBA support (if hardware decoding is not supported, then software decoding is used)
- Supported 2D physics engines (see also [APPENDIX.md](APPENDIX.md)):
- Box2D
- Box2D-optimized
- Chipmunk2D
- Supported 3D physics engines:
- Bullet Physics SDK
Add goals to readme
2019-11-25 10:22:58 +08:00
Add windows video play support [render video sample to texture2d] (#577) * [Draft] Implement windows video player Based on microsoft media foundation * Delete pvd * Shutdown MF media before release player * Consider MFMediaPlayer ref leak * Use Microsoft::WRL::ComPtr * Simplify code * Improve code and take care COM object refs * Update UIVideoPlayer-win.cpp * Delete unused code * Add play from url support * Update logic * Rename ADXE_ENABLE_MFMEDIA to AX_ENABLE_MFMEDIA * Rescale video render sprite to view node * Fix warnings * Don't shallow copy the video context, it's very dangerous * Fix compile error CC_VIDEOPLAYER_DEBUG_DRAW=1 * Fixup * [Window video player] play event dispatch * support switch video file * Update UIVideoPlayer-win.cpp * [windows-video-player] keep aspect ratio and full screen support * Improve code * Update changelog [skip ci] * Update README.md * Update README.md * Update README.md * Update README_CN.md * Update README_CN.md
2022-02-24 17:57:08 +08:00
[Read Full changes since cocos2d-x-4.0](CHANGELOG)
Final migrate (#876)
2022-10-01 16:24:52 +08:00
Open [APPENDIX.md](APPENDIX.md) for additional information and see [Milestones](https://github.com/axmolengine/axmol/milestones) for planed features too.
Make setup.py works with python3
2020-10-22 16:53:28 +08:00
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
## Building
Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD (#987) * Update AXConfigDefine.cmake * Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD * Fix formatting * remov empty line * Update AXConfigDefine.cmake Fix typo
2022-12-20 11:31:52 +08:00
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
View the [Dev setup instructions](docs/DevSetup.md).
Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD (#987) * Update AXConfigDefine.cmake * Use standard cmake CMAKE_CXX_STANDARD instead of CXX_STD * Fix formatting * remov empty line * Update AXConfigDefine.cmake Fix typo
2022-12-20 11:31:52 +08:00
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
## Reference links
Clarify the order of steps required to create and build new projects (#970) * Committing genbindings changes * Clarify instructions on how to create new projects and build files
2022-11-27 22:57:06 +08:00
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
- [buildware](https://github.com/axmolengine/buildware), the axmol prebuilt build-bot
Update README.md (#1103) better readable of some links
2023-03-08 08:10:49 +08:00
- [Some interesting related projects based on axmol](https://github.com/axmolengine/axmol/discussions/694)
- [Axmols contributing guide](https://github.com/axmolengine/axmol/discussions/411)
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
- [Official Cocos2d-x](https://github.com/cocos2d/cocos2d-x)
Add Contributing guide
2021-08-27 15:47:40 +08:00
Improve docs, move dev setup instructions to docs/DevSetup.md
2023-05-31 12:58:15 +08:00
## The axmol Active Stats
Fix #957
2022-11-08 23:28:15 +08:00
![Alt](https://repobeats.axiom.co/api/embed/6fcb8168a3af91ba9e797a1f14a3c2edc42ac56a.svg "Repobeats analytics image")