klammertext/sks/image/image.k

#[
@@@state image_search_path.list :create Series of directories for image search
         :value . imgsrc ../imgsrc ../dbg
@@@
]#

@@@state Image_search_path :desc Series of directories for image search
         :value . imgsrc ../imgsrc ../dbg
@@@

@@@state Image_output_dir :desc Output directory for images :value img @@@

@@@state Image_default_width :desc Default width for images :value .667w @@@

@@@state Image_quality
         :desc JPEG quality, 1 to 100, at which a photograph -- a raster with
               no transparency, whether it arrives as JPEG, PNG or TIFF -- is
               written to the image cache for the html and pdf targets.  The
               default keeps print quality at a fraction of the size; 100 copies
               or converts the source unchanged, as before 2026-09-09.
         :value 85
@@@

#
# @@@argtype pixels | a pixel count :pattern \d+px @@@
# @@image.k basename : Image read from a file @@
# @@image.html basename | width | height : @eval import image ; result = image.image(K) eval@ @@

# An image once had its own position type, for the sake of the "none" value
# (no positioning container).  That value is meaningful for any block
# element, so the shared hpos type carries it and an image is placed by the
# hpos_args option set like every other block element.

@@image.k
  basename
  :id
  :width.length .5w
  @caption_args@
  :vmargin.bool true
  @hpos_args@
  :rel
  :abswidth.number 0.0
  :border.bool false
  :
An image read from a file.  The basename names the file, which is looked
for in the image search path and converted to a format the target can use.
^:width is the image's width in the text column, ^:hpos and ^:offset place
it there, and the caption arguments caption it.
@@

@@image.html,tex :: @eval image.Image(K) eval@ @@

@@image_grid.k
  image_specs.rest(2)
  :cell_number.bool false
  :landscape.bool false
  :scale.number 0.98
  @caption_args@
  @hpos_args@
  :thumbnail.bool false
  :allow_break.bool true
  :id
  :rel
  :hsep.number 0.02
: A grid of images
@@

@@image_grid.html,tex :: @eval image_grid.Image_grid(K) eval@ @@

@@fig.k spec.figure_id : The caption title for a figure @@
@@fig.html,tex :: @reference *spec* | Figure @ @@