ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

im2single

イメージを単精度に変換

説明

J = im2single(I) は、必要に応じてデータを再スケーリングまたはオフセットし、グレースケール、RGB またはバイナリ イメージ Isingle に変換します。

入力イメージが single クラスの場合、出力イメージも同じクラスになります。入力イメージが logical クラスの場合、im2single は true 値の要素を 65535 に変更します。

オプションで、変換を GPU を使用して実行できます (Parallel Computing Toolbox™ が必要)。詳細は、GPU での画像処理を参照

J = im2single(I,'indexed') は、必要に応じてデータをオフセットし、インデックス付きイメージ Isingle に変換します。

すべて折りたたむ

この例では、uint8 クラスの配列を single クラスに変換する方法を説明します。

uint8 クラスの数値配列を作成します。

I = reshape(uint8(linspace(1,255,25)),[5 5])
I = 5x5 uint8 matrix

     1    54   107   160   213
    12    65   117   170   223
    22    75   128   181   234
    33    86   139   192   244
    43    96   149   202   255

配列を single クラスに変換します。

I2 = im2single(I)
I2 = 5x5 single matrix

    0.0039    0.2118    0.4196    0.6275    0.8353
    0.0471    0.2549    0.4588    0.6667    0.8745
    0.0863    0.2941    0.5020    0.7098    0.9176
    0.1294    0.3373    0.5451    0.7529    0.9569
    0.1686    0.3765    0.5843    0.7922    1.0000

gpuArray オブジェクトを作成することで、GPU で uint8 クラスの配列を作成します。

I = gpuArray(reshape(uint8(linspace(1,255,25)),[5 5]))
I =

    1   54  107  160  213
   12   65  117  170  223
   22   75  128  181  234
   33   86  139  192  244
   43   96  149  202  255

GPU で配列を uint8 クラスから single クラスに変換します。im2singlegpuArray オブジェクトを渡すことができます。

I2 = im2single(I)
I2 =

    0.0039    0.2118    0.4196    0.6275    0.8353
    0.0471    0.2549    0.4588    0.6667    0.8745
    0.0863    0.2941    0.5020    0.7098    0.9176
    0.1294    0.3373    0.5451    0.7529    0.9569
    0.1686    0.3765    0.5843    0.7922    1.0000

入力引数

すべて折りたたむ

入力イメージ。任意のサイズおよび次元の数値配列または logical 配列として指定します。

  • I がグレースケール イメージまたは RGB イメージの場合は、uint8uint16doublelogicalsingle または int16 のいずれかになります。

  • I がインデックス付きイメージの場合は、uint8uint16double または logical のいずれかになります。

  • I がバイナリ イメージの場合は、logical でなければなりません。

GPU を使用して変換を実行するには、I を任意のサイズおよび次元の数値配列または logical 配列を含む gpuArray として指定します。

データ型: single | double | int16 | uint8 | uint16 | logical

出力引数

すべて折りたたむ

クラス single のイメージ。I と同じサイズと次元の数値配列として返されます。

GPU を使用して変換を実行する場合、J は数値配列を含む gpuArray として返されます。

データ型: single

拡張機能

R2006a より前に導入