Radout User Manual (3.9.7)
Contents
Name
Radout - Export facility from Autocad to RADIANCE scene description.
Description
Software extension for Autocad to export data to the RADIANCE lighting
simulation package of the Lawrence Berkeley Laboratory.
Autocad entities can be selected and filtered by numerous options.
Entities are sorted either by color or by layer.
The sorting results in seperate files written for every layer or color.
Other files created optionally contain initial material definitions
(plastic with the color as visible in autocad), a set up of sun
and sky and a rif file as direct input to rad(1).
Only the entities that are visible (that is their layer is on and thawed)
will be exported, even when nested in a selected block. This provides
another method of filtering elements of your drawing especially usefull
when you want to update only part of a scene.
The layer name or color number will be part of each respective filename
to make it an unique identifier. The pipe character "|" used by Autocad
within layernames associated with externally referenced blocks, as well
as the dollar sign "$" are replaced by an underscore "_" as they are
illegal or at least confusing characters for filenames on most systems.
Installation
Radout can be loaded after you have copied the radout[.arx] and
radout.dcl files to a location on your system which is included in
your Autocad search path. The method to specify or modify the necessary
environment variable ($ACAD) varies depending on the operating system.
You may have to quit and restart any Autocad process still running for
the change to take effect. In recent Releases of Autocad, this
support path is set from the "Options" dialog and usually doesn't
require to restart the program.
Loading
Load the program by entering (xload "radout")
[including the parens]
at the Autocad command prompt. In R14 and Autocad 2000 you enter
(arxload "radout") at the command prompt, or you can alternatively
load the application through the APPLOAD dialog.
Interface
The program is started by typing "radout" at the Autocad command prompt.
This will open a dialog box for editing all options.
There are a number of toggles to switch on or off by
by selecting toggle buttons in the dialog box.
Some of the toggles affect the access to some of the others as it is
apropiate for writing only subsets of the possible data. In such a
case the corresponding input facilities
in the dialog box will be grayed out and so disabled.
The dialog box looks as follows on Windows:
Options
Write Filetypes:
The following toggles and settings (upper right boxed column of the
dialog box) specify which types of information to export:
Radout does not edit the exported files. Every time you export data,
any existing files with the same names will be overwritten
without warning.
-
Geometry files
-
This switch is on by default for it is the generic purpose
of the program. Turning it off will disable the list of sampled
entity types and the sampling mode selection.
- Materials file
-
The materials of the exported objects will have
the same color (a plastic) as they appear with in autocad.
- Radiance Input File (rif)
-
This file can be given to the rad(1) program and contains
all the basic information needed to run a simulation.
- Exterior daylight file
-
This option sets the parameters of natural lighting as
required by gensky.
The input fields activated by this option determine
your location (Longitude/Latitude) and time of day and year
(Month/Day/Hour/Timezone).
Sampling modes:
These settings (the lower right boxed column in the dialog box) let
you specify the way the geometrical information will be converted.
- Assign materials by:
-
Select the sorting method here out of the following.
- Color
-
The Autocad color number as visible on the screen.
This is the default and will help you when you organize
your drawing "visually".
- Layer
-
The layer of every subentity (the one which this entity
is created on). Choose this method if you use a conceptual
layering system independently from screen display colors.
The concept of floating layers and colors within (nested)
blocks is fully supported. That means a subentity within a
block with on layer "0" and/or with the color "byblock" will
appear on the layer and with the color of the containing block.
This continues recursively if the block has those properties as
well until a level with explicitly defined properties or the
top level block is reached. Toplevel entities with the
color "byblock" are drawn with color nr. 7 (white).
- Distance Tolerance for arc approx:
-
Arc entities and arc segments of polylines have to be meshed
for the use in RADIANCE. The value you enter here specifies
how smooth these meshes will appear in the final image.
Higher values will make smoother surfaces.
The default of 0.1. It is recommended to make test for
optimised settings balancing file size and visual accuracy,
since the optimal settings depends on the size and scale
of your model.
- Distance Tolerance for arc approx:
-
(This option is not available for all versions of Radout)
The orientation of neighbouring mesh elements will not
differ by more than this amount in degrees. The default
is 15.0 degrees, which usually gives reasonable results.
The effect of this setting is independent of model size
and complexity. Please note that very low values (eg. below 2.0
degrees) can lead to unreasonably big output files and may even
crash Autocad when running out of memory.
- Output scaling factor
-
Output geometry will be scaled according to this factor. Radiance
preferrably uses international (SI) units, ie. meters.
Geometry to Export:
With the following switches (the left boxed row in the dialog box)
you can specify which entity types you wish to extract from your
drawing and in what kind of surface they should result. By default
all entities that define a surface in Autocad (opaque for the
hide and shade/render commands) are activated.
Others that can be used to simplify modelling but are rendered
differentely in Autocad than in RADIANCE are off and have to be
enabled by the user explicitly.
All polygons should keep their orientation as created in Autocad
determined by the right hand rule as explained in the RADIANCE
tutorial.
Entities extruded by thickness will be inverted if their thickness
value (or "PDSIZE" for point entities) is negative.
The current export types and their results are the following:
- 3DFACEs
-
3dfaces will be split to two triangular polygons if not planar.
- Extruded TRACEs
-
Traces will appear as a single polygon or as a box if the
thickness is not zero.
- Extruded SOLIDs
-
Solids will appear as a single polygon or as a box if the
thickness is not zero.
- Extruded CIRCLEs
-
Circles will appear as a ring with a inner radius of zero
or as a cylinder/tube with a ring at either end if their
thickness is different from zero.
- Extruded ARCs
-
Arcs with a thickness different from zero will be segmented
according to the given arc tolerance.
- Extruded LINEs
-
Lines with a thickness different from zero will appear as a
single polygon.
- Extruded 2D-PLINEs
-
2d-polylines with a thickness different from zero will appear
as a set of polygons. With R14, this includes lightweight
polylines.
- Wide 2D-PLINEs
-
2d-polylines with a starting width different from zero set in
their header entity (not the vertexes!) will appear as a
polygon following the trace of the polyline with a constant
width. This option will override the one below for poly-
lines that match both categories.
Together with a thickness and the respective option set this
will will result in a kind of a quadrilateral worm. With R14,
this includes lightweight polylines.
- 3D-MESHes
-
The Faces of 3d-polygon meshes will appear as a set of
polygons ignoring spline fits of any kind. Nonplanar faces
will be split into two triangles.
- POLYFACEs
-
The faces of polyface meshes will
appear as a set of polygons. Nonplanar faces will be split
into two triangles.
- Closed 2d-PLINES
-
2d-polylines with the closed flag set in their header entity
will appear as a polygon of the shape of the polyline.
polylines with a width will not follow this rule if the
option above is chosen as well (Wide 2d-plines).
Together with a thickness and the respective option set this
will result in a prismatic volume of the shape of the polyline.
This option is off by default. With R14, this includes lightweight
polylines.
- POINTs as Spheres
-
Point entities will appear as spheres or bubbles depending on
either their thickness (if any) or else on the value of the
Autocad system variable "PDSIZE". if the result is zero the
entity is ignored.
This option is off by default.
- ACIS entities
-
The three items relating to ACIS solid modelling entities
are disabled, since the free version of Radout doesn't
support them.
File Names:
Basename for Output:
The names of all output files will start
with the string entered here. Default is the name of the drawing
file.
OK/Cancel buttons
The OK button starts the exporting after you have selected the
entities you wish to extract. The Cancel button discards all the
setting you have made and terminates the program.
Files
Program files
- radout[.arx]
- Main program file.
- radout.dcl
- Dialog box definition file.
Additional Files
- radout.man
- This File.
- index.html
- general info.
Data files (generated by Radout)
- <prefix>_l<layername>.rad
-
Geometry data written with the Layer or Toplayer
samplemodes set.
- <prefix>_c<colornumber>.rad
-
Geometry data written with the Color samplemode set.
- <prefix>_mat.rad
- Material definitions for exported files.
- <prefix>_sun.rad
- Daylight source definitions.
- <prefix>.rif
- Radiance input file for rad(1).
Requirements
Radout 3.9.7 is meant to run with Autocad R12 and up on any unix
platform, or on WindowsNT.
Currently supprted are:
- Sun Solaris 2.x
- SGI Irix 5.x/6.x
- WindowsNT 4.0sp3+
Caveats
Please note that the AME solid modelling package by Autodesk as
included in Autocad R10-R12 generates
surfaces with surface normals pointing to the inside of the created
volumes (at least most of the times...).
Models created with the AME Solid modelling package must have surfaces
defined with the command "SOLMESH". Otherwise they consist of only
wireframe information wich cannot be extracted by Radout.
The "SOLID" entities in Autocad, which can be extracted with the
"Extruded and flat Solids" option, have nothing to do with solid
modelling, AME or ACIS. These are a feature out of the 2D days of
Autocad and are just flat quadrilateral faces which appear solidly
filled when viewed from top. They form quadrilateral prisms if
extruded, which can only be done in a right angle to their ground plane.
Entities created with the ACIS solid modeller or custom entity
types defined by any other 3rd party
application ("proxies", previously "zombies") are
ignored in the freely distributed version of Radout.
Bugs
For multiple inserts, only one item is exported.
On SGI systems, if the last (closing) segment of a polyline is an arc,
it end up in a very strange position. This happens most often with
donuts.
Authors
Philip Thompson (original author)
Georg Mischler (current copyright owner)
See Also
ADS and ARX Programmers Reference Manuals, Autocad Reference Manual
and Customization Guide for Autocad, AutoDesk Inc.
Tutorial and manual pages of RADIANCE 3.1, Synthetic Imaging System.
Gregory Ward Larson, Lawrence Berkeley Laboratory, Berkeley, CA.
Legalese
Copyright © 1994 Philip Thompson, Boston, USA.
Copyright © 1998-2000 Georg Mischler, Munich, Germany.
Permission to use, copy, and distribute this software for
any purpose and without fee is hereby granted, provided that
the above copyright notice appears in all copies, that both
that copyright notice and this permission notice appear in
all supporting documentation and that no part of this software
and its documentation is sold for profit or is included in
any package sold for profit.
Sale of this software and its documentation or any part of it
for profit or inclusion of any part of this software or its
documentation in a package sold for profit requires the prior
written consent of the copyright holder.
THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY EXPRESS OR IMPLIED
WARRANTY. ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR
PURPOSE AND OF MERCHANTABILITY ARE HEREBY DISCLAIMED.
|