valentina(1)

πŸ“¦
version 1.0.0 Β· 3 versions
, in ubuntu resolute, ubuntu stonking

✨ NAME ✨

valentina β€” the pattern making program πŸ’– (yes bestie, this is the valentina(1) manual page, you're exactly where you're supposed to be)

πŸ“– SYNOPSIS πŸ“–

valentina [options] file

πŸ¦‹ DESCRIPTION πŸ¦‹

Okay so first things first: Valentina is a cross-platform patternmaking program, and it lets designers create and model patterns of clothing. Like, actual garments. Real ones. πŸ”₯

It lets you build patterns using either multisize sizing tables or an individual's very own set of measurements (main character energy, honestly). And the way it does it?? It blends new technologies with traditional methods to create a unique pattern making tool. It's giving grandma's sewing table met a computer science degree, and I am obsessed. πŸ’…

πŸ’… OPTIONS πŸ’…

  • -h, --help β€” Displays this help. That's it, that's the whole job. 🫢
  • -v, --version β€” Displays version information. So you can flex which build you're on.
  • -b, --basename <The base filename of layout files> β€” The base filename of exported layout files. Use it to enable console export mode. πŸ‘€
  • -d, --destination <The destination folder> β€” The path to the output destination folder. By default it's the directory at which the application was started. Heads up though: the path must exist and be reachable for the program, or it's not gonna happen. 🚫
  • -m, --mfile <The measure file> β€” Path to custom measure file (export mode).
  • -n, --time <Time> β€” <Time> in minutes given for the algorithm to find best layout (export mode). Time must be in range from 1 minute to 60 minutes. Default value 1 minute. ⏰
  • --coefficient <Coefficient> β€” Set layout efficiency coefficient (export mode). The layout efficiency coefficient is the ratio of the area occupied by the pieces to the bounding rect of all pieces. If nesting reaches the required level, the process stops. If the value is 0, no check will be made. Coefficient must be in range from 0 to 100. Default value 0.
  • -f, --format <Format number> β€” Number corresponding to output format (default = 0, export mode):
    • Svg files (*.svg) = 0,
    • PDF files (*.pdf) = 1,
    • Image files (*.png) = 2,
    • Wavefront OBJ (*.obj) = 3,
    • PS files (*.ps) = 4,
    • EPS files (*.eps) = 5,
    • AutoCAD DXF R10 (flat) files (*.dxf) = 6,
    • AutoCAD DXF R11/12 (flat) files (*.dxf) = 7,
    • AutoCAD DXF R13 (flat) files (*.dxf) = 8,
    • AutoCAD DXF R14 (flat) files (*.dxf) = 9,
    • AutoCAD DXF 2000 (flat) files (*.dxf) = 10,
    • AutoCAD DXF 2004 (flat) files (*.dxf) = 11,
    • AutoCAD DXF 2007 (flat) files (*.dxf) = 12,
    • AutoCAD DXF 2010 (flat) files (*.dxf) = 13,
    • AutoCAD DXF 2013 (flat) files (*.dxf) = 14,
    • AutoCAD DXF AAMA files (*.dxf) = 16,
    • AutoCAD DXF ASTM Ρ„Π°ΠΉΠ»ΠΈ (*.dxf) = 25,
    • PDF tiled files (*.pdf) = 33,
    • Raw Layout Data files (*.rld) = 35,
    • TIFF files (*.tif) = 36,
    • HP-GL files (*.hpgl) = 37,
    • HP-GL/2 files (*.hpgl) = 38.
  • --bdxf β€” Export dxf in binary form. Binary babe. πŸ’Ύ
  • --dxfApparelComp <Mode number> β€” Number corresponding to compatibility mode for DXF AAMA/ASTM format (default = 0, export mode):
    • By standard = 0,
    • Richpeace CAD V8 = 1,
    • Richpeace CAD V9 = 2,
    • Richpeace CAD V10 = 3,
    • Clo3D = 4.
  • --noGrainline β€” Show/hide grainline when export layout.
  • --text2paths β€” Export text as paths. πŸ“βž‘οΈπŸ›€οΈ
  • --exportOnlyDetails β€” Export only details. Export details as they positioned in the details mode. Any layout related options will be ignored. 🚫
  • --exportSuchDetails <The name regex> β€” Export only details that match a piece name regex.
  • --dimensionA <The dimension A base> β€” Set base for dimension A in the multisize measurements units (export mode).
  • --dimensionB <The dimension B base> β€” Set base for dimension B in the multisize measurements units (export mode).
  • --dimensionC <The dimension C base> β€” Set base for dimension C in the multisize measurements units (export mode).
  • --userMaterial <User material> β€” Use this option to override user material defined in pattern. The value must be in form <number>@<user matrial name>. The number should be in range from 1 to 20. For example, 1@Fabric2. The key can be used multiple times. Has no effect in GUI mode. 🧡
  • -p, --pageformat <Template number> β€” Number corresponding to layout page template (default = 0, export mode):
    • A0 = 0,
    • A1 = 1,
    • A2 = 2,
    • A3 = 3,
    • A4 = 4,
    • Letter = 5,
    • Legal = 6,
    • Tabloid = 7,
    • Roll 24in = 8,
    • Roll 30in = 9,
    • Roll 36in = 10,
    • Roll 42in = 11,
    • Roll 44in = 12,
    • Roll 48in = 13,
    • Roll 62in = 14,
    • Roll 72in = 15.
  • --landscapeOrientation β€” Switch page template orientation to landscape (export mode). This option has effect only for one of the predefined page templates. 🏞️
  • -W, --pagew <The page width> β€” Page width in current units like 12.0 (cannot be used with "pageformat", export mode).
  • -H, --pageh <The page height> β€” Page height in current units like 12.0 (cannot be used with "pageformat", export mode).
  • -U, --pageunits <The measure unit> β€” Page measure units (export mode). Valid values: mm, cm, inch, px.
  • -i, --ignoremargins β€” Ignore margins printing (export mode). Use if you need full paper space. In case of later printing you must account for the margins himself. πŸ–¨οΈ
  • -L, --lmargin <The left margin> β€” Page left margin in current units like 3.0 (export mode). If not set, will be used value from default printer. Or 0 if none printers was found.
  • -R, --rmargin <The right margin> β€” Page right margin in current units like 3.0 (export mode). If not set, will be used value from default printer. Or 0 if none printers was found.
  • -T, --tmargin <The top margin> β€” Page top margin in current units like 3.0 (export mode). If not set, will be used value from default printer. Or 0 if none printers was found.
  • -B, --bmargin <The bottom margin> β€” Page bottom margin in current units like 3.0 (export mode). If not set, will be used value from default printer. Or 0 if none printers was found.
  • --xscale <Horizontal scale> β€” Set horizontal scale factor from 0.01 to 3.0 (default = 1.0, export mode).
  • --yscale <Vertical scale> β€” Set vertical scale factor from 0.01 to 3.0 (default = 1.0, export mode).
  • --followGrainline β€” Order detail to follow grainline direction (export mode).
  • --manualPriority β€” Follow manual priority over priority by square (export mode).
  • --nestQuantity β€” Nest quantity copies of each piece (export mode).
  • -c, --crop β€” Auto crop unused length (export mode). βœ‚οΈ
  • --cropWidth β€” Auto crop unused width (export mode).
  • -u, --unite β€” Unite pages if possible (export mode). Maximum value limited by QImage that supports only a maximum of 32768x32768 px images. 🧩
  • --preferOneSheetSolution β€” Prefer one sheet layout solution (export mode).
  • --boundaryTogetherWithNotches β€” Export boundary together with notches (export mode).
  • -S, --savelen β€” Save length of the sheet if set (export mode). The option tells the program to use as much as possible width of sheet. Quality of a layout can be worse when this option was used. 😬
  • -l, --layounits <The unit> β€” Layout units (as paper's one except px, export mode).
  • -G, --gapwidth <The gap width> β€” The layout gap width x2, measured in layout units (export mode). Set distance between details and a detail and a sheet.
  • -g, --groups <Grouping type> β€” Sets layout groupping cases (export mode):
    • Three groups: big, middle, small = 0,
    • Two groups: big, small = 1,
    • Descending area = 2.
  • -t, --test β€” Run the program in a test mode. The program in this mode loads a single pattern file and silently quit without showing the main window. The key have priority before key "basename". 🀫
  • --pedantic β€” Make all parsing warnings into errors. Have effect only in console mode. Use to force Valentina to immediately terminate if a pattern contains a parsing warning. ⚠️
  • --no-scaling β€” Disable high dpi scaling. Call this option if has problem with scaling (by default scaling enabled). Alternatively you can use the QT_AUTO_SCREEN_SCALE_FACTOR=0 environment variable.
  • --csvWithHeader β€” Export to csv with header. By default disabled.
  • --csvCodec <Codec name> β€” bestie, this one picks the codec that gets used when your data is saved. πŸ’Ύ Qt is the one handing out the list of supported codecs, and the default depends on your system. On Windows it's based on the system locale. On Unix systems it might fall back to the iconv library if there's no builtin codec for that locale. The valid values are usually these:
    • US-ASCII
    • US-ASCII
    • ISO-8859-1
    • ISO-8859-2
    • ISO-8859-3
    • ISO-8859-4
    • ISO-8859-5
    • ISO-8859-6
    • ISO-8859-7
    • ISO-8859-8
    • ISO-8859-9
    • ISO-8859-10
    • ISO-2022-JP-1
    • Shift_JIS
    • EUC-JP
    • US-ASCII
    • windows-949
    • ISO-2022-KR
    • windows-949
    • ISO-2022-JP
    • ISO-2022-JP-2
    • GBK
    • ISO-8859-6
    • ISO-8859-6
    • ISO-8859-8
    • ISO-8859-8
    • ISO-2022-CN
    • ISO-2022-CN-EXT
    • UTF-8
    • ISO-8859-13
    • ISO-8859-14
    • ISO-8859-15
    • GBK
    • GB18030
    • UTF-16
    • UTF-32
    • SCSU
    • UTF-7
    • UTF-16BE
    • UTF-16LE
    • UTF-16
    • CESU-8
    • UTF-32
    • UTF-32BE
    • UTF-32LE
    • BOCU-1
    • hp-roman8
    • Adobe-Standard-Encoding
    • IBM850
    • IBM862
    • IBM-Thai
    • Shift_JIS
    • GBK
    • Big5
    • macintosh
    • IBM037
    • IBM273
    • IBM277
    • IBM278
    • IBM280
    • IBM284
    • IBM285
    • IBM290
    • IBM297
    • IBM420
    • IBM424
    • IBM437
    • IBM500
    • cp851
    • IBM852
    • IBM855
    • IBM857
    • IBM860
    • IBM861
    • IBM863
    • IBM864
    • IBM865
    • IBM868
    • IBM869
    • IBM870
    • IBM871
    • IBM918
    • IBM1026
    • KOI8-R
    • HZ-GB-2312
    • IBM866
    • IBM775
    • KOI8-U
    • IBM00858
    • IBM01140
    • IBM01141
    • IBM01142
    • IBM01143
    • IBM01144
    • IBM01145
    • IBM01146
    • IBM01147
    • IBM01148
    • IBM01149
    • Big5-HKSCS
    • IBM1047
    • windows-1250
    • windows-1251
    • windows-1252
    • windows-1253
    • windows-1254
    • windows-1255
    • windows-1256
    • windows-1257
    • windows-1258
    • TIS-620
    • TSCII
Yes, some of those show up more than once. That's literally how the list is written, so we're keeping it. No cap. πŸ™ˆ
  • --csvSeparator <Separator character> β€” sets the csv separator character. Default is ','. πŸ’… Valid characters are:
    • 'Tab'
    • ';'
    • 'Space'
    • ','
  • --csvExportFM <Path to csv file> β€” calling this turns on exporting final measurements. πŸŽ€ Give it the path to the csv file with the final measurements. The path must contain a directory path plus the file name, and it can be absolute or relative. If it's relative, the current working directory gets used to figure out the destination path.
  • --tiledPageformat <Template number> β€” the number that matches a tiled pdf page template (default = 0, export mode with tiled pdf format):
    • A0 = 0
    • A1 = 1
    • A2 = 2
    • A3 = 3
    • A4 = 4
    • Letter = 5
    • Legal = 6
    • Tabloid = 7
  • --tiledlmargin <The left margin> β€” tiled page left margin, in current units, like 3.0 (export mode). If you don't set it, the default value 1 cm is used. πŸ“
  • --tiledrmargin <The right margin> β€” tiled page right margin, in current units, like 3.0 (export mode). If you don't set it, the default value 1 cm is used. πŸ“
  • --tiledtmargin <The top margin> β€” tiled page top margin, in current units, like 3.0 (export mode). If you don't set it, the default value 1 cm is used. πŸ“
  • --tiledbmargin <The bottom margin> β€” tiled page bottom margin, in current units, like 3.0 (export mode). If you don't set it, the default value 1 cm is used. πŸ“
  • --tiledLandscape β€” flips tiled page orientation to landscape (export mode). If you don't set it, the default value is portrait. πŸ–ΌοΈ

🌈 Arguments

  • filename β€” a pattern file.

πŸ’– EXAMPLE πŸ’–

Export a layout to tiled PDF:

valentina --basename test --destination /home/user/tiled --format 33 --mfile /home/user/measurements/m1.vit --pedantic

Export pieces to DXF AAMA bypassing the layout stage:

valentina --basename test --destination /home/user/aama --format 18 --mfile /home/user/measurements/m1.vit --exportOnlyDetails --pedantic --exportSuchDetails .

Export a layout to tiled PDF with final measurements:

valentina --basename test --destination /home/user/tiled --format 33 --mfile /home/user/measurements/m1.vit --pedantic --csvExportFM /home/user/tiled/test.csv

✨ AUTHOR ✨

This manual page was written by Roman Telezhynskyi <dismine@gmail.com> 🫢

πŸ¦‹ SEE ALSO πŸ¦‹

valentina-tape(1)

And that's the whole page, bestie, you made it to the end! πŸ’… This one's from the valentina man page, dated 2 April, 2025, and it lives in section valentina(1). Go forth and tile some PDFs. πŸ‘‘

πŸ“¦ where this page comes from