1. Manuals
  2. Tumbleweed
  3. tkimg
  4. img-bmp(n)

Scroll to navigation

img-bmp(n) Img img-bmp(n) 





NAME


img-bmp - Img, Windows Bitmap Format (bmp)






SYNOPSIS


package require Tk 


package require img::bmp ?1.4?


image create photo ?name?
  ?options?










DESCRIPTION


package require img::bmp.


Like all packages of Img it does not provide new
    commands, but extends the existing Tk command image so that it
    supports files containing raster images in the Windows Bitmap Format (bmp).
    More specifically img::bmp extends Tk's photo image
    type.


The name of the new format handler is bmp.


The package img::bmp is a sub-package of Img. It can
    be loaded as a part of the complete Img support, via package require
    Img, or on its own, via package require img::bmp.


This handler provides new additional configuration options. See
    section BMP OPTIONS for more detailed explanations.


All of the above means that in a call like



  

  





  
[1]

  
Image data in bmp format (options -data and -file) is
      detected automatically.

  
[2]

  
The format name bmp is recognized by the option -format. In
      addition the value for the option is treated as list and may contain any
      of the special options listed in section BMP OPTIONS.








BMP OPTIONS


The handler provides the following options:



  

  
The display resulation and/or aspect ratio property of the outputted bmp
      file may be set using this option. The default values are an x and y
      resolution of 74 dpi. res is a list of 2 or 3 elements and may have
      one of the following formats. The values xres, yres and
      unit are specified after the formats.







  

  
Set the same resolution for x and y. Example: Write image with a
      resolution of 300dpi:






img write out.bmp -format {bmp -resolution {300 i}}






  

  
Set the aspect ratio only. The x resolution remains to the default value
      74dpi, as the bmp format does not allow to specify the aspect ratio only.
      The y resolution is set to 74*yres/xres. Example: Write
      image with an aspect ratio of 1/3:






img write out.bmp -format {bmp -resolution {1 3}}






  

  
Set an independent resolution for x and y direction. Example: Write image
      with a resolution of x=300dpi and y=150dpi:






img write out.bmp -format {bmp -resolution {300 100 i}}








  

  
The used parameters are:







  

  
The output resolution in x direction as a float number.

  

  
The output resolution in x direction as a float number.

  

  
Unit of the given resolution numbers similar to Tk_GetPixel. Possible
      units are:







  

  
pixel per centimeter.

  

  
pixel per meter.

  

  
pixel per inch.

  

  
pixel per inch/72 (Printer points).












SEE ALSO


img-bmp, img-dted, img-flir, img-gif, img-ico, img-intro,
    img-jpeg, img-pcx, img-pixmap, img-png, img-ppm, img-ps, img-raw, img-sgi,
    img-sun, img-tga, img-tiff, img-window, img-xbm, img-xpm






KEYWORDS


bmp, image handling, tk






COPYRIGHT


Copyright (c) 1995-2023 Jan Nijtmans <nijtmans@users.sourceforge.net>








  

    1.4
    img-bmp