1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
#pragma once
#include <string>
#include <stdexcept>
#include "icommandsystem.h"
#include "math/Vector2.h"
class TextureProjection;
class Face;
class SelectionTest;
enum EAlignType
{
ALIGN_TOP,
ALIGN_BOTTOM,
ALIGN_LEFT,
ALIGN_RIGHT,
};
namespace selection
{
namespace algorithm
{
// Command wrapper of the above
void applyShaderToSelectionCmd(const cmd::ArgumentList& args);
/**
* greebo: Applies the shader in the clipboard to the nearest
* texturable object (using the given SelectionTest)
*
* @test: the SelectionTest needed (usually a SelectionVolume).
*
* @projected: Set this to TRUE if the texture is projected onto patches
* using the face in the shaderclipboard as reference plane
* Set this to FALSE if a natural texturing of patches is attempted.
*
* @entireBrush: Set this to TRUE if all brush faces should be textured,
* given the case that the SelectionTest is resulting in a brush.
*
* @throws: cmd::ExecutionFailure when the current selection
* is not suitable.
*/
void pasteShader(SelectionTest& test, bool projected, bool entireBrush = false);
/**
* greebo: Copies the texture coordinates from the source patch in the
* ShaderClipboard to the target patch defined by the SelectionTest.
* Tests are performed to ensure that the operation is valid,
* an error message is displayed otherwise.
*
* @test: the SelectionTest needed (usually a SelectionVolume).
* @throws: cmd::ExecutionFailure when the current selection
* is not suitable.
*/
void pasteTextureCoords(SelectionTest& test);
/**
* greebo: Copies the texture name only from the source in the
* ShaderClipboard to the target patch defined by the SelectionTest.
* Tests are performed to ensure that the operation is valid,
* an error message is displayed otherwise.
*
* @test: the SelectionTest needed (usually a SelectionVolume).
*/
void pasteShaderName(SelectionTest& test);
/** greebo: The command target of "CopyTexure". This tries to pick the shader
* from the current selection and copies it to the clipboard.
*/
void pickShaderFromSelection(const cmd::ArgumentList& args);
/** greebo: The command target of "PasteTexture". This tries to get the Texturables
* from the current selection and pastes the clipboard shader onto them.
*/
void pasteShaderToSelection(const cmd::ArgumentList& args);
/** greebo: The command target of "PasteTextureNatural". This tries to get
* the Texturables from the current selection and
* pastes the clipboard shader "naturally" (undistorted) onto them.
*/
void pasteShaderNaturalToSelection(const cmd::ArgumentList& args);
/** greebo: Retrieves the texture projection from the current selection.
*
* @returns: the TextureProjection of the last selected face/brush.
*/
TextureProjection getSelectedTextureProjection();
/** greebo: Get the width/height of the shader of the last selected
* face instance.
*
* @returns: A Vector2 with <width, height> of the shader or <0,0> if empty.
*/
Vector2 getSelectedFaceShaderSize();
/** greebo: Rescales the texture of the selected primitives to fit
* <repeatX> times horizontally and <repeatY> times vertically
*/
void fitTexture(const double repeatS, const double repeatT);
// Command target wrapping the above
void fitTextureCmd(const cmd::ArgumentList& args);
/** greebo: Flips the texture about the given <flipAxis>
*
* @flipAxis: 0 = flip S, 1 = flip T
*/
void flipTexture(int flipAxis);
/** greebo: The command Targets for flipping the textures about the
* S and T axes respectively.
* Passes the call to flipTexture() method above.
*/
void flipTextureS(const cmd::ArgumentList& args);
void flipTextureT(const cmd::ArgumentList& args);
void alignTexture(EAlignType align);
// Aligns the texture of the current objets so that the image border aligns with a world edge
void alignTextureCmd(const cmd::ArgumentList& args);
/** greebo: Applies the texture "naturally" to the selected
* primitives. Natural makes use of the currently active default scale.
*/
void naturalTexture(const cmd::ArgumentList& args);
/** greebo: Shifts the texture of the current selection about
* the specified Vector2
*/
void shiftTexture(const Vector2& shift);
/** greebo: These are the shortcut methods that scale/shift/rotate the
* texture of the selected primitives about the values that are currently
* active in the Surface Inspector.
*/
void shiftTextureLeft();
void shiftTextureRight();
void shiftTextureUp();
void shiftTextureDown();
void scaleTextureLeft();
void scaleTextureRight();
void scaleTextureUp();
void scaleTextureDown();
void rotateTextureClock();
void rotateTextureCounter();
/**
* Command target to rotate the texture.
*
* args[0]: Pass positive values to rotate clockwise,
* negative values for counter-clockwise rotation.
*/
void rotateTexture(const cmd::ArgumentList& args);
/**
* Command target to scale the texture.
*
* args[0]: Vector2 which contains the relative scale values
* in the s and t axis (0 = 100%).
* args[0]: String: [up|down|left|right] which takes the values
* from the SurfaceInspector.
*
* Example: <0.05, 0> results in a 105% scale in the s direction.
*/
void scaleTexture(const cmd::ArgumentList& args);
/**
* Command target to shift the texture.
*
* args[0]: Vector2 which contains the s/t shift values
* args[0]: String: [up|down|left|right] which takes the values
* from the SurfaceInspector.
*/
void shiftTextureCmd(const cmd::ArgumentList& args);
/** greebo: This translates the texture coordinates towards the origin
* in texture space without altering the appearance.
* The texture is translated in multiples of 1.0
*/
void normaliseTexture(const cmd::ArgumentList& args);
/**
* greebo: (De-)selects all map nodes that match the given shaderName.
*/
void selectItemsByShader(const std::string& shaderName);
void deselectItemsByShader(const std::string& shaderName);
// Command target to (de-)select items by shader name
void selectItemsByShaderCmd(const cmd::ArgumentList& args);
void deselectItemsByShaderCmd(const cmd::ArgumentList& args);
} // namespace algorithm
} // namespace selection
|
