www.schorsch.com

Free Downloads

 
 
 

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.

 

Home

Lighting Software
  Rayfront
  Raydirect
  3Dsolar
  3D Lighting Tools
  Support
  Buy it Now!

Gallery
  Student Works
  Built Projects

Knowledge
  Glossary
  Resources
  Daylighting
  Literature

Download
  Rayfront Demo
  3Dsolar Demo
  Radiance Tools
  Autocad Tools

Information
  Site Map
  Newsletter
  About Us
  Privacy

  Tell a Friend
  Feedback

 
 
http://www.schorsch.com/download/radout/manual.html
Copyright © 1998-2003 Georg Mischler. All rights reserved.