cl-photo

API Reference

cl-photo

Lisp Markup Language

CL-PHOTO

  • Variable *DIGITAL-CAMERAS*
    (cl-photo::sort-formats
     (loop kmrcl:for format kmrcl:in cl-photo::+format-db+
           when (getf format :pixels)
           cl-photo::collect format))
  • Variable *CAMERAS*
    (cl-photo::sort-formats
     (loop kmrcl:for format kmrcl:in cl-photo::+format-db+
           when (getf format :imager)
           cl-photo::collect format))
  • Function PIXEL-DIMENSIONS (sensor-spec &key (format :35mm))
    Returns the number of pixels for a format. CAMERA-SPEC is either a keyword designating the camera or the number of megapixels of the sensor. FORMAT should be defined if the CAMERA-SPEC is the number of megapixels so the proper aspect ratio is used.
  • Function IMAGER-DIMENSIONS (format-spec)
    Returns the imager dimensions in mm of a FORMAT.
  • Function PIXEL-SIZE (format-spec)
    Return pixel size in micrometers.
  • Function OUTPUT-DIMENSIONS (format-spec)
    Returns the output dimensions in mm of a FORMAT.
  • Function AOV (focal-length frame-width frame-height &key (projection :rectilinear) (magnification 0))
    Returns the angle of field of view for a focal length and frame size. Default is infinity (magnification 0)
  • Function GAUSSIAN-LENS (&key object-distance image-distance focal-length (units :mm))
    object-distance is in units. image-distance and focal-length are in mm.
  • Function FOV (focal-length frame-width frame-height &key object-distance image-distance magnification (units :feet) (projection :rectilinear))
  • Function AOV-FORMAT (focal-length format &key (projection :rectilinear))
    Returns the angle of field of view for a focal length and frame size at infinity
  • Function MAGNIFICATION (&key focal-length object-distance image-distance (units :feet))
    Returns the image magnification: the ratio of image size to object size. focal-length and image-distance are in mm, object-distance is in units
  • Function CLOSE-UP (&key focal-length object-distance image-distance magnification (units :feet))
    Computes the parameters for focusing closer than infinity. Requires two, and only two, of the input parameters. Returns: focal-length object-distance image-distance magnification bellows-factor.
  • Function BELLOWS-FACTOR (focal-length object-distance)
    Returns the bellows factor, the ratio of effective aperature to actual aperture.
  • Function EXTENSION-TUBE (focal-length &key original-object-distance original-image-distance original-magnification new-object-distance new-image-distance new-magnification extension-length (units :feet))
    Computes the parameters for using extension tubes. Requires: 1. original-object-distance, original-image-distance, or original-magnification 2. new-object-distance, new-image-distance, new-magnification, or extension-length Returns: original-object-distance, original-image-distance, original-magnification, original-bellows-factor new-object-distance, new-image-distance, new-magnification, extension-length.
  • Function PRINT-MAGNIFICATION (imager-size print-size)
    Returns the magnification required between an imager and print sizes while taking crop into consideration.
  • Function COC (imager-size &key (lpm 5) (minimum-distance 250) (viewing-distance 250) (print-size (output-dimensions :8x10in)))
    Returns circle of confusion in mm and print magnification for a format. Default resolving power is 5 lpm at 25cm.
  • Function COC-FORMAT (format &key (lpm 5) (minimum-distance 250) (viewing-distance 250) (print-size (output-dimensions :8x10in)))
    Returns circle of confusion in mm and print magnification for a format. Default resolving power is 5 lpm at 25cm.
  • Function COC-PIXELS (imager pixels)
    Returns lpm and circle of confusion based on pixel size.
  • Function COC-PIXELS-FORMAT (format)
    Returns circle of confusion based on pixel size.
  • Function COC-AIRY (f-stop &optional (wavelength 5.12e-4))
    Return the circle of confusion based on the airy disk.
  • Function RAYLEIGH-LIMIT (f-stop &optional (wavelength 5.e-4))
    Returns the rayleigh limit in line pairs per mm (MTF 9%) as well as the MTF50
  • Function MAXIMUM-SHARPNESS-APERTURE (format &optional (wavelength 5.e-4))
  • Function DOF (focal-length f-stop distance coc &key (units :mm) (pupil-factor 1))
    Returns the Depth of Field. Input: FOCAL-LENGTH, F-STOP, DISTANCE, CIRCLE-OF-CONFUSION. Output: NEAR-POINT, FAR-POINT, TOTAL-DOF, MAGNIFICATION, BLUR-SIZE-OF-INFINITY-POINT-IN-MM.
  • Function HYPERFOCAL (focal-length f-stop coc &key (units :mm))
  • Function EFFECTIVE-APERTURE (focal-length distance aperture)
  • Function HYPERFOCAL-TABLE (focal-length coc &key (units :feet) (output *standard-output*))
  • Function AOV-TABLE (imager &key (output *standard-output*) (projection :rectilinear))
  • Function FOV-TABLE (imager focal-length &key (output *standard-output*) (projection :rectilinear) (units :feet))
  • Function DOF-TABLE (focal-length coc &key (output *standard-output*) (units :feet))