ST_Raster.buildPyramid

Определение

Функция ST_Raster.buildPyramid строит пирамидные слои для объекта ST_Raster. Эта функция предназначена для использования только в выражении UPDATE в SQL. При использовании в выражении SELECT будет возвращена ошибка базы данных.

Синтаксис

Oracle

buildPyramid () RETURN ST_RASTER

buildPyramid (parameter_list IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

buildPyramid (raster IN ST_Raster)

buildPyramid (raster IN ST_Raster, 
              parameter_list IN TEXT)

SQL Server

buildPyramid (parameter_list IN NVARCHAR)

Возвраты

ST_Raster

Параметры

parameter_list—Список параметров с разделителем запятая, заключенный в одинарные кавычки; если список параметров не предоставлен, уровень устанавливается равным 0 (удаляет любые существующие пирамидные слои). Список параметров может включать следующие параметры:

• level <value>—Верхний уровень пирамидного слоя, который будет построен; по умолчанию равен -1, что дает функции возможность автоматически определить максимальный уровень пирамидного слоя. Чтобы удалить пирамидный слой, установите этому параметру значение 0.
• skipLevel1—Указывает функции не хранить первый уровень пирамидного слоя
• nearest | bilinear | bicubic—Алгоритм интерполяции, используемый для построения пирамидного слоя; по умолчанию используется значение nearest
• quality <value>—Если типом сжатия (компрессии) базового слоя является JPEG или JPEG 2000, то качество сжатия пирамидных слоев контролируется установкой этого параметра. Значением по умолчанию для сжатия JPEG является 75, тогда как значением по умолчанию для сжатия JPEG 2000 является 0.
• bitrate <value>—Битовая скорость передачи данных для сжатия JPEG 2000
• log <logfile name>—Файл журнала, хранящий результаты выполнения функции buildPyramid.

Примеры

Эти примеры демонстрируют следующее:

1. Первый - это выражение, которое строит пирамидные слои для всех объектов ST_Raster для пользовательской таблицы с помощью билинейной интерполяции и опцией автоматического уровня пирамидного слоя, установленной по умолчанию.
2. Во втором примере растровые пирамидные слои для всех объектов ST_Raster в таблице nova удаляются путем установки уровня пирамидного слоя равным 0.
3. В последнем примере первый уровень пирамидного слоя не сохраняется; сохраняются только второй уровень и выше. Дополнительно, пирамидный слой создается с помощью билинейной интерполяции, а не установленной по умолчанию интерполяции по методу ближайшего соседа.

Oracle

• UPDATE NOVA n 
  SET image = n.image.buildPyramid('bilinear');
  

• UPDATE NOVA n 
  SET image = n.image.buildPyramid('level=0');
  

• UPDATE NOVA n
  SET image = n.image.buildPyramid('skipLevel1,bilinear');
  

PostgreSQL

• UPDATE nova 
  SET image = buildPyramid(image,'bilinear');
  

• UPDATE nova 
  SET image = buildPyramid(image,'level=0');
  

• UPDATE nova 
  SET image = buildPyramid(image,'skipLevel1,bilinear');
  

SQL Server

• UPDATE nova 
  SET image = image.buildPyramid('bilinear');
  

• UPDATE nova 
  SET image = image.buildPyramid('level=0');
  

• UPDATE nova 
  SET image = image.buildPyramid('skipLevel1,bilinear');