CommFractionBar

Last updated March 16, 2011

Available since CTAT 2.11

1. Component Parameters

Parameter Name Description
1 Bar Color Scheme Sets the scheme that the component should use for deciding how to color the pieces in the Bar Chart.
2 Bar Color Specified Color for all selected pieces and modified by "Non-selected visibility (alpha)" to determine the colors of the unselected pieces.
3 Bar Color Mixed Specifies the colors for the first n pieces where n is the number of colors in a semicolon-delimited list. Any pieces 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 pieces.
6 Partitions Horizontal Sets the initial number of vertical partitions. The meaning of this parameter depends on "Pieces equal/different sized".
7 Partitions Vertical Sets the initial number of vertical partitions. The meaning of this parameter depends on "Pieces equal/different sized".
8 Vertical partitioning Sets if the user is able to modify the vertical partitioning.
9 Pieces Activated Sets which pieces are considered activated initially.
10 Line Thickness Sets the thickness of the lines drawn around each piece.
11 Non-selected visibility (alpha) Sets the transparency of unselected pieces when "Deactivated style" is set to "Show lighter."
12 Image URL Sets the image to use when "Bar Color Scheme" is set to "Image".
13 Deactivated style Sets how unselected pieces are displayed
14 Pieces equal/different sized Sets what assumptions the Bar chart makes about its pieces. This is used to optimize some calculations and inputs based on the set assumption.
15 Partition Style Sets the policy concerning when the pieces are updated given user manipulation of the partition controls. It also determines what partition controls are available.
16 Partition Style Sets the policy concerning when the pieces are updated given user manipulation of the partition controls. It also determines what partition controls are available.
17 Spacing between parts Sets the distance between each piece in the chart.
18 Use Gradient Fill Sets if gradient coloring is used when drawing the pieces.
19 When partitioning changes Sets the policy of how pieces respond to changes in the number of partitions (ie changes in the denominator).
20 Is drop target Determines if the component will accept pieces dragged from compatible components.
21 Show divisions box Determines if the textbox used for showing and modifying the number of partitions (the divisors) are displayed.
22 Maximum divisions Sets the maximum number of pieces that can be displayed in the chart.
23 Button Spacing Sets the amount of space to add between any of the extra interface buttons, for example the partition controls.
24 Suppress Highlighting on Correct Sets if this component displays correct feedback highlighting.
25 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

Bar Color Scheme

Sets the scheme that the component should use for deciding how to color the pieces in the Bar 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 pieces.
  • As in Specified: (default) use the color in "Bar Color Specified"
  • As in Mixed: use the color scheme in "Bar Color Mixed"
  • Image: use the image in "Image URL"
Bar Color Specified

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

Bar Color Mixed
Specifies the colors for the first n pieces where n is the number of colors in a semicolon delimited list. Any pieces 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: fraction: (default) The "Ok" button is the only action that triggers a tutored event, the value of the chart is the only data sent to the tutor.
  • On submit: fraction and parts: The "Ok" button is the only action that triggers a tutored event and both the value of the chart and its partitioning scheme is sent to the tutor (<value>;<horizontal>x<vertical>).
  • 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 pieces.

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

Sets the initial number of horizontal partitions. The meaning of this parameter depends on "Pieces equal/different sized". Value: If "Pieces equal/different sized"=="Equal Sized Pieces", this should be an integer for the number of horizontal divisions. If "Pieces equal/different sized"=="Different Sized Pieces", this should be a list of semicolon delimited fractions specifying the sizes of the horizontal divisions. For example, Partitions Horizontal=1/3;1/6;1/2, Partitions Vertical=1/1 will produce 3 pieces, one is 1/3 the size of the component's area, next one is 1/6, and the last is 1/2 the size of the component's area.

Partitions Vertical

Sets the initial number of vertical partitions. The meaning of this parameter depends on "Pieces equal/different sized". Value: If "Pieces equal/different sized"=="Equal Sized Pieces", this should be an integer for the number of vertical divisions. If "Pieces equal/different sized"=="Different Sized Pieces", this should be a list of semicolon delimited fractions specifying the sizes of the vertical divisions.

Vertical partitioning

Sets if the user is able to modify the vertical partitioning. Value: true: (default) the controls for modifying the vertical partitions are made available to the user. false: the controls for the vertical partitions are not available to the user and "Partitions Vertical" is ignored.

Pieces Activated

Sets which pieces are considered activated initially. Value: a semicolon delimited list of whole numbers corresponding to the index of the pieces that are initially displayed as selected. 1 is the first wedge starting in the upper left corner and proceeding horizontally. Default value is "1;3" for the first and third pieces.

Line Thickness

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

Non-selected visibility (alpha)

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

Image URL

Sets the image to use when "Bar 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 pieces are displayed.

  • Show lighter: (default) uses "Non-selected visibility (alpha)" as the alpha value modifying the appropriate color for the piece.
  • Show outline: transparent pieces with light gray borders
  • Hide: unselected pieces are not visible.
Pieces equal/different sized

Sets what assumptions the Bar chart makes about its pieces. 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 pieces are the same size. For example, it will base initial piece sizes on "Partitions Horizontal" as the number of columns and "Partitions Vertical" as the number of rows.
  • Different Sized Pieces: Extra calculations and such are performed on each piece under the assumption that each piece can be of different size. "Partitions Horizontal" and "Partitions Vertical" should then contain lists of fractions that set up the proportional size of the rows and columns.
Partition Style

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

  • Instant: (default) Pieces 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 piece in the chart. Value: The number of pixels between each piece. Default value = 4.

Use Gradient Fill

Sets if gradient coloring is used when drawing the pieces. Value: true: (default) gradient coloring is used such that the pieces get lighter towards the top of each piece. false: the piece is uniformly colored.

When partitioning changes

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

  • Activate all pieces: When changed, all the resulting pieces are considered selected (eg the value of the chart goes to 1).
  • Deactivate all pieces: When changed, all the resulting pieces are considered unselected (eg the value of the chart goes to 0).
  • Retain active pieces: The number of selected pieces is held constant (eg the numerator stays the same regardless of changes to the denominator) (ie if there are 2 pieces selected when there are 3 pieces and the number of pieces is increased to 4, then 2 of the 4 pieces will be selected).
  • Retain amount: show left-over: When changed, the chart will fill as many full pieces as possible to the value of the pie chart and the new denominator. It will then create an additional piece for any left over portion that does not fill a full piece. (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 chart with equally sized pieces. 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 pieces 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.