RGtk2 (version 2.12.17)

cairoStrokeExtents: cairoStrokeExtents

Description

Computes a bounding box in user coordinates covering the area that would be affected, (the "inked" area), by a cairoStroke operation operation given the current path and stroke parameters. If the current path is empty, returns an empty rectangle ((0,0), (0,0)). Surface dimensions and clipping are not taken into account.

Usage

cairoStrokeExtents(cr)

Arguments

cr

[Cairo] a cairo context

Value

• A list containing the following elements:
• x1
  [numeric] left of the resulting extents
• y1
  [numeric] top of the resulting extents
• x2
  [numeric] right of the resulting extents
• y2
  [numeric] bottom of the resulting extents

Details

Note that if the line width is set to exactly zero, then cairo_stroke_extents will return an empty rectangle. Contrast with cairoPathExtents which can be used to compute the non-empty bounds as the line width approaches zero. See cairoStroke, cairoSetLineWidth, cairoSetLineJoin, cairoSetLineCap, cairoSetDash, and cairoStrokePreserve.