CommPieChart

Last updated March 17, 2011

Available since CTAT 2.11

1. Component Parameters

Parameter Name Description
1 Pie Color Scheme Sets the scheme that the component should use for deciding how to color the wedges in the Pie Chart.
2 Pie Color Specified Color for all selected wedges and modified by "Non-selected visibility (alpha)" to determine the colors of the unselected wedges.
3 Pie Color Mixed Specifies the colors for the first n wedges were n is the number of colors in a semicolon delimited list. Any wedges beyond n will use the appropriate color from the Rational Number Project.
4 Tutor this Component Sets the tutoring policy for this component
5 Interactive Sets what kind of user interactions are permitted with the pie wedges.
6 Pieces Type Sets what assumptions the Pie chart makes about its wedges. This is used to optimize some calculations and inputs based on the set assumption.
7 Fraction(s) Sets what fractions are represented in the pie chart initially.
8 Pieces Activated Sets which wedges are considered activated by default.
9 Line Thickness Sets the thickness of the lines drawn around each wedge.
10 Non-selected visibility (alpha) Sets the transparency of unselected wedges when "Deactivated style" is set to "Show lighter."
11 Image URL Sets the image to use when "Pie Color Scheme" is set to "Image".
12 Deactivated style Sets how unselected wedges are displayed
13 Partition Style Sets the policy concerning when the wedges are updated given user manipulation of the partition controls. It also determines what partition controls are available.
14 Spacing between parts Sets the distance between each wedge in the pie chart.
15 Use Gradient Fill Sets if gradient coloring is used when drawing the wedges.
16 When partitioning changes Sets the policy of how wedges respond to changes in the number of partitions (ie changes in the denominator).
17 Is drop target Determines if the component will accept pieces dragged from compatible components.
18 Show divisions box Determines if the textbox used for showing and modifying the number of partitions (the divisor) is displayed.
19 Maximum divisions Sets the maximum number of wedges that can be displayed in the chart.
20 Button Spacing Sets the amount of space to add between any of the extra interface buttons, for example the partition controls.
21 Suppress Highlighting on Correct Sets if this component displays correct feedback highlighting.
22 When Piece Dropped Sets the policy for determining what this component will do when a piece from a compatible component is dropped on it. This is only checked when "Is drop target" is set to true.

2. Parameter Descriptions and Values

Pie Color Scheme

Sets the scheme that the component should use for deciding how to color the wedges in the Pie Chart.

  • Rational Number Project: use colors corresponding to those used by the Rational Number Project (eg different color for each denominator)
  • Transparent: No coloring and transparent wedges.
  • As in Specified: (default) use the color in "Pie Color Specified"
  • As in Mixed: use the color scheme in "Pie Color Mixed"
  • Image: use the image in "Image URL"
Pie Color Specified

