+ All Categories
Home > Documents > AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk...

AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk...

Date post: 03-Apr-2018
Category:
Upload: lekien
View: 251 times
Download: 5 times
Share this document with a friend
58
Autodesk AliasStudio 2009 Command Line Utilities in AliasStudio March 2008
Transcript
Page 1: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Autodesk AliasStudio 2009

Command Line Utilities inAliasStudio

March 2008

Page 2: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

© 2008 Autodesk, Inc. All Rights Reserved. Except as otherwise permitted by Autodesk, Inc., this publication, or parts thereof, may not bereproduced in any form, by any method, for any purpose. Certain materials included in this publication are reprinted with the permission of the copyright holder. TrademarksThe following are registered trademarks or trademarks of Autodesk, Inc., in the USA and other countries: 3DEC (design/logo), 3December,3December.com, 3ds Max, ActiveShapes, Actrix, ADI, Alias, Alias (swirl design/logo), AliasStudio, Alias|Wavefront (design/logo), ATC, AUGI,AutoCAD, AutoCAD Learning Assistance, AutoCAD LT, AutoCAD Simulator, AutoCAD SQL Extension, AutoCAD SQL Interface, Autodesk, AutodeskEnvision, Autodesk Insight, Autodesk Intent, Autodesk Inventor, Autodesk Map, Autodesk MapGuide, Autodesk Streamline, AutoLISP, AutoSnap,AutoSketch, AutoTrack, Backdraft, Built with ObjectARX (logo), Burn, Buzzsaw, CAiCE, Can You Imagine, Character Studio, Cinestream, Civil3D, Cleaner, Cleaner Central, ClearScale, Colour Warper, Combustion, Communication Specification, Constructware, Content Explorer,Create>what's>Next> (design/logo), Dancing Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignKids, DesignProf, DesignServer,DesignStudio, Design|Studio (design/logo), Design Your World, Design Your World (design/logo), DWF, DWG, DWG (logo), DWG TrueConvert,DWG TrueView, DXF, EditDV, Education by Design, Exposure, Extending the Design Team, FBX, Filmbox, FMDesktop, Freewheel, GDX Driver,Gmax, Heads-up Design, Heidi, HOOPS, HumanIK, i-drop, iMOUT, Incinerator, IntroDV, Inventor, Inventor LT, Kaydara, Kaydara (design/logo),LocationLogic, Lustre, Maya, Mechanical Desktop, MotionBuilder, Mudbox, NavisWorks, ObjectARX, ObjectDBX, Open Reality, Opticore,Opticore Opus, PolarSnap, PortfolioWall, Powered with Autodesk Technology, Productstream, ProjectPoint, ProMaterials, Reactor, RealDWG,Real-time Roto, Recognize, Render Queue, Reveal, Revit, Showcase, ShowMotion, SketchBook, SteeringWheels, StudioTools, Topobase, Toxik,ViewCube, Visual, Visual Bridge, Visual Construction, Visual Drainage, Visual Hydro, Visual Landscape, Visual Roads, Visual Survey, Visual Syllabus,Visual Toolbox, Visual Tugboat, Visual LISP, Voice Reality, Volo, Wiretap, and WiretapCentral The following are registered trademarks or trademarks of Autodesk Canada Co. in the USA and/or Canada and other countries: Backburner,Discreet, Fire, Flame, Flint, Frost, Inferno, Multi-Master Editing, River, Smoke, Sparks, Stone, and Wire All other brand names, product names or trademarks belong to their respective holders. DisclaimerTHIS PUBLICATION AND THE INFORMATION CONTAINED HEREIN IS MADE AVAILABLE BY AUTODESK, INC. "AS IS." AUTODESK, INC. DISCLAIMSALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY ORFITNESS FOR A PARTICULAR PURPOSE REGARDING THESE MATERIALS. Published by:Autodesk, Inc.111 Mclnnis ParkwaySan Rafael, CA 94903, USA

Page 3: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Contents

Command line utilities . . . . . . . . . . . . . . . . . . . . . . . 1Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Background utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 1 Command reference . . . . . . . . . . . . . . . . . . . . . . . . 7AliasBatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7AlToCa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8AlToC5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9AlToDWG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10AlToGR3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10AlToIv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11AlToObj . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14AlToSt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15AlToUG, AlToUG19, AlToUG20, AlToUG21, ALToUG22 . . . . . . . . . 18BakeOrientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20bsd l . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20CaToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21C5ToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21DWGToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23FieldAssembler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23from100to97 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24GrToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26hp_glplotf, hp_gl2plotf . . . . . . . . . . . . . . . . . . . . . . . . . . 27

iii

Page 4: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

IGESToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29imgcvt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30IvToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34lmgrd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34lmutil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36ObjToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37PRenderToAlias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37print_wire_header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38psplotf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40renderer/raytracer/powercaster/powertracer . . . . . . . . . . . . . . . 41StToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47SwToAl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48UGToAl, UGToAl19, UGToAl20, UGToAl21, UGToAl22 . . . . . . . . . 48

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

iv | Contents

Page 5: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Command line utilities

Describes various command line programs included with AliasStudio.

PlatformsLists which platforms each utiltity is available on.

The functions are available in the following operating environments.

PurposePlatformsFunction

Batch File Translator doesunattended translation of

WindowsAliasBatch on page 7

data files. This replacesAlias-B.

Translates Alias wire files toDWG file format.

WindowsAlToDWG on page 10

Translates Alias wire files toCAI file format.

WindowsAlToCa on page 8

Translates Alias wire files toCATIA V5 file format.

WindowsAlToC5 on page 9

Translates Alias wire filesinto Granite 3 format.

WindowsAlToGR3 on page 10

1

Page 6: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

PurposePlatformsFunction

Translates Alias wire files toInventor file format.

WindowsAlToIv on page 11

Translate Alias wire files toOBJ file format.

WindowsAlToObj on page 14

Translates Alias wire files toISO10303 (STEP) format.

Windows,AlToSt on page 15

Translates Alias wire files toUnigraphics 19, 20 or 21format.

WindowsAlToUG, AlToUG19,AlToUG20, AlToUG21,ALToUG22 on page 18

Bakes Alias wire file normalsorientation.

WindowsBakeOrientation on page20

Converts a binary SDL fileinto ASCII text

Windowsbsdl on page 20

Translates CAI files to Aliaswire files.

WindowsCaToAl on page 21

Translates CATIA V5 files toAlias wire files.

WindowsC5ToAl on page 21

Translates DWG or DXFfiles to Alias wire format.

WindowsDWGToAl on page 23

Interlaces scan-lines of im-ages rendered on fields into

WindowsFieldAssembler on page 23

a single image; also pastestogether incompletelyrendered images. See theonline documenation thatcomes with FieldAssembler.

Windowsfrom100to97 on page 24

2 | Part 1 Command line utilities

Page 7: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

PurposePlatformsFunction

PTC file to Alias Wire filetranslator (using DirectCon-nect).

WindowsGrToAl

Translates Alias plot files in-to HP-GL (IBM-GL) and HP-GL2 formats.

Windowshp_glplotf, hp_gl2plotf onpage 27

