MeshLabLauncher (X3DJSAIL, X3D Java Scene Access Interface Library)

java.lang.Object
- org.web3d.x3d.jsail.MeshLabLauncher

```
public class MeshLabLauncher
extends java.lang.Object
```
Utility class for invoking and launching MeshLab via local operating system to perform a variety of conversion tasks. Note use of static methods.

See Also:

STL (file format), MeshLab, Wikipedia: MeshLab, SourceForge: meshlab in command-line?, SourceForge: Automating Meshlab conversion , GitHub: meshlabserver.txt command-line help, GitHub: TheNerdJedi/MeshlabAuto, Mr. P. MeshLab Tutorials: MeshLab Basics, Mr. P. MeshLab Tutorials: 3D Scanning pipeline, Mr. P. MeshLab Tutorials: Features, Mr. P. MeshLab Tutorials: Cleaning, StackOverflow: MeshLab, GitHub: MeshlabAuto, GitHub: issues, MeshLab References, Java Tutorials: Understanding (Static) Class Members, X3D Scene Authoring Hints

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`MESHLAB_URL` MeshLab website URL
`static java.lang.String`	`USAGE` Usage: `java [-classpath X3DJSAIL.*.jar] org.web3d.x3d.jsail.MeshLabLauncher sourceFile [resultFile] [-convert \| -help \| -properties fileName.properties \| -MESHLAB_PATH directoryPath]`

Constructor Summary

Constructors
Constructor and Description

MeshLabLauncher()

Constructors
Constructor and Description
`MeshLabLauncher()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`checkMeshLabPath()` Check MeshLab local path and also executable name, reset to operating system defaults if necessary.
`static boolean`	`convertModel(java.lang.String inputFileName, java.lang.String outputFileName)` Use meshLab to convert model from one file to another.
`static boolean`	`convertModel(java.lang.String path, java.lang.String inputFileName, java.lang.String outputFileName)` Use meshLab to convert model from one file to another.
`static java.lang.String`	`executeCommand(java.lang.String command)` Launch MeshLab in operating system and run command.
`static boolean`	`exportModelToFile(X3DObject modelToExport, java.lang.String path, java.lang.String fileName)` TODO: Use MeshLab to export geometry to STL
`static boolean`	`exportSTLtoFile(X3DObject modelToExport, java.lang.String path, java.lang.String fileName)` TODO: Use MeshLab to export geometry to file
`static java.lang.String`	`getMeshLabAnalytics(X3DObject modelOfInterest)` TODO: Get MeshLab metrics for X3D model of interest.
`static MetadataSetObject`	`getMeshLabAnalyticsX3dMetadataSet(X3DObject modelOfInterest)` TODO: Get MeshLab metrics as MetadataSet object.
`static java.lang.String`	`getMeshLabVersion()` Get MeshLab version.
`static java.lang.String`	`getPriorMeshLabTraceLogContents()` Get contents of MeshLab trace log file produced during most recent MeshLab operation.
`static java.lang.String`	`getPriorMeshLabTraceLogFilePath()` Get name of MeshLab trace log file produced during most recent MeshLab operation.
`static boolean`	`hasMeshLab()` Determine if MeshLab is locally available.
`static X3DObject`	`importModel(java.lang.String fileName)` Use meshLab to import model to X3D.
`static X3DObject`	`importModel(java.lang.String path, java.lang.String fileName)` Use meshLab to import model to X3D.
`X3DObject`	`importSTL(java.lang.String path, java.lang.String fileName)` TODO: Use meshLab to import STL geometry as X3D model
`static void`	`initialize()` Initialize this MeshLabLauncher instance to default values.
`static void`	`launchMeshLabWebPage()` Open MeshLab page
`static void`	`main(java.lang.String[] args)` Default main() method provided for test purposes, invoking run() method.
`static void`	`run(java.lang.String[] args)` Default run() method provided for test purposes, first initializing ConfigurationProperties then reading properties file (if any) and processing arguments.
`static void`	`setPriorMeshLabTraceLogFilePath(java.lang.String value)` Set name of MeshLab trace log file produced during most recent MeshLab operation.
`static boolean`	`wasPriorCommandSuccessful()` Report whether prior command was successful.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - USAGE
```
public static final java.lang.String USAGE
```
    Usage: java [-classpath X3DJSAIL.*.jar] org.web3d.x3d.jsail.MeshLabLauncher sourceFile [resultFile] [-convert | -help | -properties fileName.properties | -MESHLAB_PATH directoryPath]
    
    See Also:
    
    Constant Field Values
  - MESHLAB_URL
```
public static final java.lang.String MESHLAB_URL
```
    MeshLab website URL
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - MeshLabLauncher
```
public MeshLabLauncher()
```
- Method Detail
  - checkMeshLabPath
```
public static void checkMeshLabPath()
```
    Check MeshLab local path and also executable name, reset to operating system defaults if necessary. Executable name: meshlabserver.exe on Windows, meshlabserver otherwise.
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab, ConfigurationProperties.getMeshLabServerExecutableName(), ConfigurationProperties.setMeshLabServerExecutableName(String)
  - wasPriorCommandSuccessful
```
public static boolean wasPriorCommandSuccessful()
```
    Report whether prior command was successful.
    
    Returns:
    
    whether prior command was successful. Warning: meshlabserver may popup an exception window while running headless (not very smart) which can cause exception to be lost following timeout.
    
    See Also:
    
    StackOverflow: possible to capture pop-up message box?
  - executeCommand
```
public static java.lang.String executeCommand(java.lang.String command)
```
    Launch MeshLab in operating system and run command. Warning: meshlabserver may popup an exception window while running headless (not very smart) which can cause exception to be lost following timeout.
    
    Parameters:
    
    command - MeshLab invocation
    
    Returns:
    
    console results
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab, StackOverflow: possible to capture pop-up message box?
  - convertModel
```
public static boolean convertModel(java.lang.String inputFileName,
                                   java.lang.String outputFileName)
