CIBC:ImageVis3D

From NCRR Biomedical Software Development, Engineering, and Dissemination Wiki

Main CIBC Page
Looking for the old ImageVis3D design page?

Contents 1 Motivation and Overview 2 Getting ImageVis3D 2.1 Download the binary 2.2 Compile it Yourself 2.3 ImageVis3D Mobile 3 Sample Datasets 4 Join the Community 4.1 Report Issues 5 Using ImageVis3D 5.1 Manual 5.2 Video Tutorials 6 Development Information 6.1 Design Principles 6.1.1 Near Term Development Focus 6.1.2 Long Term Development Focus

Motivation and Overview

The goal of ImageVis3D development is to initially replicate the capabilities of the BioImage powerapp and then expand it capabilities to include all the functionality currently within SCIRun for visualizing three-dimensional rasterized data. The program is another light weight application in the same vein as Seg3D and map3d and provides the user with streamlined access to the extensive volume visualization capabilities available from tools developed within the SCI Institute and the NCRR CIBC.

Getting ImageVis3D

Download the binary

Download milestone releases here or the latest build here and simply run it. For windows if you do not download the installler but the packed binaries make sure you also download and install the Microsoft C++ 2008 runtime which is available for 32 bit systems VS2008SP1 redist x86 and for 64 bit systems VS2008SP1 redist x64. Note that you may need the 32 bit version of the redist even on a 64 bit machine if you use the 32 bit version of ImageVis3D. No other prerequisites are required for ImageVis3D to run.

For DirectX functionality you also may need to update your DirectX subsystem via this tool.

In addition to the main ImageVis3D program, we also provide a command line tool that allows you to convert your data into ImageVis3D's internal `UVF' format and vice versa. You can also download this UVFConverter here.

Compile it Yourself

Assuming that you already have Qt 4.4 or newer on your machine all you have to do to compile ImageVis3D is:

svn co https://gforge.sci.utah.edu/svn/imagevis3d
qmake
make

If you do not have Qt installed yet, we have provided some scripts to aid you in the process.

• Windows: https://code.sci.utah.edu/svn/imagevis3d/Scripts/Win-StaticQt.bat
• Mac OS X: https://code.sci.utah.edu/svn/imagevis3d/Scripts/Mac-StaticQt.sh
• Linux: https://code.sci.utah.edu/svn/imagevis3d/Scripts/Linux-StaticQt.sh

If you want to use the visual studio project files on windows you need to set the environment variables QTDIR32 and QTDIR64 (only if you want to compile a 64 bit build) to point to your Qt installation directories. As we are now using C++ tr1 functionality you need to download and install the Microsoft Visual Studio 2008 Service Pack 1 as well as Microsoft Visual Studio 2008 Feature Pack on when compiling with Microsoft Visual Studio 2008.

ImageVis3D Mobile

ImageVis3D Mobile is a mobile volume rendering application that allows you visualize and share your data while you are on the go. With ImageVis3D and ImageVis3D Mobile you can transfer your data directly from the desktop to your mobile device. ImageVis3D currently supports all iPod touches and iPhones (including the new iPhone 3Gs). Download the application via the Apple App Store or request a pre-release from the ImageVis3D team. More information and a quick start guide can be on a dedicated page.

Sample Datasets

Some sample datasets are now available from the ImageVis3D download page.

Join the Community

ImageVis3D is actively developed, open source software provided under the terms of the MIT license. We encourage you to give us your feedback on the iv3d-users mailing list, or join in the development on iv3d-develop.

Report Issues

For non-fatal issues (those that don't cause ImageVis3D to crash), please use the `Help | Report an Issue' dialog within ImageVis3D itself. This causes additional debugging information which is useful for ImageVis3D developers to be sent along with your bug report. Further, if the issue is dataset specific, you can upload your dataset easily via this mechanism.

For all other issues, we ask that you subscribe to the iv3d-users mailing list and post any problems you run into there.

Using ImageVis3D

Manual

The ImageVis3D 1.0 manual is now available.

Video Tutorials

First Start

• initial setup [MOV]
• the welcome screen [MOV]

Loading Data

• from a native UVF File [MOV]
• from an external File [MOV]
• from a directory of files (e.g. DICOM, Images) [MOV]

Rendering

• general rendermodes [MOV]
• the LOD system [MOV]
• 2D slice and MIP views [MOV]
• locking views [MOV]
• red/blue (anaglyph) stereo [MOV]

Recording

• 3D views [MOV]
• MIP rotations

Feedback

• Submitting an error report [MOV]

more coming soon.

Development Information

Design Principles

• Lightweight Application
• Interactive
• Large Dataset Support
• Flexible UI
• Support a Wide range of Software & Hardware
• Foundation for other Apps
• Foundation for Research Projects
• MIT License

Near Term Development Focus

• ImageVis3D Mobile
• Nearest neighbor interpolation option.

Long Term Development Focus

• Shader factory
• Interactive merging of multiple datasets.