API_​FilltypeType

Fill type attribute representation.

    typedef struct {
        API_Attr_Head       head;
        API_FillSubtype     subType;
        bool                isPercentFill;
        bool                filler_1[3];
        API_Pattern         bitPat;
        double              hXSpac;
        double              hYSpac;
        double              hAngle;
        Int32               linNumb;
        Int32               hotNumb;
        Int32               arcNumb;
        Int32               filNumb;
        API_Coord           c1;
        API_Coord           c2;
        GS::uchar_t         textureName [API_UniLongNameLen];
        short               textureStatus;
        short               filler_2[3];
        double              textureXSize;
        double              textureYSize;
        double              textureRotAng;
        double              percent;
        Int32               filler_3[8];
    } API_FilltypeType;

 

Members

head
Contains the name and the index of the fill. The flags field tells whether the fill is for drafting, cover, or cut fills, and scales with the plan or scale-independent.
subType
Describes the type of the fill. The possible values are enumerated in API_FillSubtype.
isPercentFill 11
Indicates a “percent” fill, e.g. 100%, 75%. This is an output-only parameter; detected from the bitmap pattern.
bitPat
Pattern of the fill. It is an eight-character constant; the first character corresponds to the the first line of the pattern, the second character to the second, etc. Example: the bitPat 0x8080808F888888F8 means the following pattern:
 

0x80 *-------
0x80 *-------
0x80 *-------
0x8F *---****
0x88 *---*---
0x88 *---*---
0x88 *---*---
0xF8 *****---
hXSpac
The fill’s spacing factor in the X direction.
hYSpac
The fill’s spacing factor in the Y direction.
hAngle
The angle of the fill.
linNumb
The number of fill line items.
hotNumb
The number of hotspot items (symbol fill only).
arcNumb
The number of arc items (symbol fill only).
filNumb
The number of simple fill items (symbol fill only).
c1
The symbol fill offset. Corresponds to the X1, Y1 values in the Fill Types dialog.
c2
The symbol fill offset. Corresponds to the X2, Y2 values in the Fill Types dialog.
textureName Changed in API 12
Texture file name.
textureStatus Changed in API 12
Texture status APITxtr_MirrorY | APITxtr_MirrorX.
textureXSize Changed in API 12
x size of the texture.
textureYSize Changed in API 12
y size of the texture.
textureRotAng Changed in API 12
Rotation angle of the texture in radians.
percent Changed in API 12
Percent of the translucent fill.

 

Remarks

The flags field of the header can take the following values:

Value

Description

APIFill_ScaleWithPlan

The fill type is scale dependent.

APIFill_ForWall

This fill can be used for cut fills.

APIFill_ForPoly

This fill can be used for drafting fills.

APIFill_ForCover

This fill can be used for cover fills.

The subType of the fill can take the following values:

Value

Description

APIFill_Vector

Vectorial fill.

APIFill_Symbol

Symbol fill.

APIFill_Solid

Solid fill. Only one solid fill may exist for polygons, and one for walls.

APIFill_Empty

Empty fill. Only one empty fill may exist for polygons, and one for walls.

APIFill_LinearGradient 10

Linear gradient fill.
  Linear gradient fill

APIFill_RadialGradient 10

Radial gradient fill.
  Radial gradient fill

APIFill_Image

Image fill.Changed in API 12

Most of the fields in this structure correspond to the items of the Fill Types dialog in Archicad.

There is additional data assigned to fill attributes in the API_AttributeDef structure; the definition of a fill is passed through the fill_lineItems and fill_lineLength fields. Refer to the API_FillLine structure to get more details on them.

API 17 Note that in AC17 the Energy Evaluation property parameters (thermalConductivity, density and heatCapacity) have been removed from this structure; they are now part of API_BuildingMaterialType.

 

Requirements

Version: API 1.3 or later
Header: APIdefs_Attributes.h

 

See Also

API_Coord, API_Attr_Head, API_Attribute, API_FillLine, API_AttributeDef,
Attribute Manager, API Types