```
    Use meshLab to convert model from one file to another.
    
    Parameters:
    
    inputFileName - for input file
    
    outputFileName - for output file
    
    Returns:
    
    whether successful
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - convertModel
```
public static boolean convertModel(java.lang.String path,
                                   java.lang.String inputFileName,
                                   java.lang.String outputFileName)
```
    Use meshLab to convert model from one file to another.
    
    Parameters:
    
    path - directory path to file of interest
    
    inputFileName - for input file
    
    outputFileName - for output file
    
    Returns:
    
    whether successful
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - importModel
```
public static X3DObject importModel(java.lang.String fileName)
```
    Use meshLab to import model to X3D.
    
    Parameters:
    
    fileName - for input file
    
    Returns:
    
    result, null if unsuccessful
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - importModel
```
public static X3DObject importModel(java.lang.String path,
                                    java.lang.String fileName)
```
    Use meshLab to import model to X3D.
    
    Parameters:
    
    path - directory path to file of interest
    
    fileName - for input file
    
    Returns:
    
    result, null if unsuccessful
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - importSTL
```
public X3DObject importSTL(java.lang.String path,
                           java.lang.String fileName)
```
    TODO: Use meshLab to import STL geometry as X3D model
    
    Parameters:
    
    path - directory path to file of interest
    
    fileName - for input file
    
    Returns:
    
    result, null if unsuccessful
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - exportModelToFile
```
public static boolean exportModelToFile(X3DObject modelToExport,
                                        java.lang.String path,
                                        java.lang.String fileName)
```
    TODO: Use MeshLab to export geometry to STL
    
    Parameters:
    
    modelToExport - X3D model of interest
    
    path - directory path for X3D model of interest
    
    fileName - file name for X3D model of interest
    
    Returns:
    
    plain-text STL file
    
    See Also:
    
    STL (file format), MeshLab, Wikipedia: MeshLab
  - exportSTLtoFile
```
public static boolean exportSTLtoFile(X3DObject modelToExport,
                                      java.lang.String path,
                                      java.lang.String fileName)
```
    TODO: Use MeshLab to export geometry to file
    
    Parameters:
    
    modelToExport - X3D model of interest
    
    path - directory path to file of interest
    
    fileName - for output file
    
    Returns:
    
    whether successful
    
    See Also:
    
    STL (file format), MeshLab, Wikipedia: MeshLab
  - getMeshLabAnalytics
```
public static java.lang.String getMeshLabAnalytics(X3DObject modelOfInterest)
```
    TODO: Get MeshLab metrics for X3D model of interest.
    
    Parameters:
    
    modelOfInterest - X3D model to analyze
    
    Returns:
    
    MeshLab output
    
    See Also:
    
    STL (file format), MeshLab, Wikipedia: MeshLab
  - getMeshLabAnalyticsX3dMetadataSet
```
public static MetadataSetObject getMeshLabAnalyticsX3dMetadataSet(X3DObject modelOfInterest)
```
    TODO: Get MeshLab metrics as MetadataSet object.
    
    Parameters:
    
    modelOfInterest - X3D model to analyze
    
    Returns:
    
    MeshLab output
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - getMeshLabVersion
```
public static java.lang.String getMeshLabVersion()
```
    Get MeshLab version.
    
    Returns:
    
    MeshLab version.
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - hasMeshLab
```
public static boolean hasMeshLab()
```
    Determine if MeshLab is locally available.
    
    Returns:
    
    whether MeshLab is found.
    
    See Also:
    
    MeshLab, Wikipedia: MeshLab
  - getPriorMeshLabTraceLogFilePath
```
public static java.lang.String getPriorMeshLabTraceLogFilePath()
```
    Get name of MeshLab trace log file produced during most recent MeshLab operation.
    
    Returns:
    
    name of most recent MeshLab trace log file
  - setPriorMeshLabTraceLogFilePath
```
public static void setPriorMeshLabTraceLogFilePath(java.lang.String value)
```
    Set name of MeshLab trace log file produced during most recent MeshLab operation.
    
    Parameters:
    
    value - new path and file name for meshLabTraceLogFilePath
  - getPriorMeshLabTraceLogContents
```
public static java.lang.String getPriorMeshLabTraceLogContents()
```
    Get contents of MeshLab trace log file produced during most recent MeshLab operation.
    
    Returns:
    
    contents of most recent MeshLab trace log file
  - initialize
```
public static final void initialize()
```
    Initialize this MeshLabLauncher instance to default values.
  - main
```
public static void main(java.lang.String[] args)
```
    Default main() method provided for test purposes, invoking run() method.
    
    Parameters:
    
    args - the command line arguments
    
    See Also:
    
    run(String[]), X3DObject.handleArguments(String[])
  - run
```
public static void run(java.lang.String[] args)
```
    Default run() method provided for test purposes, first initializing ConfigurationProperties then reading properties file (if any) and processing arguments. When invoked without parameters then reports results of validate() self-checks to system output.
    
    Parameters:
    
    args - the command line arguments
    
    See Also:
    
    main(String[]), ConfigurationProperties, X3DObject.handleArguments(String[])
  - launchMeshLabWebPage
```
public static void launchMeshLabWebPage()
```
    Open MeshLab page
    
    See Also:
    
    http://www.MeshLab.net

Class MeshLabLauncher

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

USAGE

MESHLAB_URL

Constructor Detail

MeshLabLauncher

Method Detail

checkMeshLabPath

wasPriorCommandSuccessful

executeCommand

convertModel

convertModel

importModel

importModel

importSTL

exportModelToFile

exportSTLtoFile

getMeshLabAnalytics

getMeshLabAnalyticsX3dMetadataSet

getMeshLabVersion

hasMeshLab

getPriorMeshLabTraceLogFilePath

setPriorMeshLabTraceLogFilePath

getPriorMeshLabTraceLogContents

initialize

main

run

launchMeshLabWebPage