https://github.com/ppodds/aaaanimation

An ASCII Art animation program working with FFmpeg and Qt. Some code is written in assembly.
https://github.com/ppodds/aaaanimation

ascii-anim cpp17 ffmpeg masm64 qt6

Last synced: 2 days ago
JSON representation

An ASCII Art animation program working with FFmpeg and Qt. Some code is written in assembly.

• Host: GitHub
• URL: https://github.com/ppodds/aaaanimation
• Owner: ppodds
• License: mit
• Created: 2021-12-14T17:11:35.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-01-07T17:56:19.000Z (about 3 years ago)
• Last Synced: 2023-03-03T23:49:21.045Z (almost 2 years ago)
• Topics: ascii-anim, cpp17, ffmpeg, masm64, qt6
• Language: C
• Homepage:
• Size: 1.13 MB
• Stars: 18
• Watchers: 1
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# AAAAnimation

![](docs/project.png)

## About

This is a term project of the Assembly Language and System Programming course in NCU. It decodes video with FFmpeg and plays ASCII animation with assembly. The graphic media player is implemented with Qt's QMediaPlayer and QVideoWidget.

## Screenshots

![](docs/screenshot_1.png)

![](docs/screenshot_2.png)

![](docs/screenshot_3.png)

![](docs/screenshot_4.png)

## Installation

### Use Prebuilt Binary

1. Install FFmpeg and add your ffmpeg bin to `PATH`

2. Download prebuilt binary from [here](https://github.com/ppodds/AAAAnimation/releases)

Caution:

Prebuilt binary conains Qt6's dependency, but you need to install FFmpeg by yourself.

### Compile From Source Code

#### Envirment

- Visual Studio 2019

  - Universal Windows Platform

  - C++ Desktop

  - Windows 10 SDK (10.0.1904)

  - Build Tools v142

  - Qt VS Tools (Extension)

- FFmpeg

  - [ffmpeg-n4.4.1-2-gcc33e73618-win64-lgpl-shared-4.4](https://github.com/BtbN/FFmpeg-Builds/releases)

- Qt

  - msvc 6.2.2

  - Windows

Caution:

you need to set Qt VS Tools's Qt Version to "Qt 6.2.2 for MSVC 2019"

#### Clone The Repository and Set Environment Variables

```shell

git clone https://github.com/ppodds/AAAAnimation.git

```

Environment Variables

- ffmpeg

  - `%your_project_path%\includes\ffmpeg`

- qt

  - `%your_qt_path%`

- PATH

  - `%qt%\bin;%ffmpeg%\bin%;...`

#### Build

Open `AAAAnimation.sln` and select build configuation (`Release`). Then build solution. You can see the result in `AAAAnimation\x64\Release\AAAAnimation.exe`.

If you want to deploy the binary, you can use qt's `windeployqt` tool in qt's console.

Change directory to `AAAAnimation\x64\Release` and run `windeployqt`

usage: `windeployqt AAAAnimation.exe`

This tool will copy dependencies to that folder and generate some files for deployment. Now you can run `AAAAnimation.exe` and enjoy it.

Caution:

`windeployqt` will not copy FFmpeg's dependencies to this folder. You need to copy them manually or add them to `PATH`.