WEMSave

MLModule

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

Purpose

The module WEMSave saves a WEM to different 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 GeomView Object File Format because of its use in the 3D mesh viewer with the same name. Useful links: http://www.geomview.org/ http://www.csit.fsu.edu/~burkardt/data/off/off.html
Wavefront (*.obj)	This file format is used by the WaveFront suite of commercial high-end animation packages. It was developed by Wavefront/Alias Technologies. The file format is also used in 3D photography. Useful link: http://www.csit.fsu.edu/~burkardt/data/obj/obj.html
Polygon File Format (*.ply)	This format is also known as Stanford File Format and is widely known because of the Stanford Bunny which is a scan-converted 3D mesh of a bunny. Its shape is very good for testing triangle reduction and triangle decimation algorithms due to its specific geometry. Useful links: http://www.csit.fsu.edu/~burkardt/data/ply/ply.html http://astronomy.swin.edu.au/~pbourke/dataformats/ply/ http://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 of 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: http://en.wikipedia.org/wiki/STL_(file_format)
Winged Edge Mesh (*.wem)	This format was created to support the ever growing number of WEM features. It is the only format which can hold the very specific WEM parameters. The more advanced WEM related things cannot be stored by the other public formats. Its main goal is to keep the loading process as fast as possible, and it succeeds so by loading meshes at least two to four times faster. The size on disk is also considerably smaller.

More information on the public file formats can be found at this link: http://cmp.felk.cvut.cz/~pajdla/Doc/3D.formats.html

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
Filename: String	save (save): Trigger
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

If 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)

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 PVLs 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