BCF Format Attributes (Feature Representation)

Jump to:

Format-Specific Attributes

In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Type Attributes), this format also adds format-specific attributes (Format Attributes).

Attribute

Description

xml_topic_guid

Except for the Version, ProjectExtension, Document, and Extension (TopicLabel, TopicStatus, TopicType, User, SnippetType, Stage, Priority, this attribute should be present in all BCF feature types.

The attribute represents the topic GUID. In the BCF zip archive, it is the name of the topic directory.

xml_viewpoint_id

This attribute should be present in viewpoints and snapshot features types. A topic may have one or more viewpoints. The first, default, viewpoint in a topic is composed of a viewpoint.bcfv and a snapshot.png file. Any of the following values will route the viewpoint and snapshot features to their default files:

  • Empty string
  • viewpoint or viewpoint.bcfv
  • snapshot or snapshot.png

Subsequent viewpoints and snapshot files must be identified by a unique GUID. The GUID determines the viewpoint and snapshot file names in the topic.

For example, if the xml_viewpoint_id for the viewpoint features and the Snapshot feature has the GUID value A7693B7D-CFA3-4355-8E0E-5B618F497C4E, then the features were read from, or will be written to, the following viewpoint and snapshot files:

A7693B7D-CFA3-4355-8E0E-5B618F497C4E.bcfv

A7693B7D-CFA3-4355-8E0E-5B618F497C4E.png

Geometry Features

The geometry features produced by the BCF reader can be identified by the xml_type attribute. The valid values for this attribute are:

xml_type

Description

xml_no_geom

FME Feature with no geometry.

Every BCF feature type except for the Snapshot feature will have its xml_type set to xml_no_geom.

xml_raster

BCF PNG Snapshot features.

Feature Types

The feature types for the BCF reader and writer are listed below. These are FME feature representations of the various XML and PNG files in a BCF dataset.

BCF 2.0

BCF File FME Feature Type

bcf.version

Version

project.bcfp

ProjectExtension

markup.bcf

Markup

Header

Topic

Comment

Viewpoints

viewpoint.bcfv

VisualizationInfo

Component

OrthogonalCamera

PerspectiveCamera

Line

ClippingPlane

Bitmaps

snapshot.png

Snapshot

BCF 2.1

BCF File FME Feature Type

bcf.version

Version

project.bcfp

ProjectExtension

markup.bcf

Markup

Header

Topic

Comment

Viewpoints

viewpoint.bcfv

VisualizationInfo

Component

OrthogonalCamera

PerspectiveCamera

Line

ClippingPlane

Bitmap

snapshot.png

Snapshot

BCF 3.0

BCF File FME Feature Type

bcf.version

Version

project.bcfp

ProjectExtension

markup.bcf

Markup

Header

Topic

Comment

Viewpoints

viewpoint.bcfv

VisualizationInfo

Component

OrthogonalCamera

PerspectiveCamera

Line

ClippingPlane

Bitmap

snapshot.png

Snapshot

documents.xml

Document

extensions.xml

User

Priority

SnippetType

Stage

TopicStatus

TopicType

TopicLabel

Attribute Representation

The attributes for each feature type for the BCF reader and writer are listed below. Additional documentation on the BCF format can be found in buildingSMART GitHub resources:

Note  Changes from BCF 2.0 to BCF 2.1 are carried over into BCF 3.0, unless otherwise specified.

You can search feature type and attribute names in the table below.

Feature Type

Attribute BCF Version 2.0

Attribute BCF Version 2.1

Attribute BCF Version 3.0

Change Description, if applicable

Version

 

VersionId

VersionId

VersionId

 

DetailedVersion

DetailedVersion

Not Supported

2.1 to 3.0: Removed

ProjectExtension (2.0 and 2.1)

ProjectInfo (3.0)

 

 

Project.ProjectId

Project.ProjectId

Project.ProjectId

 

Project.Name

Project.Name

Project.Name

 

ExtensionSchema

ExtensionSchema

Not Supported

2.1 to 3.0: Removed

Header

 

 

 

 

 

File{}.IfcProject

File{}.IfcProject

File{}.IfcProject

 

File{}.IfcSpatialStructureElement

File{}.IfcSpatialStructureElement

File{}.IfcSpatialStructureElement

 

File{}.IsExternal

File{}.IsExternal

File{}.IsExternal

 

File{}.Filename

File{}.Filename

File{}.Filename

 

File{}.Date

File{}.Date

File{}.Date

 

File{}.Reference

File{}.Reference

File{}.Reference

 

Topic

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Guid

Guid

Guid

 

TopicType

TopicType

TopicType

 

TopicStatus

TopicStatus

TopicStatus

 

ReferenceLink

ReferenceLink{}

ReferenceLink{}

2.0 to 2.1: Type Changed: List Attribute

Title

Title

Title

 

Priority

Priority

Priority

 

Index

Index

Index

2.0 to 2.1: Type Changed to Int32 from Int64

Labels{}

Labels{}

Labels{}

 

CreationDate

CreationDate

CreationDate

 

CreationAuthor

CreationAuthor

CreationAuthor

 

ModifiedDate

ModifiedDate

ModifiedDate

 

ModifiedAuthor

ModifiedAuthor

ModifiedAuthor

 

Not Supported

DueDate

DueDate

 

AssignedTo

AssignedTo

AssignedTo

 

Not Supported

Stage

Stage

 

Description

Description

Description

 

BimSnippet.SnippetType

BimSnippet.SnippetType

BimSnippet.SnippetType

 

BimSnippet.isExternal

BimSnippet.isExternal

BimSnippet.isExternal

 

BimSnippet.Reference

BimSnippet.Reference

BimSnippet.Reference

 

BimSnippet.ReferenceSchema

BimSnippet.ReferenceSchema

BimSnippet.ReferenceSchema

 

DocumentReferences{}.Guid

DocumentReference{}.Guid

DocumentReference{}.Guid

2.0 to 2.1: Renamed

DocumentReferences{}.isExternal

DocumentReference{}.isExternal

DocumentReference{}.isExternal

2.0 to 2.1: Renamed

DocumentReferences{}.ReferencedDocument

DocumentReference{}.ReferencedDocument

DocumentReference{}.ReferencedDocument

2.0 to 2.1: Renamed

DocumentReferences{}.Description

DocumentReference{}.Description

DocumentReference{}.Description

2.0 to 2.1: Renamed

Not Supported

Not Supported

DocumentReference{}.Url

2.1 to 3.0: Added

RelatedTopics{}.Guid

RelatedTopic{}.Guid

RelatedTopic{}.Guid

2.0 to 2.1: Renamed

Comment

Guid

Guid

Guid

 

 

VerbalStatus

Not Supported

Not Supported

2.0 to 2.1: Removed

 

Status

Not Supported

Not Supported

2.0 to 2.1: Removed

 

Date

Date

Date

 

 

Author

Author

Author

 

 

Comment

Comment

Comment

 

 

Topic.Guid

Not Supported

Not Supported

2.0 to 2.1: Removed

 

Viewpoint.Guid

Viewpoint.Guid

Viewpoint.Guid

 

 

ReplyToComment.Guid

Not Supported

Not Supported

2.0 to 2.1: Removed

 

Modified Date

Modified Date

Modified Date

 

 

Modified Author

Modified Author

Modified Author

 

Viewpoints

 

 

 

Guid

Guid

Guid

 

Snapshot

Snapshot

Snapshot

 

Viewpoint

Viewpoint

Viewpoint

 

Not Supported

Index

Index

2.0 to 2.1: Added

Component

 

 

 

 

 

IfcGuid

IfcGuid

IfcGuid

 

Selected

Selected

Selected

 

Visible

Visible

Visible

 

Color

Color

Color

 

OriginatingSystem

OriginatingSystem

OriginatingSystem

 

AuthoringToolId

AuthoringToolId

AuthoringToolId

 

OrthogonalCamera

CameraViewPoint.X

CameraViewPoint.X

CameraViewPoint.X

 

CameraViewPoint.Y

CameraViewPoint.Y

CameraViewPoint.Y

 

CameraViewPoint.Z

CameraViewPoint.Z

CameraViewPoint.Z

 

CameraDirection.X

CameraDirection.X

CameraDirection.X

 

CameraDirection.Y

CameraDirection.Y

CameraDirection.Y

 

CameraDirection.Z

CameraDirection.Z

CameraDirection.Z

 

CameraUpVector.X

CameraUpVector.X

CameraUpVector.X

 

CameraUpVector.Y

CameraUpVector.Y

CameraUpVector.Y

 

CameraUpVector.Z

CameraUpVector.Z

CameraUpVector.Z

 

ViewToWorldScale

ViewToWorldScale

ViewToWorldScale

 

Not Supported

Not Supported

Aspect Ratio

2.1 to 3.0: Added

PerspectiveCamera

CameraViewPoint.X

CameraViewPoint.X

CameraViewPoint.X

 

CameraViewPoint.Y

CameraViewPoint.Y

CameraViewPoint.Y

 

CameraViewPoint.Z

CameraViewPoint.Z

CameraViewPoint.Z

 

CameraDirection.X

CameraDirection.X

CameraDirection.X

 

CameraDirection.Y

CameraDirection.Y

CameraDirection.Y

 

CameraDirection.Z

CameraDirection.Z

CameraDirection.Z

 

CameraUpVector.X

CameraUpVector.X

CameraUpVector.X

 

CameraUpVector.Y

CameraUpVector.Y

CameraUpVector.Y

 

CameraUpVector.Z

CameraUpVector.Z

CameraUpVector.Z

 

ViewToWorldScale

ViewToWorldScale

ViewToWorldScale

 

Not Supported

Not Supported

Aspect Ratio

 

Line

 

 

 

 

 

StartPoint.X

StartPoint.X

StartPoint.X

 

StartPoint.Y

StartPoint.Y

StartPoint.Y

 

StartPoint.Z

StartPoint.Z

StartPoint.Z

 

EndPoint.X

EndPoint.X

EndPoint.X

 

EndPoint.Y

EndPoint.Y

EndPoint.Y

 

EndPoint.Z

EndPoint.Z

EndPoint.Z

 

ClippingPlane

 

 

 

 

 

Location.X

Location.X

Location.X

 

Location.Y

Location.Y

Location.Y

 

Location.Z

Location.Z

Location.Z

 

Direction.X

Direction.X

Direction.X

 

Direction.Y

Direction.Y

Direction.Y

 

Direction.Z

Direction.Z

Direction.Z

 

Bitmaps (2.0)

Bitmap (2.1)

 

 

 

 

 

 

 

 

 

 

 

Bitmap

Bitmap

Format Bitmap

2.1 to 3.0: Renamed

Reference

Reference

Reference

 

Location.X

Location.X

Location.X

 

Location.Y

Location.Y

Location.Y

 

Location.Z

Location.Z

Location.Z

 

Normal.X

Normal.X

Normal.X

 

Normal.Y

Normal.Y

Normal.Y

 

Normal.Z

Normal.Z

Normal.Z

 

Up.X

Up.X

Up.X

 

Up.Y

Up.Y

Up.Y

 

Up.Z

Up.Z

Up.Z

 

Height

Height

Height

 

VisualizationInfo

Not Supported

DefaultVisibility

DefaultVisibility

2.0 to 2.1: Added

Not Supported

Guid

Guid

2.0 to 2.1: Added

Not Supported

ViewSetupHints.SpaceBoundariesVisible

ViewSetupHints.SpaceBoundariesVisible

2.0 to 2.1: Added

Not Supported

ViewSetupHints.OpeningsVisible

ViewSetupHints.OpeningsVisible

2.0 to 2.1: Added

Not Supported

ViewSetupHints.SpacesVisible

ViewSetupHints.SpacesVisible

2.0 to 2.1: Added

TopicType

Not Supported

Not Supported

TopicType

2.1 to 3.0: Added

TopicLabel

Not Supported

Not Supported

TopicLabel

2.1 to 3.0: Added

TopicStatus

Not Supported

Not Supported

TopicStatus

2.1 to 3.0: Added

User

Not Supported

Not Supported

User

2.1 to 3.0: Added

SnippetType

Not Supported

Not Supported

SnippetType

2.1 to 3.0: Added

Stage

Not Supported

Not Supported

Stage

2.1 to 3.0: Added

Priority

Not Supported

Not Supported

Priority

2.1 to 3.0: Added

Document

Not Supported

Not Supported

GUID

2.1 to 3.0: Added

Not Supported

Not Supported

Filename

 

Not Supported

Not Supported

SourceDocumentPath

 

Not Supported

Not Supported

Description