Olaf Corten's OCUS help page for create_retrieve_trailfile

Help and/or history for create_retrieve_trailfile

See also entry in DESCRIPTION file

Usage: create_retrieve_trailfile [options] [files]
 
	The create_retrieve_trailfile script creates a trail file which
	retrieves all models in a directory or all given files. If the file
	is preceded by a directory name Pro/E will first perform a CHANGE DIR.
	Instances can be given like this: "instance.prt"

	options:	-h 	=> this help screen 
			-f file	=> use file as input
			-c 	=> perform a misc change to current dir first
			-w dir  => Use this as your working dir (different from
				   current retrieve dir). After each retrieval
				   do a change dir. Option -c is also set.
			-m xxx	=> retrieve models, where xxx is:
					p	=> retrieve all parts 
					a	=> retrieve all assembly's
					d	=> retrieve all drawings
					dprt	=> retrieve all drawings of all
						   parts with the same name
					dasm 	=> retrieve all drawings of all
						   assemblies with the same name
					     Above two options can be used 
					     together with the [files] option,
					     you will have to select prt's and
					     asm's yourself,
					     e.g.: -m dprt 12345*.prt.*
					f	=> retrieve all formats
					s	=> retrieve all sections
					l	=> retrieve all layouts
					m	=> retrieve all manufacture
						   models. Determines if it is
						   a MANUFACTURE or MOLD type.
					create_rep => when retrieving an asm
						      create a dummy simp.rep
					rep NAME   => retrieve simp.rep. NAME
					viewonly   => when retrieving a drawing
						      retrieve it view only.
			-b	=> save all models
			-i xxx	=> info options, where xxx is:
					l	=> create layer info file
					m	=> model info
					f	=> feature list 
					p	=> mass properties (assumes no
						   density has to by typed in)
					pc	=> mass properties (check if 
						   material has been set for
						   parts. If so add to trail
						   file)
					a	=> audit trail
					b	=> BOM
					bu	=> Show Unplaced members in BOM
					bs	=> Show Skeletons in BOM
					r	=> show relations 
					reninf  => run a special command to
						   rename info files.
						   Use together with the 
						   -i l, the -i f and -i r
						   options.
			-s	=> shade the model
			-d	=> set orientation to default view
			-v xxx	=> set view to name xxx
			-e xxx	=> export file in format xxx.
				   You can specify multiple -e options.
				   Supported formats are:

					PLOTTER (Postscript; A-size)
					LASERJET (special; 
							Uses crt_ps.pcf file)
					LJET_A3 (special; 
							Uses crt_ps_a3.pcf file)
					DESIGNJET (special;
							Uses crt_hp.pcf file)
					IGES
					DXF	(Drawing)
					DWG	(Drawing)
					TIFF(snapshot) 
					Neutral
					STL 	(or STL-bin)
					SLA
					STL-ASC
						(overrules STL-BIN)
					Render
					Inventor
					Optegra_Vis
					PATRAN
					COSMOS
					SUPERTB
					SET
					VDA
					PDGS
					STEP
					CGM
					VRML
					WWW	(assemblies only)
				   Shade export options:
				     (Model will be shaded first)
					SHADE 
					JPEG
					TIFF 
					EPS
					TIFF(snapshot)

				   Unsupported formats will be treated as print
				   button names (or .pcf filenames with pre-R20
				   files).

			-u xxx	=> utility options. Where xxx is:
					s	=> runs pro_scrsave; Use this
						   together with -i l.
					c	=> clean up plot directory with

			-y	=> confirm to give the plot command (< R20).
			-r	=> force a regenerate for prt's and asm's.
			           by #info; #regen info; #beginning; #quit
			-g	=> force a regenerate for prt's and asm's.
				   (> R16) by redefining the first feature.
			-x	=> if model is an assembly explode it
			-x r	=> if model is an assembly un-explode it
			-q	=> Include exit command.
			-o file	=> write output to file
			-t	=> create seperate trail file for each model.
			-n	=> do not include files which can't be found
			-p xxx  => execute options, where xxx is:
					c	=> create config.pro
					g	=> run in no_graphics mode
					s	=> start proe
					f	=> forced start of proe
					l	=> use pdm-links option
					other	=> set proe startcommand
			-a xxx  => additional options, where xxx is:
					sheet all     => go to all sheets.
					sheet y	      => go to sheet y
						         you can add this option
						         multiple times, e.g.:
						         -a sheet 1 -a sheet 2
					sheet_ljet    => special export option:
							 print all sheets, if
							 size A4 do post_a4.pcf
							 or else do post_a3.pcf
					shade_res yyy => set shade export
							 resolution to yyy dpi.
					shade_size yy => set shade export size
							 to yy.
					shade_depth y => set shade export depth
							 to y, with y=
							 - depth8
							 - depth24
							 - depth_mono
							 - depth_gray
					no_format     => plot without format.
					alternate     => alternate system colors
					trail FILE    => insert trailfile FILE
							 after retrieval.
					quiet	      => Run quietly
					to_file_off   => Turn off printing to
							 file.
					to_printer_on => Turn on printing now.
					version yy    => Create Ryy version file.
							 Where yy can be:
							 17,18,19 or
							 20 or
							 21

	By default this script will retrieve all Pro/E models. 
	Only one export option can be given.
	The format names are case-insensitive.

	If you have a list of models in one file you can use that list with
	the command:
			% create_retrieve_trailfile -f filelist.txt
			
	If you get a 'word too long' error you probably give too many
	commandline files (especially if you use wildcards). You can prevent
	this by writing the commandline arguments to a file and read the file
	with the -f option.
	
	e.g.:		% ls -1 *.drw.* > filelist.txt
			% create_retrieve_trailfile -f filelist.txt

	EXAMPLES:
		crt -br
			retrieves all models and saves them (parts and
			assemblies are regenerated first)
		crt -qt -m dprt -e plotter -e dxf
			for each part drawing create a trail file which
			creates a plotfile and a dxf file and exit Pro/E.
		crt -i l -s -e snap -x -m a -t 
			for each assembly create a trail file which explodes it,
			shades it, creates a layer info file and make a snaphot.
			The layer info file needs to be created so that the
			snap shot utility can determine the current model name. 

	config.pro:	with the -p c option you will get the following
			Recommended config.pro settings:
			WINDOWS_SCALE			0.5
			DATUM_DISPLAY			NO
			DATUM_POINT_DISPLAY		NO
			DATUM_POINT_TAG_DISPLAY		NO
			AXIS_DISPLAY			NO
			DISPLAY_COORDINATE_SYS		NO
			DISPLAY				HIDDENVIS  
			SPIN_CENTER_DISPLAY		NO
			MODEL_TREE_START		NO
			START_APPMGR			NO
			USE_TEMP_DIR_FOR_INST		YES
			SAVE_OBJECTS			CHANGED_AND_SPECIFIED 
			OVERRIDE_STORE_BACK		YES
			PLOT_FILE_DIR			.


	KNOWN BUGS:
	o	model info of assembly drawings does not work:
			create the model info with the '-m a' option.
	o	-a sheet 1 will crash Pro/E with single sheet drawings

