ST_Raster

Определение

ST_Raster создает объект с типом ST_Raster.

Синтаксис

Oracle

sde.st_raster (filename IN VARCHAR2)

sde.st_raster (filename IN VARCHAR2, 
               options IN VARCHAR2)

sde.st_raster (data IN ST_PIXELDATA)

sde.st_raster (data IN ST_PIXELDATA, 
               options IN VARCHAR2)

PostgreSQL

st_raster (filename IN TEXT)

st_raster (filename IN TEXT, 
           options IN TEXT)

st_raster (data IN ST_PIXELDATA)

st_raster (data IN ST_PIXELDATA, 
           options IN TEXT)

SQL Server

st_raster (filename IN NVARCHAR, 
           data IN ST_PIXELDATA, 
           options IN NVARCHAR)

Параметры

Параметр	Описание
имя файла	Имя исходных растровых данных
data	Предварительно определенный объект ST_PixelData
options	Список с разделителем запятая, заключенный в одинарные кавычки, который может включать следующее: align—Автоматически сдвигает исходные пикселы, при этом максимальный сдвиг равен половине ширины или высоты ячейки пиксела, чтобы соответствовать выравниванию ячейки растра ST_Raster; по умолчанию установлено не сдвигать данные и вернуть ошибку, если они не выровнены. compression <lz77 | jpeg | jp2>—Алгоритм сжатия, который будет применен к объекту ST_Raster; по умолчанию установлено не применять сжатие к данным. interleave <separate | contiguous>—Данная опция применяется к объектам ST_Raster, которые будут хранить трехканальные 8-битные данные пикселов. Указание последовательного чередования показывает, что данные пикселов будут храниться в отдельных каналах RGB, в то время как установка непрерывного чередования показывает, что данные пикселов будут храниться в одиночном канале из непрерывных серий красных, зеленых и голубых пикселов. recursive—Предписывает конструктору выполнить поиск в папке, указанной в параметре filename и в любых вложенных папках, всех файлов изображений, имена которых удовлетворяют критерию поиска. conversion <rgb | grayscale>—Если установлено на rgb, параметр преобразования предписывает конструктору конвертировать одноканальные входные изображения с цветовой картой в трехканальный RGB объект ST_Raster. Если параметр преобразования установлен на grayscale (оттенки серого), то конструктор должен конвертировать 1-битные черно-белые входные изображения в 8-битный объект ST_Raster в оттенках серого. quality <value>—Качество сжатия опции ST_Raster для переменного сжатия JPEG или JPEG 2000 bitrate <value>—Битовая скорость передачи данных для сжатия JPEG 2000 nodata <(r,g,b) | value>—Значения пикселов входного изображения, которые будут сконвертированы в значение nodata в процессе добавления в объект ST_Raster nocolormap—Показывает, что цветовая карта будет удалена из входного изображения с цветовой картой при добавлении его в объект ST_Raster edge <value>:<tolerance>—Удаляет ненужные пикселы границы вокруг ST_Raster, отмеченные как NoData; edge показывает, что только пикселы заданного диапазона значений будут удалены, и только из внешней границы растра. Это предотвращает удаление пикселов внутри растра, имеющих то же значение. level=<pyramid level>—Максимальный уровень пирамидного слоя, который будет создан после добавления изображения в ST_Raster origin (x,y)—Оригинал привязки пирамидных слоев объекта ST_Raster skipLevel1—Показывает, что первый уровень пирамидного слоя объекта ST_Raster не создан tile (width,height)—Ширина и высота хранилища листов для ST_Raster nearest | bilinear | bicubic—Алгоритм интерполяции, который будет использован для создания пирамидных слоев объекта ST_Raster log <logfile name>—Файл журнала, в который конструктор будет записывать результаты.

Примеры

Oracle

Данный пример добавляет файл изображения GeoTIFF в объект ST_Raster, явным образом вызывая конструктор ST_Raster.

INSERT INTO NOVA (image)
 VALUES (sde.st_raster('nova.tif','compression=lz77'));

Данный пример копирует значения объекта ST_Raster из входной таблицы world в целевую таблицу nova. В этом случае конструктор ST_Raster вызывается явным образом через выражение INSERT, чтобы создать объекты ST_Raster в целевой таблице.

INSERT INTO NOVA (image)
SELECT image 
FROM WORLD;

В данном примере объект ST_PixelData заполняется пикселами из объекта ST_Raster и затем вставляется в другой объект ST_Raster.

DECLARE
  	  data sde.ST_PixelData;
BEGIN
  	  SELECT t.image.getPixelData('level=1') INTO DATA FROM NOVA t;
  	  INSERT INTO NOVA VALUES (sde.st_raster(data, 'compression=lz77'));
     END; 
     /

PostgreSQL

Данный пример добавляет файл изображения GeoTIFF в объект ST_Raster, явным образом вызывая конструктор ST_Raster.

INSERT INTO nova (image)
VALUES (sde.st_raster('nova.tif','compression=lz77'));

Данный пример копирует значения объекта ST_Raster из входной таблицы world в целевую таблицу nova. В этом случае конструктор ST_Raster вызывается явным образом через выражение INSERT, чтобы создать объекты ST_Raster в целевой таблице.

INSERT INTO nova (image)
SELECT image 
FROM world;

В данном примере объект ST_PixelData заполняется пикселами из объекта ST_Raster и затем вставляется в другой объект ST_Raster.

DECLARE data st_pixeldata; 
BEGIN 
		SELECT getPixelData(image, 'level=1') 
  INTO data 
  FROM nova; 
  INSERT into nova 
  VALUES (sde.st_raster(data,''compression=lz77'')); 
END;

SQL Server

Данный пример добавляет файл изображения GeoTIFF в объект ST_Raster, явным образом вызывая конструктор ST_Raster.

INSERT INTO nova (image)
 VALUES (ST_Raster::construct('nova.tif',NULL,'compression=lz77'));

Данный пример копирует значения объекта ST_Raster из входной таблицы world в целевую таблицу nova. В этом случае конструктор ST_Raster вызывается явным образом через выражение INSERT, чтобы создать объекты ST_Raster в целевой таблице.

INSERT INTO nova (image)
SELECT image 
FROM world;

В данном примере объект ST_PixelData заполняется пикселами из объекта ST_Raster и затем вставляется в другой объект ST_Raster.

DECLARE
@data ST_Pixeldata;
SET @data =
(SELECT image.getPixelData('level=1')
 FROM nova);
 INSERT INTO nova
 
VALUES (ST_Raster::construct(NULL, @data, 'compression=lz77')) ;