Skip to content

dev'http_api'reference'GeoObject.SetVertexColor

Usagi Ito edited this page Nov 15, 2017 · 1 revision

GeoObject.SetVertexColor

GeoObject にグローバルアドレスモードで頂点色を設定します。

Params

Pattern 1: 完全な頂点色群全体を与える場合(主に新規転送時に使用)

{ "id": <number>
, "vertexcolors":
  [ <number;unorm-r>
  , <number;unorm-g>
  , <number;unorm-b>
  , <number;unorm-a>
  ] // 頂点色1つあたりの r-g-b-a を単位として頂点色の数だけ1つの配列に展開して渡す
}

Pattern 2: 部分的な連続した頂点色群を与える場合(主に部分更新時に使用)

{ "id": <number>
, "auto_resize": <bool>
, "begin_index": <number>
, "vertexcolors":
  [ <number;unorm-r>
  , <number;unorm-g>
  , <number;unorm-b>
  , <number;unorm-a>
  ] // 頂点色1つあたりの r-g-b-a を単位として頂点色の数だけ1つの配列に展開して渡す
}

Pattern 3: 部分的な不連続の頂点色群を与える場合(主に部分更新時に使用)

{ "id": <number>
, "auto_resize": <bool>
, "vertexcolors":
  { <string;index>:
    [ <number;unorm-r>
    , <number;unorm-g>
    , <number;unorm-b>
    , <number;unorm-a>
    ] // 頂点色1つ分の r-g-b-a を渡す
  } // index を key とし、頂点色の構成要素を array で value とした object として渡す 
}

Pattern 4: 1つだけ与える場合(主に1点だけの更新時に使用)

{ "id": <number>
, "auto_resize": <bool>
, "index": <number>
, "vertexcolor":
  [ <number;unorm-r>
  , <number;unorm-g>
  , <number;unorm-b>
  , <number;unorm-a>
  ] // 頂点色1つ分の r-g-b-a を渡す
}
  • 頂点色の要素、頂点色を1つの配列に展開するデータ記述方式の扱いに十分に注意して下さい。この方法はデータ転送上とパースコストの都合から最適なパフォーマンスを得るための仕様です。
  • auto_reizetrue の場合、既存のデータに対して与えるデータのインデックスがはみ出す場合には自動的にデータの保持数をリサイズします。 false の場合に範囲外のインデックスへの書き込みを試みた場合はエラーが発行されます。

Result

なし

Error

Clone this wiki locally
You can’t perform that action at this time.