admesh/admeshgui

STL viewer and manipulation tool

ADMeshGUI

STL viewer and manipulation tool.

Manipulation and repair algorithms come from ADMesh library and stlsplit library is used for splitting. ADMeshGUI is licensed under the GNU Affero General Public License, version 3. Whole text of the license comes in LICENSE file which is included in this package.

Building

In order to run ADMeshGUI, ADMesh library, stlsplit library, Qt 5.4 (or higher) with qmake, OpenGL and g++ are necessary.

On Linux, unzip downloaded package, navigate to target directory and type following into terminal:

qmake # or qmake-qt5 on some distros
make
sudo make install

On Mac OS X use homebrew. You can install ADMeshGUI directly from our homebrew tap by typing following into terminal:

brew tap admesh/admesh
brew install admeshgui --HEAD
brew linkapps admeshgui

or if you prefer to build it manually, type following into terminal (installs all required dependencies):

brew tap admesh/admesh
brew install gettext qt5 admesh stlsplit
/usr/local/opt/qt5/bin/qmake 
make	

On Windows download admeshgui-win.zip containing precompiled application.

If you intend to build ADMeshGUI on Windows by yourself, the process is not that straightforward though. You must make sure Qt5 and all other dependendencies (admesh, stlsplit, gettext) are properly installed and paths set, so it is possible to link them. Then run qmake and make in terminal.

It is also possible to build ADMeshGUI in Qt Creator which comes with Qt package.

Running ADMeshGUI from command line tool

admeshgui file_1.stl file_2.stl file_3.stl ... file_n.stl

Files given as parameters will be opened in ADMeshGUI.

Features

• View STL files
  • Highlighted flaws
  • 3 modes: solid, solid with highlighted edges and wireframe
  • Selection of files. It is possible to have more files open and process only some.
  • User defined colors
• Scale by x, y and z axes
• Mirror along xz, xy and yz planes
• Rotate along x, y and z axes
• Translate in x, y and z directions
• Merge files
• Split files
• Repair files
  • Fill holes
  • Repair facets orientation
  • Repair normals
  • Remove degenerate facets
  • Repair facets by connecting nearby facets that are within a given tolerance
• Save as binary or ASCII STL
• Export to .OBJ, .OFF, .VRML, .DXF file formats

ADMeshGUI was succesfully run on following systems: Ubuntu 14.04 LTS, Fedora 21, Mac OS X 10.9 Mavericks, Mac OS X 10.10 Yosemite, Windows 7 64-bit

admeshgui's Issues

Screenshots

Is it possible to add a screenshot in the readme?

SIGSEGV: Drag and drop RMB

When i click to the canvas area with right mouse button and drag it around (still clicked) - similar to the way I do pan with MMB or rotation with LMB, I get a SIGSEGV.

Happens on Linux and Mac. Apparently, dark theme only.

update

hey, update admeshgui app for qt5 and qt6

I randomly see or don't see the OpenGL canvas

I've just updated to Fedora 25 and I'm having a strange error with ADMeshGUI.

When I launch ADMeshGUI (empty or with file), I get cca 50 % chance of OpenGL canvas with grid and file and 50 % chance with emptiness.

Bad:

Good:

There is no error on stout or stderr. The chance of seeing the OpenGL canvas appears to be pretty random. Those are last 20 launches: GGBGGBGGBBGGBGGBBGGG (G is good and B is bad).

Homebrew depricated `linkapps`

Please notice that linkapps has been depricated for some time...

The reason: Homebrew/brew#1808

╭─syky at aluminium in ~ using ‹2.5.1›
╰─○ brew linkapps admeshgui
Error: Unknown command: linkapps

Solution - create cask...

ADMeshGUI on Mac OS X

This is here to tract the status of ADMeshGUI on Mac OS X.

It is a continuation of discussion on admesh/homebrew-admesh#1