-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Generate web-based charts using the Google Chart API
--   
--   Generate web-based charts using the Google Chart API
@package GoogleChart
@version 0.1


-- | This module is for generating web-based charts using Google's Chart
--   API: <a>http://code.google.com/apis/chart/</a>. Its output is URLs
--   that will resolve to a PNG image of the resulting chart.
--   
--   Most of the functions in this module, with names like <tt>setFoo</tt>,
--   take a <a>Chart</a> as an argument and produce a new <a>Chart</a> with
--   the specified attribute added. These calls are designed to be chained
--   together. See the example below.
--   
--   <a>Chart</a>s are represented as a hierarchy of type classes so that
--   parameters that only affect a specific chart type are only available
--   to that chart type.
--   
--   <pre>
--   putStrLn "URL for your chart:"
--   putStrLn $ <a>chartURL</a> $
--     <a>setSize</a> 400 257 $
--     <a>setTitle</a> "My Chart" $
--     <a>setData</a> (<a>encodeDataSimple</a> [[1..20]]) $
--     <a>setLegend</a> ["1 to 20"] $
--     <a>newLineChart</a>
--   </pre>
--   
--   This produces:
--   <a>http://chart.apis.google.com/chart?chs=400x257&amp;chtt=My+Chart&amp;chd=s%3aBCDEFGHIJKLMNOPQRSTU&amp;chdl=1+to+20&amp;cht=lc</a>
module Graphics.Google.Chart

-- | The type class underneath all Charts.
class Chart c

-- | Construct the URL used to show the chart.
chartURL :: (Chart c) => c -> String

-- | Set the width and height, in pixels, of the resulting image.
setSize :: (Chart c) => Int -> Int -> c -> c

-- | Set the title of the chart.
setTitle :: (Chart c) => String -> c -> c

-- | Set options for the display of the title of the chart.
setTitleOpts :: (Chart c) => String -> Int -> c -> c

-- | Set the data displayed by the chart.
setData :: (Chart c) => ChartData -> c -> c

-- | All the encoding methods produce <a>ChartData</a>, which is usable by
--   <a>setData</a>.
data ChartData

-- | Encode data using the "simple" encoding. This produces minimal URLs
--   but doesn't have as much resolution. Input values must be in the range
--   <tt>0 &lt;= x &lt;= 61</tt>. Values outside the valid input range will
--   be considered missing data.
encodeDataSimple :: [[Int]] -> ChartData

-- | Encode data using the "text" encoding. XXX unimplemented.
encodeDataText :: [[Int]] -> ChartData

-- | Encode data using the "extended" encoding. XXX unimplemented.
encodeDataExtended :: [[Int]] -> ChartData

-- | LegendChart represents charts that can display legends with
--   <a>setLegend</a>.
class (Chart c) => LegendChart c
setLegend :: (LegendChart c) => [String] -> c -> c
data LineChart
newLineChart :: LineChart
data PieChart
newPieChart :: PieStyle -> PieChart
data PieStyle
Pie2D :: PieStyle
Pie3D :: PieStyle
setLabels :: [String] -> PieChart -> PieChart
data BarChart
newBarChart :: Orientation -> BarStyle -> BarChart
data Orientation
Horizontal :: Orientation
Vertical :: Orientation
data BarStyle
Stacked :: BarStyle
Grouped :: BarStyle
instance Show ChartData
instance LegendChart BarChart
instance Chart BarChart
instance Chart PieChart
instance LegendChart LineChart
instance Chart LineChart