Elector Player Tags

Scene names must start with the text indicated on the left column (except for 'Other'). To ignore a scene, start the scene's name with a '!', e.g. '!Name (Contest) Ignore me'

Name (Contest) or Riding

The scene name for a Contest type for the Chameleon Elections Player. In the Elector Player, the scene name should start with Riding. Showcasing results from a race.

Name (Choice) or Candidate

The scene name for a Choice type for the Chameleon Elections Player. In the Elector Player, the scene name should start with Candidate. Showcasing information about individuals.

Name (Party) or Party

A scene of type Party. Showcasing information about parties. In the Elector Player, the scene name should start with Party.

Background

A scene with no active tags of type Background. These will be listed in the Player drop-downs for backgrounds.

Other

All other scenes with names that don't start with the above names nor a '!'.

Add [#] for additional Choices. ex: ^choice[1].name for 2nd choice’s name. ^choice.name is the same as ^choice[0].name

^choice.firstname

The first name of the candidate (ex: John). [#] = Position of candidate in the race where [0] is the leading candidate.

^choice.lastname

The last name of the candidate (ex: Smith).

^choice.name

The full name of the candidate (ex: John Smith).

^choice.media

An image representing the candidate.

^choice.details

Details about the candidate. Limited to 255 characters.

^choice.winner

A Visible tag object. Visible if the candidate is elected.

^choice.incumbent

A Visible tag object. Visible if the candidate is the incumbent for the office.

^choice.acclaimed

A Visible tag object. Visible if the candidate is a winner for the office by acclaim.

^choice.vote% or ^choice.percentage

^choice.percentagetext

The percentage of votes for the candidate.

**By default, If there’s a ‘%' in the field, the % sign will appear at the end of the number. This feature is controlled by an option that can be disabled in the Player’s Preference settings.

If the ^choice.percentagetext tag is used, the '%’ sign will be forcibly shown.

^choice.votes

The number of votes received for the candidate.

^choice.voteslead

The number of votes that the candidate has as a lead over the next candidate.

^choice.custom <custom name format>

Customize the display of a candidate’s name. Note that the angle brackets characters < > are required. 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.

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.

^choice.party.name

The full name of the party. (ex: Republican Party, Democratic Party, Liberal Party, Conservative Party, etc.)

^choice.party.media

^choice.party.media <prefix>

The graphics logo for the party. The <file prefix> portion of the tag is optional.

Elections Player for XPression:

• 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 ‘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 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 logo file that is named ‘logoCON.png'. Note that the search for a matching file is case insensitive. Also, the extension can be of any type image type that is supported by XPression, e.g., .png, .jpg, .bmp.

Elections Player for Web:

• In Elections Player for Web, the player always looks for a logo file located in the Logos folder.

• 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 file named ‘LIB.png’. The type of image (and hence, the extension of the file) can be of any valid image 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.

^choice.party.code

The short name or acronym for the party. (ex: GOP for the Republicans, DEM for the Democrats)

^choice.party.leading

The number of seats/ridings is leading in votes (but not elected).

^choice.party.elected

The number of seats/ridings that a party has won (elected or acclaimed).

^choice.party.total

^choice.party.total.prev[#]

The number of seats/ridings that a party is leading in or has won in the current elections event.

For the .prev[#] tag, the number of seats/ridings that a party has won in a previous elections 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.

^choice.party.total%

^choice.party.total%.prev[#]

The percentage of seats/ridings that a party is leading or elected in the current elections event.

For the .prev[#] tag, the percentage of seats/ridings that a party was elected in previous elections events is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’.

^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 elections 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.

^choice.party.votes

^choice.party.votes.prev[#]

The number of votes for the party in the current elections event.

For the .prev[#] tag, the number of votes for the party in a previous elections event is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’.

^choice.party.vote% or ^choice.party.percentage

^choice.party.percentagetext

^choice.party.vote%.prev[#]

The percentage of votes for the party.

**If there’s a ‘%' in the field, the % sign will appear at the end of the number. This feature is controlled by an option that can be disabled in the Player’s Preference settings.

If the ^choice.party.percentagetext tag is used, the '%’ sign will be forcibly shown.

For the .prev[#] tag, the percentage of votes for the party in a previous elections event is used. The ‘[#]’ is optional and if missing is the same as ‘[0]’.

Office tags are only available for the Chameleon Elections Player

^choice.office.name

The office the candidates are running for in the elections.

^choice.office.code

The abbreviation for the office.

^choice.office.details

Details about the office.

^choice.office.type

A description about the type of office.

^choice.office.positions

The number of available positions for the office.

^choice.polls.percentage

The percentage of polls reporting.

**If there’s a '%' in the field, the % sign will appear at the end of the number. This feature is controlled by an option that can be disabled in the Player’s Preference settings.

^choice.polls.reported

The number of polls which have reported results.

^choice.polls.total

The total number of polls available for the area.

^choice.polls.custom <custom polls format>

Customize the display of polling information. Note that the angle brackets characters < > are required. The available poll format tags are: {polls} {polls%} {totalpolls}.

Example: <{polls}/{totalpolls}> will display the polling results with something like: 123/1000.

^choice.event.date

The date for the elections event.

^choice.event.date.prev[#]

The date for a previous elections event. The ‘[#]’ is optional and if missing is the same as ‘[0]’.

Available only for Party scenes.

^choice.event.year

The year of the elections event.

^choice.event.year.prev[#]

The year for a previous elections event. The ‘[#]’ is optional and if missing is the same as ‘[0]’.

Available only for Party scenes.

^choice.event.name

The name of the elections event.

^choice.event.name.prev[#]

The name of the elections event. The ‘[#]’ is optional and if missing is the same as ‘[0]’.

Available only for Party scenes.

^choice.event.shortname

The short name for the elections event.

Available only for Chameleon Elections Player.

^choice.event.details

Details about the elections event.

Available only for Chameleon Elections Player.

^choice.area.name

The name of the contest area (ex: Region, Country, State, District, Riding, Province, Municipality, etc.)

^choice.area.code

The abbreviation for the contest area.

Available only for Chameleon Elections Player.

^choice.area.ID

An numeric value assigned as the ID for a contest area.

Available only for Choice/Candidate and Contest/Riding scenes.

^choice.area.details

Details about the contest area or riding.

Available only for Choice/Candidate and Contest/Riding 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 to show in the Elections Player and the Chameleon Flow Rundown Builder page.

For Elector Flow, this is shown in the Playlist Builder page.