Author: Olaf Corten, olafc@molding.fico.nl or ocorten@knoware.nl


create_retrieve_trailfile interrupted...

################################################################################
# History:
#
# 20000919 And fixed the previous fix for non-existing commandline files.
# 20000918 Fixed wildcard selection: changed 'sort -t\. -n -r +0 -2 +2 -3' to 'sort -t\. +0 -2 +2nr -3'
# 20000306 Added -x r. Upgraded to R2000i (-a version option).
#	   Added -i bu and -i bs.
# 19991124 Added $PDMLINKS
# 19991020 Added -a quiet. Fixed -a sheet_ljet option.
# 19990526 Added -a sheet_ljet option.
# 19990504 Added -a trail FILE options. Instance names can also be given.
#	   Added -p other.
# 19990323 Fixed generic checking for compressed files. Added check for BULK ITEM parts.
# 19990219 Changed SCRIPTS_DIR extraction.
# 19990106 Export options are now not case-sensitive (unless you enter a pcf file).
# 19981009 Added -n to PROSTART command
# 19980928 Added -a alternate option. Fixed SHADE output option.
# 19980922 Added .lay there where .drw is needed.
# 19980904 Added -a no_format option.
# 19980901 Fixed few bugs concerning plotting. Added output name for multiple
#	   sheets. Plotter names now case sensitive.
# 19980810 Added -i reninf (and removed it from the -i r, -i f and -i l)
# 19980807 Exit now performed twice seperate by a blank line. The blank line
#	   is sometimes needed to enter through a Pro/E question, which might
#	   hold the exit process.
# 19980803 Added '-m create_rep' and '-m rep NAME' options. 'quit window' now
#	   added *before* retrieving each model.
# 19980707 Fixed trail file out of sequence with VRML files.
# 19980618 Fixed trail file out of sequence single sheet drawings.
# 19980612 Seperate trail files are now also seperately run.
#	   Added sheet options. Unsupported export options are now
#	   assumed to be pcf files. Added TIFF, Optegra_Vis and DWG options.
# 19980525 Changed -v from verbose to view names option.
# 19980203 Added optional start of proe. Added execute options (-p).
# 19970528 Fixed mass properties entries for assemblies.
# 19970429 Fixed LJET_A3 plot.
# 19970424 Added more verbose info. Display arguments are too long warning.
#	   Scanning commandline arguments now much faster. -m dprt and -m dasm
#	   can be used together with [files] option.
# 19970415 Added option "-i pc".
# 19970407 Added #DONE to #SHOW RELATIONS. Added q to #EXIT
# 19970313 Added .lay and .mfg models.
# 19970206 Added LJET_A3 export option.
# 19970224 Added -y option. Upgraded Laserjet and Postscript to R17. You can 
#	   now give multiple export options. Added Designjet option. Added
#	   -m dprt -m dasm options. Added -t option. Reorganized commandline
#	   options. Added -w option.
# 19960927 Added regenerate parts by redefining first feature (-g). Generics
#	   are now better recognized (by @instances instead of @gen_name).
# 19960612 Added SLA-asc option.
# 19960419 Output file no longer gets a third extension. (Release 16 can't
#	   handle them). Added -r option to force a regenerate of your part
#	   before saving. NO! changed to #GENERIC (R15 update).
#	   Trail version updated to R15. Added -c and -x options.
# 19960306 Added -n option. Will ignore third extension if given.
# 19960206 Added -o option.
# 19950116 Added -i option. Added check for preceding directory name.
# 19951215 Changed split to /bin/split
# 19951205 Added Laserjet export and save option
# 19950622 Added export option (-e).
# 19950518 Added -s option.
# 19950511 Added check for generic models.
# 19940922 Added options
# first version: 1994
#
################################################################################