WEMSave

MLModule

genre	WEMPersistence
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	MLWEMModules
definition	MLWEMModules.def
see also	WEMLoad, LocalWEMLoad
keywords	file, format, surface, off, ply, stl, geom

Purpose

The module WEMSave saves a WEM in various 3D mesh file formats.

Details

The following 3D mesh file formats are currently supported by this module:

Format	Description
Object File Format (.off, .geom)	This file format was developed in 1986 at Digital Equipment Corporation’s Workstation Systems Engineering for the interchange and archiving of 3D objects. It is mostly known as the GeomView Object File Format due to its use in the 3D mesh viewer of the same name. Useful links: http://www.geomview.org/
Wavefront (.obj)	This file format is used by the WaveFront suite of commercial high-end animation packages. It was developed by Wavefront/Alias Technologies and is also used in 3D photography. Useful link: https://people.sc.fsu.edu/~jburkardt/data/obj/obj.html
Polygon File Format (.ply)	This file format is also known as the Stanford File Format and is widely recognized because of the Stanford Bunny, which is a scan-converted 3D mesh of a bunny. Its shape is well-suited for testing triangle reduction and triangle decimation algorithms due to its specific geometry. Useful links: https://people.sc.fsu.edu/~jburkardt/data/ply/ply.html https://graphics.stanford.edu/data/3Dscanrep/
Standard Tessellation Language (.stl)	STL (Standard Tessellation Language) is a file format native to the stereolithography CAD software created by 3D Systems in Valencia, CA, USA. STL files describe only the surface geometry of a three-dimensional object without any representation of color, texture, or other common CAD model attributes. Useful link: Wikipedia - STL
VRML (.wrl)	WEMLoad supports a rudimentary VRML format for loading indexed triangle faces with colors and normals.
Winged Edge Mesh (.wem)	This format was created to support the ever-growing number of WEM features. It is the only format that can hold the very specific WEM parameters. More advanced WEM-related elements cannot be stored by other public formats. Its main goal is to keep the loading process as fast as possible, and it achieves this by loading meshes at least two to four times faster. The size on disk is also considerably smaller.

Windows

Default Panel

Input Fields

inWEM

name: inWEM, type: WEM(MLBase)

The WEM to be saved.

For accessing this object via scripting, see the Scripting Reference: MLWEMWrapper.

Parameter Fields

Field Index

Auto Apply: Bool	listenToFinishingNotifications: Bool	Should Save Node Colors: Bool
Auto Update: Bool	listenToRepaintNotifications: Bool	Should Save Node Normals: Bool
autoClear: Bool	listenToSelectionChangedNotifications: Bool	Should save PVLs: Bool
elapsedTime: Float	progress: Float	Status: String
File Type: Enum	Save (apply): Trigger	Successful: Bool
Filename: String	save (save): Trigger	Used Filename: String
inWEMValid: Bool	Should Save Edges: Bool
isProcessing: Bool	Should Save Face Normals: Bool

Visible Fields

Auto Apply

name: autoApply, type: Bool, default: FALSE

If checked, all changes of parameters lead to a saving of the input WEM.

Auto Update

name: autoUpdate, type: Bool, default: FALSE

If checked, all changes of the input WEM lead to a saving of it.

Save

name: apply, type: Trigger

When pressed, the input WEM is saved with the current parameter settings.

Filename

name: filename, type: String

Sets the filename of the target file.

File Type

name: fileType, type: Enum, default: Winged Edge Mesh File Format (.wem)

Defines the target file format.

Values:

Title	Name	Description
​By Extension	​By Extension	​The file type is chosen by the extension in the filename.
​Object File Format (.off)	​Object File Format (.off)
​Geomview File Format (.geom)	​Geomview File Format (.geom)
​Wavefront (.obj)	​Wavefront (.obj)
​ASCII Stanford Polygon File Format (.ply)	​ASCII Stanford Polygon File Format (.ply)
​ASCII Standard Tessellation Language (.stl)	​ASCII Standard Tessellation Language (.stl)
​Binary Standard Tessellation Language (.stl)	​Binary Standard Tessellation Language (.stl)
​Winged Edge Mesh File Format (.wem)	​Winged Edge Mesh File Format (.wem)
​ASCII Inventor File Format (.iv)	​ASCII Inventor File Format (.iv)

Used Filename

name: usedFilename, type: String, persistent: no

Shows the actual used filename.

If no file extension was provided, the module appends the selected File Type to the name, and this field displays the resulting filename.

Note that this field is only updated when save is pressed.

Successful

name: savingSuccessful, type: Bool, persistent: no

Shows whether the saving to a file was successful.

Status

name: status, type: String

Shows the status of the module.

Should Save Node Normals

name: shouldSaveNodeNormals, type: Bool, default: FALSE

If checked, node normals are saved in the .wem format.

Should Save Node Colors

name: shouldSaveNodeColors, type: Bool, default: FALSE

If checked, node colors are saved in the .wem format.

Should Save Edges

name: shouldSaveEdges, type: Bool, default: FALSE

If checked, edges and their links to the other structures are saved in the .wem format.

Should Save Face Normals

name: shouldSaveFaceNormals, type: Bool, default: FALSE

If checked, face normals are saved in the .wem format.

Should save PVLs

name: shouldSavePVLs, type: Bool, default: TRUE

If checked, all Primitive Value Lists are saved in the .wem format.

Hidden Fields

isProcessing

name: isProcessing, type: Bool, persistent: no

elapsedTime

name: elapsedTime, type: Float, persistent: no

autoClear

name: autoClear, type: Bool, default: TRUE

listenToFinishingNotifications

name: listenToFinishingNotifications, type: Bool, default: FALSE

listenToRepaintNotifications

name: listenToRepaintNotifications, type: Bool, default: FALSE

listenToSelectionChangedNotifications

name: listenToSelectionChangedNotifications, type: Bool, default: FALSE

save

name: save, type: Trigger

inWEMValid

name: inWEMValid, type: Bool, default: FALSE

progress

name: progress, type: Float, persistent: no