This file is indexed.

/usr/include/Wt/Chart/WDataSeries is in libwt-dev 3.1.10-1ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
// This may look like C code, but it's really -*- C++ -*-
/*
 * Copyright (C) 2008 Emweb bvba, Kessel-Lo, Belgium.
 *
 * See the LICENSE file for terms of use.
 */
#ifndef CHART_WDATA_SERIES_H_
#define CHART_WDATA_SERIES_H_

#include <Wt/Chart/WAxis>
#include <Wt/WBrush>
#include <Wt/WPen>
#include <Wt/WShadow>
#include <Wt/Chart/WChartGlobal>

namespace Wt {

  class WPointF;

  namespace Chart {

/*! \class WDataSeries Wt/Chart/WDataSeries Wt/Chart/WDataSeries
 *  \brief A single data series in a cartesian chart.
 *
 * This class configures all aspects for rendering a single data series
 * in a cartesian chart. A data series renders Y data from a single
 * model column against the X series configured for the chart.
 *
 * \if cpp
 * The data column should contain data that can be converted to
 * a number, but should not necessarily be of a number type, see
 * also asNumber(const boost::any&).
 * \elseif java
 * The data column should contain data that can be converted to
 * a number, but should not necessarily be of a number type, see
 * also {javadoclink eu.webtoolkit.jwt.StringUtils#asNumber(Object)}.
 * \endif
 *
 * Multiple series of different types may be combined on a single chart.
 *
 * \image html ChartWDataSeries-1.png "Different styles of data series"
 * 
 * For a category chart, series may be stacked on top of each other.
 * This is controlled by setStacked() for a series, which if enabled,
 * will stack that series on top of the preceding data series. This
 * works regardless of whether they are of the same type, but
 * obviously works visually best if these series are of the same
 * type. When not stacked, bar series are rendered next to each other.
 * The margin between bars of different data series is controlled
 * using WCartesianChart::setBarMargin().
 *
 * The line and color type are by default based on the \link
 * WCartesianChart::palette() chart palette\endlink, but may be
 * overridden for a series using setPen(), setBrush(), etc...
 *
 * \sa WCartesianChart::addSeries()
 *
 * \ingroup charts
 */
class WT_API WDataSeries
{
public:
  /*! \brief Enumeration that indicates an aspect of the look.
   *
   * These flags are used to keep track of which aspects of the look
   * that are overridden from the values provided by the chart palette,
   * using one of the methods in this class.
   *
   * \sa setPen(), setBrush(), setMarkerPen(), setMarkerBrush(), setLabelColor()
   */
  enum CustomFlag {
    CustomPen = 0x1,         //!< A custom pen is set.
    CustomBrush = 0x2,       //!< A custom brush is set.
    CustomMarkerPen = 0x4,   //!< A custom marker pen is set.
    CustomMarkerBrush = 0x8, //!< A custom marker brush is set.
    CustomLabelColor = 0x10  //!< A custom label color is set.
  };

  /*! \brief Constructs a new data series.
   *
   * Creates a new data series which plots the Y values from the
   * model column <i>modelColumn</i>, with the indicated
   * <i>seriesType</i>. The Y values are mapped to the indicated
   * <i>axis</i>, which should correspond to one of the two Y axes.
   *
   * \sa WCartesianChart::addSeries()
   */
  WDataSeries(int modelColumn, SeriesType seriesType = PointSeries,
	      Axis axis = Y1Axis);

  /*! \brief Sets the bar width.
   *
   * The bar width specifies the bar width (in axis dimensions).  For
   * category plots, which may have several bars for different series
   * next to each other, you will want to specify the same bar width
   * for each series.
   *
   * For scatter plots, you may want to set the bar width to a natural
   * size. E.g. if you are plotting weekly measurements, you could set
   * the width to correspond to a week (=7).
   *
   * The default value is 0.8 (which leaves a 20% margin between bars
   * for different categories in a category chart.
   *
   * \sa WCartesianChart::setBarMargin()
   */
  void setBarWidth(const double width);

  /*! \brief Returns the bar width.
   *
   * \sa setBarWidth() 
   */
  double barWidth() const;

  /*! \brief Sets the series type.
   *
   * The series type specifies how the data is plotted, i.e. using
   * mere point markers, lines, curves, or bars.
   */
  void setType(SeriesType t);

  /*! \brief Returns the series type.
   *
   * \sa setType()
   */
  SeriesType type() const { return type_; }

  /*! \brief Sets the model column.
   *
   * This specifies the model column from which the Y data is retrieved
   * that is plotted by this series.
   *
   * The data column should contain data that can be converted to
   * a number (but should not necessarily be of a number type).
   * \if java 
   * See also {javadoclink eu.webtoolkit.jwt.StringUtils#asNumber(Object)}.
   * \endif
   *
   * \if cpp
   * \sa Wt::asNumber()
   * \endif
   */
  void setModelColumn(int modelColumn);

