StockDiagram::Private Namespace Reference

Functions
int	closeValueColumn () const
	Returns the column of the close value in the model.
void	drawCandlestick (const CartesianDiagramDataCompressor::DataPoint &open, const CartesianDiagramDataCompressor::DataPoint &high, const CartesianDiagramDataCompressor::DataPoint &low, const CartesianDiagramDataCompressor::DataPoint &close, PaintContext *context)
	Draws a line connecting the low and the high value of an OHLC chart.
void	drawLine (int col, const QPointF &point1, const QPointF &point2, PaintContext *context)
	Draws a line connecting two points.
void	drawOHLCBar (const CartesianDiagramDataCompressor::DataPoint &open, const CartesianDiagramDataCompressor::DataPoint &high, const CartesianDiagramDataCompressor::DataPoint &low, const CartesianDiagramDataCompressor::DataPoint &close, PaintContext *context)
int	highValueColumn () const
	Returns the column of the high value in the model.
int	lowValueColumn () const
	Returns the column of the low value in the model.
int	openValueColumn () const
	Returns the column of the open value in the model.
	Private (const Private &r)
	Private ()
QRectF	projectCandlestick (PaintContext *context, const QPointF &open, const QPointF &close, qreal width) const
	Projects a candlestick onto the coordinate plane.
QPointF	projectPoint (PaintContext *context, const QPointF &point) const
	Projects a point onto the coordinate plane.
	~Private ()

---

Function Documentation

int StockDiagram::Private::closeValueColumn

(

)

const

Returns the column of the close value in the model.

Returns:

The column of the close value

Definition at line 509 of file KDChartStockDiagram_p.cpp.

References StockDiagram::type().

Referenced by drawCandlestick().

{
    return type == HighLowClose ? 2 : 3;
}

void StockDiagram::Private::drawCandlestick	(	const CartesianDiagramDataCompressor::DataPoint &	open,
		const CartesianDiagramDataCompressor::DataPoint &	high,
		const CartesianDiagramDataCompressor::DataPoint &	low,
		const CartesianDiagramDataCompressor::DataPoint &	close,
		PaintContext *	context
	)

Draws a line connecting the low and the high value of an OHLC chart.

Parameters:

	low	The low data point
	high	The high data point
	context	The context to draw the candlestick in

Definition at line 314 of file KDChartStockDiagram_p.cpp.

References KDChart::ThreeDBarAttributes::angle(), KDChart::StockBarAttributes::candlestickWidth(), closeValueColumn(), KDChart::AbstractThreeDAttributes::depth(), KDChart::AbstractThreeDAttributes::isEnabled(), openValueColumn(), KDChart::PaintContext::painter(), projectCandlestick(), projectPoint(), and KDChart::ThreeDBarAttributes::useShadowColors().

