<--- Cannot embed stylesheet: [Errno 2] No such file or directory: '../../../../aros.css' --->

Image.mui

MUIA_Image_FontMatch

Function

Enable font-based adjustment of default both dimensions.

Inputs

Initialize only, BOOL, default FALSE. No local setter or getter.

Notes

For a prepared image, AskMinMax multiplies the accumulated default both
dimension(s) by integer font XSize/8 or YSize/8 on each selected axis.
Division occurs before multiplication, so a font dimension below eight
produces a zero factor. Minimum and maximum are unchanged. This is not
an aspect-ratio or pixel-resampling guarantee. Combined and per-axis
tags update the same flags in tag order; the rule does not apply to
OldImage or private Prop-image sizing.

MUIA_Image_FontMatchHeight

Function

Enable font-based adjustment of default height dimensions.

Inputs

Initialize only, BOOL, default FALSE. No local setter or getter.

Notes

For a prepared image, AskMinMax multiplies the accumulated default
height dimension(s) by integer font XSize/8 or YSize/8 on each selected
axis. Division occurs before multiplication, so a font dimension below
eight produces a zero factor. Minimum and maximum are unchanged. This is
not an aspect-ratio or pixel-resampling guarantee. Combined and per-axis
tags update the same flags in tag order; the rule does not apply to
OldImage or private Prop-image sizing.

MUIA_Image_FontMatchWidth

Function

Enable font-based adjustment of default width dimensions.

Inputs

Initialize only, BOOL, default FALSE. No local setter or getter.

Notes

For a prepared image, AskMinMax multiplies the accumulated default width
dimension(s) by integer font XSize/8 or YSize/8 on each selected axis.
Division occurs before multiplication, so a font dimension below eight
produces a zero factor. Minimum and maximum are unchanged. This is not
an aspect-ratio or pixel-resampling guarantee. Combined and per-axis
tags update the same flags in tag order; the rule does not apply to
OldImage or private Prop-image sizing.

MUIA_Image_FreeHoriz

Function

Allow image width to use the backend size range.

Inputs

Initialize only, BOOL, default FALSE. No local setter or getter.

Notes

TRUE adds backend minimum/default/maximum values on this axis to the
corresponding superclass fields. FALSE adds the backend default to all
three fields. It does not override the separate OldImage or private
Prop-image size paths. Drawing passes actual content dimensions to the
backend; this attribute controls size negotiation, not a generic scaling
algorithm.

MUIA_Image_FreeVert

Function

Allow image height to use the backend size range.

Inputs

Initialize only, BOOL, default FALSE. No local setter or getter.

Notes

TRUE adds backend minimum/default/maximum values on this axis to the
corresponding superclass fields. FALSE adds the backend default to all
three fields. It does not override the separate OldImage or private
Prop-image size paths. Drawing passes actual content dimensions to the
backend; this attribute controls size negotiation, not a generic scaling
algorithm.

MUIA_Image_OldImage

Function

Supply a classic Intuition Image.

Inputs

Initialize only, struct Image pointer. Default NULL. No local setter or
getter.

Notes

The Image structure and referenced data remain caller-owned and must
stay valid while used. It is used only if no prepared specification or
private Prop image takes precedence. Its Width/Height fix size
negotiation; drawing uses DrawImage with no state parameter. Image_State
does not select an alternate old image.

MUIA_Image_Spec

Function

Supply or retrieve the image specification.

Inputs

Initialize, set and get in this AROS implementation; the header marks
initialize-only. Supply a valid NUL-terminated specification or
supported numeric MUII identifier.

Notes

The stored representation is an owned string. Get returns a borrowed
pointer valid until replacement or disposal. No explicit constructor
default is supplied. Set frees before copying, so its input must not
alias the current allocation. When set up it hides/cleans/rebuilds/shows
resources as applicable, updates FillArea for successfully parsed
gradients versus other images and requests full redraw without relayout.
Failed duplication or preparation is not separately reported.

MUIA_Image_State

Function

Choose the image drawing state.

Inputs

Initialize and set, LONG, default IDS_NORMAL. No local getter.

Notes

Passed to the image-spec drawing backend or internal Prop-image
renderer. A changed explicit State requests full redraw. Selected TRUE
maps state to IDS_SELECTED; Selected FALSE maps it to IDS_NORMAL on set.
Constructor Selected FALSE does not reset a state already supplied. Tag
order therefore matters. No validation of state values is performed;
classic OldImage drawing ignores the value.

MUIC_Image

Superclass

Area.mui

Description

Display a Zune image specification or a borrowed classic Intuition
Image. No source is required at construction; there is no default image
fallback. A prepared specification takes precedence over OldImage. The
class owns a copied specification and setup-time image resources;
OldImage and the internal Prop connection remain borrowed. Complete Hide
and Cleanup before disposal, which frees only the specification string
locally.
Setup calls Area and returns success even if image preparation fails.
For gradient specifications it sets FillArea FALSE; for other
successfully prepared specifications it sets FillArea TRUE. Initial
brush setup removes the frame. These are side effects on inherited
attributes, not merely image-local state.

Methods

AskMinMax obtains the prepared image's bounds. A free axis uses its
minimum/default/maximum contributions; a nonfree axis adds its default
size to all three fields. Font matching multiplies only the resulting
default dimension by integer font-size/8. It does not scale minimum or
maximum dimensions. OldImage instead fixes all dimensions to its size
plus superclass minimum contributions. With no usable image, no local
size contribution is added.
Spec replacement is implemented despite the header's initialize-only
annotation. It rebuilds resources when set up and requests redraw, but
no relayout. Image_State changes request redraw; Selected updates map
state to IDS_SELECTED or IDS_NORMAL. Draw normally calls Area, checks
full/update flags and draws the image over the content rectangle.
OldImage uses DrawImage and does not receive state. Show always returns
one after calling Area, Hide and Cleanup return superclass results, and
Dispose returns zero.

Notes

Spec strings use AROS's image-specification parser. Supported numeric
MUII identifiers are converted to copied strings: configuration
identifiers in [MUII_WindowBack, MUII_BACKGROUND) use the 6: form,
pattern identifiers in [MUII_BACKGROUND, MUII_LASTPAT) use the 0: form.
Other values are treated as string pointers. Do not assume integer zero
is a NULL-image sentinel.
Repeated constructor Spec tags leak earlier copies. Set frees the
previous specification before duplicating its argument; do not pass the
current getter pointer or an interior pointer back to Set. Duplication
failure loses the old specification and is not separately reported.
Resource getters and borrowed external images do not extend their
owners' lifetimes.