Skip to content

Latest commit

 

History

History
146 lines (110 loc) · 3.4 KB

README.md

File metadata and controls

146 lines (110 loc) · 3.4 KB
Raw

QtAliceVision - AliceVision/OIIO plugin for Qt

QtAliceVision is a C++ plugin providing:

  • classes to load and visualize AliceVision and Alembic data through QML
  • an OpenImageIO backend for image IO in Qt.

Currently available:

  • Features Viewer
    • Position, scale and orientation
    • Status: extracted, matched or reconstructed
  • Matches Viewer
  • Statistics
    • Per view statistics with reprojection error, observations histograms
    • Global SfM statistics with number of landmarks/matches, reprojection errors, observations per view
  • Float Image Viewer
    • Visualize images with floating point precision
    • Dynamically adjust gain and gamma
  • 3D Depth Maps
    • Visualize depth/sim maps generated by the AliceVision framework in a 3D viewer
  • Alembic 3D visualization
    • Point clouds
    • Cameras
  • OIIO backend
    • Read RAW images from DSLRs
    • Read intermediate files of the AliceVision framework stored in EXR format

License

The project is released under MPLv2, see COPYING.md.

Get the project

Get the source code:

git clone --recursive git://github.com/alicevision/QtAliceVision
cd QtAliceVision

See INSTALL.md to build and install the project.

Usage

AliceVision data visualization

Once built and with the plugin installation folder in QML2_IMPORT_PATH:

  • Create an MSfMData object to get access to the SfM information:
import AliceVision 1.0

MSfMData {
  id: sfmData
  sfmDataPath: "/path/to/SfM/sfmData.abc”
}
  • Create an MTracks to load all matches and get access to tracks information:
import AliceVision 1.0

MTracks {
  id: tracks
  matchingFolder: "/path/to/FeatureMatching/UID/”
}
  • Create a FeaturesViewer to visualize features position, scale, orientation and optionally information about the feature status regarding tracks and SfmData.
FeaturesViewer {
  colorOffset: 0
  describerType: "sift"
  featureFolder: "/path/to/features/folder"
  mTracks: tracks
  viewId: 101245654
  color: “blue”
  landmarkColor: “red”
  displayMode: FeaturesViewer.Points
  mSfmData: sfmData
}
  • Create an MSfMDataStats to display global statistics about your SfMData:
MSfMDataStats {
  msfmData: msfmData
  mTracks: mTracks
}
  • Create an MViewStats to display statistics about a specific View of your SfMData:
MViewStats {
  msfmData: msfmData
  viewId: 451244710
}
  • Create a FloatImageViewer to display an image with floating point precision, allowing to dynamically adjust the gain and gamma:
FloatImageViewer {
  source: "/path/to/image"
  gamma: 1.0
  gain: 1.0
  width: textureSize.width || 500
  height: textureSize.height || 500
  channelMode: "RGB" 
}
  • Create a DepthMapEntity to display a depth map as a point cloud in a 3D viewer:
import DepthMapEntity 1.0

Scene3D {
  DepthMapEntity {
    source: "depthmap.exr"
  }
}
  • Create a SfmDataEntity to display point clouds (in .abc, .sfm or .json format) and cameras in a 3D viewer:
import SfmDataEntity 1.0

Scene3D {
  SfmDataEntity {
    source: "/path/to/pointcloud.sfm"
  }
}

OpenImageIO backend

When added to the QT_PLUGIN_PATH, all supported image files will be loaded through this plugin.