Development/Tutorials/KPlotWidget - Revision history

Neverendingo: Text replace - "" to ""

2011-06-29T20:52:30Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:29:20Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:29, 29 June 2011
			
Line 22:
Line 22:
  Basic usage of KPlotWidget is illustrated with the following example:   Basic usage of KPlotWidget is illustrated with the following example:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  // Create a new KPlotWidget, provide a minimum size,     // Create a new KPlotWidget, provide a minimum size,  
  // and activate antialiased drawing:   // and activate antialiased drawing:
Line 56:
Line 56:
  The data points in a {{class|KPlotObject}} can be rendered in a number of ways: as discrete points, connected line segments, or bar-graph style rectangles.  In fact, the same KPlotObject can be rendered in any combination of these styles; here is an example of a KPlotObject which will be rendered with all three styles:   The data points in a {{class|KPlotObject}} can be rendered in a number of ways: as discrete points, connected line segments, or bar-graph style rectangles.  In fact, the same KPlotObject can be rendered in any combination of these styles; here is an example of a KPlotObject which will be rendered with all three styles:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  po = new KPlotObject( Qt::white, KPlotObject::Points, 10, KPlotObject::Pentagon );   po = new KPlotObject( Qt::white, KPlotObject::Points, 10, KPlotObject::Pentagon );
  po->setShowLines( true );   po->setShowLines( true );
Line 75:
Line 75:
  By default, the same {{qt|QPen}} and {{qt|QBrush}} will be used to render the Points, Lines, and Bars.  The color of the default pen and brush are set in the constructor.  However, it is easy to provide custom pens and brushes for the different plot styles:   By default, the same {{qt|QPen}} and {{qt|QBrush}} will be used to render the Points, Lines, and Bars.  The color of the default pen and brush are set in the constructor.  However, it is easy to provide custom pens and brushes for the different plot styles:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  // Modify the pen used to draw Lines connecting     // Modify the pen used to draw Lines connecting  
  // data points in this KPlotObject:   // data points in this KPlotObject:
Line 92:
Line 92:
  done like this:   done like this:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  // "plot" is a KPlotWidget containing several KPlotObject data sets,   // "plot" is a KPlotWidget containing several KPlotObject data sets,
  // each of which consists of several  KPlotPoints   // each of which consists of several  KPlotPoints
Line 125:
Line 125:
  Besides setting the colors of KPlotObjects (using KPlotObject::setPen(), setLinePen(), setBrush(), etc), you can also customize three color elements for the plot as a whole: the background, foreground and grid colors.  The functions for this are:   Besides setting the colors of KPlotObjects (using KPlotObject::setPen(), setLinePen(), setBrush(), etc), you can also customize three color elements for the plot as a whole: the background, foreground and grid colors.  The functions for this are:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  KPlotWidget::setBackgroundColor( const QColor& );   KPlotWidget::setBackgroundColor( const QColor& );
  KPlotWidget::setForegroundColor( const QColor& );   KPlotWidget::setForegroundColor( const QColor& );
Line 138:
Line 138:
    
  If you would like your plot to include a grid overlay, simply add:   If you would like your plot to include a grid overlay, simply add:
− <code cppqt>plot->setShowGrid(true)</code> + <syntaxhighlight lang="cpp-qt">plot->setShowGrid(true)</code>
  The grid lines are placed at the positions of major tickmarks along the Bottom and Left axes.   The grid lines are placed at the positions of major tickmarks along the Bottom and Left axes.
    
Line 157:
Line 157:
  The secondary data limits are stored internally as a QRectF, just like the primary limits.  To set the secondary limits, so something like:   The secondary data limits are stored internally as a QRectF, just like the primary limits.  To set the secondary limits, so something like:
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  plot->setSecondaryLimits( -5.73, 365.55, -1.1, 1.1 );   plot->setSecondaryLimits( -5.73, 365.55, -1.1, 1.1 );
  plot->axis(KPlotWidget::TopAxis)->setTickLabelsShown( true );   plot->axis(KPlotWidget::TopAxis)->setTickLabelsShown( true );



Tampakrap: addObject -> addPlotObject
2009-03-22T21:43:16Z
addObject -> addPlotObject

				
				
				
				
			
			← Older revision
			Revision as of 21:43, 22 March 2009
			
Line 44:
Line 44:
    
  // Add the KPlotObject to the plot:   // Add the KPlotObject to the plot:
− plot->addObject( sineobj ); + plot->addPlotObject( sineobj );
    
  // Add a text label to the bottom axis:   // Add a text label to the bottom axis:



LMCBoy: /* Providing Secondary Data Limits */
2007-04-24T00:13:00Z
‎Providing Secondary Data Limits

				
				
				
				
			
			← Older revision
			Revision as of 00:13, 24 April 2007
			
Line 148:
Line 148:
    
  === Providing Secondary Data Limits ===   === Providing Secondary Data Limits ===
  + 
  + By default, the top and right axes show the same tickmarks as the bottom and left axes.  However, it is possible to define secondary data limits for your data set which will be displayed on the top and right axes.
  + 
  + Why would one want to do this?  One possibility is shown in the example image at the beginning of this tutorial: you may want to express the data using two different units.  In the case of the example, we are plotting angles on the x-axis; the angles are shown in both degrees (top axis) and in radians (bottom axis).
  + 
  + In any case, bear in mind that the secondary data limits are not used for anything other than rendering the top and right axes; all internal calculations use the primary data limits only.  Also, no check is made to make sure that the secondary limits are actually mapped correctly to the primary limits.
  + 
  + The secondary data limits are stored internally as a QRectF, just like the primary limits.  To set the secondary limits, so something like:
  + 
  + <code cppqt>
  + plot->setSecondaryLimits( -5.73, 365.55, -1.1, 1.1 );
  + plot->axis(KPlotWidget::TopAxis)->setTickLabelsShown( true );
  + plot->axis(KPlotWidget::TopAxis)->setLabel("Angle [degrees]")
  + </code>
  + 
  + The first command tells the top axis to cover values -5.73 to 365.55, and the right axis to cover values -1.1 to 1.1.  The second command tells the plot to draw tick labels along the top axis, and the third command adds an axis label to the top axis.



LMCBoy at 09:08, 12 April 2007
2007-04-12T09:08:20Z


				
				
				
				
			
			← Older revision
			Revision as of 09:08, 12 April 2007
			
Line 28:
Line 28:
  plot->setMinimumSize( 400, 400 );   plot->setMinimumSize( 400, 400 );
  plot->setAntialiasing( true );   plot->setAntialiasing( true );
  + 
  + // Set the boundaries of the plot to display the full extent of the sine curve:
  + plot->setLimits( -0.1, 6.38, -1.1, 1.1 );
    
  // Create a KPlotObject which will display data     // Create a KPlotObject which will display data  
Line 143:
Line 146:
    
  If you need to restore the automatic calculation of the axis padding, you can set the padding of any axis to -1, or use setDefaultPaddings() to restore all four axes at once.   If you need to restore the automatic calculation of the axis padding, you can set the padding of any axis to -1, or use setDefaultPaddings() to restore all four axes at once.
−  
− === Providing Custom Data Limits ===  
    
  === Providing Secondary Data Limits ===   === Providing Secondary Data Limits ===



LMCBoy: /* The Padding Area */
2007-04-12T08:42:42Z
‎The Padding Area

				
				
				
				
			
			← Older revision
			Revision as of 08:42, 12 April 2007
			
Line 139:
Line 139:
    
  === The Padding Area ===   === The Padding Area ===
  + 
  + By default, KPlotWidget will automatically compute how much padding is needed outside of each Axis, to provide room for tickmark labels and/or the axis label, if they are present.  If you need to override these calculations, the padding on each axis can be set manually with the functions setTopPadding(int), setBottomPadding(int), setLeftPadding(int), or setRightPadding(int), where the argument is the size of the padding in pixels.
  + 
  + If you need to restore the automatic calculation of the axis padding, you can set the padding of any axis to -1, or use setDefaultPaddings() to restore all four axes at once.
    
  === Providing Custom Data Limits ===   === Providing Custom Data Limits ===
    
  === Providing Secondary Data Limits ===   === Providing Secondary Data Limits ===



LMCBoy: /* Showing a grid */
2007-04-12T08:33:53Z
‎Showing a grid

				
				
				
				
			
			← Older revision
			Revision as of 08:33, 12 April 2007
			
Line 133:
Line 133:
    
  === Showing a grid ===   === Showing a grid ===
  + 
  + If you would like your plot to include a grid overlay, simply add:
  + <code cppqt>plot->setShowGrid(true)</code>
  + The grid lines are placed at the positions of major tickmarks along the Bottom and Left axes.
    
  === The Padding Area ===   === The Padding Area ===



LMCBoy: /* Custom Colors for the Plot Area */
2007-04-11T22:26:55Z
‎Custom Colors for the Plot Area

				
				
				
				
			
			← Older revision
			Revision as of 22:26, 11 April 2007
			
Line 130:
Line 130:
  The background color is self-explanatory; its default is black.<br>   The background color is self-explanatory; its default is black.<br>
  The foreground color is used for drawing the axes and their labels; its default is white.<br>   The foreground color is used for drawing the axes and their labels; its default is white.<br>
− The grid color is used for drawing the optional grid on the plot (see the section in this tutorial); its default is grey.<br> + The grid color is used for drawing the optional grid on the plot (see the next section in this tutorial); its default is grey.<br>
    
  === Showing a grid ===   === Showing a grid ===





LMCBoy: /* Custom Colors for the Plot Area */
2007-04-11T22:26:29Z
‎Custom Colors for the Plot Area

				
				
				
				
			
			← Older revision
			Revision as of 22:26, 11 April 2007
			
Line 119:
Line 119:
    
  === Custom Colors for the Plot Area ===   === Custom Colors for the Plot Area ===
  + 
  + Besides setting the colors of KPlotObjects (using KPlotObject::setPen(), setLinePen(), setBrush(), etc), you can also customize three color elements for the plot as a whole: the background, foreground and grid colors.  The functions for this are:
  + 
  + <code cppqt>
  + KPlotWidget::setBackgroundColor( const QColor& );
  + KPlotWidget::setForegroundColor( const QColor& );
  + KPlotWidget::setGridColor( const QColor& );
  + </code>
  + 
  + The background color is self-explanatory; its default is black.<br>
  + The foreground color is used for drawing the axes and their labels; its default is white.<br>
  + The grid color is used for drawing the optional grid on the plot (see the section in this tutorial); its default is grey.<br>
    
  === Showing a grid ===   === Showing a grid ===



LMCBoy: /* Traversing All Data Points */
2007-04-11T21:16:19Z
‎Traversing All Data Points

				
				
				
				
			
			← Older revision
			Revision as of 21:16, 11 April 2007
			
Line 84:
Line 84:
  === Traversing All Data Points ===   === Traversing All Data Points ===
    
− Both KPlotWidget and KPlotObject provide functins that return   + Both KPlotWidget and KPlotObject provide functions that return  
  the list of KPlotObjects and KPlotPoints that they contain, so if     the list of KPlotObjects and KPlotPoints that they contain, so if  
  one needed to access all of the data points in the plot, it can be     one needed to access all of the data points in the plot, it can be

@@ Line 50: / Line 50: @@
 plot->update();
-</code>
+</syntaxhighlight>
 === Rendering Options for KPlotObjects ===
@@ Line 60: / Line 60: @@
 po->setShowLines( true );
 po->setShowBars( true );
-</code>
+</syntaxhighlight>
 Note that when constructing a KPlotObject which will be rendered as Points,
@@ Line 83: / Line 83: @@
 // KPlotObject:
 po->setBarBrush( QBrush( Qt::blue, Qt::BDiagPattern ) );
-</code>
+</syntaxhighlight>
 === Traversing All Data Points ===
@@ Line 100: / Line 100: @@
+     }
+}
-</code>
+</syntaxhighlight>
 === Labeling Data Points ===
@@ Line 129: / Line 129: @@
 KPlotWidget::setForegroundColor( const QColor& );
 KPlotWidget::setGridColor( const QColor& );
-</code>
+</syntaxhighlight>
 The background color is self-explanatory; its default is black.<br>
@@ Line 138: / Line 138: @@
 If you would like your plot to include a grid overlay, simply add:
-<syntaxhighlight lang="cpp-qt">plot->setShowGrid(true)</code>
+<syntaxhighlight lang="cpp-qt">plot->setShowGrid(true)</syntaxhighlight>
 The grid lines are placed at the positions of major tickmarks along the Bottom and Left axes.
@@ Line 161: / Line 161: @@
 plot->axis(KPlotWidget::TopAxis)->setTickLabelsShown( true );
 plot->axis(KPlotWidget::TopAxis)->setLabel("Angle [degrees]")
-</code>
+</syntaxhighlight>
 The first command tells the top axis to cover values -5.73 to 365.55, and the right axis to cover values -1.1 to 1.1.  The second command tells the plot to draw tick labels along the top axis, and the third command adds an axis label to the top axis.

← Older revision		Revision as of 00:13, 24 April 2007
Line 148:		Line 148:

	=== Providing Secondary Data Limits ===		=== Providing Secondary Data Limits ===
		+
		+	By default, the top and right axes show the same tickmarks as the bottom and left axes. However, it is possible to define secondary data limits for your data set which will be displayed on the top and right axes.
		+
		+	Why would one want to do this? One possibility is shown in the example image at the beginning of this tutorial: you may want to express the data using two different units. In the case of the example, we are plotting angles on the x-axis; the angles are shown in both degrees (top axis) and in radians (bottom axis).
		+
		+	In any case, bear in mind that the secondary data limits are not used for anything other than rendering the top and right axes; all internal calculations use the primary data limits only. Also, no check is made to make sure that the secondary limits are actually mapped correctly to the primary limits.
		+
		+	The secondary data limits are stored internally as a QRectF, just like the primary limits. To set the secondary limits, so something like:
		+
		+	<code cppqt>
		+	plot->setSecondaryLimits( -5.73, 365.55, -1.1, 1.1 );
		+	plot->axis(KPlotWidget::TopAxis)->setTickLabelsShown( true );
		+	plot->axis(KPlotWidget::TopAxis)->setLabel("Angle [degrees]")
		+	</code>
		+
		+	The first command tells the top axis to cover values -5.73 to 365.55, and the right axis to cover values -1.1 to 1.1. The second command tells the plot to draw tick labels along the top axis, and the third command adds an axis label to the top axis.

← Older revision		Revision as of 08:33, 12 April 2007
Line 133:		Line 133:

	=== Showing a grid ===		=== Showing a grid ===
		+
		+	If you would like your plot to include a grid overlay, simply add:
		+	<code cppqt>plot->setShowGrid(true)</code>
		+	The grid lines are placed at the positions of major tickmarks along the Bottom and Left axes.

	=== The Padding Area ===		=== The Padding Area ===

← Older revision		Revision as of 22:26, 11 April 2007
Line 119:		Line 119:

	=== Custom Colors for the Plot Area ===		=== Custom Colors for the Plot Area ===
		+
		+	Besides setting the colors of KPlotObjects (using KPlotObject::setPen(), setLinePen(), setBrush(), etc), you can also customize three color elements for the plot as a whole: the background, foreground and grid colors. The functions for this are:
		+
		+	<code cppqt>
		+	KPlotWidget::setBackgroundColor( const QColor& );
		+	KPlotWidget::setForegroundColor( const QColor& );
		+	KPlotWidget::setGridColor( const QColor& );
		+	</code>
		+
		+	The background color is self-explanatory; its default is black.<br>
		+	The foreground color is used for drawing the axes and their labels; its default is white.<br>
		+	The grid color is used for drawing the optional grid on the plot (see the section in this tutorial); its default is grey.<br>

	=== Showing a grid ===		=== Showing a grid ===