You are on page 1of 17

VISUHOLE

DRILLING HOLES AND CARVING / EMBOSSING SHAPES
VERSION 1.0 – 19 SEP 14
BY FREDO6

DRILL THRU PUNCH THRU

CARVE EMBOSS

STAMP PUNCH

Fredo6 – VisuHole Page 1 / 17 v1.0 – 19 Sep 2014

.................................................................. Overview.................................. 9 1) General procedure ..............................................................................................................................................................................................................0 – 19 Sep 2014 ............................................................. 5 5..................... Stencils.......... 7 2) Navigating in the History of Stencils ........................................................................... 4 4......................................................................15 9............. 8 1) Dynamic Selection from a face at Top Level................ 11 5) Working on Curved Surfaces – FOLLOW SURFACE option .......................................................................................................................... 3 3..................................................................................................... Toolbar and Configuration ............ 13 8.............................................................................. 7 6............................ Other Options .................... 3 2.................................................................... 11 4) Carving and Embossing ................................................................................................................................................................ Stamping and Extruding...... 16 2) Smoothing Local Normals... Specifications ..................................... 9 2) Drilling ......................................................................................... Installation ..............................16 1) Grouping IN and OUT ................................................................ 7 1) Creating a Stencil ....... Menus............... Selection ...... 8 7................................................................................................ Tools for Drilling....................................................................... Material Assignment .................................................................................. 10 3) Stamping ......... 8 2) Dynamic Selection from a face in a Group or Component ...... 17 Fredo6 – VisuHole Page 2 / 17 v1............ 16 3) Ignoring Sharp curvatures ......................................................................................................................... Contents 1.........................................

Win8 and Mac OSX all versions  IMPORTANT: VisuHole requires the Shared Library LibFredo6 v6. Other languages may be provided by kind translators.  Language: English and French. Win7.Grouping. VISUHOLE Drilling. Make and Pro). . In the current version. The scope of the selection can be specified implicitly or by pre- selection. . including when embedded in groups or components. Stamping shapes on Surfaces VERSION 1. allowing to respect the shapes relative dimensions (versus Projection mode.  Platforms: Windows XP. Works better with v8 M2 and above. where they would be distorted) 2.Material assignment: you can choose or pick a material in the model for painting the extrusions. Specifications  Sketchup Versions: 6 and above (Free.Follow Surface for Carve and Emboss on curved surfaces.1 or higher. A few additional options are available: . you can create the hole with edges or with guide lines. with 2 modes: o GROUP IN for putting extrusions in groups in the selection context o GROUP OUT for putting all extrusions and tubes in a master group. Embossing.CARVE and EMBOSS with a specified offset and a few options to control the direction of extrusion. Overview VisuHole is a suite of interactive tools dedicated to holes and extrusions on planar and curved surfaces.DRILL THRU (with tubes) and PUNCH THRU (without Tubes). Fredo6 – VisuHole Page 3 / 17 v1.STAMP (no hole) and PUNCH (just the hole) and MARK (with Guide lines). tubes and stamped shapes .0 – 19 SEP 14 by Fredo6 1. VisuHole can drill through one or several surfaces.0 – 19 Sep 2014 . without altering the original selection . Carving. In addition. Vista. VisuHole supports the following tools: .

the icons. If you run SU8 and above. SketchUp 8. This subfolder contains the library files. SketchUp 2013 C:\program files\SketchUp\SketchUp 2013\Plugins\ On Windows.0 Macintosh HD/Library/Application Support/Google SketchUp 8/SketchUp/Plugins On Mac OSX. SketchUp 2013 ~/Library/Application Support/ SketchUp 2013/SketchUp/Plugins On Mac OSX. rename or move files there).rb • one subfolder Fredo6_VisuHole.rb Ruby file Fredo6_!LibFredo6 Folder Fredo6_!LibFredo6. SketchUp 2014 C:\program files\SketchUp\SketchUp 2013\Plugins\ On Mac OSX.0 C:\program files\google\google Sketchup 8\plugins\ On Windows. SketchUp 2014 ~/Library/Application Support/ SketchUp 2014/SketchUp/Plugins Fredo6 – VisuHole Page 4 / 17 v1. you have to Unzip into the SU Plugins directory from a . Name Type SU Plugins root directory Plugins Root Folder Fredo6_VisuHole Folder Fredo6_VisuHole. SketchUp 8.rb Ruby file The Sketchup Plugins root directory is: On Windows.zip file (see details below) All installations however will end up with the following footprint in the SketchUp Plugins directory: • one script file Fredo6_VisuHole. You can also download the RBZ file on this site for installation via the Extension Manager of Sketchup. language files (please do not alter. the recommended method is to auto-install VisuHole via the SCF Plugin Store available for free on Sketchucation (you will need to register but it is free). cursor files. For SU6 and SU7 users. Installation The original publishing of this script is on Sketchucation.3.0 – 19 Sep 2014 .

Toolbar and Configuration Main menu: By default in Tools > Fredo6 Collection > VisuHole.0 – 19 Sep 2014 .rbz to VisuHole. whether shown or not in the toolbar.php?f=323&t=39073#p345150). you must install the plugin from its Zip archive file.com/forums/viewtopic. Fredo6 – VisuHole Page 5 / 17 v1. You can obtain this Zip file via the following procedure: 1) Download the file VisuHole. There is only one icon in the current version. Note: you can select an alternative plugin directory (see AdditionalPluginFolders at http://sketchucation. For SU6 and SU7 users. do it in a neutral folder and check that you reconstruct the right footprint. Then transfer the folders and files to the SU Plugins Directory. All functions are available in this menu. If you are unsure of your unzip operation. Menus. 4.rbz file on Sketchucation Plugin Store page 2) Rename VisuHole. Contextual menu No contextual menu on selection Toolbar Toolbar name is Fredo6_VisuHole by default (you can change it to put the icon in an existing toolbar).zip 3) Open the Zip archive 4) Select All files 5) Press the Extract button and select the Sketchup Plugin folder as the destination 6) Answer YES to overwrite existing files if any CAUTION: NEVER rename or move files from their folders.

Error Handling In some circumstances. either because the geometry is too complex for computing intersections or simply because there are still bugs in the script. it can be useful for the author in order to trace the cause of error.0 – 19 Sep 2014 . exporting as txt file (or simply copy / paste) and posting on Sketchucation could be helpful. For instance. you may get an error message shown as the dialog box below: Although this is purely technical information related to the Ruby script. If this happens. Fredo6 – VisuHole Page 6 / 17 v1. Buttons Palette The buttons palette is organized in 7 zones. VisuHole may be unable to perform the operation.

Just click on the arrows to navigate thru the list of Stencils. Stencils The object used for drilling or extruding is called a STENCIL. To enter the Pick Stencil mode. The main buttons palette will disappear. 1) Creating a Stencil In the current version. The centroid of each individual shapes is shown as a small dot in blue. When you move the mouse on faces and components.5. This is the Insertion point used when you will later apply the stencil to drill or extrude a selection. this history is NOT kept across Sketchup sessions. press CTRL to force picking the individual face. • Click on a Face or on a group / component to pick the stencil. Fredo6 – VisuHole Page 7 / 17 v1. Stencils must be picked in the model. This is actually a set of 2D shapes. with or without holes. IMPORTANT: the point clicked becomes the origin of the Stencil.0 – 19 Sep 2014 . click on the button in the palette or press TAB. Note however that in the current version of VisuHole. The Insertion point is shown in red. 2) Navigating in the History of Stencils VisuHole keeps a history of created stencils within a Sketchup session. The active stencil is displayed below the buttons palette. The blue axis shows the direction for 2D projection (on faces it is simply the face normal). • Click and Drag to pick and orientate the X axis NOTE: if the selection is a group or component. a small axis system is displayed.

