SVG_New_polyline_by_arrays

4D - Documentation   Français   English   German   4D SVG Component, Command Theme List   4D SVG Component, Index   Back   Previous   Next

version 11.3


SVG_New_polyline_by_arrays (parentSVGObject; xArrayPointer; yArrayPointer{; foregroundColor{; backgroundColor{; strokeWidth}}}) SVG_Ref

ParameterTypeDescription
parentSVGObjectSVG_RefReference of parent element
xArrayPointerPointerCoordinates on X axis of points
yArrayPointerPointerCoordinates on Y axis of points
foregroundColorStringColor or gradient name
backgroundColorStringColor or gradient name
strokeWidthLongintLine thickness
Function resultSVG_RefReference of line

Description

The SVG_New_polyline_by_arrays command draws a broken line composed of straight segments connected together in the SVG container designated by parentSVGObject and returns its reference. If parentSVGObject is not an SVG document, an error is generated.

Usually, 'polyline' elements design open forms but they can be used for closed forms as well. In this case the last point must be set as equal to the first.

All the coordinate values are in the user coordinate system.

The optional foregroundColor and backgroundColor parameters contain, respectively, the name of the line color and of the background color. (For more information about colors, please refer to the commands of the Colors and Gradients theme).

The optional strokeWidth parameter contains the size of the pen expressed in pixels. Its default value is 1.

Examples

1. Draw a triangle (default border color and line thickness):

   ARRAY LONGINT($tX;0)
   ARRAY LONGINT($tY;0)

   APPEND TO ARRAY($tX;10)
   APPEND TO ARRAY($tY;10)
   APPEND TO ARRAY($tX;200)
   APPEND TO ARRAY($tY;100)
   APPEND TO ARRAY($tX;10)
   APPEND TO ARRAY($tY;100)
   APPEND TO ARRAY($tX;10)
   APPEND TO ARRAY($tY;10)

   svgRef:= SVG_New 
   objectRef:=SVG_New_polyline_by_arrays (svgRef;->$tX;->$tY)

2. Draw a line diagram:

   ARRAY LONGINT($tX;0)
   ARRAY LONGINT($tY;0)
      `X axis
   For ($Lon_i;0;200;20)
      APPEND TO ARRAY($tX;$Lon_i)
   End for
      `Values
   APPEND TO ARRAY($tY;100)
   APPEND TO ARRAY($tY;100)
   APPEND TO ARRAY($tY;30)
   APPEND TO ARRAY($tY;30)
   APPEND TO ARRAY($tY;80)
   APPEND TO ARRAY($tY;60)
   APPEND TO ARRAY($tY;10)
   APPEND TO ARRAY($tY;40)
   APPEND TO ARRAY($tY;50)
   APPEND TO ARRAY($tY;70)

   objectRef:= SVG_New_polyline_by_arrays (svgRef;->$tX;->$tY;"crimson";"none";5)

See Also

SVG_New_polyline.


4D - Documentation   Français   English   German   4D SVG Component, Command Theme List   4D SVG Component, Index   Back   Previous   Next