Reference: Display Filters: MIME
Move Up Move to Top
Contents: Filter Overview User Interface & Options
Example Variables
Filter Overview This filter decodes MIME messages. It can display inline images, decode base64, quoted-printable, x-uue/x-uuencode, and handle multipart mime messages.

Currently, this filter cannot operate in progressive loading mode. This means that the entire article must be read before a MIME message can be displayed. During loading, a brief message to this effect is displayed which is later replaced by the article contents once the transfer is complete.

Back to Top

User Interface The user interface for this filter looks like this:

The available configuration options are:

  • Save Directory - The default save directory for data segments.

  • No-Display Types - Any MIME section who's Content-Type field matches this AmigaOS pattern will not be displayed. This is useful for filtering out text/html or other undesirable sections. If this field is empty, all MIME sections will be displayed.

  • Display Inline - If the data is image data and there is an appropriate system datatype, the image will be displayed inline if this option is checked. Note that the datatype display may not happen properly or at all if there are an insufficient number of free pens. Generally it is best to use a truecolor (16 or 24 bit) display mode, but failing that, 256 colors is usually adequate as well.

  • Make Dirs - If selected, save directories will automatically be created if they do not already exist.

  • Use Requestors - If selected, OK and Cancel requestors will be displayed after saving data from a MIME data block. Otherwise, all saves are silent.

  • Display Size - If selected, MIME data blocks which are of any image type (image/*) will display the size of the graphic file in the information area of the data block.

  • Deletion Marker - When operating in text mode (for printing, saving article text, or generating replies), non-text MIME data blocks, such as image/* or audio/*, are deleted and replaced with this text.

Back to Top

Example The following is a partial example of a multipart MIME article. The first part is a text message, and the second is a base64 encoded image (which is cropped here for space reasons):

The following controls are available:

  • Save... - Saves the encoded data to the default save directory using the filename defined in the uuencoded data block.

  • Save As... - Displays a file requestor and saves the encoded data to the chosen filename.

  • Action... - Displays a list of defined multimedia actions for this multimedia type, as obtained from the MIME headers. Double clicking on one of the actions in the list will perform the indicated action. Actions might be defined to, for example, send the image to an image processing program, print it, or display it using an external viewer program.

Back to Top
Variables The following variables, in addition to the standard group, article, and project variables, are available to multimedia actions using this filter:

Variable NameDescription
File When used in a multimedia action for a MIME data segment, this variable will be set to a filename which contains the decoded data. It maybe used to send to external commands. The data file will be deleted when the article display goes away, either from another article being displayed or the group reader window being closed.
Lines When used in the Deletion Marker field, this variable expands to the number of lines in the MIME data block.
Name When used in the Deletion Marker field, this variable expands to the filename given in the MIME data block.
Size When used in the Deletion Marker field, this variable expands to the number of bytes in the MIME data block, before decoding.
MIMEType When used in the Deletion Marker field, this variable expands to the MIME Content-Type field for the data being deleted.
MIMEDesc When used in the Deletion Marker field, this variable expands to the MIME Content-Description field for the data being deleted.