pandoc-3.1.9: Conversion between markup formats
CopyrightCopyright (C) 2011-2023 John MacFarlane
LicenseGNU GPL, version 2 or above
MaintainerJohn MacFarlane <jgm@berkeley.edu>
Stabilityalpha
Portabilityportable
Safe HaskellSafe-Inferred
LanguageHaskell2010

Text.Pandoc.ImageSize

Description

Functions for determining the size of a PNG, JPEG, or GIF image.

Synopsis

Documentation

data ImageType #

Constructors

Png 
Gif 
Jpeg 
Svg 
Pdf 
Eps 
Emf 
Tiff 

Instances

Instances details
Show ImageType # 
Instance details

Defined in Text.Pandoc.ImageSize

Methods

showsPrec :: Int -> ImageType -> ShowS #

show :: ImageType -> String #

showList :: [ImageType] -> ShowS #

imageSize :: WriterOptions -> ByteString -> Either Text ImageSize #

sizeInPixels :: ImageSize -> (Integer, Integer) #

sizeInPoints :: ImageSize -> (Double, Double) #

Calculate (height, width) in points using the image file's dpi metadata, using 72 Points == 1 Inch.

desiredSizeInPoints :: WriterOptions -> Attr -> ImageSize -> (Double, Double) #

Calculate (height, width) in points, considering the desired dimensions in the attribute, while falling back on the image file's dpi metadata if no dimensions are specified in the attribute (or only dimensions in percentages).

data Dimension #

Instances

Instances details
Show Dimension # 
Instance details

Defined in Text.Pandoc.ImageSize

Methods

showsPrec :: Int -> Dimension -> ShowS #

show :: Dimension -> String #

showList :: [Dimension] -> ShowS #

Eq Dimension # 
Instance details

Defined in Text.Pandoc.ImageSize

data Direction #

Constructors

Width 
Height 

Instances

Instances details
Show Direction # 
Instance details

Defined in Text.Pandoc.ImageSize

Methods

showsPrec :: Int -> Direction -> ShowS #

show :: Direction -> String #

showList :: [Direction] -> ShowS #

dimension :: Direction -> Attr -> Maybe Dimension #

Read a Dimension from an Attr attribute. `dimension Width attr` might return `Just (Pixel 3)` or for example `Just (Centimeter 2.0)`, etc.

scaleDimension :: Double -> Dimension -> Dimension #

Scale a dimension by a factor.

numUnit :: Text -> Maybe (Double, Text) #

Maybe split a string into a leading number and trailing unit, e.g. "3cm" to Just (3.0, "cm")

showInInch :: WriterOptions -> Dimension -> Text #

Convert a Dimension to Text denoting its equivalent in inches, for example "2.00000". Note: Dimensions in percentages are converted to the empty string.

showInPixel :: WriterOptions -> Dimension -> Text #

Convert a Dimension to Text denoting its equivalent in pixels, for example "600". Note: Dimensions in percentages are converted to the empty string.

showFl :: RealFloat a => a -> Text #