Adjustment
paper-pptx 0.2.0 API reference
An adjustment value for an autoshape.
An adjustment value corresponds to the position of an adjustment handle on an auto shape. Adjustment handles are the small yellow diamond-shaped handles that appear on certain auto shapes and allow the outline of the shape to be adjusted. For example, a rounded rectangle has an adjustment handle that allows the radius of its corner rounding to be adjusted.
Values are float and generally range from 0.0 to 1.0, although the value can be negative or
greater than 1.0 in certain circumstances.
Adjustment(name: str, def_val: int, actual: int | None = None)Attributes
actual
attributeactual= actualdef_val
attributedef_val= def_valeffective_value
attributeeffective_valuefloatRead/write float representing normalized adjustment value for this adjustment.
Actual values are a large-ish integer expressed in shape coordinates, nominally between 0 and 100,000. The effective value is normalized to a corresponding value nominally between 0.0 and 1.0. Intuitively this represents the proportion of the width or height of the shape at which the adjustment value is located from its starting point. For simple shapes such as a rounded rectangle, this intuitive correspondence holds. For more complicated shapes and at more extreme shape proportions (e.g. width is much greater than height), the value can become negative or greater than 1.0.
name
attributename= nameval
attributevalintDenormalized effective value.
Expressed in shape coordinates, this is suitable for using in the XML.