https://github.com/warzone2100/wmit
Warzone Model Import Tool - for use with Warzone 2100
https://github.com/warzone2100/wmit
3d-models c-plus-plus cmake open-source opengl qt5
Last synced: 15 days ago
JSON representation
Warzone Model Import Tool - for use with Warzone 2100
- Host: GitHub
- URL: https://github.com/warzone2100/wmit
- Owner: Warzone2100
- License: gpl-3.0
- Created: 2011-10-26T22:40:35.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2023-08-18T19:10:02.000Z (over 1 year ago)
- Last Synced: 2025-04-10T13:45:13.039Z (18 days ago)
- Topics: 3d-models, c-plus-plus, cmake, open-source, opengl, qt5
- Language: C++
- Homepage:
- Size: 1.29 MB
- Stars: 16
- Watchers: 10
- Forks: 11
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: COPYING.nongpl.txt
Awesome Lists containing this project
README
# WMIT
Warzone Model Import Tool
Import and export [.PIE](https://github.com/Warzone2100/warzone2100/blob/master/doc/PIE.md), and .OBJ files.
Also can import files in .WZM format.
> Note: support for .WZM format is deprecated and will be removed in a future release. Please migrate your files into .PIE format.
For use with: [Warzone 2100](https://github.com/Warzone2100/warzone2100)
## Latest development builds
[](https://github.com/Warzone2100/WMIT/actions?query=workflow%3AWindows+branch%3Amaster+event%3Apush)
[](https://github.com/Warzone2100/WMIT/actions?query=workflow%3AmacOS+branch%3Amaster+event%3Apush)
[](https://github.com/Warzone2100/WMIT/actions?query=workflow%3AUbuntu+branch%3Amaster+event%3Apush)
### Windows
How to get the latest Windows development builds:
1. View the **[latest successful Windows builds](https://github.com/Warzone2100/WMIT/actions?query=workflow%3AWindows+branch%3Amaster+event%3Apush+is%3Asuccess)**.
2. Select the latest workflow run in the table / list.
This should display a list of **Artifacts** from the run.
3. Download the `wmit_win_x86` or `wmit_win_x64` artifact (depending on whether you want the 32-bit or 64-bit build).
> Note: A free GitHub account is currently required to download the artifacts.
### macOS
How to get the latest macOS development builds:
1. View the **[latest successful macOS builds](https://github.com/Warzone2100/WMIT/actions?query=workflow%3AmacOS+branch%3Amaster+event%3Apush+is%3Asuccess)**.
2. Select the latest workflow run in the table / list.
This should display a list of **Artifacts** from the run.
3. Download the `wmit_macOS` artifact.
> Note: A free GitHub account is currently required to download the artifacts.
### Linux (from source)
Clone this Git repo and build, following the instructions under:
[How to Build](#how-to-build)
> Development builds are a snapshot of the current state of development, from the
> latest (successfully-built) commit. Help testing these builds is always welcomed,
> but they should be considered a work-in-progress.
## How to build
### Getting the Source
Clone the Git repo:
```
git clone https://github.com/Warzone2100/WMIT.git
cd WMIT
git submodule update --init --recursive
```
> Note: Initializing submodules is required.
### Windows
* Prerequisites
* **Visual Studio 2017+**
* **CMake 3.11+** (https://cmake.org/)
* **QT 5.4+ (ideally, Qt 5.9+)** (https://www.qt.io/)
* NSIS _[optional] (used to generate the installer package)_ (https://nsis.sourceforge.io/Download)
* **Building:**
* Open the appropriate pre-configured command prompt from the "Visual Studio 2017" folder in your Start Menu:
* For a 32-bit (x86) build: "x86 Native Tools Command Prompt for VS 2017"
* For a 64-bit (x64) build: "x64 Native Tools Command Prompt for VS 2017"
* Change directory to the WMIT repo directory:
* `cd C:\src\WMIT` _(substitute the appropriate path to the repo on your system)_
* Run the `configure_win` script using Powershell:
* `powershell .\configure_win.ps1`
* If successful, you should now have a **wmit.sln** Visual Studio project in a new `build/` folder inside the repo.
* Simply open the **wmit.sln** file in Visual Studio.
* Or build from the command-line using something like:
* `msbuild build/x86/wmit.vcxproj /p:Configuration=Release` (builds wmit.exe)
* `msbuild build/x86/PACKAGE.vcxproj /p:Configuration=Release` (builds the installer package)
### Linux
* Prerequisites
* **GCC / Clang**
* **CMake 3.5+** (https://cmake.org/)
* **QT 5.4+ (ideally, Qt 5.9+)** (https://www.qt.io/)
* Examples of installing prerequisites:
* Ubuntu 18.04:
* `sudo apt-get install git cmake build-essential ninja-build automake qt5-default`
* Fedora 29:
* `sudo dnf install git cmake gcc gcc-c++ ninja-build make qt5-devel mesa-libGLU-devel`
* **Building**:
* Change directory to the WMIT repo directory
* `cd WMIT`
* Configure (builds dependencies and generates the Makefile)
* `./configure_linux.sh`
* Build
* `cmake --build build`
### macOS
* Prerequisites
* **Xcode 8+**
* **CMake 3.11+** (https://cmake.org/)
* **QT 5.9.1+** (https://www.qt.io/)
* **Building:**
* Change directory to the WMIT repo directory
* `cd WMIT`
* Configure (builds dependencies and generates an Xcode project)
* `PATH=/Qt/5.9.7/clang_64/bin:$PATH QT5_DIR="/Qt/5.9.7/" ./configure_macOS.sh`
* (Substitute the appropriate PATH to Qt5's bin folder and the main Qt5 install folder.)
* Build
* Simply open the `build/wmit.xcodeproj`, and build the `wmit` target / scheme.