ChartDirector 6.0 (Ruby Edition)

Custom Scatter Symbols




This example demonstrates using external image files as scatter symbols.

The chart in this example is created as 5 scatter layers using XYChart.addScatterLayer, with each layer containing one point.

The symbols for the scatter layers come from external image files. They are loaded using DataSet.setDataSymbol2.

Source Code Listing

[Ruby On Rails Version - Controller] app/controllers/scattersymbols_controller.rb
require("chartdirector")

class ScattersymbolsController < ApplicationController

    def index()
        @title = "Custom Scatter Symbols"
        @ctrl_file = File.expand_path(__FILE__)
        @noOfCharts = 1
        render :template => "templates/chartview"
    end

    #
    # Render and deliver the chart
    #
    def getchart()
        # The XY points for the scatter chart
        dataX = [200, 400, 300, 250, 500]
        dataY = [40, 100, 50, 150, 250]

        # The custom symbols for the points
        symbols = ["robot1.png", "robot2.png", "robot3.png", "robot4.png", "robot5.png"]

        # Create a XYChart object of size 450 x 400 pixels
        c = ChartDirector::XYChart.new(450, 400)

        # Set the plotarea at (55, 40) and of size 350 x 300 pixels, with a light grey border
        # (0xc0c0c0). Turn on both horizontal and vertical grid lines with light grey color
        # (0xc0c0c0)
        c.setPlotArea(55, 40, 350, 300, -1, -1, 0xc0c0c0, 0xc0c0c0, -1)

        # Add a title to the chart using 18pt Times Bold Itatic font.
        c.addTitle("Battle Robots", "timesbi.ttf", 18)

        # Add a title to the y axis using 12pt Arial Bold Italic font
        c.yAxis().setTitle("Speed (km/s)", "arialbi.ttf", 12)

        # Add a title to the y axis using 12pt Arial Bold Italic font
        c.xAxis().setTitle("Range (km)", "arialbi.ttf", 12)

        # Set the axes line width to 3 pixels
        c.xAxis().setWidth(3)
        c.yAxis().setWidth(3)

        # Add each point of the data as a separate scatter layer, so that they can have a different
        # symbol
        0.upto(dataX.length - 1) do |i|
            c.addScatterLayer([dataX[i]], [dataY[i]]).getDataSet(0).setDataSymbol2(
                File.dirname(__FILE__) + "/" + symbols[i])
        end

        # Output the chart
        send_data(c.makeChart2(ChartDirector::PNG), :type => "image/png", :disposition => "inline")

    end

end

[Ruby On Rails Version - View] app/views/templates/chartview.html.erb
<html>
<body style="margin:5px 0px 0px 5px">

<!-- Title -->
<div style="font-size:18pt; font-family:verdana; font-weight:bold">
    <%= @title %>
</div>
<hr style="border:solid 1px #000080" />

<!-- Source Code Listing Link -->
<div style="font-size:9pt; font-family:verdana; margin-bottom:1.5em">
    <%= link_to "Source Code Listing", 
        :controller => "cddemo", :action => "viewsource",
        :ctrl_file => @ctrl_file, :view_file => File.expand_path(__FILE__) %>
</div>

<!-- Create one or more IMG tags to display the demo chart(s) -->
<% 0.upto(@noOfCharts - 1) do |i| %>
    <img src="<%= url_for(:action => "getchart", :img => i) %>">
<% end %>

</body>
</html>

[Command Line Version] rubydemo/scattersymbols.rb
#!/usr/bin/env ruby
require("chartdirector")

# The XY points for the scatter chart
dataX = [200, 400, 300, 250, 500]
dataY = [40, 100, 50, 150, 250]

# The custom symbols for the points
symbols = ["robot1.png", "robot2.png", "robot3.png", "robot4.png", "robot5.png"]

# Create a XYChart object of size 450 x 400 pixels
c = ChartDirector::XYChart.new(450, 400)

# Set the plotarea at (55, 40) and of size 350 x 300 pixels, with a light grey border (0xc0c0c0).
# Turn on both horizontal and vertical grid lines with light grey color (0xc0c0c0)
c.setPlotArea(55, 40, 350, 300, -1, -1, 0xc0c0c0, 0xc0c0c0, -1)

# Add a title to the chart using 18pt Times Bold Itatic font.
c.addTitle("Battle Robots", "timesbi.ttf", 18)

# Add a title to the y axis using 12pt Arial Bold Italic font
c.yAxis().setTitle("Speed (km/s)", "arialbi.ttf", 12)

# Add a title to the y axis using 12pt Arial Bold Italic font
c.xAxis().setTitle("Range (km)", "arialbi.ttf", 12)

# Set the axes line width to 3 pixels
c.xAxis().setWidth(3)
c.yAxis().setWidth(3)

# Add each point of the data as a separate scatter layer, so that they can have a different symbol
0.upto(dataX.length - 1) do |i|
    c.addScatterLayer([dataX[i]], [dataY[i]]).getDataSet(0).setDataSymbol2(symbols[i])
end

# Output the chart
c.makeChart("scattersymbols.png")