IGES file to Alias Wire filetranslator (using DirectCon-nect).

WindowsIGESToAl on page 29

Converts between a widevariety of image fileformats.

Windowsimgcvt on page 30

Translates Inventor files toAlias wire files.

WindowsIvToAl on page 34

Looks for the license file,which contains the inform-

Windowslmgrd on page 34

ation about vendors andfeatures.

Is a licence managementprogram from GlobetrotterSoftware.

Windows,lmutil on page 36

Converts OBJ files to Aliaswire file format.

WindowsObjToAl on page 37

Is a command line parallelrenderer for AliasStudio

Windowspowercaster

SDL files. See the sectionrenderer/raytracer/power-caster/powertracer on page41.

Platforms | 3

Page 8: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

PurposePlatformsFunction

Is a command line parallelraytracer for AliasStudio

Windowspowertracer

SDL files. See the sectionrenderer/raytracer/power-caster/powertracer on page41.

Converts Pro/Engineerrender (.slp) files to Aliaswire file format.

WindowsPRenderToAlias

Views the headers of wirefiles.

Windowsprint_wire_header on page38

Translates Alias plot files in-to PostScript.

Windowspsplotf on page 40

Is a command line raytracerfor AliasStudio SDL files.

Windowsraytracer

See the section render-er/raytracer/power-caster/powertracer on page41.

Is a command line rendererfor AliasStudio SDL files.

Windowsrenderer

See the section render-er/raytracer/power-caster/powertracer on page41.

Converts ISO10303 (SAT)files to Alias wire files.

WindowsSATToAl

Converts STEP format filesto Alias wire format.

WindowsStToAl on page 47

4 | Part 1 Command line utilities

Page 9: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

PurposePlatformsFunction

Converts Unigraphics 19,20, or 21 files to Alias wirefile format.

WindowsUGToAl, UGToAl19, UG-ToAl20, UGToAl21, UG-ToAl22 on page 48

Background utilitiesThe following utilities are called by other programs, are used in the background,or are documented elsewhere.

PurposePlatformsFunction

Is the executable for theStudio interactive package

WindowsAlias.exe

a background utility to dis-play error messages

WindowsAliasWarn

Enables the user to selectwhich Studio product to

WindowsappLaunch

run. It is launched on start-up.

component of the LicenceManager

Windowslmutil

component of the LicenceManager. See the descrip-tion of lmutil on page 36

Windowslmgrd

component of the LicenceManager

Windowslmtools

component of the LicenceManager

Windowssgiawd

Background utilities | 5

Page 10: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

PurposePlatformsFunction

works with imgcvt duringconversion of image files

Windowstoimg

Using command line utilities on Windows

1 Choose Programs > Accessories > Command Prompt from the Start menu.

2 Click the cursor in the window.

You can see what directory you are in by typing

dir

A list of the directory contents will be provided; at the top of the list isyour current location.

3 Navigate to the directory containing the files to be converted. If you haveinstalled AliasStudio in its default location, the path will be similar to

C:\Documents and Settings\[UserID]\My Documents\AliasStu

dio\user_data\[Project]

where [UserID] is replaced by your login userid (and no square brackets)and [Project] is replaced by the name you have assigned to the project:the default project is demo (again, no square brackets). So to navigate tothe directory, on a single line, type

cd C:\Documents and Settings\[UserID]\My Documents\AliasStu

dio\user_data\[Project]\wire

4 To use a stand-alone utility to convert a file named“headlight.[fileextension]” to an AliasStudio wirefile named“headlight.wire, choose the translator and type

[translator] headlight.[fileextension] [flags] headlight.wire

where [translator] is the name of the stand-alone utility being used,[fileextension] is the three-letter extension after the dot, and [flags] arethe stand-alone utility’s options.

6 | Part 1 Command line utilities

Page 11: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Command reference

AliasBatch

Description

The Alias Batch File Translator is a command-line invocation of AliasStudio thatallows unattended data file translation. You can use this interface to AliasStudioin a UNIX shell script to run multiple file translations unattended, perhaps inan overnight batch job. All file formats supported by AliasStudio retrieve/savefeatures are supported, with the exception of Filter.

The standalone utility Alias -B has been replaced by the application AliasBatch,which uses the OpenModel API. You will find that AliasBatch is more robust.For help, enter AliasBatch -h.

Note: Alias -B is no longer supported.

Command Line Options

AliasBatch [-h] [-w -sdl -r1 -r2] [-o...] -sRetFile...

Launches the Alias Batch Processor, readsin the RetFile, translates it according to

AliasBatch

settings in an options file, writes it out asSavFile, and exits.

Displays help information.-h

1

7

Page 12: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Loads the options file OptFile. (Its full pathis required.)

-o[OptFile]

Writes output to SavFile. This option iscompulsory.

-s[SavFile]

Overwrites the SavFile if it exists.-w

Sets the format to SDL; overrides the saveformat in the options file.

-sdl

Optimizes redundant pre-V5.0 trimmedsurfaces by converting them to surfaces.

-r1

Retrieves files at start up (wire, IGES, etc.).If more than one file is retrieved, the Sav-File is a merged stage or stage set.

RetFile

AlToCa

Platforms

Purpose

AlToCa translates Alias wire file to CAI format files. CAI is CATIA/AliasInteroperability format.

Description

The usage statement for AlToCa is as follows:

AlToCa [ options ] [-i<input Wire file]> -o<output CAI file>

outputs online help, then exits.-h

8 | Chapter 1 Command reference

Page 13: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

displays a log file on screen during execu-tion

-b

produces an extended log file-x

name of input wire file; if not specified,stdin (generally the keyboard) is used

-i

name of output CAI file; must be specified-o

AlToC5

AlToC5 - Convert Alias Wire files to CATIA Part (.CATPart) files.

Usage:

AlToC5 [<options>] -i <input Wire file> -o <output CATIA file>

where

ValueArgument

input Wire filename (.wire)-i

output CATIA filename (.CATPart)-o

logfile option:0=No logfile output (de-fault)1=Output a logfile (-l1)2=Outputan extended logfile (-l2)

-l

Processes symmetry information from Aliaslayers; the geometric objects are conver-ted.

-b

Convert layer to open body/geometricalset or hybrid body feature

-a

do not convert invisible geometric entities-v

AlToC5 | 9

Page 14: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

ValueArgument

display this help information, then exit-h

Surface (divide/split) options:

Do not divide closed/periodic surface inmultiple surfaces. By default, AlToC5 will

-c

split any closed/periodic surface andtrimmed surface in two pieces if this optionis not specified.

divide surface with multi-knots in multiplesurfaces

-d

By default, AlToC5 will split any closed/periodic surface and trimmed surfacein two pieces.

If -c option is specified, we don't split them.

AlToDWG

ValueOption

input Wire file-i

output DwG file-o

AlToDWG is an Autodesk DirectConnect utility.

AlToGR3

Converts Alias wire files to Granite 3 file format.

Arguments: -i <infile> -o [<outfile>]

10 | Chapter 1 Command reference

Page 15: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

If no output filename is provided,the input file's base name will be used asthe outfile.

ValueOption

Show help-h

