For French users, here is a translation of this post in French (Many thanks to Jean Franco)

ThurPaint QuickStart - v1.2a - 08 May 12.pdf

ThruPaint is a standalone script which extends the native SU Paint tool with several functions:

Painting across the boundaries of components and groups. You don’t need to open groups and components to paint their faces or edges.

Click and Drag mode to paint progressively face by face, or surface by surface and to extend a surface already painted

ThruPaint gif 2.gif

Explicit selections of faces: single face, surfaces, connected faces, adjacent faces with same materials. ThruPaint also supports painting of a preselection of faces or edges.

Selection of edges by properties. Edges can also be painted automatically when painting their bordering faces.

Painting on front face, back face or both, with an option to automatically orientate faces all in the same direction.

Painting of component, groups as well as text labels and dimensions

ThruPaint Container mode -small.gif

Sampling of material from any face within the model, including if embedded in component.

Several Texturing options (but this is NOT UV mapping):

Natural UV: Ensure texture continuity with NO distortion. UV are propagated from the initial face painted via their common edges. Adapted to quasi-planar shapes and regular surfaces

Projected UV with various choices of the projection plan: initial face, view camera plane, custom face, local and model axes

QuadMesh, which requires that the faces you paint are nicely arranged as pseudo-quads in a rather regular mesh. Useful for arch, spheres or shapes generated by TIG Extrusion, Curviloft. I use the convention for diagonals introduced by Thomthom (edge property "Cast shadow" is set to false), but the script tries to reconstruct the mesh on the fly if not guided by diagonals. ThruPaint embeds a tool to mark / unmark edges as diagonal, which may help ThruPaint to build the mesh correctly. Due to limitation of the SU, which performs texture distortion by perspective instead of bilinear mapping, you may not get the desired effect and the continuity between cells may not be perfect.

ThruPaint gif 6.gif

ThruPaint gif 4.gif

ThruPaint gif 1.gif

You have also a Transfer UV mode (the colored brush icon), where you just substitute a texture by another without changing the UV.

For each texturing mode, you need to select the U axis and V direction by hovering over the edges of the first face to paint.

Edition of Textured faces, with the following transformations: translation, rotation, scaling (uniform and non-uniform), mirroring, tiling and reset. These transformations are performed by modifying the UV map on the faces, not by modifying the material. So the same material can be used to texture faces with different transformations.For texture Transformation, you can use:- The arrows (you can keep them pressed to progressively perform the transformation)

ThruPaint gif 3.gif

- the VCB, where you can indicate the exact values of transformations parameters- A Visual Editor (click when you have the Red/Green cross)For the shortcuts and VCB syntax, the best is to call the built-in Help by pressing F10 or via the contextual menu. And more generally, check out the tooltips and contextual menu.

ThruPaint gif 7.gif

Texturing modes and transformations are persistent across Sketchup sessions. So you can edit textured faces at any further point in time.Finally, you can freely use CTRL-Z or Escape as well as Ctrl-Y to undo / redo from within the plugin.

BIG WARNING to MAC UsersOn Windows, you can freely use the native Material Selector. HOWEVER, on Mac, you CANNOT, because the Ruby API does not see the current material until it is applied with the native SU Paint tool. So you need to cycle through the model materials using the small arrows in the palette or TAB / Shift TAB. You can also sample the material from the model. I may have to build a custom selector in a next version.

On Windows, you can use the Material selector, whether for materials in the Model or in libraries.WARNING: On Mac, the Material selector cannot be used, due to a bug in the API. When you click on a material thumbnail, the Ruby API does not see it.

Sampling material from the model: hover faces in the model and press Return. You have also 2 small icons in the button palette to perform this operation, either just for the material or for both the material and UV mode. When you hover on a textured face, you can also press any arrow to switch to its material and UV mode (and then start edition)

Cycling through the materials in the model. Use the small arrows in the palette button or the TAB / Shift-TAB keys

You can set the current material to Default Material for Unpainting by clicking on the small icon.

Basic Painting of faces

ThruPaint Faces.png

Choose the Faces Selection in the palette: single face, surface, all connected faces, adjacent faces with same color, adjacent faces with same color and UV mode.

For Colors, mouse over the first face to paint and Click.For Texturing, mouse over to choose the U axis (in Red) and V axis (in green) from an edge of the face.

Click & Drag painting: This is to extend the painting from a face already painted. The extended faces depends on the Face Selection parameter. Useful to paint face by face, or to fill an area after painting its contour.

Texturing Modes

ThruPaint UV modes.png

Choose the UV Mode, depending on the shape you have, then pick the U and V directions by hovering on face edges, then click on a face.

Texturing is always generated from the first face painted.

In Natural mode, texture continuity is propagated from the first face

In Projected mode, the default plane is the plane of the initial face. So it does matter which one you choose. Try to start from a face defining an average plane.

In QuadMesh mode, only faces with 3 or 4 edges are painted. The first face fixes width and height references, which are then propagated to the neighbor faces. So you don’t get the same result depending on where you start from. Try also to avoid starting from a spike face. After painting, the quad mesh is shown in red and green. In this mode, you may have faces which cannot be painted (in Red if this is critical), in yellow if they can be just ignored. Usually, this is a problem with the construction of the Mesh. You can guide ThruPaint to better construct the mesh by using the diagonal tool to mark edge as diagonal, which are ignored in the mesh.

For the Transfer UV mode, just select a new textured material and click on a textured area (anywhere). The UV mapping and UV mode are preserved and the texture is substituted (there may be adjustments if you edit it afterward, as the new texture may have a different ratio Height / Width).

Transforming textures

ThruPaint provides 3 ways to transform texturing

VCB: you can set the exact value of parameters (like “30d” to rotate by 30 degrees or “3x” to scale by a factor 3 uniformly).

Arrows: straight arrows are for Translation, Shift-Arrows for Scaling along U and along V, Ctrl-Arrows Left / Right for Rotation, Ctrl-Arrows Up / Down for Uniform scaling.

Visual Editor. This is a small referential allowing to interactively perform translation, scaling and rotation. The small handles works in Click & Drag mode as well as in Click – Release – Drag – Click mode. Inference for Rotation, Scaling and Translation along axes can be deactivated via the small floating palette, which also features other transformations.

For the syntax of VCB and Arrows, use the embedded help by pressing F10 or calling the help from the contextual menu.

For Rotation, Scaling and Mirroring, the transformation is always performed about the cursor point or the Visual Editor origin. So check where you mouse-over the cursor. Note also that - Rotation is clock-wise (green toward red axis) - Translation is by reference to the UV axis, not the screen viewport (so check the direction of axes when using arrows).Transformations supported are:

Translation in U and V

Scaling, Uniform and non Uniform (except for Natural mode)

Rotation

Tiling, 1x1 by default, or choosing the factors in U and V

Mirroring, about the cursor point, the U axis and the V axis

If the Current Material in the material selector and current UV mode are the same as the textured material and UV mode on a face, then the cursor should appear as a small cross red / green / black. In this case, you can - use the arrows - use the VCB - Click to activate the Visual Editor

If the Current Material in the material selector and current UV mode are NOT the same as the textured material and UV mode on a face, then you are in Painting mode. You can however: - use the arrows - use the VCBThis will switch the current material and UV mode to the selected face, so that you can further activate the Visual Editor

Most transformations functions are available from the Contextual menu

When the textured area has a lot of faces, only a small number of faces (1000 by default) are interactively transformed. The other faces are transformed when you finish the interactive edition. You can change this number in the Default Parameters.

Painting Edges

ThruPaint Edges.png

You can Paint just edges by disabling the Paint Faces option

You have the choice for selection edges: edge by edge, curve, Follow, All connected

Hover over the edges and click to paint them

Other Functions

ThruPaint Others.png

You can toggle the visibility of hidden edges

There is a tool to mark diagonal

You can call the native SU Paint tool

You can set the option to have ThruPaint activated whenever you call the native SU Paint tool.

Came here specifically wondering about this plugin and here it is! Fredo we all owe you a huge debt of gratitude. Thanks for all of the great plugins and for continuing to keep them free and available to all. Between Thom's Quad Tools, Whaat's SketchUVs and now ThruPaint, I might have to actually bring models made elsewhere into Sketchup for texturing! Who woulda thunk it?!

I am getting a bugsplat every time when I try to apply a material to a newly created group. If I create a group and paint it with the native SU bucket, sample that with Thrupaint and apply it to a different group I don't get a bugsplat. Weird.Any ideas?

wolfy wrote:I am getting a bugsplat every time when I try to apply a material to a newly created group. If I create a group and paint it with the native SU bucket, sample that with Thrupaint and apply it to a different group I don't get a bugsplat. Weird.Any ideas?

Wolfy,

Could you be more explicit.Are you on Mac or Windows?What do you mean by "newly created group"?

This is AWESOME...! Than you so much for all the excellent plugins you make, Fredo... I wonder why you make them all for free...The Google SU team should pay you something for this - and some of your other - amazing plugins...

wolfy wrote:I am getting a bugsplat every time when I try to apply a material to a newly created group. If I create a group and paint it with the native SU bucket, sample that with Thrupaint and apply it to a different group I don't get a bugsplat. Weird.Any ideas?

Wolfy,

Could you be more explicit.Are you on Mac or Windows?What do you mean by "newly created group"?

Thanks

Fredo

That sounds like the material applied is from the Material Library and not In Model. The bugsplat I mentioned in my Materials article. Did you trap for that?

your interface and icons are ugly, but these tools are EFFING amazing!!!!!! Really cant believe these things are possible in Sketchup (wheres the clapping hands icon) - and very gracious of you to make them free, i will definitly donate!

Free Agent wrote:your interface and icons are ugly, but these tools are EFFING amazing!!!!!! Really cant believe these things are possible in Sketchup (wheres the clapping hands icon) - and very gracious of you to make them free, i will definitly donate!

please fix graphic interface and icons

support， all of the powerful plug-in, Fredo6 the selfless spirit! Admire

Next drink is on me my friend. Loving this plugin! Donated a little more than I paid for the new commercial UV tool as I think there are more features with ThruPaint. Although I think both tools together have great synergy.

bagatelo wrote:What then would be the advantages or disadvantages from this Plugin for Plugin SketchUV done by whaat? May I have to try both to say something...

SketchUV is much more powerful for real UV Mapping. You can export, map UVs and import back to have a professional work. ThruPaint is just a paint tool that handle texture continuity in predefined situations within Sketchup. So both are complementary.

Whenever I can, I will check whethere they could be any incompatibility or conflict when applying texture in one and editing in the other.

wolfy wrote:I am getting a bugsplat every time when I try to apply a material to a newly created group. If I create a group and paint it with the native SU bucket, sample that with Thrupaint and apply it to a different group I don't get a bugsplat. Weird.Any ideas?

Wolfy,

Could you be more explicit.Are you on Mac or Windows?What do you mean by "newly created group"?

Thanks

Fredo

That sounds like the material applied is from the Material Library and not In Model. The bugsplat I mentioned in my Materials article. Did you trap for that?

Fredo and ThomThom,Thanks for the replies. I mean "newly created group" as in the first group I make when opening Sketchup, and yes I am picking the material from the materials library. Is that not the correct procedure? Does the material have to be in the model for use with Thrupaint?Can't wait to learn the ins and outs of the fantastic plugin Fredo! Your skills are amazing