Ad banner place
Browse, install and update extensions directly in SketchUp with Sketchucation Tools
Download Now
TextureTools v2.0
- Overview
- Documentation
- Release Notes
A Toolset of six utilities to manipulate Textures through either dialogs or arrow-keys:
Allowing you to finely Rotate, Position and Scale Textures on a Selected Face.
See Main Documentation for usage...
Copyright 2011-2014 (c) TIG
All Rights Reserved.
THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES,INCLUDING,WITHOUT LIMITATION,THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
TIG-TextureTools.rb >> ../Plugins/ folder
Plus script >>> ../Plugins/TIG-TextureTools/ folder
TIG-TextureTools_code.rb
Plus image files >>> ../Plugins/TIG-TextureTools/Images/ folder
TextureAdjust.png
TextureNudge.png
TextureRotate.png
TextureScale.png
TextureShunt.png
TextureTweak.png
Usage:
Ensure the TIG-TextureTools Extension is activated...
TextureRotate:
Select ONE face that has a front material with a texture.
Note that a selection containing more that one thing is ignored.
Activate the Tool:-
...Either pick 'TextureRotate' off the Plugins submenu 'TIG-TextureTools...'
...Or View > Toolbars activate TIG-TextureTools-toolbar and click its button.
[Note: the toolbar is only available if the .png files exists]
A dialog appears showing the initial default rotation of 90.0 degrees.
Enter any +/-ve angle and the texture on the selected face rotates about
the first vertex of that face by that given angle.
The last entered angle is remembered during that session.
To run the Tool without a dialog you can use 'TIG::TextureTools::Rotate.new(45)' -
where the angle is passed directly to the texture, in this case it is
45 degrees; this allows the texture-rotation to be run from within another
tool which passes an angle directly to it without an interrupting dialog.
TextureAdjust:
Select ONE face that has a front material with a texture.
Note that a selection containing more that one thing is ignored.
Activate the Tool:-
...Either pick 'TextureAdjust' off the Plugins submenu 'TIG-TextureTools...'
...Or View > Toolbars activate TIG-TextureTools-toolbar and click its button.
[Note: the toolbar is only available if the .png files exists]
A dialog appears showing the initial default adjust angle of 1.0.
Enter the adjust angle value required - e.g. 15.0
The last entered adjust angle is remembered during that session.
Now use the arrow-keys to adjust the texture by the current angle -
the U/X +/- is right/left arrows.
A +ve arrow [right] applies the angle CCW.
A -ve arrow [left] applies the angle CW [i.e. as if it's -ve].
Thus entering 0.5 and pressing the right-arrow repeatedly will rotate the
texture by increments of 0.5 degrees: useful for fine adjustments.
Thus you can reverse the rotation by using the other arrow...
The texture on the selected face roattes the given angle, or 10x if the
Shift key is being held down.
The rotation is anchored on the face's first vertex.
To open the dialog to reset the Tool's Adjust Angle value press
Choose another Tool to end TextureAdjust.
TextureShunt:
Select ONE face that has a front material with a texture.
Note that a selection containing more that one thing is ignored.
Activate the Tool:-
...Either pick 'TextureShunt' off the Plugins submenu 'TIG-TextureTools...'
...Or View > Toolbars activate TIG-TextureTools-toolbar and click its button.
[Note: the toolbar is only available if the .png files exists]
A dialog appears showing the initial default shunt factors of U=1 & V=1
in 'units' - i.e. whatever the SKP's units are, e.g. 1cm
Enter any shunt values required [with or without units suffix] and the
texture on the selected face shunts across the face by the given factors in
the UV directions.
The last entered shunt factors are remembered during that session.
To run the Tool without a dialog you can use
'TIG::TextureTools::Shunt.new('20mm','0')' - where the factors are passed
directly as strings to the texture, in this case it is moved 20mm across
in the U; this allows the texture-shunting to be run from within another
tool which passes factors directly to it without an interrupting dialog.
TextureNudge:
Select ONE face that has a front material with a texture.
Note that a selection containing more that one thing is ignored.
Activate the Tool:-
...Either pick 'TextureNudge' off the Plugins submenu 'TIG-TextureTools...'
...Or View > Toolbars activate TIG-TextureTools-toolbar and click its button.
[Note: the toolbar is only available if the .png files exists]
A dialog appears showing the initial default nudge factor of 1 unit -
i.e. whatever the SKP's units are, e.g. 1mm
Enter the nudge value required [with or without units suffix].
The last entered nudge factor is remembered during that session.
Now use the arrow-keys to nudge the texture by the current distance -
the U/X is right or left, and V/Y is up or down.
It is useful for fine adjustments to the texture's position.
The texture on the selected face nudges across by the given distance, or 10x
the distance if the Shift key is being held down.
To open the dialog to reset the Tool's Nudge value press
Choose another Tool to end TextureNudge.
TextureScale:
Select ONE face that has a front material with a texture.
Note that a selection containing more that one thing is ignored.
Activate the Tool:-
...Either pick 'TextureScale' off the Plugins submenu 'TIG-TextureTools...'
...Or View > Toolbars activate TIG-TextureTools-toolbar and click its button.
[Note: the toolbar is only available if the .png files exists]
A dialog appears showing the initial default scale factors of U=0.5 & V=0.5.
Enter any scale values required [e.g. 0.5 & 1] and the texture on the
selected face scales by the given factors in the UV directions; it is
anchored on the face's first vertex.
The last entered scale factors are remembered during that session.
To run the Tool without a dialog you can use
'TIG::TextureTools::Scale.new('2','1')' - where the factors are passed
directly as strings to the texture, in this case it is scaled 2x in the U/X
direction; this allows the texture-shunting to be run from within another
tool which passes factors directly to it without an interrupting dialog.
TextureTweak:
Select ONE face that has a front material with a texture.
Note that a selection containing more that one thing is ignored.
Activate the Tool:-
...Either pick 'TextureTweak' off the Plugins submenu 'TIG-TextureTools...'
...Or View > Toolbars activate TIG-TextureTools-toolbar and click its button.
[Note: the toolbar is only available if the .png files exists]
A dialog appears showing the initial default tweak scale factor of 0.1.
Enter the tweak value required - e.g. 0.2
The last entered tweak scale factor is remembered during that session.
Now use the arrow-keys to tweak the texture by the current factor -
the U/X +/- is right or left, and V/Y +/- is up or down.
A +ve arrow [right/up] applies the factor - e.g. 0.5
A -ve arrow [left/down] applies the inverse of the factor - e.g. 1/0.5=2
It is useful for fine adjustments to the texture's size.
Thus you can reverse scaling in an axis by using the inverse arrow...
The texture on the selected face scales the given factor, or 10x if the
Shift key is being held down.
The scaling is anchored on the face's first vertex.
To open the dialog to reset the Tool's Tweak Scale value press
Choose another Tool to end TextureTweak.
The final submenu item Toggles the Toolbar ON/OFF...
1.0 20110519 First Release - TextureRotate.
1.1 20110519 TextureTools expanded to include TextureShunt.
Traps added for colinear vertices and > quad faces etc.
1.2 20110519 Minor toolbar coding glitch fixed.
1.3 20110519 TextureNudge with Arrow-Keys added.
1.4 20110520 New tools added, TextureScale & TextureTweak [Scale by Arrows]
& TextureAdjust [Rotate by Arrows]. Button png files adjusted.
Use of a ',' instead of a '.' as a decimal-point now works.
1.5 20110520 Users may now type a '.' OR a ',' as a decimal-separator,
depending on their preference, for any of the tools' dialogs -
issues with conversion of strings to lengths from potential
locale-wrong input is addressed in the code behind the scenes.
1.6 20110812 Inputbox code improved.
2.0 20131214 Now Extension TIG-TextureTools & self-tidies. Added to PluginStore.