Class dnx.lr.node.FontStyleNode 
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class dnx.lr.node.FontStyleNode 

java.lang.Object
   |
   +----dnx.util.DNXObject
           |
           +----dnx.lr.Node
                   |
                   +----dnx.lr.SubsidiaryNode
                           |
                           +----dnx.lr.node.FontStyleNode
public class FontStyleNode
extends SubsidiaryNode 
 FontStyle {
    field        SFString     family          "SERIF"
    field        SFBool       horizontal      TRUE
    field        MFString     justify         "BEGIN"
    field        SFString     language        ""
    field        SFBool       leftToRight     TRUE
    field        SFFloat      size            1.0
    field        SFFloat      spacing         1.0
    field        SFString     style           "PLAIN"
    field        SFBool       topToBottom     TRUE
 }

The FontStyle node defines the size, font family, and style of text's font, as well as the direction of the text strings and any specific language rendering techniques that must be used for non-English text. See Text node for application of FontStyle.

The size field specifies the height (in object space units) of glyphs rendered and determines the spacing of adjacent lines of text. All subsequent strings advance in either X or Y by -( size * spacing).

Font Family and Style

Font attributes are defined with the family and style fields. It is up to the browser to assign specific fonts to the various attribute combinations.

The family field specifies a case-sensitive SFString value that may be "SERIF" (the default) for a serif font such as Times Roman; "SANS" for a sans-serif font such as Helvetica; or "TYPEWRITER" for a fixed-pitch font such as Courier. A family value of empty quotes, "", is identical to "SERIF".

The style field specifies a case-sensitive SFString value that may be "PLAIN" (the default) for default plain type; "BOLD" for boldface type; "ITALIC" for italic type; or "BOLDITALIC" for bold and italic type. A style value of empty quotes, "", is identical to "PLAIN".

Direction, Justification and Spacing

The horizontal, leftToRight, and topToBottom fields indicate the direction of the text. The horizontal field indicates whether the text advances horizontally in its major direction (horizontal = TRUE, the default) or vertically in its major direction (horizontal = FALSE). The leftToRight and topToBottom fields indicate direction of text advance in the major (characters within a single string) and minor (successive strings) axes of layout. Which field is used for the major direction and which is used for the minor direction is determined by the horizontal field.

For horizontal text (horizontal = TRUE), characters on each line of text advance in the positive X direction if leftToRight is TRUE or in the negative X direction if leftToRight is FALSE. Characters are advanced according to their natural advance width. Then each line of characters is advanced in the negative Y direction if topToBottom is TRUE or in the positive Y direction if topToBottom is FALSE. Lines are advanced by the amount of size * spacing.

For vertical text (horizontal = FALSE), characters on each line of text advance in the negative Y direction if topToBottom is TRUE or in the positive Y direction if topToBottom is FALSE. Characters are advanced according to their natural advance height. Then each line of characters is advanced in the positive X direction if leftToRight is TRUE or in the negative X direction if leftToRight is FALSE. Lines are advanced by the amount of size * spacing.

The justify field determines alignment of the above text layout relative to the origin of the object coordinate system. It is an MFString which can contain 2 values. The first value specifies alignment along the major axis and the second value specifies alignment along the minor axis, as determined by the horizontal field. A justify value of "" is equivalent to the default value. If the second string, minor alignment, is not specified then it defaults to the value "FIRST". Thus, justify values of "", "BEGIN", and ["BEGIN" "FIRST"] are equivalent.

The major alignment is along the X axis when horizontal is TRUE and along the Y axis when horizontal is FALSE. The minor alignment is along the Y axis when horizontal is TRUE and along the X axis when horizontal is FALSE. The possible values for each enumerant of the justify field are "FIRST", "BEGIN", "MIDDLE", and "END". For major alignment, each line of text is positioned individually according to the major alignment enumerant. For minor alignment, the block of text representing all lines together is positioned according to the minor alignment enumerant. The following table describes the behavior in terms of which portion of the text is at the origin:

Major Alignment, horizontal = TRUE:

Enumerant leftToRight = TRUE leftToRight = FALSE
 FIRST  Left edge of each line  Right edge of each line
 BEGIN  Left edge of each line  Right edge of each line
 MIDDLE  Centered about X-axis  Centered about X-axis
 END  Right edge of each line  Left edge of each line

Major Alignment, horizontal = FALSE:

Enumerant topToBottom = TRUE topToBottom = FALSE
 FIRST  Top edge of each line  Bottom edge of each line
 BEGIN  Top edge of each line  Bottom edge of each line
 MIDDLE  Centered about Y-axis  Center about Y-axis
 END  Bottom edge of each line  Top edge of each line

Minor Alignment, horizontal = TRUE:

Enumerant topToBottom = TRUE topToBottom = FALSE
 FIRST  Baseline of first line  Baseline of first line
 BEGIN  Top edge of first line  Bottom edge of first line
 MIDDLE  Centered about Y-axis  Centered about Y-axis
 END  Bottom edge of last line   Top edge of last line

Minor Alignment, horizontal = FALSE:

Enumerant leftToRight = TRUE leftToRight = FALSE
 FIRST  Left edge of first line  Right edge of first line
 BEGIN  Left edge of first line  Right edge of first line
 MIDDLE  Centered about X-axis  Centered about X-axis
 END  Right edge of last line  Left edge of last line

The default minor alignment is "FIRST". This is a special case of minor alignment when horizontal is TRUE. Text starts at the baseline at the Y-axis. In all other cases, :"FIRST" is identical to "BEGIN". In the following tables, each color-coded cross-hair indicates where the X and Y axes should be in relation to the text:


horizontal = TRUE:

Horizontal Text Table


horizontal = FALSE:

Vertical Text Table

The language field specifies the context of the language for the text string. Due to the multilingual nature of the ISO 10646-1:1993, the language field is needed to provide a proper language attribute of the text string. The format is based on the POSIX locale specification as well as the RFC 1766: language[_territory]. The values for the language tag is based on the ISO 639, i.e. zh for Chinese, jp for Japanese, sc for Swedish. The territory tag is based on the ISO 3166 country code, i.e. TW is for Taiwan and CN for China for the "zh" Chinese language tag. If the language field is set to empty "", then local language bindings are used.

Please refer to these sites for more details: 

     http://www.chemie.fu-berlin.de/diverse/doc/ISO_639.html
     http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html

Variable Index

o family
o horizontal
o justify
o language
o leftToRight
o size
o spacing
o style
o topToBottom

Constructor Index

o FontStyleNode()

Method Index

o createNodeDefinition(NodeDefinition)
Create the node definition.
o initFields()
Initialize field values.

Variables

o family 
  public SFString family
o horizontal 
  public SFBool horizontal
o justify 
  public MFString justify
o language 
  public SFString language
o leftToRight 
  public SFBool leftToRight
o size 
  public SFFloat size
o spacing 
  public SFFloat spacing
o style 
  public SFString style
o topToBottom 
  public SFBool topToBottom

Constructors

o FontStyleNode 
  public FontStyleNode()

Methods

o createNodeDefinition 
  protected void createNodeDefinition(NodeDefinition def)
Create the node definition.
Overrides:
createNodeDefinition in class Node
o initFields 
  protected void initFields()
Initialize field values.
Overrides:
initFields in class Node 
All Packages  Class Hierarchy  This Package  Previous  Next  Index