Up    Next

n_icons - sphericon like polyhedra

Usage    |    Examples    |    Notes

Usage

Synopsis

n_icons [options]

Description

Creates Sphericon like polyhedra.

Options

-h
program help

-n <n>
n-icon of order n. Must be 3 or greater (default: 4)

-m <m,m2>
longitudes of model of m sides with optional m2 of m sides showing m must be even and 3 or greater (default: 36,36)

-d
dual of n-icon

-t <twist>
number of twists. Can be negative, postive or 0 (default: 1)

-x <elems>
exclude top and/or bottom if they exist. Valid values t and b

-s
place a seam in top and bottom polygons if they exist (when t = 0)

-a
place a north and south pole in top and bottom if they exist. Only valid if m2<m. Not<valid with -c h

-c <close>
close open model if m2<m. Valid values h - horizonal closure, v - vertical closure

-H
hybrid of even order n-icons and dual, -s -a -c and m2 have no effect with hybrids

-I
info on current n-icon

-o <file>
write output to file, if this option is not used the program writes to standard output
Coloring Options
-f <>

-f <int>
int is face coloring method. (the coloring is done before twist)
  1. color distinct surfaces with colors in color string
  2. color latitudinally with colors in color string
  3. color longitudinally with colors in color string checkerboard
  4. use each color in color string in succession
  5. first two colors in color string based on sign of x
  6. first two colors in color string based on sign of y
  7. first two colors in color string based on sign of z note: z is also the twist plane
  8. use first 8 colors in color string per xyz octants

-F <elems>
face colors. Default red,yellow,darkorange,darkgreen,blue,magenta, white,black,gray. Valid color names and indexes are in X11 map or use only index numbers if -M map is used (index numbers wrap) key word: seq,n - uses map colors in sequential order starting at optional map index number n

-T <tran>
face transparency. valid range from 0 to 255, 0 - invisible 255 - opaque (default: 255)

-0 <string>
face transparency pattern string. valid values 0 - T value suppressed 1 - T value applied (default: "1")

-e
edge coloring by distinct edges

-E <elems>
edge colors. Default yellow,darkgreen,blue,magenta,red,darkorange. Valid colors same as in -F

-U <tran>
edge transparency. valid range from 0 to 255, 0 - invisible 255 - opaque (default: 255)

-M <file>
map color indexes into color values using color map file

-N <elems>
write color indexes to output. Transparency settings ignored. Valid values are f - faces, e - edges

Surface Count Reporting (options above igonored)
-J <type>
list n-icons with more than one surface. Valid values for type

-K <k,k2>
range of n-icons to list for multiple surfaces

-L
long form report

-Z
filter out case 2 types

Examples

The Sphericon 
   n_icons | antiview
The Dual of the Spherican 
   n_icons -d | antiview
A Hybrid of the Sphericon and its Dual 
   n_icons -H | antiview
The N-icon of order 20 twisted 5 increments. The five surfaces are colored with the default colors. No edges or vertices are shown. 
   n_icons -n 20 -t 5 -f 1 | antiview -x ve
Same as above but only using colors red, orange, and yellow. 
   n_icons -n 20 -t 5 -f 1 -F red,orange,yellow | antiview -x ve
Same as above but 50 percent transparent. 
   n_icons -n 20 -t 5 -f 1 -F red,orange,yellow -T 128 | antiview -x ve
The N-icon of order 30 twisted 5 increments. The faces are colored white and the edges are the default colors. The edges are sized in antiview and only the explicit edges created in n_icon are shown. 
   n_icons -n 30 -t 5 -f 5 -F white -e | antiview -e 0.1 -v 0.1 -E x
The reporting subsystem is used. A list of even order N-icons with twists between 3 and 30 and more than one surface are listed. 
   n_icons -J n -K 3,30 -L

Notes

n_icons was written by Roger Kaufman. For more details on the construction see Roger's N-icon study.

Up: Programs and Documentation
Next: kcycle - kaleidocycle rings of polyhedron

Antiprism Documentation 21.11.2007 - http://www.antiprism.com/