User:Ali Haydar/GSOC19/Report


Annotations:Implement more annotation support: labels, notes, and dimensions| Project Report

The project was divided into three parts:

  • Fixing bugs in the annotation primitive.
  • Extending the current annotation to have more features.
  • Testing.

Fixing bugs in the annotation primitive

    • Annotation leader line bug: the annotation leader line was invisible because of an uninitialized variable.
    • Short annotations bug: using numbers for label results in no label "short annotation is not drawn":

the cause of this bug is that all the annotation points are in display space and we should consider just the point that exists in the model space.
    • new bounding box function:

the existed bounding box function was dealing in a wrong way with the long annotations because it's vlist is constructed from more than one memory chunk so the display mode was not memorized by the old function.
    • Position adjustment of the annotations:
The current state of position flags

the old implementation of the annotation considered just the top right (TR) relative position of the text with respect to the reference point. this patch implements the nine possible relative positions
    • Bug in L command when used on the annotation primitive: there inconsistent behavior in exporting and importing the label of the annotation to the database this patch fix that
    • Bug due to ant_label_dimensions() function: this bug was due to wrong initialization of bu_list structure in this function.

Extending the current annotation to have more features

    • Drawing a bounding box around the label text:

The user may want to have a box around the text this patch implement this feature.

bounding box around the label

    • Annotations editor: this feature is implemented based on the existing sketch editor.
Annotations editor

    • Dimension line annotation: this feature enables the user to add a dimension line between two points in the wireframe view.
Annotations editor

    • Extending the annotation text segment structure: the text segment size and rotation angle was fixed this patch add these parameters to the text segment structure.
    • Extending the annotation internal to have 3d verts vector this will be used for the future development of the dimension line


    • We have made some test on the added features and a unit test program to test a function in vlist.c.

Here is the link to my Proposal The tasks mentioned in the proposal are either completed or approached partially and needs work and discussion with the society.

Project Extension

  • These are some of the tasks that I aim to work on in the near future:
    • Closing all the open issues and keep developing the annotation primitive.
    • Refining the bounding box for the text.
    • Develope the dimension line annotation.
    • Determine the annotation types and define the types supported by in command.
    • Develope a new command for other types of annotations