you can restrict the selection to the picked face or picked surface. regardless of the status of the buttons in the palette. Selection When there is a preselection. not embedded in a group or component). groups and components. represent the scope of the model that will be affected by the drilling or extrusion. faces.0 – 19 Sep 2014 .6. the elements selected. 1) Dynamic Selection from a face at Top Level If the picked face is at top-level (i. Note: you can force the SINGLE option by pressing control. then the selection depends on the options selected in the button palette: SINGLE: Only the picked RECURSE: the picked FROM TOP: all components component / group is component / group and all / groups are selected from selected its descendants are selected the top-most parent of the selected face The choice of options in reflected in the display: the resulting selection is highlighted in thick lines. then the selection is taken as all connected faces. Note that by pressing CTRL. Fredo6 – VisuHole Page 8 / 17 v1. Dynamic selection is All connected face Pressing Ctrl.e. dynamic selection is to the picked face restricted to the picked face 2) Dynamic Selection from a face in a Group or Component If the picked face belongs to a group or component. VisuHole computes dynamically a selection from the picked face with respect to the active model. When there is no pre-selection.

you can either proceed with another operation or modify the settings for the current operation. For custom direction. Note: if some shapes of the Stencil fall outside of the selection they would be ignored if their centroid is outside any face. the button “APPLY CHANGE” will be enabled. If you change any parameter in the buttons palette. the other axes in X and Y are computed by default. Fredo6 – VisuHole Page 9 / 17 v1. along with their options: 1) General procedure Setting the direction of projection: by default it is the normal to the picked face. Tools for Drilling. • Either double click on a face • Or Click–Release–Move–Click–Release or Click-Drag-Release to set a different orientation of the X and Y axis. either an axis or a custom normal (as in MoveAlong or DrawAlong). mouse over a face and either type ENTER or LONG- CLICK. Once the Z-axis is set. VisuHole will undo the operation and redo it again with the new settings. Then. When pressing this button.0 – 19 Sep 2014 . Stamping and Extruding The VisuHole tool can be selected in the button palette. You may also set the Material options and Group options (see details later in this chapter). Once the operation is executed. to execute the operation. You can however impose a direction.7.

