This method returns the side texture set for the specified face segment, and relevant parameters.
HRESULT GetSideTexture(
[in] int SegmentNum,
[out] VARIANT* bstrFileName,
[out] VARIANT* enumTilingMethod,
[out] VARIANT* doubleScaleX,
[out] VARIANT* doubleScaleY)
Parameters:
SegmentNum – The number of the segment. The number of segments is a value between 0, for the first wall, and ITerrainBuilding5::NumOfVertices –1, for the last wall.
bstrFileName – A full pathname or a URL to the texture image file.
enumTilingMethod – An enum determining the tiling method used for the side textures. The TextureTilingMethod enum can use any of the following values:
TM_TILES_PER_AXIS = 0
TM_METERS_PER_TILE = 1
doubleScaleX – If Tiling Method is Tiles per Side – returns the number of repetitions, for each side, of the image file in the X-axis. If Tiling Method is Meters per Tile – returns the size of the side texture in the X-axis.
doubleScaleY – If Tiling Method is Tiles per Side – returns the number of repetitions, for each side, of the image file in the Y-axis. If Tiling Method is Meters per Tile – returns the size of the side texture in the Y-axis.
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
Return value |
Meaning |
S_OK |
Success. |
E_FAIL |
Catastrophic failure. |