im2int16

イメージを 16 ビット符号付き整数に変換

構文

J = im2int16(I)

説明

J = im2int16(I) は、必要に応じてデータを再スケーリングし、グレースケール イメージ、RGB イメージ、またはバイナリ イメージ I をデータ型 int16 に変換します。

入力イメージのデータ型が int16 の場合、出力イメージも入力イメージと同じデータ型になります。入力イメージのデータ型が logical の場合、im2int16 は、false 値の要素を -32768 に、true 値の要素を 32767 に変更します。

例

double から int16 への配列の変換

double クラスの配列を作成します。

I = reshape(linspace(0,1,20),[5 4])

I = 5×4

         0    0.2632    0.5263    0.7895
    0.0526    0.3158    0.5789    0.8421
    0.1053    0.3684    0.6316    0.8947
    0.1579    0.4211    0.6842    0.9474
    0.2105    0.4737    0.7368    1.0000

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

I2 = im2int16(I)

I2 = 5x4 int16 matrix

   -32768   -15522     1724    18970
   -29319   -12073     5173    22419
   -25870    -8624     8623    25869
   -22420    -5174    12072    29318
   -18971    -1725    15521    32767

入力引数

I — 入力イメージ

数値配列 | logical 配列

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

• I がグレースケール イメージまたは RGB イメージの場合、データ型は uint8、uint16、int16、double、single、または logical のいずれかになります。関数 im2int16 では、データ型が double および single であるイメージの値の範囲は [0, 1] でなければなりません。I が [0, 1] の範囲外の値をもつ場合、関数 rescale を使用して、想定される範囲に値を再スケーリングできます。

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

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

出力引数

J — データ型が int16 のイメージ

数値配列

データ型が int16 のイメージ。入力イメージ I と同じサイズの数値配列として返されます。

データ型: int16

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• im2int16 では C コードの生成がサポートされています (MATLAB^® Coder™ が必要)。汎用の MATLAB Host Computer ターゲット プラットフォームを選択した場合、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用するコードが、im2int16 によって生成されます。共有ライブラリを使用するとパフォーマンスの最適化は維持されますが、コードを生成できるターゲット プラットフォームが限定されます。詳細については、Image Processing Toolbox でサポートされているコード生成のタイプを参照してください。

GPU コード生成
GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数は、スレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

この関数は、GPU 配列を完全にサポートします。詳細については、GPU でのイメージ処理を参照してください。

バージョン履歴

R2006a より前に導入

R2021b: スレッドベース環境のサポート

im2int16 は、スレッドベースの環境をサポートするようになりました。

参考

im2double | im2single | im2uint8 | im2uint16 | int16