Model.CE_SetSpecificDetail

Model.CE_SetSpecificDetail(ce_collection, detail_type, int_val, dbl_val)

Sets a specific detail for all the connectors on the mark.

Parameters:

• ce_collection (Collection) – The collection containing the connector entities.

• detail_type (int) –

  The number for the connector detail you are editing:

  Generic Connector Details:

  1 = thickness (integer)

  2 = user control (integer: 0 or 1)

  3 = state (integer: 0 = unrealized, 1 = realized, 2 = failed, 3 = modified, 4 = unconfirmed)

  Connector Line Details:

  101 = spacing (double)

  102 = density (integer)

  103 = offset (double)

  104 = half spacing (integer: 0 or 1)

• int_val (int) – Pass necessary integers values through this parameter.

• dbl_val (double) – Pass necessary double values through this parameter.

Examples

Change the thickness of the connectors on collection from 2T to 3T

import hm
import hm.entities as ent

model = hm.Model()

connectors  = hm.CollectionByDisplayed(model, ent.Connector)

model.CE_SetSpecificDetail(
    ce_collection=connectors, detail_type=1, int_val=3, dbl_val=0.0
)

Change the spacing for a connector with IDs 10 and 11 created at a line to 5.0

import hm
import hm.entities as ent

model = hm.Model()

connectors  = hm.Collection(model, ent.Connector, [10, 11])

model.CE_SetSpecificDetail(
    ce_collection=connectors, detail_type=101, int_val=0, dbl_val=5.0
)

Note

A connector must be in user control mode in order to edit the state.

Note

If the connector is in the unrealized state it can only be set to the failed state.

Note

If the connector is in the realized, modified, failed or unconfirmed state it cannot be set to the unrealized state.