# LydiaLab

**Repository Path**: mcoder2014/LydiaLab

## Basic Information

- **Project Name**: LydiaLab
- **Description**: 魔改版本的 Starlab
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-22
- **Last Updated**: 2021-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# **LydiaLab**starlab

A lightweight, modular, and cross-platform (Windows, OSX, Linux) 3D geometry processing environment.This project is based on StarLab for a little further development.

![Running on Windows 8](/media/coverimageWin8.png)

![Running ICP plugin on OSX](/media/coverimageOSX.png)

![Running on Ubuntu](/media/coverimageUbuntu.png)

## Requirments

* Qt 5
* Modern C++ compiler(C++11)

## Features

* Lightweight, minimal external dependency
* Uses a state of the art mesh data-structure and linear algebra library (Surface_mesh + Eigen)
* You can write graphical algorithms in plugin form so that you can easily see the implementation of the algorithm in a graphical interface.

## Developing a Starlab Plugin

There are several types of plugins you can easily write:

* **Filter** plugin :Suitable for simple graphics algorithms
* **InputOutput** plugin
* **Mode** plugin :Suitable for graphics algorithms that require a lot of interaction

Simply copy any of the provided example plugins and rename them as your own. You will find the example code in [My LydiaLab Plugins](https://github.com/mcoder2014/LydiaLabExpPlugins)

### Filter Plugin

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:

```c++
    void initParameters( RichParameterSet* pars );
    void applyFilter( RichParameterSet* pars );
```

Where you can easily add parameters such as:

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

And use them in your `applyFilter()` method:

```c++
bool isVisualize = pars->getBool("visualize")
```

### Mode Plugin

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](http://www.youtube.com/watch?v=95KVrSfc1r8).

Several functions to look into are:

```c++
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.

### Reference

1. [The origin starlab project](https://github.com/OpenGP/starlab)
2. [My LydiaLab Plugins](https://github.com/mcoder2014/LydiaLabExpPlugins)