{
    PainterSaver painterSaver( context->painter() );

    // Note: A row in the model is a column in a StockDiagram, and the other way around
    const int row = low.index.row();
    const int col = low.index.column();

    QPointF bottomCandlestickPoint;
    QPointF topCandlestickPoint;
    QBrush brush;
    QPen pen;
    bool drawLowerLine;
    bool drawCandlestick = !open.hidden && !close.hidden;
    bool drawUpperLine;

    // Find out if we need to paint a down-trend or up-trend candlestick
    // and set brush and pen accordingly
    // Also, determine what the top and bottom points of the candlestick are
    if ( open.value <= close.value ) {
        pen = diagram->upTrendCandlestickPen( row );
        brush = diagram->upTrendCandlestickBrush( row );
        bottomCandlestickPoint = QPointF( open.key, open.value );
        topCandlestickPoint = QPointF( close.key, close.value );
        drawLowerLine = !low.hidden && !open.hidden;
        drawUpperLine = !low.hidden && !close.hidden;
    } else {
        pen = diagram->downTrendCandlestickPen( row );
        brush = diagram->downTrendCandlestickBrush( row );
        bottomCandlestickPoint = QPointF( close.key, close.value );
        topCandlestickPoint = QPointF( open.key, open.value );
        drawLowerLine = !low.hidden && !close.hidden;
        drawUpperLine = !low.hidden && !open.hidden;
    }

    StockBarAttributes attr = diagram->stockBarAttributes( col );
    ThreeDBarAttributes threeDAttr = diagram->threeDBarAttributes( col );

    const QPointF lowPoint = projectPoint( context, QPointF( low.key, low.value ) );
    const QPointF highPoint = projectPoint( context, QPointF( high.key, high.value ) );
    const QLineF lowerLine = QLineF( lowPoint, projectPoint( context, bottomCandlestickPoint ) );
    const QLineF upperLine = QLineF( projectPoint( context, topCandlestickPoint ), highPoint );

    // Convert the data point into coordinates on the coordinate plane
    QRectF candlestick = projectCandlestick( context, bottomCandlestickPoint,
                                             topCandlestickPoint, attr.candlestickWidth() );

    // Remember the drawn polygon to add it to the ReverseMapper later
    QPolygonF drawnPolygon;

    // Use the ThreeDPainter class to draw a 3D candlestick
    if ( threeDAttr.isEnabled() ) {
        ThreeDPainter threeDPainter( context->painter() );

        ThreeDPainter::ThreeDProperties threeDProps;
        threeDProps.depth = threeDAttr.depth();
        threeDProps.angle = threeDAttr.angle();
        threeDProps.useShadowColors = threeDAttr.useShadowColors();

        // If the perspective angle is within [0,180], we paint from bottom to top,
        // otherwise from top to bottom to ensure the correct z order
        if ( threeDProps.angle > 0.0 && threeDProps.angle < 180.0 ) {
            if ( drawLowerLine )
                drawnPolygon = threeDPainter.drawTwoDLine( lowerLine, pen, threeDProps );
            if ( drawCandlestick )
                drawnPolygon = threeDPainter.drawThreeDRect( candlestick, brush, pen, threeDProps );
            if ( drawUpperLine )
            drawnPolygon = threeDPainter.drawTwoDLine( upperLine, pen, threeDProps );
        } else {
            if ( drawUpperLine )
                drawnPolygon = threeDPainter.drawTwoDLine( upperLine, pen, threeDProps );
            if ( drawCandlestick )
                drawnPolygon = threeDPainter.drawThreeDRect( candlestick, brush, pen, threeDProps );
            if ( drawLowerLine )
                drawnPolygon = threeDPainter.drawTwoDLine( lowerLine, pen, threeDProps );
        }
    } else {
        QPainter *const painter = context->painter();
        painter->setBrush( brush );
        painter->setPen( pen );
        if ( drawLowerLine )
            painter->drawLine( lowerLine );
        if ( drawUpperLine )
            painter->drawLine( upperLine );
        if ( drawCandlestick )
            painter->drawRect( candlestick );

        // The 2D representation is the projected candlestick itself
        drawnPolygon = candlestick;

        // FIXME: Add lower and upper line to reverse mapper
    }

    DataValueTextInfoList list;

    if ( !low.hidden )
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( low.index ), 0,
                                       PositionPoints( lowPoint ), Position::South, Position::South, low.value );
    if ( drawCandlestick ) {
        // Both, the open as well as the close value are represented by this candlestick
        reverseMapper.addPolygon( row, openValueColumn(), drawnPolygon );
        reverseMapper.addPolygon( row, closeValueColumn(), drawnPolygon );

        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( open.index ), 0,
                                       PositionPoints( candlestick.bottomRight() ), Position::South, Position::South, open.value );
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( close.index ), 0,
                                       PositionPoints( candlestick.topRight() ), Position::South, Position::South, close.value );
    }
    if ( !high.hidden )
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( high.index ), 0,
                                       PositionPoints( highPoint ), Position::South, Position::South, high.value );

    paintDataValueTextsAndMarkers( diagram, context, list, false );
}

void StockDiagram::Private::drawLine	(	int	col,
		const QPointF &	point1,
		const QPointF &	point2,
		PaintContext *	context
	)

Draws a line connecting two points.

Parameters:

	col	The column of the diagram to paint the line in
	point1	The first point
	point2	The second point
	context	The context to draw the low-high line in

Definition at line 441 of file KDChartStockDiagram_p.cpp.

References KDChart::ThreeDBarAttributes::angle(), KDChart::PaintContext::coordinatePlane(), KDChart::AbstractThreeDAttributes::depth(), KDChart::AbstractThreeDAttributes::isEnabled(), KDChart::PaintContext::painter(), KDChart::AbstractCoordinatePlane::translate(), and KDChart::ThreeDBarAttributes::useShadowColors().