Save PTC Neutral file instead of Granitefile.

-n

an Alias Wire file.-i <infile>

a Granite part file that will be appendedwith .g

-o <outfile>

AlToIv

Purpose

AlToIv translates Alias wire file to SGI OpenInventor format files.

Description:

AlToIv [ options ] [-i <infile> [-o <outfile>]]

outputs online help-h

switches the output to a more compactInventor binary format. The default is In-ventor ASCII format.

-binary

outputs the ASCII inventor-ascii

displays all messages.-verbose

operates with no feedback-quiet

AlToIv | 11

Page 16: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

outputs world space objects-notransforms

outputs a full hierachy with transforms ateach DAG node and each object spaceobject

-alltransforms

outputs required transforms at each DAGnode and at each object space object

-transforms

tesselates all NURBS surfaces to trianglesusing settings from the Render Stats win-dow

-tri

tesselates all NURBS surfaces to quad-rangles wherever possible, using settingsfrom thje Render Stats window

-quad

outputs NURBS surfaces-nurb

outputs cameras-cameras

does not output cameras-nocameras

converts AliasStudio instances to Inventorinstances

-instances

converts AliasStudio instances to copies-noinstances

creates inline texture date instead of refer-ences

-inline

creates referenced textures where possible(for file textures only)

-noinline

creates a single Inventor material or texturefor each AliasStudio material or texture,and an instance for each object

-inventory

12 | Chapter 1 Command reference

Page 17: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

creates an Inventor material or texture foreach object

-noinventory

outputs units with a specific name to indic-ate the type of the units. Name can

-units name

be:MICRONS MILLIMETERS CENTIMETERSMETERS KILOMETERS INCHES FEET MILES

don’t output units-nounits

scale the Inventor file by a specifiedamount

-scale scale

Non-file textures sample to this X resolu-tion

-xres resolution

Non-file textures sample to this Y resolution-yres resolution

does not convert AliasStudio instances toInventor instances

-noinstances

Where:

specifies an Alias wire file to use as input.If not specified, input comes from stdin.

-i <infile>

specifies an Inventor file to write outputto. If it is not specified, the output is writ-ten to stdout.

-o <outfile>

Limitations

■ The Inventor/VRML translator does not support annotation information.

■ If you have extended SoNodeKit classes in your Inventor files, AliasStudiocan only read these nodes if there is a Dynamically Shared Object (DSO),containing the extensions, in the path of LD_LIBRARY_PATH.

AlToIv | 13

Page 18: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

For more information, see The Inventor Mentor: Programming ObjectOriented 3D Graphics with Open Inventor: Release 2, Chapter 11, “FileFormat,” Page 17: Reading in Extender Nodes and Engines.The rest of this section lists the Inventor nodes that are partially supportedor not supported by the Inventor import and export translators (IvToAland AlToIv).

■ The analytical geometry nodes SoCube and SoCubeDetail are not supporteddirectly. However, an Inventor file containing these nodes can be importedif optimization is on.

■ These text and camera nodes are not supported: SoAsciiText, SoText2,

SoText3, SoTextDetail, SoLabel, SoFont, SoFontStyle, SoDrawStyle,

SoOrthographicCamera, SoTranslation and all their subclasses.

■ These animation nodes are not supported: SoSensor and SoEngine andtheir subclasses.

■ These nodes are implemented as SoGroup and do not fully support theconcept of level of detail: SoLOD and SoLevelOfDetail.

AlToObj

Purpose

Converts Alias wire files to OBJ files.

Description:

AlToObj [-h] -i <infile> [-o <outfile>] [-h]

displays help information, then exits.-h

name of input Alias wire file;. If this is notspecified, standard input (generally thekeyboard) is used.

infile

name of utput OBJ format file; this mustbe specified.

outfile

14 | Chapter 1 Command reference

Page 19: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

convert faces to curves; default is trimmedsurfaces

-c

do not create a group for each geometricobject

-g

<units> where1 is inches2 is millimeters3is feet4 is miles5 is meters6 is kilometers7

-u

is millimeters8 is microns9 is centimeters10is microinches

<scale> geometry scale factor-s

<tol> tolerance value for tesselation-t

AlToSt

Purpose

Converts Alias wire files to ISO10303 format, specifically these:

■ application protocols ISO10303-203, or Configuration Controlled Design,conformance classes 1 to 4, and

■ ISO10303-214, or Core Data for Automotive Mechanical Design Process,conformance classes 1 and 2.

The import and export of this data is supported via ISO10303-21 Physical Fileexchange. You might need a separate licence to run this utility.

Application protocol support

The geometric data formats in ISO10303-203 and ISO10303-214 are identical.This comprises the core of the implementation of the translator. The followingtable shows the mappings made.

AliasStudio EntityStep Entity

PointCartesian Point

AlToSt | 15

Page 20: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

AliasStudio EntityStep Entity

B-Spline CurveLine

B-Spline CurveCircle

B-Spline CurveEllipse

B-Spline CurveParabola

B-Spline CurveHyperbola

B-Spline CurvePolyLine

B-Spline Curve (Grouped)Composite Curve

B-Spline CurveTrimmed Curve

B-Spline CurveB-Spline Curve

B-Spline SurfacePlane

B-Spline SurfaceCylindrical Surface

B-Spline SurfaceConical Surface

B-Spline SurfaceSpherical Surface

B-Spline SurfaceToroidal Surface

B-Spline SurfaceSurface of Linear Extrusion

B-Spline SurfaceSurface of Revolution

B-Spline SurfaceB-Spline Surface

Trimmed SurfaceRectangular Trimmed Surface

16 | Chapter 1 Command reference

Page 21: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

AliasStudio EntityStep Entity

Trimmed SurfaceCurve Bounded Surface

B-Spline SurfaceOffset Surface

Shell (Closed)Manifold Solid Brep

Shell (Open/Closed)Shell Based Surface Model

STEP logfile

When retrieval finishes without errors, this message is displayed:

STEP files retrieved successfully.

If there were errors in the retrieval, you see:

Problem Reading Step File, refer to log file for details.

The STEP logfile contain an error message for each problem entity that isencountered. Each error contains the STEP entity ID and entity type.

Description

AlToSt [ <options> ] -i<infile> -o<outfile>

specifies which AP to output: either 203 or214. The default is AP214

-p

specifies which model representation tooutput. Value can be one of:1 = wire-

-m value

frames2 = surface models3 = manifoldsurface models (shells)5 = brep solids6 =hybrid models (the default)

specifies the type of trimming that is done.This option is valid for surface models only.

-t value

Value can be one of:1 = parameter spacetrimming (the default)2= world spacetrimming

AlToSt | 17

Page 22: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

AlToSt [ <options> ] -i<infile> -o<outfile>

specifies the type of geometry to output.This option is valid only for shells. Value

-g value

can be one of:1 = shells only (the default)2= all geometry

outputs presentation data. This option isvalid only for AP214 files.

-c

outputs layer data. This option is valid onlyfor AP214 files.

-l

Displays help on usage-h

Where:

specifies an AliasStudio wire file to use asinput.

<infile>

specifies the STEP file to write output to.<outfile>

