本文提供一些调整图片大小、裁剪和对齐图片的用例。
调整图片大小
我们利用 URL 的查询字符串来调整图片大小。
指定宽度和保留比率
1![Resize](featured-sample.webp?width=300px)
指定高度和保留比率
1![Resize](featured-sample.webp?height=200px)
指定宽度和高度
1![Resize](featured-sample.webp?width=300px&height=200px)
它不仅可以用于页面资源,而且也适用于 static 图像和外部图像。 但是,除了页面资源外,其他资源的大小都是按内联样式调整的,也就是说,它们的原始大小不会改变。
对齐图像
我们可以利用 URL 片段轻易地对齐图像,比如:#center
, #float-start
和 #float-end
分别表示居中对齐、向左浮动和向右浮动。
居中对齐
添加 #center
使图片居中对齐。
举个例子:![Center](/center.png#center)
。
向左浮动
添加 #float-start
使图片向左浮动。
举个例子:![Float Start](/featured-sample.webp#float-start)
。
向右浮动
同样的,我们也可以添加 #float-end
使图片向右浮动。
举个例子:![Float End](/featured-sample.webp#float-end)
。
Caption
HBS 允许使用图片标题作为 caption,但这个功能默认是关闭的,你需要启用 post.imageTitleAsCaption
参数:
params.toml
1[post]
2 imageTitleAsCaption = true
params.yaml
1post:
2 imageTitleAsCaption: true
params.json
1{
2 "post": {
3 "imageTitleAsCaption": true
4 }
5}
1![Image Caption](/featured-sample.webp "Use Image Title as Caption")
Crop Images
Crop an image to match the given dimensions without resizing. You must provide both width and height. Use the anchor1 option to change the crop box anchor point.
1![Crop Image](/featured-sample.webp?crop=[width]x[height],[anchor])
- The size
[width]x[height]
is required. [anchor]
is optional, the,
is used to separate the size and anchor.
Examples | ||
---|---|---|
Fill Images
Crop and resize an image to match the given dimensions. You must provide both width and height. Use the anchor1 option to change the crop box anchor point.
1![Fill Image](/featured-sample.webp?fill=[width]x[height],[anchor])
- The size
[width]x[height]
is required. [anchor]
is optional, the,
is used to separate the size and anchor.
Examples | ||
---|---|---|
Fit Images
Downscale an image to fit the given dimensions while maintaining aspect ratio. You must provide both width and height.
1![Fit Image](/featured-sample.webp?fit=[width]x[height])
Filters
Brightness
The brightness
must be in range (-100, 100)
.
1![Image Brightness](/featured-sample.webp?brightness=-30)
ColorBalance
ColorBalance creates a filter that changes the color balance of an image. The percentage parameters for each color channel (red, green, blue) must be in range (-100, 500)
.
1![Image ColorBalance](/featured-sample.webp?colorBalance=-50,50,150)
Colorize
Colorize creates a filter that produces a colorized version of an image. The hue parameter is the angle on the color wheel, typically in range (0, 360)
. The saturation parameter must be in range (0, 100)
. The percentage parameter specifies the strength of the effect, it must be in range (0, 100)
.
1![Image Colorize](/featured-sample.webp?colorize=-100,50,150)
Contrast
The contrast
must be in range (-100, 100)
.
1![Image Contrast](/featured-sample.webp?contrast=50)
Gamma
Gamma creates a filter that performs a gamma correction on an image. The gamma parameter must be positive. Gamma = 1 gives the original image. Gamma less than 1 darkens the image and gamma greater than 1 lightens it.
1![Image Gamma](/featured-sample.webp?gamma=2)
GaussianBlur
Applies a gaussian blur to an image.
1![Image GaussianBlur](/featured-sample.webp?gaussianBlur=2)
Grayscale
Grayscale creates a filter that produces a grayscale version of an image.
1![Image Grayscale](/featured-sample.webp?grayscale)
Hue
Hue creates a filter that rotates the hue of an image. The hue angle shift is typically in range -180
to 180
.
1![Image Hue](/featured-sample.webp?hue=90)
Invert
Invert creates a filter that negates the colors of an image.
1![Image Invert](/featured-sample.webp?invert)
Pixelate
Pixelate creates a filter that applies a pixelation effect to an image.
1![Image Pixelate](/featured-sample.webp?pixelate=8)
Saturation
Saturation creates a filter that changes the saturation of an image.
1![Image Saturation](/featured-sample.webp?saturation=100)
Sepia
Sepia creates a filter that produces a sepia-toned version of an image.
1![Image Sepia](/featured-sample.webp?sepia=200)
Sigmoid
Sigmoid creates a filter that changes the contrast of an image using a sigmoidal function and returns the adjusted image. It’s a non-linear contrast change useful for photo adjustments as it preserves highlight and shadow detail.
1![Image Sigmoid](/featured-sample.webp?sigmoid=2,5)
UnsharpMask
UnsharpMask creates a filter that sharpens an image. The sigma parameter is used in a gaussian function and affects the radius of effect. Sigma must be positive. Sharpen radius roughly equals 3 * sigma. The amount parameter controls how much darker and how much lighter the edge borders become. Typically between 0.5
and 1.5
. The threshold parameter controls the minimum brightness change that will be sharpened. Typically between 0
and 0.05
.
1![Image UnsharpMask](/featured-sample.webp?unsharpMask=10,1,0.05)
评论