  /*! \brief Returns the model column.
   *
   * \sa setModelColumn()
   */
  int modelColumn() const { return modelColumn_; }

  /*! \brief Sets the X series column.
   *
   * By default, the data series uses the X series column configured
   * for the chart. For a scatter plot, each series can have its own
   * matching X data, which is configured here. For other plots, this
   * setting is ignored.
   *
   * The default value is -1, which indicates that
   * WCartesianChart::XSeriesColumn() is to be used.
   *
   * \sa WCartesianChart::setXSeriesColumn(int modelColumn)
   */
  void setXSeriesColumn(int modelColumn);

  /*! \brief Returns the X series column.
   *
   * \sa setXSeriesColumn(int modelColumn)
   */
  int XSeriesColumn() const { return XSeriesColumn_; }

  /*! \brief Sets whether this series is stacked on top of the preceding series.
   *
   * For category charts, data from different series may be rendered
   * stacked on top of each other. The rendered value is the sum of the
   * value of this series plus the rendered value of the preceding
   * series. For line series, you probably will want to add filling
   * under the curve. A stacked bar series is rendered by a bar on top
   * of the preceding bar series.
   *
   * The default value is false.
   */
  void setStacked(bool stacked);

  /*! \brief Returns whether this series is stacked on top of the preceding
   *         series.
   *
   * \sa setStacked()
   */
  bool isStacked() const { return stacked_; }

  /*! \brief Binds this series to a chart axis.
   *
   * A data series may be bound to either the first or second Y axis.
   * Note that the second Y axis is by default not displayed.
   *
   * The default value is the first Y axis.
   *
   * \sa WAxis::setVisible()
   */
  void bindToAxis(Axis axis);

  /*! \brief Returns the chart axis used for this series.
   *
   * \sa bindToAxis()
   */
  Axis axis() const { return axis_; }

  /*! \brief Sets which aspects of the look are overriden.
   *
   * Set which aspects of the look, that are by default based on the
   * chart palette, are overridden by custom settings.
   *
   * The default value is 0 (nothing overridden).
   */
  void setCustomFlags(WFlags<CustomFlag> customFlags);

  /*! \brief Returns which aspects of the look are overriden.
   *
   * \sa setCustomFlags()
   */
  WFlags<CustomFlag> customFlags() const { return customFlags_; }

  /*! \brief Overrides the pen used for drawing lines for this series.
   *
   * Overrides the pen that is used to draw this series. Calling this
   * method automatically adds CustomPen to the custom flags.
   *
   * The default value is a default WPen().
   *
   * \sa WChartPalette::strokePen(), WChartPalette::borderPen()
   */
  void setPen(const WPen& pen);

  /*! \brief Returns the pen used for drawing lines for this series.
   *
   * \sa setPen()
   */
  WPen pen() const;

  /*! \brief Overrides the brush used for filling areas for this series.
   *
   * Overrides the brush that is used to draw this series which is
   * otherwise provided by the chart palette. For a bar plot, this is the
   * brush used to fill the bars. For a line chart, this is the brush
   * used to fill the area under (or above) the line. Calling this
   * method automatically adds CustomBrush to the custom flags.
   *
   * \sa WChartPalette::brush()
   */
  void setBrush(const WBrush& brush);

  /*! \brief Returns the brush used for filling areas for this series.
   *
   * \sa setBrush()
   */
  WBrush brush() const;

  /*! \brief Sets a shadow used for stroking lines for this series.
   */
  void setShadow(const WShadow& shadow);

  /*! \brief Returns the shadow used for stroking lines for this series.
   *
   * \sa setShadow()
   */
  const WShadow& shadow() const;

  /*! \brief Sets the fill range for line or curve series.
   *
   * Line or curve series may be filled under or above the curve, using the
   * brush(). This setting specifies the range that is filled.
   */
  void setFillRange(FillRangeType fillRange);

  /*! \brief Returns the fill range for line or curve series.
   *
   * \sa setFillRange()
   */
  FillRangeType fillRange() const { return fillRange_; }

  /*! \brief Sets the data point marker.
   *
   * Specifies a marker that is displayed at the (X,Y) coordinate for each
   * series data point.
   *
   * The default value is a CircleMarker for a PointSeries, or NoMarker
   * otherwise.
   *
   * \sa setMarkerPen(), setMarkerBrush().
   */
  void setMarker(MarkerType marker);

  /*! \brief Returns the data point marker.
   *
   * \sa setMarker()
   */
  MarkerType marker() const { return marker_; }

  /*! \brief Sets the marker size.
   *
   * The default marker size is 6 pixels.
   */
  void setMarkerSize(double size);

  /*! \brief Returns the marker size.
   *
   * \sa setMarkerSize()
   */
  double markerSize() const { return markerSize_; }