AlToUG,AlToUG19,AlToUG20,AlToUG21,ALToUG22

AlToUG

Purpose

Convert AliasStudio wire files to Unigraphics files.

■ AlToUG detects the required output format.

■ AlToUG19, AlToUG20, AlToUG21, and AlToUG22 convert AliasStudiowire files to the respective Unigraphics format (NX1, NX2, NX3, or NX4).

18 | Chapter 1 Command reference

Page 23: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Description

AlToUG [options] <infile> <outfile>

The name of the input AliasStudio wire file.infile

The name of the output Unigraphics file.outfile

Options:

Input Wire file.-i

Output Unigraphics file.-o

Units to be output1 = millimeters2 =inches.

-u

Ignore surface continuity breaks (mul-tiknots). Default is to split.

-b

Convert categories. Default is not to con-vert.

-g

Support collaboration mode.-c

Unigraphics distance value to use in aUnigraphics part.

-d<tol>

Force to overwrite an existing outfile.-f

Echo logfile to console.-e

Create extended logfile.-l

AlToUG,AlToUG19,AlToUG20,AlToUG21,ALToUG22 | 19

Page 24: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

BakeOrientation

Bake Alias Wire file orientation. This utility zeroes transforms, swaps UV's anddeletes history as necessary.

ValueOption

input Alias Wire filename; if not specified,stdin is used.

-i

output Alias Wire filename; must be spe-cified.

-o

display this help information, then exit.-h

bsdl

Overview

This command-line utility extracts ASCII SDL from a binary SDL file, andinserts ASCII SDL back into a binary SDL file. It is useful when you need tohand-edit scene description language files.

Binary files must be used in AliasStudio 12 for rendering, so any file that isconverted to ASCII must be converted back to binary format before rendering.

Description

bsdl extract [-f] <text> <binary>

Extract ASCII SDL to <text> from a binary SDL file called <binary>. The file<text> will not be overwritten unless the option -f is specified.

bsdl replace <text> <binary>

Insert the ASCII SDL file <text> into the binary SDL file <binary>, replacingthe ASCII SDL data.

To see the help statement for the utility, type

bsdl -h

NOTE On Windows operating systems, this stand-alone utility is called bsdl.exe.

20 | Chapter 1 Command reference

Page 25: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

CaToAl

Purpose

Translates CAI files to Alias wire file format. CAI is CATIA/Alias Interoperabilityformat.

Description

The usage statement for CaToAl is as follows:

CaToAl [ options ] [-i<input Wire file>] -o<output CAI file>

displays help information, then exits-h

displays a log file on screen during execu-tion

-b

produces an extended log file-x

name of input CAI file; must be specified-i

output CAI filename; if not specified.stdout is used.

-o

C5ToAl

Alias provides a stand-alone utility, C5ToAl, to enable you to convert CATIAPart (.CATPart) and CATIA product (.CATProduct) document files to AliasWire files without running the AliasStudio application. You may find thisuseful for creating a batch script if you have many files that need to betranslated from the CATIA format.

Usage:

C5ToAl -i <CATIA V5 file> -o <Wire file> [<options>]

CaToAl | 21

Page 26: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

where

ValueArgument

input CATIA filename (either .CATPart or.CATProduct)

-i

output Wire filename (.wire)-o

logfile option:0=No logfile output (de-fault)1=Output a logfile (-l1)2=Output anextended logfile (-l2)

-l

import geometrical sets and hybrid bodiesas layers

-a

Want the infinite (unbounded) geometryimported. Default is false

-wantInf bool

Want the invisible (noshow) geometry im-ported. Default is false

-wantInv bool

Want solids and open sheet bodies as sur-faces. Default is false

-wantUnstitch bool

Using stand-alone utilities on Windows

1 Choose Programs > Accessories > Command Prompt from the Start menu.

2 Click the cursor in the window.

You can see what directory you are in by typing

dir

A list of the directory contents will be provided; at the top of the list isyour current location.

3 Navigate to the directory containing the files to be converted. If you haveinstalled AliasStudio in its default location, the path will be similar to

C:\aw\[UserID]\Alias\user_data\[Project]\wire

22 | Chapter 1 Command reference

Page 27: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

where [UserID] is replaced by your login userid (and no square brackets)and [Project] is replaced by the name you have assigned to the project:the default project is demo (again, no square brackets). So to navigate tothe directory, type

cd C:\aw\{UserID]\Alias\user_data\[Project]\wire

4 To use the stand-alone utility to convert a CATIA file named“headlight.CATPart” to an AliasStudio wirefile named “headlight.wire”without autostitching, and with a logfile created, type

C5ToAl -i headlight.CATPart -o headlight.wire

DWGToAl

DWG to Alias Wire file translator (using DirectConnect).

DescriptionArgument

input DWG/DXF file-i

output Wire file-o

FieldAssembler

Purpose

Interlaces scan-lines of images rendered on fields into a single interlaced image;also pastes together incompletely rendered images.

Description

The FieldAssembler utility interlaces field-rendered images. Field-renderedimages are created in a sequence for video playback. Television draws everyother line on the screen and then fills in the alternate lines. Each field isone-half of a frame (the even lines or the odd lines).

NTSC and PAL video systems both use interlaced fields.

■ NTSC video systems, used in North America, display 30 frames or 60 fieldsper second.

DWGToAl | 23

Page 28: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

■ PAL video systems, used in Europe, display 25 frames or 50 fields persecond.

Each field is stored in a separate file. For animations that will be played backon television, you can render images into fields. However, to view them on acomputer screen or to transfer them to certain other computer programs, youneed to reassemble, or interlace, them into full images. The result is half asmany files that each have twice as much data.

For information on FieldAssembler, from the FieldAssembler window selectHelp > Help.

NOTE If you will be using Composer to composite images rendered as fields, youmust either interlace the fields together before importing them into Composer,or render the images in Alias PIX or RLA format. You can only import fields intoComposer if they are in Alias PIX or RLA format. (In addition, RLA format fieldsmust be named name.1, name.2, name.3, name.4, and so on, not name.1o,name.1e, name.2o, name.2e, and so on.)

from100to97

Purpose

The standalone utility from100to97 lets you convert a wire file from AliasStudio10 or later to a AliasStudio 9.7 wire file.

Description

The following table outlines the details of this function:

fromto97 -s [saved_file] [retrieved_file]

saves the result-s

is the name of the new, V9.7 filesaved_file

is the name of the old, V10 fileretrieved_file

overwrite savFile if it exists-w

24 | Chapter 1 Command reference

Page 29: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

NOTE The from100to97 utility will convert fillets created with the new Fillet surfacetool and save only the surface information. It will not save construction history,so you will not be able to modify the fillet after conversion. See New Surface Fillettool section in the What’s New manual.

NOTE The from100to97 utility will convert round surfaces created with the Roundtool and save only the surface information. It will not save construction history,so you will not be able to modify the round after conversion.

Limitations

■ Object editor commands are discarded (because they were not availablein Version 9.7)

■ Offset commands are discarded (because they were not available in Version9.7)

■ Fillet surface commands are discarded. Because of the great number ofimprovements to fillets that were made in Version 10, these commandsaren't readable in previous versions.

