[ブログに戻る](/ja/blog) # ラスター画像ファイルの操作

Andrew Markovich 2月 02, 2017 [\#Raster image](/ja/blog/tag/raster-image) [\#Example](/ja/blog/tag/example)

<a class="a2a_button_facebook"></a><a class="a2a_button_twitter"></a><a class="a2a_button_linkedin"></a>

よくある質問に「Teighaでラスター画像データを変更するにはどうすればよいですか？」というものがあります。開発者は、ラスター画像データゲッターのみを含むOdGiRasterImage APIにラスター画像編集機能がないことに戸惑うことがあります。この記事では、ラスター画像を読み込んだ後に変更する方法を示します。

### ファイルからラスター画像を読み込む

ファイルからラスター画像を読み込むために、TeighaはTeighaダイナミックリンカーを使用して実行時にアクセスできるラスターサービスモジュールを提供します。

```
<span class="hljs-title">OdRxRasterServicesPtr</span> pRasSvcs = <span class="hljs-keyword">odrxDynamicLinker</span>()-><span class="hljs-keyword">loadApp</span>(RX_RASTER_SERVICES_APPNAME, false);
if (pRasSvcs.<span class="hljs-keyword">isNull</span>()) // Check that raster services module correctly loaded
    throw <span class="hljs-keyword">OdError</span>(eNullPtr);
```

ダイナミックライブラリプロジェクト構成の場合、**「RxRasterServices.tx」**モジュールがアプリケーションディレクトリで利用可能である必要があります。スタティックライブラリプロジェクト構成の場合、アプリケーションは**「RxRasterServices」**スタティックライブラリとリンクする必要があり、ラスターサービスモジュールはTeighaスタティックモジュールマップに登録されている必要があります。

```
<span class="hljs-keyword">ODRX_DECLARE_STATIC_MODULE_ENTRY_POINT</span>(ExRasterModule);
<span class="hljs-keyword">ODRX_DECLARE_STATIC_MODULE_ENTRY_POINT</span>(OdRasterProcessingServicesImpl);

<span class="hljs-keyword">ODRX_BEGIN_STATIC_MODULE_MAP</span>()
    <span class="hljs-keyword">ODRX_DEFINE_STATIC_APPLICATION</span>(RX_RASTER_SERVICES_APPNAME,  ExRasterModule)
    <span class="hljs-keyword">ODRX_DEFINE_STATIC_APPLICATION</span>(OdRasterProcessorModuleName, OdRasterProcessingServicesImpl)
<span class="hljs-keyword">ODRX_END_STATIC_MODULE_MAP</span>()
```

この例では、ラスター画像の読み込みまたは保存中に必要となる可能性があるため、ラスター処理モジュールも登録しました。

ラスターサービスモジュールが正しく読み込まれた場合、単一の呼び出しでファイルからラスター画像を読み込むことができます。

```
<span class="hljs-title">OdGiRasterImagePtr</span> pInputImage = pRasSvcs-><span class="hljs-keyword">loadRasterImage</span>(inputFileName);
if (pInputImage.<span class="hljs-keyword">isNull</span>()) // Check that raster image correctly loaded
    throw <span class="hljs-keyword">OdError</span>(eNullPtr);
```

OdRxRasterServices::loadRasterImageメソッドは、ラスター画像形式を自動的に検出します。ラスター画像が正しく読み込まれた場合、ラスター画像スマートポインタはnull以外になり、それを使用してラスター画像のピクセルデータ、形式、パレット、その他のプロパティにアクセスできます。

### ファイルにラスター画像を保存する

ラスターサービスモジュールは、ラスター画像を保存するためにも使用できます。この例では、出力ファイル名拡張子からラスター画像の保存形式を検出する最も簡単な方法を使用します。

```
bool bSaveState = pRasSvcs-><span class="hljs-keyword">saveRasterImage</span>(pOutputImage, outputFileName);
if (!bSaveState)
    throw <span class="hljs-keyword">OdError</span>(eFileWriteError);
```

### ラスター画像ピクセルへのアクセス

この記事では、湖の波の以下のラスター画像を使用します。

[![](/files/images/blog/2017-02-02-pic1.png)](/files/images/blog/2017-02-02-pic1.png)

このシリーズの記事で説明されているラスター画像実験では、画像の四隅からのピクセル色が必要です。画像ピクセルにアクセスするために、OdGiRasterImageはscanLinesメソッドの2つのバージョンを提供します。最初の（直接の）scanlinesアクセス方法は、すべてのラスター画像タイプでサポートされているわけではありません。なぜなら、すべてのラスター画像が互換性のあるピクセル配列を含んでいるわけではないからです。したがって、まず、この種のラスター画像に最適化されたscanlinesアクセスを使用できることを確認する必要があります。

```
<span class="hljs-title">ODCOLORREF</span> inputColors[4];
if (pInputImage-><span class="hljs-keyword">scanLines</span>())
{
    const <span class="hljs-title">OdUInt8</span> *pPixels = pInputImage-><span class="hljs-keyword">scanLines</span>();
    inputColors[0] = <span class="hljs-keyword">ODRGB</span>(pPixels[0], pPixels[1], pPixels[2]); // Bottom-left corner
    pPixels += (pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3;
    inputColors[1] = <span class="hljs-keyword">ODRGB</span>(pPixels[0], pPixels[1], pPixels[2]); // Bottom-right corner
    pPixels = pInputImage-><span class="hljs-keyword">scanLines</span>() + (pInputImage-><span class="hljs-keyword">scanLineSize</span>() * (pInputImage-><span class="hljs-keyword">pixelHeight</span>() - 1));
    inputColors[2] = <span class="hljs-keyword">ODRGB</span>(pPixels[0], pPixels[1], pPixels[2]); // Top-left corner
    pPixels += (pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3;
    inputColors[3] = <span class="hljs-keyword">ODRGB</span>(pPixels[0], pPixels[1], pPixels[2]); // Top-right corner
}
```

この例では（最適化されたピクセルアクセサーがnull以外のデータポインターを返す場合）、左下、右下、左上、右上のピクセルカラーをinputColors配列に格納します。Teigha内では、ラスター画像のスキャンラインは下から上への順序で格納されるため、scanLinesメソッドによって返されるポインターは、画像の下部のスキャンラインを指すことに注意してください。

ラスター画像が直接スキャンラインアクセサーを提供しない場合でも、ピクセル配列を中間ユーザー定義配列にコピーする別のバージョンのscanLinesメソッドを常に使用できます。このメソッドは、すべての種類のラスター画像でサポートされています。

```
if (!pInputImage->scanLines())
{
    <span class="hljs-title">OdUInt8Array</span> scanLine;
    scanLine.<span class="hljs-keyword">resize</span>(pInputImage-><span class="hljs-keyword">scanLineSize</span>());
    pInputImage-><span class="hljs-keyword">scanLines</span>(scanLine.<span class="hljs-keyword">asArrayPtr</span>(), 0);
    inputColors[0] = <span class="hljs-keyword">ODRGB</span>(scanLine[0], scanLine[1], scanLine[2]); // Bottom-left corner
    inputColors[1] = <span class="hljs-keyword">ODRGB</span>(scanLine[(pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3 + 0], // Bottom-right corner
                     scanLine[(pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3 + 1],
                     scanLine[(pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3 + 2]);
    pInputImage-><span class="hljs-keyword">scanLines</span>(scanLine.<span class="hljs-keyword">asArrayPtr</span>(), pInputImage-><span class="hljs-keyword">pixelHeight</span>() - 1);
    inputColors[2] = <span class="hljs-keyword">ODRGB</span>(scanLine[0], scanLine[1], scanLine[2]); // Top-left corner
    inputColors[3] = <span class="hljs-keyword">ODRGB</span>(scanLine[(pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3 + 0], // Top-right corner
                     scanLine[(pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3 + 1],
                     scanLine[(pInputImage-><span class="hljs-keyword">pixelWidth</span>() - 1) * 3 + 2]);
}
```

この例では、最初（下）と最後（上）のスキャンラインを中間配列にコピーし、それらの最初と最後のピクセルカラーをinputColors配列内にコピーします。

## 今すぐ始める

**ODAソフトウェアを60日間無料でお試しください。  
リスクなし、クレジットカード不要。**

[無料で試す](https://www.opendesign.com/ja/free-trial)