-
Notifications
You must be signed in to change notification settings - Fork 0
MUI_Image
Image class is used to display one of MUI's standard images or some selfmade image data.
| Attribute | Version | ISG | Type |
|---|---|---|---|
| MUIA_Image_BuiltinSpec | V21 | I.. | ULONG |
| MUIA_Image_CopySpec | V20 | I.. | BOOL |
| MUIA_Image_FontMatch | V4 | IS. | BOOL |
| MUIA_Image_FontMatchHeight | V4 | IS. | BOOL |
| MUIA_Image_FontMatchString | V20 | IS. | CONST_STRPTR |
| MUIA_Image_FontMatchWidth | V4 | IS. | BOOL |
| MUIA_Image_FreeHoriz | V4 | IS. | BOOL |
| MUIA_Image_FreeVert | V4 | IS. | BOOL |
| MUIA_Image_OldImage | V4 | I.. | struct Image * |
| MUIA_Image_Spec | V4 | ISG | STRPTR |
| MUIA_Image_State | V4 | IS. | LONG |
MUIA_Image_BuiltinSpec -- V21 [I..], ULONG, 0x8042b907
Specify the builtin image type to be used as fallback image in case loading the normal image specified by MUIA_Image_Spec fails for some reason. Even if the builtin image is not the desired one it is still better to get this fallback image displayed instead of no image at all.
MUIA_Image_CopySpec -- V20 [I..], BOOL, 0x8042a784
Let MUI copy the image spec string internally instead of using the spec literally. This attribute MUST be set to TRUE if a temporary string is to be used for MUIA_Image_Spec.
Defaults to FALSE.
MUIA_Image_FontMatch -- V4 [IS.], BOOL, 0x8042815d
If TRUE, width and height of the given image will be scaled to match the current font. Images are always defined with a reference font of topaz/8, bigger fonts will make the image grow (as long as its maximum size is big enough).
The arrows of a scroll bar are e.g. defined with MUIA_Image_FontMatch.
MUIA_Image_FontMatch, MUIA_Image_FontMatchString, MUIA_Image_FontMatchWidth
MUIA_Image_FontMatchHeight -- V4 [IS.], BOOL, 0x80429f26
If TRUE, the height of the given image will be scaled to match the current font. Images are always defined with a reference font of topaz/8, bigger fonts will make the image grow (as long as its maximum size is big enough).
MUIA_Image_FontMatch, MUIA_Image_FontMatchString, MUIA_Image_FontMatchWidth
MUIA_Image_FontMatchString -- V20 [IS.], CONST_STRPTR, 0x804263c1
By default the font size matching happens against the dimensions of the single letter 'n'. In case this does not result in sensible dimension the attribute can be set to valid string to be used for the dimsension calculation instead, i.e. "W" to use a usually quite "large" letter.
MUIA_Image_FontMatch, MUIA_Image_FontMatchHeight, MUIA_Image_FontMatchWidth
MUIA_Image_FontMatchWidth -- V4 [IS.], BOOL, 0x804239bf
If TRUE, the width of the given image will be scaled to match the current font. Images are always defined with a reference font of topaz/8, bigger fonts will make the image grow (as long as its maximum size is big enough).
MUIA_Image_FontMatch, MUIA_Image_FontMatchHeight, MUIA_Image_FontMatchString
MUIA_Image_FreeHoriz -- V4 [IS.], BOOL, 0x8042da84
Tell the image if its allowed to get scaled horizontally.
Defaults to FALSE.
MUIA_Image_FreeVert, MUIA_Image_FontMatch
MUIA_Image_FreeVert -- V4 [IS.], BOOL, 0x8042ea28
Tell the image if its allowed to get scaled vertically.
Defaults to FALSE.
MUIA_Image_FreeHoriz, MUIA_Image_FontMatch
MUIA_Image_OldImage -- V4 [I..], struct Image *, 0x80424f3d
Allows you to use any conventional image structure within a MUI window. The resulting object is always as big as the image and not resizable.
MUIA_Image_Spec -- V4 [ISG], STRPTR, 0x804233d5
Specify the type of your image. Usually, you will use one of the predefined standard images here (one of the MUII_xxx definitions from mui.h), but you also can supply a string containing a MUI image specification. Image specifications always starts with a digit, followed by a ':', followed by some parameters. Currently, the following things are defined (all numeric parameters need to be ASCII values!):
0:<x>
where is between MUII_BACKGROUND and MUII_FILLBACK2 identifying
a builtin pattern.
1:<x>
where identifies a builtin standard image.
Don't use this, use "6:" instead.
2:,,: where , and are 32-bit RGB color values specified as 8-digit hex string (e.g. 00000000 or ffffffff).
3:<n>
where is the name of an external BOOPSI image class.
4:<n>
where is the name of an external MUI brush.
5:<n>
where is the name of an external picture file that should be
loaded with datatypes.
6:<x>
where is between MUII_WindowBack and MUII_Count-1 identifying a
preconfigured image/background.
The supplied string pointer will be stored internally. Hence you MUST make sure that the pointer stays valid as long as the object lives. If you cannot avoid passing a temporary string then you MUST use the MUIA_Image_CopySpec attribute to enforce an internal copy of the string.
If the image is loaded by datatypes (i.e. "5:image.png") the image file will remain Lock()'d by datatypes.library as long as the image is kept in MUI's internal image cache. Use the FlushImagespace tool to flush all currently unused images from the cache.
MUIA_Image_OldImage, MUIA_Image_CopySpec
MUIA_Image_State -- V4 [IS.], LONG, 0x8042a3ad
Some MUI images offer different states, you can select one of the by setting this attribute. Simply use one of the IDS_NORMAL, IDS_SELECTED, ... values defined in "intuition/imageclass.h".
Objects that respond to user input will automatically toggle their state between IDS_NORMAL to IDS_SELECTED depending on their MUIA_Selected attribute.
| Copyright © 1992-2006 by Stefan Stuntz Copyright © 2006-2021 by Thore Böckelmann, Jens Maus |
MUI for AmigaOS Homepage MUI for AmigaOS Wiki |
Updated: 11-Oct-2021 |