■ Because sketching is only available on the Windows platforms, any sketchdata that is contained in an AliasStudio 10 file is only converted to Version9.7 if the from100to97 utility is run on a Windows platform. If run on anyother platform, this data is removed.

To use the from100to95 utility on windows

1 Choose Start Menu -> Programs -> Accessories and open the CommandPrompt window

NOTE In this example, we are assuming that AliasStudio is installed in thedefault location, and that the wire file directory is also in the default location.Let's say your wirefile is called "bunchaspheres.wire"

2 Type in the Command Prompt window:

cd C:\Program Files\Alias\StudioTools10.0\bin

and press Enter.

This puts you in the directory where from100to97.exe is located.

3 If your original wire file is called "bunchaspheres.wire", you need to choosea new file name for the 9.7 file. Let's call it "bunchaOLDspheres.wire"

from100to97 | 25

Page 30: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

You'll also need to use your full path to where the wire file is located; inthis case, let's assume it's

C:\aw\username\Alias\user_data\wire\

4 To convert the file to 9.7, type:

from100to97 -s C:\aw\username\Alias\user_data\wire\bunchaOLD

spheres.wire C:\aw\username\Alias\user_data\wire\bunchas

pheres.wire

To use the from100to95 utlitiy on UNIX

In this example, we are assuming that AliasStudio is installed in the defaultlocation, and that the wire file directory is also in the default location. Let'ssay your wirefile is called "bunchaspheres.wire"

1 Open a shell and type:

cd /usr/aw/alias10.0/bin

and press Enter.

This puts you in the directory where from100to97.exe is located.

2 If your original wire file is called "bunchaspheres.wire", you need to choosea new file name for the 9.7 file. Let's call it "bunchaOLDspheres.wire"

You'll also need to use your full path to where the wire file is located; inthis case, let's assume it's

/aw/username/Alias/user_data/wire/

3 To convert the file to 9.7, type:

from100to97 -s

C:\aw\username\Alias\user_data\wire\bunchaOLDspheres.wire

C:\aw\username\Alias\user_data\wire\bunchaspheres.wire

GrToAl

PTC file to Alias Wire file translator (using DirectConnect)

DescriptionArgument

input ProE/Granite file (.prt, osm.g)-i

26 | Chapter 1 Command reference

Page 31: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

DescriptionArgument

output Wire file-o

hp_glplotf, hp_gl2plotf

Purpose

hp_glplotf translates Alias plot files into HP-GL (IBM GL) format files that aresuitable for plotting on any supported plotter.

hp_gl2plotf creates similar output, but includes initialization commandsrequired for HP-GL2 plotters.

Overview

hp_glplotf and hp_gl2plotf are filters which take input from stdin or <in_file>and send output to stdout or <out_file>, which would normally be sent to lp.

Description

