Dynamic Dummy Image Generator For Django!
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dummyimage
LICENSE
MANIFEST.in
README.rst
setup.py

README.rst

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.