Vector |
This class is used to optimize paths and layers. I. e. paths and layers
can be simplified by removing superfluous elements or replacing
commands by other ones more suitable for marking. (In the
RAYGUIDE GUI these operations are available in the context menu
"Vector optimizations" of a vector graphic object in the object tree.)
Inheritance HierarchySystemObject
RAYLASE.Marker.VectorGraphicElementVectorGraphicOptimizer
RAYLASE.Marker.VectorGraphicElementVectorGraphicOptimizer
Namespace: RAYLASE.Marker.VectorGraphicElement
Assembly: RAYLASE.Marker.VectorGraphicElement (in RAYLASE.Marker.VectorGraphicElement.dll) Version: 2.19.0
SyntaxC#
public class VectorGraphicOptimizer
The VectorGraphicOptimizer type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | VectorGraphicOptimizer | Initializes a new instance of the VectorGraphicOptimizer class |
Methods| Name | Description | |
|---|---|---|
| CloseGaps | Closes gaps between open paths if the gaps are not larger than LocationDistance. |
| ClosePaths | Closes the contour of all open paths by adding a line from the end position to the start position. |
| DoublePointsInPolylines(VectorGraphicLayer) | Loops through all paths and inserts in each polyline an additional point between each two points. |
| DoublePointsInPolylines(VectorGraphicPath) | Loops through all commands of the given path and inserts an additional point between each two points of polylines. |
| JoinLayers | Joins layers. All paths will be appended to the first matching layer. |
| JoinPolylines(VectorGraphicLayer) | Loops through all paths and joines in each path adjacent polylines. |
| JoinPolylines(VectorGraphicPath) | Loops through all commands in the given path and joines adjacent polylines. |
| JoinSimilarArcs(VectorGraphicLayer, Double) | Loops through all paths and concatenates in each path adjacent arcs if they are "similar", i. e. they must have the same center and the first arc's end point is the same as the second arc's start point. |
| JoinSimilarArcs(VectorGraphicPath, ListArcToMetafileCommand, Double) | Loops through all commands in the given path and checks, if each two adjacent commands are arcs and if it is possible to replace them by a single arc. If yes, the arcs are merged. |
| JoinStraightLines(VectorGraphicLayer, Double) | Loops through all paths and concatenates in each path adjacent lines if they are collinear. |
| JoinStraightLines(VectorGraphicPath, Double) | Loops through all commands in the given path and searches for polylines. Adjacent polylines are concatenated then if the second (poly)line is collinear with the first one. |
| JoinStraightLines(VectorGraphicPath, ListBaseMetafileCommand, Double) | Loops through all commands in the given path and searches for polylines. Adjacent polylines are concatenated then if the second (poly)line is collinear with the first one and if it is in the given list of commands to join. |
| JoinTouchingPaths | Loops through all paths of the given layer and joins adjacent paths if the predecessor's end point is nearer than LocationDistance to the successor's start point. |
| OptimizeOrientationFilling | |
| OptimizeVectors(IListVectorGraphicLayer, OptimizationSettings, dmat4, Double, Int32, NullableCancellationToken) | Optimizes all objects for filling. For best filling Results, the vectors have to be in order, the objects have to closed and objects contained in another object must be of opposite orientation. |
| OptimizeVectors(IListVectorGraphicLayer, OptimizationSettings, dmat4, Double, Int32, PenSet, NullableCancellationToken) | |
| RemoveDrills(VectorGraphicLayer) | Loops through all paths and removes all drills. |
| RemoveDrills(VectorGraphicPath) | Loops through all commands of the given path and deletes all drills. |
| RemoveDuplicates(VectorGraphicLayer, Double) | Removes duplicate paths in the path list, adjacent duplicate points in polylines and adjacent duplicate loops in polylines. |
| RemoveDuplicates(VectorGraphicPath, Double) | Loops through all commands of the given path, searches for polylines and removes all duplicated points and all loops found in all the polylines. |
| RemoveEmptyPaths | Loops through all paths and removes empty ones. |
| RemoveStraightPoints(VectorGraphicLayer, Double) | Loops through all paths and checks all polylines for adjacent points building a line. If found, the points between the line's borders are removed. |
| RemoveStraightPoints(VectorGraphicPath, Double) | Loops through all commands in the given path, checks all PolyLineMetafileCommands and tries to remove all "linear" points from them. |
| ReplaceAllByDrills | Converts the vectors to a list of drills./> |
| ReplaceAllCommandsByPolylines(VectorGraphicLayer, Int32, Double) | Loops through all paths and replaces all commands by polylines. See CreatePolyline(Int32, Double) for details. |
| ReplaceAllCommandsByPolylines(VectorGraphicPath, Int32, Double) | Loops through all commands in the given path and replaces each one by a polyline if possible, consisting out of NumberOfPoints. See CreatePolyline(Int32, Double) for details. |
| ReplaceArcByDrill | If the given path contains only an arc or an ellipse it is replaced by a drill if its radius is less than or equal than the given one. In case of an ellipse the criterion is its arc length instead, to avoid replacing ellipses with a big axes ratio. |
| ReplaceArcsByDrills | Loops through all paths and replaces all arcs with a radius less than the given one by drills. |
| ReplaceCircularArcsByCubicCurves(VectorGraphicLayer) | Loops through all paths and replaces all circular arcs by approximating cubic curves. |
| ReplaceCircularArcsByCubicCurves(VectorGraphicPath) | Loops through all commands of the given path and converts all circular arcs to approximating cubic curves. |
| ReplaceCircularArcsByEllipticalArcs(VectorGraphicLayer) | Loops through all paths and replaces all circular arcs by elliptical arcs. |
| ReplaceCircularArcsByEllipticalArcs(VectorGraphicPath) | Loops through all commands of the given path and converts all circular arcs to elliptical arcs with both semi axes having the old arc's radius. |
| ReplaceCircularArcsByLines(VectorGraphicLayer) | Loops through all paths and replaces each arc by a single line. |
| ReplaceCircularArcsByLines(VectorGraphicPath) | Loops through all commands of the given path and replaces each arc by a single line. |
| ReplaceCircularArcsByPolylines(VectorGraphicLayer, Int32, Double) | Loops through all paths and replaces all circular arcs by approximating polylines. |
| ReplaceCircularArcsByPolylines(VectorGraphicPath, Int32, Double) | Loops through all commands of the given path and converts all circular arcs to polylines. |
| ReplaceCircularArcsByQuadraticCurves(VectorGraphicLayer) | Loops through all paths and replaces all circular arcs by approximating quadratic curves. |
| ReplaceCircularArcsByQuadraticCurves(VectorGraphicPath) | Loops through all commands of the given path and converts all circular arcs to quadratic curves. |
| ReplaceCommandsByPaths | Replaces all commands in the given layer whose indices are given in Dictionary pathDic by a path containing only that command. |
| ReplaceCubicCurvesByArcs(VectorGraphicLayer, Int32, Double) | Loops through all paths and replaces all cubic curves by arcs. |
| ReplaceCubicCurvesByArcs(VectorGraphicPath, Int32, Double) | Loops through all commands of the given path and converts all cubic curves to arcs. |
| ReplaceCubicCurvesByLines(VectorGraphicLayer) | Loops through all paths and replaces each curve by a single line. |
| ReplaceCubicCurvesByLines(VectorGraphicPath) | Loops through all commands of the given path and replaces each curve by a single line. |
| ReplaceCubicCurvesByPolylines(VectorGraphicLayer, Int32, Double) | Loops through all commands of the given layer and converts all cubic curves to polylines. |
| ReplaceCubicCurvesByPolylines(VectorGraphicPath, Int32, Double) | Loops through all commands of the given path and converts all cubic curves to polylines. |
| ReplaceCubicCurvesByQuadraticCurves(VectorGraphicLayer) | Loops through all paths and replaces each cubic curve by a quadratic curve. |
| ReplaceCubicCurvesByQuadraticCurves(VectorGraphicPath) | Loops through all commands of the given path and replaces each cubic curve by a quadratic curve. |
| ReplaceDrillByCircle | If the given path contains only a drill it is replaced by a circle with the given radius. |
| ReplaceDrillsByCircles | Loops through all paths and replaces all drills by circles with the given radius. |
| ReplaceEllipticalArcsByCircularArcs(VectorGraphicLayer) | Loops through all paths and replaces all elliptical arcs by circular arcs. |
| ReplaceEllipticalArcsByCircularArcs(VectorGraphicPath) | Loops through all commands of the given path and converts all elliptical arcs to circular arcs. |
| ReplaceEllipticalArcsByCubicCurves(VectorGraphicLayer) | Loops through all paths and replaces all elliptical arcs by approximating cubic curves. |
| ReplaceEllipticalArcsByCubicCurves(VectorGraphicPath) | Loops through all commands of the given path and converts all elliptical arcs to approximating cubic curves. |
| ReplaceEllipticalArcsByLines(VectorGraphicLayer) | Loops through all paths and replaces each arc by a single line. |
| ReplaceEllipticalArcsByLines(VectorGraphicPath) | Loops through all commands of the given path and replaces each arc by a single line. |
| ReplaceEllipticalArcsByPolylines(VectorGraphicLayer, Int32, Double) | Loops through all paths and replaces all elliptical arcs by approximating polylines. |
| ReplaceEllipticalArcsByPolylines(VectorGraphicPath, Int32, Double) | Loops through all commands of the given path and converts all elliptical arcs to polylines. |
| ReplaceEllipticalArcsByQuadraticCurves(VectorGraphicLayer) | Loops through all paths and replaces all elliptical arcs by approximating quadratic curves. |
| ReplaceEllipticalArcsByQuadraticCurves(VectorGraphicPath) | Loops through all commands of the given path and converts all elliptical arcs to quadratic curves. |
| ReplacePolylinesByArcs(VectorGraphicLayer) | Loops through all paths and replaces all polylines by approximating arcs. |
| ReplacePolylinesByArcs(VectorGraphicPath) | Loops through all commands of the given path and converts all polylines to arcs. |
| ReplacePolylinesByCubicCurves(VectorGraphicLayer) | Loops through all paths and replaces each polyline by a set of cubic curves. |
| ReplacePolylinesByCubicCurves(VectorGraphicPath) | Loops through all commands of the given path and converts each polyline into a set of cubic curves. |
| ReplacePolylinesByQuadraticCurves(VectorGraphicLayer) | Loops through all paths and replaces each polyline by a set of quadratic curves. |
| ReplacePolylinesByQuadraticCurves(VectorGraphicPath) | Loops through all commands of the given path and converts each polyline to a set of quadratic curves. |
| ReplacePolylineSectionsByArcs(VectorGraphicLayer, Double) | Loops through all paths and replaces all polyline sections by approximating arcs if possible. |
| ReplacePolylineSectionsByArcs(VectorGraphicPath, Double) | Loops through all commands of the given path and converts all fitting polyline sections into arcs. |
| ReplaceQuadraticCurvesByArcs(VectorGraphicLayer, Int32, Double) | Loops through all paths and replaces all quadratic curves by arcs. |
| ReplaceQuadraticCurvesByArcs(VectorGraphicPath, Int32, Double) | Loops through all commands of the given path and converts all quadratic curves to arcs. |
| ReplaceQuadraticCurvesByCubicCurves(VectorGraphicLayer) | Loops through all paths and replaces each quadratic curve by a cubic curve. |
| ReplaceQuadraticCurvesByCubicCurves(VectorGraphicPath) | Loops through all commands of the given path and and replaces each quadratic curve by a cubic curve. |
| ReplaceQuadraticCurvesByLines(VectorGraphicLayer) | Loops through all paths and replaces each curve by a single line. |
| ReplaceQuadraticCurvesByLines(VectorGraphicPath) | Loops through all commands of the given path and and replaces each curve by a single line. |
| ReplaceQuadraticCurvesByPolylines(VectorGraphicLayer, Int32, Double) | Loops through all commands of the given layer and converts all quadratic curves to polylines. |
| ReplaceQuadraticCurvesByPolylines(VectorGraphicPath, Int32, Double) | Loops through all commands of the given path and converts all quadratic curves to polylines. |
| ReplaceStraightCurvesByLines(VectorGraphicLayer, Double) | Checks if the control point(s) of a cubic or quadratic curve are laying on the line defined by the curve's start and end point. If yes, the curve is replaced by a line. |
| ReplaceStraightCurvesByLines(VectorGraphicPath, Double) | Loops through all commands in the given path, checks all QuadraticCurveToMetafileCommands and CubicCurveToMetafileCommands and replaces them by lines if all control points are laying on the line defined by the curve's start and end point. |
| Segment | |
| SegmentByTime | |
| SetZCoordsToZero(VectorGraphicLayer) | Loops through all paths and sets all z-coordinates to zero. |
| SetZCoordsToZero(VectorGraphicPath) | Loops through all commands of the given path and sets all z-coordinates to zero. |
| SortVectorsByDirection | |
| SortVectorsMinJump | Sorts all the vectors in the given layer to minimize jumps and jump distance. |
| SplitIntoTwo(VectorGraphicLayer) | Loops through all paths and splits all commands into two (Drill and SetPen commands are ignored). |
| SplitIntoTwo(VectorGraphicPath) | Loops through all commands of the given path and splits all commands into two; Drills and SetPen commands remain unchanged. |
| SplitPaths | Splits all paths given in the dictionary pathDic into two paths at the command index which is the value of each entry in pathDic. |
Remarks
For optimization there are three important tolerance values available
here as properties:
- LocationDistance: The locations of two points are considered as
equal if their distance is less than this value,
measured in micrometers.
- CollinearityDistance: A point is considered to be laying on the line
defined by two other points if its
perpendicular distance from the line is
less than this value, measured in micrometers.
- NumberOfPoints: When replacing a metafile command by a polyline the
resulting polyline will consist out of this number of
points; some commands will reduce this amount of
points in an additional step by removing all points
which are inert the CollinearityDistance.
Example:
Say, you want to remove duplicates in the polylines of
a path, and a point should be considered as the same as another point
if their distance is less than 300 micrometers. This can be done in
this way:
See a full example in the sample folder.
VectorGraphicPath path = GetYourPathFromSomewhere(); VectorGraphicOptimizer vgo = new VectorGraphicOptimizer(); vgo.LocationDistance = 300; vgo.RemoveDuplicates(path);
See Also