Skip to content
3D geometry processing environment
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
core
data
media
surfacemesh
.gitattributes
.gitignore
Makefile
README.md Update README.md May 10, 2015
starlab_full.pro
starlab_mini.pro

README.md

#starlab

A lightweight, modular, and cross-platform (Windows, OSX, Linux) 3D geometry processing environment.

Running on Windows 8

Running ICP plugin on OSX

Running on Ubuntu

Requirments

  • Qt 5
  • Modern C++ compiler

Features

  • Lightweight, minimal external dependency
  • Uses a state of the art mesh data-structure and linear algebra library (Surface_mesh + Eigen)

Developing a Starlab Plugin

There are two types of plugins you can easily write:

  • Filter plugin
  • Mode plugin

Simply copy any of the provided example plugins and rename them as your own.

Filter

A filter plugin is a one way process on a selected model. You provide any number of parameters and then apply your algorithm. Example surfacemesh_filter_normalize.

The two functions to modify are:

    void initParameters( RichParameterSet* pars );
    void applyFilter( RichParameterSet* pars );

Where you can easily add parameters such as:

pars->addParam(new RichFloat("angle", 90.0f, "Maximum angle"));
pars->addParam(new RichBool("visualize", true, "Visualize result"));

And use them in your applyFilter() method:

bool isVisualize = pars->getBool("visualize")

Mode

A mode plugin gives you full control over the starlab interface. It is useful for interactive or more complex model processing. A tool button with an icon is added to the tool bar for each loaded mode plugin. Example surfacemesh_mode_arapdeform in action.

Several functions to look into are:

void create();
void decorate();
bool keyPressEvent(QKeyEvent *);

The create function is called once the mode is selected. The decorate functions allows you to make OpenGL calls on the current scene. The keyPressEvent and other Qt keyboard and mouse widget events can be overloaded to include your own desired behavior.

You can’t perform that action at this time.