Class AcDb2dVertex

Represents the vertices in 2D polylines.

Hierarchy (View Summary)

Constructors

constructor

Properties

typeName

Accessors

attrs bulge color database endWidth geometricExtents layer lineStyle lineType linetypeScale lineWeight objectId ownerId position properties rgbColor startWidth transparency type vertexType visibility

Methods

attachEntityInfo close draw getAttr getAttrWithoutException getGeneralProperties getLayerColor setAttr subGetGripPoints subGetOsnapPoints transformBy triggerModifiedEvent

Constructors

constructor

Properties

StatictypeName

typeName: string = '2dVertex'

The entity type name

Accessors

attrs

bulge

color

database

  • get database(): AcDbDatabase

  • Gets the database in which this object is resident.

    When an object isn't added to a database, this property returns the current working database. After it is added to a database, it will be set automatically. You should never set this value manually.

    Returns AcDbDatabase

    The database this object belongs to

    Example

    const db = obj.database;
  • set database(db: AcDbDatabase): void

  • Sets the database for this object.

    This is typically set automatically when the object is added to a database. Manual setting should be avoided unless you know what you're doing.

    Parameters

    Returns void

    Example

    obj.database = myDatabase;

endWidth

  • get endWidth(): number

  • Gets the end width for the vertex. The end width is used as the width at the end of the polyline segment from this vertex to the next vertex.

    Returns number

    The end width for the vertex

  • set endWidth(value: number): void

  • Sets the end width for the vertex. The end width is used as the width at the end of the polyline segment from this vertex to the next vertex.

    Parameters

    • value: number

      The end width for the vertex

    Returns void

geometricExtents

layer

  • get layer(): string

  • Gets the name of the layer referenced by this entity.

    Returns string

    The layer name

    Example

    const layerName = entity.layer;
  • set layer(value: string): void

  • Sets the name of the layer for this entity.

    Parameters

    • value: string

      The new layer name

    Returns void

    Example

    entity.layer = 'MyLayer';

lineStyle

  • get lineStyle(): AcGiLineStyle

  • Gets the line style for this entity.

    This method returns the line style based on the entity's linetype and other properties.

    Returns AcGiLineStyle

    The line style object

    Example

    const lineStyle = entity.lineStyle;

lineType

  • get lineType(): string

  • Gets the name of the line type referenced by this entity.

    Returns string

    The linetype name

    Example

    const lineType = entity.lineType;
  • set lineType(value: string): void

  • Sets the name of the line type for this entity.

    Parameters

    • value: string

      The new linetype name

    Returns void

    Example

    entity.lineType = 'DASHED';

linetypeScale

  • get linetypeScale(): number

  • Gets the line type scale factor of this entity.

    When an entity is first instantiated, its line type scale is initialized to an invalid value. When the entity is added to the database, if a linetype scale has not been specified for the entity, it is set to the database's current line type scale value.

    Returns number

    The linetype scale factor

    Example

    const scale = entity.linetypeScale;
  • set linetypeScale(value: number): void

  • Sets the line type scale factor for this entity.

    Parameters

    • value: number

      The new linetype scale factor

    Returns void

    Example

    entity.linetypeScale = 2.0;

lineWeight

objectId

  • get objectId(): string

  • Gets the object ID.

    AutoCAD uses 64-bit integers to represent handles, which exceed the maximum integer value of JavaScript. Therefore, strings are used to represent object handles.

    Returns string

    The object ID as a string

    Example

    const id = obj.objectId;
    console.log(`Object ID: ${id}`);
  • set objectId(value: string): void

  • Sets the object ID.

    Parameters

    • value: string

      The new object ID

    Returns void

    Example

    obj.objectId = 'new-object-id';

ownerId

  • get ownerId(): string

  • Gets the object ID of the owner of this object.

    Returns string

    The owner object ID

    Example

    const ownerId = obj.ownerId;
  • set ownerId(value: string): void

  • Sets the object ID of the owner of this object.

    Parameters

    • value: string

      The new owner object ID

    Returns void

    Example

    obj.ownerId = 'parent-object-id';

position

  • get position(): AcGePoint3d

  • Gets the position value of the vertex. The position point value must be in OCS coordinates (the OCS of the polyline containing the vertex), not WCS. The Z coordinate is kept in the owning AcDb2dPolyline only for historical purposes.

    Returns AcGePoint3d

    The position value of the vertex

  • set position(value: AcGeVector3dLike): void

  • Sets the position value of the vertex. The position point value must be in OCS coordinates (the OCS of the polyline containing the vertex), not WCS. The Z coordinate is kept in the owning AcDb2dPolyline only for historical purposes.

    Parameters

    Returns void

