image
Element
Element functions can be customized with set and show rules.
set and show rules.ラスターまたはベクター画像。
画像をfigureで囲むことで、番号とキャプションを与えることができます。
ほとんどの要素と同様に、画像はデフォルトでは ブロックレベル であるため、隣接する段落に統合されることはありません。
画像を強制的にインラインにするには、boxの中に入れてください。
Example
#figure(
image("molecular.jpg", width: 80%),
caption: [
A step in the molecular testing
pipeline of our lab.
],
)
Parameters
Parameters are the inputs to a function. They are specified in parentheses after the function name.
path
画像ファイルのパス。
より詳細な情報はパスの章を参照してください。
format
画像のフォーマット。デフォルトでは自動的に検出されます。
サポートされている拡張子は PNG, JPEG, GIF, SVGです。 PDFの画像はまだサポートされていません。
-
"png"イラストや透明グラフィック用のラスターフォーマット。
-
"jpg"写真に適した非可逆ラスターフォーマット。
-
"gif"短いアニメーションクリップによく使われるラスターフォーマット。
-
"svg"Webサイトに用いられるベクターフォーマット。
Default:auto
width
画像の幅。
Default:auto
height
画像の高さ。
Default:auto
alt
画像の説明文。
Default:none
fit
Settable
Settable parameters can be customized for all following uses of the function with a set rule.
set rule.与えられた領域に対して、画像をどのように調整するか。
領域は width や height フィールドで定義します。
領域の縦横比が画像の縦横比と同じであれば、fit で見た目が変わらないことに注意してください。
-
"cover"領域を完全にカバーします。 水平または垂直方向にのみ画像をトリミングすることで、アスペクト比を保持します。 これがデフォルトです。
-
"contain"画像は領域内に完全に収まるようにします。 アスペクト比を維持して、画像を切り取らず、1つの寸法は指定より狭くします。
-
"stretch"たとえ画像が歪むことになっても、その領域を正確に埋めるように引き伸ばします。 アスペクト比は保たれず、画像は切り取られません。
Default:"cover"
View example
#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")
Definitions
Functions and types and can have associated definitions. These are accessed by specifying the function or type, followed by a period, and then the definition's name.
decode
バイトまたは文字列からラスターまたはベクトル図形をデコードします。
View example
#let original = read("diagram.svg")
#let changed = original.replace(
"#2B80FF", // blue
green.to-hex(),
)
#image.decode(original)
#image.decode(changed)
data
画像としてデコードするデータ。SVG の場合は文字列です。
format
画像のフォーマット。デフォルトでは自動的に検出されます。
-
"png"イラストや透明グラフィック用のラスターフォーマット。
-
"jpg"写真に適した非可逆ラスターフォーマット。
-
"gif"短いアニメーションクリップによく使われるラスターフォーマット。
-
"svg"Webサイトに用いられるベクターフォーマット。
width
画像の幅。
height
画像の高さ。
alt
画像の説明文。
fit
与えられた領域に対して、画像をどのように調整するか。
-
"cover"領域を完全にカバーします。 水平または垂直方向にのみ画像をトリミングすることで、アスペクト比を保持します。 これがデフォルトです。
-
"contain"画像は領域内に完全に収まるようにします。 アスペクト比を維持して、画像を切り取らず、1つの寸法は指定より狭くします。
-
"stretch"たとえ画像が歪むことになっても、その領域を正確に埋めるように引き伸ばします。 アスペクト比は保たれず、画像は切り取られません。