  /*! \brief Sets the marker pen.
   *
   * Overrides the pen used for stroking the marker. By default the
   * marker pen is the same as pen(). Calling this method automatically adds
   * CustomMarkerPen to the custom flags.
   *
   * \sa setPen(), setMarkerBrush()
   */
  void setMarkerPen(const WPen& pen);

  /*! \brief Returns the marker pen.
   *
   * \sa setMarkerPen()
   */
  WPen markerPen() const;

  /*! \brief Sets the marker brush.
   *
   * Overrides the brush used for filling the marker. By default the
   * marker brush is the same as brush(). Calling this method
   * automatically adds CustomMarkerBrush to the custom flags.
   *
   * \sa setBrush(), setMarkerPen()
   */
  void setMarkerBrush(const WBrush& brush);

  /*! \brief Returns the marker brush.
   *
   * \sa setMarkerBrush()
   */
  WBrush markerBrush() const;

  /*! \brief Enables the entry for this series in the legend.
   *
   * When <i>enabled</i>, this series is added to the chart
   * legend.
   *
   * The default value is true.
   *
   * \sa WCartesianChart::setLegendEnabled().
   */
  void setLegendEnabled(bool enabled);

  /*! \brief Returns whether this series has an entry in the legend.
   *
   * \sa setLegendEnabled()
   */
  bool isLegendEnabled() const;

  /*! \brief Enables a label that is shown at the series data points.
   *
   * You may enable labels for the XAxis, YAxis or both axes. The
   * label that is displayed is the corresponding value on that
   * axis. If both labels are enabled then they are combined in a
   * single text using the format: "<x-value>: <y-value>".
   *
   * The default values are false for both axes (no labels).
   *
   * \sa isLabelsEnabled()
   */
  void setLabelsEnabled(Axis axis, bool enabled = true);

  /*! \brief Returns whether labels are enabled for the given axis.
   *
   * \sa setLabelsEnabled()
   */
  bool isLabelsEnabled(Axis axis) const;

  /*! \brief Sets the label color.
   *
   * Specify the color used for the rendering labels at the data
   * points.
   *
   * \sa setLabelsEnabled()
   */
  void setLabelColor(const WColor& color);

  /*! \brief Returns the label color.
   *
   * \sa setLabelColor()
   */
  WColor labelColor() const;

  /*! \brief Hide/unhide this series.
   *
   * A hidden series will not be show in the chart and legend.
   */
  void setHidden(bool hidden);

  /*! \brief Return whether the series is hidden.
   *
   * \sa setHidden()
   */
  bool isHidden() const;

  /*! \brief Maps from device coordinates to model coordinates.
   *
   * Maps a position in the chart back to model coordinates, for data
   * in this data series.
   *
   * This uses WChart::mapFromDevice() passing the axis() to which this
   * series is bound.
   *
   * This method uses the axis dimensions that are based on the latest
   * chart rendering. If you have not yet rendered the chart, or wish
   * to already the mapping reflect model changes since the last
   * rendering, you should call WCartesianChart::initLayout() first.
   *
   * \sa mapToDevice()
   */ 
  WPointF mapFromDevice(const WPointF& deviceCoordinates) const;

  /*! \brief Maps from model values to device coordinates.
   *
   * Maps model values to device coordinates, for data in this data series.
   *
   * This uses WChart::mapToDevice() passing the axis() to which this
   * series is bound.
   *
   * This method uses the axis dimensions that are based on the latest
   * chart rendering. If you have not yet rendered the chart, or wish
   * to already the mapping reflect model changes since the last
   * rendering, you should call WCartesianChart::initLayout() first.
   *
   * \sa mapFromDevice()
   */ 
  WPointF mapToDevice(const boost::any& xValue, const boost::any& yValue,
		      int segment = 0) const;

private:
  WCartesianChart   *chart_;
  int                modelColumn_;
  int                XSeriesColumn_;
  bool               stacked_;
  SeriesType         type_;
  Axis               axis_;
  WFlags<CustomFlag> customFlags_;
  WPen               pen_, markerPen_;
  WBrush             brush_, markerBrush_;
  WColor             labelColor_;
  WShadow            shadow_;
  FillRangeType      fillRange_;
  MarkerType         marker_;
  double             markerSize_;
  bool               legend_;
  bool               xLabel_;
  bool               yLabel_;
  double             barWidth_;
  bool               hidden_;

  template <typename T>
  bool set(T& m, const T& v);

  void setChart(WCartesianChart *chart);
  void update();

  friend class WCartesianChart;
};

template <typename T>
bool WDataSeries::set(T& m, const T& v)
{
  if (m != v) {
    m = v;
    update();
    return true;
  } else
    return false;
}

  }
}

#endif // CHART_WDATA_SERIES_H_