イメージの作成と書式設定

イメージの作成

レポートにイメージを追加するには、mlreportgen.dom.Image オブジェクトを作成します。これは、次のいずれかのドキュメント要素オブジェクトに追加できます。

  • Document

  • Group

  • Paragraph

  • ListItem

  • TableEntry

たとえば、MATLAB® Figure を作成し、この Figure をイメージとして保存して、そのイメージをレポートに追加できます。

import mlreportgen.dom.*
d = Document("imageArea","html");

p = Paragraph("Plot 1");
p.Bold = true;
append(d,p);

x = 0:pi/100:2*pi;
y = sin(x);
plot(x,y);

saveas(gcf,"myPlot_img.png");

plot1 = Image("myPlot_img.png");
append(d,plot1);

close(d);
rptview(d.OutputPath);

サポートされているイメージ形式の一覧については、mlreportgen.dom.Image を参照してください。

イメージのサイズ変更

イメージ オブジェクトのサイズを変更するには、以下の方法があります。

  • イメージの Height プロパティまたは Width プロパティを設定する。1 つの寸法のみを設定した場合、設定されていない寸法はオブジェクトによってサイズ変更されません。

  • mlreportgen.dom.Height オブジェクトまたは mlreportgen.dom.Width オブジェクトを使用して、イメージの Style プロパティを設定する。1 つの寸法のみを設定した場合、設定されていない寸法は、縦横比を維持するためにオブジェクトによってサイズ変更されます。

Microsoft® Word および PDF のレポートの場合、mlreportgen.dom.ScaleToFit オブジェクトを使用して、ページの余白内またはイメージが含まれるテーブル エントリ内にイメージが収まるようにイメージをスケーリングできます。

イメージのストレージ

ドキュメントにコピーされるまで元のファイルを保持します。ドキュメントを閉じると、DOM API によりソース イメージ ファイルのコンテンツが出力ドキュメントにコピーされます。

イメージからのリンク

イメージの領域をリンクとして指定できます。HTML ブラウザーのイメージ内でリンク領域をクリックすると、リンクが開きます。詳細については、イメージ マップの作成を参照してください。

参考

| | |

トピック