To use ImageEngine you need to register an account. When you have signed up, you get a unique hostname. This hostname is used to identify you account and is the first part of the host name:{token}.imgeng.in

Even if you can point your DNS to your ImageEngine host directly, the easiest way to test ImageEngine is to simply prefix your image URL with the ImageEngine hostname you got assigned. In the below example, the size of the image will be equal to the detected screen size of the requesting device.

<img src="//{token}.imgeng.in/https://web.wurfl.io/assets/sunsetbeach.jpg">

However you may also pass a set of parameters to the ImageEngine service as seen below. The below example would return an image sized to 50% of the screen width. A full list of parameters can be found here.

<img src="//{token}.imgeng.in/pc_50/https://wurfl.io/assets/sunsetbeach.jpg">

ImageEngine supports the emerging standard Client Hints. To enable this feature, include the below meta tag in your head element:

<meta http-equiv="Accept-CH" content="DPR, Viewport-Width, Width">

Once WURFL.js has been included, you can use the returned object to check if it is a mobile device like this:

if (WURFL.is_mobile === true && WURFL.form_factor === "Smartphone") {
    // targetSmartPhoneDevices();
}

For example, your current device looks like:

{
    "is_mobile": <% WURFL.is_mobile %>,
    "complete_device_name": <% WURFL.complete_device_name %>,
    "form_factor": <% WURFL.form_factor %>
}

In development, you may pass debug=true to the query string to disable any caching.

Below are the capabilities available:

complete_device_name

The name the device is known by. Typically make and model, a "group" of devices, or a more generic definition.

form_factor

May return any of these values: Desktop, App, Tablet, Smartphone, Feature Phone, Smart-TV, Robot, Other non-Mobile, Other Mobile.

is_mobile

Returns true if the device is a tablet, or other mobile device, otherwise false