# images

These scripts are for working with images and other visual material.

## The individual scripts

<!-- [[[cog

# This adds the root of the repo to the PATH, which has cog_helpers.py
from os.path import abspath, dirname
import sys

sys.path.append(abspath(dirname(dirname("."))))

import cog_helpers

folder_name = "images"

scripts = [
    {
        "usage": "chunky_pixels.py [PATH] [PIXEL_SIZE]",
        "description": """
        redraw an image using “chunky” pixels – that is, replacing every NxN block of pixels with a single colour.
        <p>
          <table>
            <tr>
              <td>
                <img src="examples/flowers.jpg">
                original
              </td>
              <td>
                <img src="examples/flowers_12.jpg">
                N=12
              </td>
              <td>
                <img src="examples/flowers_34.jpg">
                N=34
              </td>
              <td>
                <img src="examples/flowers_68.jpg">
                N=68
              </td>
              <td>
                <img src="examples/flowers_204.jpg">
                N=204
              </td>
            </tr>
          </table>
        </p>
        """,
    },
    {
        "usage": "convert_gif_to_mp4 GIF_PATH",
        "description": "convert an animated GIF to an MP4 file"
    },
    {
        "name": "copycrop.py",
        "description": """
        this script will “copy” the crop from one image pair to another.
        <p>For example, suppose I have a full-screen screenshot and a crop to a small region of the screen:</p>
        <p>
          <table>
            <tr>
              <td><img src="examples/light_original.png"></td>
              <td>&amp;</td>
              <td><img src="examples/light_crop.png"></td>
            </tr>
          </table>
        </p>
        I can use this tool to extract the equivalent region from a second screenshot:
        <p>
          <table>
            <tr>
              <td><img src="examples/dark_original.png"></td>
              <td>&rarr;</td>
              <td><img src="examples/dark_crop.png"></td>
            </tr>
          </table>
        </p>
        I often use this when making images for my website, to create identical light mode and dark mode screenshots.
        """
    },
    {
        "usage": "images_only_pdf.py [PATH]",
        "description": """
        take a PDF, and create a new PDF which just has the images filling the page.
        I use this to work around an odd behaviour of the “Scan Document” feature in Notes.app, where it adds a large white border around scanned images that I don’t want.
        <p><strong>Note:</strong> this script overwrites the original file.</p>
        """
    },
    {
        "usage": "pdfthumb.py [PATH] --page=[PAGE]",
        "description": """
        get a PNG thumbnail of a specific page of a PDF, for example <code>pdfthumb pattern.pdf --page=3</code> will create a thumbnail of the third page.
        """
    },
    {
        "usage": "reborder.py [PATH] [BORDER_WIDTH]",
        "description": """
        replace empty space around an image with consistent white padding.
        I use this when cleaning up screenshots, to get equal padding around the entire image.
        <p>
          <table>
            <tr>
              <td><img src="examples/reborder_original.png"></td>
              <td>&rarr;</td>
              <td><img src="examples/reborder_50.png"></td>
            </tr>
          </table>
        </p>
        """
    },
    {
        "usage": "squarify.py [PATH]",
        "description": """
        crop an image to a central square
        """
    },
    {
        "usage": "srgbify.py [PATH]",
        "description": """
        convert an image in-place to have an sRGB colour profile.
        """
    },
    {
        "usage": "tint_image.py [PATH] [HEX_COLOUR]",
        "description": """
        take a greyscale image, and create a version which is tinted with the specified colour.
        This works by creating an RGBA image which has the specified colour on every pixel, but controlling the intensity with the alpha value.
        <p>
          <table>
            <tr>
              <td><img src="examples/grayscale_circle.png"></td>
              <td>&rarr;</td>
              <td><img src="examples/grayscale_circle.ff0000.png"></td>
            </tr>
          </table>
        </p>
        I don’t use this script very often, but I checked it in because I thought it was a neat trick I didn’t want to forget.
        """
    },
]

cog_helpers.create_description_table(folder_name=folder_name, scripts=scripts)

]]]-->
<dl>
  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/chunky_pixels.py">
      <code>chunky_pixels.py [PATH] [PIXEL_SIZE]</code>
    </a>
  </dt>
  <dd>
    redraw an image using “chunky” pixels – that is, replacing every NxN block of pixels with a single colour.
    <p>
      <table>
        <tr>
          <td>
            <img src="examples/flowers.jpg">
            original
          </td>
          <td>
            <img src="examples/flowers_12.jpg">
            N=12
          </td>
          <td>
            <img src="examples/flowers_34.jpg">
            N=34
          </td>
          <td>
            <img src="examples/flowers_68.jpg">
            N=68
          </td>
          <td>
            <img src="examples/flowers_204.jpg">
            N=204
          </td>
        </tr>
      </table>
    </p>
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/convert_gif_to_mp4">
      <code>convert_gif_to_mp4 GIF_PATH</code>
    </a>
  </dt>
  <dd>
    convert an animated GIF to an MP4 file
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/copycrop.py">
      <code>copycrop.py</code>
    </a>
  </dt>
  <dd>
    this script will “copy” the crop from one image pair to another.
    <p>For example, suppose I have a full-screen screenshot and a crop to a small region of the screen:</p>
    <p>
      <table>
        <tr>
          <td><img src="examples/light_original.png"></td>
          <td>&amp;</td>
          <td><img src="examples/light_crop.png"></td>
        </tr>
      </table>
    </p>
    I can use this tool to extract the equivalent region from a second screenshot:
    <p>
      <table>
        <tr>
          <td><img src="examples/dark_original.png"></td>
          <td>&rarr;</td>
          <td><img src="examples/dark_crop.png"></td>
        </tr>
      </table>
    </p>
    I often use this when making images for my website, to create identical light mode and dark mode screenshots.
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/images_only_pdf.py">
      <code>images_only_pdf.py [PATH]</code>
    </a>
  </dt>
  <dd>
    take a PDF, and create a new PDF which just has the images filling the page.
    I use this to work around an odd behaviour of the “Scan Document” feature in Notes.app, where it adds a large white border around scanned images that I don’t want.
    <p><strong>Note:</strong> this script overwrites the original file.</p>
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/pdfthumb.py">
      <code>pdfthumb.py [PATH] --page=[PAGE]</code>
    </a>
  </dt>
  <dd>
    get a PNG thumbnail of a specific page of a PDF, for example <code>pdfthumb pattern.pdf --page=3</code> will create a thumbnail of the third page.
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/reborder.py">
      <code>reborder.py [PATH] [BORDER_WIDTH]</code>
    </a>
  </dt>
  <dd>
    replace empty space around an image with consistent white padding.
    I use this when cleaning up screenshots, to get equal padding around the entire image.
    <p>
      <table>
        <tr>
          <td><img src="examples/reborder_original.png"></td>
          <td>&rarr;</td>
          <td><img src="examples/reborder_50.png"></td>
        </tr>
      </table>
    </p>
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/squarify.py">
      <code>squarify.py [PATH]</code>
    </a>
  </dt>
  <dd>
    crop an image to a central square
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/srgbify.py">
      <code>srgbify.py [PATH]</code>
    </a>
  </dt>
  <dd>
    convert an image in-place to have an sRGB colour profile.
  </dd>

  <dt>
    <a href="https://github.com/alexwlchan/scripts/blob/main/images/tint_image.py">
      <code>tint_image.py [PATH] [HEX_COLOUR]</code>
    </a>
  </dt>
  <dd>
    take a greyscale image, and create a version which is tinted with the specified colour.
    This works by creating an RGBA image which has the specified colour on every pixel, but controlling the intensity with the alpha value.
    <p>
      <table>
        <tr>
          <td><img src="examples/grayscale_circle.png"></td>
          <td>&rarr;</td>
          <td><img src="examples/grayscale_circle.ff0000.png"></td>
        </tr>
      </table>
    </p>
    I don’t use this script very often, but I checked it in because I thought it was a neat trick I didn’t want to forget.
  </dd>
</dl>
<!-- [[[end]]] (sum: 9yBrlmL4gH) -->