情報 / Info当サイトは、Typst GmbHの許諾を得て、日本語コミュニティ「Typst Japan Community」がTypst v0.13.1の公式ドキュメントを翻訳したものです。誤訳や古い情報が含まれている可能性があるため、公式ドキュメントとの併用を推奨します。翻訳の改善やサイトの機能向上について、GitHubでのIssueやPull Requestを歓迎します。コミュニティにご興味のある方はDiscordサーバー「くみはんクラブ」にぜひご参加ください。
This site provides a Japanese translation of the Typst v0.13.1 documentation maintained by the "Typst Japan Community" with permission from Typst GmbH. We recommend using this alongside the official documentation. We welcome contributions through Issues and Pull Requests on our GitHub repository for both translation improvements and website enhancements. Feel free to join our Discord server "Kumihan Club".

`curve`
Element

A curve consisting of movements, lines, and Bézier segments.

At any point in time, there is a conceptual pen or cursor.

Move elements move the cursor without drawing.
Line/Quadratic/Cubic elements draw a segment from the cursor to a new position, potentially with control point for a Bézier curve.
Close elements draw a straight or smooth line back to the start of the curve or the latest preceding move segment.

For layout purposes, the bounding box of the curve is a tight rectangle containing all segments as well as the point (0pt, 0pt).

Positions may be specified absolutely (i.e. relatively to (0pt, 0pt)), or relative to the current pen/cursor position, that is, the position where the previous segment ended.

Bézier curve control points can be skipped by passing none or automatically mirrored from the preceding segment by passing auto.

Example

#curve(
  fill: blue.lighten(80%),
  stroke: blue,
  curve.move((0pt, 50pt)),
  curve.line((100pt, 50pt)),
  curve.cubic(none, (90pt, 0pt), (50pt, 0pt)),
  curve.close(),
)

引数

curve(

fill:

none color gradienttiling

fill-rule:

str

stroke:

none auto length color gradient stroketilingdictionary

content

)->

content

`fill`
none color gradienttiling
Settable

How to fill the curve.

When setting a fill, the default stroke disappears. To create a rectangle with both fill and stroke, you have to configure both.

デフォルト値:

none

`fill-rule`
str
Settable

The drawing rule used to fill the curve.

使用可能な文字列値:

non-zero
Specifies that "inside" is computed by a non-zero sum of signed edge crossings.
even-odd
Specifies that "inside" is computed by an odd number of edge crossings.

デフォルト値:

"non-zero"

例を表示

// We use `.with` to get a new
// function that has the common
// arguments pre-applied.
#let star = curve.with(
  fill: red,
  curve.move((25pt, 0pt)),
  curve.line((10pt, 50pt)),
  curve.line((50pt, 20pt)),
  curve.line((0pt, 20pt)),
  curve.line((40pt, 50pt)),
  curve.close(),
)

#star(fill-rule: "non-zero")
#star(fill-rule: "even-odd")

`stroke`
none auto length color gradient stroketilingdictionary
Settable

How to stroke the curve. This can be:

Can be set to none to disable the stroke or to auto for a stroke of 1pt black if and if only if no fill is given.

デフォルト値:

auto

例を表示

#let down = curve.line((40pt, 40pt), relative: true)
#let up = curve.line((40pt, -40pt), relative: true)

#curve(
  stroke: 4pt + gradient.linear(red, blue),
  down, up, down, up, down,
)

`components`
content
Required
Positional
Variadic

The components of the curve, in the form of moves, line and Bézier segment, and closes.

定義

`move`
Element

Starts a new curve component.

If no curve.move element is passed, the curve will start at (0pt, 0pt).

curve.move(

)->

例を表示

#curve(
  fill: blue.lighten(80%),
  fill-rule: "even-odd",
  stroke: blue,
  curve.line((50pt, 0pt)),
  curve.line((50pt, 50pt)),
  curve.line((0pt, 50pt)),
  curve.close(),
  curve.move((10pt, 10pt)),
  curve.line((40pt, 10pt)),
  curve.line((40pt, 40pt)),
  curve.line((10pt, 40pt)),
  curve.close(),
)

`start`
array
Required
Positional

The starting point for the new component.

`relative`
bool
Settable

Whether the coordinates are relative to the previous point.

デフォルト値:

false

`line`
Element

Adds a straight line from the current point to a following one.

curve.line(

)->

例を表示

#curve(
  stroke: blue,
  curve.line((50pt, 0pt)),
  curve.line((50pt, 50pt)),
  curve.line((100pt, 50pt)),
  curve.line((100pt, 0pt)),
  curve.line((150pt, 0pt)),
)

`end`
array
Required
Positional

The point at which the line shall end.

`relative`
bool
Settable

Whether the coordinates are relative to the previous point.

デフォルト値:

false

例を表示

#curve(
  stroke: blue,
  curve.line((50pt, 0pt), relative: true),
  curve.line((0pt, 50pt), relative: true),
  curve.line((50pt, 0pt), relative: true),
  curve.line((0pt, -50pt), relative: true),
  curve.line((50pt, 0pt), relative: true),
)

`quad`
Element

Adds a quadratic Bézier curve segment from the last point to end, using control as the control point.

curve.quad(

)->

例を表示

// Function to illustrate where the control point is.
#let mark((x, y)) = place(
  dx: x - 1pt, dy: y - 1pt,
  circle(fill: aqua, radius: 2pt),
)

#mark((20pt, 20pt))

#curve(
  stroke: blue,
  curve.move((0pt, 100pt)),
  curve.quad((20pt, 20pt), (100pt, 0pt)),
)

`control`
none auto array
Required
Positional

The control point of the quadratic Bézier curve.

If auto and this segment follows another quadratic Bézier curve, the previous control point will be mirrored.
If none, the control point defaults to end, and the curve will be a straight line.

