Share via

2.3.22.10 Geometry Text Boolean Properties

  • Article

The Geometry Text Boolean Properties specify a 32-bit field of Boolean values for text that is drawn with visual effects.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

opid

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

S

T

U

V

W

X

Y

Z

a

b

c

d

e

f

opid (2 bytes): An OfficeArtFOPTEOPID record, as defined in section 2.2.8, that specifies the header for this property. The following table specifies the subfields.

Field

Meaning

opid.opid

A value that MUST be 0x00FF.

opid.fBid

A value that MUST be 0x0.

opid.fComplex

A value that MUST be 0x0.

A - fUsegtextFReverseRows (1 bit): A bit that specifies whether the gtextFReverseRows bit is set. A value of 0x0 specifies that the gtextFReverseRows bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

B - fUsefGtext (1 bit): A bit that specifies whether the fGtext bit is set. A value of 0x0 specifies that the fGtext bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

C - fUsegtextFVertical (1 bit):  A bit that specifies whether the gtextFVertical bit is set. A value of 0x0 specifies that the gtextFVertical bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

D - fUsegtextFKern (1 bit):  A bit that specifies whether the gtextFKern bit is set. A value of 0x0 specifies that the gtextFKern bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

E - fUsegtextFTight (1 bit):  A bit that specifies whether the gtextFTight bit is set. A value of 0x0 specifies that the gtextFTight bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

F - fUsegtextFStretch (1 bit):  A bit that specifies whether the gtextFStretch bit is set. A value of 0x0 specifies that the gtextFStretch bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

G - fUsegtextFShrinkFit (1 bit):  A bit that specifies whether the gtextFShrinkFit bit is set. A value of 0x0 specifies that the gtextFShrinkFit bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

H - fUsegtextFBestFit (1 bit):  A bit that specifies whether the gtextFBestFit bit is set. A value of 0x0 specifies that the gtextFBestFit bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

I - fUsegtextFNormalize (1 bit):  A bit that specifies whether the gtextFNormalize bit is set. A value of 0x0 specifies that the gtextFNormalize bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

J - fUsegtextFDxMeasure (1 bit):  A bit that specifies whether the gtextFDxMeasure bit is set. A value of 0x0 specifies that the gtextFDxMeasure bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

K - fUsegtextFBold (1 bit): A bit that specifies whether the gtextFBold bit is set. A value of 0x0 specifies that the gtextFBold bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

L - fUsegtextFItalic (1 bit): A bit that specifies whether the gtextFItalic bit is set. A value of 0x0 specifies that the gtextFItalic bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

M - fUsegtextFUnderline (1 bit): A bit that specifies whether the gtextFUnderline bit is set. A value of 0x0 specifies that the gtextFUnderline bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

N - fUsegtextFShadow (1 bit): A bit that specifies whether the gtextFShadow bit is set. A value of 0x0 specifies that the gtextFShadow bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

O - fUsegtextFSmallcaps (1 bit): A bit that specifies whether the gtextFSmallcaps bit is set. A value of 0x0 specifies that the gtextFSmallcaps bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

P - fUsegtextFStrikethrough (1 bit): A bit that specifies whether the gtextFStrikethrough bit is set. A value of 0x0 specifies that the gtextFStrikethrough bit MUST be ignored and the default value used instead. The default value of this property is 0x0.

Q - gtextFReverseRows (1 bit): A bit that specifies whether the order in which lines of geometry text are laid out SHOULD<63> be reversed. This bit is applicable only if the geometry text is vertically oriented, as specified by gtextFVertical; otherwise, it MAY be any value. This value MUST be ignored if fUsegtextFReverseRows is 0x0. The default value of this property is 0x0.

R - fGtext (1 bit): A bit that specifies whether this shape has geometry text. If fGtext is 0x1, the gtextUNICODE_complex property, as defined in section 2.3.22.2, MUST exist. This value MUST be ignored if fUsefGtext is 0x0. The default value of this property is 0x0.

S - gtextFVertical (1 bit): A bit that specifies whether the characters of the geometry text for this shape are laid out vertically rather than horizontally. This value MUST be ignored if fUsegtextFVertical is 0x0. The default value of this property is 0x0.

T - gtextFKern (1 bit): A bit that specifies whether the geometry text of this shape SHOULD<64> use kerning. This value MUST be ignored if fUsegtextFKern is 0x0. The default value of this property is 0x0.

U - gtextFTight (1 bit): A bit that specifies the quantity that the scaling factor, as specified by the gtextSpacing property, SHOULD<65> be applied to. The following table describes the effect of each value for this bit. This value MUST be ignored if fUsegtextFTight is 0x0. The default value of this property is 0x0.

