textureWindow is undoable, queryable, and editable.
This command is used to create a UV Editor and to query or edit
the texture editor settings.
In query mode, return type is based on queried flag.
| Long name (short name) |
Argument types |
Properties |
|
activeSelectionOnTop(ast)
|
boolean
|
  
|
|
Display the solid map / distortion of active selection on top of others.
|
|
axesColor(axc)
|
[float, float, float]
|
|
|
The color of axes, default is 0.0 0.0 1.0
|
|
backFacingColor(bfc)
|
[float, float, float, float]
|
|
|
Sets or queries the RGBA back facing color.
|
|
capture(cpt)
|
string
|
|
|
Perform an one-time capture of the viewport to the named image file on disk.
|
|
captureSequenceNumber(csn)
|
int
|
|
|
When a number greater or equal to 0 is specified each
subsequent refresh will save an image file to disk if the
capture flag has been enabled.
The naming of the file is:
{root name}.#.{extension}
if the name {root name}.{extension} is used for the capture flag argument.
The value of # starts at the number specified to for this argument and
increments for each subsequent refresh.
Sequence capture can be disabled by specifying a number less
than 0 or an empty file name for the capture flag.
|
|
changeCommand(cc)
|
[string, string, string, string]
|
|
|
Parameters:
- First string: command
- Second string: editorName
- Third string: editorCmd
- Fourth string: updateFunc
Call the command when something changes in the editor The command
should have this prototype :
command(string $editor, string $editorCmd, string $updateFunc, int $reason)
The possible reasons could be :
- 0: no particular reason
- 1: scale color
- 2: buffer (single/double)
- 3: axis
- 4: image displayed
- 5: image saved in memory
|
|
checkerColor1(cc1)
|
[float, float, float]
|
|
|
Sets the first color of the checker and identification pattern, when color mode is 2-colors.
|
|
checkerColor2(cc2)
|
[float, float, float]
|
|
|
Sets the second color of the checker and identification pattern, when color mode is 2-colors.
|
|
checkerColorMode(ccm)
|
int
|
|
|
Sets the color mode of the checker and identification pattern.
0: multi-colors;
1: 2-colors;
|
|
checkerDensity(cd)
|
int
|
|
|
Sets the density of the checker and identification pattern.
|
|
checkerDrawTileLabels(cdt)
|
boolean
|
|
|
Toggles the checker tile label display.
|
|
checkerGradient1(cg1)
|
[float, float, float]
|
|
|
Sets the first gradient of the checker and identification pattern, when color mode is 2-colors.
|
|
checkerGradient2(cg2)
|
[float, float, float]
|
|
|
Sets the second gradient of the checker and identification pattern, when color mode is 2-colors.
|
|
checkerGradientOverlay(cgo)
|
boolean
|
|
|
Toggle application of the gradient.
|
|
checkerTileLabelColor(ctc)
|
[float, float, float]
|
|
|
Sets the checker tile label color.
|
|
clearImage(ci)
|
boolean
|
|
|
Clears the current Editor Image.
|
|
cmEnabled(cme)
|
boolean
|
|
|
Turn on or off applying color management in the editor. If set, the color
management configuration set in the current editor is used.
|
|
control(ctl)
|
boolean
|
|
|
Query only. Returns the top level control for this editor.
Usually used for getting a parent to attach popup menus.
Caution: It is possible for an editor to exist without a
control. The query will return "NONE" if no control is present.
|
|
defineTemplate(dt)
|
string
|
|
|
Puts the command in a mode where any other flags and arguments are
parsed and added to the command template specified in the argument.
They will be used as default arguments in any subsequent
invocations of the command when templateName is set as the
current template.
|
|
displayAxes(dax)
|
boolean
|
|
|
Specify true to display the grid axes.
|
|
displayCheckered(dct)
|
boolean
|
|
|
Display a unique checker and identification pattern for each UV tiles.
|
|
displayDistortion(ddt)
|
boolean
|
|
|
Display the layout in shaded colors to indentify areas with stretched/squashed UVs
|
|
displayDivisionLines(ddl)
|
boolean
|
|
|
Specify true to display the subdivision lines between
grid lines.
|
|
displayGridLines(dgl)
|
boolean
|
|
|
Specify true to display the grid lines.
|
|
displayImage(di)
|
int
|
|
|
Set a particular image in the Editor Image Stack as the current Editor Image.
Images are added to the Editor Image Stack using the "si/saveImage" flag.
|
|
displayIsolateSelectHUD(dih)
|
boolean
|
|
|
Show heads-up display of isolate selection
|
|
displayLabels(dl)
|
boolean
|
|
|
Specify true to display the grid line numeric labels.
|
|
displayOverlappingUVCountHUD(doh)
|
boolean
|
|
|
Show heads-up display of overlapping UV count, as a part UV Statistics HUD
|
|
displayPreselection(dps)
|
boolean
|
|
|
Toggles the pre-selection display.
|
|
displayReversedUVCountHUD(drh)
|
boolean
|
|
|
Show heads-up display of UV Shells, as a part UV Statistics HUD
|
|
displaySolidMap(dsm)
|
boolean
|
|
|
Display a solid overlay for the active texture map.
|
|
displayStyle(dst)
|
string
|
|
|
Set the mode to display the image. Valid values are:
- "color" to display the basic RGB image
- "mask" to display the mask channel
- "lum" to display the luminance of the image
|
|
displayTextureBorder(dtb)
|
boolean
|
|
|
Toggles the texture borders display.
|
|
displayUVPositionHUD(duv)
|
boolean
|
|
|
Show heads-up display of UV positions
|
|
displayUVShellCountHUD(dsh)
|
boolean
|
|
|
Show heads-up display of UV Shell count, as a part UV Statistics HUD
|
|
displayUVStatisticsHUD(duh)
|
boolean
|
|
|
Show heads-up display of UV Statistics
|
|
displayUsedPercentageHUD(dph)
|
boolean
|
|
|
Show heads-up display of used UV space percentage, as a part UV Statistics HUD
|
|
distortionAlpha(dta)
|
float
|
|
|
Set or query the distortion display alpha.
|
|
distortionPerObject(dpo)
|
boolean
|
|
|
Toggles the per-object distortion display.
|
|
divisions(d)
|
int
|
|
|
Sets the number of subdivisions between main grid lines.
|
|
docTag(dtg)
|
string
|
|
|
Attaches a tag to the editor.
|
|
doubleBuffer(dbf)
|
boolean
|
|
|
Set the display in double buffer mode
|
|
drawAxis(da)
|
boolean
|
|
|
Set or query whether the axis will be drawn.
|
|
drawSubregions(dsr)
|
boolean
|
|
|
Toggles the subregion display.
|
|
exists(ex)
|
boolean
|
|
|
Returns whether the
specified object exists or not. Other flags are ignored.
|
|
exposure(exp)
|
float
|
|
|
The exposure value used by the color management of the current editor.
|
|
filter(f)
|
string
|
|
|
Specifies the name of an itemFilter object to be used with this editor.
This filters the information coming onto the main list
of the editor.
|
|
forceMainConnection(fmc)
|
string
|
|
|
Specifies the name of a selectionConnection object that the
editor will use as its source of content. The editor will only
display items contained in the selectionConnection object. This is
a variant of the -mainListConnection flag in that it will force a
change even when the connection is locked. This flag is used to
reduce the overhead when using the -unlockMainConnection
, -mainListConnection, -lockMainConnection flags in immediate
succession.
|
|
forceRebake(frb)
|
boolean
|
|
|
Forces the current cache texture to refresh.
|
|
frameAll(fa)
|
boolean
|
|
|
This will zoom on the whole scene.
|
|
frameSelected(fs)
|
boolean
|
|
|
This will zoom on the currently selected objects.
|
|
frontFacingColor(ffc)
|
[float, float, float, float]
|
|
|
Sets or queries the RGBA front facing color.
|
|
gamma(ga)
|
float
|
|
|
The gamma value used by the color management of the current editor.
|
|
gridLinesColor(glc)
|
[float, float, float]
|
|
|
The color of grid lines, default is 0.325 0.325 0.325
|
|
gridNumbersColor(gnc)
|
[float, float, float]
|
|
|
The color of grid numbers, default is 0.2 0.2 0.2
|
|
highlightConnection(hlc)
|
string
|
|
|
Specifies the name of a selectionConnection object that
the editor will synchronize with its highlight list. Not all
editors have a highlight list. For those that do, it is a secondary
selection list.
|
|
imageBaseColor(ibc)
|
[float, float, float]
|
|
|
The base color of the image, default is white 1.0 1.0 1.0
|
|
imageDim(idm)
|
boolean
|
|
|
Toggles the image dimming.
|
|
imageDisplay(id)
|
boolean
|
|
|
Toggles the Texture Image display.
|
|
imageNames(imn)
|
boolean
|
|
|
List image names for all Texture Images available for display,
if any.
|
|
imageNumber(imageNumber)
|
int
|
|
|
Sets the number of Texture Images to display.
This depends on the number of textures corresponding to
the current selection. If there are N textures, then the
possible Texture Image numbers are 0 to N-1.
|
|
imagePixelSnap(ip)
|
boolean
|
|
|
Sets a mode so that UV transformations in
the UV Texture Editor will cause UV values to snap
to image pixel corners. Which pixels are used depends on whether
a Texture Image or an Editor Image is being displayed. If both
are displayed, the Texture Image pixels will be used.
|
|
imageRatio(imr)
|
boolean
|
|
|
Sets the window to draw using the Texture Image's height versus
width ratio. If the width is greater than the height,
then the width is set to be 1 "unit" in the window,
and the height is adjusted by width divided by height. This
only affects the display of a Texture Image, not an Editor Image.
|
|
imageRatioValue(irv)
|
float
|
|
|
Query current image ratio value in UV Editor.
|
|
imageSize(imageSize)
|
boolean
|
|
|
Returns the size of the Texture Image currently being displayed.
The values returned are width followed by height.
Image size can only be queried.
|
|
imageTileRange(itr)
|
[float, float, float, float]
|
|
|
Sets the UV range of the display. The 4 values specify the
minimum U, V and maximum U, V in that order. When viewing a texture
image, these values affect how many times the image is tiled based on
appropriate parameters (e.g. Repeat UV, Mirror, Wrap, etc...)
When viewing an Editor Image these values determine the visible size
of the image. For example, setting the range to ( 0, 0, 2, 1 ) will
cause the Editor Image to be loaded into a 2x1 rectangle, distorting
it as necessary to fill the available space.
|
|
imageUnfiltered(iuf)
|
boolean
|
|
|
Sets the Texture Image to draw unfiltered. The image will
appear "pixelated" when the display resolution is higher than the
resolution of the image.
|
|
internalFaces(internalFaces)
|
boolean
|
|
|
Display contained faces by the selected components.
|
|
labelPosition(lp)
|
string
|
|
|
The position of the grid's numeric labels. Valid values are
"axis" and "edge".
|
|
loadImage(li)
|
string
|
|
|
load an image from disk and set it as the current Editor Image
|
|
lockMainConnection(lck)
|
boolean
|
|
|
Locks the current list of objects within the mainConnection,
so that only those objects are displayed within the editor.
Further changes to the original mainConnection are ignored.
|
|
mainListConnection(mlc)
|
string
|
|
|
Specifies the name of a selectionConnection object that the
editor will use as its source of content. The editor will
only display items contained in the selectionConnection object.
|
|
maxResolution(mrs)
|
int
|
|
|
This flag will set the current cached texture's maximum resolution.
|
|
multiColorAlpha(mca)
|
float
|
|
|
Sets the multi-color alpha of shaded UVs.
|
|
nbImages(nim)
|
boolean
|
|
|
returns the number of images
|
|
nextView(nv)
|
boolean
|
|
|
Switches to the next view.
|
|
numUvSets(nuv)
|
boolean
|
|
|
This flag will return the number of UV sets for selected
objects in the texture window.
|
|
numberOfImages(ni)
|
int
|
|
|
The number of Texture Images currently available.
for display.
|
|
numberOfTextures(nt)
|
int
|
|
|
The number of textures currently available.
for display.
|
|
panel(pnl)
|
string
|
|
|
Specifies the panel for this editor. By default if
an editor is created in the create callback of a scripted panel it
will belong to that panel. If an editor does not belong to a panel
it will be deleted when the window that it is in is deleted.
|
|
parent(p)
|
string
|
|
|
Specifies the parent layout for this editor. This flag will only
have an effect if the editor is currently un-parented.
|
|
previousView(pv)
|
boolean
|
|
|
Switches to the previous view.
|
|
realSize(rs)
|
boolean
|
|
|
This will display the image with the size of the
internal buffer. Note: This argument no long has
any affect on image display.
|
|
refresh(ref)
|
boolean
|
|
|
requests a refresh of the current Editor Image.
|
|
relatedFaces(rf)
|
boolean
|
|
|
Display connected faces by the selected components.
|
|
removeAllImages(ra)
|
boolean
|
|
|
remove all the Editor Images from the Editor Image Stack
|
|
removeImage(ri)
|
boolean
|
|
|
remove the current Editor Image from the Editor Image Stack
|
|
rendererString(rds)
|
string
|
|
|
Set or query the string describing the current renderer.
|
|
reset(r)
|
boolean
|
|
|
Resets the ground plane to its default values.
|
|
saveImage(si)
|
boolean
|
|
|
save the current Editor Image to memory. Saved Editor Images are
stored in an Editor Image Stack. The most recently saved image is stored in
position 0, the second most recently saved image in position 1,
and so on... To set the current Editor Image to a previously saved
image use the "di/displayImage" flag.
|
|
scaleBlue(sb)
|
float
|
|
|
Define the scaling factor for the blue component
in the View. The default value is 1 and can be
between -1000 to +1000
|
|
scaleGreen(sg)
|
float
|
|
|
Define the scaling factor for the green component
in the View. The default value is 1 and can be
between -1000 to +1000
|
|
scaleRed(sr)
|
float
|
|
|
Define the scaling factor for the red component
in the View. The default value is 1 and can be
between -1000 to +1000
|
|
selectInternalFaces(sif)
|
boolean
|
|
|
Add to selectionList the faces which are contained by
(internal to) selected components.
|
|
selectRelatedFaces(srf)
|
boolean
|
|
|
Add to selectionList the faces which are connected to
(non-internally related to) selected components.
|
|
selectionConnection(slc)
|
string
|
|
|
Specifies the name of a selectionConnection object that the
editor will synchronize with its own selection list. As the user
selects things in this editor, they will be selected in the
selectionConnection object. If the object undergoes changes, the
editor updates to show the changes.
|
|
setUvSet(suv)
|
int
|
|
|
This flag will set the current UV set on one given
selected object within the texture window.
|
|
singleBuffer(sbf)
|
boolean
|
|
|
Set the display in single buffer mode
|
|
size(s)
|
float
|
|
|
Sets the size of the grid.
|
|
solidMap3dView(s3d)
|
boolean
|
|
|
Display a solid overlay for the active texture map in 3D viewport.
|
|
solidMapColorSeed(scs)
|
int
|
|
|
Sets the multi-color seed of shaded UVs.
|
|
solidMapPerShell(sps)
|
boolean
|
|
|
Display a solid overlay with a random color per shell.
|
|
spacing(sp)
|
float
|
|
|
Sets the spacing between main grid lines.
|
|
stateString(sts)
|
boolean
|
|
|
Query only flag. Returns the MEL command that will create an
editor to match the current editor state. The returned command string
uses the string variable $editorName in place of a specific name.
|
|
style(st)
|
int
|
|
|
This flag is obsolete and should not be used.
|
|
subdivisionLinesColor(sdc)
|
[float, float, float]
|
|
|
The color of subdivision lines, default is 0.25 0.25 0.25
|
|
textureBorder3dView(t3d)
|
boolean
|
|
|
Toggles the texture borders display in 3d viewport.
|
|
textureBorderColor(tbc)
|
[float, float, float]
|
|
|
Sets the display color of texture border.
|
|
textureBorderWidth(tbw)
|
int
|
|
|
Set the display edge width of texture border.
|
|
textureNames(txn)
|
boolean
|
|
|
Texture names for all Texture Images available for display,
if any.
|
|
textureNumber(tn)
|
int
|
|
|
Sets the number of textures to display
This depends on the number of textures corresponding to
the current selection. If there are N textures, then the
possible Texture Image numbers are 0 to N-1.
|
|
tileLabels(tlb)
|
boolean
|
|
|
Toggles the texture tile label display.
|
|
tileLinesColor(tlc)
|
[float, float, float]
|
|
|
The color of tile lines, default is 0.0 0.0 0.0
|
|
toggle(tgl)
|
boolean
|
|
|
Toggles the ground plane display.
|
|
toggleExposure(tge)
|
boolean
|
|
|
Toggles between the current and the default exposure value of the editor.
|
|
toggleGamma(tgg)
|
boolean
|
|
|
Toggles between the current and the default gamma value of the editor.
|
|
unParent(up)
|
boolean
|
|
|
Specifies that the editor should be removed from its layout.
This cannot be used in query mode.
|
|
unlockMainConnection(ulk)
|
boolean
|
|
|
Unlocks the mainConnection, effectively restoring the original
mainConnection (if it is still available), and dynamic updates.
|
|
updateMainConnection(upd)
|
boolean
|
|
|
Causes a locked mainConnection to be updated from the orginal
mainConnection, but preserves the lock state.
|
|
useFaceGroup(uf)
|
boolean
|
|
|
Display faces that are associated with the groupId
that is set on the mesh node that is drawn.
(The attribute "displayFacesWithGroupId")
|
|
useTemplate(ut)
|
string
|
|
|
Forces the command to use a command template other than
the current one.
|
|
usedPercentageHUDRange(upr)
|
[float, float, float, float]
|
|
|
Sets the range when calculating used UV space percentage. The 4 values specify the minimum U, V and maximum U, V in that order., default is 0 0 1 1.
|
|
uvSets(uvs)
|
boolean
|
|
|
This flag will return strings containing
UV set and object name pairs for selected
objects in the texture window. The syntax of
each pair is "objectName | uvSetName", where |
is a literal character.
|
|
viewPortImage(vpi)
|
boolean
|
|
|
Toggles the view port/ caching Texture Images.
|
|
viewTransformName(vtn)
|
string
|
|
|
Sets the view pipeline to be applied if color management is enabled in the
current editor.
|
|
wireframeComponentColor(wcc)
|
[float, float, float, float]
|
|
|
Sets or queries the RGBA component wireframe color.
|
|
wireframeObjectColor(woc)
|
[float, float, float, float]
|
|
|
Sets or queries the RGBA object wireframe color.
|
|
writeImage(wi)
|
string
|
|
|
write the current Editor Image to disk
|
|
Flag can have multiple arguments, passed either as a tuple or a list.