このページは日本語に翻訳済みです。
image要素関数要素関数要素関数はsetルールやshowルールでカスタマイズできます。
setルールやshowルールでカスタマイズできます。A raster or vector graphic.
You can wrap the image in a figure to give it a number and caption.
Like most elements, images are block-level by default and thus do not
integrate themselves into adjacent paragraphs. To force an image to become
inline, put it into a box.
Example
#figure(
image("molecular.jpg", width: 80%),
caption: [
A step in the molecular testing
pipeline of our lab.
],
)
引数引数引数は関数への入力値です。関数名の後に括弧で囲んで指定します。
source
例を表示
#let original = read("diagram.svg")
#let changed = original.replace(
"#2B80FF", // blue
green.to-hex(),
)
#image(bytes(original))
#image(bytes(changed))
format設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。The image's format.
By default, the format is detected automatically. Typically, you thus
only need to specify this when providing raw bytes as the
source (even then, Typst will try to figure out the
format automatically, but that's not always possible).
Supported formats are "png", "jpg", "gif", "svg",
"pdf", "webp" as well as raw pixel data.
When providing raw pixel data as the source, you must specify a
dictionary with the following keys as the format:
encoding(str): The encoding of the pixel data. One of:"rgb8"(three 8-bit channels: red, green, blue)"rgba8"(four 8-bit channels: red, green, blue, alpha)"luma8"(one 8-bit channel)"lumaa8"(two 8-bit channels: luma and alpha)
width(int): The pixel width of the image.height(int): The pixel height of the image.
The pixel width multiplied by the height multiplied by the channel count
for the specified encoding must then match the source data.
使用可能な文字列値:
pngRaster format for illustrations and transparent graphics.
jpgLossy raster format suitable for photos.
gifRaster format that is typically used for short animated clips. Typst can load GIFs, but they will become static.
webpRaster format that supports both lossy and lossless compression.
svgThe vector graphics format of the web.
pdfHigh-fidelity document and graphics format, with focus on exact reproduction in print.
デフォルト値: auto
例を表示
#image(
read(
"tetrahedron.svg",
encoding: none,
),
format: "svg",
width: 2cm,
)
#image(
bytes(range(16).map(x => x * 16)),
format: (
encoding: "luma8",
width: 4,
height: 4,
),
width: 2cm,
)
width
The width of the image.
デフォルト値: auto
height
The height of the image.
デフォルト値: auto
alt
A text describing the image.
デフォルト値: none
page設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。The page number that should be embedded as an image. This attribute only has an effect for PDF files.
デフォルト値: 1
fit設定可能引数設定可能引数設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。
setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。How the image should adjust itself to a given area (the area is defined
by the width and height fields). Note that fit doesn't visually
change anything if the area's aspect ratio is the same as the image's
one.
使用可能な文字列値:
coverThe image should completely cover the area (preserves aspect ratio by cropping the image only horizontally or vertically). This is the default.
containThe image should be fully contained in the area (preserves aspect ratio; doesn't crop the image; one dimension can be narrower than specified).
stretchThe image should be stretched so that it exactly fills the area, even if this means that the image will be distorted (doesn't preserve aspect ratio and doesn't crop the image).
デフォルト値: "cover"
例を表示
#set page(width: 300pt, height: 50pt, margin: 10pt)
#image("tiger.jpg", width: 100%, fit: "cover")
#image("tiger.jpg", width: 100%, fit: "contain")
#image("tiger.jpg", width: 100%, fit: "stretch")
scaling
A hint to viewers how they should scale the image.
When set to auto, the default is left up to the viewer. For PNG
export, Typst will default to smooth scaling, like most PDF and SVG
viewers.
Note: The exact look may differ across PDF viewers.
使用可能な文字列値:
smoothScale with a smoothing algorithm such as bilinear interpolation.
pixelatedScale with nearest neighbor or a similar algorithm to preserve the pixelated look of the image.
デフォルト値: auto
定義定義これらの関数や型には、関連する定義を持たせることができます。定義にアクセスするには、対象の関数や型の名前を指定した後に、ピリオド区切りで定義名を記述します。
decode
Decode a raster or vector graphic from bytes or a string.
data
The data to decode as an image. Can be a string for SVGs.
format
The image's format. Detected automatically by default.
使用可能な文字列値:
pngRaster format for illustrations and transparent graphics.
jpgLossy raster format suitable for photos.
gifRaster format that is typically used for short animated clips. Typst can load GIFs, but they will become static.
webpRaster format that supports both lossy and lossless compression.
svgThe vector graphics format of the web.
pdfHigh-fidelity document and graphics format, with focus on exact reproduction in print.
fit
How the image should adjust itself to a given area.
使用可能な文字列値:
coverThe image should completely cover the area (preserves aspect ratio by cropping the image only horizontally or vertically). This is the default.
containThe image should be fully contained in the area (preserves aspect ratio; doesn't crop the image; one dimension can be narrower than specified).
stretchThe image should be stretched so that it exactly fills the area, even if this means that the image will be distorted (doesn't preserve aspect ratio and doesn't crop the image).