imager

Index Home MAE > MAE Architecture > MAE Daemons > imager

Imager Daemon

This daemon takes non-format specific image descriptions (created through the Image class) and converts them into format-specific images, such as .gif or .jpg or .svg.

Use the UserDevice class to render an image; rendering sends the image description to Imager to render. Once rendered, it typically sends them to UserGW to pass them on to the user's display.

Daemon Parameters

None.

Programming API to Imager

Use the Image class to create images or pull previously created images from ImageLib via the ImageLib class.  Behind the scenes, the Image class uses the ImagerAPI class to interface with Imager.

Database Tables

Imager uses these database tables:

Table Name

Description

ImageLib

A database of images where uploaded images are stored.


Messages Received and Processed (imager)

The following messages may be received on the imager channel.

Server API Messages (imager)

MsgTag

Description

render

Render an image to the end-user's device

device - the end-user's device

iid - image id

errmsg - If the image cannot be rendered, output this error message

action - (optional)  the message keyword to send when user clicks on text (aka request)

cbdata - (optional)  data to send along with action message

@return  true if sent successfully

save2lib

Save the image (in filecontent) to the image library (ImageLib).

device -  the end-user's device

filename - the image's filename

filetype - the images file type, e.g. svg, jpeg, etc.

filecontent - the raw content of the image

xid - upload transaction id

category - the category for the image

@return  true if sent successfully

saveagain

Save the image to the ImageLib along with metadata about the image.

image_id - the (already assigned) ImageLib id for the image

filename - the filename to use for the image

filetype - the file type of the image, e.g. svg, jpeg, etc

filecontent - the raw data of the image

category - the category for the image

@return  true if sent successfully

updatelib

FUTURE USE. Update an image in ImageLib, specified by the provided id.

image_id - the ImageLib id for the image

@return  true if sent successfully

setlibdata

Save/Update the image stored in the ImageLib.

image_id - the (already assigned) ImageLib id for the image

filecontent - the raw data of the image

@return  true if sent successfully

setlibcat

Set the image category for the specified image.  Categories are useful for organizing images.

image_id - the ImageLib id for the image

category - the new category for the image

@return  true if sent successfully

setlibname

Set the image filename as stored in ImageLib.

image_id - the ImageLib id for the image

name - the new image filename

@return  true if sent successfully

setlibtype

Set the image file type as stored in ImageLib.

image_id - the ImageLib id for the image

type - the new image file type

@return  true if sent successfully

imager.new

Assign a new image id to an existing image.

table - the image table

id - the id in the table

@return XMLData["iid"] - the new image id