PHPlot

PHPlot — Construct a new PHPlot Class Object

Synopsis

$plot = new PHPlot([$width], [$height], [$output_file], [$input_file])
    

Description

This is the class constructor for PHPlot. It creates a new plot object and initializes all internal settings to default values.

Parameters

$width

Optional width of the plot image, in pixels. Default is 600.

$height

Optional height of the plot image, in pixels. Default is 400.

$output_file

Optional name of a file where the image output will be written. This is the same as using SetOutputFile. Default is no output file, meaning the image is written to standard output (that is, sent back to the browser).

$input_file

Optional name of a file to use as a starting image. This becomes the background for the plot. If an input_file is given, any width and height given to the constructor are ignored, and the size of the image in the named input_file are the plot image size. Default is no input file, meaning a blank image will be created at the given or default width and height.

Return Value

Returns an object, an instance of the PHPlot class.

Notes

The output_file will be ignored unless SetIsInline(True) is called.

Earlier versions of this manual said that the created object should always be returned as a reference, like this:

  $plot =& new PHPlot(...);  // Do not use this
      

This was because PHPlot included a function to deallocate memory used by the object at script shutdown, but that would only work if a reference assignment was used. This quasi-destructor was removed at PHPlot-5.0.4 because it interfered with memory deallocation until the script ended. So the reference assignment should not be used. In addition, reference assignment of a newly created object instance is deprecated starting with PHP5.