1
0
Fork 0
freesewing/markdown/dev/tutorials/pattern-design/part2/adding-measurements/en.md

65 lines
1.9 KiB
Markdown
Raw Normal View History

---
title: Adding measurements
order: 130
---
2023-09-28 09:11:06 +02:00
FreeSewing is all about _made-to-measure_ sewing patterns -- or *parametric
design* to use a more generic term.
That means that when drafting our pattern, I will take the measurements provided
by the user into account.
Which begs the question, which measurements?
2023-09-28 09:11:06 +02:00
As the pattern designers, you get to decide which measurements are used
to draft the pattern. For this bib, I am going to use the
_head circumference_.
So let's add it as a required measurement.
## Adding required measurements
2023-09-28 09:11:06 +02:00
In our `design/src/bib.mjs` file, we will add a `measurements` property to the `bib` object.
This property will be an Array (a list) holding all required measurements for this part.
2023-09-28 09:11:06 +02:00
I am usign [*the official name* of the measurement](/reference/measurements) here. For head
circumference, that name is `head`.
```design/src/bib.mjs
2023-09-28 09:11:06 +02:00
function draftBib({ part }) => {
return part
}
export const bib = {
name: 'tutorial.bib',
2023-08-08 13:20:46 -05:00
draft: draftBib,
2023-09-28 09:11:06 +02:00
// highlight-start
measurements: [ 'head' ],
// highlight-end
}
```
2023-09-28 09:11:06 +02:00
From now on, this part requires the `head` measurement.
2023-09-28 09:11:06 +02:00
This change will also get picked up by the development environment, which will now complain that it is missing some measurements.
Since it's just one measurement, I will simply enter a value by hand.
For example `38` as 38 cm is a realistic head circumference measurement for a baby.
2023-09-28 09:11:06 +02:00
<Tip>
2023-09-28 09:11:06 +02:00
##### Why using standard measurements names matters
2023-09-28 09:11:06 +02:00
In principle, I can use any name I want for our measurements.
The FreeSewing core library does not care.
However, if everybody uses their own (names for) measurements, then people
aren't able to re-use their measurements across designs.
So if you have any intention at all to play nice with the FreeSewing ecosystem,
please make sure to re-use the names of existing measurements, rather than
invent your own.
2023-09-28 09:11:06 +02:00
See the [best practices](/guides/best-practices/reuse-measurements) on this
topic for details.
2023-09-28 09:11:06 +02:00
</Tip>