例を表示

#curve(
  stroke: 2pt,
  curve.quad((20pt, 40pt), (40pt, 40pt), relative: true),
  curve.quad(auto, (40pt, -40pt), relative: true),
)

`end`
array
Required
Positional

The point at which the segment shall end.

`relative`
bool
Settable

Whether the control and end coordinates are relative to the previous point.

デフォルト値:

false

`cubic`
Element

Adds a cubic Bézier curve segment from the last point to end, using control-start and control-end as the control points.

curve.cubic(

)->

例を表示

// Function to illustrate where the control points are.
#let handle(start, end) = place(
  line(stroke: red, start: start, end: end)
)

#handle((0pt, 80pt), (10pt, 20pt))
#handle((90pt, 60pt), (100pt, 0pt))

#curve(
  stroke: blue,
  curve.move((0pt, 80pt)),
  curve.cubic((10pt, 20pt), (90pt, 60pt), (100pt, 0pt)),
)

`control-start`
none auto array
Required
Positional

The control point going out from the start of the curve segment.

If auto and this element follows another curve.cubic element, the last control point will be mirrored. In SVG terms, this makes curve.cubic behave like the S operator instead of the C operator.
If none, the curve has no first control point, or equivalently, the control point defaults to the curve's starting point.

例を表示

#curve(
  stroke: blue,
  curve.move((0pt, 50pt)),
  // - No start control point
  // - End control point at `(20pt, 0pt)`
  // - End point at `(50pt, 0pt)`
  curve.cubic(none, (20pt, 0pt), (50pt, 0pt)),
  // - No start control point
  // - No end control point
  // - End point at `(50pt, 0pt)`
  curve.cubic(none, none, (100pt, 50pt)),
)

#curve(
  stroke: blue,
  curve.move((0pt, 50pt)),
  curve.cubic(none, (20pt, 0pt), (50pt, 0pt)),
  // Passing `auto` instead of `none` means the start control point
  // mirrors the end control point of the previous curve. Mirror of
  // `(20pt, 0pt)` w.r.t `(50pt, 0pt)` is `(80pt, 0pt)`.
  curve.cubic(auto, none, (100pt, 50pt)),
)

#curve(
  stroke: blue,
  curve.move((0pt, 50pt)),
  curve.cubic(none, (20pt, 0pt), (50pt, 0pt)),
  // `(80pt, 0pt)` is the same as `auto` in this case.
  curve.cubic((80pt, 0pt), none, (100pt, 50pt)),
)

`control-end`
none array
Required
Positional

The control point going into the end point of the curve segment.

If set to none, the curve has no end control point, or equivalently, the control point defaults to the curve's end point.

`end`
array
Required
Positional

The point at which the curve segment shall end.

`relative`
bool
Settable

Whether the control-start, control-end, and end coordinates are relative to the previous point.

デフォルト値:

false

`close`
Element

Closes the curve by adding a segment from the last point to the start of the curve (or the last preceding curve.move point).

curve.close(

mode:

str

)->

content

例を表示

// We define a function to show the same shape with
// both closing modes.
#let shape(mode: "smooth") = curve(
  fill: blue.lighten(80%),
  stroke: blue,
  curve.move((0pt, 50pt)),
  curve.line((100pt, 50pt)),
  curve.cubic(auto, (90pt, 0pt), (50pt, 0pt)),
  curve.close(mode: mode),
)

#shape(mode: "smooth")
#shape(mode: "straight")

`mode`
str
Settable

How to close the curve.

使用可能な文字列値:

smooth
Closes the curve with a smooth segment that takes into account the control point opposite the start point.
straight
Closes the curve with a straight line.

デフォルト値:

"smooth"

curveElementヘルプアイコンElement functions can be customized with set and show rules.

Example

引数ヘルプアイコンParameters are the inputs to a function. They are specified in parentheses after the function name.

fillnonecolorgradienttilingSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

fill-rulestrSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

使用可能な文字列値:

strokenoneautolengthcolorgradientstroketilingdictionarySettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

componentscontentRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.VariadicヘルプアイコンVariadic parameters can be specified multiple times.

定義ヘルプアイコン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.

moveElementヘルプアイコンElement functions can be customized with set and show rules.

startarrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

relativeboolSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

lineElementヘルプアイコンElement functions can be customized with set and show rules.

endarrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

relativeboolSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

quadElementヘルプアイコンElement functions can be customized with set and show rules.

controlnoneautoarrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

endarrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

relativeboolSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

cubicElementヘルプアイコンElement functions can be customized with set and show rules.

control-startnoneautoarrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

control-endnonearrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

endarrayRequiredヘルプアイコンRequired parameters must be specified when calling the function.PositionalヘルプアイコンPositional parameters are specified in order, without names.

relativeboolSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

closeElementヘルプアイコンElement functions can be customized with set and show rules.

modestrSettableヘルプアイコンSettable parameters can be customized for all following uses of the function with a set rule.

使用可能な文字列値:

検索

`curve`
Element

引数

`fill`
none color gradienttiling
Settable

`fill-rule`
str
Settable

`stroke`
none auto length color gradient stroketilingdictionary
Settable

`components`
content
Required
Positional
Variadic

定義

`move`
Element

`start`
array
Required
Positional

`relative`
bool
Settable

`line`
Element

`end`
array
Required
Positional

`relative`
bool
Settable

`quad`
Element

`control`
none auto array
Required
Positional

`end`
array
Required
Positional

`relative`
bool
Settable

`cubic`
Element

`control-start`
none auto array
Required
Positional

`control-end`
none array
Required
Positional

`end`
array
Required
Positional

`relative`
bool
Settable

`close`
Element

`mode`
str
Settable