Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OPENSCAD(1)		    General Commands Manual		   OPENSCAD(1)

NAME
       openscad	- script file based graphical CAD environment

SYNOPSIS
       openscad	[options] [file]

DESCRIPTION
       This manual page	documents briefly the openscad command.

       openscad	is a software for creating solid 3D CAD	objects. It focuses on
       CAD aspects rather than artistic	ones.

       OpenSCAD	will start as a	graphical program unless  export  options  are
       given  (see  below).  For the usage of the GUI and a description	of the
       OpenSCAD	language see  the  OpenSCAD  user  manual  at  http://en.wiki-
       books.org/wiki/OpenSCAD_User_Manual.

OPTIONS
       -o outputfile
	      Export  the given	file to	outputfile in STL, OFF,	AMF, DXF, SVG,
	      or PNG format, depending on file	extension  of  outputfile.  If
	      this option is given, the	GUI will not be	started.

	      Additional  formats,  which  are	mainly	used for debugging and
	      testing (but can also be used in automation), are	AST (the input
	      file  as parsed and serialized again), CSG (an OpenSCAD language
	      representation of	the input file with calculations done and mod-
	      ule  calls  applied),  TERM (the constructive solid geometry ex-
	      pression passed to OpenCSG).  If outputfile is null,  no	output
	      file  will  be written, but the file will	still be evaluated and
	      all echo commands	will be	written	to the standard	error  output.
	      (The rendering process will still	take place if the --render op-
	      tion is given.)

       -d file.deps
	      If the -d	option is given, all files  accessed  while  exporting
	      are written to the given deps file in the	syntax of a Makefile.

       -m make_command
	      If  a  nonexisting file is accessed during OpenSCAD's operation,
	      it will try to invoke make_command missing_file  to  create  the
	      missing file, and	then read it again.

       -D var=val
	      This  option  can	 be used to assign constant values to OpenSCAD
	      variables. The variable's	value is an  expression,  so  if  this
	      mechanism	 is  used to assign strings, care has to be taken that
	      the shell	does not consume quotation marks.  More	 than  one  -D
	      option can be given.

       --render
	      If  exporting an image, render the model fully. (Default is pre-
	      view)

       --preview[=throwntogether]
	      If exporting an image, use an  OpenCSG  preview  (optionally  in
	      throwntogether mode for quicker rendering).

       --csglimit=limit
	      If  exporting an image as	an OpenCSG preview, stop rendering af-
	      ter encountering limit elements to avoid runaway resource	usage.

       --camera=transx,transy,transz,rotx,roty,rotz,distance
	      If exporting an image, use a Gimbal camera with the given	param-
	      eters.   Rot  is	rotation around	the x, y, and z	axis, trans is
	      the distance to move the object in the x,	y, and	z  directions,
	      and  distance  is	the distance between the camera	and the	center
	      of the object.

       --camera=eyex,eyey,eyez,centerx,centery,centerz
	      If exporting an image, use a Vector camera with the given	param-
	      eters.  The first	three are for the Eye position,	while the next
	      three are	for the	Center (or target) that	the camera  will  look
	      at. The 'up' vector is not currently supported.

       --viewall
	      If  exporting  an	image, adjust camera distance to fit the whole
	      design in	the frame

       --autocenter
	      If exporting an image, center the	design in the frame

       --imgsize=width,height
	      If exporting an image, specify the pixel width and height

       --projection=[o|ortho|p|perspective]
	      If exporting an image, specify whether to	 use  orthographic  or
	      perspective projection

       --colorscheme=[Cornfield|Sunset|Metallic|Starnight|BeforeDawn|Na-
       ture|DeepOcean]
	      If exporting an image, use the specified color  scheme  for  the
	      rendering.

       -v, --version
	      Show version of program.

       --info Show  which  versions of libraries were used to compile the pro-
	      gram, and	which OpenGL details are discovered.

COMMAND	LINE EXAMPLES
       Render example001.scad into the .stl format (raw	triangle data):

       openscad	-o example001.stl examples/example001.scad

       Compile a 2d image using	a camera rotated 25 degrees in x and 35	in  z,
       distance	500, with orthographic projection:

       openscad	-o o.png o.scad	--camera=0,0,0,25,0,35,500 --projection=ortho

       Set  the	 'mode'	variable in example017 so that it will render only the
       parts of	the shape. Export to a .dxf file.

       openscad	-x example017.dxf -D'mode="parts"' examples/example017.scad

AUTHOR
       OpenSCAD	was written by Clifford	Wolf, Marius Kintel, and others.

       This manual page	was written by chrysn <chrysn@fsfe.org>, for  the  De-
       bian project (and may be	used by	others). Updated by the	OpenSCAD team.

				    2015.03			   OPENSCAD(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMAND LINE EXAMPLES | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=openscad&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help