diff --git a/.github/workflows/CompileAndRelease.yml b/.github/workflows/CompileAndRelease.yml index e01b192c9..ecf86f15e 100755 --- a/.github/workflows/CompileAndRelease.yml +++ b/.github/workflows/CompileAndRelease.yml @@ -1,9 +1,9 @@ name: CompileAndRelease on: - [push, pull_request] #just for test release scripts - #schedule: - # - cron: '0 0 1 * *' #every first day of the month at midnight + #[push, pull_request] #just for test release scripts + schedule: + - cron: '0 0 1 * *' #every first day of the month at midnight jobs: ubuntu_build: diff --git a/README.md b/README.md index dae2e72da..127f03ca5 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ This is the official repository for the source and the binaries of MeshLab. -MeshLab is an open source, portable, and extensible system for the processing and editing of unstructured large 3D triangular meshes. It is aimed to help the processing of the typical not-so-small unstructured models arising in 3D scanning, providing a set of tools for editing, cleaning, healing, inspecting, rendering and converting this kind of meshes. These tools include MeshLab proper, a versatile program with a graphical user interface, and [meshlabserver](https://github.com/cnr-isti-vclab/meshlab/blob/master/src/meshlabserver/meshlabserver.txt), a program that can perform mesh processing tasks in batch mode, without a GUI. +MeshLab is an open source, portable, and extensible system for the processing and editing of unstructured large 3D triangular meshes. It is aimed to help the processing of the typical not-so-small unstructured models arising in 3D scanning, providing a set of tools for editing, cleaning, healing, inspecting, rendering and converting this kind of meshes. These tools include MeshLab proper, a versatile program with a graphical user interface, and [meshlabserver](https://github.com/cnr-isti-vclab/meshlab/blob/master/src/meshlabserver/README.md), a program that can perform mesh processing tasks in batch mode, without a GUI. MeshLab is mostly based on the open source C++ mesh processing library [VCGlib](http://www.vcglib.net) developed at the [Visual Computing Lab](http://vcg.isti.cnr.it) of [ISTI - CNR](http://www.isti.cnr.it). VCG can be used as a stand-alone large-scale automated mesh processing pipeline, while MeshLab makes it easy to experiment with its algorithms interactively. @@ -19,22 +19,22 @@ You can find the last MeshLab release in the [Releases Tab](https://github.com/c You can also test a built version of MeshLab generated by the last commit pushed in this repository, by downloading the artifacts of the last [Github Actions](https://github.com/cnr-isti-vclab/meshlab/actions) workflow. ### Note for Windows -Right now, the portable version of meshlab won't start if doesn't find a Visual C++ Compiler installed. If you get the error "MSVCP140.dll not found" or related, please install Visual C++ Redist by executing the `vc_redist.exe` file contained in the meshlab portable archive. Alternatively, you can download Visual C++ Redist [here](https://support.microsoft.com/it-it/help/2977003/the-latest-supported-visual-c-downloads). +The portable version of meshlab won't start if doesn't find a Visual C++ Compiler installed. If you get the error "MSVCP140.dll not found" or related, please install Visual C++ Redist by executing the `vc_redist.exe` file contained in the meshlab portable archive. Alternatively, you can download Visual C++ Redist [here](https://support.microsoft.com/it-it/help/2977003/the-latest-supported-visual-c-downloads). # Build instructions We provide a set of scripts that build and deploy automatically MeshLab. All the scripts can be found in the [install](https://github.com/cnr-isti-vclab/meshlab/tree/master/install) folder. -For specific build instructions see the [src](https://github.com/cnr-isti-vclab/meshlab/tree/master/src) folder. +For specific build instructions see the [src](https://github.com/cnr-isti-vclab/meshlab/blob/master/src/README.md) folder. # Structure of the Repository The MeshLab repository is organized as follows: -* `distrib`: this folder contains a set of prebuilt libraries, shaders and plugins that will be used by MeshLab once it is compiled. Binaries and plugins will be placed in this folder after MeshLab is built, or a copy of this folder will be placed in the chosen shadow build directory. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/tree/master/distrib); +* `distrib`: this folder contains a set of prebuilt libraries, shaders and plugins that will be used by MeshLab once it is compiled. Binaries and plugins will be placed in this folder after MeshLab is built, or a copy of this folder will be placed in the chosen shadow build directory. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/tree/master/distrib/README.md); * `docs`: doxygen scripts for generating MeshLab documentation. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/tree/master/docs); -* `install`: in this folder there are a set of platform-dependent script to build and deploy MeshLab. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/tree/master/install); +* `install`: in this folder there are a set of platform-dependent script to build and deploy MeshLab. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/tree/master/install/README.md); * `sample`: a set of files (meshes, images) used for tests; -* `src`: this folder contains all the source code of MeshLab, its plugins and the external libraries that it requires. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/tree/master/src); +* `src`: this folder contains all the source code of MeshLab, its plugins and the external libraries that it requires. For more details, check the readme [here](https://github.com/cnr-isti-vclab/meshlab/blob/master/src/README.md); * `vcglib`: submodule of [VCGLib](https://github.com/cnr-isti-vclab/vcglib). # License diff --git a/install/linux/README.md b/install/linux/README.md index 5d4b5f61f..d4d1d4ff5 100644 --- a/install/linux/README.md +++ b/install/linux/README.md @@ -15,6 +15,9 @@ The follwing scripts are provided: * `linux_appimage.sh`: this script makes the `distrib` folder a portable version of MeshLab (no Qt and other libraries dependencies), and generates an [AppImage](https://appimage.org/) that can be run in a Linux Environment without dependencies; * it requires a properly built meshlab `distrib` directory (see `linux_build.sh`); * without given arguments, the folder that will be deployed is `meshlab/distrib`. You can give as argument the `DISTRIB_PATH`. +* `linux_meshlabserver_appimage.sh`: this script generates an [AppImage](https://appimage.org/) of [MeshLabServer](https://github.com/cnr-isti-vclab/meshlab/blob/master/src/meshlabserver/README.md) that can be run in a Linux Environment without dependencies; + * it requires a properly built meshlab `distrib` directory (see `linux_build.sh`); + * without given arguments, the folder that will be deployed is `meshlab/distrib`. You can give as argument the `DISTRIB_PATH`. * `linux_make_it.sh`: this script builds, deploys and generates an [AppImage](https://appimage.org/) that can be run in a Linux Environment without dependencies; * it requires a properly set Qt environment (see `linux_setup_env_ubuntu.sh`); * without given arguments, all the binaries will be placed in the `meshlab/distrib` folder. You can give as argument the `BUILD_PATH`, and meshlab binaries and the AppImage will be then placed inside `BUILD_PATH/distrib`; diff --git a/install/linux/linux_meshlabserver_appimage.sh b/install/linux/linux_meshlabserver_appimage.sh index d357ff184..7435b889d 100755 --- a/install/linux/linux_meshlabserver_appimage.sh +++ b/install/linux/linux_meshlabserver_appimage.sh @@ -1,15 +1,15 @@ #!/bin/bash -# this is a script shell for setting up the application bundle for linux -# Requires a properly built meshlab (does not require to run the -# linux_deploy.sh script). +# this is a script shell for setting up the application bundle of meshlabserver for linux +# Requires a properly built meshlab (does not require to run the linux_deploy.sh script). # # This script can be run only in the oldest supported linux distro that you are using # due to linuxdeployqt tool choice (see https://github.com/probonopd/linuxdeployqt/issues/340). # -# Without given arguments, MeshLab AppImage will be placed in the meshlab/distrib +# Without given arguments, MeshLabServer AppImage will be placed in the meshlab # directory. # -# You can give as argument the DISTRIB_PATH. +# You can give as argument the DISTRIB_PATH, and the output AppImage will be placed +# in the directory DISTRIB_PATH/../ cd "${0%/*}" #move to script directory