freesewing/markdown/dev/reference/api/part/addcut/en.md

title
Part.addCut()

A part's addCut() method allows designers to specify how the part should be cut. It can also be used to remove cutting information, as an alternative to Part.removeCut().

Part.addCut() signature when adding cut information

Part.part.addCut(cut=2, material='fabric', identical=false)

In this form, this methiod takes three parameters:

Parameter	type	description	default
cut	integer	The amount of times this part should be cut.	2
material	string	The name of the material, typically one of fabric, lining, facing, interfacing, canvas, or various	fabric
identical	boolean	Whether or not parts should be cut identical (true) or mirrored (false). Mirorred is often referred to as good sides together	false

Part.addCut() signature when removing cut information

Part.part.addCut(false, material='fabric')

In this form, this methiod takes two parameters:

Parameter	type	description	default
cut	boolean	Pass false to remove the cut info for the material passed as the second parameter	2
material	string	The name of the material, typically one of fabric, lining, facing, interfacing, canvas, or various	fabric

Part.addCut() example

export default function (part) {

  // Cut two from fabric with good sides together
  part.addCut(2, 'fabric')  

  // Cut seven from lining, identical
  part.addCut(7, 'lining')  

  // Remove the lining cut info (but keep the fabric info)
  part.addCut(false, 'lining')  

  // You would do more useful stuff before returning
  return part
}

The part's grain line and whether it should be cut on fold or not will be set automatically when you call the [grainline](/reference/api/macros/grainline) or [cutonfold](/reference/api/macros/cutonfold) macro.