You are here: Start » AVL.NET » AVL.CropSurface

AVL.CropSurface

Removes from the surface points that are not contained in a given rectangular box.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void CropSurface
(
	AvlNet.Surface inSurface,
	NullableRef<AvlNet.Region> inRoi,
	double? inMinX,
	double? inMaxX,
	double? inMinY,
	double? inMaxY,
	double? inMinZ,
	double? inMaxZ,
	bool inPreserveDimensions,
	AvlNet.Surface outSurface,
	AvlNet.Region outRejected
)

Parameters

Name Type Range Default Description
inSurfaceAvlNet.SurfaceInput surface.
inRoiAvlNet.NullableRef<AvlNet.Region>Region of interest. Default value: atl::NIL.
inMinXdouble?
inMaxXdouble?
inMinYdouble?
inMaxYdouble?
inMinZdouble?
inMaxZdouble?
inPreserveDimensionsboolFalseFlag indicating whether the surface dimensions should be preserved or not. Default value: False.
outSurfaceAvlNet.SurfaceOutput surface.
outRejectedAvlNet.RegionRegion of locations where points are not contained in a given rectangular box.

Description

The operation removes points from surface that are not contained in a given rectangular box within provided coordinates.
It is also possible to narrow this box by editing inRoi, Region of Interest of operation.
Coordinates are defined via acceptable ranges of their values. E.g. inMinX is minimum and inMaxX is maximum value of the X coordinate. Every point with its X coordinate outside of this range is removed.
Flag inPreserveDimensions informs if the operation output should keep the original dimensions of its input. E.g. if inSurface has its Width=300, Height=200 and Pitch=608 and the flag is enabled, the outSurface will have exactly the same dimensions of 300x200x608. However, if the flag is disabled, outSurface will have its dimensions smaller to adjust them to surface size, but its XOffset, YOffset, ZOffset properties will be accordingly bigger in order to keep the surface in the same place in workspace.
Operation returns the cropped Surface as well as removed Region if one needs to perform further actions on removed points.

Examples

A sample Surface object.

The same Surface object seen from above.

A sample Surface object cropped through half of its height.

Cropped Surface object seen from above.

Properties of a cropped surface with dimension preservation enabled.

Properties of a cropped surface with dimension preservation disabled.

Function Overrides

See also