Contents
Login Register Wishes Forum About
Language Reference » Drawing functions » drawThresholdArea
Help topics
Latest updates
1147d  replaceImageMapTitle
1147d  replaceImageMapValues
1147d  createFunctionSerie
1147d  setAbsicssaPosition
1147d  negateValues
Toolbox
  Download as PDF
  Print this page
  Share this page
  Create an account
  Feed the updates!
Google AdSense
drawThresholdArea - Draw an area between two threshold

This function will draw an area between two threshold. Using areas can help you to highlight specific values. It is possible to tune the rendering by playing with the $Format array. To learn more about this please read the Format array guide.

By default, the area will be drawn using the 1st Y Axis (0) as reference. If you chart contains multiple Y Axis, please use the AxisID parameter of the format array.

Calling this function
drawThresholdArea($Value1,$Value2,$Format="");
Where :

Value1 is the value of the 1st threshold.
Value2 is the value of the 1st threshold.
Format is an array containing the drawing parameters of the arrow.

This function returns an array containing the Y position of the up & down boundaries of the area.

Customisation array - Tune up your area!

It is possible to customize the way your threshold will be rendered by playing with this array. Providing a detailled configuration is not mandatory, by default the line will be drawn dashed in red.

You can specify which axis you‘ll use to compute the value position in the chart area AxisID
You can specify the filled area color using R,G,B.
You can specify the filled area alpha factor using Alpha.
You can draw the area bordes setting Border to TRUE or FALSE.
You can specify the border color using BorderR,BorderG,BorderB.
You can specify the border area alpha factor using BorderAlpha.
You can specify the border tick width with BorderTicks.


Sample script



 $MyData = new pData();  

 /* Prepare some nice data & axis config */
 $MyData = new pData();  
 $MyData->addPoints(array(24,-25,26,25,25),"Temperature");
 $MyData->setAxisName(0,"Temperatures");
 $MyData->addPoints(array("Jan","Feb","Mar","Apr","May","Jun"),"Labels");
 $MyData->setSerieDescription("Labels","Months");
 $MyData->setAbscissa("Labels");

 /* Define the graph area and do some makeup */
 $myPicture->setGraphArea(60,60,660,190);
 $myPicture->drawFilledRectangle(60,60,660,190,array("R"=>255,"G"=>255,"B"=>255,"Surrounding"=>-200,"Alpha"=>10));
 $myPicture->drawText(350,55,"My chart title",array("FontSize"=>20,"Align"=>TEXT_ALIGN_BOTTOMMIDDLE));

 /* Draw the scale */
 $myPicture->drawScale(array("DrawSubTicks"=>TRUE));

 /* Draw two thresholds */
 $myPicture->setShadow(TRUE,array("X"=>1,"Y"=>1,"R"=>0,"G"=>0,"B"=>0,"Alpha"=>20)); 
 $myPicture->drawThresholdArea(5,15,array("R"=>226,"G"=>194,"B"=>54,"Alpha"=>40));

This example will draw an area between Y=5 and Y=15.
Last updated on 11/30/2009 
by Jean-Damien 
Linked resources
Community comments
  No comments have been posted yet.
© Copyrights
Components used on this web site : Famfamfam icons has been made by Mark James, Rounded corners lite has been coded by Cameron Cooke and Tim Hutchison, SyntaxHighlighter has been written by Alex Gorbatchev. pChart and this web site have been created by Jean-Damien POGOLOTTI. This documentation contains 185 pages and 55 comments. 800 users have registered. This page has been rendered in 0,04 seconds. Wiki revision 1.37.