PDFエクスポートのパラメータとフラグを設定する

PDFエクスポートプロセスは、エクスポートの実行方法を決定する一連のパラメータとフラグで管理できます。これらのパラメータとフラグは、PDFExportParams クラスのインスタンスに含まれています。

PDFエクスポートパラメータは以下の表に記載されています。

エクスポートパラメータ名	説明	Getメソッド	Setメソッド
エクスポート用データベース	PDFファイルにエクスポートされるデータベースへのポインタ。	`database()`	`setDatabase()`
PDFファイル書き込み用出力ストリーム	PDFファイルにデータを書き込むために使用される出力ストリームオブジェクトを表す、OdStreamBuffポインタへの参照。	`output()`	`setOutput()`
バージョン	出力PDFファイルのバージョン。サポートされているバージョンの一覧は、`PDFExportVersions` 列挙型を参照してください。	`version()`	`setVersion()`
エクスポートするレイアウト	出力PDFファイルにエクスポートされるレイアウトの配列。配列に要素がない場合、アクティブなレイアウトのみがエクスポートされます。詳細については、「PDFのレイアウトをエクスポートし、ページパラメータを設定する」を参照してください。	`layouts()`	`setLayouts()`
ページパラメータ	エクスポートされたレイアウトのページパラメータ（用紙サイズ、余白など）の配列。要素の数は、レイアウト配列の要素の数と等しくなければなりません。詳細については、「PDFのレイアウトをエクスポートし、ページパラメータを設定する」を参照してください。	`pageParams()`	`setPageParams()`
背景色	出力PDFファイルの背景色。白がデフォルト値です。	`background()`	`setBackground()`
パレット	出力PDFファイルのパレット。指定されていない場合 (NULL)、背景色に応じて2つのデフォルトパレットのいずれかが使用されます。	`palette()`	`setPalette()`
カラーポリシー	エクスポート出力の作成に使用されるカラーポリシー。詳細はモノクロまたはグレースケールPDFファイルへのエクスポートを参照してください。	`colorPolicy()`	`setColorPolicy()`
ベクター化解像度	出力PDFファイルをベクター化するために使用される解像度 (1インチあたりのドット数、DPI)。標準値は、72、150、200、300、400、600、720、1200、2400、4800 DPIです。デフォルト値は600 DPIです。	`getGeomDPI()`	`setGeomDPI()`
ハッチングエクスポート解像度	ハッチングエクスポート中に作成される画像の解像度 (1インチあたりのドット数、DPI)。詳細はPDFへのハッチングエクスポートを参照してください。	`hatchDPI()`	`setHatchDPI()`
カラーおよびグレースケール画像の解像度	エクスポートされたカラーおよびグレースケール画像の解像度 (1インチあたりのドット数、DPI)。	`colorImagesDPI()`	`setColorImagesDPI()`
モノクロ画像の解像度	エクスポートされるモノクロ画像の解像度（1インチあたりのドット数、DPI）。	`bwImagesDPI()`	`setBWImagesDPI()`
画像の切り抜き	クリップされた画像がどのようにエクスポートされるかを決定します。画像はクリッピング境界（例えば、PDFファイルのページ境界やビューポート境界）によってクリップできます。falseの場合、クリップされた画像は完全な画像としてエクスポートされます。それ以外の場合は、画像の表示されている部分のみがエクスポートされます。	`imageCropping()`	`setImageCropping()`
画像DCT圧縮	画像をエクスポートする際に離散コサイン変換（DCT）圧縮アルゴリズムが使用されるかどうかを決定します。値がtrueの場合、画像はJPEG形式で表現されます。DCT圧縮を使用すると、出力PDFファイルのサイズが大幅に削減されます。	`dctCompression()`	`setDCTCompression()`
画像DCT圧縮品質	画像DCT圧縮（JPEG形式）の品質を決定し、画像DCTパラメータがtrueの場合にのみ適用されます。パラメータ値は10から100の間で、元の画像に対する圧縮画像の品質を決定します。デフォルト値は50です。	`dctQuality()`	`setDCTQuality()`
画像のアップスケーリング	画像が設定された画像解像度よりも低い場合にアップスケールされるかどうかを決定します。デフォルトでは、パラメータ値はfalseです。	`upscaleImages()`	`setUpscaleImages()`
ソリッドハッチのエクスポートタイプ	ソリッドハッチのエクスポートに使用されるアルゴリズム。詳細はPDFへのハッチのエクスポートを参照してください。	`solidHatchesExportType()`	`setSolidHatchesExportType()`
グラデーションハッチのエクスポートタイプ	グラデーションハッチのエクスポートに使用されるアルゴリズム。詳細はPDFへのハッチのエクスポートを参照してください。	`gradientHatchesExportType()`	`setGradientHatchesExportType()`
その他のハッチのエクスポートタイプ	ソリッドおよびグラデーション以外のハッチのエクスポートに使用されるアルゴリズム。詳細はPDFへのハッチのエクスポートを参照してください。	`otherHatchesExportType()`	`setOtherHatchesExportType()`
出力ドキュメントのタイトル	出力PDFファイルのタイトル。	`title()`	`setTitle()`
出力ドキュメントの作成者	出力PDFファイルを作成した人の名前。	`author()`	`setAuthor()`
出力ドキュメントの件名	出力PDFファイルの件名。	`subject()`	`setSubject()`
出力ドキュメントのキーワード	出力PDFファイルに関連付けられたキーワード。	`keywords()`	`setKeywords()`
出力ドキュメントの作成者	元の図面ドキュメントの作成に使用されたアプリケーションの名前（例：Adobe® FrameMaker®）。	`creator()`	`setCreator()`
出力ドキュメントのプロデューサー	元の図面を出力PDFファイルに変換するために使用されたアプリケーションの名前（例：Adobe Acrobat® Distiller）。	`producer()`	`setProducer()`
PDF/Aサポート	出力PDFファイルがPDF/A（アーカイブ）形式で作成されるかどうかを決定します。詳細については、「PDF/A形式へのエクスポート」を参照してください。	`archived()`	`setArchived()`
PRCサポート	エクスポートプロセス中にPRC形式がどのようにサポートされるかを決定します。詳細については、「PRCを使用したPDFへのエクスポート」を参照してください。	`PRCMode()`	`setPRCMode()`
PRC圧縮	エクスポートプロセス中にPRCデータの圧縮がサポートされるかどうかを決定します。B-Repデータとテッセレーションデータの両方について、圧縮レベルを個別に設定できます。詳細については、「PRCを使用したPDFへのエクスポート」を参照してください。	`PRCCompression()`	`setPRCCompression()`
PRCコンテキスト	エクスポートするPRCデータが含まれており、PRCストリームにエクスポートする特定のエンティティを含めるようにフィルタリングできます。詳細については、「PRCを使用したPDFへのエクスポート」を参照してください。	`getPRCContext()`	`setPRCContext()`
PRC背景色	エクスポート操作の結果として作成されるPRCデータの背景色を定義します。背景色がデフォルトの白色と異なるかどうかを判断するには、hasPrcBackground() メソッドを使用します。PRCデータのデフォルトの背景色を返すには、clearPrcBackground() メソッドを呼び出します。詳細については、「PRCを使用したPDFへのエクスポート」を参照してください。	`getPrcBackground()`	`setPrcBackground()`
PRCレンダリングモード	エクスポートされたPRCコンテンツのレンダリングモードを定義します。	`getPrcRenderingMode()`	`setPrcRenderingMode()`
シェーディングされたビューポートのエクスポート	シェーディングされたレンダリングモードでのビューポートのエクスポートモードを決定します。詳細については、「シェーディングされたビューポートをPDFにエクスポート」を参照してください。	`shadedVpExportMode()`	`setShadedVpExportMode()`
シェーディングされたビューの背景の透明度	GSデバイスでエクスポートされたシェーディングされたビューの背景が透明であるかどうかを決定します。true値は透明を示し、false値は不透明を示します。	`transparentShadedVpBg()`	`setTransparentShadedVpBg()`
GSデバイスを無効にする	シェーディングされたビューのエクスポートに使用されるGSデバイスを無効にします。パラメータ値がtrueの場合、GSデバイスは無効になります。それ以外の場合（デフォルト）は、GSデバイスは有効になります。ODAソフトウェアは、ワイヤーフレームおよび隠線付きワイヤーフレーム（隠線除去アルゴリズムがオンの場合）のジオメトリとしてPDFへのエクスポートをサポートしています。その他のレンダリングモード（シェーディングなど）の場合、コンテンツは画像としてエクスポートされ、後で出力PDFファイルに挿入されます。ただし、特定の状況では、描画は異なるレンダリングモード（たとえば、ワイヤーフレームモードとシェーディングモードの円）で同じ外観を持つことができます。このような場合、描画を画像としてエクスポートすると、出力PDFコンテンツをスケーリングする際に不利になります。したがって、レンダリングモードに関係なく、そのようなエンティティをジオメトリとしてエクスポートする方が良いです。これを行うには、GSデバイスをオフにし（このオプションをtrueに設定）、描画コンテンツはレンダリングモードに依存せずにジオメトリとしてエクスポートされます。ただし、このオプションを使用すると、出力PDFドキュメントで不正確なレンダリング結果が生じる可能性があるため、注意してください。一般的に、エクスポートプロセスに使用されるGSデバイスを無効にすることは推奨されません。	`forceDisableGsDevice()`	`setForceDisableGsDevice()`
GSCache の使用	PDFエクスポート操作でGsCacheを使用するかどうかを決定します。詳細については、「PDFエクスポート中にGsCacheを使用する」を参照してください。	`useGsCache()`	`setUseGsCache()`
表示とベクトル化のためのマルチスレッド	エクスポートプロセス中に表示とベクトル化のためにマルチスレッドを使用するかどうかを定義する2つのパラメータ。マルチスレッドを使用するには、GsCacheサポートオプションを切り替える必要があることに注意してください。	`isParallelDisplay()` `isParallelVectorization()`	`setParallelDisplay()` `setParallelVectorization()`
PDFブロック	入力図面からのブロックをPDFブロックとしてエクスポートするかどうかを決定します。詳細については、「図面ブロックをPDFブロックとしてエクスポートする」を参照してください。	`isUsePdfBlocks()`	`setUsePdfBlocks()`
パスワード保護のサポート	エクスポートされたPDFドキュメントがパスワードで保護されているかどうかを決定します。パスワード保護のサポートは、PDFバージョン1.3以降でのみ利用可能です。詳細については、「パスワード保護付きPDFへのエクスポート」を参照してください。	`ownerPassword()` `userPassword()` `accessPermissionFlags()`	`setOwnerPassword()` `setUserPassword()` `setAccessPermissionFlags()`
検索可能なテキスト	元の図面からのテキストが出力PDFファイルで検索可能かどうかを決定します。詳細については、「検索可能なテキストをPDFにエクスポート」を参照してください。	`searchableTextType()`	`setSearchableTextType()`
ビュー範囲の使用	エクスポートプロセスがビュー範囲を使用するかどうか（trueの場合）または使用しないか（falseの場合）を決定します。このフラグがtrueに設定されている場合、エクスポートされた図面の範囲を計算する際に、プロット範囲（デフォルトで使用される）の代わりにビュー範囲が使用されます。図面には、範囲の計算で考慮されるエンティティが含まれる場合がありますが、これらのエンティティはレンダリングされません（たとえば、空の複数行テキストエンティティ、非表示レイヤー上のエンティティなど）。ビュー範囲モード（フラグがtrue）は、範囲が計算されるときにすべての非表示エンティティが考慮されると仮定します。プロット範囲モード（フラグがfalse）は、そのようなエンティティが範囲計算から除外されると仮定します。	`useViewExtents()`	`setUseViewExtents()`
透かし	出力PDFドキュメントに関連付けられた透かしの配列が含まれます。詳細については、「透かしを使用したPDFへのエクスポート」を参照してください。	`watermarks()`	`addWatermark()`
ブックマーク	エクスポート中にブックマークが作成されるかどうかを決定します。詳細については、「PDFエクスポート内のブックマークサポート」を参照してください。	`bookmarksEnabled()`	`enableBookmarks()`
測定タイプ	エクスポートプロセス中に使用される測定のタイプを決定します。詳細については、「測定データをPDFにエクスポート」を参照してください。	`measuringType()`	`setMeasuringType()`
アンビエントカラー	エクスポート中にテクスチャを持つマテリアルに割り当てられるアンビエントカラーを決定します。詳細については、「PRCエクスポート用のテクスチャを持つマテリアルのアンビエントカラーを決定する」を参照してください。	`getPrcExportAmbientColorBehavior()`	`setPrcExportAmbientColorBehavior()`

