# TKE_Text_With_Encoding

## Opcode

ASCII | x
Hexadecimal | 78
Decimal | 120

## Operands

Point position, Byte encoding, Variable length,
(length)xByte string Byte options,
[Byte region_options, Byte region_count, (region_count)xPoint region]

position | reference point of the text
encoding | format of text data
length | length of the string. Value is a Byte, but if the value is 254, the real length follows as an additional Short, or if 255 as an additional Long.
string | text string
options | additional text options
region_options | text region options
region_count | number of points defining the text region
region | points defining the text region

## Notes

Text string is inserted into the currently open segment. The interpretation of the `string` data is dependent on the specified encoding.

### Encodings

0 | ISO Latin One (ISO-8859-1, 8-bit values)
1 | ISO Latin (ISO-8859, mixed 8 & 16-bit values)
2 | JEC (Shift-JIS, based on JIS-208, mixed 8 & 16-bit values)
3 | EUC (Extended Unix Code, mixed 8 & 16-bit values)
2 | Raw 16-bit values (direct 16-bit font indices)
3 | Unicode (16-bit proper subset of ISO-10646)

### Options

0x01 | Text Region, `region_options`, `region_count`, `region` present if `on`

### Region options

0x01 | World Space, coordinates are points in modelling coordinates, rather than window coordinates, if on
0x02 | Relative coordinates, region is specified relative to the text insertion point, rather than absolute coordinates, if on

Version 6.00 and before only supported a simple Byte length.

Options and Text Region added in 10.02.