VS:GetClosestSide: Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
(add note about polylines fails) |
||
Line 48: | Line 48: | ||
----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ||
<remark> | <remark> | ||
[[User: | |||
[[User:CBM-c-| _c_]], 2021.12.28: If applied to polylines, the routine is unreliable for poly segments whose type is NOT corner: it fails. So basically this works well only on polygons | |||
[[User:CBM-c-| _c_]], 2011.12.31: If applied to polygons, the routine needs the passed point to be ON a side. It will return different values depending if | |||
* the chosen point is ON the side: always returns the vertexes defining the found side | * the chosen point is ON the side: always returns the vertexes defining the found side | ||
* the chosen point is NOT ON the side: | * the chosen point is NOT ON the side: |
Latest revision as of 04:33, 28 December 2021
.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix
Description
Returns the indices of the vertices that define the side closest to the specified location.
GetClosestSide supports only 2D objects. If the object is unsupported, -1 will be returned as the index values.
PROCEDURE GetClosestSide(
obj :HANDLE;
ptX,ptY :REAL;
VAR index1 :INTEGER;
VAR index2 :INTEGER);
def vs.GetClosestSide(obj, pt): return (index1, index2)
Parameters
obj HANDLE Handle to object. pt REAL Coordinates of location. index1 INTEGER Index of first vertex of closest side. index2 INTEGER Index of second vertex of closest side.
Remarks
_c_, 2021.12.28: If applied to polylines, the routine is unreliable for poly segments whose type is NOT corner: it fails. So basically this works well only on polygons
_c_, 2011.12.31: If applied to polygons, the routine needs the passed point to be ON a side. It will return different values depending if
- the chosen point is ON the side: always returns the vertexes defining the found side
- the chosen point is NOT ON the side:
- polygons: returns the range of vertexes --> 1-(count of vertexes)
- polylines: returns the range of vertexes --> (count of vertexes) -(count of vertexes)
Version
Availability: from VectorWorks 8.5