Release v2.0.0dev7 changes to Master

.editorconfig

@@ -0,0 +1,17 @@
+root = true
+
+[*.{h,cpp}]
+indent_size = 4
+indent_style = tab
+
+[*.{pro,pri}]
+indent_size = 4
+indent_style = tab
+
+[*.ui]
+indent_size = 1
+indent_style = space
+
+[*.{frag,prog,vert}]
+indent_size = 4
+indent_style = tab

.gitignore

@@ -1,27 +1,74 @@
-# generated ones
+# Generated
+.moc/
+.obj/
+.qrc/
+.ui/
+[Bb]in/
+[Dd]ebug/
+[Rr]elease/
+GeneratedFiles/
 Makefile
 Makefile.Debug
 Makefile.Release
+nifskope_plugin_import.cpp
 moc_*.cpp
 qrc_*.cpp
 ui_*.h
+*.tags
 
-# compiled 
+# Intermediate 
 *.o
+*.obj
+*.bak
+*.ilk
+*.log
+*.tmp
 
-# eclipse project
+# Eclipse project
 .project
 .cproject
 .settings
 
-# qtcreator
+# Qt Creator
 NifSkope.pro.user
+.qmake.stash
 
-# binary
+# Binaries
 NifSkope
+NifSkope.exe
 
-# VC build dirs
-release
-debug
-# VC debug file
+# VC Project
+*.cd
+*.filters
+*.psess
+*.sln
+*.sln.docstates
+*.suo
+*.vcxproj
+*.vcxproj.user
+*.vcproj
+*.vcproj.user
+*.vsp
+*.vspscc
+*.vssscc
+*.vspx
+
+
+# VC Cache
+.vs/
+ipch/
+*.aps
+*.cachefile
+*.ncb
+*.opendb
+*.opensdf
+*.sdf
+*.VC.db
+*.VC.VC.opendb
+
+# VC Debug
 vc100.pdb
+
+# OS
+[Tt]humbs.db
+*.DS_Store

.gitmodules

@@ -1,6 +1,12 @@
 [submodule "docsys"]
-	path = docsys
-	url = git://niftools.git.sourceforge.net/gitroot/niftools/nifdocsys
+	path = build/docsys
+	url = https://github.com/niftools/nifdocsys.git
 [submodule "qhull"]
-	path = qhull
-	url = git://gitorious.org/qhull/qhull.git
+	path = lib/qhull
+	url = https://github.com/qhull/qhull.git
+[submodule "lib/zlib"]
+	path = lib/zlib
+	url = https://github.com/madler/zlib.git
+[submodule "lib/gli"]
+	path = lib/gli
+	url = https://github.com/g-truc/gli.git

.travis.yml

@@ -0,0 +1,43 @@
+dist: trusty
+sudo: required
+language: cpp
+os:
+  - linux
+  - osx
+addons:
+  apt:
+    sources:
+      - sourceline: 'ppa:beineri/opt-qt571-trusty'
+    packages: [
+      # static analysis
+      clang-3.6,
+      # qt5 requirement
+      qt57-meta-minimal
+    ]
+matrix:
+  fast_finish: true
+  include:
+    - os: linux
+      env:
+        ANALYZE="scan-build-3.6 --use-cc clang-3.6 --use-c++ clang++-3.6 "
+      compiler: clang
+  allow_failures:
+    - env: ANALYZE="scan-build-3.6 --use-cc clang-3.6 --use-c++ clang++-3.6 "
+
+before_install:
+  - if [ "${TRAVIS_OS_NAME}" = "linux" ]; then sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test; fi
+  - if [ "${TRAVIS_OS_NAME}" = "linux" ]; then sudo apt-get update -qq; fi
+  - if [ "${TRAVIS_OS_NAME}" = "linux" ]; then QT_ENV_SCRIPT=$(find /opt -name 'qt*-env.sh'); source $QT_ENV_SCRIPT; fi
+  - if [ "${TRAVIS_OS_NAME}" = "osx" ]; then brew update; brew install [email protected]; export PATH="/usr/local/opt/[email protected]/bin:$PATH"; fi
+
+install:
+  - if [ "${TRAVIS_OS_NAME}" = "linux" ]; then sudo apt-get install -qq g++-6; fi
+  - if [ "${TRAVIS_OS_NAME}" = "linux" ]; then sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-6 90; fi
+
+script:
+  - qmake --version
+  - qmake -makefile NifSkope.pro
+  - ${ANALYZE}make -j4
+
+notifications:
+    email: false

CHANGELOG.TXT → CHANGELOG.md

@@ -1,5 +1,10 @@
  == CHANGELOG ==
 
+**NOTE: This changelog is not maintained for prerelease versions**
+
+You may view the changes since 1.1.3 here: https://github.com/jonwd7/nifskope/releases
+
+
 This is version 1.1.3 of NifSkope.
 
 changes since 1.1.2:

DOXYGEN.md

