XFRACTINT(1)

XFRACTINT(1) πŸ’–βœ¨

okay bestie, welcome to xfractint β€” the fractal generation program that literally makes math pretty. this is her manual page, group-chat edition. grab a snack, we're doing this together 🫢


✨ NAME ✨

xfractint β€” fractal generation program. that's it. that's the vibe. she draws fractals πŸ’…


🌸 SYNOPSIS 🌸

xfractint [options] [; comments]

yes bestie, options go in, fractals come out. and yeah you can drop ; comments in there too, go off πŸ‘‘


πŸ¦‹ DESCRIPTION πŸ¦‹

Xfractint draws a wide variety of fractals. it's giving range, it's giving versatility.

Xfractint is a port of the IBM PC program fractint. periodt.

Xfractint has online documentation which should be referenced for most operation information. so like, that's your main character resource, okay?

⚠️ but real talk β€” that online documentation is from fractint, and it does not always accurately describe xfractint. so don't come for me if it's a little off, she's quoting her ex πŸ’€

a text version of the online documentation can be generated by running:

make doc

slay. free docs. we love a DIY moment πŸ“„βœ¨


πŸ’… OPTIONS πŸ’…

okay this is the part where we go through EVERY single one, no skips, no skimming, because that's what besties do:

  • -display display_name β€” specifies the X11 display to use. tell her where to show up, she'll show up πŸ’–
  • -onroot β€” indicates the resulting images should appear on the root window.
πŸ“Œ note: rubberband zoom boxes don't work on the root window. so like, cute but limited, iykyk.
  • -private β€” indicates that xfractint should allocate as many colors as possible in a private colormap. normally xfractint will use 128 colors; this flag will let you use all 256, but it may mess up the colors in other windows 😭. this is not necessary if you are using greater than 8-bit color.
  • -slowdisplay β€” indicates that the machine has a slow display, so the scrolling window should be updated infrequently. use this flag if xfractint hangs on the title screen πŸ’€ like, stuck. frozen. not the moment.
  • -fast β€” indicates that xfractint should use the faster drawing mode. instead of drawing each pixel immediately, xfractint will save up pixels and then refresh the screen every 5 seconds. depending on your X implementation, this may make drawing twice as fast. no cap πŸ”₯
  • -disk β€” use disk video. that is, generate the picture in memory instead of to the screen. the resulting picture can be saved as a gif file or printer file. lowkey a workaround queen ✨
  • -fixcolors num β€” specifies the number of colors to use. this number must be a power of two. also, this number can't be greater than the number of colors available. and, it can't be greater than 256. three rules, bestie, don't fight them πŸŽ€
  • -geometry WxH[{+-X}{+-Y}] β€” this sets the size and position of the image window. the default is 800x600 pixels. so if you want it bigger, say it with your chest πŸ“
  • -share β€” indicates that xfractint should share the current colormap. that is, xfractint uses as many colors as possible, but doesn't modify the colormap. this is not necessary with greater than 8-bit colors. the polite option 🫢
  • -simple β€” uses simpler keyboard handling. use this flag if you wish to debug xfractint with gdb, or else you may get "(gdb)" repeated infinitely. and bestie, infinitely is a LOT 😭
  • xxx=yyy β€” sets variable xxx to value yyy. see the online documentation for more details on the possible variables. plug in your little variables, go feral 🧚
  • @filename β€” loads parameters from the specified file.
  • @filename/groupname β€” reads a named group of parameters from the specified file. see, the /groupname is doing the heavy lifting here πŸ‘‘
  • -psviewer β€” allows the user to change the default postscript viewer. the viewer is called when the user prints an image with ctrl-p. the default viewer is gv. change your destiny πŸ–¨οΈβœ¨
  • -ctrlwindow β€” allows the user to have a separate control window similar to the ncurses interface. two windows, one legend πŸ’…
  • -font β€” loads the selected font.
  • -fontbold β€” loads the selected bold font. bold of her, honestly πŸ’œ

πŸ’€ BUGS πŸ’€

okay bestie, deep breath. there are many bugs and things that haven't been implemented. not ideal, but we're being honest here:

  • Boundary tracing sometimes locks up. 😭
  • Passes=2 has problems?? β€” yes, with the double question marks, i'm just the messenger.
  • Symmetry that is offset slightly doesn't always complete the image.
  • The top of the help screens are messed up. starting your xterm with -geometry 80x25 fixes this. okay so there IS a fix, we love that for us ✨
  • Xfractint uses a bizarre (to Unix users) user interface which was directly copied from the IBM version. if you don't have the appropriate keys, use the following key mappings:
    • F1 to F10 (IBM) β†’ Shift-1 to Shift-0 (Unix)
    • INSERT (IBM) β†’ I (Unix)
    • DELETE (IBM) β†’ D (Unix)
    • PAGE_UP (IBM) β†’ U (Unix)
    • PAGE_DOWN (IBM) β†’ N (Unix)
    • LEFT_ARROW (IBM) β†’ H (Unix)
    • RIGHT_ARROW (IBM) β†’ L (Unix)
    • UP_ARROW (IBM) β†’ K (Unix)
    • DOWN_ARROW (IBM) β†’ J (Unix)
    • HOME (IBM) β†’ O (Unix)
    • END (IBM) β†’ E (Unix)
    • CTL_PLUS (IBM) β†’ } (Unix)
    • CTL_MINUS (IBM) β†’ { (Unix)
πŸŽ€ screenshot this mapping list. future you will be so grateful. iykyk.

Copyright 1991 - 2010 by The Stone Soup Group

(the Stone Soup Group!! iconic name, honestly, ate)


🌈 AUTHORS 🌈

okay giving credit where credit is due, because these people built the whole thing:

  • the original Unix port was done by Ken Shirriff (shirriff@eng.sun.com).
  • Xfractint was updated to Fractint 19.5 by Tim Wegner (twegner@fractint.org) under Linux 2.0. please report updates for other platforms to Tim Wegner. the current official release is 20.0.
  • the primary authors of Fractint 20.0 are:
    • Timothy Wegner β€” twegner@fractint.org
    • Jonathan Osuch β€” josuch@fractint.org
    • George Martin β€” ggmartin@compuserve.com
    • Robin Bussell β€” robin.b2@ukonline.co.uk

legends. all of them. absolute main character energy 🫢🌟


and that's the whole page, bestie!! go make some fractals, be safe with -private (it WILL mess up your other windows, i warned you), and remember: this was version 20.04 of the xfractint manual page. mwah πŸ’–