CutPolylines

Synopsis

A mapper module that cuts a 3D polyline mesh on an imported cut-plane. This allows one to cut a bounding box of an object with the object inside.

Input Ports

Name Type Description

in_cut &cut_plane reference to a cut_plane module. This cut plane module provides the location of the cuting plane.
in_polyline Mesh+Data polyline Mesh that is to be cut on the plane provieded by in_cut.

Output Ports

Name Type Description

out Mesh+Data output field after cutting
obj DataObject directly renderable output object

Description

The CutPolylines macro crops a 3D polyline mesh according to the parameters of another cut_plane module. The module itself does not provide a user interface as all necessary parameters are taken from the provided cut_plane. This aligns the cut of ie. a bounding box of a given object with the cut of the object itself. The CutPolylines macro needs a reference to the cut_plane module itself as input rather than one of its outputs. This allows the use of additional internal parameters such as the distance to the cutting plane for cutting the polyline mesh. A simple network to use the module could look:

Network for CutPolylines

Inputs

in_cut

Reference to the field input that is to be cropped. The field should contain at least a Mesh component. If Node_Data or Cell_Data components are present then the user interface can be used to specify which of these should be copied across to the output.

in_polyline

Reference to the polyline field input that is to be cropped.

Outputs

out

The most primitive output field of the CutPolylines macro. This contains the new 3D polyline mesh model generated from the model present on the input, cropped using the plane specified by the module connected to in_cut.

obj

The directly renderable output field of the CutPolylines macro. This contains a DataObject object that can be rendered by the standard data viewers. The Data Object is generated directly from the field data created from the input model.

Utility Modules

The User Macro CutPolylines makes use of the CutPolylinesCore module.

Example

An example application CutPolylinesEg is provided, which loads an Example field file and and cuts the bounding box on the same plane as the isosurface of the object.

Files

iac_proj/polycut/polycut.v Creates the IAC_PROJ.CutPolylines library.

iac_proj/polycut/pc_mods.v Creates the CutPolylinesMods library containing the low-level module CutPolylinesCore and CutPolylinesTest.

iac_proj/polycut/pc_macs.v Creates the CutPolylinesMacs library containing the high-level macro CutPolylines.

iac_proj/polycut/pc_apps.v Creates the CutPolylinesApps library containing the example applications CutPolylinesEg.

Authors

Dr Joanna Leng
Manchester Visualization Centre

Modifications

Tobias Schiebeck
Manchester Visualization Centre

Contact

International AVS Centre
Manchester Visualization Centre
Kilburn Building
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL