Model.CE_ConnectorLineCreate#

Model.CE_ConnectorLineCreate(collection, density, spacing, half_spacing_offset, offset)#

Creates connector(s) on the lines at the given density or spacing.

Parameters:

  • collection (Collection) – The collection containing the line entities that specify the connector location.

  • density (unsigned int) –

    Integer number to split line into number of points. Spacing between points.

    = line_length/density

  • spacing (double) –

    Float number to split line into number of points with specified distance between points.

    = spacing

  • half_spacing_offset (unsigned int) –

    Create points from an offset (= spacing/2) from the start and end of line.

    0 - Follows the spacing provided by offset parameter

    1 - Follows the spacing in parameter description (half_spacing_offset)

  • offset (double) – Create points from an offset (= offset) from the start and end of line.

Example#

Create a connector on line number with ID 10 with a spacing of 2.0 and half_spacing_offset#
import hm
import hm.entities as ent

model = hm.Model()

model.CE_ConnectorLineCreate(
    collection=hm.Collection(model, ent.Line, [10]),
    density=0,
    spacing=2.0,
    half_spacing_offset=1,
    offset=0,
)

Note

Only one connector is created for each line at the center of the line and it is displayed as a cylinder.