Referenced by drawOHLCBar().

{
    PainterSaver painterSaver( context->painter() );

    // A row in the model is a column in the diagram
    const int modelRow = col;
    const int modelCol = 0;

    const QPen pen = diagram->pen( col );
    const QBrush brush = diagram->brush( col );
    const ThreeDBarAttributes threeDBarAttr = diagram->threeDBarAttributes( col );

    QPointF transP1 = context->coordinatePlane()->translate( point1 );
    QPointF transP2 = context->coordinatePlane()->translate( point2 );
    QLineF line = QLineF( transP1, transP2 );

    if ( threeDBarAttr.isEnabled() ) {
        ThreeDPainter::ThreeDProperties threeDProps;
        threeDProps.angle = threeDBarAttr.angle();
        threeDProps.depth = threeDBarAttr.depth();
        threeDProps.useShadowColors = threeDBarAttr.useShadowColors();

        ThreeDPainter painter( context->painter() );
        reverseMapper.addPolygon( modelCol, modelRow, painter.drawThreeDLine( line, brush, pen, threeDProps ) );
    } else {
        context->painter()->setPen( pen );
        //context->painter()->setBrush( brush );
        reverseMapper.addLine( modelCol, modelRow, transP1, transP2 );
        context->painter()->drawLine( line );
    }
}

void StockDiagram::Private::drawOHLCBar	(	const CartesianDiagramDataCompressor::DataPoint &	open,
		const CartesianDiagramDataCompressor::DataPoint &	high,
		const CartesianDiagramDataCompressor::DataPoint &	low,
		const CartesianDiagramDataCompressor::DataPoint &	close,
		PaintContext *	context
	)

Definition at line 243 of file KDChartStockDiagram_p.cpp.

References KDChart::ThreeDBarAttributes::angle(), drawLine(), KDChart::AbstractThreeDAttributes::isEnabled(), and KDChart::StockBarAttributes::tickLength().

{
    // Note: A row in the model is a column in a StockDiagram
    const int col = low.index.row();

    StockBarAttributes attr = diagram->stockBarAttributes( col );
    ThreeDBarAttributes threeDAttr = diagram->threeDBarAttributes( col );
    const qreal tickLength = attr.tickLength();

    const QPointF leftOpenPoint( open.key + 0.5 - tickLength, open.value );
    const QPointF rightOpenPoint( open.key + 0.5, open.value );
    const QPointF highPoint( high.key + 0.5, high.value );
    const QPointF lowPoint( low.key + 0.5, low.value );
    const QPointF leftClosePoint( close.key + 0.5, close.value );
    const QPointF rightClosePoint( close.key + 0.5 + tickLength, close.value );

    bool reversedOrder = false;
    // If 3D mode is enabled, we have to make sure the z-order is right
    if ( threeDAttr.isEnabled() ) {
        const int angle = threeDAttr.angle();
        // Z-order is from right to left
        if ( angle >= 0 && angle < 90 || angle >= 180 && angle < 270 )
            reversedOrder = true;
        // Z-order is from left to right
        if ( angle >= 90 && angle < 180 || angle >= 270 && angle < 0 )
            reversedOrder = false;
    }

    if ( reversedOrder ) {
        if ( !open.hidden )
            drawLine( col, leftOpenPoint, rightOpenPoint, context ); // Open marker
        if ( !low.hidden && !high.hidden )
            drawLine( col, lowPoint, highPoint, context ); // Low-High line
        if ( !close.hidden )
            drawLine( col, leftClosePoint, rightClosePoint, context ); // Close marker
    } else {
        if ( !close.hidden )
            drawLine( col, leftClosePoint, rightClosePoint, context ); // Close marker
        if ( !low.hidden && !high.hidden )
            drawLine( col, lowPoint, highPoint, context ); // Low-High line
        if ( !open.hidden )
            drawLine( col, leftOpenPoint, rightOpenPoint, context ); // Open marker
    }

    DataValueTextInfoList list;
    if ( !open.hidden )
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( open.index ), 0,
                                       PositionPoints( leftOpenPoint ), Position::South, Position::South, open.value );
    if ( !high.hidden )
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( high.index ), 0,
                                       PositionPoints( highPoint ), Position::South, Position::South, high.value );
    if ( !low.hidden )
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( low.index ), 0,
                                       PositionPoints( lowPoint ), Position::South, Position::South, low.value );
    if ( !close.hidden )
        appendDataValueTextInfoToList( diagram, list, diagram->attributesModel()->mapToSource( close.index ), 0,
                                       PositionPoints( rightClosePoint ), Position::South, Position::South, close.value );
    paintDataValueTextsAndMarkers( diagram, context, list, false );
}

