PixelPyramidBuilder
Description
- Derived from
A builder for IPixelPyramid objects.
First, use these methods to configure the builder properties:
The, call one of these method to create a IPixelPyramid object:
Use IMapInfo.Map to obtain the MapInfo value that will be returned by the built IPixelPyramid, based on the current builder properties.
- See also
Public / Constructors
Constant
2 overloads
Creates a pixel pyramid of uniform color.
Creates a pixel pyramid with separate uniform colors for the cubemap-Y faces.
Usually, this method is used to create a pixel pyramid that fills holes at the North and South poles (e.g. Mercator voids).
Dataset
3 overloads
Creates a mutable pixel pyramid that is kept in the given *.PYR
file.
Storage space is only allocated for pyramid tiles that contain data (see IPyramidBase.HasTileData2). So storage space consumption does not depend on the pyramid size, but on the quantity of data that has been fed into it.
- IOException
-
If an I/O error has occurred.
Creates a mutable pixel pyramid that is kept in the given *.PYR
file.
Storage space is only allocated for pyramid tiles that contain data (see IPyramidBase.HasTileData2). So storage space consumption does not depend on the pyramid size, but on the quantity of data that has been fed into it.
- IOException
-
If an I/O error has occurred.
Creates a mutable pixel pyramid that is kept in the given *.PYR
file.
Storage space is only allocated for pyramid tiles that contain data (see IPyramidBase.HasTileData2). So storage space consumption does not depend on the pyramid size, but on the quantity of data that has been fed into it.
- IOException
-
If an I/O error has occurred.
Memory
Creates a mutable pixel pyramid dataset that is kept entirely in memory.
Memory is only allocated for tiles that contain data (see IPyramidBase.HasTileData2). So memory consumption does not depend on the pixel pyramid size, but on the quantity of data that has been fed into it.
Shapes
Creates a pixel pyramid that rasterizes vector shape layers.
This method calls GeorefDefault.
Public / Methods
FormatHint
Specifies a pixel format hint to use for encoding / decoding of pixel data.
The pixel format hint is interpreted as follows:
-
If the PixelFormat.Truecolor flag is not set:
Pixel data is treated as grayscale, instead of truecolor. -
If the PixelFormat.Alpha flag is not set:
Pixel data is treated as fully opaque. -
If the PixelFormat.SixteenBits flag is not set:
Pixel data is treated as 8-bit per component.
The default value is PixelFormat.Default.
FullSize
Specifies the full size of the pixel pyramid.
The default value is MappingUtil.MaxSize.
- See also
Georef
Specifies the geo-reference for the pixel pyramid.
This method will also set the map type via Type, according to Raster.RasterType of georef in, if not null
.
The cubemap size of the given raster transform (see IRasterTransform.Size of Raster.Transform of georef in) will be adjusted by this method and may thus have an arbitrary value.
The default value is null
.
- See also
GeorefDefault
Specifies a default geo-reference for the pixel pyramid, if necessary.
If no geo-reference raster has been specified (i.e. HasGeoref returns false
), a default raster will be chosen depending on the map type that has been chosen with Type:
To specify another geo-reference, use the Georef method, before calling this method.
Type
Specifies the map type of the pixel pyramid.
Setting a map type in that is inconsistent with Raster.RasterType of the current geo-reference (see Georef) will clear the current geo-reference to null
, i.e. HasGeoref will return false
.
The default value is MapType.Cube.
- See also