Value

Meaning

0x0

Tightening—the value of gtextSpacing is used to scale the character advance width, as shown in the following figure.

The value of gtextSpacing is used to scale the character advance width

The A spacing is the width to add to the current position before placing the character. The B spacing is the width of the character itself. The C spacing is the white space to the right of the character. The total advance width is determined by calculating the sum of A+B+C. Because characters can overhang or underhang the character cell, either or both of the A and C increments can be negative numbers.

0x1

Tracking—the value of gtextSpacing is used to scale the amount of spacing between the characters.

V - gtextFStretch (1 bit): A bit that specifies whether the geometry text of this shape SHOULD<66> be stretched to fit the bounding rectangle of the container. This value MUST be ignored if fUsegtextFStretch is 0x0. The default value of this property is 0x0.

W - gtextFShrinkFit (1 bit): A bit that specifies whether the bounding rectangle of the geometry text SHOULD<67> be measured according to the bounding rectangle of the characters that are used in the string, rather than according to the bounding rectangle of the characters in the font. The following table shows the effect of this bit on the bounding rectangle of the geometry text. This bit is applicable only if gtextFStretch is 0x1 and fUsegtextFStretch is 0x1; otherwise, it MAY be any value. This value MUST be ignored if fUsegtextFShrinkFit is 0x0.

Value

Meaning

0x0

The bounding rectangle of the geometry text is measured according to the bounding rectangle of the characters in the font.

 The bounding rectangle of the geometry text is measured according to the bounding rectangle of the characters in the font

0x1

The bounding rectangle of the geometry text is measured according to the bounding rectangle of the characters that are used in the string.

 The bounding rectangle of the geometry text is measured according to the bounding rectangle of the characters that are used in the string

X - gtextFBestFit (1 bit): A bit that specifies whether the geometry text SHOULD<68> be stretched to fill the entire line. Stretching occurs in the same direction as the orientation of the geometry text, as specified by gtextFVertical. This bit is applicable only if gtextFStretch is 0x0 or fUsegtextFStretch is 0x0; otherwise, it MAY be any value. This value MUST be ignored if fUsegtextFBestFit is 0x0. The default value of this property is 0x0.

Y - gtextFNormalize (1 bit): A bit that specifies whether every character in the geometry text is adjusted to fill the available space for that character. The definition of the available space varies based on the text orientation, as specified by gtextFVertical. The following table shows how the text orientation affects the normalization of the text. This value MUST be ignored if fUsegtextFNormalize is 0x0.

Text orientation

Original text

Normalized text

Horizontal

Original horizontal text

Normalized horizontal text. Characters are all sized the same

Vertical

Original vertical text

 Normalized vertical text. Characters are resized to be the same size

Z - gtextFDxMeasure (1 bit): A bit that specifies whether the distance that is used to calculate the amount to warp text along the geometry of this shape SHOULD<69> use only the x component rather a combination of the x and y components. This value MUST be ignored if fUsegtextFDxMeasure is 0x0. The default value of this property is 0x0.

a - gtextFBold (1 bit): A bit that specifies whether this geometry text uses bold text. This value MUST be ignored if fUsegtextFBold is 0x0. The default value of this property is 0x0.

b - gtextFItalic (1 bit): A bit that specifies whether this geometry text uses italics. This value MUST be ignored if fUsegtextFItalic is 0x0. The default value of this property is 0x0.

c - gtextFUnderline (1 bit): A bit that specifies whether this geometry text uses an underline effect on the text characters. This value SHOULD<70> be ignored. This value MUST be ignored if fUsegtextFUnderline is 0x0. The default value of this property is 0x0.

d - gtextFShadow (1 bit): A bit that specifies whether this geometry text uses a shadow effect on the text characters. This value SHOULD be ignored. This value MUST be ignored if fUsegtextFShadow is 0x0. The default value of this property is 0x0.

e - gtextFSmallcaps (1 bit): A bit that specifies whether this geometry text shows every character in uppercase, with the lowercase characters in the text being smaller-sized versions of their uppercase counterparts. This value SHOULD<71> be ignored. This value MUST be ignored if fUsegtextFSmallcaps is 0x0. The default value of this property is 0x0.

f - gtextFStrikethrough (1 bit): A bit that specifies whether this geometry text has strikethrough formatting. This value SHOULD<72> be ignored. This value MUST be ignored if fUsegtextFStrikethrough is 0x0. The default value of this property is 0x0.