int StockDiagram::Private::highValueColumn

(

)

const

Returns the column of the high value in the model.

Returns:

The column of the high value

Definition at line 489 of file KDChartStockDiagram_p.cpp.

References StockDiagram::type().

{
    return type == HighLowClose ? 0 : 1;
}

int StockDiagram::Private::lowValueColumn

(

)

const

Returns the column of the low value in the model.

Returns:

The column of the low value

Definition at line 499 of file KDChartStockDiagram_p.cpp.

References StockDiagram::type().

{
    return type == HighLowClose ? 1 : 2;
}

int StockDiagram::Private::openValueColumn

(

)

const

Returns the column of the open value in the model.

Returns:

The column of the open value

Definition at line 478 of file KDChartStockDiagram_p.cpp.

References StockDiagram::type().

Referenced by drawCandlestick().

{
    // Return an invalid column if diagram has no open values
    return type == HighLowClose ? -1 : 0;
}

StockDiagram::Private::Private

(

const Private &

r

)

Definition at line 206 of file KDChartStockDiagram_p.cpp.

Referenced by KDChart::CartesianCoordinatePlane::calculateRawDataBoundingRect(), KDChart::RingDiagram::clone(), KDChart::PolarDiagram::clone(), KDChart::Plotter::clone(), KDChart::PieDiagram::clone(), KDChart::LineDiagram::clone(), KDChart::LeveyJenningsDiagram::clone(), KDChart::Legend::clone(), KDChart::HeaderFooter::clone(), KDChart::BarDiagram::clone(), KDGantt::DateTimeScaleFormatter::operator=(), KDGantt::DateTimeGrid::paintDayScaleHeader(), KDGantt::DateTimeGrid::paintHourScaleHeader(), KDGantt::DateTimeGrid::paintMonthScaleHeader(), and KDGantt::DateTimeGrid::paintWeekScaleHeader().

    : AbstractCartesianDiagram::Private( r )
{
}

StockDiagram::Private::Private

(

)

Definition at line 201 of file KDChartStockDiagram_p.cpp.

    : AbstractCartesianDiagram::Private()
{
}

QRectF StockDiagram::Private::projectCandlestick	(	PaintContext *	context,
		const QPointF &	open,
		const QPointF &	close,
		qreal	width
	)			const

Projects a candlestick onto the coordinate plane.

Parameters:

	context	The context to paint the candlestick in
	low	The

Definition at line 233 of file KDChartStockDiagram_p.cpp.

References KDChart::PaintContext::coordinatePlane(), and KDChart::AbstractCoordinatePlane::translate().

Referenced by drawCandlestick().

{
    const QPointF leftHighPoint = context->coordinatePlane()->translate( QPointF( close.x() + 0.5 - width / 2.0, close.y() ) );
    const QPointF rightLowPoint = context->coordinatePlane()->translate( QPointF( open.x() + 0.5 + width / 2.0, open.y() ) );
    const QPointF rightHighPoint = context->coordinatePlane()->translate( QPointF( close.x() + 0.5 + width / 2.0, close.y() ) );

    return QRectF( leftHighPoint, QSizeF( rightHighPoint.x() - leftHighPoint.x(),
                                          rightLowPoint.y() - leftHighPoint.y() ) );
}

QPointF StockDiagram::Private::projectPoint	(	PaintContext *	context,
		const QPointF &	point
	)			const

Projects a point onto the coordinate plane.

Parameters:

context

The context to paint the point in The point to project onto the coordinate plane

Returns:

The projected point

Definition at line 222 of file KDChartStockDiagram_p.cpp.

References KDChart::PaintContext::coordinatePlane(), and KDChart::AbstractCoordinatePlane::translate().

Referenced by drawCandlestick().

{
    return context->coordinatePlane()->translate( QPointF( point.x() + 0.5, point.y() ) );
}

StockDiagram::Private::~Private

(

)

Definition at line 211 of file KDChartStockDiagram_p.cpp.

{
}

---