Reference API Roblox

Engine API

Website

Related

Reference API Roblox

Texture

A Texture object applies a repeating texture to the face of a BasePart.

Memory categoryGraphicsTexture

Member index 4

HistoryMember
553OffsetStudsU: float
553OffsetStudsV: float
553StudsPerTileU: float
553StudsPerTileV: float
inherited from Decal
553Color3: Color3
553Shiny: float
553Specular: float
645Texture: ContentId
553Transparency: float
553ZIndex: int
inherited from FaceInstance
553Face: NormalId
inherited from Instance
553Archivable: bool
635Capabilities: SecurityCapabilities
553Name: string
553Parent: Instance
635Sandboxed: bool
616UniqueId: UniqueId
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
641GetStyled(name: string): Variant
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
580IsPropertyModified(name: string): bool
573Remove(): null
576RemoveTag(tag: string): null
580ResetPropertyToDefault(name: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
648children(): Instances
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
648getChildren(): Instances
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
553childAdded(child: Instance)
inherited from Object
647ClassName: string
647className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
650isA(className: string): bool
647Changed(property: string)

Description

A Texture object applies a repeating texture to the face of a BasePart.

How does a Texture work?

A Texture will apply an image to the BasePart it is parented to. The surface this image is applied to is dependent on the FaceInstance.Face property. When the BasePart is resized, the image will repeat. The size of the repeating textures is determined by the Texture.StudsPerTileU and StudsPerTileV properties.

local texture = Instance.new("Texture")
texture.Texture = "http://www.roblox.com/asset/?id=732339893" -- roblox logo
-- 1x1 studs repeating texture
texture.StudsPerTileU = 1
texture.StudsPerTileV = 1

The image a Texture applies is determined by its Decal.Texture property. Images can be uploaded to Roblox provided they adhere to the community guidelines. For information on how to upload images, see Textures and Decals.

What is the difference between Textures and Decals?

The texture object is very similar to the Decal object. However, whereas the image applied by a Decal scales when the BasePart is resized, the image applied by a Texture repeats.

Repeating textures have a wide range of applications such as floor tiles and wall textures.

Alternatives to Textures

Although Decals have a wide variety of applications, in some cases developers may wish to pick one of the following classes instead.

  • For non repeating images Decal object should be used
  • To apply GUI elements, the SurfaceGui object should be used
  • If the effect of lighting on the image needs to be altered, the SurfaceGui object should be used

History 17

Members 4

OffsetStudsU

TypeDefault
float0

OffsetStudsU determines how far the rendered texture is offset on the horizontal axis in studs.

Example

In the screenshots above, a Part with a Texture is visible. On the left, OffsetStudsU/OffsetStudsV are both 0, so the rendered texture tiling aligns with the top-left corner of the part. On the right, both properties are set to 1 which causes the tiling to start in the center of the texture.

See also:

Thread safetyReadSafe
CategoryAppearance
Loaded/Savedtrue

History 4

OffsetStudsV

TypeDefault
float0

OffsetStudsV determines how far the rendered texture is offset on the vertical axis in studs.

Example

In the screenshots above, a Part with a Texture is visible. On the left, OffsetStudsU/OffsetStudsV are both 0, so the rendered texture tiling aligns with the top-left corner of the part. On the right, both properties are set to 1 which causes the tiling to start in the center of the texture.

See also:

Thread safetyReadSafe
CategoryAppearance
Loaded/Savedtrue

History 4

StudsPerTileU

TypeDefault
float2

Sets the horizontal size, in studs, of the tiled image applied by the Texture.

Larger values for this property will lead to the Texture appearing larger, and repeating less frequently. Unlike with Decals, the size of the repeated image is unaffected by the dimensions of the BasePart. Instead, resizing the BasePart only increases the number of times the texture repeats.

See the code snippet below for an example of how this property can be used.

local texture = Instance.new("Texture")
texture.Texture = "http://www.roblox.com/asset/?id=732339893" -- roblox logo
-- 1x1 studs repeating texture
texture.StudsPerTileU = 1
texture.StudsPerTileV = 1

Note:

  • This property can be set to very low values, but not zero
  • The horizontal / vertical distinction is relative to the BaseParts axis. Therefore, the Texture will rotate along with the BasePart.
Thread safetyReadSafe
CategoryAppearance
Loaded/Savedtrue

History 4

StudsPerTileV

TypeDefault
float2

Sets the vertical size, in studs, of the tiled image applied by the Texture.

Larger values for this property will lead to the Texture appearing larger, and repeating less frequently. Unlike with Decals, the size of the repeated image is unaffected by the dimensions of the BasePart. Instead, resizing the BasePart only increases the number of times the texture repeats.

See the code snippet below for an example of how this property can be used.

local texture = Instance.new("Texture")
texture.Texture = "http://www.roblox.com/asset/?id=732339893" -- roblox logo
-- 1x1 studs repeating texture
texture.StudsPerTileU = 1
texture.StudsPerTileV = 1

Note:

  • This property can be set to very low values, but not zero
  • The horizontal / vertical distinction is relative to the BaseParts axis. Therefore, the Texture will rotate along with the BasePart.
Thread safetyReadSafe
CategoryAppearance
Loaded/Savedtrue

History 4

Settings