SKETCH(1)

💅 SKETCH(1) — User Commands, bestie edition ✨

okay so picture this: it's sketch(1), and it makes 3D line drawings out of a scene description language. that's the whole vibe. it's giving "draw me like one of your French girls but make it vector" 🎀

🌸 NAME 🌸

sketch — produce 3D line drawings from scene description language

no cap, that's literally the job description 💖

✨ DESCRIPTION ✨

here's the whole shape of it, bestie:

sketch [options] file1 [-D tag] [-U tag] file2...

so you feed it files, you can flip tags on and off as you go, and it does the thing. the options are where the ✨magic✨ lives, so let's go one by one, no skipping, we're doing all of them 🫶

• -h — prints a summary of options to stderr. it's the "help me bestie" button. note it goes to stderr, not stdout, so don't @ me if your pipe comes up empty 👀
• -v — prints version info to standard output. cute little "hi, this is who I am" moment 💅
• -d — debug the parser. this one's for the developers, the people in the lab coats, the ones who are actually built different 🔬
• -b — use the BSP algorithm instead of the Painters algorithm for hidden surface removal. two ways to figure out what's in front, pick your fighter 🥊
• -T[u|e][p[P|T]] — produce a complete LaTeX document 👑 this one has its own little sub-menu, so stay with me:
  • u — U.S. paper size, 8.5 x 11 inches. this is the default, bestie 🍓
  • e — European A4 paper size, 297 x 210 mm. for the international girlies 🌍
  • p — print the document template to stdout 📄
  • P — print the PSTricks version of the doc template. this is the default when you're picking between P and T ⭐
  • T — print the TikZ version of the doc template 🌈
• -t templatefile — load your very own user document template. it can be any text file, and it just has to have the escape %SKETCH_OUTPUT% in it, and that's where your output goes 🎀
• -o outfile — put the output in outfile. the default is stdout, so if you say nothing, it just yells into the void (the void being your terminal) 💀
• -D tag — define the given tag. tag's on, periodt ✅
• -U tag — undefine the given tag. tag's off, no cap ❌

🔍 SEE ALSO 🔍

the full documentation for sketch is living its best life as a Texinfo manual. so if the info and sketch programs are properly installed at your site, this little command right here

info sketch

should hand you the complete manual. access granted 🔓✨

👑 AUTHOR 👑

this manual page was written by David Bremner <bremner@unb.ca> for the Debian(TM) system (but it may be used by others, it's not gatekeeping 🫶). permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

and on Debian systems specifically, the complete text of the GNU General Public License can be found in:

/usr/share/common-licenses/GPL

like, the whole thing, right there, go read it if that's your vibe 📚

💖 COPYRIGHT 💖

Copyright © 2009 David Bremner

and that's the tea, bestie 🦋 this page was serving sketch 0.2.159, dated July 7, 2009, and honestly? iconic. slay. go draw something. 💅✨🎀