@@ -0,0 +1,110 @@
+Main Page {#mainpage}
+=========
+
+[TOC]
+
+
+Introduction {#intro}
+========
+
+%NifSkope is a graphical program that allows you to open NIF files, view their contents, edit them, and write them back out again. It is written in C++ using OpenGL and the Qt framework.
+
+The main application resides in the NifSkope class; rendering takes place via GLView.  A central feature of Qt is the [Signals and Slots](http://doc.qt.io/qt-5/signalsandslots.html) mechanism, which is used extensively for communication between classes.  A NIF is internally represented as a NifModel, and blocks are referenced by means of QModelIndex or QPersistentModelIndex.
+
+Various functions can be performed on a NIF via the Spell system; this is a good place to start if you want to learn about how a NIF is typically structured and how the blocks are manipulated.
+
+
+Reading and parsing a NIF {#parsing}
+========
+
+The NIF specification is currently described by [nif.xml](https://github.com/niftools/nifxml) and parsed using NifXmlHandler.
+
+
+Detailed Information {#detailed}
+========
+
+- @ref ui_programming 
+- @ref viewport_details
+
+[Signals and Slots]: 	http://doc.qt.io/qt-5/signalsandslots.html
+
+<!-- ~~~~~~~ end mainpage ~~~~~~~ -->
+
+
+@page ui_programming UI Programming
+
+[TOC]
+
+%NifSkope uses [Qt Designer] and [.ui files] to define the layout of most of its UI and uses [Signals and Slots] to allow communication between UI and non-UI code.  %NifSkope makes partial use of QMetaObject's [auto-connection] features.
+
+The UI is styled with a Qt-specific subset of CSS dubbed [QSS]. Most of the style is defined in `style.qss` which is installed alongside NifSkope.exe, though stylesheets can also be defined in C++ using QWidget::setStyleSheet().
+
+
+See also: [Designing a UI].
+
+[Designing a UI]: 		http://doc.qt.io/qt-5/gettingstartedqt.html#designing-a-ui
+[Qt Designer]: 			http://doc.qt.io/qt-5/qtdesigner-manual.html
+[.ui files]: 			http://doc.qt.io/qt-5/designer-using-a-ui-file.html
+[Signals and Slots]: 	http://doc.qt.io/qt-5/signalsandslots.html
+[auto-connection]: 		http://doc.qt.io/qt-5/designer-using-a-ui-file.html#widgets-and-dialogs-with-auto-connect
+[QSS]: 					http://doc.qt.io/qt-5/stylesheet-reference.html
+
+<!-- ~~~~~~~ end ui_programming ~~~~~~~ -->
+
+
+@page viewport_details Viewport
+
+[TOC]
+
+The main viewport class is GLView. Each frame is painted to the viewport via GLView::paintGL(). The viewport scenegraph is managed by a Scene class. A scene consists of:
+
+- Node, a physical object in the scene such as NiNode, BSFadeNode, etc.
+    - Mesh, e.g. NiTriShape
+	- Particles
+	- LODNode, BillboardNode
+- Property, a property of a physical object in the scene.
+
+Nodes {#nodes}
+========
+
+The Node class is the base class for any physical object in a Scene.  A Node can have children which are stored in a NodeList. [Properties] are stored with the Node via a PropertyList.
+
+
+Properties {#properties}
+========
+
+The Property class is the %NifSkope analog to NiProperty blocks.  Ideally anything that inherits NiProperty in nif.xml should have a Property subclass implementation.  Not all Properties require any kind of manifestation in the scene but they are nevertheless encapsulated and tracked by a Property class.
+
+
+Animation {#animation}
+========
+
+Anything that should animate must implement the IControllable interface.  To animate an IControllable, you create a Controller.  These Controllers are then made a `friend class` in the class which implements IControllable.  There are currently very few Controllers implemented when it comes to reaching feature parity with the NIF specification:
+
+| %NifSkope class                | NIF Block                        |
+|--------------------------------|----------------------------------|
+| KeyframeController             | NiKeyframeController             |
+| TransformController            | NiTransformController            |
+| MultiTargetTransformController | NiMultiTargetTransformController |
+| VisibilityController           | NiVisController                  |
+| MorphController                | NiGeomMorpherController          |
+| UVController                   | NiUVController                   |
+| ParticleController             | NiParticleSystemController       |
+| AlphaController                | NiAlphaController                |
+| MaterialColorController        | NiMaterialColorController        |
+| TexFlipController              | NiFlipController                 |
+| TexTransController             | NiTextureTransformController     |
+
+Newer Bethesda NIFs mostly use Bethesda proprietary (BS*) blocks, none of which are currently supported.  This includes `BSKeyframeController, BSEffectShaderPropertyFloatController, BSEffectShaderPropertyColorController, BSLightingShaderPropertyFloatController, BSLightingShaderPropertyColorController` to name a few.
+
+To utilize [Controllers] a class must implement IControllable's methods:
+
+- IControllable::clear()
+- IControllable::update()
+- IControllable::transform()
+- IControllable::setController()
+
+[Properties]: @ref Property
+[Controllers]: @ref Controller
+
+<!-- ~~~~~~~ end viewport_details ~~~~~~~ -->