PDFエクスポートフラグは、setExportFlags() 列挙子に格納されており、これはPDFExportParams クラスのメンバーです。PDFエクスポートオプションは、パラメーターの値とパラメーターフラグの組み合わせによって決定されます。

エクスポートフラグのデフォルトの組み合わせは次のとおりです。


kTTFTextAsGeometry|kSHXTextAsGeometry|kFlateCompression|kASCIIHexEncoding|kZoomToExtentsMode

、つまり：

TrueTypeテキストをジオメトリとして扱うフラグがオンになっています。
SHXテキストをジオメトリとして扱うフラグがオンになっています。
データ圧縮フラグがオンになっています。
16進エンコーディングフラグがオンになっています。
範囲にズームモードがオンになっています。
その他のフラグはオフになっています。

一部のエクスポートフラグは、非推奨であるか、ODAプラットフォームの将来のバージョンで削除または変更される可能性があるため、使用が推奨されません。詳細については、「非推奨のエクスポートフラグ」を参照してください。

PDFエクスポートフラグを次の表に示します。

エクスポートパラメータ	パラメータ名	値	説明
埋め込みTTFを使用	kEmbededTTF	1	PDFファイルへのTrueTypeフォントファイルの埋め込みを有効にします。詳細については、「PDFへのフォントのエクスポート」を参照してください。
ジオメトリとしてのTTFテキスト	kTTFTextAsGeometry	2	TrueTypeフォントテキストのジオメトリ変換を有効にします。詳細については、「PDFへのフォントのエクスポート」を参照してください。
ジオメトリとしてのSHXテキスト	kSHXTextAsGeometry	4	SHXフォントテキストのジオメトリ変換を有効にします。詳細については、「PDFへのフォントのエクスポート」を参照してください。
ジオメトリ最適化を使用	kSimpleGeomOptimization	8	エクスポートプロセス中に単純なジオメトリ最適化が有効になっているかどうかを決定します（分離されたセグメントが1つのポリライン、ベジェ曲線制御点に結合されます）。単純なジオメトリ最適化は、ドキュメント要素を描画するためのより効果的なメカニズムを使用します（いくつかの分離されたセグメントの代わりに1つのポリラインを描画したり、ベジェ曲線制御点など）。たとえば、最適化が使用されていない場合、長方形は各線に1つずつ、4つのコマンドで描画されます。最適化が使用されている場合、長方形は単一のコマンドで描画され、出力ファイルの全体的なサイズが削減されます。
レイヤーサポートを有効にする	kEnableLayers	16	レイヤーサポートが有効になっているかどうかを決定します。有効になっている場合、レイヤーは出力PDFファイルに追加されます。詳細については、「PDFエクスポート：レイヤー」を参照してください。
非表示レイヤーを含める	kIncludeOffLayers	32	エクスポートされた図面の非表示レイヤーが出力PDFファイルに追加されるかどうかを決定します。詳細については、「PDFへのレイヤーのエクスポート」を参照してください。
埋め込みTTF最適化	kEmbededOptimizedTTF	64	出力PDFファイルに埋め込まれるTrueTypeフォントファイルのサイズを削減することを可能にします。詳細については、「PDFへのフォントのエクスポート」を参照してください。
隠線除去アルゴリズムを使用	kUseHLR	128	対応するビューポートのエクスポートプロセス中に、ソフトウェアベクトル隠線除去 (HLR) を使用して隠線を削除するかどうかを決定します。このフラグが true の場合、ワイヤーフレームモードの描画内容はジオメトリとしてエクスポートされます。false の場合、内容は画像としてエクスポートされます。
データ圧縮	kFlateCompression	256	内部 PDF ストリームに描画データを書き込む際に、データ圧縮アルゴリズムが適用されるかどうかを決定します。このフラグがオンの場合、内部 PDF 圧縮アルゴリズムが使用されます。データ圧縮により、出力 PDF ファイルのサイズが削減されます。
16 進エンコーディング	kASCIIHexEncoding	512	内部 PDF ストリームにデータが 16 進形式で書き込まれるかどうかを決定します。これにより、16 進エディタで出力ファイルを探索できます。16 進数サポートを有効にするには、[16 進エンコーディング] パラメータをオンにします。16 進数サポートを使用すると、出力ファイルサイズが 2 倍になることに注意してください。
ハイパーリンクのエクスポートサポート	kExportHyperlinks	1024	出力 PDF ファイルへのハイパーリンクのエクスポートを有効にします。
全体表示モード	kZoomToExtentsMode	2048	エクスポートされた図面が全体表示モードであるかどうかを決定します。有効な場合、レイアウトジオメトリは用紙サイズに合わせてズームされ、そうでない場合はレイアウト設定が適用されます。
線形化された PDF ファイルを作成	kLinearized	4096	エクスポートプロセスが、エクスポートされた図面から線形化された PDF ファイルを作成するかどうかを決定します。詳細については、「線形化された PDF ファイルへのエクスポート」を参照してください。
交差する線の色を結合	kMergeLines	8192	交差する線の色が結合されるかどうかを決定します。
測定尺度	kMeasuring	16384	出力 PDF ファイル内のエンティティに測定尺度が実装されるかどうかを決定します。詳細については、「測定データを PDF にエクスポート」を参照してください。

フラグの特殊な値も使用できます。

kZeroFlag(0) は、すべてのフラグが無効になっていることを意味します。
kDefault は、フラグの組み合わせのデフォルト値を格納します。

現在のエクスポートフラグの組み合わせを取得するには、PDFExportParamsクラスのexportFlags()メソッドを使用します。

新しいエクスポートフラグの組み合わせを現在のものとして設定するには、PDFExportParamsクラスのsetExportFlags()メソッドを使用します。

非推奨のエクスポートフラグ

m_reserved1、m_reserved2、m_reserved3、またはm_reserved4フラグは非推奨であり、ODA Platformの将来のバージョンで変更または削除される可能性があるため、使用しないでください。

詳細については、ODAドキュメントを参照してください。

DevConnect Webinars

PDFエクスポートのパラメータとフラグを設定する

非推奨のエクスポートフラグ

今すぐ始める

非推奨のエクスポートフラグ

今すぐ始める

いつでもサポートいたします

イリーナ・ルデヴァ

ジェシー・カイ