Class Ifc4x2::IfcFillAreaStyleHatching

Nested Relationships

This class is a nested type of Struct Ifc4x2.

Inheritance Relationships

Base Type

Class Documentation

class Ifc4x2::IfcFillAreaStyleHatching : public Ifc4x2::IfcGeometricRepresentationItem

Definition from ISO/CD 10303-46:1992: The fill area style hatching defines a styled pattern of curves for hatching an annotation fill area or a surface.

The IfcFillAreaStyleHatching is used to define simple, vector-based hatching patterns, based on styled straight lines. The curve font, color and thickness is given by the HatchLineAppearance, the angle by the HatchLineAngle and the distance to the next hatch line by StartOfNextHatchLine, being either an offset distance or a vector.

NOTE If the hatch pattern involves two (potentially crossing) rows of hatch lines, then two instances of IfcFillAreaStyleHatching should be assigned to the IfcFillAreaStyle. Both share the same (virtual) point of origin of the hatching that is used by the reference hatch line (or the PointOfReferenceHatchLine if there is an offset).

For better control of the hatching appearance, when using hatch lines with other fonts then continuous, the PatternStart allows to offset the start of the curve font pattern along the reference hatch line (if not given, the PatternStart is at zero distance from the virtual point of origin). If the reference hatch line does not go through the origin (of the virtual hatching coordinate system), it can be offset by using thePatternStartPointOfReferenceHatchLine.

NOTE The coordinates of the PatternStart and the PointOfReferenceHatchLine are given relative to the assumed 0., 0. virtual point of origin at which the hatch pattern is later positioned by the FillStyleTarget point at IfcAnnotationFillAreaOccurrence. The measure values are given in global drawing length units and apply to the target plot scale for the scale depended representation subcontext.

NOTE The use of PointOfReferenceHatchLine is deprecated.

Figure 292 illustrates hatch attributes.

Example 1 This example shows simple hatching given by using a curve font “continuous” at HatchLineAppearance.

The distance of hatch lines is given by a positive length measure. The angle (here 45’ if measures in degree) is provided by HatchLineAngle.

The PatternStart is set to NIL ($) in this example. Example 2 This shows hatching from example 1 with using a different curve font at HatchLineAppearance. The distance of hatch lines is given by a positive length measure, therefore the font pattern start is at a point at the next hatch line given by a vector being perpendicular to the point of origin at the reference hatch line. The PatternStart is set to NIL ($) in this example. Example 3 This example uses hatching from example 2 with a vector to determine the pattern start of the next hatch lines. The pattern start is the beginning of the first visual curve font pattern segment at IfcCurveFont.CurveFont. The PatternStart is set to NIL ($) in this example. Example 4 This example uses hatching from example 3 where the pattern start is offset from the point of origin at the reference hatch line. That is, the first visible curve font pattern segment now does not start at the point of origin at the reference hatch line.

Example 5 This example uses hatching from example 4 where the hatch pattern is shifted against the underlying coordinate system. The point that is mapped to the insertion point of the IfcAnnotationFillAreaOccurrence now has an X and Y offset from the start of the reference hatch line. That is, the reference hatch line now does not go through the insertion point of the hatching.

Example 6 This example shows use of

IfcFillAreaStyleHatching attributes for two IfcFillAreaStyleHatching’s within one IfcFillAreaStyle. Note that the PatternStart now displaces both the reference hatch line from the point of origin and the start of the curve pattern. This can be used in cases when more than one IfcFillAreaStyleHatching is used in an IfcFillAreaStyle in order to place rows of hatch lines with an offset from each other.

Figure 292 — Fill area style hatching

NOTE Corresponding ISO 10303 name: fill_area_style_hatching. Please refer to ISO/IS 10303-46:1994, p. 108 for the final definition of the formal standard.

HISTORY New entity in IFC2x2.

IFC2x3 CHANGE The IfcFillAreaStyleHatching has been changed by making the attributes PatternStart and PointOfReferenceHatchLine OPTIONAL. The attribute StartOfNextHatchLine has changed to a SELECT with the additional choice of IfcPositiveLengthMeasure. Upward compatibility for file based exchange is guaranteed.

Public Types

typedef IfcTemplatedEntityList<IfcFillAreaStyleHatching> list

Public Functions

::Ifc4x2::IfcCurveStyle *HatchLineAppearance() const

The curve style of the hatching lines. Any curve style pattern shall start at the origin of each hatch line.

void setHatchLineAppearance(::Ifc4x2::IfcCurveStyle *v)
::Ifc4x2::IfcHatchLineDistanceSelect *StartOfNextHatchLine() const

A repetition factor that determines the distance between adjacent hatch lines.

IFC2x Edition 3 CHANGE The attribute type of StartOfNextHatchLine has changed to a SELECT of IfcPositiveLengthMeasure (new) and IfcOneDirectionRepeatFactor.

void setStartOfNextHatchLine(::Ifc4x2::IfcHatchLineDistanceSelect *v)
bool hasPointOfReferenceHatchLine() const

Whether the optional attribute PointOfReferenceHatchLine is defined for this IfcFillAreaStyleHatching.

::Ifc4x2::IfcCartesianPoint *PointOfReferenceHatchLine() const

A Cartesian point which defines the offset of the reference hatch line from the origin of the (virtual) hatching coordinate system. The origin is used for mapping the fill area style hatching onto an annotation fill area or surface. The reference hatch line would then appear with this offset from the fill style target point. If not given the reference hatch lines goes through the origin of the (virtual) hatching coordinate system.

IFC2x Edition 3 CHANGE The usage of the attribute PointOfReferenceHatchLine has changed to not provide the Cartesian point which is the origin for mapping, but to provide an offset to the origin for the mapping. The attribute has been made OPTIONAL.

void setPointOfReferenceHatchLine(::Ifc4x2::IfcCartesianPoint *v)
bool hasPatternStart() const

Whether the optional attribute PatternStart is defined for this IfcFillAreaStyleHatching.

::Ifc4x2::IfcCartesianPoint *PatternStart() const

A distance along the reference hatch line which is the start point for the curve style font pattern of the reference hatch line. If not given, the start point of the curve style font pattern is at the (virtual) hatching coordinate system.

IFC2x Edition 2 Addendum 2 CHANGE The attribute PatternStart has been made OPTIONAL.

void setPatternStart(::Ifc4x2::IfcCartesianPoint *v)
double HatchLineAngle() const

A plane angle measure determining the direction of the parallel hatching lines.

void setHatchLineAngle(double v)
const IfcParse::entity &declaration() const
IfcFillAreaStyleHatching(IfcEntityInstanceData *e)
IfcFillAreaStyleHatching(::Ifc4x2::IfcCurveStyle *v1_HatchLineAppearance, ::Ifc4x2::IfcHatchLineDistanceSelect *v2_StartOfNextHatchLine, ::Ifc4x2::IfcCartesianPoint *v3_PointOfReferenceHatchLine, ::Ifc4x2::IfcCartesianPoint *v4_PatternStart, double v5_HatchLineAngle)

Public Static Functions

const IfcParse::entity &Class()