Zobrazenie zdroja stránky En:Graphs for Android

{{navigacia_projekty_en|En:Graphs for Android|Graphs for Android|En:GraphDemo|GraphDemo}}
{{Šablóna:Graphs for Android obsah}}
<div itemscope itemtype="http://schema.org/SoftwareApplication">
{| class="prettytable"
| Name || <span itemprop="name">GraphLib (info.kiwiki.graphlib)</span>
|-
| Version || <span itemprop="version">1</span>
|-
| Type || <span itemprop="applicationCategory">Library</span>
|-
| Platform || <span itemprop="operatingSystem">Android</span>
|-
| Description || <span itemprop="description">Visual graph componnets library</span>
|-
| Author || <span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">Juraj Ďuďák</span> ([[Redaktor:Juraj]])</span>
|-
| Download || [http://www.kiwiki.info/files/android/graphlibrary.jar graphlib.jar]
|}
</div>


==Library content==
The GraphLib library consists of components for graph visualization on Android platform. There are most knowt type of graphs such as:
* line graph,
* XY graph,
* bar graf,
* table (taxt baset data representation).

===Functionality===
* Automatic or manual setting of y asis measure
* 4 visual styles (Android, dark, pastel, citrus)
* Zoom-in and zoom-out by well-known gestures (moving 2 fingers)
* Move the chart by dragging 
* Reset graph settings (zoom, moving) by 3-finger tap

{|
| [[Súbor:Graph for android zoomin.png]] 
| [[Súbor:Graph for android zoomout.png]]
|-
|Gesture for zoom-in
|Gesture for zoom-out
|-
|[[Súbor:Graph for android reset.png]]
|[[Súbor:Graph for android translate.png]]
|-
|Gesture for graph reset
|Gesture for moving
|}

==Gallery==
'''Line graphs'''

<gallery widths=350px heights=180px perrow=2>
Súbor:Graphs_for_android_line_1.png
Súbor:Graphs_for_android_line_2.png
</gallery>


'''XY Graph'''

<gallery widths=350px heights=180px perrow=2>
Súbor:Graphs_for_android_xy_1.png
Súbor:Graphs_for_android_xy_2.png
Súbor:Graphs_for_android_xy_3.png
</gallery>


'''Bar graphs'''

<gallery widths=350px heights=180px perrow=2>
Súbor:Graphs_for_android_bar_1.png
Súbor:Graphs_for_android_bar_2.png
Súbor:Graphs_for_android_bar_3.png
</gallery>

==Detailed description==
'''Platform'''

*Minimal Android API version : 8 (FroYo)


Common properties of all components:

Every graph consists of title, x and y axis with theit own labels. When representation of multiple data series (2 or more) are color-coded according to the selected visual style. There are 4 themes: Android theme, dark theme, pastel and citrus (green and yellow) theme.


'''Sample code''' 

<source lang="java">
    GraphXY graf
    graf = (GraphXY) findViewById(R.id.graphXY1);

    //data sctructure for data representation 
    dt=new DataTable();
    // pridanie 1. datovej rady
    dt.addDataSet("teplota");
    dt.addDataY(5);
    dt.addDataY(6);
    dt.addDataY(5);
    dt.addDataY(7);

    //data for x-axis
    dt.addDataX(1);
    dt.addDataX(3);
    dt.addDataX(5);
    dt.addDataX(6);
    dt.addDataX(8);

    //assigment data to graph
    graf.addDataTable(dt);
    graf.setXlabel("Cas [s]");
    graf.setYlabel("Teplota [C]");
    graf.setTitle("Pribeh teploty");
</source>

[[Súbor:Graplib class diagram.png|stred|rám|Diagram tried graplib]]


==BaseGraph class==


The basic class is BaseGraph that provides work with plotting data, display data conversion defined by scaling and rendering napidsov, axes, labels, axes and legends.

[[Súbor:Graplib class.png|stred|rám|Trieda BaseGraph]]

===Public objects===
;DataTable data: Object [[Graphs for Android:DataTable|DataTable]] for representation od displayed data. This object must be used for all types of graphs as data model.

===Static constant===
*To adjust the display legend (parameter method setLegendPosition)
**BaseGraph.LEGEND_TOP_LEFT
**BaseGraph.LEGEND_TOP_RIGHT
**BaseGraph.LEGEND_MIDDLE_LEFT
**BaseGraph.LEGEND_MIDDLE_RIGHT
**BaseGraph.LEGEND_BOTTOM_LEFT
**BaseGraph.LEGEND_BOTTOM_RIGHT
*To set the display mode X axis ticks
**BaseGraph.XAXIS_DISPLAY_NUM
**BaseGraph.XAXIS_DISPLAY_STR


===Public methods===

'''addDataTable''' - assign table data to be displayed. Object dt (DataTable) must be created and must contain data for display.
<source lang="java">
public void addDataTable(DataTable dt)
</source>


'''displayLegend''' - determines whether the display (dLegend = true) or no (dLegend = false) legend
<source lang="java">
public void displayLegend(boolean dLegend)
</source>


'''getDisplayMarkers''' - returns information about whether the graph will show signs displayed through points.
<source lang="java">
public boolean getDisplayMarkers(){
    return this.display_markers;
}	
</source>

'''getStyle''' - Returns the style of the graph as the constant
* GraphStyle.THEME_ANDROID
* GraphStyle.THEME_DARK
* GraphStyle.THEME_PASTEL
* GraphStyle.THEME_CITRUS
<source lang="java">
public int getStyle(){}
</source>


'''getTitle''' -Return graph title
<source lang="java">
public String getTitle()
</source>


'''getXLabelRotate''' - Returns the rotation labels on the x axis. The resulting value is the angle in degrees and positive rotation is oriented counterclockwise.
<source lang="java">
public int getXLabelRotate()
</source>


'''resetYmin''' - Canceled manually setting the lower limit to display the values on the y-axis. After calling this method, the lower limit of the graph on the y-axis is automatically calculated according to the values shown.
<source lang="java">
public void resetYmin()
</source>


'''setDisplayMarkers''' - Apply at the line and XY chart. Specifies whether to redraw the curve, respectively. polygon shown signs that point.
<source lang="java">
public void setDisplayMarkers(boolean markers)
</source>


'''setLegendPosition''' - Sets the position of the legend. Details of the parameters of the methods are ''static constants'' (class MaseGraph)
<source lang="java">
public void setLegendPosition(int position)
</source>


'''setStyle''' - set the visual style to view the chart. The possible values of the parameter style are: GraphStyle.THEME_ANDROID, GraphStyle.THEME_DARK, GraphStyle.THEME_PASTEL, GraphStyle.THEME_CITRUS
<source lang="java">
public void setStyle(int style)
</source>


'''setTickXformat''' - Sets the number of decimal places to show values on the x-axis.
<source lang="java">
public void setTickXformat(int format)
</source>


'''setTitle''' - set the graph title.
<source lang="java">
public void setTitle(String title)
</source>


'''setXaxisDisplayMode''' - Sets the way for displaying the values on the x axis. When adding values to the x-axis to the DataTable object, you can add in addition to the numerical value of a text description. This is particularly useful in a bar graph. If this fails to textual value and a text description of the value is the same as the value.

When the parameter BaseGraph.XAXIS_DISPLAY_NUM is used, on the x-axis will be display numerical values. For the constants BaseGraph.XAXIS_DISPLAY_STR alternative text will be displayed.
<source lang="java">
public void setXaxisDisplayMode(int mode)
</source>


'''setXlabel''' - sets the name of the x-axis.
<source lang="java">
public void setXlabel(String l)
</source>


'''setXLabelRotate''' - sets the angle of x-axis ticks. The default value is 0 Angle increases counterclockwise.
<source lang="java">
public void setXLabelRotate(int angle)
</source>


'''setYlabel''' - sets the name of the y-axis.
<source lang="java">
public void setYlabel(String l)
</source>

==Class GraphStyle==
GraphStyle Class is a class of constants (final) and define the colors for each style. Class includes 4 basic styles to view graphs: GraphStyle.THEME_ANDROID, GraphStyle.THEME_DARK, GraphStyle.THEME_PASTEL and GraphStyle.THEME_CISTRUS

===ANDROID theme===
{| style="background-color:#eeeeee; color:#121212"
|Background
|style="background-color:#eeeeee;width:300px"|&nbsp;
|-
|1. data series
|style="background-color:#0099cc;width:300px"|&nbsp;
|-
|2. data series
|style="background-color:#9933cc;width:300px"|&nbsp;
|-
|3. data series
|style="background-color:#669900;width:300px"|&nbsp;
|-
|4. data series
|style="background-color:#ff8800;width:300px"|&nbsp;
|-
|5. data series
|style="background-color:#cc0000;width:300px"|&nbsp;
|}


===DARK theme===
{| style="background-color:#151013; color:#ebebeb"
|Background
|style="background-color:#151013;width:300px"|&nbsp;
|-
|1. data series
|style="background-color:#FFB752;width:300px"|&nbsp;
|-
|2. data series
|style="background-color:#F9FF52;width:300px"|&nbsp;
|-
|3. data series
|style="background-color:#7DFF52;width:300px"|&nbsp;
|-
|4. data series
|style="background-color:#52FFF3;width:300px"|&nbsp;
|-
|5. data series
|style="background-color:#FF52FF;width:300px"|&nbsp;
|}


===PASTEL theme===
{| style="background-color:#FEF3F4; color:#101010"
|Background
|style="background-color:#FEF3F4;width:300px"|&nbsp;
|-
|1. data series
|style="background-color:#453120;width:300px"|&nbsp;
|-
|2. data series
|style="background-color:#FF5800;width:300px"|&nbsp;
|-
|3. data series
|style="background-color:#BE9D3F;width:300px"|&nbsp;
|-
|4. data series
|style="background-color:#6591DD;width:300px"|&nbsp;
|-
|5. data series
|style="background-color:#BC8FA5;width:300px"|&nbsp;
|}


===CITRUS theme===
{| style="background-color:#E9F3EA; color:#16280A"
|Background
|style="background-color:#E9F3EA;width:300px"|&nbsp;
|-
|1. data series
|style="background-color:#DE8B30;width:300px"|&nbsp;
|-
|2. data series
|style="background-color:#F0BD1B;width:300px"|&nbsp;
|-
|3. data series
|style="background-color:#B8C538;width:300px"|&nbsp;
|-
|4. data series
|style="background-color:#71863D;width:300px"|&nbsp;
|-
|5. data series
|style="background-color:#16280A;width:300px"|&nbsp;
|}