Function Context.setLineWidth

Sets the current line width within the cairo context. The line width value specifies the diameter of a pen that is circular in user space, (though device-space pen may be an ellipse in general due to scaling/shear/rotation of the CTM).

Prototype

void setLineWidth(
  double width
);

Note

When the description above refers to user space and CTM it refers to the user space and CTM in effect at the time of the stroking operation, not the user space and CTM in effect at the time of the call to setLineWidth(). The simplest usage makes both of these spaces identical. That is, if there is no change to the CTM between a call to setLineWidth() and the stroking operation, then one can just pass user-space values to setLineWidth() and ignore this note.

As with the other stroke parameters, the current line width is examined by stroke(), strokeExtents() and strokeToPath(), but does not have any effect during path construction.

The default line width value is 2.0.

Authors

Johannes Pfau cairoD
Andrej Mitrovic cairoD
cairo team cairo

Copyright

License

cairoD wrapper/bindings Boost License 1.0
cairo LGPL 2.1 / MPL 1.1