hp_glplotf [-a] [-c<x>[<y>]] [-h] [-i] [-m<model>] [-n] [-p<paper>] [-r<angle>][-s] [t # #] [<in_file> [<out_file>]]

specifies automatic feed is to be used.-a

specifies scale correction factors.-c<x>[<y>]

displays the on-line help.-h

displays version information.-i

specifies the plotter model type.-m<model>

separates HPGL plot commands on newlines.

-n

hp_glplotf, hp_gl2plotf | 27

Page 32: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

specifies the paper type.-p<paper>

specifies the force plot rotation angle.-r<angle>

sizes the plot produced automatically. Theplotter’s default size is used.

-s

specifies the text scaling where # and # arethe width and height.

-t # #

reads input from the file <in_file>. The de-fault is to read from stdin.

<in_file>

writes output to the file <out_file>. Thedefault is to write to stdout.

<out_file>

NOTE Any errors encountered by the HP-GL and IBM-GL device drivers are writtento a file /tmp/plot_err.<number> as well as /usr/adm/syslog. Look there forany clues as to why the plotter is not working. The <number> is determined bythe operating system.

Automatic page advance

Some plotters can be fitted with a spool feed or have an automatic pageadvance option. This also applies to printers like the IBM-4019 and IBM-4029,which can automatically advance the page. To tell the plotter driver that youare using the spool feed option the following option should be specified:

-fa

Correction factor

When large plots are plotted, some inaccuracies can creep in over largedistances. As an interim fix, it is possible to compensate for this error byspecifying x and y correction factors. The default x and y correction factor is1.0, which is no correction at all. The correction factors are used internally asmultipliers.

28 | Chapter 1 Command reference

Page 33: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Example

If you plotted something that should have come out 30" and it came out to30.125", the plot was 0.125" too large. Assuming that the same error occursin both the x and y directions, you would need a correction factor of 30/30.125= 0.9959. The following should compensate for the error:

-fc0.9959

NOTE Setting the correction values in the Plotting Interface window opened byFile > Plot, overrides the correction values in the LP queue options for plot outputsection of the Alias Preferences window.

IGESToAl

IGES file to Alias Wire file translator (using DirectConnect).

Description:

IgesToAl -i <IGES file> -o <Wire file> [<options>]

ValueArgument

input IGES (.igs, iges) file-i

output Wire (.wire) file-o

integer-u

integer. specifies the trim curves that thetranslator will use:0: use 3D model space

-useTrimmingCurves

curves1: use 2D parameter space curves2:use the preference flag in the IGES fileBydefault, 3D model space curves are used.

True or False-s (boolean)

specifies if base surfaces are to be shrunkto trim regions or not. By default, shrinksurfaces.

-shrinkSurfaces

IGESToAl | 29

Page 34: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

imgcvt

Purpose

The Imgcvt utility converts images or a sequence of images from one imageformat to another.

Description

In any shell window, enter imgcvt followed by the name of the image thatyou want to convert. The input and output image formats are usuallydetermined by the filename extension or image content. However, when theinput or output image has no extension, or cannot be identified, the -f and-t options can be used to indicate the desired formats. You can use thefollowing options.

imgcvt <options> input_image output_image

Example 1

imgcvt -f sgi -t tiff input_image output_image

This line converts the image named input_image that is in the Silicon Graphicsformat to the TIFF format and saves the image out to a different name,output_image.

Example 2

imgcvt -f tiff -t iff input_image output_image

This line converts a TIFF image to the IFF file format.

The following table lists the imgcvt options.

DescriptionCommand line options

Identifies the specific image format thatyou are converting from. For example,-f

-f input_image_extension

sgi means that only files matching the Sil-icon Graphics image format are acceptedas input.

Identifies the specific image format thatyou are converting to. For example -t

-t output_image_extension

30 | Chapter 1 Command reference

Page 35: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

DescriptionCommand line options

tiffmeans that files will be converted to theTIFF image format only. For the list ofpossible extensions, see the section on Us-ing image filename extensions on page 32.

Is the start, end and step of an input imagesequence (only whole numbers are accep-ted).

-n start end step

Is the start, end and step of an output im-age sequence (only whole numbers areaccepted).

-N start end step

In an input image sequence, selects therange of images to be converted from. For

-r range

example:imgcvt -r 1-5 ...imgcvt -r 1-5x2...imgcvt -r 1-5,10-20x2,50 ...A sequencespecifier is a list of single frames or rangesseparated by a comma or a slash. In thisexample, they are individual, numberedfiles. For each range, an optional step canbe specified after an x.Sequences can bereversed and offsets can be added to theinput or output frame number:imgcvt -r100-1 -R 1-100 in.#.rgb out.#.rlaimgcvt -r1-100 in.#.rgb out.#+100.rla

In an output image sequence, selects therange of images to be converted to.

-R range

Provides a brief description of each option.-h

Silent mode.-s

Verbose mode.-v

Video mode for yuv files.-V pal/ntsc

imgcvt | 31

Page 36: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

DescriptionCommand line options

TIFF compression types: LZW (the default)or NONE.

-C compress

JPEG quality (0...100; default is 75).-q N

Explore map format.-m

When you are working on a sequence of images, the # and @ symbols referto the current frame number:

■ The hash (#) indicates a four-digit padded number,

■ whereas the @ symbol indicates a non-padded number.

The following converts a sequence of 100 frames:

imgcvt -n 1 100 1 image_in.iff.@ image_out.#.rla

For more precise control of the frame number format, use either multiple @symbols to set a specific padding or the standard printf(3S) notation:

imgcvt -n 1 100 1 image_in.@@@.rgb image_out.#.rla imgcvt -n 1 100

1 image_in.%03d.rgb image_out.#.rla imgcvt -n 1 100 1 im

age_in.%.2f.rgb image_out.#.rla

Using image filename extensions

Use the following filename extensions to convert images from one imageformat to another.

■ In the -f option, you specify the extension of the image format that youare converting from.

■ In the -t option, you specify the extension of the image format that youare converting to.

ExtensionImage Format

.yuvAbekas NTSC or PAL

.alsAlias

32 | Chapter 1 Command reference

Page 37: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

ExtensionImage Format

Explore

.gifGIF

.jpgJPEG

.cinKodak Cineon

.lffLucas Film

.iffMaya IFF

.pxbPixibox PXB

PXN

.ppmPPM raw/ascii

.priPrisms

.qtlQuantel

.rgb, .sgi or .bwSGI

.picSoftimage

.tgaTarga RGB/BW

.tif or .tiffTIFF 6.0

.vstVista

.rlaWavefront RLA

imgcvt | 33

Page 38: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

ExtensionImage Format

.bmpWindows bitmap

IvToAl

Purpose

IvToAl translates SGI OpenInventor files into Alias wire files.

Description

IvToAl [<options>] [-i <infile> [-o <outfile>]]

Do not optimize the Inventor file-o

Use an input scale factor of scale (for ex-ample, 2.0)

-s scale

Do not group the geometry-g

specifies an Inventor file to use as input. Ifinfile is not specified, input comes fromstdin.

<infile>

specifies the Alias wire file to write outputto. If outfile is not specified, output iswritten to stdout.

<outfile>

For information on this utility’s limitations, see AlToIv.

lmgrd

When you invoke lmgrd, it looks for the license file which contains theinformation about vendors and features. Usage is:

34 | Chapter 1 Command reference

Page 39: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

lmgrd [ -app ] [ -c license_file ] [ -t timeout_interval ] [ -l

logfile ] [ -s timestamp_interval ] [ -2 -p ] [ -v ] [ -x lmdown

] [ -x lmremove ]

PurposeOption

Required for Windows when run as acommand, but not used when run as aservice.

-app

Use the license file specified by license_file.-c license_file

Sets a timeout interval, in seconds, duringwhich redundant daemons must complete

-t timeout_interval

their connections to each other. The de-fault value is 10 seconds. A larger valuemay be desirable if the daemons are runon busy systems or a very heavily loadednetwork.

Write the debug log to the specified logfile.-l logfile

Specifies the logfile timestamp interval, inminutes. The default is 360 minutes.

-s timestamp_interval

Restricts usage of lmdown, lmreread, andlmremove to a FLEXlm administrator who

-2 -p

is by default the root account. If there is aUnix group called ‘lmadmin’, then use isrestricted to members of that group. If rootis not a member of that group, then rootcan not use any of the above utilities. The‘-p’ option is available in FLEXlm v2.4 andlater.

Prints lmgrd’s version number and copy-right, and then exits.

-v

Disallows the lmdown command (no usercan run lmdown). If lmdown is disabled,

-x lmdown

you must stop lmgrd via ‘kill pid’ (Unix) or

lmgrd | 35

Page 40: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

PurposeOption

CTRL-ALT-DEL and stop the lmgrd andvendor daemon processes (Windows 95).On Unix, be sure that the kill commanddoes not have a -9 argument. The -x lm-down option is available in FLEXlm v4.0and later.

Disallows the lmremove command (no usercan run lmremove).The -x lmremove op-tion is available in FLEXlm v4.0 and later.

-x lmremove

lmutil

Purpose

lmutil is the first among FLEXlm license manager utilities. FLEXlm is thenetwork license manager used by Autodesk to control the use of their softwareproducts.

If you are a UNIX systems administrator or user, it is likely that one or moreof the products on your network is licensed by FLEXlm. Details about installingwith FLEXlm are in your Installation Notes.

The AliasStudio installation program creates a FLEXlm directory, whichcontains a FLEXlm control panel and its required DLL, plus a number of relatedutilities

■ lmutil

■ lmtools

■ sgiawd (if you install the licensing component of the software)

■ lmgrd.exe (if you install the licensing component of the software)

While you do not call all the utilities directly, they are needed and must notbe deleted.

36 | Chapter 1 Command reference

Page 41: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

ObjToAl

Purpose

Converts OBJ files to Alias wire files.

Description

ObjToAl -i <infile> [-o <outfile>] [-h]

the name of the input OBJ file; this mustbe specified.

infile

the name of the output Alias wire file. Ifthis is not specified, standard output(generally the screen) is used.

outfile

displays help information, then exits.-h

PRenderToAlias

Pro/Engineer Render (.slp) file to Alias Wire file converter.

ValueOption

Input scale factor (e.g. -s2.0)-s scale

Input units[MI,FT,IN,MIL,UIN,KM,M,CM,MM,UM](de-fault = -uIN)

-u units

Group the geometry-g

Recalculate vertex normals-r

Do not merge vertices-n

ObjToAl | 37

Page 42: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

ValueOption

Merge vertices according to xyz positiononly

-p

Specify merge vertices position tolerancevalue in input units (default = 0.0001)

-t pos_tol

Specify merge vertices normal tolerancevalue in degrees (default = 1 degree).

-a nrm_tol

Name of Pro/Engineer Render file. If <in-file> is absent, input comes from stdin.

<infile>

Name of Alias wire file to be created. If<outfile> is absent, output goes to stdout.

<outfile>

By default, all vertices are merged according to their positions and normals.

print_wire_header

Purpose

print_wire_header prints the header and can be used to verify the named wirefiles.

Description

print_wire_header [-v] file [file...]

sets the verify mode. If -v is included, theentire wire file is read and if the trailer re-

-v

cord is not found, the file is reported asinvalid. This option indicates that a wirefile is not truncated. It is useful for verifyingthe success of a file transfer operation, suchas a copy to or from tape or across NFS.

38 | Chapter 1 Command reference

Page 43: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

print_wire_header [-v] file [file...]

is a list of files to be processed. There mustbe at least one file listed. Wildcard listingof files is supported.

file [file...]

Example

The following is an example of output produced using the commandprint_wire_header -v * in a directory.

SkiBootFilename:

Alias StudioAlias Product Name:

Alias Product Version:

2001/07/18 13:08Alias Software Date

V-12Alias File Version:

Thu Jul 29 17:09:25 2001File Creation Date:

WIREFile Type:

Z UpCoordinate System

830 x 840Graphics Display Size:

SkiBoot_strap.iges is not an

Alias Wire File.

Warning: Wire file truncated.als

is corrupted. Trailer record is

missing!

print_wire_header | 39

Page 44: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

psplotf

Purpose

Translates Alias plot files into PostScript for printing on any PostScript printer.

The plotter driver program psplotf is a filter that takes input from stdin or<in_file> and sends output to stdout or <out_file> instead of lp.

Description

psplotf [-f fontname] [-h] [-i] [-r #] [-s#,#,#,#] [-t #] [-u] [-w #] [<in_file>[<out_file>]]

specifies the font name to use.-f fontname

displays the on-line help.-h

displays the version information.-i

specifies the rotation angle.-r #

specifies the paper size. The # values rep-resent x min, x max, y min, y max.

-s #, #, #, #

specifies the font size.-t #

specifies that the program generated initial-ization string is not to be used.

-u

specifies the line width.-w #

reads input from the file <in_file>. The de-fault is to read from stdin.

<in_file>

writes output to the file <out_file>. Thedefault is to write to stdout.

<out_file>

40 | Chapter 1 Command reference

Page 45: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

You can add more initialization commands to the file by defining theenvironment variables ALIAS_PSPLOT_INIT and ALIAS_PSPLOT_INIT2.

renderer/raytracer/powercaster/powertracer

Purpose

The renderer creates raycast or raytraced image files from AliasStudio SceneDescription Language files while in a command line. The AliasStudio renderprograms create image files as follows:

■ renderer: raycasts images

■ powercaster: multi-threaded version of the renderer images (purchaseable)

■ raytracer: raytraces images

■ powertracer: multi-threaded version of the raytracer images (purchaseable)

AliasStudio Renderer for Windows is a command-line tool for rendering Aliasfiles. The rendered files produce a sequence of images that can be played backas an animation.

The functions powercaster and powertracer might not be present if they havenot been purchased for your system.

Description

All four render programs use the same arguments. The usage statement forrenderer, raytracer, powercaster, or powertracer is described below.

<command> [-a#] [-b#] [-B#] [-c <quant-ized_output_file>] [-C <color_map_file-name>] [-d <filename>] [-e#] [-E#] [-f<script>] [-h#] [-H] [-J] [-k] [-K#] [-m <file-name>] [-p <filename>] [-P] [-q#] [-Q#] [-r#] [-R#] [-s#] [-S#] [-t#] [-T#] [-w#] [-W#][-x#] [-y#] [-Y#] [<sdl_filename>]

is renderer or raytracer or powercaster orpowertracer

<command>

renderer/raytracer/powercaster/powertracer | 41

Page 46: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

sets the anti-aliasing level (aalevel) to theinteger #. aalevel is the maximum anti-ali-asing level per pixel.

-a#

sets the by frame number for animationsequences to the floating point number #.

-b#

sets the by extension for animation se-quences to the integer #.

-B#

outputs the quantized image to the file<quantized_output_file> after each frame.

-c <quantized_output_file>

uses the SGI image format file <col-or_map_filename> as the color map torefer to for quantizing after each frame.*

-C color_map_filename

uses <filename> as the depth filename.-d <filename>

sets the ending frame number for anima-tion sequences to the floating point num-ber #.

-e#

sets the size extension for animation se-quences to the integer # where # indicates

-E#

the number of 0 padding before the exten-sion number. For example, -E 4 producesfile extensions such as <file>.0001 indicat-ing frame 1.

invokes the program <script> after eachframe.

-f <script>

sets the image height for the partial imageto be rendered to the integer # without

-h#

changing the view port. However, this sub-region to be rendered always originatesfrom the lower left hand corner of the im-

42 | Chapter 1 Command reference

Page 47: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

age. The integer # moves the origin of thiswindow around the view port.

displays the on-line help.-H

creates a depth file called ‘timing’ repres-enting time per pixel.

-J

keeps depth maps in memory after readingthem once.**

-k

turns depth maps on disk usage to #. 0 isOFF. Any number other than zero is ON.***

-K#

produces a matte file and uses <filename>as the filename.

-m <filename>

sets, to the integer #, the number of pro-cessors to render on. This option is only

-n#

available with powertracer and power-caster.

uses <filename> as the pix filename.-p <filename>

preserves the non-glowed image unlessDOF or Quantize are on. This option allows

-P

you to save both a glowed and non-glowed image on disk. The non-glowedimage will have the same name as theglowed image, but will have the suffix .ng.

sets the quiet flag to #. # can be 0, 1, or2.

-q#

sets the resolution in the X direction andthe view port to the integer #. This option

-Q#

is useful for overriding the resolution spe-cified in a given SDL file. For example, it is

renderer/raytracer/powercaster/powertracer | 43

Page 48: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

useful for switching between renderingNTSC and 1/4 NTSC for a quick previewrender.

sets the aspect ratio to the floating pointnumber #.

-r#

sets the resolution in the Y direction andthe view port to the integer #. This option

-R#

is useful for overriding the resolution spe-cified in a given SDL file. For example, it isuseful for switching between renderingNTSC and 1/4 NTSC for a quick previewrender.

sets the starting frame number for anima-tion sequences to the floating point num-ber #.

-s#

sets the start extension for animation se-quences to the integer #.

-S#

sets the aathreshold to the integer #.aathreshold is the anti-aliasing threshold

-t#

value that adaptively super-samples pixelsbased on color difference. The higher thevalue, the more sensitive the super-sampling is to color difference.

sets the number of Y pixels in a tile to theinteger #. A tile is a row of pixels to be

-T#

rendered together. The main reason to usethis option is to reduce the amount ofmemory used by lowering the Y value. Thiscontrols the tile size the image is brokenup into for rendering and has no effect onthe final image or its resolution.

render normally outside of viewport region-v

44 | Chapter 1 Command reference

Page 49: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

render image with hidden lines-V

sets the image width for the partial imageto be rendered to the integer # without

-w#

changing the view port. However, this sub-region to be rendered always originatesfrom the lower left hand corner of the im-age. The integer # moves the origin of thiswindow around the view port.

sets the ylow for backgrounds to #. Theylow and yhigh define the region of the

-W#

rendering, specified in pixels, where thebackground should appear.

sets the xleft to the integer #. xleft is theleft corner of the partial image to berendered.

-x#

sets the ylow to the integer #. ylow is theleft corner of the partial image to berendered.

-y#

sets the yhigh for backgrounds to #. Theylow and yhigh define the region of the

-Y#

rendering, specified in pixels, where thebackground should appear.

sets the SDL filename to a specific filename.If no filename is specified, standard inputis used.

sdl_filename

* If required, the renderer quantizes images after rendering them. The option-C allows a previously generated color table to be used for quantizing images.However, aquant quantizes images much more quickly.

** Generally, when a depth_input file is specified for a shadowing spotlight,it is read every frame. -k forces the renderer to read the shadow map only onceduring the first frame of rendering.

renderer/raytracer/powercaster/powertracer | 45

Page 50: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

*** Rather than editing your SDL files to add depth_input or depth_outputcommands to shadowing spotlights, this command line option may be used.When set to a non-zero value (for example -K 1), the renderer automaticallycreates depth output files named after the spotlights in your current directory,or if these files already exist, they are used.

Using any of the above options overrides any equivalent SDL keyword settingsin the SDL file.

Examples

The following are examples showing the uses of the rendering utilities.

This command:

renderer testframe.sdl

renders an SDL file called testframe.sdl. All parameters and keywords set withinthe SDL file will be used. If any of the keywords is missing and requires a value,the default value for that parameter is used.

This command:

renderer -a0 -s1 -b2 -e20 -p testpix -q0 -h512 -w512 -x0 -y0

scene.sdl

renders an SDL file called scene.sdl. The scene to be rendered is an animation.

Anti-aliasing is turned OFF by setting the aalevelmax to 0. The animationspecified in the SDL file is overridden by the specification of -s1 -b2 -e20,which renders with a frame step of 2 the first twenty frames of animation.Normal messages are output, and the test image size is 512x512 pixels square.The animation sequence is output to a series of files starting with the nametestpix.

This command:

renderer -s 1.5 -e 3.5 -b .25 -S 1 -B 2 -E 3 sdl/foo

produces the following:

foo.001 (a snap shot of the animation at time 1.5) foo.003 (a snap

shot of the animation at time 1.75) foo.005 (a snap shot of the

animation at time 2.0) ... foo.019 (a snap shot of the animation

at time 3.25) foo.021 (a snap shot of the animation at time 3.5)

Assuming a 512x512 image, the following command:

renderer -h 255 -w 255 -x 255 -y 255 sdl/foo

46 | Chapter 1 Command reference

Page 51: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

produces an image of the top right 255 x 255 pixel region of the originalimage.

Important notes

Saved geometry is not compatible with motion blur.

You cannot stop and start a render process that uses saved geometry and retainthe saved geometry.

Saved geometry uses a significant amount of memory. You should have atleast 100 megabytes of swap space available before attempting to use it.

Alias backgrounds interpolate between the top and bottom of the currentrendering pixel span in Y. If you are rendering only a sub-region, this mightnot be what you intend, because the background is repeated many times inY. Therefore, use the options -W and -Y to specify a final resolution fromwhich AliasStudio can calculate background positioning.

File formats

SDL files are binary, and are compatible across platforms. To edit an SDL file,you must first convert it to text using the standalone utility bsdl. The TIFFfile format is an image display format that is also compatible across platforms.All other image formats are automatically read and saved in SGI image format.

You must uncompress any texture-map files before you render.

StToAl

Purpose

Converts ISO10303 files to Alias wire files, specifically:

■ application protocols ISO10303-203, or Configuration Controlled Design,conformance classes 1 to 4, and

■ ISO10303-214, or Core Data for Automotive Mechanical Design Process,conformance classes 1 and 2.

The import and export of this data is supported via ISO10303-21 Physical Fileexchange.

StToAl | 47

Page 52: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Description

StToAl [-s] <infile> <outfile>

specifies the STEP file to use as input. If notspecified, input comes from stdin.

<infile>

specifies an Alias wire file to write outputto. If not specified, output goes to stdout.

<outfile>

SwToAl

PTC SolidWorks file to Alias Wire file translator (using DirectConnect).

ValueOption

Solidworks part or assembly file-i input

output Wire file-o

UGToAl, UGToAl19, UGToAl20, UGToAl21,UGToAl22

UGToAl

■ UGToAl19, UGToAl20, UGToAl21, UGToAl22: Use directly for the Windowsplatform.

Purpose

Convert Unigraphics files to AliasStudio wire files.

48 | Chapter 1 Command reference

Page 53: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Description

UGToAl [options] <infile> <outfile>(ForWindows, substitute UGToAl with UG-ToAl19, UGToAl20, or UGToAl21.)

The name of the input Unigraphics file.infile

The name of the output AliasStudio wirefile.

outfile

Options:

Input Ungraphics file.-i

Output Unigraphics file.-o

Do not stitch model on input. Default is tostitch.

-s

Echo logfile to console.-e

Create extended logfile.-l

Convert categories. Default is not to con-vert.

-g

UGToAl, UGToAl19, UGToAl20, UGToAl21, UGToAl22 | 49

Page 54: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

50

Page 55: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Index

A

Abekas 32Alias batch file translator 7Alias plot files 40Alias to DWG format 10Alias to Granite3 file format 10AlToC5 9AlToCa 8AlToDWG 10AlToGR3 10AlToIv 11AlToSt 18AlToUG 18AlToUG utility 18ASCII SDL 20

B

bake normal orientation 20BakeOrientation 20binary SDL 20bsdl 20

C

C5ToAl 21CAI format 8, 21CATIA Part (.CATPart) format 9, 21CATIA product (.CATProduct) document

format 21CATIA/Alias Interoperability format 8CaToAl 21command line programs 1command line utilities 6

on Windows 6converting 30

image formats 30

D

DWG to Alias Wire format 23DWGToAl 23

E

Explore image format 33

F

FieldAssembler 23FLEXlm 36from100to97 utility 24

G

GIF files 33GrToAl 26

H

hp_gl2plotf 27hp_glplotf 27HP-GL2 plotters 27

I

image formats 30conversion 30

imgcvt 30interlaced images 23ISO10303 format 15, 47IvToAl 34

51 | Index

Page 56: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

J

JPEG files 33extension 33

K

Kodak Cineon 33

L

license file 34lmutil 36Lucas Film format 33

M

Maya IFF 33

N

normals 20baking 20

O

OBJ format 14, 37orientation 20

normals 20

P

Pixibox PXB 33PostScript 40powercaster 41powertracer 41PPM raw/ascii 33PRenderToAlias 37print_wire_header 38Prisms 33Pro/Engineer Render (.slp) file to Alias wire

file 37psplotf 41PTC Granite file to Alias Wire file 26

PTC SolidWorks file to Alias wire file 48PXN 33

Q

Quantel 33

R

raycaster 41raytracer 41renderer 41

S

setting normals 20stand-alone utility 20

SGI 33SGI Inventor format 11, 34Softimage 33StToAl 48StudioTools 9.7 wire file, converting 24SwToAl 48

T

Targa 33TIFF 33

U

UGToAl 48UGToAl utility 48Unigraphics format 18, 48using command line utilities 6

on Windows 6

V

Vista 33

W

Wavefront RLA 33

52 | Index

Page 57: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

Windows bitmap 34

Index | 53

Page 58: AutodeskAliasStudio2009 - Autodesk | 3D Design, …€¦ ·  · 2008-04-25Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor , Autodesk Map, Autodesk MapGuide, ... 2

54


Recommended