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

Dtpic.mui

MUIA_Dtpic_Alpha

Function

Set the target opacity for cached high-color compositing.

Inputs

Initialize, set, get: LONG; default 255. Use 0-255; values are not
validated.

Notes

Get returns the target, not the animated value. Current opacity starts
at 255; Fade determines transitions. Set alone does not request redraw.
Direct alpha fallback and mask/plain bitmap paths ignore this setting.
Values outside 0-255 have undefined visual results.

MUIA_Dtpic_DarkenSelState

Function

Enable darkening while the mouse button is pressed.

Inputs

Initialize, get: BOOL; default FALSE. No local setter.

Notes

Tracks a private pressed flag, not Area Selected or an activation
event. Selected takes precedence over highlighting. The high-color
alpha path animates brightness; the plain bitmap path uses a prepared
darkened bitmap. The mask path does not darken. Get returns the option,
not the pressed state.

MUIA_Dtpic_Fade

Function

Control progress toward the target Alpha.

Inputs

Initialize, set, get: LONG; default 0.

Notes

Negative values apply Alpha immediately; zero freezes the current
value; positive values step on received Intuiticks by Fade * 50 / 20.
This is not a time duration. Keep Fade * 50 within LONG range. Set does
not request redraw and does not control pointer-state brightness.

MUIA_Dtpic_LightenOnMouse

Function

Enable highlighting when the pointer enters the object.

Inputs

Initialize, get: BOOL; default FALSE. No local setter.

Notes

Hover state changes on mouse-motion events; Show does not sample the
pointer position, and Hide does not clear the flag. The high-color
alpha path animates brightness; the plain bitmap path uses a prepared
highlighted bitmap. The mask path ignores highlighting. Get returns the
option, not hover state.

MUIA_Dtpic_Name

Function

Set or get the picture filename.

Inputs

Initialize, set, get: borrowed STRPTR; default NULL.

Notes

The string is not copied or freed; keep it valid and unchanged until
replacement or disposal. After Setup, a different string triggers
synchronous loading. Equal text leaves the old pointer in place.
Replacing a non-NULL name with NULL is unsafe. A failed reload discards
the previous image; Get returns the stored pointer, not load status. A
size change does not explicitly trigger relayout.

MUIC_Dtpic

Superclass

Area.mui

Description

Display an unscaled picture using datatypes.library. Loading is
synchronous during Setup or a changed Name on a set-up object; it may
perform filesystem I/O without a local timeout. The filename is
borrowed and must stay valid.

Methods

Setup can return TRUE even when picture loading fails; no load status
is exposed. A failed reload discards the previous picture. Use the
normal Show/Hide and Setup/Cleanup lifecycle: Dispose does not release
datatype resources.

Notes

Rendering depends on image masking and screen depth. Cached high-color
alpha compositing supports fading and pointer-state brightness; a full
draw refreshes the background cache. Direct alpha fallback ignores the
Alpha setting. Mask and plain bitmap paths do not apply global alpha;
the mask path also ignores brightness states.
Alpha/Fade changes do not request redraw. Name changes do not
explicitly request group relayout.

Bugs

State-bitmap allocation can fail without failing the load, leaving an
unchecked NULL bitmap at draw time. Buffer-size multiplication is
unchecked. Composite alpha uses division by 256, so Alpha 255 is not
mathematically exact opacity. Event registration bookkeeping can become
stale if Cleanup occurs without Hide.