|
. |
VS3D File Menu
1.1.2 Import.
"File / Import => VS3D Raw Binary (.vsb)..." : This will load or merge a ".vsb" relief sculpture surface. After selecting a file, the "Import VS3D Raw Relief surface" dialog will appear. This dialog has three settings.
-
"Insert Relief on Layer" : Select the layer (1, 2, or 3) on which to place the imported surface heights.
-
"Insert Mode" : "Load" - erase existing surface and reset the data coordinate scales.
"Overwrite" - overwrite the existing surface where it is covered by the XY extents (in data coordinates) of the imported surface. The data coordinate scales are unchanged.
"Merge" - add the imported surface heights to the existing surface heights in the overlap area.
-
"Data Sampling %" : This determines the sampling rate for the imported data before it is loaded/overwritten/merged. Normally, this should be set to 100%. A sampling rate of 50% will skip every other grid point in the imported surface. In cases where the imported surface grid is very large, it may be beneficial to sub-sample the imported data.
The ".vsb" files do not contain a region in addition to a surface, but they can be loaded directly as a region via the "File / Region => Import => VS3D Raw Binary (.vsb)..." menu.
The ".vsb" file format is as follows:
First 4 bytes: File ID - must have the byte values 86,83,51,68 - the ASCII characters "VS3D".
Next 60 bytes: Header - ignored.
Next 4 bytes: A long integer specifying the X dimension of the surface grid in grid points ("X_Grid").
Next 4 bytes: A long integer specifying the Y dimension of the surface grid in grid points ("Y_Grid").
Next 4 bytes: A floating-point number specifying the minimum X data coordinate value.
Next 4 bytes: A floating-point number specifying the maximum X data coordinate value.
Next 4 bytes: A floating-point number specifying the minimum Y data coordinate value.
Next 4 bytes: A floating-point number specifying the maximum Y data coordinate value.
Remaining Bytes: Floating-point Z height values. There must be X_Grid * Y_Grid values (4 bytes per value).
The values are arranged such that the lower left grid point is first, followed by the remaining values on the bottom row.
The second row from the bottom follows that. The upper right point in the grid is last.
|