ipptransform3d(7)

✨ ipptransform3d — the glow-up ✨

okay so bestie, this is ipptransform3d from the Apple Inc. manual crew (section 7, we're fancy like that 💅). she converts 3d document data into alternate formats and she is so good at it. let's get into it 🫶

---

🌸 NAME 🌸

ipptransform3d — convert 3d document data to alternate formats 🦋

---

🎀 SYNOPSIS 🎀

ipptransform3d [ --help ] [ -d device-uri ] [ -i input/format ] [ -m
output/format;machine=name ] [ -o name=value [... name=value] ] [ -v ]
filename

---

💖 DESCRIPTION 💖

so like, ipptransform3d takes your input file, converts it into the output format, and — if you want — literally sends the output straight to a USB (serial) printer. no cap. 🔥

and the tea is, you're probably not even running it yourself: ipptransform3d is normally run by ippserver(8) to convert document data for printing. she's the backstage icon making it all work 👑

---

✨ OPTIONS ✨

here's everything ipptransform3d recognizes, and yes we're going through all of them because nothing gets skipped in this house 💜

• --help — shows program help. that's it, that's the whole vibe 🙈
• -d device-uri — specifies an output device as a URI. rn only the "usbserial" URI scheme is supported, like "usbserial:///dev/ttyACM0" to send print data to an attached USB printer on Linux. lowkey specific but she works 🖨️
• -i input/format — specifies the MIME media type of the input file. currently the "model/3mf" (3MF) and "application/sla" (STL) MIME media types are supported 🍓
• -m output/format;machine=name — specifies the MIME media type of the output file. currently only the "application/g-code" (G-code) MIME media type is supported. the "machine=name" parameter specifies a machine-specific variant such as "ultimaker2" 🧚
• -o "name=value[...name=value]" — specifies one or more named options for the conversion. currently the "materials-col", "platform-temperature", "print-accuracy", "print-base", "print-quality", and "print-supports" options are supported. head down to the NAMED OPTIONS section for the full scoop 💅
• -v — increases the verbosity for any diagnostics. she gets chatty. iconic behavior 💬

---

🌈 NAMED OPTIONS 🌈

the following named options are supported:

💜 materials-col

specifies the material(s) to use. each value is surrounded by curley braces and contains a list of material properties and their values, e.g., '{material-diameter=285 material-type="pla" ...}'. the "material-diameter", "material-fill-density", "material-purpose", "material-rate", "material-rate-units", "material-shell-thickness", "material-temperature", and "material-type" properties are supported. so many properties, she's thorough 💖

💜 platform-temperature

specifies the temperature of the build platform in degrees Celsius. 🌡️

💜 print-accuracy

specifies the dimensional accuracy requirements for the print. for example, a horizontal accuracy of 0.1mm and vertical accuracy of 0.05mm is '{x-accuracy=100 y-accuracy=100 z-accuracy=50 accuracy-units=um}'. precision queen fr fr ✨

💜 print-base

specifies whether brims, rafts, or skirts should be printed. the values 'none', 'brim', 'raft', and 'skirt' are supported. pick your fighter 🎀

💜 print-quality

specifies the print quality with value 3 (draft), 4 (normal), or 5 (high/best). 5 is the main character option, just saying 👑

💜 print-supports

specifies whether supports are printed. the values 'none', 'material', and 'standard' are supported. we love a supportive icon 🫶

---

😭 DIAGNOSTICS 😭

ipptransform3d sends all messages to the standard error. each message is prefixed with "ERROR", "INFO", or "DEBUG" depending on the level of verbosity. so you always know exactly what's giving what 💀

---

⭐ EXIT STATUS ⭐

the ipptransform3d program returns 0 if the input file is converted successfully and 1 otherwise. binary queen. no in-between 🌈

---

🦋 ENVIRONMENT 🦋

ipptransform3d recognizes the following environment variables:

• CONTENT_TYPE — specifies the MIME media type of the input file.
• DEVICE_URI — specifies the output device as a URI.
• DOCUMENT_NAME — specifies the title of the input file.
• IPP_xxx — specifies the value of the "xxx" Job Template attribute, where "xxx" is converted to uppercase. for example, the "materials-col" Job Template attribute is stored as the "IPP_MATERIALS_COL" environment variable.
• IPP_xxx_DEFAULT — specifies the default value of the corresponding "xxx-default" Printer Description attribute, where "xxx" is converted to uppercase. for example, the "materials-col-default" Printer Description attribute is stored as the "IPP_MATERIALS_COL_DEFAULT" environment variable.
• OUTPUT_TYPE — specifies the MIME media type of the output file. for 'application/g-code' the "flavor" media type parameter specifies the variant of G-code to produce: 'bfb', 'griffin', 'mach3', 'makerbot', 'reprap' (default), 'reprap-volumatric', and 'ultimaker' are currently supported. so many flavors, literally a whole menu 🍓
• SERVER_LOGLEVEL — specifies the log level (verbosity) as "error", "info", or "debug".

---

🎀 EXAMPLES 🎀

print a 3MF file to a G-code printer connected via USB on Linux using the default options:

ipptransform3d -d usbserial:///dev/usbACM0 -m application/g-code \
    filename.3mf

ate and left no crumbs 💅

---

💅 SEE ALSO 💅

ippdoclint(7), ippserver(8), ipptool(1), ipptransform(7)

the whole friend group, love that for them 🫶

---

👑 COPYRIGHT 👑

Copyright © 2016-2019 by the IEEE-ISTO Printer Working Group. Copyright © 2016-2019 by Apple Inc.

---

okay that's the whole page bestie, you're officially educated 💖 this was the ippsample version, dated 2019-05-17 — thanks for reading, mwah, bye 🎀✨🦋