https://github.com/scardine/image_size

Get image width and height given a file path using minimal dependencies (no need for PIL, libjpeg, libpng, etc)
https://github.com/scardine/image_size

Last synced: 16 days ago
JSON representation

Get image width and height given a file path using minimal dependencies (no need for PIL, libjpeg, libpng, etc)

• Host: GitHub
• URL: https://github.com/scardine/image_size
• Owner: scardine
• License: mit
• Created: 2013-09-27T01:11:35.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2023-05-21T11:59:24.000Z (over 1 year ago)
• Last Synced: 2024-08-01T05:23:51.467Z (3 months ago)
• Language: Python
• Size: 53.7 KB
• Stars: 153
• Watchers: 5
• Forks: 45
• Open Issues: 7
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • License: LICENSE

Awesome Lists containing this project

README

        


================

get_image_size

================

| Src: https://github.com/scardine/image_size

| PyPI:

.. image:: https://raw.github.com/scardine/image_size/master/lookmanodeps.png

    :alt: Look, Ma! No deps!

Get image width and height given a file path using minimal dependencies

(no need for PIL, libjpeg, libpng, etc).

Why don't you just use PIL?

---------------------------

PIL is huge and has lots of dependencies, perhaps an overkill if you

want just the image dimensions.  If you already have PIL installed, then

sure, use it instead.

This was written in answer for the question "`Get Image size WITHOUT

loading image into memory

`__"

(using Python) in stackoverflow. The OP said:

    @PauloScardine hey thanks Paulo, this is great!  It's always so nice

    to have code that can be easily deployed without bringing in

    dependencies, and this fits the bill!  As you say, avoiding PIL is

    worth it for its own sake.

Usage

-----

Right now only for PNG, JPEG, GIF, BMP and TIF. Very untested, fork and

send PRs.

Python ``get_image_size.get_image_size`` usage:

.. code:: python

    import get_image_size

    try:

        width, height = get_image_size.get_image_size('/path/to/image.ext')

    except get_image_size.UnknownImageFormat:

        width, height = -1, -1

Python ``get_image_size.get_image_metadata`` usage:

.. code:: python

   import get_image_size

   try:

       img = get_image_size.get_image_metadata('/path/to/image.ext')

       width, height = img.width, img.height

       print(img._asdict())

   except get_image_size.UnknownImageFormat:

       width, height = -1, -1

Commandline ``get-image-size`` usage:

.. code:: bash

    $ python -m get_image_size --help

    $ get-image-size --help

    Usage: get-image-size [-v|--verbose] [--json|--json-indent]  []

    Print metadata for the given image paths (without image library bindings).

    Options:

      -h, --help     show this help message and exit

      --json

      --json-indent

      -v, --verbose

      -q, --quiet

      -t, --test

    $ get-image-size ./lookmanodeps.png

    251	208	22228	PNG	./lookmanodeps.png

    $ get-image-size --json-indent ./lookmanodeps.png

    {

      "path": "./lookmanodeps.png",

      "type": "PNG",

      "file_size": 22228,

      "width": 251,

      "height": 208

    }

Updates

-------

Over the time people sent updates for ".ico", ".bmp" and other

improvements. It is interesting to have all those algorithms in the same

place so people can reimplement them using other languages, so thanks

for all the pull requests (you can see the list of contributions in the

history).

    I added support for BMP file types, respecting different types of

    DIB headers. Should work on all current bitmap types, tested for old

    OS/2 and BITMAPCOREHEADER files, too. You might try it and consider

    it for merging if you find it useful. **No longer under 100 LOC

    though, sorry ;)**

License

--------

MIT License

Thanks

------

Thanks everyone who inspired this, contributed with code or sent bug

reports. You know who you are, THANK YOU!