An open API service indexing awesome lists of open source software.

https://github.com/rmax/django-dummyimage

Dynamic Dummy Image Generator For Django!
https://github.com/rmax/django-dummyimage

Last synced: 9 months ago
JSON representation

Dynamic Dummy Image Generator For Django!

Awesome Lists containing this project

README

          

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::

Output::

Example::

{% get_dummyimage_url 320 240 png as image %}

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``.