Model.CE_EditSeamAndLineDetail#

Model.CE_EditSeamAndLineDetail(ce_collection, density=0, spacing=0.0, half_spacing_offset=0, offset=0.0, param1=0, param2=0.0, vertex_angle=0.0)#

Edit density, spacing and offset details for seam or line spot connectors specified by collection.

Parameters:
  • ce_collection (Collection) – The collection containing the connector entities to be updated.

  • 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.

  • 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 from the start and end of line.

  • param1 (unsigned int) – Reserved for future use. It must be 0.

  • param2 (double) – Reserved for future use. It must be 0.0.

  • vertex_angle (double) – Reserved for future development.

Note

Instead of this function the Model.CE_DetailSetInt() and Model.CE_DetailSetDouble() are recommended for the purpose of setting details for a seam connector.

Example#

Set density=10 and offset=1.5 for line connectors with IDs 1, 2 and 3#
import hm
import hm.entities as ent

model = hm.Model()

connector_collection = hm.Collection(model, ent.Connector, [1, 2, 3])
model.CE_EditSeamAndLineDetail(
    ce_collection=connector_collection, density=10, offset=1.5
)

Note

The specified details are modified, only if the previous values were not the same. The modified connectors are unrealized since editing details affects realization.