Color for all selected wedges and modified by "Non-selected visibility (alpha)" to determine the colors of the unselected wedges. Value is the color of the wedges (#RRGGBB).

Pie Color Mixed
Specifies the colors for the first n wedges were n is the number of colors in a semicolon delimited list. Any wedges beyond n will use the appropriate color from the Rational Number Project. Value is a list of semicolon-delimited color strings (0xRRGGBB) as well as "transparent".
Tutor this Component

Sets the tutoring policy for this component.

  • On submit: (default) The "Ok" button is the only action that triggers a tutored event.
  • Every step: all user actions are sent to the tutor as tutored actions.
  • No: all actions are sent to the tutor as untutored.
Interactive

Sets what kind of user interactions are permitted with the pie wedges.

  • Highlighting and Drag: Wedges become highlighted when the mouse cursor is over them and wedges can be clicked to be picked up and dragged.
  • Highlighting and Select: (default) Wedges become highlighted when the mouse cursor is over them and clicking on them selects or deselects them.
  • Just Highlighting: Wedges become highlighted when the mouse cursor is over them. Clicking on wedges does nothing.
  • No: Wedges are not directly manipulable.
Pieces Type

Sets what assumptions the Pie chart makes about its wedges. This is used to optimize some calculations and inputs based on the set assumption.

  • Equal Sized Pieces: (default) calculations and representations assume that all the wedges are the same size. For example, it will base initial wedge sizes on the first fraction in the "Fractions" parameter and will assume all wedges are the same size as the first wedge for calculating the magnitude of the fraction represented in the pie chart.
  • Different Sized Pieces: Extra calculations and such are performed on each wedge under the assumption that each wedge can be of different size.
Fraction(s)

Sets what fractions are represented in the pie chart initially. Value is a fraction (eg the default value "1/3") or a semicolon delimited list of fractions (eg "1/3;1/4;1/5").

Note: if "Pieces Type" is set to "Equally Sized Pieces" then only the first fraction found will be used in the case where a list of fractions are specified.

Pieces Activated

Sets which wedges are considered activated by default. Value: a semicolon delimited list of whole numbers corresponding to the index of the wedges that are initially displayed as selected. 1 is the first wedge starting at 12 o'clock and progressing clockwise. Default value is "1;3" for the first and third wedge. In the default configuration displaying 1/3 sized wedges, these would be the ones from 12 o'clock to 4 o'clock and 8 o'clock to 12 o'clock.

Line Thickness

Sets the thickness of the lines drawn around each wedge. Value: the thickness of the lines around each wedge in pixels. Default value = 2.

Non-selected visibility (alpha)

Sets the transparency of unselected wedges when "Deactivated style" is set to "Show lighter." Value: the alpha value used when coloring unselected wedges. Default value = 10.

Image URL

Sets the image to use when "Pie Color Scheme" is set to "Image". Value: a URL to an image file supported by Flash. Note: the image file and the interface SWF must be on the same server because of Flash's security policies unless special security provisions are made on the server.

Deactivated style

Sets how unselected wedges are displayed.

  • Show lighter: (default) uses "Non-selected visibility (alpha)" as the alpha value modifying the appropriate color for the wedge.
  • Show outline: transparent wedges with light gray borders
  • Hide: unselected wedges are not visible.
Partition Style

Sets the policy concerning when the wedges are updated given user manipulation of the partition controls. It also determines what partition controls are available.

  • Instant: (default) Wedges change as soon as any of the partition controls are manipulated.
  • Button: a "Part" button is added and changes only occur when that button is pressed.
  • No partitioning: The partition controls are not available to the user.
Spacing between parts

Sets the distance between each wedge in the pie chart. Value: The number of pixels between each wedge. Default value = 4.

Use Gradient Fill

Sets if gradient coloring is used when drawing the wedges. Value: true: (default) gradient coloring is used such that the wedge gets lighter as it goes to the outer edge of the pie chart. false: the wedge is uniformly colored.

When partitioning changes

Sets the policy of how wedges respond to changes in the number of partitions (ie changes in the denominator).

  • Activate all pieces: When changed, all the resulting wedges are considered selected (eg the value of the chart goes to 1).
  • Deactivate all pieces: When changed, all the resulting wedges are considered unselected (eg the value of the chart goes to 0).
  • Retain active pieces: The number of selected wedges is held constant (eg the numerator stays the same regardless of changes to the denominator) (ie if there are 2 wedges selected when there are 3 wedges and the number of wedges is increased to 4, then 2 of the 4 wedges will be selected).
  • Retain amount: show left-over: When changed, the chart will fill as many full wedges as possible to the value of the pie chart and the new denominator. It will then create an additional wedge for any left over portion that does not fill a full wedge. (eg the chart will hold the value of the chart constant while trying to accommodate the new denominator).
  • Retain amount: skip impossible: When changed, the chart will skip partition sizes that can not represent the value of the pie chart with equally sized wedges. In other words, it will go to the next multiple of the value of the chart (ie 1/2 -> 2/4 -> 3/6).
Is drop target

Determines if the component will accept pieces dragged from compatible components. Value: false: (default) all dropped pieces will be rejected. true: pieces dropped on this component might be accepted, depending on the policy set in "When Piece Dropped".

Show divisions box

Determines if the textbox used for showing and modifying the number of partitions (the divisor) is displayed. Value: true: the texbox is displayed if partition controls are available (see "Partition Style"). false: (default) the textbox is not displayed.

Maximum divisions

Sets the maximum number of wedges that can be displayed in the chart. Value: the maximum divisor. Default value = 42.

Button Spacing

Sets the amount of space to add between any of the extra interface buttons, for example the partition controls. Value: the number of pixels used to separate any of the extra interface buttons.

Suppress Highlighting on Correct

Sets if this component displays correct feedback highlighting. Value: true: correct feedback highlighting is not displayed. false: (default) correct feedback highlighting is displayed normally.

When Piece Dropped

Sets the policy for determining what this component will do when a piece from a compatible component is dropped on it. This is only checked when "Is drop target" is set to true.

  • If Fits -> Add Piece: (default) if adding the piece does not cause the value of the chart to be greater than 1, then accept it.
  • Replace All Pieces: set the chart's value to that of the piece that was just dropped into it.
  • Always Dismiss Dropped: The dropped piece is accepted by this component and triggers a tutor event but does not modify the value of the chart.