votorola.s.gwt.stage.vote

Interface LightableDifference

All Known Implementing Classes:

LightableDifference1, ShadowedDiff

public interface LightableDifference

A difference that is lightable by a DifferenceLight. It corresponds to the difference (perhaps empty) between a position represented in the vote track and that of the anchoring author. Difference lighting in general is mediated by style classes set on the #StageV-top element and the document body. The #StageV-top element gets classes for all differences (up to MAX_DIFFS) that have representation in the track, each class being named after the cast relation of the other author in regard to the anchoring author. At most one of these differences is spotlit at a given time, the spotlight being implemented by two or three classes set on document body as detailed in the following table.

Relation	stageRelClass	bodyRelClass	bodySecClass	Ordinal	bodyOrdClass
Voter	vDS	voLiDi-rel-v	voLiDi-DS	a	voLiDi-ord-a
Co-voter	oDS	voLiDi-rel-o	voLiDi-DS	a	voLiDi-ord-a
				b	voLiDi-ord-b
Tight cycler	y	voLiDi-rel-y	none	a	voLiDi-ord-a
				b	voLiDi-ord-b
Base co-candidate	oDS	voLiDi-rel-o	voLiDi-DS	a	voLiDi-ord-a
				b	voLiDi-ord-b
Candidate	c	voLiDi-rel-c	none	b	voLiDi-ord-b

The variable DS is the other author's dart sector, from 0 to 20.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	LightableDifference.Runner<D extends LightableDifference> A routine that runs in the context of a lightable difference.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACTOR_LINK_VARIANT_BASE The base "VoteTrack-spotlit" for all values of actorLinkVariant(), which is itself a valid default variant.
static String	BODY_REL_PREFIX The common prefix "voLiDi-rel-" for all values of the bodyRelClass().
static String	BODY_SEC_PREFIX The common prefix "voLiDi-" for all values of the bodyRelClass().
static char	REL_CANDIDATE The style symbol 'c' for the candidate cast relation.
static char	REL_CO The style symbol 'o' for the co-voter and base co-candidate cast relations.
static char	REL_TIGHT_CYCLE The style symbol 'y' for the base co-candidate cast relation when there is a tight cycle between the anchor and the other person.
static char	REL_UNKNOWN The style symbol 'u' for the unknown cast relation.
static char	REL_VOTER The style symbol 'v' for the voter cast relation.
static Typifier	TYPIFIER A typifier for LightableDifference.

Method Summary

Methods

Modifier and Type	Method and Description
String	actorLinkVariant() The style variant for actor dependent links in the link track.
String	bodyOrdClass() The name of the ordinal style class to set on the document body when this lightable difference is lit.
String	bodyRelClass() The name of the cast-relational style class to set on the document body when this lightable difference is lit.
String	bodySecClass() The name of the dart-sectoral style class to set on the document body when this lightable difference is lit, or null of there is none.
String	personName() The name of the other author, as opposed to the anchoring author.
String	pollName() The name of the poll.
String	stageRelClass() The name of the cast-relational style class to set on the #StageV-top element, indicating the existence of this lightable difference.

Field Detail

ACTOR_LINK_VARIANT_BASE

static final String ACTOR_LINK_VARIANT_BASE

The base "VoteTrack-spotlit" for all values of actorLinkVariant(), which is itself a valid default variant.

See Also:

Constant Field Values

BODY_REL_PREFIX

static final String BODY_REL_PREFIX

The common prefix "voLiDi-rel-" for all values of the bodyRelClass().

See Also:

Constant Field Values

BODY_SEC_PREFIX

static final String BODY_SEC_PREFIX

The common prefix "voLiDi-" for all values of the bodyRelClass().

See Also:

Constant Field Values

REL_CANDIDATE

static final char REL_CANDIDATE

The style symbol 'c' for the candidate cast relation.

REL_CO

static final char REL_CO

The style symbol 'o' for the co-voter and base co-candidate cast relations.

REL_TIGHT_CYCLE

static final char REL_TIGHT_CYCLE

The style symbol 'y' for the base co-candidate cast relation when there is a tight cycle between the anchor and the other person.

See Also:

Constant Field Values

REL_UNKNOWN

static final char REL_UNKNOWN

The style symbol 'u' for the unknown cast relation.

See Also:

Constant Field Values

REL_VOTER

static final char REL_VOTER

The style symbol 'v' for the voter cast relation.

TYPIFIER

static final Typifier TYPIFIER

A typifier for LightableDifference.

Method Detail

actorLinkVariant

String actorLinkVariant()

The style variant for actor dependent links in the link track.

bodyOrdClass

String bodyOrdClass()

The name of the ordinal style class to set on the document body when this lightable difference is lit.

See Also:

Normal order

bodyRelClass

String bodyRelClass()

The name of the cast-relational style class to set on the document body when this lightable difference is lit.

bodySecClass

String bodySecClass()

The name of the dart-sectoral style class to set on the document body when this lightable difference is lit, or null of there is none.

personName

String personName()

The name of the other author, as opposed to the anchoring author.

pollName

String pollName()

The name of the poll.

stageRelClass

String stageRelClass()

The name of the cast-relational style class to set on the #StageV-top element, indicating the existence of this lightable difference.