There are 3 options that can be combined together: a) Limiting the drill to the first tube b) Creating the holes without the tubes (i.e.e. 2) Drilling By default the Drill tool will create Holes with tubes in the whole selection. whatever is the selection Drill on the second block of the component Fredo6 – VisuHole Page 10 / 17 v1.0 – 19 Sep 2014 . Punch Thru) c) Generate the holes with Guide lines (i. Mark Thru) There are 3 options that can be combined together: Default: Thru with tubes First Tube only Thru with NO Tube First Tube only with no Tube Mark with Tubes Mark with NO tube IMPORTANT: The Drill tool always operates Front-to-Back from the picked face.

The shapes are printed on the front faces. PUNCH Holes are created for the Stencil shapes MARK The contours of the stencil shapes are created with Guide lines 4) Carving and Embossing The Offset (and other options) are common to these two forms of extrusion. This is similar to Joint Push Pull Extrude method. By default the direction for carving and embossing is calculated from the average directions of the extruded faces in the selection (so not based on the normal of the picked face). Carve Emboss Fredo6 – VisuHole Page 11 / 17 v1. You can type the offset in the VCB or click on the palette button to set it. 3) Stamping You can Stamp.0 – 19 Sep 2014 . Punch or Mark. Sholes in the stencils are left out. STAMP The shapes are printed as faces on the selection. The objective is to avoid unrealistic distortions on curved surfaces. Both methods support formula and optional units.

0 – 19 Sep 2014 . Flattened Flattened Option: FORCE MASTER DIRECTION By default the direction of extrusion is calculated for each individual shapes as the local normal at the centroid of each individual shapes. Option: FLATTEN EXTRUDED FACES By default the extrusion keeps a uniform depth (or height). Fredo6 – VisuHole Page 12 / 17 v1. You may want however to flatten the extruded faces. Therefore the extruded faces follow the curved surface. You can also combine this option with the FLATTEN EXTRUDED FACES option. You may however want to force the direction normal to the picked face for ALL shapes.

individual shapes are drilled along the master direction With the option FOLLOW SURFACE.0 – 19 Sep 2014 . but this is not perfect. On curved surfaces. a straight projection is not necessarily adapted. Carve and Emboss attenuates this effect by using local normals. especially when you have several shapes. Only the shape close to the insertion point will not be too much distorted but others will. Stamp and Carve / Emboss. individual shapes are drilled along the local direction on the surface. you can create platforms in terrains: 5) Working on Curved Surfaces – FOLLOW SURFACE option VisuHole uses straight projection for each individual faces for all operations Drill. The result is very different Fredo6 – VisuHole Page 13 / 17 v1. In Projection mode. By combining the 2 options and imposing a global direction (here the vertical axis).

Likewise. when you stamp or carve / emboss. individual shapes can be distorted is you don’t use the option Follow Surface (here the circle appears as an ellipse): Fredo6 – VisuHole Page 14 / 17 v1.0 – 19 Sep 2014 .

8. the material of the faces below the extrusions You can change this behavior and force a material with the dedicated buttons in the palette.0 – 19 Sep 2014 . EXTRUDE and EMBOSS. Here are some illustrations: No Material assignment No Material assignment Material assigned Emboss Drill Emboss Material assigned Material assigned Material assigned Carve Drill Stamp Fredo6 – VisuHole Page 15 / 17 v1. the material is assigned as follows: • For DRILL tool. allowing you to navigate in the material list of the model or interactively pick a material in the model. Material Assignment By default. Default material • For STAMP.

By default the angle is 25 degrees. The original selection is unchanged. GROUP OUT: with this option. the generated geometry is put into individual groups in the individual context of the selection. You can however adjust it if you need in special situations by going to the Default Parameters: Fredo6 – VisuHole Page 16 / 17 v1. the generated geometry is created in the individual context of the selection and therefore merged with the original geometry. then you may have an irregular spacing of the shapes. VisuHole handles this issue by computing a true smooth profile for the curved surface when the curvature is ‘gentle’ (defined by a smoothness angle).9. The original selection is however changed (actually just punched). the generated geometry is created in a Master group at the top level of the model. GROUP IN: with this option. Other Options 1) Grouping IN and OUT By default. If local normals are taken as the normal of the face hit by the centroid of each individual shapes. Each shape is put into individual groups within this master group. This is because in Sketchup. there is no real ‘curved’ surface but a succession of flat faces. By default. 2) Smoothing Local Normals Curved surfaces present another issue (among others) related to the calculation of local normals.0 – 19 Sep 2014 .

0 – 19 Sep 2014 . Here is an illustration of the subtle effect of this option No smoothing of local normal Smoothing of local normal Angle = 0° Angle = 25° Shapes in the back are not well spaced Shapes in the back are equally spaced 3) Ignoring Sharp curvatures Another issue with curved surfaces is related to stamping or extruding on surfaces presenting sharp deviations. The question is whether some shapes should be ignored. The behavior is controlled by a maximum angle of deviation which can be set in the Default Parameters (default is 45 degrees): Here is an illustration: Cylinder shape is drawn (angle = 180°) Cylinder shape is NOT drawn (angle = 45°) Here the deviation is 70° So smaller than the deviation of 70° Fredo6 – VisuHole Page 17 / 17 v1.