Hide Table of Contents
GetPolylines6 Method (IView)

Obsolete. Superseded by IView::GetPolylines7.

.NET Syntax

Visual Basic (Declaration) 
Function GetPolylines6( _
   ByVal CrossHatchOption As Short, _
   ByRef Polylines As Object _
) As Object
Visual Basic (Usage) 
Dim instance As IView
Dim CrossHatchOption As Short
Dim Polylines As Object
Dim value As Object
 
value = instance.GetPolylines6(CrossHatchOption, Polylines)
C# 
object GetPolylines6( 
   short CrossHatchOption,
   out object Polylines
)
C++/CLI 
Object^ GetPolylines6( 
&   short CrossHatchOption,
&   [Out] Object^ Polylines
) 

Parameters

CrossHatchOption
  • 0 = include crosshatch lines
  • 1 = exclude crosshatch lines
  • 2 = include only crosshatch lines
Polylines
Array of doubles representing the lines in the view (see Remarks)

Return Value

Array of modeling edges corresponding to the polylines in the view

Remarks

The difference between this method and IView::GetPolyLinesAndCurves and IView::IGetPolyLinesAndCurves is that splines and ellipses returned by these methods are returned as equation parameters, which are more precise definitions.

This method returns data for all visible solid model edges in the drawing view. This includes these types of edges:

  • arcs: Returned using a center point, radius, and start and stop location.

  • circles: Returned using a center point, radius, and start and stop location.

  • ellipses: Returned as tessellated polylines.

  • splines: Returned as tessellated polylines.

  • straight lines: Returned as tessellated polylines, but because the edges are straight, there is no loss of data in the approximation.

NOTE: If the view contains silhouette edges, then the polylines that render them cannot correspond to an edge because an edge does not actually exist. For example, if the third and fourth polyline in the set of polylines returned describe a silhouette edge, then array positions 4 and 5 in the edge array will be null.

This method also lets you include or exclude crosshatch lines. This method does not return data for sketch segments added by a user in the drawing view.

To get...

Call...

Size of array needed to hold this data

IView::GetPolylineCount5

Items that were sketched in this drawing view

IView::GetArcs4 and IView::IGetArcs4

IView::GetLines4 and IView::IGetLines4

IView::GetSplines3 and IView::IGetSplines3

IView::GetEllipses5 and IView::IGetEllipses5

Format of the return value is the following array of doubles:

[ Type, GeomDataSize, GeomData[ ], LineColor, LineStyle, LineFont, LineWeight, LayerID, LayerOverride, NumPolyPoints, [x,y,z] ]

where:

Type = underlying geometry type, possible values are:

        • 0 Polyline type

        • 1 Arc or Circle type

GeomDataSize = number of elements in the GeomData array, for Type = 0 this will be 0.

GeomData[ ] = geometric data that can be used to represent the underlying geometry type. The data returned in this array is based on the underlying geometry type:

        • Type = 0. This array is empty

        • Type = 1. [ centerPtX, centerPtY, centerPtZ, startPtX, startPtY, startPtZ, endPtX, endPtY, endPtZ, normalX, normalY, normalZ ]

LineColor = polyline color. This value is determined either by the explicitly set value or by the layer that the polyline is on.

LineStyle = value combines polyline font and weight information. This value can be used as an input to GetLineFontInfo and GetLineFontName. If this value is -1, then the user has probably modified the line display manually in the drawing and you should use the LineFont and LineWeight return values to recreate the exact polyline style.

LineFont = value is used for polyline font information. This value can be used as an input to the GetLineFontInfo2 and GetLineFontName2 functions. This value will only be valid if LineStyle is -1.

LineWeight = polyline weight where Thin = 0.0, Normal = 1.0, Thick = 2.0. This value will only be valid if LineStyle is -1.

LayerID = integer value indicating which layer holds this polyline. The ILayer object can be obtained by passing this integer value to ILayerMgr::GetLayerById and ILayerMgr::IGetLayerById.

LayerOverride = integer with bit flags set to determine which properties, if any, have been overridden with respect to the Layer default properties. If the bit value is set, then the specific property or properties have been overridden. The bit indicators are: color = 0x1, style = 0x2, and width = 0x4. Therefore, if LayerOverride was returned as 3, you know the color and style have been specifically set for this item and may not match the default values associated with this item's layer.

NumPolyPoints = number of XYZ points found in the [x,y,z] return value

[x,y,z] = array of points used to describe the polyline. This array has NumPolyPoints points. This data will be returned for every polyline regardless of Type.

If...

Then...

Display mode of the view is:

  • Shaded

  • Shaded with Edges

  • Draft Quality

  • Fast HLR/HLV

A value is not returned.

Use IView::SetDisplayMode3 to change Shaded or Shaded with Edges mode to Wireframe, Hidden Lines Removed (HLR), or Hidden Lines Visible (HLV), and then get the polylines.  

Changes are made to the parts or assemblies shown in this drawing

Polylines are only generated that are in the visible viewing bounds when the drawing is opened.

Drawing is already open

All polylines in the drawing are generated. If you open a drawing that is zoomed in to a particular region, then the polylines that are outside the zoomed region do not exist if the parts or assemblies shown in this drawing have been changed. To force the generation of all possible polyline data, call IModelDoc2::ViewZoomtofit2.

 

See Also

Availability

SolidWorks 2007 FCS, Revision Number 15.0


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   GetPolylines6 Method (IView)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:



x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2010 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.