Introduction

The GenericHanger TSL is available starting from hsbDesign28 onward.
This guide explains how to use it within ACA, how it can be displayed in hsbMake Clients, and how it can be integrated with other TSLs to improve and streamline the user workflow.

Creating Hangers In ACA

This section describes how to use the GenericHanger TSL in sequential steps.

1. Applying GenericHanger TSL

This can be accessed through the Ribbon. Via the tab ‘hsbCassette’, within the section ‘Floor Tools’. The tool is called ‘Hangers’.

2. Dialogue Box Settings

Product

• ‍ Manufacturer
  User selects the manufacturer of the hanger they want to insert into the model.

• ‍Family
  ‍‍‍User selects the family of the hanger they want to insert into the model.

• ‍Product
  ‍‍‍User can select a specific hanger (based on Manufacturer and Family) they want to insert.
  They can also set it to 'Automatic', this allows an automatic selection of the hangers based on the entities selected by the user.

Tooling

• ‍Stretch Incoming Joists
  This determines if the ‘Male’ beams will be stretched or not.
  This only applied to Beam entities –Truss entities are not supported.

• ‍Gap
  This defines the gap between the connected beams, it will always be the ‘Male’ beam that will be shortened to create the gap.
  Not applicable to Truss entities.

• ‍Base Depth
  This defines the depth of material to be notched from the underside of the “male” beam.
  Once applied, the hanger will be positioned so that it aligns with the bottom of this notch.
  For example, if a value of 10 is entered, the result will appear as shown in the image.
• ‍‍‍Marking
  Marking is only applied on ‘female’ entities which are beams. This does not apply to truss entities.

• ‍Group Assignment
  This setting determines which group the hanger will be assigned to.
  If set to None, the hanger will not be associated with any group.
  
  If both entities already belong to the same group, selecting either Female Genbeam or Male Genbeam will ensure the hanger is added to that group.
  In cases where the two entities belong to different groups, choosing Female Genbeam or Male Genbeam allows the user to control which group the hanger will be assigned to.

Fixture

• ‍To be determined

Selection

• This allows the user to define the entity type for the female/male connection.
  If set to <by Selection>,the user does not need to specify it manually—the TSL will automatically detect and assign the appropriate type.
  
  However, if an entity type is specified, the user must ensure that the correct beam types are selected when choosing the elements for hanger placement.

Stiffener

• ‍To be determined

3. TSL Execution

The next steps in the workflow depend on the settings selected in Selection of the previous dialogue box.
If “by Selection” is chosen for both male and female entities, the user can bulk select beams or truss entities in the first selection step.
The second prompt (to select female entities) can be ignored in this case.
If a specific entity type (e.g. beam or truss) is defined for either the male or female, the user must ensure that the correct entity type is select accordingly.
If the selection does not match the defined types, the TSL will not execute.

4. Change Colour

To change the colour of the hanger, first select it, then right-click and choose Properties.

In the Properties panel that appears, locate the TrueColor field and select the desired colour.
After making your selection, the change may not display immediately. To apply it, right-click the hanger again and select Recalculate—the updated colour will then be visible.

Display Tags In ACA

Tag display depends on how tagging is configured in ACA.
Within this section, there will be two methods discussed that would enable tags to be generated for GenericHanger;
1.Tagging Within GenericHanger TSL
2.Tagging With hsbEntity Tag TSL

1. Tagging Within GenericHanger TSL

This method embeds the tags directly within the GenericHanger TSL.
These are the sequential steps involved to display the tags.

1. Select Hanger

Right select on the hanger created through the GenericHanger tsl and then go into ‘Custom’ and then ‘Settings’.
A dialogue box will then appear.

2. Dialogue Box Settings

Display

• ‍Colour
  Users can also use this property to change the colour of the hanger.

Tag

• ‍Style
  User can specify the type of tag to display. Currently there are 3 types; Text, Box and Triangle.
• ‍Format
  Users can define the information displayed on the tag by clicking the three dots, which opens the Format Editor dialog box.
  
  Within the Format field, begin typing @( to bring up a list of properties associated with the hanger.
  Selecting a property will display its corresponding value in the Result field, allowing users to preview the information that will appear on the tag.

Tag Display

• ‍Colour
  By selecting the Allow users to control the transparency of the tag.
• Transparency
  Allow users to control the transparency of the tag.
• ‍Dimstyle
  Allows users to choose the style of the tag they want to display.
• ‍Text Height
  Allows users to control the size of the tag.

Tagging With hsbEntity Tag

The steps below outline the process for using the hsbEntity Tag TSL.
This can be used alongside GenericHanger, which is particularly useful when multiple tags are required for a single hanger.

1. Opening hsbEntity tag tsl

This process is the same as it is described here.

2. Dialogue Box Settings

General

• Format
  Users can define the information displayed on the tag by clicking the three dots, which opens the Format Editor dialog box.
  
  Within the Format field, begin typing @( to bring up a list of properties associated with the hanger.
  Selecting a property will display its corresponding value in the Result field, allowing users to preview the information that will appear on the tag.

References

• ‍Filter
  Not sure
• ‍Group Assignment
  Not sure
• ‍Equal Parts Format
  Not sure

Alignment

• ‍Direction
  This allows users to set the direction of the tag display
• ‍Alignment
  This describes where the user would like to have grip point for the tag

Display

• ‍Style
  User can specify the type of tag to display. Currently there are 3 types; Text, Box and Triangle.
• ‍Dimstyle
  Allows users to choose the style of the tag they want to display.
• ‍Text Height
  Allows users to control the size of the tag.
  ‍Colour
  By selecting the Allow users to control the transparency of the tag.
• Fill Transparency
  Allow users to control the transparency of the tag.
• ‍Leader Line type
  Users have the ability to define the line type they would like for the leader of the tag.
• ‍Leader Style
  Users have the ability to set the style of the leader

3. Selecting hangers

After the settings have been confirmed – it will prompt the user to select a hanger where it will require the tag. The tag will then appear.

Display Generic Hanger and hsbEntity Tag In hsbMake Client

Depending on how tags are displayed in ACA, the settings selected in the client would differ slightly depending on the display method in ACA.
Both ways will be outlined here.

Display GenericHanger TSL

The steps above outline how to ensure that GenericHanger is displayed within hsbMake Client. If a tag has been assigned in ACA through the same tsl, it should also appear alongside it.

1. Go into settings within the client application

2. The on the left hand side, select ‘Tsl Instances’

3. Then create a new property, assigning the relevant name

4. Navigate into the ‘Criteria’ tab and write the name of the TSL. In this context, it should be ‘GenericHanger’.

5. Once the settings are confirmed, the hanger should appear, and if a tag was set, this should also appear.

Display hsbEntity Tag

This section describes how to enable the tsl to be displayed in hsbMake clients. It will be a similar process to displaying GenericHanger.
The following fields would need to be copied and filled.

After it is confirmed, the tag will appear, as shown below.

Other Intressesting documents

TSL | hsb_Hanger

‍