Add README
This commit is contained in:
		
							parent
							
								
									78bd3264bf
								
							
						
					
					
						commit
						00052c08f8
					
				
							
								
								
									
										116
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										116
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							| 
						 | 
					@ -0,0 +1,116 @@
 | 
				
			||||||
 | 
					# Facecam2D
 | 
				
			||||||
 | 
					2D avatar facecam software
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Installation
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Debian GNU/Linux
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					A `.deb` package is available for systems running **Debian 11 or newer** or **Ubuntu 20.04 or newer.** You can find it on the Releases page.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Arch Linux
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					An AUR package (`facecam2d`) is available for Arch Linux users.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Windows
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					A Windows Installer package (MSI) is available for systems running **Windows 10 or newer.** You can find it on the Releases page. (You might be able to run it on earlier Windows versions, this hasn't been tested.) 
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Verifying packages (optional)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Released binaries are signed with this PGP key:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					pub   rsa3072 2021-07-12 [SC] [expires: 2022-07-12]
 | 
				
			||||||
 | 
					      1CB1 F64B 8061 EB02 B8A4  B421 4AB7 1F23 5C64 BE77
 | 
				
			||||||
 | 
					uid           [ultimate] Rubi Wilkins (Facecam2D Release Signing Key) <epicalert@protonmail.com>
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					You can download it at https://epicalert.xyz/keys/4AB71F235C64BE77.asc
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					When downloading the package, download its accompanying signature and verify it using e.g. GnuPG.
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					gpg --verify facecam2d_0.3.0-1_amd64.deb.asc
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Building
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### GNU/Linux or similar systems
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Make sure you have all dependencies installed.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					1. Create a `build` directory and cd into it.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					mkdir build
 | 
				
			||||||
 | 
					cd build
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					2. Configure with `cmake` (You may need to define `wxWidgets_CONFIG_EXECUTABLE` and `wxWidgets_wxrc_EXECUTABLE` if you're using Arch Linux.)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					cmake ..
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					3. Compile with `make`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					make -j4
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					4. Run the Facecam2D Configuration Tool and/or Facecam2D 
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					./fc2dconfig
 | 
				
			||||||
 | 
					./fc2d
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					5. Optionally, you can also install your build.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					make install
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Windows
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					At the moment, building on Windows is not supported. You will need to cross-compile from a GNU/Linux system with MinGW.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					1. Create a `build` directory and cd into it.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					mkdir build
 | 
				
			||||||
 | 
					cd build
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					2. Configure with the MinGW version of `cmake`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					x86_64-w64-mingw32-cmake ..
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					3. Compile with `make`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					make -j4
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					4. Make SourceDir for MSI packaging
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					mkdir SourceDir
 | 
				
			||||||
 | 
					cp -r *.exe lib/Boxer/libBoxer.dll ../packaging/*.ico models/ cvdata/ SourceDir/
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					6. Use a utility like peldd to find and copy the DLLs needed
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					for lib in $(peldd -t -r --clear-path -p /usr/x86_64-w64-mingw32/bin -w OPENGL32.dll -w libBoxer.dll fc2d.exe)
 | 
				
			||||||
 | 
						cp $lib SourceDir
 | 
				
			||||||
 | 
					for lib in $(peldd -t -r --clear-path -p /usr/x86_64-w64-mingw32/bin fc2dconfig.exe)
 | 
				
			||||||
 | 
						cp $lib SourceDir
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					7. Create MSI package with `wixl`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					wixl ../packaging/*.wx* -o facecam2d-$(git describe).msi
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
		Loading…
	
		Reference in a new issue