Demo Program

This chapter will introduce the compilation and running methods of demos on various system platforms. The demo code is located in the demo directory:

TIP

The source code is compiled using CMake. The latest compiled libraries for various platforms can be found here

iOS

Make sure the iOS library has been compiled (reference), open the project in gpupixel/demo/ios with Xcode

WARNING

If you are creating your own Xcode project, remember to turn off the Build Settings -> Compress PNG Files -> NO option, otherwise it will cause image color inversion

Mac

Make sure the MacOS library has been compiled (reference), open the project in gpupixel/demo/mac with Xcode

WARNING

If you are creating your own Xcode project, remember to turn off the Build Settings -> Compress PNG Files -> NO option, otherwise it will cause image color inversion

Android

Copy the generated gpupixel.aar to the demo/android/app/libs directory, and open the directory demo/android with Android Studio

The calling logic is in MainActivity, select the app target, connect to the phone and run

Desktop

Desktop Demo compilation requires the following environment:

Environment Requirements

• Microsoft Visual Studio >= 2017 (Windows)
• cmake >= 3.10
• mesa-utils, libglu1-mesa-dev, freeglut3-dev, mesa-common-dev, libglfw3-dev (Linux)

Windows Build Environment Configuration

It is recommended to use Windows Terminal and select the corresponding VS environment tab for compilation. If not using Windows Terminal, you can configure as follows:

• 64-bit compilation: Find and click vcvars64.bat (x64 Native Tools Command Prompt for VS 2017) in settings to open the VS virtual environment for compiling x64 architecture programs

WARNING

Windows only supports generating x86_64 Release version, x86_32 is not supported currently

Linux Build Environment Configuration

./script/setup_env_linux.sh

Compilation

After configuring the environment, execute the batch file at the root directory of the project:

Windows:

.\script\build_windows.bat

Linux:

./script/build_linux.sh

The demo is in the output/bin directory

WebAssembly

Environment Requirements

• Modern web browser with WebAssembly support (Chrome, Firefox, Safari, Edge)
• NodeJS (for local development)

Compilation

Make sure the WebAssembly library has been compiled (reference)

Running

After compilation, the WASM demo files can be found in the output/bin directory. To run the demo:

1. Navigate to the output directory:

   cd output/bin

2. Start a local web server:

   # Using Python
   python -m http.server
   
   # Or using Node.js
   npx serve

3. Open your browser and navigate to http://localhost:8000 (or the port indicated by your web server)

4. The demo interface allows you to interact with the same beauty effects as the desktop version

WARNING

The WASM version does not support facial keypoint detection. Filters that rely on face detection, such as face-slimming and big eyes, are unavailable.