CHOICE / CANDIDATE TAGS |
|---|
Add [#] for additional Choices. ex: ^choice[1].name for 2nd choice’s name. ^choice.name is the same as ^choice[0].name.
Note: [0] refers to the leading candidate for the election area that the candidate belongs to.
For AreaAREA/Riding RIDING and Summary SUMMARY scenes, a special index of [inc] is also allowed and targets the incumbent candidate of the election area. E.g., ^choice[inc].name and ^summary[1].choice[inc].name. | ^choice[#].firstname | The first name of the candidate (ex: John). [#] = Position of candidate in the race where [0] is the leading candidate. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].firstname.
Not supported for Party scenes. | ^choice[#].lastname | The last name of the candidate (ex: Smith). Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].lastname.
Not supported for Party scenes. | ^choice[#].nameor ^choice[#].name | The full name of the candidate (ex: John Smith). Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].name or [#].name or ^summary[#].choice[#].
Not supported for Party scenes. | ^choice[#].custom <custom name format> | Customize the display of a candidate’s name. Note that the angle brackets characters < > are required. Any text within the < > brackets that are not encapsulated in { } brackets will be treated as literals and will be output as is. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].custom <custom name format>.
Not supported for Party scenes. The available name format tags are: {firstname} {lastname} {firstinitial} {incumbent} {elected} {partycode} {votes} {vote%}.
Example: <{lastname}, {firstname}> will display a candidate’s name as: Smith, John. | ^choice[#].media | An image representing the candidate. Tag is a Graphics object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].media.
Not supported for Party scenes. | ^choice[#].details | Details about the candidate. Limited to 255 characters. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].details.
Not supported for Party scenes. | ^choice[#].winner | A Visible tag object. Visible if the candidate is elected. Tag can be a Text or Graphics object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].winner.
Not supported for Party scenes. | ^choice[#].incumbent | A Visible tag object. Visible if the candidate is the incumbent for the office. Tag can be a Text or Graphics object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].incumbent.
Not supported for Party scenes. | ^choice[#].acclaimed | A Visible tag object. Visible if the candidate is a winner for the office by acclaim. Tag can be a Text or Graphics object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].acclaimed.
Not supported for Party scenes. | ^choice[#].vote% or ^choice[#].percentage
^choice[#].percentagetext | The percentage of votes for the candidate. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].vote%, ^summary[#].choice[#].percentage or ^summary[#].choice[#].percentagetext.
Not supported for Party scenes. **See note about the Percent Sign '%' below. If the ^choice.percentagetext or ^summary[#].choice[#].percentagetext tag is used, the '%’ sign will be forcibly shown.
**See note about Percentage Decimal Places below. | ^choice[#].votes | The number of votes received for the candidate. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].votes.
Not supported for Party scenes. | ^choice[#].voteslead | The number of votes that the candidate has as a lead over the next nearest candidate in the same election area. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].voteslead.
Not supported for Party scenes. | ^choice[#].voteslead% | The number of votes that a candidate has as a lead over the next nearest candidate as a percentage of the total votes in the election area that the candidates belong to. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].voteslead%.
Not supported for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].voteslose | The number of votes that the candidate is losing by as compared to that of the leading candidate in the same election area has. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].voteslose.
Not supported for Party scenes. | ^choice[#].voteslose% | The number of votes that the candidate is losing by as compared to that of the leading candidate as a percentage of the total votes in the election area that the candidates belong to. Tag is a Text object. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].voteslose%.
Not supported for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].custom <custom name format> | Customize the display of a candidate’s name. Note that the angle brackets characters < > are required. Available for Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].custom <custom name format>.
Not supported for Party scenes. The available name format tags are: {firstname} {lastname} {firstinitial} {incumbent} {elected} {partycode} {votes} {vote%}.
Example: <{lastname}, {firstname}> will display a candidate’s name as: Smith, John' below.
**See note about Percentage Decimal Places below. |
PARTY TAGS |
|---|
Add [#] for additional Parties. ex: ^choice[1].party.name is the name for the 2nd party. ^choice.party.name is the same as ^choice[0].party.name.
For AreaAREA/Riding RIDING and Summary SUMMARY scenes, a special index of [inc] is also allowed and targets the incumbent candidate of the election area. E.g., ^choice[inc].party and ^summary[inc].party and ^summary[1].choice[inc].party.1].choice[inc].party. | ^choice[#].party.name | The full name of the party. (ex: Republican Party, Democratic Party, Liberal Party, Conservative Party, etc.) Tag is a Text object. Available for Party, Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].party.name where choice[#] specifies the candidate that is in position # in the summary[#] election area/riding. | ^choice[#].party.colour or ^choice[#].party.nameThe full name of the party. (ex: Republican Party, Democratic Party, Liberal Party, Conservative Party, etc.)color | Changes the diffuse colour for the material assigned to a graphics object based on a specified string value that is the hex format of a colour assigned the the Party. The hex format for a colour should specify either the RGB values or ARGB values, e.g., ‘#FF0000’ for the saturated red colour (without specifying the alpha value), or ‘#7D00FF00’ for saturated green colour with an alpha value of hex 7D (i.e., decimal 125). Note that the starting '#' character is optional. If the alpha value is not specified, the current alpha value of the material will be retained. Tag is a Graphics object. Available for Party, Choice/Candidate and Candidate and Area/Riding scenes. Note: For Summary scenes, use ^summaryWeb Output, make sure that the graphics object uses a material that is just a colour with no media file attached. | ^choice[#].choiceparty.colourvalue or ^choice[#].party.name where choice[#] specifies the candidate that is in position # in the summary[#] election area/riding.colorvalue | Sets the text to the hex formatted value of the colour assigned to the Party. For more information regarding the hex formatted colours, see the description for the ^choice[#].party.colour tag. Tag is a Text object. Available for Party, Choice/Candidate and Area/Riding scenes. | ^choice[#].party.media ^choice[#].party.media <prefix> | The graphics logo for the party. The <prefix> portion of the tag is optional. Note: when using files as a source for replacement logos, it is always best specify a prefix. The reason is that there are certain file names in the Windows operating system that are reserved. For example, ‘CON’ and ‘LPT’ can’t be used even when paired with file extensions. Tag is a Graphics object. Elector Player for XPression Output: In the absence of the <prefix> part, the player looks for an XPression material that is named based on the party code. The name of the material that is assigned to the Quad at design time determines the format of the name of the replacement materials that can be used for replacement on output. The format of the materials is: prefixPARTYCODE. For example: during design time, the material assigned is named ‘logoLIB’ and during output the party should be the format of the name of the replacement materials that can be used for replacement on output. The format of the materials is: prefixPARTYCODE. For example: during design time, the material assigned is named ‘logoLIB’ and during output the party should be ‘CON’, then the player will look for a replacement material that is named ‘logoCON’. When the <prefix> part is specified as part of the tag’s name, the source of the logo will be from a file that is in the Logos folder (specified in the Elector Player’s Preferences) instead of another XPression material. The file prefix specifies what the prefix of the logo filename to look for on output. For example: we have a tag ^choice[0].party.media <logo> and the party on output is ‘CON’, then the player will look for a replacement material logo file that is named ‘logoCON’.When the <prefix> part is specified as part of the tag’s name, the source of the logo will be from a file that is .png'. The extension can be of any image type that is supported by XPression, e.g., .png, .jpg, .bmp. Note that the search for a matching file is case insensitive, i.e., ‘logocon.png’ or 'LogoCon.Jpg' will also work.
Web Output: The player always looks for a logo file located in the Logosfolder (specified in the Elector Player’s Preferences) instead of another XPression material. The file prefix specifies what the prefix of the logo filename to look for on output. For example: we have a tag ^choice[0].party.media <logo> and the party on output is ‘CON’, then the . In the absence of the <prefix> part, the player looks for a file with a name that is the party code. For example: on output, the party of interest is ‘LIB’, then player will look for a logo file that is named ‘logoCONLIB.png'’. The type of image (and hence, the extension of the file) can be of any valid image type that is supported by XPression, e.g., .png, .jpg, .bmp, etc. Note that the The search for a matching file the logo filename is case insensitive, i.e., ‘logoconlib.png’ or 'LogoCon.Jpg' ' or ‘Lib.PNG’ will also work.
Elector Player for Web: In Elector Player for Web, the player always looks for a logo file located in the Logos folder (specified in the Elector Player’s Preferences). In the absence of When the <prefix> part is specified as part of the tag’s name, the player looks will look for a file with a that name that is the party codehas the following format:prefixPARTYCODE.ext. For example: the desired party code on output is ‘CON', the party of interest is ‘LIB ^choice[0].party.media <logo> is the tag and the prefix is ‘logo’, then the player will look search for a logo file named ‘LIBlogoCON.pngjpg’. The type of image (and henceAgain, the extension of search is case insensitive and the file ) extension can be of from any valid image file type, e.g., .png, .jpg, .bmp, etc. The search for the logo filename is case insensitive, i.e., ‘lib.png' or ‘Lib.PNG’ will also work.When the <prefix> part is specified as part of the tag’s name, the player will look for a file that name has the following format:prefixPARTYCODE.ext. For example: the desired party code on output is ‘CON', ^choice[0].party.media <logo> is the tag and the prefix is ‘logo’, then the player will search for a logo file named ‘logoCON.jpg’. Again, the search is case insensitive and the file extension can be from any valid image file type, e.g., .png, .jpg, .bmp.
Available for Party, Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].party.media or ^summary[#].choice[#].party.media <prefix> where choice[#] specifies the candidate that is in position # in the summary[#] election area/riding. | ^choice[#].party or ^choice[#].party.code | The short name or acronym for the party. (ex: GOP for the Republicans, DEM for the Democrats) Available for Party, Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].party or ^summary[#].choice[#].party.code where choice[#] specifies the candidate that is in position # in the summary[#] election area/riding. | ^choice[#].party.leading | The number of seats/ridings is leading in votes (but not elected). Available only for Party scenes. | ^choice[#].party.elected | The number of seats/ridings that a party has won (elected or acclaimed) Available for Party, Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].party.media or ^summary[#].choice[#].party.media <prefix> where choice[#] specifies the candidate that is in position # in the summary[#] election area/riding. | ^choice[#].party or ^choice[#].party.code | The short name or acronym for the party. (ex: GOP for the Republicans, DEM for the Democrats) Tag is a Text object. Available for Party, Choice/Candidate and Area/Riding scenes.
For Summary scenes, use ^summary[#].choice[#].party or ^summary[#].choice[#].party.code where choice[#] specifies the candidate that is in position # in the summary[#] election area/riding. | ^choice[#].party.leading | The number of seats/ridings is leading in votes (but not elected). Tag is a Text object. Available only for Party scenes. | ^choice[#].party.elected | The number of seats/ridings that a party has won (elected or acclaimed). Tag is a Text object. Available only for Party scenes. | ^choice[#].party.total ^choice[#].party.total.prev[#] | The number of seats/ridings that a party is leading in or has won in the current election event. Tag is a Text object. For the .prev[#] tag, the number of seats/ridings that a party has won in a previous election event is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’. The previous events must be similar in terms of geographic and political purposes, e.g., Canadian Federal elections or U.S. Presidential elections on different years. Available only for Party scenes. | ^choice[#].party.total% ^choice[#].party.total%.prev[#] | The percentage of seats/ridings that a party is leading or elected in the current election event. Tag is a Text object. For the .prev[#] tag, the percentage of seats/ridings that a party was elected in previous election events is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.totaldiff ^choice[#].party.totaldiff.prev[#] | The number of seats/ridings that a party is gaining or losing in the current event as compared to the previous election event immediately before the current event. Tag is a Text object. For the .prev[#] tag, the comparison is done for the current event against the previous event specified by the index in the '[#] part. The ‘[#]’ is optional and if missing is the same as ‘[0]’, i.e., basically the same as the tag without the .prev[#] part. Available only for Party scenes. | ^choice[#].party.total^choice[#].party.total.prev[#]electedhasvotes | The number of seats/ridings with votes that a party is leading in or has won has been declared elected in for a region or all regions in the current election event. For the .prev[#] tag, the number of seats/ridings that a party has won in a previous election event is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’. The previous events must be similar in terms of geographic and political purposes, e.g., Canadian Federal elections or U.S. Presidential elections on different years Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Tag is a Text object. Available only for Party scenes. | ^choice[#].party.leadinghasvotes | The number of seats/ridings with votes that a party is leading in but not elected in for a region or all regions in the current event. Note that this only works for the current event and when the incumbent party .total%for each election area (in the current event) is set appropriately. Tag is a Text object. Available only for Party scenes. | ^choice[#].party.total%.prev[#]totalhasvotes | The percentage number of seats/ridings with votes that a party is leading in or is elected in for a region or all regions in the current election event.For the .prev[#] tag, the percentage of seats/ridings that a party was elected in previous election events is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’event. Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Tag is a Text object. Available only for Party scenes. | ^choice[#].party.seatshasvotes | The number of seats/ridings with votes for a region or all regions in the current event. Tag is a Text object. Available only for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.totaldiff ^choice[#].party.totaldiff.prev[#] The number totalhasvotes% | The percentage of seats/ridings with votes that a party is gaining or losing in the current event as compared to the previous election event immediately before the current event.For the .prev[#] tag, the comparison is done for the current event against the previous event specified by the index in the '[#] part. The ‘[#]’ is optional and if missing is the same as ‘[0]’, i.e., basically the same as the tag without the .prev[#] part.leading in or is elected in for a region or all regions the current event. Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Tag is a Text object. Available only for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.electedhasvotestotalprevhasvotes | The number of seats/ridings with votes that a party has been declared is leading in or is elected in for a region or all regions in the current eventprevious event (i.e., using the assigned incumbent party). Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Tag is a Text object. Available only for Party scenes. | ^choice[#].party.leadinghasvotestotalprevhasvotes% | The number percentage of seats/ridings with votes that a party is leading in but not or is elected in for a region or all regions in the current previous event (i.e., using the assigned incumbent party). Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Tag is a Text object. Available only for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.totalhasvotestotaldiffhasvotes | The number of seats/ridings with votes that a party is leading in gaining or is elected losing in for a region or all regions in the current event as compared to the previous election event. Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Available only for Party scenes. | ^choice[#].party.seatshasvotes | The number of seats/ridings with votes for a region or all regions in the current eventTag is a Text object. Available only for Party scenes. | ^choice[#].party.totalhasvotes%totaldiffhasvotes% | The percentage of seats/ridings with votes that a party is leading in gaining or is elected losing in for a region or all regions in the current event as compared to the previous election event. Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriatelyappropriately. Tag is a Text object. Available only for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.totalprevhasvotesvotes ^choice[#].party.votes.prev[#] | The number of seats/ridings with votes that a party is leading in or is elected in for a region or all regions in the previous event (i.e., using the assigned incumbent party). Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately.Available only for Party scenes.votes for the party in the current election event. Tag is a Text object. For the .prev[#] tag, the number of votes for the party in a previous election event is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. | ^choice[#].party.vote% or ^choice[#].party.percentage
^choice[#].party.percentagetext ^choice[#].party.totalprevhasvotes%.vote%.prev[#] | The percentage of seats/ridings with votes that a party is leading in or is elected in for a region or all regions in the previous event (i.e., using the assigned incumbent party). Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriatelyvotes for the party. Tag is a Text object. For the .prev[#] tag, the percentage of votes for the party in a previous election event is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. **See note about the Percent Sign '%' belowabout the Percent Sign '%' below. If the ^choice.party.percentagetext tag is used, the '%’ sign will be forcibly shown.
**See note about Percentage Decimal Places below. | ^choice[#].party.votediff ^choice[#].party.totaldiffhasvotesvotediff.prev[#] | The difference in the number of seats/ridings with votes that a party is gaining or losing in for a region or all regions in has for the current event as compared to the a previous election event. Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriately. Available only for Party scenes. ^choice[#].party.totaldiffhasvotes% The percentage of seats/ridings with votes that a party is gaining or losing in for a region or all regions in the current event as compared to the previous election event. Note that this only works for the current event and when the incumbent party for each election area (in the current event) is set appropriatelyTag is a Text object. For the .prev[#] tag, the # value indicates the index of the previous event to use as a comparison from the list of previous events defined via the Elections Settings dialog in the Elector Player UI. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.votesvotediff% ^choice[#].party.votesvotediff%.prev[#] | The number of votes for the party in the current election event.difference in the popular vote percentage that a party has for the current event as compared to a previous election event. Tag is a Text object. For the .prev[#] tag, the number of votes for the party in a previous election event is usedthe # value indicates the index of the previous event to use as a comparison from the list of previous events defined via the Elections Settings dialog in the Elector Player UI. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes.^choice[#].party.vote% or ^choice[#].party.percentage **See note about the Percent Sign '%' below.
**See note about Percentage Decimal Places below. | ^choice[#].party.percentagetextvoteseligible ^choice[#].party.vote%voteseligible.prev[#] | The percentage maximum number of eligible votes possible for the partyspecified region of the election event. Tag is a Text object. For the .prev[#] tag, the # value indicates the percentage index of votes for the party in a previous election event is usedto use. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. **See note about the Percent Sign '%' below. If the ^choice.party.percentagetext tag is used, the '%’ sign will be forcibly shown.
**See note about Percentage Decimal Places belowas ‘[0]’. Available only for Party scenes. | ^choice[#].party.votediffseatseligible ^choice[#].party.votediffseatseligible.prev[#] | The difference in the number of votes that a party has for the current event as compared to a previous election eventseats possible for the specified region of the election event. Tag is a Text object. For the .prev[#] tag, the # value indicates the index of the previous event to use as a comparison from the list of previous events defined via the Elections Settings dialog in the Elector Player UI. The ‘[#]’ is optional and if missing if missing is the same as ‘[0]’. Available only for Party scenes. |
POLL TAGS |
|---|
For SUMMARY scenes, add [#] for additional Summaries. ex: ^summary[1].polls.total is the total polls for the 2nd summary. ^summary.polls.total is the same as |
‘’Available only for Party Available only for Party scenes. ^choice[#].party.votediff% ^choice[#].party.votediff%.prev[#] | The difference in the popular vote percentage that a party has for the current event as compared to a previous election event. For the .prev[#] tag, the # value indicates the index of the previous event to use as a comparison from the list of previous events defined via the Elections Settings dialog in the Elector Player UI. The ‘[#]’ is optional and if missing is the same as ‘[0]’. ^choice.polls.percentage or ^choice.polls.%
^choice.polls.percentagetext | The percentage of polls reporting for the election area. Tag is a Text object. For Area/Riding and Party scenes, use the tags as shown since there is only a single polls info specified for the scene.
For Summary scenes, use ^summary[#].polls.percentage or ^summary[#].polls.% or ^summary[#].polls.percentagetext.
Not supported in Choice/Candidate scenes. **See note about the Percent Sign '%' below. |
**See note about Percentage Decimal Places below.^choice[#].party.voteseligible ^choiceIf the ^choice.polls.percentagetext or ^summary[#]. |
party.voteseligible.prev[#]The maximum number of eligible votes possible for the specified region of the election event. For the .prev[#] tag, the # value indicates the index of the previous event to use. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. | ^choice[#].party.seatseligible ^choice[#].party.seatseligible.prev[#] | The seats possible for the specified region of the election event. For the .prev[#] tag, the # value indicates the index of the previous event to use. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. | POLL TAGS |
|---|
For Summary scenes, add [#] for additional Summaries. ex: ^summary[1].polls.total is the total polls for the 2nd summary. ^summary.polls.total is the same as ^summary[0].polls.total. | ^choice.polls.percentage or ^choice.polls.%
^choice.polls.percentagetext | The percentage of polls reporting for the election areapolls.percentagetext tag is used, the '%’ sign will be forcibly shown.
**See note about Percentage Decimal Places below. | ^choice.polls.reported | The number of polls which have been reported for the election area. Tag is a Text object. For Area/Riding and Party scenes, use the tag as shown since there is only a single polls info specified for the scene.
For Summary scenes, use ^summary[#].polls.reported.
Not supported in Choice/Candidate scenes. | ^choice.polls.total | The total number of polls available for the election area. Tag is a Text object. For Area/Riding and Party scenes, use the tag as shown since there is only a single polls info specified for the scene.
For Summary scenes, use ^summary[#].postnota.
Not supported in Choice/Candidate scenes. | ^choice.polls.custom <custom polls format> | Customize the display of polling information. Note that the angle brackets characters < > are required. Any text within the < > brackets that are not encapsulated in { } brackets will be treated as literals and will be output as is. Tag is a Text object. For Area/Riding and Party scenes, use the tags tag as shown since there is only a single polls info specified for the scene.
For Summary scenes, use ^summary[#].polls.percentage or ^summary[#].polls.% or ^summary[#].polls.percentagetext.custom <custom polls format>.
Not supported in Choice/Candidate scenes. **See note about the Percent Sign '%' below. If the ^choice.polls.percentagetext or ^summary[#].polls.percentagetext tag is used, the '%’ sign will be forcibly shown.
**See note about Percentage Decimal Places below. | ^choice.polls.reported | The number of polls which have been reported for the election area. The available poll format tags are: {polls} {polls%} {totalpolls}.
Example: <{polls} / {totalpolls}> will display the polling results with something like: 123 / 1000. |
EVENT TAGS |
|---|
If available, add [#] for additional Events or Summaries. ex: ^choice[1].event.date is the name for the 2nd event. ^choice.event.date is the same as ^choice[0].event.date. | ^choice.event.date | The date for the election event. Tag is a Text object. For Area/Riding and Party scenes, use the tag as shown since there is only a single |
polls info specified for the scene.For Summary scenes, use ^summary[#].polls.reported.Not supported in Choice/Candidate event specified for the scene.
For Choice/Candidate scenes, use ^choice[#].event.date to target the specific candidate’s event.
For Summary scenes, use ^summary.event.date. There is only a single event specified for the scene. | ^choice.event.date.prev[#] | The date for a previous election event. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Tag is a Text object. Available only for Party scenes. | ^choice. |
pollstotal total number polls available for areaevent. Tag is a Text object. For Area/Riding and Party scenes, use the tag as shown since there is only a single |
polls info event specified for the scene.
For |
Summary Choice/Candidate scenes, use |
^summarypolls.total.Not supported in Choice/Candidate scenes.^choice.polls.custom <custom polls format> | Customize the display of polling information. Note that the angle brackets characters < > are required. For Area/Riding and Party scenes, use the tag as shown since there is only a single polls info specified for the sceneevent.year to target the specific candidate’s event.
For Summary scenes, use ^summary |
[#].polls.custom <custom polls format>.Not supported in Choice/Candidate scenes.The available poll format tags are: {polls} {polls%} {totalpolls}.
Example: <{polls} / {totalpolls}> will display the polling results with something like: 123 / 1000. EVENT TAGS |
|---|
If available, add [#] for additional Events or Summaries. ex: ^choice[1].event.date is the name for the 2nd event. ^choice.event.date is the same as ^choice[0].event.date. | ^choice.event.date | The date for the election event. .event.year. There is only a single event specified for the scene. | ^choice.event.year.prev[#] | The year for a previous election event. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Tag is a Text object. Available only for Party scenes. | ^choice.event or ^choice.event.name | The name of the election event. Tag is a Text object. For Area/Riding and Party scenes, use the tag tags as shown since there is only a single event specified for the scene.
For Choice/Candidate scenes, use ^choice[#].event or ^choice[#].event.datename to target the specific candidate’s event.
For Summary scenes, use ^summary.event.datename. There is only a single event specified for the scene. | ^choice.event.datename.prev[#] | The date for a name of the previous election event. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Tag is a Text object. Available only for Party scenes. | ^choice.event.year | The year of the election event. For Area/Riding and Party scenes, use the tag
AREA TAGS |
|---|
If available, add [#] for additional Choices or Summaries. ex: ^choice[1].area.name is the name for the 2nd area. ^choice.area.name is the same as ^choice[0].area.name. | ^choice.area or ^choice.area.name | The name of the election area (ex: Region or Riding) Tag is a Text object. For Party and Area/Riding scenes, use the tags as shown since there is only a single |
event area specified for the scene.
For Choice/Candidate scenes, use ^choice[#]. |
event.year to target the specific candidate’s eventarea or ^choice[#].area.name.
For Summary scenes, use ^summary |
.event.year. There is only a single event specified for the scene.^choice.event.year.prevThe year for a previous election event. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes.area or ^summary[#].area.name. | ^choice. |
event or ^choice.event.nameregion | The name of the election |
eventRegion. Tag is a Text object. For Area/Riding |
and Party use the tags as shown since there is only a single event specified for the scene.For Choice/Candidate this provides the name of the region that the area/riding belongs to.
Not supported in Choice/Candidate scenes.
For Party scenes, use ^choice |
[#]event[#]eventto target the specific candidate’s event instead.
For Summary scenes, use ^summary. |
eventname. There is only a single event specified for the scene. | ^choice.area.nameline1
^choice. |
event.name.prev[#]The name of the previous election event. The ‘[#]’ is optional and if missing is the same as ‘[0]’. Available only for Party scenes. | AREA TAGS |
|---|
If available, add [#] for additional Choices or Summaries. ex: ^choice[1].area.name is the name for the 2nd area. ^choice.area.name is the same as ^choice[0].area.name. | ^choice.area or ^choice.area.name | The name of the election area (ex: Region or Riding) For Party and area.nameline2 | The area/riding name that is split into 2 lines. This is for use with graphics that are too short to hold the entire name of the riding in a single line. The 2 lines of text are assigned using Elector Flow. Tags are Text objects. For Area/Riding scenes, use the tags as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choice[#].nameline1 and ^choice[#].area.nameline2.
For Summary scenes, use ^summary[#].area.nameline1 and ^summary[#].area.nameline2.
Not supported in Party scenes. | ^choice.area.ID | An numeric value assigned as the ID for an area/riding. This ID is usually provided by the datafeed. In the absence of a datafeed ID, the database record number is used instead. Tag is a Text object. For Area/Riding scenes, use the tags tag as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choice[#].area or , use ^choice[#].area.nameID.
For Summary scenes, use ^summary[#].area or ^summary[#].area.name.^choice.area.nameline1.ID.
Not supported in Party scenes. | ^choice.area.nameline2details | The Details about the area/riding name that is split into 2 lines. This is for use with graphics that are too short to hold the entire name of the riding in a single line. The 2 lines of text are assigned using Elector Flow.. Tag is a Text object. For Area/Riding scenes, use the tags tag as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choice[#].nameline1 and ^choice[#].area.nameline2details.
For Summary scenes, use ^summary[#].area.nameline1 and ^summary[#].area.nameline2.details.
Not supported in Party scenes. | ^choice.area.IDAn numeric value assigned as the ID for an electors | The number of electors available for the area/riding. This ID is usually provided by the datafeed. In the absence of a datafeed ID, the database record number is used instead Tag is a Text object. For Area/Riding scenes, use the tag as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choice[#].area.IDelectors.
For Summary scenes, use ^summary[#].area.IDelectors.
Not supported in Party scenes. | ^choice.area.detailsDetails about mailballots | The number of mail-in ballots submitted for the area/riding. Tag is a Text object. For Area/Riding scenes, use the tag as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choice[#].area.detailsmailballots.
For Summary scenes, use ^summary[#].area.detailsmailballots.
Not supported in Party scenes. | ^choice^summary[#].area.electorstotalvotes | The total number of electors available for votes in the area/riding .For Area/Riding scenes, use the tag as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choicefor summary [#]. Tag is a Text object. Only for Summary scenes. | ^summary[#].area.electors.
For Summary scenes, use partyincumbent or ^summary[#].area.electors.
Not supported in Party scenes. | ^choice.area.mailballots | The number of mail-in ballots submitted for the area/riding. For Area/Riding scenes, use the tag as shown since there is only a single area specified for the scene.
For Choice/Candidate scenes, use ^choice[#].area.mailballots.
For Summary scenes, use ^summary[#].area.mailballots.
Not supported in Party scenes. | ^summary[#].area.totalvotes | The total number of votes in the area/riding for summary [#]. Only for Summary scenes. | ^summary[#].area.partyincumbent or ^summary[#].area.partyincumbent.code | The short name or acronym for the party that won the area/riding prior to the current election event. Only for Summary scenes. | ^summary[#].area.partyincumbent.name | The full name of the party that won the area/riding prior to the current election event. Only for Summary scenes. |
TEXT CAPTIONS |
|---|
Add [#] for additional Captions. ex: ^caption[1].label for the 2nd text caption. ^caption.label is the same as ^caption[0].label | ^caption.<label> | Text caption with optional label to show in the Elector Player and the Elector Flow Playlist Builder module.partyincumbent.code | The short name or acronym for the party that won the area/riding prior to the current election event. Tag is a Text object. Only for Summary scenes. | ^summary[#].area.partyincumbent.name | The full name of the party that won the area/riding prior to the current election event. Tag is a Text object. Only for Summary scenes. |
TEXT CAPTIONS |
|---|
This tag is available for all scene types except BACKGROUND scenes. Add [#] for additional Captions. ex: ^caption[1].label for the 2nd text caption. ^caption.label is the same as ^caption[0].label | ^caption.label | Text caption with optional label to show in the Elector Player and the Elector Flow Playlist Builder module. Tag is a Text object. |
TICKER TAGS |
|---|
These tags are only available for TICKER scenes. | ^story or ^content or ^story.content | Contents of an RSS News item. Tag is a Text object. | ^header or ^story.header | Title of an RSS News item. Tag is a Text object. |
SPECIAL TAGS |
|---|
### | Each election area or riding's representative graphic element for use in a party map. Each riding is marked with the colour of the party's candidate who is in the lead or who is elected. Otherwise, the riding is black (or whatever colour is designated as being vacant in the project). The tag should be in a 3 digit format (e.g., 001). Tags are Graphics objects. Only for Party Map scenes. |
|