django-dummyimage

Dynamic Dummy Image Generator For Django!


License
BSD-3-Clause
Install
pip install django-dummyimage==0.1.1

Documentation

Django DummyImage

A simple app to generate dummy/filler images on the fly at whatever size you want.

Inspired by http://dummyimage.com/ and http://github.com/xxx/fakeimage

Installation

Installation using pip:

$ pip install django-dummyimage

Running tests:

$ DJANGO_SETTINGS_MODULE=dummyimage.settings django-admin.py test dummyimage

Running demo:

$ DJANGO_SETTINGS_MODULE=dummyimage.settings django-admin.py runserver
$ xdg-open "http://localhost:8000/500x150.png?text=hello+world"

Setup & Settings

Add dummyimage to your INSTALLED_APPS setting.

Default settings:

DUMMYIMAGE_MAX_DIMENSION = 1024
DUMMYIMAGE_DEFAULT_BG = 'white'
DUMMYIMAGE_DEFAULT_TEXT = 'grey'
DUMMYIMAGE_DEFAULT_BORDER = 'grey'

Template Tag

Code:

<img src="{% get_dummyimage_url 320 240 %}" />

Output:

<img src="/dummyimage/320x240.jpg" />

Example:

{% get_dummyimage_url 320 240 png as image %}
<img src="{{ image }}?text=hello+world" />

Query Parameters

Available parameters:

  • text=string text to be rendered in the middle of the image.
  • textcolor=color text color.
  • bgcolor=color background color.
  • bordercolor=color border color.
  • noborder=1 disable border.
  • cross=1 draw a cross in the through the image.

Note

Colors can be literal color names (e.g. white, red) or hexadecimal values starting with !, for example: !333, !AAA, white, blue, !CBCBCB.