DK for .NET | TatukGIS.NDK.TGIS_LayerPixel.LockPixels | Overloads | Constructors | Fields | Methods | Properties | Events
Locks a fragment of the pixel layer for updating.
// C# public virtual TGIS_LayerPixelLock LockPixels( TGIS_Extent _ext, TGIS_CSCoordinateSystem _cs, double _pixelsize, int _band, bool _writable );
' VisualBasic Public Overridable Function LockPixels( ByVal _ext As TGIS_Extent, ByVal _cs As TGIS_CSCoordinateSystem, ByVal _pixelsize As Double, ByVal _band As Integer, ByVal _writable As Boolean ) As TGIS_LayerPixelLock
// Oxygene public function LockPixels( _ext : TGIS_Extent; _cs : TGIS_CSCoordinateSystem; _pixelsize : Double; _band : Integer; _writable : Boolean ) : TGIS_LayerPixelLock; virtual;
Name | Type | Description |
---|---|---|
_ext | TGIS_Extent | area to be locked; if bigger then layer extent then will be truncated to layer extent |
_cs | TGIS_CSCoordinateSystem | coordinate system of _cs; if nil then same as layer CS |
_pixelsize | double Double | minimum requested size of image pixel; by providing 0 a maximum possible resolution will be used, which is also a fastest method if a layer is full in-memory because in such situation a pointer to existing memory will be used |
_band | int Integer | specific band to be locked |
_writable | bool Boolean | if true than layer will post back any changes in locked area; if write is not possible then TGIS_LayerPixelLock.Writable will be set accordingly |
Type | Description |
---|---|
TGIS_LayerPixelLock | locked area |
Must be paired with UnlockPixels.
To speed-up operation, the function can return a larger area than requested. Use Bounds
property of result value to obtain actual scope.