[Plugin] FredoTools::ThruPaint - v1.3a - 20 Oct 16

fredo6 · 11 Apr 2012, 21:50

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
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
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.
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)
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.

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 Users
On 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.

ThruPaint is installed as part of FredoTools ..

See the main post for this plugin for Installation of FredoTools

No user manual (see section Quick Start and Videos below)

SU Versions: SU6, SU7, SU8 – works better with SU8 M1 and above
Platforms: Windows and Mac (with limitation of Material selector)
Languages: English, French, Spanish Spain (by Oxer), Spanish Latin America (by Defisto), Chinese (by guanjin)
Menus: by default, ThruPaint is installed in Tools > FredoTools. It does NOT appear in the Contextual menu.
Icon toolbar: Fredo6 Tools. There is only a single icon. By default, it is not shown. You need to go to the Default Parameters… dialog of FredoTools to enable the icon.
The plugin is free, for private and commercial usage.

ThruPaint Overview

There is a very comprehensive tutorial by TutorialsUp (Ahmed00007).

Selecting the Current Material

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

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.
Choose the Face side. Visible face (default), Front, Back, Front+Back. By default the auto-flip mode is On.
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

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 VCB
  This 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

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

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.

ThruPaint 1.3a - 20 Oct 16: Introduction of Purge. See this post for details.

ThruPaint 1.2a - 08 May 12: Painting of components, groups, text labels and dimensions. See this post for details.

ThruPaint 1.0n - 21 Apr 12: Small functional evolutions:

ThruPaint keeps track of the last scaling and rotation parameters by Material. Sampling in model also copy the scaling and rotation parameters
Painting of a preselection of Faces or Edges
See Release Notes for details

ThruPaint 1.0m - 14 Apr 12: Update to fix a few problems and to integrate the Translation in Spanish and Chinese

ThruPaint 1.0j - 11 Apr 12: initial public release

Rich O Brien · 11 Apr 2012, 21:51

Thanks Fredo

Really great tool

pilou · 11 Apr 2012, 22:15

The more difficult is for rotate and zoom : use Arrow key + Shift or Control

bagatelo · 11 Apr 2012, 23:18

What's inside you, Fredo?
You are not of this world, huh?

EarthMover · 11 Apr 2012, 23:41

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?!

wolfy · 11 Apr 2012, 23:43

Outstanding looking plugin Fredo Cannot wait to try it.
Your efforts make this world a better place, one plugin at a time!
Thank you very much!!!

bagatelo · 12 Apr 2012, 00:06

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...

mitcorb · 12 Apr 2012, 01:54

Of course, I saw ReverseOrientFaces before I saw ThruPaint, and I am just floored! Salute to you Fredo, for this work.

wolfy · 12 Apr 2012, 02:00

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?

solo · 12 Apr 2012, 02:07

jorge2011 · 12 Apr 2012, 02:35

fredo thank you very much. excellent tool.
more than 7000 lines of code. The work is very hard.

Thank you very much again

fredo6 · 12 Apr 2012, 06:49

@wolfy said:

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

Frederik · 12 Apr 2012, 07:10

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...

srx · 12 Apr 2012, 07:17

This will make me texture organic shapes for the first time Thank you!

thomthom · 12 Apr 2012, 07:26

@unknownuser said:

@wolfy said:

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?

thomthom · 12 Apr 2012, 07:33

If you appreciate Fredo's high quality extensive tool sets I highly recommend you make a donation to support his efforts!

Window > LibFredo6 Settings... > Donations... > Fredo6 at PayPal

Rich O Brien · 12 Apr 2012, 07:37

+1

Pixero · 12 Apr 2012, 07:51

I was fortunate to test this plugin and it's already proved irreplaceable for me.
Big thanks Fredo!

Panga · 12 Apr 2012, 07:54

Thanks a million Fredo !! For sure I'll donate...and hope that others will do the same !! Every work needs to be awarded !!

free agent · 12 Apr 2012, 08:37

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