properties

  • get properties(): AcDbEntityProperties

  • Returns the full property definition for this entity, including all property groups and runtime accessors.

    This getter is used by the property inspector UI to:

    • determine the layout and grouping of properties,
    • look up editable flags and metadata,
    • read/write live values on this entity using accessors.

    The returned structure contains:

    • static metadata (label, type, group structure),
    • dynamic accessor bindings that expose the actual values stored in the entity.

    Note: The groups array contains AcDbEntityPropertyGroup objects whose properties entries are runtime-resolved property descriptors that include AcDbPropertyAccessor objects. Each property object therefore conforms to AcDbEntityRuntimeProperty.

    Returns AcDbEntityProperties

rgbColor

  • get rgbColor(): number

  • Gets the RGB color of this entity.

    This method handles the conversion of color indices (including ByLayer and ByBlock) to actual RGB colors. It resolves layer colors and block colors as needed.

    Returns number

    The RGB color value as a number

    Example

    const rgbColor = entity.rgbColor;
    console.log(`RGB: ${rgbColor.toString(16)}`);

startWidth

  • get startWidth(): number

  • Gets the start width for the vertex. The start width is used as the width at this vertex for the polyline segment from this vertex to the next vertex.

    Returns number

    The start width for the vertex

  • set startWidth(value: number): void

  • Sets the start width for the vertex. The start width is used as the width at this vertex for the polyline segment from this vertex to the next vertex.

    Parameters

    • value: number

      The start width for the vertex

    Returns void

transparency

type

  • get type(): string

  • Gets the type name of this entity.

    This method returns the entity type by removing the "AcDb" prefix from the constructor name.

    Returns string

    The entity type name

    Example

    const entity = new AcDbLine();
    console.log(entity.type); // "Line"

vertexType

visibility

  • get visibility(): boolean

  • Gets whether this entity is visible.

    Returns boolean

    True if the entity is visible, false otherwise

    Example

    const isVisible = entity.visibility;
  • set visibility(value: boolean): void

  • Sets whether this entity is visible.

    Parameters

    • value: boolean

      True to make the entity visible, false to hide it

    Returns void

    Example

    entity.visibility = false; // Hide the entity

Methods

ProtectedattachEntityInfo

  • attachEntityInfo(target: undefined | null | AcGiEntity): void

  • Attaches entity information to a graphic interface entity.

    This method transfers essential entity properties (object ID, owner ID, layer name, and visibility) from this entity to the target graphic interface entity. This is typically used during the rendering process to ensure the graphic entity has the correct metadata.

    Parameters

    • target: undefined | null | AcGiEntity

      The graphic interface entity to attach information to

    Returns void

close

  • close(): void

  • Closes the object.

    All changes made to the object since it was opened are committed to the database, and a "closed" notification is sent. This method can be overridden by subclasses to provide specific cleanup behavior.

    Returns void

    Example

    obj.close();

draw

getAttr

  • getAttr(attrName: string): any

  • Gets the value of the specified attribute.

    This method will throw an exception if the specified attribute doesn't exist. Use getAttrWithoutException() if you want to handle missing attributes gracefully.

    Parameters

    • attrName: string

      The name of the attribute to retrieve

    Returns any

    The value of the specified attribute

    Throws

    When the specified attribute doesn't exist

    Example

    try {
      const value = obj.getAttr('objectId');
    } catch (error) {
      console.error('Attribute not found');
    }

getAttrWithoutException

  • getAttrWithoutException(attrName: string): any

  • Gets the value of the specified attribute without throwing an exception.

    This method returns undefined if the specified attribute doesn't exist, making it safer for optional attributes.

    Parameters

    • attrName: string

      The name of the attribute to retrieve

    Returns any

    The value of the specified attribute, or undefined if it doesn't exist

    Example

    const value = obj.getAttrWithoutException('optionalAttribute');
    if (value !== undefined) {
      // Use the value
    }

ProtectedgetGeneralProperties

ProtectedgetLayerColor

  • getLayerColor(): null | AcCmColor

  • Gets the color of the layer this entity belongs to.

    This method retrieves the color from the layer table for the layer this entity belongs to.

    Returns null | AcCmColor

    The layer color, or undefined if the layer doesn't exist

    Example

    const layerColor = entity.getLayerColor();

setAttr

subGetGripPoints

subGetOsnapPoints

transformBy

triggerModifiedEvent

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods