Overview
This page documents the Common Truss attribute libraries returned and consumed by the Medeek Truss API attribute read/set methods.
The parameters are organized by library and listed in the same order as the internal common truss attribute dictionaries so it is easier to understand where each value belongs.
Each parameter name is shown exactly as it appears in the attribute library. Descriptions can be expanded over time as additional API notes and implementation details are documented.
Basic Attributes
These parameters define the common truss family, origin points, truss identity, geometry, member sizes, heel options, spacing controls, and connection-related data.
| Parameter | Description |
|---|---|
| TRUSSFAMILY | Defines the overall truss family classification for the assembly. For this API page it identifies the common truss family. |
| MAINORIGIN | Stores the main origin point for the truss assembly group. This is typically used as a geometric reference for positioning, transformations, and regeneration logic. |
| INITORIGIN | Stores the original insertion or initialization point used when the truss assembly was first created. |
| TRUSS_NAME | User-defined truss name or label for identification within the model and API workflows. |
| TRUSSTYPE | Defines the common truss web configuration or truss type, such as Fink, Howe, Fan, or other supported common truss types. |
| SPAN | Overall horizontal span of the truss assembly measured between bearing locations. |
| PITCH | Primary roof pitch of the common truss expressed as rise over 12 inches of run. |
| OVERHANGL | Left-side eave overhang dimension for the common truss assembly. |
| OVERHANGR | Right-side eave overhang dimension for the common truss assembly. |
| TCD | Top chord depth or top chord member size value for the truss assembly. |
| BCD | Bottom chord depth or bottom chord member size value for the truss assembly. |
| WEBD | Web member depth or web member size value for the truss assembly. |
| PLY | Defines the truss ply count or number of plies used for the assembly. |
| RAISEDHEEL | Enables or defines whether the common truss uses a raised heel configuration. |
| USRHH | User-specified raised heel height value when a custom raised heel option is active. |
| BUILDINGLENGTH | Overall building length associated with the truss layout or truss assembly context. |
| TRUSS_SPACING | Spacing value used for truss layout along the building length. |
| GABLETRUSSINPUT | Defines whether or how gable truss input is enabled within the truss assembly or truss set workflow. |
| VERTSPACING | Vertical spacing value used by the common truss web layout logic. |
| ADVROOFOPTIONS | Enables or defines whether advanced roof and accessory options are active for the truss assembly. |
| CONNECTLIST | Collection/list of connection or linked assembly data associated with the truss assembly. |
Advanced Attributes
These parameters define sheathing, gable wall, fascia, rake, outlooker, heel block, cladding, ridge, soffit cut, return, batten, gypsum, gutter, insulation, material, offset, and truss modification options.
| Parameter | Description |
|---|---|
| SHEATHING_OPTION | Enables or defines the roof sheathing option for the truss assembly. |
| SHEATHING_THICKNESS | Thickness of the roof sheathing material. |
| GABLEWALL_OPTION | Enables or defines the gable wall option associated with the truss assembly. |
| FASCIA_OPTION | Enables or defines whether fascia components are active. |
| FASCIA_TYPE | Defines the fascia type or fascia configuration used by the assembly. |
| FASCIA_WIDTH | Width of the fascia component. |
| FASCIA_DEPTH | Depth of the fascia component. |
| RAKEBOARD_OPTION | Enables or defines whether rake boards are active. |
| OVERHANG_GABLE | Gable-end overhang dimension associated with the truss assembly. |
| RAKE_WIDTH | Width of the rake board or rake trim component. |
| RAKE_DEPTH | Depth of the rake board or rake trim component. |
| OUTLOOKER_OPTION | Enables or defines whether outlooker framing is active. |
| OUTLOOKER_SPACING | Spacing value for outlooker framing members. |
| OUTLOOKER_SIZE | Member size designation used for outlooker framing. |
| OUTLOOKER_ST | Outlooker setback or start location value used by the outlooker layout logic. |
| OUTLOOKER_ORIENT | Orientation setting used for outlooker framing members. |
| OUTLOOKER_PEAK | Defines whether an outlooker is placed or extended to the peak condition. |
| HEELBLOCK_OPTION | Enables or defines whether heel blocks are active for the truss assembly. |
| HEELBLOCK_ORIENT | Orientation setting used for heel block placement. |
| ROOFCLADDING_OPTION | Enables or defines the roof cladding option for the assembly. |
| ROOFCLADEXT | Extension value associated with the roof cladding geometry. |
| RIDGECAP_OPTION | Enables or defines whether a ridge cap option is active. |
| WALLCLADDING_OPTION | Enables or defines the wall cladding option associated with the gable wall or related assembly elements. |
| SOFFITCUT | Defines the soffit cut condition or soffit cut style used by the truss assembly. |
| ROOFRETURN | Enables or defines whether roof return geometry/options are active. |
| ROOFBATTEN | Enables or defines whether roof battens are active. |
| GYPSUM_OPTION | Enables or defines whether gypsum ceiling options are active. |
| GUTTER_OPTION | Enables or defines whether gutter options are active. |
| INSUL_OPTION | Enables or defines whether insulation options are active. |
| WALLSHEATHMAT | Material assigned to the wall sheathing component associated with the truss assembly. |
| WALLCLADMAT | Material assigned to the wall cladding component. |
| ROOFSHEATHMAT | Material assigned to the roof sheathing component. |
| ROOFCLADMAT | Material assigned to the roof cladding component. |
| WALLSHEATHTHK | Thickness of the wall sheathing material. |
| WALLCLADTHK | Thickness of the wall cladding material. |
| ROOFCLADTHK | Thickness of the roof cladding material. |
| WALLSHEATHVERTOFFSET_T | Top vertical offset applied to the wall sheathing component. |
| WALLSHEATHVERTOFFSET_B | Bottom vertical offset applied to the wall sheathing component. |
| WALLCLADVERTOFFSET_T | Top vertical offset applied to the wall cladding component. |
| WALLCLADVERTOFFSET_B | Bottom vertical offset applied to the wall cladding component. |
| WALLCLADGAP | Gap value used within the wall cladding layout or installation geometry. |
| CLADMATOFFSET | Primary material offset used by cladding-related geometry. |
| CLADMATHOFFSET | Horizontal material offset used by cladding-related geometry. |
| CLAD2MATHOFFSET | Secondary horizontal material offset used by cladding-related geometry. |
| VALLEYSET_CHECK | Stores whether a valley set condition/check is active for the truss assembly. |
| REMOVETRUSSLIST | Collection/list of trusses removed or omitted from a generated truss set or layout. |
| OVERHANGB_GABLE | Bottom or secondary gable overhang value used by the gable-end geometry logic. |
| HEELBLOCK_HOLES | Enables or defines whether heel block holes are active. |
| HEELBLOCK_HOLES_DIA | Diameter of holes placed in heel blocks when that option is enabled. |
Roof Return Options
These parameters define the roof return type, return pitch, extension, and return length values.
| Parameter | Description |
|---|---|
| RETURNTYPE | Defines the roof return type or return configuration used at the gable end. |
| PITCH3 | Pitch value associated with the roof return geometry. |
| RETURNEXT | Extension value used by the roof return geometry. |
| RETURNLENGTH | Length of the roof return assembly or return feature. |
Batten Options
These parameters define batten type, size, spacing, offsets, peak controls, and counter batten options.
| Parameter | Description |
|---|---|
| BATTENTYPE | Defines the batten type or batten configuration used by the roof assembly. |
| BATTENHEIGHT | Height of the roof batten member. |
| BATTENWIDTH | Width of the roof batten member. |
| BATTENSPACING | Spacing of roof battens along the roof slope. |
| BATTENOFFSET | General offset value applied to the batten layout. |
| BATTENPEAK | Defines whether a special batten condition is used at the roof peak. |
| BATTENOFFSETPEAK | Offset value specifically applied at the roof peak batten condition. |
| PEAKTOEAVE | Defines whether battens are laid out continuously from peak to eave. |
| CBOPTION | Enables or defines whether counter battens are active. |
| CBHEIGHT | Height of the counter batten member. |
| CBWIDTH | Width of the counter batten member. |
Gypsum Options
These parameters define gypsum board thickness, inset, and optional ceiling batten values.
| Parameter | Description |
|---|---|
| GYPSUM_THICKNESS | Thickness of the gypsum board or ceiling gypsum layer. |
| GYPSUMINSET | Inset value applied to the gypsum board geometry. |
| CLGBOPTION | Enables or defines whether ceiling battens associated with the gypsum option are active. |
| CLGBATTENHEIGHT | Height of the gypsum/ceiling batten member. |
| CLGBATTENWIDTH | Width of the gypsum/ceiling batten member. |
| CLGBATTENSPACING | Spacing of gypsum/ceiling battens. |
Gutter Options
These parameters define gutter type, offsets, extension, downspout options, and wrap behavior.
| Parameter | Description |
|---|---|
| GUTTERTYPE | Defines the gutter type or gutter profile used by the assembly. |
| GUTTERVOFFSET | Vertical offset applied to the gutter placement. |
| GUTTEREXT | Extension value used by the gutter geometry. |
| DOWNSPOUTOPTION | Enables or defines whether downspout geometry/options are active. |
| DSPLENGTH | Length of the downspout component. |
| DSPTYPE | Defines the downspout type or profile. |
| GUTTERWRAPOPTION | Enables or defines whether a gutter wrap option is active. |
Soffit / Fascia Options
These parameters define fascia/furring options, fascia material, soffit behavior, soffit geometry, and soffit material.
| Parameter | Description |
|---|---|
| FF_OPTION | Enables or defines the fascia/furring option associated with this library group. |
| FF_THK | Thickness value used by the fascia/furring component. |
| FF_DEPTH | Depth value used by the fascia/furring component. |
| FASCIAMAT | Material assigned to the fascia component. |
| SOFFIT_OPTION | Enables or defines whether soffit geometry/options are active. |
| SOFFIT_TYPE | Defines the soffit type or soffit configuration. |
| SOFFIT_THK | Thickness of the soffit material or soffit panel. |
| SOFFIT_OFFSET | Offset value applied to the soffit geometry. |
| SOFFIT_EXT | Extension value associated with the soffit geometry. |
| SOFFITMAT | Material assigned to the soffit component. |
Insulation Options
These parameters define ceiling insulation behavior, insulation material, and insulation depth values.
| Parameter | Description |
|---|---|
| INSUL_CEILING | Defines the ceiling insulation option or ceiling insulation behavior for the truss assembly. |
| INSUL_MAT | Material assigned to the insulation component. |
| INSUL_DEPTH | Depth or thickness of the insulation layer. |