30 May 2003 JpGraph 1.12.2 ========================== * [me & A. Tang] Added support for Chinese font and character handling. This requires you to install the "simhei.ttf" Chinese font. * [J Sweat] Fix bug [#124] Make step line style ignore NULL values in data * [J Sweat] Fix bug [#123] Divide by zero for line length of zero for dashed lines * [me] Fix bug [#109]. Problem with pie color when a supplied color array contains more colors than data. For anti-aliased images that meant that the last n colors was used and not the first n colors. * [me] For plotmarks that use the ALT string the wrong value was in due to the recent addition of both Y and X value to control the plot callback. This has now been fixed so that it will work as before and that previous code that assumes one parameter in their ALT srting will see the Y-value at the plotmar. New is also that the X-value is given as a second parameter. This means that the ALT string can display both the Y and X value for a specific point. * [me] Make it possible to disable individual plot legends through the method Plot::HideLegend() * [me] Fixed problem with SetTextTickInterval() together with grouped bars (bug #116) * [me] Fixed a problem with shadows on accumulated bar plots (bug #111) * [me] Fixed Legend::SetMarkAbsSize() * [me] Add error check for the case that the server (Windows) doesn't support SystemRoot and TEMP server variables. * [me] Fix short-open-tags bug that made it's way into 1.12.1 (bug #121) * [me] Make sure we only pass integers into GD when positioning texts. * [me] Always treat "" (empty string) as NULL for bar plots * [me] Allow links from vertical position 0 on gantt charts 12 Apr 2003 JpGraph 1.12.1 ========================== * [me] Added Legend::SetLineSpacing() to control the vertical line distcance (in pixels) between legend texts. * [me] Compensate for bug in imagecopyresampled() in GD 2.01. This made clipping unusable with GD 2.01 * [me] Added LinePlot::SetFillFromYMin() to make the fill start from the bottom of a Y-scale with negative values rather than the 0-value which is now the case. * [me] Fix a problem with legend box layout in the case of TTF fonts and different lengths of individual texts. The layout engine now work out each column individually. This will also give the legend box the minimum possible size. * [me] Compensate for possible bug in strtok() when parsing color specification as a string with adjustment factors. 06 Apr 2003 JpGraph 1.12 ======================== * [me] Added possibility to specify the position of the legend box with absolute pixels coordinates not only as fractinos as before. * [me] Improved legend layout. It is now possible to specify the number of columns in the legend box. The preferred way of specifyin the layout is now Legend::SetColumns(). The oild way with SetLayout() is still available for backwards compatibility reasons. The old vertical layout corresponds to a 1 column layout (SetColumns(1) which is also the default). * [me] Added possibility to specify text string position using scale coordinates onto the plot by adding Text::SetScalePos(). The autoscaling has been modifyied to be aware of the text scale positions. * [me] Added builtin images for plotmarks. This also meant a refactoring exercise for the PlotMark class and it has now been split in sevaral files. * [me] Added footer capability to Radar, Pie and Gantt charts * [me] Improved upon rounding problem with GD2 and pie slices (defect #88) * [me] Take shadow color as specified with Graph::SetShadow() into account. * [me] Don't rotate the footer if the graph is rotated. * [me] Added Axis::HideLabels() * [me] Adjusted of the automatic margin calculation so that it is aware of when the x-axis have been hidden. * [me] Added PlotMark::SetCallbackYX(), This allows for the specification of a callback function which is given both X and Y coordinates. Also extended the returned values from the callback so that image in a marker can be dynamically modified both size and actual image file used. This will enable the use of advanced "push-pin" graphs. For example adding markers to a background image map of certain size and type. For backwards compatibility any callback specified with PlotMark::SetCallback() will not be given the extra parameter. So old code does not need to be changed. * [me] Fixed handling of PHP array URL parameters with CSIM. [Bug #82] * [me] Added Legend::SetFrameWeight() which adjusts the frame around the legend. Legend::SetLineWeight() now works as documented and sets the line weight for the markers instead. * [me] Autoscaling will now also take the value of added lines into account. * [me] Fixed problem with horizontal legend box becomming too small for many legends. * [me] Radar plot. SetColor() always sets a fill color. Fixed (Bug #83) * [me] Added SetWidth() for tab-title. The tab can now easily extend over the entire plot width. Added SetPos() as synonym in tab title for SetTabAlign(). * [me] Gradient bar plots now show a gradient mark in the legend * [me] PiePlot3D::SetSliceColors() now more correctly specifies the color anti-clockwise. The same order that slices are drawn. * [me] Pie position can now also be specified in absolute pixels in PiePlot::SetCenter() * [me] Added Bevel frame for entire graph * [me] Added possibility for some more advanced Graph title formatting through the Graph::SetTitleBackground() method. * [me] Type safe comparison in auto-detection of GD version * [me] Added Graph::SetCanvasColor() to specify the background color the canvas is initialized with. * [me] Fine tuned label positiong for pie labels and made 3D pies take the specified labels into account. * [me] Added Anti-aliasing to Pie charts. Looks good but it really slows down the pie generation. Enable by acalling PieGraph::SetAntiAliasing() * [me] Ignore NULL values in Stock and bar plots * [me] Some minor internal adjustments for rounding in log scales. 2 Feb 2003 JpGraph 1.11 ======================= * [Martijn] Compensate for GD 2.x bug in filledarc() which doesn't like negative angles. * [me] Added Graph::SetBackgroundGradient() . This allows a gradient to be used as a background. The gradient can either fill the whole frame, only the margin or just the plot area. See the class reference or the manual for details regarding this method. * [me] Modified adjustment factor for colors so that it now is linear between dark and light, i.e. a factor of 1 is the original color, a factor of 0 is black and a factor of 2 is white. * [me] Added two new gradient style GRAD_LEFT_REFLECTION and GRAD_RIGHT_REFLECTION * [me] Some fine tuning of text layout in legend box * [me] Radar plots can now have a background image and multiple titles (sub-title, and subsub title). Added RadarGraph::SetPos() as alias for RadarGraph::SetCenter(). * [me] Fixed a small pre-read-loop error which could casue the X-gridline to be outside the right edge of the plotarea if the X-scale was indented. * [me] Added possibility to use (scaled) images as markers by introductin the new mark type MARK_IMG. * [me] Added tab titles for graphs. See class reference and Example tabtitleex1.php. * [me] Added filled grids by adding method Grid::SetFill(). This new feature is illustrated in example filledgridex1.php. Documented in section 6.2.11 in the manual. * [me] Improved automatic margins so they adapt to one or more title lines automatically. * [me] Fixed a class hierachy bug. RotImage::DashedLine() should not be implemented but rather rely on the Image::DashedLine() since the rotation will happen in the RotImage::Line() which gets called in Image::DashedLine() by any istance of RotImage(). You could see the ffect of this by trying to create a 90 degrees rotated graph with dashed gridlines, they would appear not to be rotated at all where in fact they were rotated twice. * [me] Added automatic default margins when using Set90AndMargin() * [me] Added Box plots which is a variant of Stock charts with the possibility to add the median as a horizontal line in the box. * [me] Added Stock charts, (aka candle-bars) as new class StockPlot(). added example stockplotex1.php in the Example directory. * [me] Added two new axis styles AXSTYLE_YBOXOUT, AXSTYLE_BOXIN which suplicates the Y-axis on both sides but not the X-axis. * [me] Set90AndMargin() now also adjusts the label alignment on the axis to suit the rotation. * [me] Added class LineErrorPlot which alolows a line plot to have error bars (+/- delta error). * [me] Added Ticks::SetSize() * [me] Modified size for plot mark circle so it will have the specified width as radius and not as diameter. * [me] Added Ticks::SetSize() to be able to set the absolute size in pixels of the tick marks. * [me] Default directories for Fonts and Cache now gets set automatically. 13-Jan 2003 JpGraph 1.10.1 ========================== * [me] Fix bug in Band pattern Left diagonal and Right Diagonal where the drawing was incorrect when width < height * [me] Take the border on/off switch into account for line AddArea() * [me] Added color parameter to Axis::SetTickLabels() to make it possible to set individual colors on labels. * [me] Fixed PiePlot::SetSliceColor() so that colors are now specified in the same order as slices. * [me] Gantt, Radar and Canvas graph now also considers the special file _IMG_HANDLER (returns the actual image handler and doesn't stream picture back) * [Christian Reiser] Pie graphs can now also return the IMG_HANDLER * [Richard Black] Removed case sensitivity for extension of background images. Added support for handling file names with multiple '.' characters in the path for background images. * [me] Added error check for imagettfbbox() since it can give a file not found error even though both file_exists() and is_readable() reports that the file exists and is readable in the case when PHP basedir restriction is in place. * [me] Corrected CSIM handling in Gantt for non-file based Gantt charts. * [me] Note to self: 1.10p * [me] Gracefully handle the abnormal case where no valid data points is included in the Y-data array when creating a line plot. 16-Dec 2002 JpGraph 1.10 ======================== * [me] Added GanttGraph::CreateSimple() whihc is a utility method to help create simple gantt charts with a minimum of code. * [me] Added new plot (FieldPlot) type which handles field plots. This is basically a variant of scatter plots where each point is represented as an arrow which a specific direction (0-360 degrees). * [me] Added Graph::SetY2OrderBack() to control of plots on Y2 should be under (in z-order) te plots on Y. By default they are on top. * [me] Avoided a potential 1-pixel off rounding problem if a user supplies a non integer canvas width and height in the Graph() call. * [me] Added two new formats for week scale in Gantt charts. WEEKSTYLE_FIRSTDAYWNBR, WEEKSTYLE_FIRSTDAY2WNBR These formats adds the weeknumber as well to displaying the date of the start of the week. Also tweaked the auto-sizing of the Gantt charts to adjust for the size of the text in the week scale. * [me] Fixed wrong define in jpgraph_gantt.php for WEEKSTYLE_DAY2 (Bug #45) * [me] Improvements on manual scaling. If a manual scale is specifed (in the Graph::SetScale()) you are now longer required to specify a major and minior tick interval (but of course you can still do it with a call to Ticks::Set() ). A suitable intervall will be automatically caclulated in the same way as for autoscaling. By default the exact limits for the scale as specified will be used. This means that depending on the scale and tick intervall chosen the max value of the scale may or may not fall on a major tick mark. If you want that behaviour you need to call Scale::SetAutoTicks(). By using this call you give the algorithm permission to slightly adjust the specified min and max values (if needed) so that they wil fall on a even major step. * [me] Added error check if user tries to use SetTextLabelStart() with a logarithmic scale (where it is undefined). * [me] Default marker for scatter plots are now a filled square * [me] Adjusted the x-axis labelling for a 1-pixel off limit. Which sometimes (depending on the image size and scale) could cause a linear scale's last label not to be shown. * [me] Fixed bug report #40 * [me] Fixed positioning of caption for full odometers. (Bug #34) * [me] Fixed spelling mistake in jpgraph_odo.php which casued Odometer::SetLabelPos() to have no affect. (Bug #33) * [me] Fixed an overzeoulous optimization which skipped both rotation and translation for angle=0. Addresses (Bug #36) * [me] Colors can now include an alpha channel specification as well. The alpha channel is specified in the text string separated by a a '@' , for example "red@0.5". The alphachannel is specified as a fraction between 0.0 and 1.0. * [me] Improved filled line plots so they now handle negative values in a more standard way. * [me] Added automatic detection of what version of GD is installed. * [me] Aligned the order of legends and slices for pie and 3D pies so that they now follow the more common order of clockwise slices with legends from top to bottom. * [me] Changed call to deprecated function SetLinePos() to SetLineSide() * [me] Added clipping to generated plots. This means that if you have plots (for example lines) which extends outside the scale range it will be clipped. This might come in handy in for example balloon plots. Clipping is enabled by default but can be controlled by a call to Graph::SetClipping() * [me] Fixed a problem with circles and filled circles when they were rotated twice in a rotated graph. (Bugtraq #26) * [me] Added Graph::Set90AndMargin() which helps for doing a 90 degrees rotation and getting the margins right. (Otherwise you have to adjust them manually since height becomes width and width becomes height when you rotate 90 degrees) Changed the horizbar* examples to use the Set90AndMargin() * [me] Changed the behaviour of plot marks in legends. The possible format callback is no longer called. Instead the plotmarks are set to a default size. * [me] Added three more plotmarks MARK_LEFTTRIANGLE, MARK_RIGHTTRIANGLE, MARK_FLASH. These new types are primarily meant to be used with GanttCharts. * [me] Added constrain lines to GanttCharts. It is now possible to illustrate start-end, start-start, end-start and end-end constrains. This is illustrated by adding lines with arrows, Use GanttPlotObject::SetConstrain() * [me] Added Image map support for Gantt chart. Bar and titles can now have associated image map targets. Use GanttBar::SetCSIMTarget() GanttBar::SetCSIMAlt() and for titles use GanttBar::title::SetCSIMTarget() and GanttBar::title::SetCSIMAlt() * [me] Fix problem in Gantt graph whereby the progress bar indicator could extend over the end date if an explicit date scale was set. * [me] By default logarithmic scale now print the labels as 10^3 instead of 1000. You can change the behaviour with the new method for logarithmic ticks, SetLabelLogType(). Also added the possibility to have a callback for log scales * NOTE TO SELF 1.9p * [me] Added the possibility to specify a value > 1 as the position for labels in PieGraph::SetLabel() to increase the margin between the label and the edge of the pie. * [Olaf Kandel] Fixed subtle bug in the printing of the month scale for the case where the start and end month hjave the same number but are on different year. This would cause the width for the first month to be wrong. Jpgraph 1.9.1 ============= * [me] Fixed defects #20 and #21 (spelling mistake and and one overzelous last minute error check I added). I have to eat a lot of humble pie over these ones. Sorry to all who have been affected. What can I say? Human error........ JpGraph 1.9 =========== * [me] Changed the way TTF fonts are handled. The font files are no longer distributed with JpGraph due to potential copyright problem. This change also has the advantage that it is now very straigthforward to install new fonts whatever their naming conventions are. 1. If you are running on a standard Windows system just point the TTF directory to your standard font directory and use the available fonts in windows. 2. If you are on a Unix system you can download the MS Core TTF files from http://corefonts.sourceforge.net/. The old MS EULA allows distribution of the fonts in unaltered form (Win EXE) and this project exercises this right and provide tools to download and install the fonts on a UNIX system. * [me] Renamed this release from 1.8.1 to 1.9 due to the big change in the handling of TTF fonts which breaks backward compatibility due to the copyright problem with TTF fonts. * [me] Improved the TTF pargagraph layout engine for consistency in handling "\n\r" vs "\n". It is now always sufficient to use just "\n". * [me] Adjusted the text positioning for StrokeBoxedText() to use the new GetBBoxHeigh() and GetBBoxWidth(). * [me] Added Image::GetBBoxHeight(), Image::getBBoxWidth() * [me] Once and for all fixed the handling of rotated TTF text by adding Image::GetBBoxTTF() which returns the bounding rectangle (which is not the same as the bounding box except for angle==0) * [me] Added argument to Legend::SetColor() to make it possible to specify both frame and font color. * [me] Cosmetic adjustment of markers in legend so that they are positioned exactly in the middle of the text string. * [me] Corrected the positioning of TTF fonts when defining the hotspot as 'bottom'. It could be up to 4 pixel off when using texts that contained character that extended below the TTF baseline e.g. '('. * [me] Added possibility to use a cache system with CSIM images as well. The cache system is used slightly, slightly different and require a call to the new method Graph::CheckCSIMCache() This is unfortunately unavoidable due to the nature of CSIM in HTML. The documentation is updated to deal with this. This also added two more defines CSIMCACHE_DIR and CSIMCACHE_HTTP_DIR * [me] Added CSIM (Client Side Image Maps) to legends, added target and alt arguments to all Plot::SetLegend() * [me] Added functionlity to pass on any URL arguments when using StrokeCSIM() (Bug: #006) * [me] Fixed so that Gantt charts can again have just the width specified and have the height automtically sized. (This was a regression introduced in 1.8) (Bug #005) * [me] Added error check for return value from imaagecolorsforindex() in Anti-aliased lines. In combination with GD2, no-true-color, a true color background (ala JPG) this can fail since it gets a color which doesn't exist (since it uses imagecolorat()). * [me] Improved edges support in 3D Pies. * [me] Changed Image::Polygon() so i now draws an open polygon and not a closed one. * [me] Legends for scatter plots no displays the mark used for each scatter plot and not just a square with the correct color. * [me] Fixed a small cosmetic problem in that horizontal legend box was sometimes not wide enough and made a small adjustment of the positioning of marks in the legend box for better apperance. (Bug #0017) * [me] Improved manual by adding linked TOC. * [me] Added Bezier curve to canvas Shape class. Added Bezier canvas example canvasbezierex1.php * [me] Added Paragraph Alignment setting in Text::Align() as well to avoid seprate call to Text::SetParagraphAlign() * [me] Added Image::SetExpired() . By default the image now sends back a couple of variants of "no-cache" headers to force the browser to reload. * [me] Some serious speed improvments for 3D Pie plots. It can now be up to 6000% faster (yes that's right 6000%!). This is the way I had planned on doing it but for time reasons were pushed out of 1.8. I have completely changed the algorithm that handles the individual slices on the expense of a slightly more complicated implementation. This means that there is no performance difference between 2D and 3D Pie Plots. * [me] Fix bug for rotation of paragraphs (multi-line) texts. A limitation for now is that rotated pargraphs always gets paragraphs align "left". (Bug: #008) * NOTE TO SELF: 1.8p * [me] Fixed a typo that had the strange affect that paragraph strings which started with a number would have larger distance between the individual lines since that number would be interpretated as the angle for the text! * [me] Fixed a problem with marks getting out of sync if NULL values are present in the line plot. (Bug #0018) * [me] Scatterplot no skips NULL values instead of treating them as zero. * [me] Added LinearScale::SetAutoMax() as complement to SetAutoMin() * [me] Added LinearScale::SetAutoTicks() this makes it possible to manually set a scale but still have the tick marks automatically determined. By default this feature is off to keep old code behave exactly the same as before. If this is enabled any Ticks::Set() calls are ignored. * [me] Added possibility to adjust the position of the displayed value for bars via the BarPlot::SetValuePos() method. Added new example example20.5 to demonstrate this. * [me] Bugfix: Fixed color themes for 3D pie plot. The color array was not wrapped around in the case where more slices (data points) than colors is used. (Bug: #001) * [me] Documentation is now 100% pure HTML and does not require any PHP. Previously a PHP script was used to generate the highlighted source used in the image/source frames. All this is now pre-generated in the docs. * [me] Position the values in a scatter plot in the center of the plot mark by default (Setting align to 'center','center' and margin=0 * [me] Added LinePlot::SetBarCenter to make it possible to center the line on the bars when combining a plot with both bars and lines. The new example 'ceneterdlinebarex1.php' demonstrates this. [19-Sep-2002] JpGraph 1.8 ========================= * [me] Added Text::SetPos() as alias for Text::Pos() to harmonize with other setting methods. * [me] Made Graph::Add() polymorphic. You can now use Graph::Add() to add all plot objects and you don't longer have to use AddText(), AddLine(), AddBand() and so on. * [me] Added PiePlot::SetLabelPos(), added some more Pie examples. * [me] Improved the API for class Text by adding SetShadow() to make it more like the other objects. Extended Text::SetBox() with shadow width and corner radius. * [me] Added the possibility for Text object to use the new rounded rectangles as the filled background. * [me] Added possibility to add arbitrary labels inside the pie plot * [me] Added special filename __IMG_HANDLER to make it possible to have Graph::Stroke() return the image handler instead of stroking the image to file (or stream it back). * [me] Improve FilledCircle() to avoid moire-patterns in circle. * [me] Added middle type pie plot * [me] User specified values for the band position is truncated to the min and max values of the axis. * [me] Added possibility to use Text::SetMargin() for all the titles in a graph * [me] Added SetSize() as synonym for SetWidth() for plot marks. * [me] Updated some of the examples with more comments. * [me] Fixed problem with with jpg background images wrongly being loaded with imagecreatefromjpg instad of imagecreatefromjpeg * [me] Corrected the positioning of individual titles for 3D plots. * [me] Added Text::SetMargin() to make it easy to have context sensitive margins. * [me] Added capability to have background images on Pie and 3D Pie plots * [me] Added method Axis::HideLine() which hides the axis line but nothing else. * [me] Fixed bug in Stroke::Text() where negative coordinates wasn't properly handled. We must allow negative absolute coordinates since these might be rotated/translated into "real" screen coordinates. This fixes the bug, for example in bar_csimex1.php where the first value of the bar wasn't displayed. * [me] More adjustment of how the rounding takes place with coordinates. This should now avoid all potential difference between different graphic objects. * [me] When you use automatic labelling on text scale it now starts at 1 and not at 0. This makes more sense since most people (except mathematicians) start counting from 1. * [me] Example directory: - Added more advanced canvas examples - Updated all CSIM examples - ~60 new example script which are used in the new documentation * [me] Compensate for bug in imagettfbox() which return to small size for large fonts. * [me] Added jpgraph_canvtools.php which contain some utility classes for use with canvas graphs. * [me] DOCUMENTATION: The class reference is now included in the release. * [me] DOCUMENTATION: Completely rewritten the original Word-introduction to JpGraph to pure HTML. This will be a living document that will be updated as time moves on. This is currently considered "Beta" and more chapters need to be added but this is a good start!! * [me] Added full support for multiline legends. (See for example nullvalueex01.php. Also improved the way lineplot with marks are illustrated in the legend by adding the line underneth the plotmark. * [me] Added some utility classes to be able to draw DB schema for DDDA. This is tailored for my DB abstraction layer (jpdb.php) in DDDA but is generic enough to work in other circumstances as well. The classes can be found in utils/misc/imgdbschema.inc Please see (run) dbschema_ddda.php which shows how it looks in a real life example. * [me] Tweaked the positioning of TTF fonts and how the width and height are determined. Making more carefull assumptions about how the baseline is handled for individual lines of text. * [me] Added class RectangleText() which makes it easier to work with text inside a rectangle with rounded corner. * [me] Added support for multi-line TTF paragraphs with paragraph formatting. This was previously only supported for the builtin fonts. All text object should now support fully formatted paragraphs of text. * [me] Added Image::RoundedRectangle() and Image::FilledRoundedRectangle() * [me] Added format callback to plot marks. This makes it possible to individually adjust the plot marks depending on it's specific data value. See balloonex1.php * [me] Added some initial support for super script used for scientific numbering, i.e properly print for example 10^2 where the 2 is in superscript. This is all handled by the new class SuperScriptText(). Not yet used in the actual labels drawing but will be added shortly. * [me] Added a small tool mkgrad.php in the utils directory to make it a breeze to create gradient squares which may be used as background images. * [me] Added footer class to graph. This makes it easy to have left,center and right footers in your graphs. * [me] Added subsubtitle to graphs * [me] Improved/Changed the way you work with CSIM. This new method makes it possible to generate CSIM without having to create an intermediate image on disk. Added Graph::StrokeCSIM(). Added new chapter in the docs on how to work with CSIM * [me] Changed naming of Spider* to Radar* since SpiderGraph is a copyrighted name. * [me] Modified the automatic suppression of the first value of the X-axis when the Y-axis have negative value so it don't happen in the case where the X-axis is positioned at the minimum of the Y-axis. * [me] Fixed spelling error of BK* instead of the correct BG* for the default settings of background image style. * [me] Some internal code changes to RGB() class to make it easier to use directly for external scripts. * [me] Changed the behaviour of filled line plot so that they don't go down to 0 for null values in the plot but instead behaves like '-' for non-filed plots, just ignore them and connect the previous and next point instead. * [me] Fixed problem in integer scaling where it certain scale combinations could generate floating point labels! Ooops.. (Affects IntCalcTicks()) [5-July-2002] JpGraph 1.7 ========================== * [me] Removed the APACHE_CACHE_DIRECTORY define since it is not used. * [me] Added Image map functionlity for rotated bar graphs, also added new example for this (bar_csimex3.php) * [me] Made Ticks::SetPrecision() deprecated. Use SetFormatString() instead * [me] Fixed problem with incorrect string being returned from ToCyrillic() * [me] Allow Y2 axis to use "int" scale * [me] Fixed problem with wrongly names framework function for patterns * [me] Fixed small problems with margins being slightly off for roated images. * [me] Changed name of PlotMark::SetMarkColor() to PlotMark::SetColor() for consistency * [me] Added example with "hidden" Y-axis. [17-June-2002] JpGraph 1.7-BETA =============================== * [me] Added DisplayValue::SetFormatCallback() to make it possible to use a user specified formatting callback routine. (Note:: Yes, this is very nono-OO but the proper OO way, by forcing the user to define a subclass of the plot class where the formatting method is overridden will probably not fly with to many non-OO PHP peoples since a callback is conceptually simpler.) * [me] Added DisplayValue::HideZero(). Makes it possible to hide zero values in labels, for example zero slices in pie's, (e.g. $pieplot->value->HideZero()) * [me] Added manual scaling to Gantt graphs, added example to illustrate this, fixscale_gantt.php * [me] Adding image maps for Y2 scale as well. * [me] Fixed a small bug which made it impossible to use BRAND_TIMING with Gantt charts. Enabling timestamping of graphs would give a "PlotArea to small" error. * [me] Made a very small change to the AutoScaling algorithm to yield tighter boundaries, i.e with the existing algorithm, depending on rounding problems a plot which had a maximum value of, say 4, could get a autoscaling max value of 5. Not a big problem (or hardly a bug) but not what I wanted. All my 111 test cases works fine with the modification but I'm still not convinced that this (very minor) adjustment is 100% (I can distinctly remember that I had a good reason to do it the original way, I just can't remember what :-) * [me] Graph titles may now have multiple rows. By default the lines will be centered, but this may of course be adjusted by a call to, for example, $graph->subtitle->ParagraphAlign('left'); * [me] Added class FuncGenerator() to make it easy to generate function plots (both normal and polar). To illustrate this I have added three new examples funcex1.php,funcex2.php,funcex3.php. * [me] Added Axis::HideFirstLastLabel() to hide first and last label on axis. This is usefull if we have a box around the plot area and we don't want the labels to owerwrite the box (see funcex1.php) * [me] Make sure GD2 variables is registred in $GLOABALS[] * [me] Fixed bug in image maps for marks. Alt strings was incorrectly indexed so it was only using values 0,2,4.. instead of 0,1,2,... * [me] Added Graph::SetAxisStyle(). This makes it easy to use a few number of preset axis setup. For example duplicating the axis as a border around the plot. Preset axis position availabel are AXSTYLE_SIMPLE, AXSTYLE_BOXIN, AXSTYLE_BOXOUT * [me] Made Axis::SetTickLabelMargin() deprecated. Use Axis::SetLabelMargin() instead. Name change to make it more consistent with the other margin settings. * [me] Made Ticks::SetSide() a synonym for Ticks::SetDirection() to make it consistent with side setting for labels and values. * [me] Added Axis::HideZeroLabel() as a shortcut for axis->scale->ticks->SupressZeroLabel() * [me] Internal code changed. Replace the use of FontProp in SpiderGraph with Text() and some additoinal code cleanup. * [me] Adjusted Image::Arc() so that no negative angles are passed on to GD imagearc() since it barfs at negative angles. * [me] Added PiePlot3D::SetHeight() which is used to specify the height in pixels of the 3D pies instead of using the default height. * [me] Pie plots (both 2D and 3D) now displays the slice labels by default. * [me] Added two more Examples. barintex1.php shows how to use integer scale and barscalecallbackex1.php shows how to use a callback function for formatting the scale. * [me] Modified grace calculation for Integer scale to have higher sensitivity. * [me] Restructured code so class DateLocale is now in jpgraph.php rather than in jpgraph_gantt.php. Also added $gDateLocale as a global instance of the class DateLocale * [me] Modified integer autoscale to correctly handle very small values (needs special handling of max==1 to avoid fraction) * [me] Changed the way min value is extracted when finding the baseline for bar plots. Now uses the function Scale::GetMinVal() instead of reading the value directly fomr the instance variable. This makes it work better with logscales so that the bar starts from the min value of the log scale. Also added check in bar PreStrokeAdjust() to see if we are using a log Y-scale to automatically adjust the Y-base. * [me] Optimized Stroke() loop for LinePlot so calls to PlotMark::Stroke() will only be done if the marks are really to be shown. * [me] Added Axis::SetLabelAlign(). * [me] Made some internal modifiaction on how Axis title gets aligned to make it possible to specify it manually without having it automtically set. This makes it possible to generate nice horizontal bar graphs. * [me] Added three examples in the Example directory on how to make horizontal bar graphs. * [me] Don't always set Y-axis position automtically * [me] Add Text::SetAngle() as synonym for SetOrientation() Added SetLabelSide() as synonym for SetlabelPos() * [me ]Make it possible to manually specify the alignment of the textstring for the title position. This makes title looks nicer with horizontal bar graphs. * [me] Allow Y-axis labels to be at an angle [14-May-2002] JpGraph 1.6.3 =========================== Changes/Additions: * [me] Added functionality to make AccBarPlot::SetAbsWidth() work in jpgraph_bar.phps * [me] LinePlot::SetColor() no longer sets the color of the plotmark. The problem that some people had was that if you set the mark color specifically first and then unsuspecting called SetColor() for the line the color for the plotmark circumference would also be set making it look like the PlotMark::SetColor() didn't work. * [me] Improved the functionality of GanntGraph::SetDateRange() to make it possible to display a section of the graph. (In previous version it was a checked error if you tried to plot a graph where any activity bar was outside the specified area. This is now changed to only cap the bars to the area. This makes it more suitable to handle big gantt charts which now can be split into several images to show different parts of the projects) * [me] Added GanttScale::SetWeekStart() to set the start of week to an arbitrary day. For example SetWeekStart(0) will make the weeks start on Sunday, SetWeekStart(1), Monday and so on. * [me] Fixed a rounding error in Gantt chart that could cause the week start day to off by one. * [me] Modified the Min() and Max() methods for AccLineBar's to avoid them overestimating the max value. (Basically now using the same methods as in AccBarPlot) * [me] Added missing code to do percentage calculation for 3D Pies so they work the same way as the 2D Pies. * [me] Added error check for the case where the image is so small that the available plot area becomes to small. * [me] Compensate for a PHP bug (#12474) in strtotime() which can affect Gantt chart so that the same month name is shown twice. See http://bugs.php.net/bug.php?id=12474 * [me] Compensate for the documented shortcomming in my 3D Pie algortitm whereby a small exploded slice close to 270 degrees get's slighthly nagged at tha base due to the fact that the z-order stroking algorithm is only perfect if the slices are not exploded. [20-April-2002] JpGraph 1.6.2 ============================= Changes/Additions: * [me] Slightly adjusted LinearTicks::Stroke() to better handle som potential rounding problems. * [Thomas George] Added LinePlot::AddArea() which makes it possible to just fill part of a line plot (a part that is specified with a start and end x-point) * [Thomas George] Fixed bug with missing coordinate when using filled line plot with step style. * [me] Added client side image maps to scatter and line plots * [me] Fixed problem with warning "IMG_ARC_CIRCLE not defined" when running on GD 1.x * [me] Removed test with is_null() in jpgraph.php to make JpGraph 1.6.2 work with older versions of PHP (especially 4.02). [07-April-2002] JpGraph 1.6.1 ============================= Changes/Additions: * [me] Modified autoscaling for the case where all values are equal to make the min/max difference larger. * [me] Fixed bug in 3D pies for certain data values * [me] Fixed bug with images maps assuming that slices where order anti-clockwise and the new pie algorithm did them clockwise. * [me] Added subtitle to Pie and Pie3D graphs. [02-April-2002] JpGraph 1.6 =========================== Changes/Additions: * [me] Changed license to QPL * [me] Completely rewritten algorithm for 3D pies which gives MUCH better result. Will also allow exploded 3D pies. * [D. Reinbach] Better handling of filling line plot with negative values * [me] Added LinePlot::StrokeDataValue() for easy handling of plotting data point values. * [Gyozo Papp,me] Real locales for Gantt chart. The locales now take a proper locale string (e.g. "en_UK", or "sv_SE") to get the real locales from the system. Note that this breaks the sc compatibility * [me] Removed jpgraph_dir.php and moved the directory settings back in jpgraph.php due to problems in PHP with nested includes and search paths. * [me] Added possibility to show values for scatter plot by refactoring value support back into jpgraph.php Plot() class. This makes it easy for all subclasses that uses Plot() to add display value support. * [me] Added possibility to use X-coordinates in Error plots * [me] Fixed missing LogScale::SetXLabelOffset(). This made it impossible to use linear plots with a log x-scale !!! * [me] Fixed bug so possible Y2 plots are also taken into account when auto scaling the X-axis. This could otherwise couse plots outside the scale when using Y and Y2 plots where Y2 plots had more data values. * [me] **********!!SC BREAK!!************** Aligned the way values are displayed on Bar graphs with line and scatter plots. The values to be displayed for these plots are now all accessed through the "value" property of the plot. For example $myBarPlot->value->Show(); instead of the previous $myBarPlot->ShowValue(); * [me] **********!!SC BREAK!!************** Aligned the way values are displayed in Pie plots with line and bar plots. You know use the "value" property in exactly the same way as in bars and lines. * [me] **********!!SC BREAK!!************** Aligned the way values are displayed in 3D Pie plots with line and bar plots. You know use the "value" property in exactly the same way as in bars and lines. * [me] Added possibility to display individual values in an accumulated bar graph in addition to the overall accumulated value. This is done as usual through setting the individual bars value property to what you want (size, color, format and so on) * [me] Added another default error handler which is image based to make it easier to see error messages when images are included in a page. This is now the default error handler. * [me] Added possibility to specify the location of the X-Axis to the top of the graph by using xaxis->SetPos("max") also added new Example topxaxisex1.php to demonstrate this feature. * [me] Added more 3D pie examples to demonstrate new functionlity. [01-March-2002] JpGraph 1.5.3 ============================= Changes/Additions: * [me] Make it possible to use JpGraph 1.5.3 with GD 1.8.x. In 1.5.2 I was using a function only available in GD 2.x. [29-Feb-2002] JpGraph 1.5.2 =========================== Bug fixes: ---------- * [me] Released the correct 3D pie file (By mistake I mixed the stable version with the development branch for 2.0 in the 1.5.1 release just to prove that I'm still human :-) * [me] Fixed out of bounds error when using shadows for bar graphs with 0 value * [me] Fixed typo in DisplayValue::SetFormat() * [me] Fixed potential array out of bounds error in Plot::Min() and Plot::Max() * [me] Fixed misplaced ')' in string construction in call to JpGraph error. Changes/Additions: ------------------ * [me] Added possibility to use "auto" file name when stroking directly to a file. * [me] Added tag 'title' to the image maps to make for better compatibility with Mozilla. * [me] Moved class LineProprty to jpgraph.php from jpgraph_gantt.php since it can be used in other modules as well. * [me]Added Text::GetTextHeight() which differs from Text::GetFontHeight() in that it takes the total text height (possible multiple lines) into account. * [me] Added Image::FilledArc() * [me] Added RotImage::SetTranslation() Added RotImage::Circle() Added RotImage::FilledCircle() Added RotImage::Arc() Added RotImage::FilledArc() [11-Feb-2002] JpGraph 1.5.1 =========================== * [me] No longer treat a not set $y[0] value as an explicit error. Instead silently set $y[0] to 0. * [me] Changed "include" to "require" in jpgraph.php when including jpgraph_dir.php. This seems to fix the strange problem whereby the constants defined in jpgraph_dir.php didn't have a correct value in jpgraph.php. * [me] Fixed problem with correctly drawing of bars when all bars are negative. (Previously the baseline wasn't correctly handled since min/max values needs to be mirrored for negative bars) Note: Funny this problem has gone unnoticed so long. * [me] Fixed problem with doing gradient fill for negative bars. * [me] Fixed problem with autoscaling when there is a very small difference (< 0.00001) between min and max and when both min and max are negative. This might happen if you have a single negative value. * [me] Added labels for line graph. Each point my now also optionally display it's value on a line graph. Value are controlled trough class DisplayValue and it's instance in LinePlot. LinePlot->value->Show(), LinePlot->value->SetColor(), LinePlot->value->SetFont(), LinePlot->value->SetMargin(), LinePlot->value->SetFormat(), [27-Jan-2002] JpGraph 1.5 ========================= * [me] Fixed misnamed xmin variable in Min() for acc bars * [me] Added possibility to specify paragraph alignment for multi line text, i.e the text can be left,right or center aligned within it's bounded box. The lignment is set by the new method Text::ParagraphAlign() * [me] Changed position specification for text so that if the position is specified in range [0,1] it is interpreted as fraction of image height width and otherwise as absolute pixels. * [me] Added possibility to specify pie size (radius) both as a fraction and absolute size in pixels. * [me] Added possibility to tweak color specification by adding a saturation percentage, i.e you can specify color as "red:0.65" which means 65% of the red value (in other words 35% darker). * [me] Tweaked the estimation of number of segments to approximate an arc in Image::CakeSlice. [17-Jan-2002] JpGraph 1.5beta2a =============================== * [me] Fixed typo in Max() calculation for accumulated bar graphs which caused it to return wrong value. * [me] For Min() calculation for acc bars graphs take the user specified ymin into account. * [Peter Svistunov, me] Added Cyrillic unicode support through the global define LANGUAGE_CYRILLIC. This is also the start of a generic support for Unicode languages through the LanguageConv class. [15-Jan-2002] JpGraph 1.5beta2 ============================== * [me] Rewrite of the pie-chart drawing algorithm. This version is slightly slower but avoids using GD floodfill function. This fixes problems with small slices not being filled completely. As an added bonus it is now possible to explode (and specify the explode radius) for all slices. It is also possible to draw the pie without having internal borders between the slices as well as turning on/off the border surronding the pie. * [me] Added graphic primitive CakeSlice() to the Image class. Used to simplify pie-drawing. * [me] Added more generic error handling. It is now possible to install your own error object with JpGraphError::Install() The default error handler will just abort execution. * [me] Security whole in utility script for displaying source and image in frames fixed. * [Cedric Scheyder] Actively ignore hours in calculating Max/Min values for dates in Gantt charts to avoid problems in autoscaling when users specify start and end dates down to hours. * [Rick Widmer] Fixed problem in calculating min/max value when first Y-value was non-numeric. * [me] Fixed calculation of width and height of text with multiple lines. Multiple text lines (text blocks) should now be almost fully supported. [16-Dec-2001] JpGraph 1.5-BETA ============================== * Take "\n" into (some) account when calculating string height and width Text output now supports multiple lines better. * [me] Removed reference to global PHP_SELF, use HTTP_SERVER_VARS array instead. This makes JpGraph working with 'register_globals' turned off. * [me] Added some rudimentary check that GD is enabled before trying to run JpGraph. * [me] Fixed silly cut-and-paste bug in AccBarPlot::Max() which could cause to small max values to be returned * [me] Added property 'title' to PlotMark. The title is printed in the center of the plotmark. * [DanNY (dulcis28@hotmail.com)] Added JpGraph Logo. (Thanks!) * [me] Added jplintphp.php, jpgendoc.php, jplintdriver.php which are parsing, documentation and pretty printing tools I use to help me to documentation and find unused code. Tthat does some simple static analysis on PHP for silly mistakes that I do (Like using instance variables without qualifying them with "$this->" ) The tool also warns about unused instance variables. Since it also parses the classes and methods I use it to generate the documentation skeleton for the reference section. * [me] Added Gantt chart funcionality, jpgraph_gantt.php . See Gantt tutorial for help on usage. * [me] Added new Gantt tutorial * [me] Added BKIMG_CENTER, possibility to center the background image. * [me] Timeout function now also aplies when you generate an image off-line, i.e if the imagefile exist and is within the time window now file will be written. * [Rasmus Lerdorf] Added patch to make background images work with GD 2.x N.B GD 2.01 has bugs in handling TTF font with truecolor images which are fixed in 2.02 but that has (of this writing) still not been officially released. GD 2.x support in JpGraph is still to be considered experimental. * [me] Fixed some potential rounding errors in 2D Pie plot which in some circumstances might have caused a flood fill to escape. Also added check to better handle very small slices so we don't try to do a fill on the border edge. * [me] Slightly changed the internal design for band patterns. They are now created by a factory class instead. This makes it much easier to re-use and have maximum code reuse. * [me] Factored out some functionlity from Graph::Stroke() to make it possible to re-use some code in GanttGraph::Stroke() * [me] One more instance when PHP surprised me by thinking 0 == "-" aarrghhh Now I think (knock on wood) all problems with data points=0 should be solved * [me] Added '&' to the assignment in Graph::Add() This now lets you specify changes for lines, plots even after they been added to a Graph. But I'm not sure if this is really such a good ide because you will have problem if you write code like for( .... ) { $myplot = new LinePlot(.....); $graph->Add($myplot); } Since this will not work the way you think (why?) Because the same reference to the variable $myplot will be used for all additions and hence the graph will only have multiple instances of the last added LinePlot(). Have to think of this and what is the best way. (I will probably never get used to PHP references....) [11-Nov-2001] JpGraph 1.4 ========================== Bug Fixes: ------------------------------------------------------------------------------------- * [me] Enabled E_NOTICE warnings in my PHP installation and found a couple of glitches (harmeless out-of-bound in two loops) which is now corrected. * [me] Fixed problem in line plots where y-value==0 wasn't drawn. (Once again bitten by the fact that in PHP the following is true: ""==0) * [me] Fixed color specification for bars when initialized as an array of colors * [me] Fixed color of bars using shadow which was advertedly set to shadow color * [me] Fixing incorrect color specification for legends using bars with color arrays * [me] Add check for sum=0 in pie plots to avoid divide by 0 problem * [me] Changed the stroke orderd for FilledRectangle() so that the shadow doesn't overwrite a line with weight > 1 * [me] Fixed incorrect calculation of font height for titles which cause the subtitle to be to close to the title. Additions: ------------------------------------------------------------------------------------- * [me] Added depth parameter (DEPTH_FRONT, DEPTH_BACK) for gridlines Graph::SetGridDepth() * [me] Added possibility to add static horizontal and vertical band with a pattern in the plot area. Graph::AddBand() Supports solid, diagonal, stright line, 3D-plane crosses (both diagonal/vertical) patterns. Graph::AddBand() * [me] Added possibility to have static lines in the plot. This is now implemented with new class PlotLine and two new functions Graph::AddLine(), * [me] Added symbolic constants to specify background image types BGIMG_COPY, BGIMG_FILLPLOT, BGIMG_FILLFRAME * [me] Added extended label formatting through either Axis::SetLabelFormatString() C-style formatting string or Axis::SetLabelFormatCallback() A callback function that are given the value to be displayed and should manipulate the value as it likes The use of the old style digit precision variable will be deprecated from next version. * [me] Added error check if supplied Y-data has unspecified value at index 0 to avoid out of bounds error when corrupted data is sent in to JpGraph. * [me] Added possibility to specify image depth for gridlines. You can now specify Graph::SetGridDepth() as DEPTH_FRONT or DEPTH_BACK. Depending on if you want the gridlines at the back of in front of your plots. * [me] Added possibility to specify Cache file name as "auto". In this case the image file name will have the same name as the scriupt that generates the image with the extension of the automtically generated graphic format. NOTE: You will get the wrong extension using this feature at the same time as specifying a different graphic format thne the automatically choosen one. * [me] Added some more advanced examples for impuls drawings impulsex3.php and impulsex4.php * [me] The values on top of bars can now be at an angle and the horisontal position now account for if a shadow is present. * [me] Added filename to Graph::Stroke() which makes it easy to output an image directly to a file _without_ streaming it back to the browser. Usefull for batch processing * [me] Added new tutorial for bar graphs * [me] New scale type "int". This gives a normal linear scale but restricts ticks (and labels) to integer values. Can be used for both X and Y scales. * [me] Added subtitle to graph * [me] Added possibility to specify an array of X-coordinates with bar plots to position individual bars on the X-scale. Makes it much easier to combine bar plots with other types of plots, (line, scatter etc) * [me] Extended utility adjimage.php to allow it to manipulate color saturation. * [me] Added Image::AdjSat() to allow manipulation of the color saturation in the image. This also makes it very easy to change the image to greyscale (just set saturation=-1). Extended Graph::AdjImage() and Graph::AdjBackgroundImage() to include new parameter for saturation value. * [me] Added BarPlot::SetAlign() which makes it possible to align bars relative the tickmark for linear and int scale * [me] Added possibility to absolutely set the width of bars. This will override the automatically decided with based on the scale and tick distance Changes: ------------------------------------------------------------------------------------- * [me] Legend color for scatter plots now becomes the fill color of the mark * [me] Impulsplots now anchors at Y-value = 0 if the y-axis contains both negative and positive values. Otherwise it will go to the lowest value on the Y-axis. * [me] Bar shadows is now connected to bars to make for a stronger 3D effect. * [me] Removed all deprecated references and usage of FONT0, FONT1, FONT2. Note You can no longer use these. Instead use FF_FONT0, FF_FONT1, FF_FONT2 etc * [me] Text scale now starts default labelling at 0 * [me] All plots internally adjusted to start at default X-coordinate 0 to harmonize better with X-scale. * [me] Graph->Stroke() now just returns instead of exit() * [me] Removed flag argument for BarPlot::SetShadow() * [me] Bar plots are know by default filled with lightblue unless otherwise specified. * [me] Changed the way bars are positioned for linear and integer scale for maximum flexibility when mixing barplot with other plots. * [me] The ALT strings for all image maps now uses printf() syntax to display the actual value. If you have used this feature you must update your ALT strings, for example "val=%v" must become "val=%d" or whatever format you choose. * [me] Changed the formatting of bar graphs by changing the framework so that labels on the x-axis using a text scale is now independent on the tick marks. This makes it possible to have the labels centered under each bar but have the tickmarks between the bars as most other commercial graph packages format these typw of graphs. Introduced Axis::SetTextLabelsInterval() Effects jpgraph.php, jpgraph_log.php and jpgraph_bar.php * [me] Renamed Axis::SetTextTicks() to Axis::SetTextTicksInterval() to make the name more descriptive. The old name is deprecated from this version on but will still work until 2.0 to keep compatibility. * [me] Cleaned up implementation of pie3d so it now inherits from pie to avoid a lot of duplicated code and easier maintainance. (A good example of the real life OO programming where you might not see the similarities between two classes until you fully implement them.) File size of jpgraph_pie3d.php has shrunk by roughly 40% [23-Sep-2001] JpGraph 1.3.1 =========================== Additions: * [Michael Anthon] Added client side image maps to 3D pie plots * [me] Added possibility to better control the labeling of pie graphs with an optional label formatting string PiePlot::SetLabelFormat(), PiePlot::SetLabelType() This also makes it possible to have labels with the absolute value and not only the percentage. (same with pie3d) * [me] Added formatting capabilities for legends on pie and pie3d graphs. Can have the value automtically included (Se Examples/pieex6.php) * [me] Added some more examples, negbarvalueex1.php, scatterlinkex2.php, pie3d_csimex1.php pieex6.php Known bugs and omissions: - Client side image maps does not currently handle exploded pie graphs (just normal pie graphs. Bug fixes: * [me] Fixed problem with positioning the displayed values for negative bars * [me] Fixed shadow for negative bars * [me] Fixed problem in Plot::Min(), PlotMax::Max() whereby zeros where not counted towards minimum since in PHP 0=="". This could sometimes cause strange autoscaling. * [Vitaly E. Ashmarin] Wrong arguments to imagejpeg() for combination of specified image quality and filename = "" * [John Milne] BarPlot::SetFillColor() fixed glitch in loop variable [13-Sep-2001] JpGraph 1.3 ========================= Note: I have to the best of my memory tried to give credit where credit is due. Howevever, since ver 1.2.2 I have received over 2000 mail about JpGraph with Questions/Suggestions/Improvments (and a few bug fixes) etc and I might have missed some in the process of going through these mails. The fault is completely my own and if you recognize some idea I have implemented something which you think you should have credit for please drop me a note and I will adjust the add you to the change notes. Known bugs and omissions: - The automatic value on bar graphs does not work well with negative bar graphs. (Quite easy to fix though..) - Client side image maps does not currently handle exploded pie graphs (just normal pie graphs. IMPORTANT NOTICE: * SC (SOURCE COMPATIBILITY) BREAK !: If you want to rotate the image the parameter is no longer supplied directly in the call to Graph() but rather as a method call Graph::SetAngle(). I decided to make this SC break since I judged it more natural to supply the timeout value just efter the specified cache-file name in the Graph() call. Hopefully this will not hit to many people since my hunch is that few people uses the rotate function and it's very easy to fix those script that does so. Bug Fixes: * [michael@anthon.net] Corrected behviour of accumulated bar graph so it now diffrentiate between the accumulated positive and negative values. * [marko@fly.srk.fer.hr] Fixed Max() calculations for accumulated bar graphs where my original code was a little bit sloppy. (I simply took the max for each plot and added those and this might be more then the real maximum.) * [m.purgar@extracom.de] Spotting an incorrect "jpg" in the image where it should have been "jpeg" * [adam.blomberg@euroseek.net,patrik.johansson@euroseek.net] 3D-Pie filling problem for small slices due to the discrapency between GD arc() and the JpGraphs purely mathematical definition of an ellipse. * [delorme.maxime@free.fr] 2D-Pie Floodfill might "escape" for very small values of slices. * [et.al] Improved handling of 0:s vs "" values. This was necessary since PHP treats 0 as "" the same in a number of situations and JpGraph needs to diffrentiate these two cases. This caused 0 data values to be treated as null values and not be inluded in (for example) autoscaling consideration. Additions: * [me] Added new global constant USE_CACHE which makes it possible to disable writing to the cache even if a filename is supplied in th Graph::Graph() method. * [me] Added LinePlot::SetStyle() to make it possible to make dashed, dotted etc lineplots. (See example1.2). Also adjusted legend to display the same style in the legend. * [michael@anthon.net, me] Added client side image maps for all types of bars and 2D pies with possibility to have the actual value shown in an ALT-tag. * [me] Added drop shadow (or rather "right-up" shadow) to bar graphs BarPlot::SetShadow() * [me] Added possibility to have the actual value of bar graphs displayed at top of graphs via BarPlot::ShowValue(), BarPlot::SetValueFont(), SetValueMargin(), SetValueColor() The format of the value is specified according to standard C printf() string formatting i.e. "val=%d" will for example print a string "val=13" * [me] Added possibility to adjust brightness and contrast for background image via the Graph::AdjBackgroundImage() method. * [me] Added possibility to adjust brightness and contrast in the finished image via the Image::AdjBrightContrast() method. * [me] Added possibility to just generate an image to a file and not stream it directly back to the browser. Added parameter $aInline to Graph::Graph() * [me] Added timout for cache, i.e if the image in the cache is older then the specified number of minutes (=0 never re-generate, -1 always regenerate) then re-generate the image. Just specify a timeout in minutes with a call: $mygraph->cache->SetTimeOut(10) * [me] Added possibility to use logarithmic scale for SpiderPlots. This also resulted in a little bit of internal cleanup in jpgraph_spider.php. * [me] Added SetWeight() method to class Ticks() for control of line thickness for ticks * [me] Added SetMarkColor method to class TIcks() which lets you specify different colors for major and minor tick marks. * [me] Added method RelTranslate() to LinearScale() and LogScale() classes which is used in Spider class. This makes a world to screen relative translation. * [me] Added possibility to link data points in a scatter plot with lines by the addition of method ScatterPlot::SetLinkPoints() * [me,john.milne@one2one.co.uk] Added possibility to have individual colors of bars in bar graphs by having BarPlot::SetColor() accept an array as argument. * [sergio@alsernet.es] Make it possibly to have x-tick labels to consist of two lines by inserting a "\n" separator in the text. * [CK1@wwwtech.de] Adding JPEG quality setting. This is done by adding a method SetQuality() to the img class. After creating a graph this can then be used as $mygraph->img->SetQuality($some_qvalue). Currently this only affects JPEG images. * [delorme.maxime@free.fr] Possibility to use different grace value for top and bottom of graph and not just a single value as in 1.2.2 Changes: * [me] Changed group/permission handling for created files to better adjust itself to the way the local Apache user is setup * [me] The default for spider graphs is now NOT to be filled * [me] Allow all datapoints to be 0 which will set the scale to [0,1] * [me] Removed the need for a DIR_BASE variable [29-Apr-2001] JpGraph 1.2.2 =========================== Bug fixes: * Removed reference to non-existent property 'bypass' in class RotImg * Changed to allow the last X-gridline to be drawn (comparison with limit was '<' where it should have been '<=' ) Additions: * Added possibility to use background image * Added possibility to use approximate color through the "USE_APPROX_COLORS" constant * Handling of diffrent form of "null values" for line graphs. An y-value can now be "" or "-". In the first case (a true null value) this mark will cause a disruption in the line graph to indicate that the value is undefined. In the other case specifying the value as "-" will cause the value to be ignored bu the line will still be drawn between the previous data point and the following. Neither of these cases will have any mark drawn. * Added a fatal warning when no more colors can be allocated for the chosen graphic format. Changes: * "Downgraded" anti-aliasing algorithm to use fewer color levels in the transition to avoid using up to much of the color palette * Cleaned up some of the code to not rely on PHP default initialization of variables. This will help those who have got warnings when they have had all error reporting enabled in php.ini (E_ALL) * Legends now show the plot mark (if defined) instead of just a square of the right color. Acknowledgements: * Thanks to kevin@pricetrak.com for suggesting the treatment of pure NULL values. * Thanks to luca_n@hotmail.com for getting my attention to the warnings caused by relying on PHP default initialization of variables. (My installation had E_NOTICE disabled, hence I never got those warning myself.) [29-Mar-2001] JpGraph 1.2.1 =========================== Bug fixes: * When min and max values for autoscaling was equal this resulted in trying to calculate log10(0) = INF resulting in an infinite loop in LinearTicks::Stroke() * When autoscaling was used with only one data point it tried to calculate log10(0) = INF resulting in an infinite loop * fopen("xxx","r") should be fopen("xxx","rb") causes problems on windows system with IIS5 * JPG streaming function was incorrectly called "imagejpg" should be "imagejpeg" (see the difference?) * Non existent color name in jpgraph_pie.php * Removed all deprecated forced references in function calls * The width of the surrunding box was not calculated correctly for internal bold font Additions: * Color themes for pie graphs * Beta release of 3D pie graphs * Added DIR_BASE as constant to make it possible to use one system wide copy of JpGraph. NOTE: This must be set to the directory where JpGraph is installed. Acknowledgements: * (ck1@wwwtech.de) (and a russian guy which I unfortunately lost the name of) for reporting the imagejpg spelling mistake * (ales.gregor@zps.skoda-auto.cz) for finding the binary file problem with IIS * Several people have reported the problem with autoscaling when all Y-values were equal. Thanks to you all for acting as my privet QA team! [18-Mar-2001] JpGraph 1.2 ========================= Additions: ---------- * Added "BRAND_TIMING" which give possibility to brand each image generated with the time (in ms) it took to generate the image. * Added Gradient Fill for bar graphs, The gradient fill allows 6 different styles. * Added Anti-aliasing for lines. Note drawing anti-aliased lines is 7-10 times slower then "normal" lines! * Added full TTF support. this means an internal SC break (Source Code Break). Normal JpGraph script should not be affected if you have used only publized "public" frunctions. The SC break is to allow uniform treatment of both internal fonts and TTF. This has been achieved by changing the parameter list for SetFont(). However, backward compatibility with the old naming conventions for internal fonts are kepot, e.g. SetFont(FONT1_BOLD) still works but is deprecated and will not be valid from 2.0 * Added possibility to control font for title of Spider Axis through the added property 'title' to the axis in the spider graph. * Added 'SetColor()' in pie graphs as a shortcut to SetMarginColor() to set the background color * Added possibility to draw X-axis labels at arbitrary angle. Internal fonts only supports horizontal and verical. * Added possibility to draw boxed text at an angle * Added possibility to have different colors for axis and the labels on the axis by the addition of extra parameter to SetColor() * Added 350 more named colors. * Added canvas "fake" graph to make it easy to draw arbitrary graphics * Added SetCenter() method for line graphs. * Added SetGrace() for autoscaling purposes. Changes: -------- * If you use a text-scale for X-axis the default labels now start at 1 instead of 0 since this is actually a counting scale and it makes more sense to start at 1. * Improved handling of bar-graphs with negative values. * Updated existing examples to use new format for SetFont() * Made it a critical error to specify a non existant font * Changed so that orientation for Text() is now given as an angle, i.e. SetOrientation(45). Old style of using SetOrientation("v") (for vertical) is deprecated. But will work until V2 Bug fixes: ---------- * Improved handling of computational effects on small values in scaling where a rounding error might cause the last label not to be drawn. * The position for the title of X-axis could in some cases be slightly different in first and second pass due to incorrectly determination of the X-axis labels font height. * Specifying an minimum Y-value for Y-axis on bar graphs could on rare occasions (combination of scale values and specified density of autoscaling ticks) cause a gap between the bottom of each bar and the X-axis. [18-Feb-2001] JpGraph 1.1 ========================= Additions/Changes: ------------------ * Added Spider graphs * Added Pie graph * Added Scatter (and impuls) graphs * Added possibility to rotate plots an arbitrary angle * Added step style rendering to lineplot * Added Breseham circle drawing which gives better visual apperance then the built in Arc() in GD (on the expense of CPU and performance) * Improved Polygon and Rectangle drawing so that it will use line weight settings * Improved the visual appearance of lines with weight>1 by correctly calculating (angle wise) the endpoints and using a filled polygon to draw the line. Unfortunately it would require some real improvements in the GD library to really improve the visual appeance of lines with weight>1. This is as good as it gets without writing a low level pixe-by-pixel correct plotting. With my method you get it to look visually aestethic right in 90% of the cases with just 10% work. * Added MARK_FILLEDCIRCLE as new mark type. Note that due too the poor performance of the basic Arc() image primitive in PHP4 the circles isn't perfect circles, they tend to be a a little bit flat at multiples on PI/2. * Added the possibility to have a separate fill- and line- color for marks * Moved Class PlotMark from jpgraph_line.php to base in jpgraph.php since this class is also used with scatter plots. * Made it a critical error to try to use Text X-scale with specified X-data points. Previously no warning was given for this non-defined state. (Using text scale with specified points really doesn't make sense.) * Made it a critical error to use unknown color rather than silently replacing it with black. * Updated documentation to reflect added capability Bug fixes: ---------- * Fixed minor bug in Line() in which it didn't update the last point for use with subsequent LineTo() calls (forgotten $this->) * Eliminated assumptions in DashedLine() that x1<=x2 and y1<=y2 eliminates the potential pixel overshoot. * Fixed a serious bug in Line plot when used with a specified X-scale (not the normal default) since the X-coordinate wasn't read from the correct vector! * Fixed a serious bug whe using as specified X-scale since the maximum value for a plot wasn't correctly passed to the autoscaling. Note: The reason that these two bugs haven't been discovered previously is the fact that my test specs didn't include test cases to do with specified X-axis (I almost never ever use that). This has now been corrected and added to the test suit. * Fixed so the possible box around the plot area correctly honours the weight specified for it. [05-Feb-2001] JpGraph 1.0 ========================= * Initial release. [EOF]