Struct CidShowElement 

#[non_exhaustive]
pub struct CidShowElement {
    pub cid: u16,
    pub adjust: f32,
    pub x_offset: f32,
}

One element of a positioned glyph run drawn with GraphicsContext::show_cid_array (issue #358).

cid is a 2-byte code in the active CID-keyed font (a glyph id under CIDToGIDMap = Identity). adjust is an optional position adjustment applied AFTER this glyph, in thousandths of a unit of text space — the TJ convention, where a positive value moves the next glyph left (back) and a negative value moves it right (forward). Use 0.0 for no adjustment.

The core treats cid as an opaque code and does not perform shaping; a consumer (e.g. oxidize-compose) produces these from a shaped run.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

cid: u16

2-byte code (glyph id) in the active CID-keyed font.

adjust: f32

Position adjustment applied to the pen advance after this glyph (thousandths of text-space units; 0.0 = none). This is the TJ kern: a positive value moves the next glyph left, a negative value moves it right.

x_offset: f32

Per-glyph horizontal offset (issue #358 #3): displaces this glyph from its pen position by x_offset thousandths of a text-space unit (positive = right) without changing the advance to the next glyph. Used for GPOS mark attachment / diacritics, where a glyph must be nudged independently of its advance. 0.0 = drawn at the pen position. Distinct from adjust, which consumes advance.

Implementations

impl CidShowElement

pub fn new(cid: u16, adjust: f32) -> Self

Construct a positioned glyph-run element with no per-glyph offset.

This type is #[non_exhaustive], so external consumers (e.g. oxidize-compose) must build it through this constructor rather than a struct literal — letting future iterations add fields without a breaking change. cid is a 2-byte code (glyph id under CIDToGIDMap = Identity); adjust is the post-glyph advance adjustment in thousandths of a text-space unit (0.0 = none). x_offset defaults to 0.0; set it with with_x_offset.

pub fn with_x_offset(self, x_offset: f32) -> Self

Set the per-glyph horizontal offset (see x_offset).

Trait Implementations

impl Clone for CidShowElement

fn clone(&self) -> CidShowElement

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CidShowElement

impl Debug for CidShowElement

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for CidShowElement

fn eq(&self, other: &CidShowElement) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CidShowElement