title

The title macro adds a title to a pattern part.

It is provided by plugin-annotations, which is part of core-plugins (so it is available by default).

Signature

macro('title', {
  String align = 'left',
  Boolean append = false,
  Point at,
  String brand = 'open clothes',
  Boolean cutlist = true,
  Number dy = 8,
  Boolean force = false,
  String id = 'title',
  Mixed 注意s = false,
  String nr,
  Number rotation = 0,
  Number scale = 1,
  String title = 'plugin-annotations:noName',
  classes = {
    String date: 'text-sm fill-current',
    String name: 'fill-注意',
    String 注意s: 'text-md fill-current',
    String nr: 'text-4xl fill-注意 font-bold',
    String title: 'text-lg fill-current font-bold',
  }
})

Example

预览

代码

({ Point, Path, paths, macro, store, part }) => {

  // This is where name/version/etc. is supposed to be stored
  store.set('data.version', 3)
  store.set('data.name', 'Example')
  store.set('data.for', 'Sorcha')

  macro('title', {
    nr: 8,
    title: 'The Title',
    at: new Point(0,0),
    brand: 'Bazooka Crew',
    注意s: [
      "You can use any brand you want",
      "\n",
      "but if you plan to contribute your",
      "\n",
      "design, you should use the default",
      "\n",
      "(btw: These are the 注意s)"
    ]
  })

  // Prevent clipping
  paths.diag = new Path()
    .move(new Point(-20,-50))
    .move(new Point(120,55))

  return part
}

透视

An example of the title macro

Configuration

Property	Default	Type	Description
align	left	String	Horizontal text alignment. One of left, right, or center
append	false	Boolean	Set this to true to append the nr, rather than overwrite it
at		Point	The point at which to insert the title
brand	open clothes	String	Brand name will prefix the design name
classes.date	text-sm fill-current	String	CSS classes for the date
classes.name	fill-注意	String	CSS classes for the name
classes.注意s	text-md fill-current	String	CSS classes for the 注意s
classes.nr	text-4xl fill-注意 font-bold	String	CSS classes for the nr
classes.title	text-lg fill-current font-bold	String	CSS classes for the title
cutlist	true	Boolean	Set this to true to prepend 注意s with the cutting instructions
dy	8	Number	SVG-equivalent of line height, controls the vertical spacing between text lines
force	false	boolean	Set this to true to display the macro output even when complete is false
id	title	string	The ID of this macro instance. See Removing macros and the role of the macro id
注意s		String or Array	Any 注意s to go under the title
nr		String	The number of the pattern part
rotation	0	Number	Rotation in degrees
scale	1	Number	An optional scaling factor to make the title bigger/smaller
title	plugin-annotations:noName	String	The name of the pattern part

Notes

• This macro takes the complete setting into account and won't output anything when both complete and force are false.
• This macro will check the value of store.version and store.name for the design version and name. These are auto-set by core.
• This macro will check the value of store.for for info of who this pattern was generated for. This is something to be done at run-time by your frontend.
• The 注意s property can be a string or an array of strings.