MRIcroGL12：v1.2 GLSL体积渲染。 能够查看NIfTI，DICOM，MGH，MHD，NRRD，AFNI格式的图像

## About MRIcroGL is a cross-platform tool for viewing DICOM and NIfTI format images. It provides a drag-and-drop user interface as well as a scripting language. Please see the [wiki page](https://www.nitrc.org/plugins/mwiki/index.php/mricrogl:MainPage) from more details. Note that the wiki page describes version 1.0 of the software, while this Github page is for the upcoming version 1.2. The changes are in general subtle, but the [scripting](PYTHON.md) has changed quite a bit.  ## Requirements By default, MRIcroGL 1.2 is compiled to require OpenGL 2.1 (from 2006). It can also be compiled to require OpenGL 3.3 Core (released in 2009). From the user perspective, there should be no difference between these choices. If your computer does not support OpenGL 2.1, you can try [MRIcron](https://www.nitrc.org/projects/mricron). ## Installation You can get MRIcroGL using three methods: - Download from [NITRC](https://www.nitrc.org/projects/mricrogl/). - Download from [Github](https://github.com/neurolabusc/MRIcroGL/releases). - Run the following command to get the latest version for Linux, Macintosh or Windows: * `curl -fLO https://github.com/rordenlab/MRIcroGL12/releases/latest/download/MRIcroGL_linux.zip` * `curl -fLO https://github.com/rordenlab/MRIcroGL12/releases/latest/download/MRIcroGL_macOS.dmg` * `curl -fLO https://github.com/rordenlab/MRIcroGL12/releases/latest/download/MRIcroGL_windows.zip` Once you have downloaded the software, extract the archive and run the executable. Visit the [wiki](https://www.nitrc.org/plugins/mwiki/index.php/mricrogl:MainPage) for a full manual that includes troubleshooting.  ## Compiling with the Graphical Interface It is generally recommended that download a pre-compiled executable (see previous section). However, you can compile your own copy from source code. - Download and install [Lazarus 2.0.6 or later](https://www.lazarus-ide.org/). - Get the [Metal-Demos repository](https://github.com/neurolabusc/Metal-Demos), for example: `git clone https://github.com/neurolabusc/Metal-Demos`. - Get the [MRIcroGL12 repository]( https://github.com/rordenlab/MRIcroGL12.git), for example: `git clone https://github.com/neurolabusc/MRIcroGL12`. - The Metal-Demos and MRIcroGL12 folders should share the same parent folder, e.g. `~/src/MRIcroGL12` and `~/src/Metal-Demos`. - **Option for Windows** You you can decide to build with or without faster gzip decompression: - To build **without** faster GZip: Remove the text "{$DEFINE FASTGZ}" from the file opts.inc. Benefit: easier build, uses permissive BSD license. - To build **with** faster GZip. Preserve the text "{$DEFINE FASTGZ}" in the file opts.inc. Benefit: faster gzip decompression. However, this only supports CPUs that support SSE4 (2008 and later). - **Option** You you can decide to build with or without Python Scripting: - To build **without** Python: Open the project MRIcroGL_NoPython.lpi (or remove the text "-dMYPY" from the file MRIcroGL.lpi). - To build **with** Python. You will need [python4lazarus_package](https://github.com/Alexey-T/Python-for-Lazarus), but hopefully Lazarus will detect and install this for you automatically. **[Note, there are issues with the latest python4lazarus](https://github.com/Alexey-T/Python-for-Lazarus/issues/25) release, you should consider compiling without Python support (MRIcroGL_NoPython.lpi) [or use and earlier (2020.07.31)](https://github.com/neurolabusc/Python27-for-Lazarus.git) release (this older release supports both Python 2.7 as well as Python 3.x). - **Option** macOS developers can build for the modern Metal API instead of the legacy OpenGL API: - Get the [lazmetalcontrol repository](https://github.com/genericptr/Metal-Framework). - Use the Lazarus Package menu to open and install the lazmetal control. - Open and compile the MRIcroGL_Metal.lpi project instead of the MRIcroGL.lpi project with Lazarus (if you do not want Python, remove the text "-dMYPY" from the file MRIcroGL_Metal.lpi). - Use the `Run` command from the `Run` menu compile and run your project. Alternatively, Debian/Ubuntu Linux users may want to look at the [docker script](./DOCKER.md) that provides a line-by-line recipt for compiling MRIcroGL from the command line. ## Compiling with the Command Line It is generally recommended that download a pre-compiled executable (see previous section). However, you can compile your own copy from source code. Download and install [Lazarus 2.0.6 or later](https://www.lazarus-ide.org/), at which point the lazbuild command should be available from the command line. **[Note, there are issues with the latest python4lazarus](https://github.com/Alexey-T/Python-for-Lazarus/issues/25) release, you should consider compilining without Python support (MRIcroGL_NoPython.lpi) [or use and earlier (2020.07.31)](https://github.com/neurolabusc/Python27-for-Lazarus.git) release. For Linux (GTK2) or Windows (though see notes above), the compilation will look like this : ``` git clone https://github.com/rordenlab/MRIcroGL12.git git clone https://github.com/neurolabusc/Metal-Demos.git git clone https://github.com/neurolabusc/Python27-for-Lazarus.git lazbuild --build-ide= --add-package lazopenglcontext ./Python27-for-Lazarus/python4lazarus/python4lazarus_package.lpk cd MRIcroGL12 lazbuild -B MRIcroGL.lpr ``` For MacOS, you will want to specify the modern Cocoa widgetset, rather than the legacy Cocoa widgetset: ``` git clone https://github.com/rordenlab/MRIcroGL12.git git clone https://github.com/neurolabusc/Metal-Demos.git git clone https://github.com/neurolabusc/Python27-for-Lazarus.git lazbuild --build-ide= --ws=cocoa --add-package lazopenglcontext ./Python27-for-Lazarus/python4lazarus/python4lazarus_package.lpk cd MRIcroGL12 lazbuild -B --ws=cocoa MRIcroGL.lpi ``` One can also compile for Linux (qt5). Users will need to install [libqt5pas 1.2.8 or later](https://github.com/davidbannon/libqt5pas/releases). This version is more recent than the version provided with Ubuntu 18.04 and Mageia 7.1, so users of many operating systems will have to download the library from Github rather than the conventional install (e.g. `sudo apt install libqt5pas`): ``` git clone https://github.com/rordenlab/MRIcroGL12.git git clone https://github.com/neurolabusc/Metal-Demos.git git clone https://github.com/neurolabusc/Python27-for-Lazarus.git lazbuild --build-ide= --add-package lazopenglcontext ./Python27-for-Lazarus/python4lazarus/python4lazarus_package.lpk cd MRIcroGL12 lazbuild -B --ws=qt5 MRIcroGL.lpi ``` One can also make minor adjustments to these command line options. - `--ws=gtk3` will compile for the GTK3 widgetset. Support for GTK3 is experimental and not all features work (e.g. color selection dialog). GTK3 requires OpenGL 3.3 Core, so you must make sure that the glopts.inc file in the Metal-Demos folder has the line "{$DEFINE COREGL}" uncommented. Unfortunately, GTK3 does not support [OpenGL multi-sampling](https://github.com/aklomp/gtk3-opengl/issues/2) so the results can never match GTK2 or QT5. - Compiling `MRIcroGL_NoPython.lpi` will compile without Python scripting support ().  ## Deploying MRIcroGL The MRIcroGL executable has more functionality if it can access its `Resources` folder. This folder includes color lookup tables (`lut` folder), Python scripts (`script`), Material Capture (`matcap`), GLSL Shaders (`shader`), default NIfTI images (`standard`), NIfTI atlases (`atlas`), as well as fonts and icons. Therefore, for full functionality, you want the executable to have access to this folder. - For MacOS, the `Resources` folder is placed inside the application package bundle. In other words, if your application is `MRIcroGL.app`, the software expects `MRIcroGL.app/Resources`. - For Windows, place the `Resources` folder in the same folder as `MRIcroGL.exe`. - For Linux, you can place the `Resources` folder in the