Class TAbstractTexture2DNode

This item has no description. Showing description inherited from TX3DNode.Create.

Constructor. Initializes various properties:

• Name, BaseUrl are initialized from given parameters.

• The Fields, Events lists are filled in every descendant, to have all the fields/events defined by the specification.

• DefaultContainerField, and other node-specific stuff, is filled in descendants. This is actually implemented in CreateNode, that is called at the end of this constructor.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 249).

This item has no description.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 250).

TextureImage, TextureComposite and TextureVideo contain actual texture data. TextureImage may come from inline VRML texture or could be loaded from file (including from some URL), this doesn't concern you here.

Calls to TextureImage, TextureVideo, IsTextureImage, IsTextureVideo, TextureComposite will automatically load the data, so in simple situations you really don't need to do anything. Just check and use them when you want, and things will just work. See IsTextureLoaded for more control about loading / unloading.

Note that either one of TextureImage or TextureVideo may be Nil, if the other one is loaded. Or when loading failed (warning will be reported by WritelnWarning). IsTextureImage checks that TextureImage is non-nil (so it's successfully loaded) and additionally that texture size is not zero. Similar for IsTextureVideo.

Note that when image failed to load, or URL was just empty, we can have IsTextureLoaded = True but both IsTextureImage = False and IsTextureVideo = False.

TextureImage may have any class allowed by LoadTextureImage.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 277).

This item has no description.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 278).

This item has no description.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 279).

This item has no description.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 280).

This item has no description.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 281).

Create node fields and events.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 35).

This item has no description. Showing description inherited from TX3DNode.ClassX3DType.

Node type name in VRML/X3D, for this class. Normal VRML/X3D node classes should override this to return something non-empty, and then X3DType automatically will return the same value.

Empty for classes that don't have a hardcoded VRML/X3D node name, like a special TX3DUnknownNode. Such special classes should override then X3DType to return actual non-empty name there.

You usually should call X3DType. The only use of this method is that it works on classes (it's "class function"), without needing at actual instance.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 36).

Is the texture data already loaded. Since the texture will be loaded automatically, you're usually not interested in this property. You can read it to e.g. predict if next TextureImage / TextureVideo call may take a long time. (You know that if IsTextureLoaded = True then TextureImage just returns ready image instantly).

You can also set IsTextureLoaded. Setting to True means that you request the texture to be loaded now, if it's not loaded already. Setting to False may be useful if you want to release resources (e.g. when you want to keep TTextureNode instance loaded but you know that you will not need TextureImage / TextureComposite / TextureVideo anymore). You can also set it to False and then back to True if you want to request reloading the texture from URL (e.g. if you suspect that the URL contents changed).

Note that IsTextureLoaded is set to True, even if actual loading failed. You still have to check afterwards IsTextureImage and IsTextureVideo to know if loading was actually successful. This is deliberate — it means that each call to TextureImage etc. will not unnecessarily read the disk (or even connect to internet) when the file does not exist. Also, the loading errors reported by WritelnWarning will not be repeated — they will occur only once, when IsTextureLoaded changes from False to True.

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 309).

From which URL did we load the texture data, if any.

Once the texture data (image or video) is successfully loaded from some URL, this property is updated to this URL.

When this property is empty then we didn't yet attempt to load (e.g. IsTextureLoaded = False) or no good URL (that we can successfully load) was specified.

This is always a full, expanded (i.e. not relative) URL. It case of data: URI to embed data, this property contains the original data: URI. This is important, it allows to use this property e.g. to determine should we use some cached resource (TImageTextureResource.PrepareCore).

When displaying this property to the user, remember to process this with UriDisplay, to avoid displaying very long URLs in such cases. Do it like this:

WritelnLog('Loaded from %s', [UriDisplay(MyImageTextureNode.TextureUsedFullUrl)]);

Source: scene/x3d/x3dnodes_standard_texturing.inc (line 335).

Internal wrapper for property RepeatS. This wrapper API may change, we advise to access simpler RepeatS instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 40).

This item has no description.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 42).

Internal wrapper for property RepeatT. This wrapper API may change, we advise to access simpler RepeatT instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 46).

This item has no description.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 48).

Internal wrapper for property TextureProperties. This wrapper API may change, we advise to access simpler TextureProperties instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 52).

This item has no description.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dtexture2dnode.inc (line 54).