Глава 10.4. Вспомогательные элементы

Описанные в этой главе элементы VML употребляются внутри элементов shape, shapetype и графических примитивов и определяют их графическое содержимое.

10.4.1. Форма фигуры: элемент path

Синтаксис: <v:path>…</v:path>
Атрибуты:  id
           arrowok = boolean (вывод стрелок)
           fillok = boolean (заливка фигуры)
           gradientshapeok = boolean (градиентная заливка)
           limo = vector2d (точка вытягивания фигуры)
           shadowok = boolean (вывод тени)
           strokeok = boolean (вывод рамки)
           textboxrect = string (текстовый прямоугольник)
           textpathok = boolean (вывод текста)
           v = string (форма фигуры)

Элемент path может употребляться в элементах shape и shapetype для задания формы фигуры. Форма фигуры задается атрибутом v, который эквивалентен атрибуту path базовых элементов. Этот атрибут является строкой, содержащей следующие команды движения пера по экрану (cpx и cpy обозначают координаты текущей точки):

Параметры могут отделяться пробелами или запятыми. Пример:

<v:shape coordorigin="0 0" coordsize="200 200"  fillcolor="green"
  strokecolor="red" style='position:relative; left:3em; top:0; width:50; height:50'>
  <v:path v="m 1,1 l 1,200, 200,200, 200,1 x e"/>
</v:shape>

Опишем назначение остальных атрибутов.

• Если arrowok равно true и рамка имеет стрелки, то стрелки будут рисоваться. Этот атрибут перекрывает все атрибуты, связанные со стрелками, в родительском элементе и элементе stroke. По умолчанию он равен false. Пример:

<v:line from="40 0" to="200 0" strokecolor="black">
  <v:stroke startarrow="block" endarrow="block"/>
  <v:path arrowok="true"/>
</v:line>

• Если fillok равно false, то заливка фигуры не производится. Этот атрибут перекрывает все атрибуты, связанные с заливкой, в родительском элементе и элементе fill. По умолчанию он равен true.
• Если gradientshapeok равно true, то производится концентрическая градиентная заливка фигуры. По умолчанию этот атрибут равен false. Он имеет смысл только для элемента fill, имеющего type, равный gradientradial. Пример:

<v:rect strokecolor="red"
  style='position:relative; top:0; left:3em; width:50; height:50'>
  <v:fill type="gradientradial" color="blue" color2="yellow"/>
  <v:path gradientshapeok="true"/>
</v:rect>

• Атрибут limo определяет точку вытягивания на границе фигуры; по умолчанию он равен (0, 0). Точка вытягивания указывает, где и как пользователь может вытягивать фигуру в графическом редакторе.
• Если shadowok равно true и фигура имеет тень, то тень выводится. Этот атрибут перекрывает все атрибуты, связанные с тенью, в родительском элементе и элементе shadow. По умолчанию он равен true. Пример:

<v:rect strokecolor="red" fillcolor="green"
  style='position:relative; top:0; left:3em; width:50; height:50'>
 ═<v:shadow on="true" offset="5pt,5pt" color="blue"/>
 ═<v:path shadowok="true"/>
 </v:rect>

═
• Если strokeok равно true, то будет рисоваться рамка фигуры. Этот атрибут перекрывает все атрибуты, связанные с рамкой, в родительском элементе и элементе stroke. По умолчанию он равен true.
• Атрибут textboxrect определяет текстовые прямоугольники для использования элементом textbox. Каждый прямоугольник задается четырьмя координатами; определения прямоугольников разделяются точкой с запятой.

<v:shape strokecolor="red" coordorigin="0 0" coordsize="200 200"
  style='position:relative; top:0; left:3em; width:50; height:50'>
  <v:path v="m 1,1 l 1,200, 200,200, 200,1 x e" textboxrect="10 70 190 190"/>
  <v:textbox>VML</v:textbox>
</v:shape>

VML
• Если textpathok равно true и родительский элемент содержит textpath, то он будет рисоваться. По умолчанию этот атрибут равен false.

10.4.2. Формулы: элемент formulas

Синтаксис: <v:formulas>…</v:formulas>

Элемент formulas может употребляться в элементах shape и shapetype для задания формул. Он не имеет атрибутов и состоит из набора подэлементов вида <v:f eqn="operation v p1 p2"/>. Каждый такой подэлемент задает одну формулу, которая состоит из названия операции и аргументов (от 1 до 3), которые принято обозначать v, p1 и p2.

Результатом вычисления формулы всегда является 32-битовое целое число. Аргументами формул могут быть либо целые числа в диапазоне от 0 до 65535 (т. е. беззнаковые 16-битовые числа), либо результаты предыдущих формул, либо выравнивающие значения, заданные в атрибуте adj элемента shape, либо предопределенные константы. Синтаксис аргументов следует следующим правилам:

Здесь EMU (English Metrical Unit) — наименьшая единица измерения, используемая в VML для внутреннего хранения данных. Она определяется так: 1 сантиметр = 360000 EMU.

Пример использования формул:

<v:shape style='position:relative; top:0; left:3em; width:1in; height:1in'
  strokecolor="red" strokeweight="2pt" coordsize="21600,21600" adj="17520"
  path="m 10800,0 qx 0,10800, 10800,21600, 21600,10800, 10800,0 x e
        m 7340,6445 qx 6215,7570, 7340,8695, 8465,7570, 7340,6445 x nf e
        m 14260,6445 qx 13135,7570, 14260,8695, 15385,7570, 14260,6445 x nf e
        m 4960,@0 c 8853,@3, 12747,@3, 16640,@0 nf e">
  <v:formulas>
    <v:f eqn="sum 33030 0 #0"/>
    <v:f eqn="prod #0 4 3"/>
    <v:f eqn="prod @0 1 3"/>
    <v:f eqn="sum @1 0 @2"/>
  </v:formulas>
</v:shape>

10.4.3. Настройки: элемент handles

Синтаксис: <v:handles>…</v:handles>

Элемент handles может употребляться в элементах shape и shapetype для задания пользовательских настроек. Точнее говоря, он позволяет определить несколько участков фигуры, за которые пользователь может потянуть в графическом редакторе, чтобы изменить значения атрибута adj. Этот элемент не имеет атрибутов и состоит из набора подэлементов h (от одного до четырех), каждый из которых описывает один участок настройки.

Синтаксис: <v:h/>
Атрибуты:  invx = boolean (инвертировать абсциссу)
           invy = boolean (инвертировать ординату)
           map = vector2d (область отображения)
           polar = vector2d (центр полярных координат)
           position = vector2d (координаты настройки)
           radiusrange = vector2d (диапазон полярного радиуса)
           switch = boolean (обмен координат)
           xrange = vector2d (диапазон абсцисс)
           yrange = vector2d (диапазон ординат)

Опишем подробно назначение этих атрибутов.

Пример использования настроек:

<v:shape style='position:relative; top:0; left:3em; width:90pt; height:54pt'
  strokecolor="red" strokeweight="2pt" coordsize="21600,21600" adj="16200,5400"
  path="m @0,0 l @0,@1, 0,@1, 0,@2, @0,@2, @0,21600, 21600,10800 x e">
  <v:formulas>
     <v:f eqn="val #0"/>
     <v:f eqn="val #1"/>
     <v:f eqn="sum height 0 #1"/>
     <v:f eqn="sum 10800 0 #1"/>
     <v:f eqn="sum width 0 #0"/>
     <v:f eqn="prod @4 @3 10800"/>
     <v:f eqn="sum width 0 @5"/>
   </v:formulas>
   <v:handles>
     <v:h position="#0,#1" xrange="0,21600" yrange="0,10800"/>
   </v:handles>
</v:shape>

10.4.4. Заливка фигуры: элемент fill

Синтаксис: <v:fill>…</v:fill>
Атрибуты:  id
           alignshape = boolean (выравнивание заливки)
           angle = number (угол градиентной заливки)
           aspect = string (сохранение пропорций)
           color = цвет (цвет заливки)
           color2 = цвет (второй цвет заливки)
           colors = string (массив цветов для градиентной заливки)
           focus = number (центр линейной градиентной заливки)
           focusposition = vector2d (центр радиальной градиентной заливки)
           focussize = vector2d (размер фокуса радиальной градиентной заливки)
           method = string (метод градиентной заливки)
           on = boolean (вывод заливки)
           opacity = number (прозрачность цвета заливки)
           origin = vector2d (центр образа заливки)
           position = vector2d (позиция образа заливки)
           size = vector2d (размер образа заливки)
           src = string (гиперссылка на графический файл)
           type = string (тип заливки)

Элемент fill может употребляться в элементах shape, shapetype, background и большинстве графических примитивов для задания заливки фигуры. Тип заливки задается атрибутом type, который может принимать следующие значения:

Все типы заливки делятся на три группы: сплошная заливка (solid), градиентная заливка (gradient и gradientradial) и заливка изображением (tile, pattern и frame). Атрибуты, определяющие заливку, соответственно можно также разбить на три группы: общие для всех типов, относящиеся к градиентной заливке и относящиеся к заливке изображением.

Общими атрибутами являются:

Атрибуты градиентной заливки:

Атрибуты заливки изображением: