The purpose of this article is to document the parameters of the Microvellum Flatshot Tokens available as of build 15.6. Elsewhere in the Microvellum Knowledge Base, you will find articles and tutorials giving an overview of the token, how to access their location and explanations on how to use them to produce dynamic product images and face frame images.
There is also an AutoCAD FLATSHOT command available in Toolbox that creates a flattened view of a 3D model. This subject is covered in a separate article.
The token list is part of this article and attached as a downloadable file in PDF format.
“Metafile Instruction” column or “Face Frame Drawing Instructions” column text
The token name is always FLATSHOT for this type of token.
The group ID symbol is always the asterisk or star character.
The group number should be the same for all token components that are to be grouped into the same dynamic picture produced by the program.
The comments are a sort of help text to identify the token, more quickly understood than interpreting the parameters for that token. They are not required.
Each option must be separated by a semicolon.
Each value must be separated by a semicolon.
Since you can create multiple flatshot views for a single product, parameter 3 allows you to specify a distance in X and Y to offset this flatshot image. All associated tokens of the same group number will be offset as well. This simplifies the use of multiple tokens as now you don’t need to do tedious calculations for the offset of each token, such as dimensions, etc.
Use a bounding box to display only part of the flatshot image. Enter the start coordinate of the desired bounding box, and the end coordinates in the format x,y,z;x,y,z. The minimum bounding box will be a point that will create the lower left front point of the cube. The maximum bounding box will be the upper right rear point of the cube. Only parts that fall within the cube will be part of the flatshot image.
Four options separated by a semicolon in the format:
Option to process for CAD views only, for only processing, or both CAD and reports processing.
No value or a value of 0 will be for both CAD and reports processing. A value of 1 will be for CAD only, and a value of 2 will be for processing only.
Enter one of the following: a CAD layer name, a 3DPartLayer to use the 3D Draw Token Layer names, or leave the value blank, which will draw the CAD image on the zero layer.
Enter a list of keywords to include, separating each name with a comma. Alternatively, enter a list of negative keywords to exclude (-Partname). For example, in the list “Base Stile,Base Rail,Rail Mid,Stile Mid,-Side” all parts would be included except the Side because it contains the minus sign.
Not currently used.
The images produced by the Flatshot tokens are populated to the work order database FaceFrameImages table and are available for use in reports. The images are differentiated by two fields in that table. One is the “Name” field and the other is the “Type” field. The Name field contains the named view of the product or face frame unit. The Type field contains the type of view of the product or face frame unit. These two fields are commonly used in report filters to limit the type of picture that is displayed in the report.
Here is a list of the Type data and what it represents and is slightly different than the Flatshot View parameter data above.
Parts that are to be included in the dynamic product image produced for the report must have the drawing token DRAW3DBOX present in the row for that part, in the column “3D Draw Token.” Only parts having this 3D token will be included.
If you have extra parts in your dynamic product report images as displayed in red in the following screenshot, make sure those parts do not have the DRAW3DBOX in the column 3D Draw Token.
If the Flatshot Token is being applied to the product using the Metafile Instructions column of the product prompts as shown below, the Name field data corresponds to the Group Number and Comments fields described in the flatshot key at the beginning of this article. In this case, the Type field data will be any of the supported values, except eleven (11).
Spreadsheet, product prompts worksheet:
Work order database, FaceFrameImages table for dynamic product image records:
Records in the Face Frame Images table that contain a Type of eleven (11) define an image for a face frame unit, as shown below.
Spreadsheet, face frame subassembly prompts worksheet:
Work order database, FaceFrameImages table for face frame component image records:
In the Microvellum shipping data, as you can see in the database screenshot above, the face frame components are grouped with a 1 or a 10 for the front face frame unit – with a 1 indicating the front view of the front face frame, and 10 indicating the rear view of the front face frame.
The face frame parts are grouped with a 2 or a 20 for the left side face frame – with a 2 indicating the front view of the left face frame, and 20 indicating the rear view of the left face frame.
The face frame parts are grouped with a 3 or a 30 for the right side face frame – with a 3 indicating the front view of the right face frame, and 30 indicating the rear view of the right face frame.
The face frame parts are grouped with a 4 or a 40 for the backside face frame – with a 4 indicating the front view of the rear face frame, and a 40 indicating the rear view of the backside face frame.
See the graphic below and group the components into the same dynamic picture accordingly.
As you develop and test your flatshot data, you may want to verify the data during the development process instead of waiting until the end. Instead of verifying the individual flatshot images in a WMF viewer or a report, you may use AutoCAD to draw several views of a selected product quickly.
These views include a plan view, elevation view, section view, southwest isometric view, and an exploded view of the product. These are drawn within a title block frame in model space.
The command to draw these views is located at Draw > 2D Drawings > Draw Dynamic Product Image. Select the product to draw and then a location in your drawing to place the two drawings.
The table FaceFrameImages is linked to the Parts table through the linking table FaceFrameImagesParts. It is linked to the Subassemblies table through the linking table FaceFrameImagesSubassemblies. A discussion of the method of using these tables in reports is outside the scope of this article.
You must select the option “Process Flatshot Tokens” on the Processing Center interface to display the dynamic product images on reports and labels.
Product libraries with a version number of 045 or newer contain flatshot token data, with each successive version refining the token data.