前へ | 次へ | 目次 | 索引 |
/FORMAT=形式名
入力ファイルまたは出力ファイルをコード化する形式を指定します。省略時の入力ファイルおよび出力ファイルの形式は DDIF です。CDA Base Services for DECwindows Motif for OpenVMS とともに提供される入力コンバータ,およびサポートされるファイル形式の省略時のファイル・タイプを,次に示します。
入力形式 ファイル・タイプ DDIF .DDIF DTIF .DTIF TEXT .TXT
CDA Base Services for DECwindows Motif for OpenVMS とともに提供される出力コンバータ,およびサポートされるファイル形式の省略時のファイル・タイプを,次に示します。
出力形式 ファイル・タイプ DDIF .DDIF DTIF .DTIF TEXT .TXT PS .PS ANALYSIS .CDA$ANALYSIS
弊社が提供する CDA Converter Library は,いくつかの文書,グラフィック,イメージ,データ・テーブル入力コンバータ,およびデータ・テーブル出力コンバータを提供しています。ソフトウェア・ベンダも, CDA に準拠したアプリケーションやコンバータを提供しています。システムで使用できるコンバータについては,システム管理者に相談してください。
分析出力コンバータ
分析出力コンバータは,入力ファイルの中間表現の分析を行います。分析出力ファイルには,指定したオブジェクトと入力ファイルに格納された値が含まれます。アプリケーション・プログラマは,デバッグのために分析出力ファイルを使用することができます。
アプリケーションのエンド・ユーザは分析出力ファイルを使用して,複数のサブファイルへの参照やリンクを入力ファイルに含めるかどうか,決めることができます。各サブファイルは,ネットワークを介して別々にコピーされなければなりません。これは,入力ファイルをネットワークを介して転送しても,サブファイルは自動的には転送されないためです。
分析出力ファイルで,文字列 "ERF_" という文字列を検索することができます。入力ファイルである DDIF 複合文書とリンクしたイメージ・ファイル "griffin.img" で,文字列 "ERF_" を検索した例を次に示します。
ERF_LABEL ISO LATIN1 "griffin.img" ! Char. string. ERF_LABEL TYPE RMS_LABEL TYPE "$RMS: ERF_CONTROL COPY_REFERENCE ! Integer = 1
分析出力ファイルは,プログラマが使用することを仮定しています。入力ファイル中のコード化された情報を変更することは前提としておらず,ファイルの内容を調べることを前提としています。上記の例では,分析出力ファイル中の,リンクされたファイルへの参照を検索する方法を示しています。
DDIF 入力コンバータは, DDIF 入力ファイルを,指定した出力ファイル形式に引き続き変換される中間表現に変換します。データのマッピング,変換に関する制限事項,外部ファイル参照,および DDIF 入力コンバータに関連した文書構文エラーについては以下を参照してください。
- データのマッピング
DDIF 入力ファイルの情報を,中間表現に直接マップします。
- 変換に関する制限事項
中間表現に変換する時,DDIF 入力ファイルの情報が消失することはありません。
ただし DDIF 入力ファイルで, DDIF 入力コンバータが理解するバージョンより新しいバージョンの DDIF 文法を使用している場合は,新文法で示される要素は消失します。
- 外部ファイル参照
DDIF 入力フィアル中の外部ファイル参照はすべて,中間表現に変換されます。
出力コンバータが要求すればコンバータ・カーネルは外部参照を解決できますが, DDIF 入力コンバータは外部参照を解決を試みません。
- 文書構文エラー
DDIF 入力ファイルに文書構文エラーがあると,回復不可能な入力処理エラーが発生します。 DDIF 入力コンバータが文書構文エラーを検出すると,変換処理は停止され,それ以降入力処理は行われません。
DDIF 出力コンバータは,入力ファイルの中間表現から DDIF 出力ファイルを作成します。データのマッピング,および DDIF 出力コンバータに関連する変換の制限事項を,次に示します。
- データのマッピング
入力ファイルの中間表現中の情報を, DDIF 出力ファイルに直接マップします。
- 変換に関する制限事項
DDIF 出力ファイルに変換する時,入力ファイルの中間表現の情報が消失することはありません。
DTIF 入力コンバータは, DTIF 入力ファイルを,指定した出力ファイル形式に引き続き変換される中間表現に変換します。データのマッピング,変換に関する制限事項,外部ファイル参照,および DTIF 入力コンバータに関連した文書構文エラーについては以下を参照してください。
- データのマッピング
DTIF 入力ファイルの情報を,中間表現に直接マップします。
- 変換に関する制限事項
中間表現に変換する時,DTIF 入力ファイルの情報が消失することはありません。
ただし DTIF 入力ファイルで, DTIF フロント・エンドが理解するバージョンより新しいバージョンの DTIF 文法を使用している場合は,新文法で示される要素は消失します。
- 外部ファイル参照
DTIF 入力フィアル中の外部ファイル参照はすべて,中間表現に変換されます。
DTIF 入力コンバータは,外部参照の解決を試みません。
- 文書構文エラー
DTIF 入力ファイルに文書構文エラーがあると,回復不可能な入力処理エラーが発生します。 DTIF 入力コンバータが文書構文エラーを検出すると,変換処理は停止され,それ以降入力処理は行われません。
DTIF 出力コンバータは,入力ファイルの中間表現から DTIF 出力ファイルを作成します。データのマッピング,および DTIF 出力コンバータに関連する変換の制限事項を,次に示します。
- データのマッピング
入力ファイルの中間表現中の情報を, DTIF 出力ファイルに直接マップします。
- 変換に関する制限事項
DTIF 出力ファイルに変換する時,入力ファイルの中間表現の情報が消失することはありません。
- 外部ファイル参照
DTIF 出力コンバータは,入力ファイルの中間表現に格納されている外部ファイル参照を変換しますが,外部参照の解決は試みません。
テキスト入力コンバータは,テキスト (ISO Latin1) 入力ファイルを,指定した出力ファイル形式に引き続き変換される中間表現に変換します。データのマッピング,変換に関する制限事項,外部ファイル参照,テキスト入力コンバータに関連した文書構文エラーについては以下を参照してください。
- データのマッピング
テキスト入力ファイルの情報を,中間表現に直接マップします。ライン・ブレークとフォーム・フィードは, DDIF 指示文にマップされます。 1 行の空白行,または連続した複数の空白行は,段落の終端を示すものと解釈されます。
キャラクタ・セル端末または端末エミュレータで, DEC MCS ファイルとしてテキスト入力ファイルを入力すると,次のように変換されます。
変換前の文字 変換後の文字 Concurrency sign 分音符 大文字の O と E の合字 乗算記号 分音符の付いた大文字の Y 鋭アクセントの付いた大文字の Y 小文字の o と e の合字 除算記号 分音符の付いた小文字の y 鋭アクセントの付いた Y
- 変換に関する制限事項
中間表現に変換する時,テキスト入力ファイルの情報が消失することはありません。これは,テキスト・ファイルには構造情報が入っていないからです。
印刷不可能な文字はすべて,空白文字に変換されます。たとえば ANSI エスケープ文字は,空白文字に変換され解釈を試みません。
- 外部ファイル参照
テキスト・ファイルには,外部ファイル参照は含まれていません。
- 文書構文エラー
テキスト・ファイルには構文がないため,テキスト入力コンバータにより構文エラーが報告されることはありません。
テキスト出力コンバータは,入力ファイルの中間表現からテキスト出力ファイルを作成します。データのマッピング,およびテキスト出力コンバータに関連する変換の制限事項を,次に示します。
- データのマッピング
入力ファイルの中間表現の中のすべての Latin1 テキストは,テキスト出力ファイルに変換されます。
入力ファイルをテキスト出力ファイルに変換する場合は,テキスト出力ファイルにはテキスト,およびライン・フィード,ページ・ブレーク,タブなどの最小限のフォーマッティングしか入れられないことに注意してください。テキスト出力コンバータは, (出力ファイルがさらに変換される可能性を考慮して) フォーマッティング情報を保持します。ページングは最も近いキャラクタ・セル (行,カラム) 位置に変換されます。
- 変換に関する制限事項
テキスト出力ファイルに変換される時に,入力ファイルの中間表現の中のすべてのグラフィック,イメージ,およびテキスト属性は消失します。
モノスペース・フォントが使用されているので,レイアウトを保持するために上書きが行われ,テキストが消失する可能性があります。文書のフォーマット情報に指定したページ幅よりも,指定したページ幅が狭い場合は,行が切り捨てられる可能性もあります。 OVERRIDE_FORMAT 処理オプションを使用すれば,このようなことは起こりません。それは,OVERRIDE_FORMAT 処理オプションを指定すると,文書のフォーマット情報は無視されるからです。
PostScript 出力コンバータは,入力ファイルの中間表現から PostScript 出力ファイルを作成します。データのマッピング,および PostScript 出力コンバータに関連する変換の制限事項を,次に示します。
- データのマッピング
入力ファイルの中間表現中の情報を,PostScript 出力ファイルに直接マップします。
- 変換に関する制限事項
PostScript 出力ファイルに変換する時,入力ファイルの中間表現の情報が消失することはありません。
/MESSAGE_FILE=ファイル指定
/NOMESSAGE_FILE (省略時の設定)
文書変換に関するメッセージを記録します。入力コンバータおよび出力コンバータからのメッセージは, ファイル指定に指定したファイルに出力されます。ファイル指定を行わないと,メッセージは SYS$ERROR に出力されます。省略時の設定は /NOMESSAGE_FILE です。/OPTIONS=オプション・ファイル名
変換時に,入力ファイルと出力ファイルに適用させたい処理オプションを含むテキスト・ファイルを指定します。オプション・ファイルの省略時のファイル・タイプは /CDA$OPTIONS です。CONVERT/DOCUMENT コマンドで /OPTIONS 修飾子を指定する前に,オプション・ファイルを作成しておきます。オプション・ファイルは,オペレーティング・システム上でファイル・タイプが省略時のファイル・タイプ .CDA$OPTIONS であるテキスト・ファイルです。
オプション・ファイルには,入力ファイル形式と出力ファイル形式に適用させるすべての処理オプションを指定します。処理オプションを指定すると,入力ファイルを形式の異なる出力ファイルに変換する時に,最小限の変更に抑えることができます。
オプション・ファイルは必須ではありません。ファイルを変換する時,省略時の処理オプションは自動的に適用されます。ただし省略時以外の設定を使用する場合は,オプション・ファイルが必要です。
オプション・ファイルを作成する時は,以下のガイドラインに従ってください。
- オプション・ファイルの各行は,入力形式または出力形式に対するキーワードで始めなければなりません。そのあとに空白やタブ (複数可),またはスラッシュ (/) を続けます。
DDIF や DTIF のように,いくつかのファイル形式では,入力コンバータと出力コンバータがあります。形式キーワードで _INPUT や _OUTPUT を指定すると,処理オプションを入力形式にのみ,または出力形式にのみ適用させるよう制限することができます。
- 同一入力形式または同一出力形式に対して複数のオプションがある場合は,各行には処理オプションを 1 つだけ指定してください。
- 処理オプションを指定するには,大文字の英字,小文字の英字,数字(0 〜 9),ドル記号($),およびアンダースコア(_) を使用します。
- 処理オプションに対して指定された値の前に, 1 つまたは複数の空白やタブを入れます。
オプション・ファイルのエントリ例を次に示します。
PS PAPER_HEIGHT 10
この例では形式キーワードの _OUTPUT は必須ではありません。これは,PostScript は出力形式でのみ使用可能だからです。省略時の設定では, PAPER_HIGHT の値はインチ単位で指定します。
オプション・ファイルに,特定の変換のためのコンバータに適用されないオプションを含めると,これらのオプションは無視されます。
入力形式または出力形式で無効なオプション,あるいはオプションで無効な値を指定すると,エラー・メッセージが返されます。処理オプションに適用される制限事項を,次の節に示します。
分析出力コンバータは,次のオプションをサポートします。
- COMMENT DEFAULT_VALUES
省略時の値により生成された行の先頭に,コメント文字(!) を挿入します。コメント文字は,対応する集合体括弧や配列括弧の前にも挿入されます。
- COMMENT INHERITED_VALUES
継承した値により生成される行の先頭に,コメント文字(!) を挿入します。コメント文字は,対応する集合体括弧や配列括弧の前にも挿入されます。
- TRANSLATE_BYTE_STRINGS
省略時の設定を変更します。BYTE STRING 型のデータの場合,バイト文字列中のすべての文字が印刷可能な文字 (16 進値で 20 〜 7E) であれば,分析出力は 16 進数を変換した値を表示しません。 TRANSLATE_BYTE_STRINGS オプションを指定すると,この機能が変更されます。
- IMAGE_DATA
省略時の設定を変更します。 DDIF$_IDU_PLANE_DATA (ビットマップのイメージ) のバイト文字列データの場合,以前は分析出力は 16 進数を変換した値と ASCII を変換した値を表示しました。これらはどちらも,多くのユーザにとって特定の値ではありませんでした。新しいバージョンでは,どちらの表示も次のコメントと置き換えられます。
! *** Bit-mapped data not displayed here ***
16 進数での表示を行う場合は,IMAGE_DATA オプションを指定します。このオプションを指定すると, ASCII に変換されません。- INHERITANCE
属性継承を有効にして,分析が表示されます。継承属性は,出力中で "[Inherited value.]"というマークが付けられます。このオプションを指定すると,外部参照はメインの文書にインポートされます。
テキスト出力コンバータは,次のオプションをサポートします。
- ASCII_FALLBACK [ON,OFF]
テキスト出力コンバータが,テキストを 7 ビットの ASCII で出力することを指定します。文字のフォールバック表現は,ASCII 標準に記述されています。このオプションを指定しないと,省略時の設定により OFF が使用されます。値を指定せずにこのオプションを指定すると,省略時の設定により ON が使用されます。
- CONTENT_MESSAGES [ON,OFF]
テキスト出力コンバータが,入力ファイルの中間表現中でテキストではない要素を検出するたびに,メッセージを出力ファイルに書き込むことを指定します。このオプションを指定しないと,省略時の設定により OFF が使用されます。値を指定せずにこのオプションを指定すると,省略時の設定により ON が使用されます。
- HEIGHT 値
テキスト出力ファイルでの,1 ページあたりの最大行数を指定します。 0 を指定すると,1 ページあたりの行数は,文書で指定した行数と同じになります。 OVERRIDE_FORMAT とともに指定する,または文書にページ・サイズが指定されていないと,このオプションで指定した値を使用して,フォーマッティングします。省略時の設定の値は 66 です。
- OVERRIDE_FORMAT [ON,OFF]
HEIGHT および WIDTH 処理オプションで指定したページのサイズにテキストをフォーマッティングできるように,文書に含まれているフォーマッティグ情報を無視するかどうかを指定します。このオプションを指定しないと,省略時の設定により OFF が使用されます。値を指定せずにこのオプションを指定すると,省略時の設定により ON が使用されます。
- SOFT_DIRECTIVES [ON,OFF]
テキスト出力ファイルを作成する時に,文書に含まれているソフト指示文に従うかどうかを指定します。このオプションを指定しないと,省略時の設定により OFF が使用されます。値を指定せずにこのオプションを指定すると,省略時の設定により ON が使用されます。
- WIDTH 値
テキスト出力ファイルでの,1 ページあたりの最大カラム数を指定します。 0 を指定すると,1 ページあたりのカラム数は,文書で指定したカラム数と同じになります。 OVERRIDE_FORMAT とともに指定する,または文書にページ・サイズが指定されていないと,このオプションで指定した値を使用してフォーマッティングします。ここで指定した値を越えるテキストは,切り捨てられます。省略時の値は 80 です。
PostScript 出力コンバータは,次のオプションをサポートします。
- PAPER_SIZE サイズ
PostScript 出力ファイルをフォーマッティングする時に使用される,用紙のサイズを指定します。 サイズ引数で有効な値を次に示します。
キーワード サイズ A0 841 x 1189 ミリ (33.13 x 46.85 インチ) A1 594 x 841 ミリ (23.40 x 33.13 インチ) A2 420 x 594 ミリ (16.55 x 23.40 インチ) A3 297 x 420 ミリ (11.70 x 16.55 インチ) A4 210 x 297 ミリ (8.27 x 11.70 インチ) A 8.5 x 11 インチ (216 x 279 ミリメートル) B 11 x 17 インチ (279 x 432 ミリメートル) C 17 x 22 インチ (432 x 559 ミリメートル) D 22 x 34 インチ (559 x 864 ミリメートル) E 34 x 44 インチ (864 x 1118 ミリメートル) LEDGER 11 x 17 インチ (279 x 432 ミリメートル) LEGAL 8.5 x 14 インチ (216 x 356 ミリメートル) LETTER 8.5 x 11 インチ (216 x 279 ミリメートル) LP 13.7 x 11 インチ (348 x 279 ミリメートル) VT 8 x 5 インチ (203 x 127 ミリメートル)
省略時の設定の用紙サイズは A(8.5 x 11 インチ)です。
- PAPER_HEIGHT 高さ
あらかじめ定義されている値以外の,用紙のサイズを指定します。省略時の設定の用紙の高さは 11 インチです。
- PAPER_WIDTH 幅
あらかじめ定義されている値以外の,用紙のサイズを指定します。省略時の設定の用紙の幅は 8.5 インチです。
- PAPER_TOP_MARGIN 上マージン
用紙の上部のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_BOTTOM_MARGIN 下マージン
用紙の下部のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_LEFT_MARGIN 左マージン
用紙の左のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_RIGHT_MARGIN 右マージン
用紙の右のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_ORIENTATION 方向
出力された PostScript ファイルで使用される用紙の方向を指定します。 方向引数で有効な値を次に示します。
キーワード 説明 PORTRAIT 縦向き。用紙の長い方の辺が,垂直軸と並行になる向き。 LANDSCAPE 横向き。用紙の長い方の辺が,水平軸と並行になる向き。
省略時の設定は PORTRAIT です。
- EIGHT_BIT_OUTPUT [ON,OFF]
PostScript 出力コンバータに,8 ビットで出力するかどうかを指定します。省略時の値は ON です。
- LAYOUT [ON,OFF]
DDIF 文書で指定されたレイアウトで処理するかどうかを指定します。省略時の値は ON です。
- OUTPUT_BUFFER_SIZE 出力バッファ・サイズ
出力バッファのサイズを指定します。 64 から 256 までの値を指定しなければなりません。省略時の値は 132 です。
- PAGE_WRAP [ON,OFF]
下マージンを越えたテキストを,改ページするかどうかを指定します。省略時の値は ON です。
- SOFT_DIRECTIVES [ON,OFF]
出力を編集するために,DDIF ファイルのソフト指示文を処理するかどうかを指定します (ソフト指示文は改行,改ページ,タブなどの編集コマンドを指定します)。 PostScript 出力コンバータがソフト指示文を処理すると,省略時の値は ON です。
- WORD_WRAP [ON,OFF]
右マージンを越えるテキストのラッピングを行うかどうかを指定します。省略時の値は ON です。OFF を指定すると,テキストは右マージンを越えてしまいます。
入力コンバータのある,CDA をサポートする表ファイル形式に適用させる処理オプションを含む,オプション・ファイルを作成できます。表ファイル形式の例としては,データ・テーブルやスプレッドシートがあります。
表入力ファイルを文書出力ファイルに変換するには, DTIF_TO_DDIF 形式名を使用し,次に処理オプションを指定します。特定の表入力ファイル形式や文書出力ファイル形式への処理オプションに加えて, DTIF_TO_DDIF 処理オプションを指定します。
レポートや他の文書に表のテキスト表現を入れられるように,表入力ファイルを文書出力ファイルに変換したい場合もあります。だたし表入力ファイルを文書出力ファイルに変換すると,セル・ボーダ,ヘッダ,グリッド行,すべての式,およびフォント・タイプが消失することに注意してください。
ドメイン・コンバータは,次のオプションをサポートします。
- COLUMN_TITLE
カラム属性のカラム・タイトルを,カラムの上中央に表示します。
- CURRENT_DATE
現在の日付と時刻を,ページの左下の隅に表示します。これらは,文書に省略時で設定されている形式にしたがって表示されます。
- DOCUMENT_DATE
文書ヘッダにある文書の日付と時刻を,ページの左上の隅に表示します。これらは,文書に省略時で設定されている形式にしたがって表示されます。
- DOCUMENT_TITLE
文書ヘッダの文書タイトルを,各ページの上中央に表示します。
- PAGE_NUMBER
現在のページ番号を,ページの右上の隅に表示します。
- PAPER_SIZE サイズ
PostScript 出力ファイルをフォーマッティングする時に使用する,用紙のサイズを指定します。サイズ引数で有効な値を次に示します。
キーワード サイズ A0 841 x 1189 ミリ (33.13 x 46.85 インチ) A1 594 x 841 ミリ (23.40 x 33.13 インチ) A2 420 x 594 ミリ (16.55 x 23.40 インチ) A3 297 x 420 ミリ (11.70 x 16.55 インチ) A4 210 x 297 ミリ (8.27 x 11.70 インチ) A5 148 x 210 ミリ (5.83 x 8.27 インチ) A 8.5 x 11 インチ (216 x 279 ミリ) B 11 x 17 インチ (279 x 432 ミリ) B4 250 x 353 ミリ (9.84 x 13.90 インチ) B5 176 x 250 ミリ (6.93 x 9.84 インチ) C 17 x 22 インチ (432 x 559 ミリ) C4 229 x 324 ミリ (9.01 x 12.76 インチ) C5 162 x 229 ミリ (6.38 x 9.02 インチ) D 22 x 34 インチ (559 x 864 ミリ) DL 110 x 220 ミリ (4.33 x 8.66 インチ) E 34 x 44 インチ (864 x 1118 ミリ) 10x13_ENVELOPE 13 x 254 ミリ (15600 x 10 インチ) 9x12_ENVELOPE 12 x 229 ミリ (14400 x 9 インチ) BUSINESS_ENVELOPE 9.5 x 105 ミリ (11400 x 4.13 インチ) EXECUTIVE 10 x 191 ミリ (12000 x 7.5 インチ) LEDGER 11 x 17 インチ (279 x 432 ミリ) LEGAL 8.5 x 14 インチ (216 x 356 ミリ) LETTER 8.5 x 11 インチ (216 x 279 ミリ) LP 13.7 x 11 インチ (348 x 279 ミリ) VT 8 x 5 インチ (203 x 127 ミリ)
用紙サイズ A(8.5 x 11 インチ) が省略時の設定です。
- PAPER_HEIGHT 高さ
あらかじめ定義されている値以外の,用紙のサイズを指定します。省略時の設定の用紙の高さは 11 インチです。
- PAPER_WIDTH 幅
あらかじめ定義されている値以外の,用紙のサイズを指定します。省略時の設定の用紙の幅は 8.5 インチです。
- PAPER_TOP_MARGIN 上マージン
用紙の上部のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_BOTTOM_MARGIN 下マージン
用紙の下部のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_LEFT_MARGIN 左マージン
用紙の左のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_RIGHT_MARGIN 右マージン
用紙の右のマージン幅を指定します。省略時の設定は 0.25 インチです。
- PAPER_ORIENTATION 方向
出力された PostScript ファイルで使用される用紙の方向を指定します。 方向引数で有効な値を次に示します。
キーワード 説明 PORTRAIT 縦向き。用紙の長い方の辺が,垂直軸と並行になる向き。 LANDSCAPE 横向き。用紙の長い方の辺が,水平軸と並行になる向き。
省略時の設定は PORTRAIT です。
#1 |
---|
$ CONVERT/DOCUMENT/OPTIONS=MY_OPTIONS.CDA$OPTIONS - _$MY_INPUT.DTIF/FORMAT=DTIF MY_OUTPUT.DDIF/FORMAT=DDIF |
このコマンドは MY_INPUT.DTIF という名前で DTIF 形式の入力ファイルを, MY_OUTPUT.DDIF という名前で DDIF 形式の出力ファイルに変換します。オプション・ファイル MY_OPTIONS.CDA$OPTIONS も指定しています。
前へ | 次へ | 目次 | 索引 |