Use of Dimension Options

Use of Dimension Options
  1# this script demonstrates the use of the new DimensionOptions, DimensionDistanceFormat and DimensionAngleFormat objects
  2# along with their use in the new dimensioning methods
  3
  4if impact.active_drawing.isNone():
  5    impact.gui.output_toolbox.add("Unable to continue: no active drawing")
  6else:
  7
  8    # Create the DimensionOptions
  9    DimensionOptions = impact.creator.dimension_options()
 10
 11    # We can also create our own formats for display distances and angles
 12    PrimaryDistanceFormat = DimensionOptions.create_dimension_distance_format()
 13    PrimaryAngleFormat = DimensionOptions.create_dimension_angle_format()
 14
 15    # We can then set their values manually
 16    PrimaryDistanceFormat.units = ipDistanceFormat.dfMillimetres
 17    PrimaryDistanceFormat.suffix = "mm"
 18    PrimaryDistanceFormat.decimal_places = 2
 19    PrimaryDistanceFormat.remove_trailing_zeros = True
 20    PrimaryDistanceFormat.display_fractions = False
 21    PrimaryDistanceFormat.reduce_denominator = False
 22    PrimaryDistanceFormat.denominator = 64
 23
 24    PrimaryAngleFormat.units = ipAngleFormat.afDegrees
 25    PrimaryAngleFormat.suffix = "deg"
 26    PrimaryAngleFormat.decimal_places = 1
 27    PrimaryAngleFormat.remove_trailing_zeros = True
 28    PrimaryAngleFormat.display_fractions = False
 29    PrimaryAngleFormat.reduce_denominator = False
 30    PrimaryAngleFormat.denominator = 64
 31
 32    # Then set the formats in the DimensionOptions
 33    DimensionOptions.primary_distance_format = PrimaryDistanceFormat
 34    DimensionOptions.primary_angle_format = PrimaryAngleFormat
 35
 36    # Get a text style
 37    text_style_sheet_name = "Palette Default"
 38    text_style_sheet = impact.active_drawing.text_style_sheets.item(text_style_sheet_name)
 39
 40    DimensionOptions.text_style = text_style_sheet.text_style
 41
 42    # Setup the rest of DimensionOptions
 43    DimensionOptions.add_lines = True
 44    DimensionOptions.terminator_style = ipTerminatorStyle.tsClosedFilledArrow
 45    DimensionOptions.terminator_size = 2.0
 46    DimensionOptions.leader_length = 2.0
 47    DimensionOptions.show_radial_lines = True
 48    DimensionOptions.parallel_offset = 10.0
 49    DimensionOptions.dimension_gap = 10.0
 50    DimensionOptions.projection_ascent = 10.0
 51    DimensionOptions.force_palette_colour = False
 52    DimensionOptions.format_specifier = "%1 (%2)"
 53    DimensionOptions.dim_text_parallel = False
 54    DimensionOptions.text_position = ipDimensionTextPosition.dtAboveLine
 55    DimensionOptions.radius_prefix = "Radius"
 56    DimensionOptions.diameter_prefix = "Diameter"
 57    DimensionOptions.display_tolerances = True
 58    DimensionOptions.display_tolerances_plus_minus = True
 59    DimensionOptions.tolerance_upper_limit = 2.0
 60    DimensionOptions.tolerance_lower_limit = 2.0
 61    DimensionOptions.auto_size = False
 62
 63    # Instead of that you can apply a master tool setting instead
 64    db = impact.active_database
 65    ms = db.find_master_tool_setting("Standard Dimensions", ipMasterSettingType.mstDimension)
 66    if ms is not None:
 67        impact.gui.output_toolbox.add("Applying MTS")
 68        DimensionOptions.apply_master_setting(ms)
 69
 70    # DimensionHorizontal2 as an example
 71    # The new dimensioning methods take the same arguments as the old ones
 72    # plus the addition of the new DimensionOptions object
 73
 74    # create a local variable for the active block
 75    ab = impact.active_drawing.active_layer.active_block
 76
 77    # create an array of points to dimension
 78    Points = [None] * 4
 79
 80    Points[0] = impact.creator.vector(0,0)
 81    Points[1] = impact.creator.vector(21,0)
 82    Points[2] = impact.creator.vector(40,0)
 83    Points[3] = impact.creator.vector(60,0)
 84
 85    # create some local variables to store the dimensions returned,
 86    # projection length, projection side, etc.
 87    Dimensions = None
 88    ProjectionLength = 10
 89    ProjectionSide = ipProjectionSide.psLeft
 90    DimensionMode = ipDimensionMode.dmSingle
 91
 92    # create the horizontal dimensions
 93    Dimensions = ab.dimension_horizontal2(Points, ProjectionLength, ProjectionSide, DimensionMode, DimensionOptions)
 94
 95    # Wrap variant return items with Impact.py wrapper
 96    if Dimensions is not None:
 97        Dimensions = [ILinearDimension(item) for item in Dimensions]
 98
 99    # check that some dimensions were returned
100    if Dimensions:
101        for dim_ent in Dimensions:
102            impact.gui.output_toolbox.add("Dimension value is " + str(dim_ent.expression_value))
103
104