「psFile(API)」の版間の差分
(→円) |
(→スケール・原点・回転角度の設定) |
||
行290: | 行290: | ||
文字及び点のスケールを(im.scaleX, im.scaleY)[pt]で、原点を(im.translateX, im.translateY)[inch]とします。 | 文字及び点のスケールを(im.scaleX, im.scaleY)[pt]で、原点を(im.translateX, im.translateY)[inch]とします。 | ||
extern void psFileImageSpaceSet (psFile* ps, psImageInfo im, psParaTypeInteger mode); | extern void psFileImageSpaceSet (psFile* ps, psImageInfo im, psParaTypeInteger mode); | ||
− | |||
− | |||
文字及び点のスケール、原点を元に戻します。 | 文字及び点のスケール、原点を元に戻します。 | ||
extern void psFileImageSpaceRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode); | extern void psFileImageSpaceRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode); | ||
− | + | 文字及び点の回転角度im.angleを設定します。 | |
+ | extern void psFileImageSpaceRotateSet (psFile* ps, psImageInfo im, psParaTypeInteger mode); | ||
+ | 文字及び点の回転角度を元に戻します。 | ||
extern void psFileImageSpaceRotateRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode); | extern void psFileImageSpaceRotateRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode); | ||
+ | <br> | ||
+ | これらの[[API]]は基本的に同じ~Setと~Restoreで処理を挟んで使用します。このとき、挟まれた処理にのみ~Setでの設定が反映されます。<br> | ||
+ | <br> | ||
+ | 使用例 | ||
+ | <pre> | ||
+ | psFileImageSpaceSet( 設定1 ) | ||
+ | (処理1) | ||
+ | psFileImageSpaceRotateSet( 角度設定1 ) | ||
+ | (処理2) | ||
+ | psFileImageSpaceSet( 設定2 ) | ||
+ | (処理3) | ||
+ | psFileImageSpaceRestore( ... ) | ||
+ | (処理4) | ||
+ | psFileImageSpaceRotateRestore( ... ) | ||
+ | (処理5) | ||
+ | psFileImageSpaceRestore( ... ) | ||
+ | </pre> | ||
+ | この例で、(設定1)の有効範囲は(処理1) ~ (処理5)、(角度設定1)の有効範囲は(処理2) ~ (処理4)、(設定2)の有効範囲は(処理3)となっています。但し、(処理3)のスケール・原点については(設定2)の方が(設定1)よりも後に設定されているので、こちらが反映されます。<br> | ||
+ | <br> | ||
===psFileLine=== | ===psFileLine=== |
2014年10月9日 (木) 00:23時点における版
Objects/DataExpress/psFileはPostScriptファイルを取り扱うためのAPI です。
目次
定数
#define MAX_STRING_LENGTH 256 #define PS_FILE_STATUS_ERROR (0) #define PS_FILE_STATUS_OK (1)
#define PROLOG_STRING_NUM (11)
#define PROLOG_VERSION (0) #define PROLOG_TITLE (1) #define PROLOG_CREATOR (2) #define PROLOG_CREATION_DATE (3) #define PROLOG_FOR (4) #define PROLOG_BOUND_BOX (5) #define PROLOG_PAGES (6) #define PROLOG_DOC_FONTS (7) #define PROLOG_END_DOC (8) #define PROLOG_END_PRO (9)
typedef enum psImageScaleMode { psImageScaleModeBottomLeft = 1, psImageScaleModeCenter = 2 } psImageScaleMode;
中心マーカのサイズ
#define PS_IMAGE_CENTRE_LINE_WIDTH (0.1) #define PS_IMAGE_CENTRE_MARK_LENGTH (0.01)
#define PS_IMAGE_SCALE_LINE_WIDTH0 (0.2) #define PS_IMAGE_SCALE_LINE_WIDTH1 (0.1) #define PS_IMAGE_SCALE_LINE_LENGTH0 (10.0) #define PS_IMAGE_SCALE_LINE_LENGTH1 (5.0) #define PS_IMAGE_SCALE_LINE_LENGTH2 (3.0) #define PS_IMAGE_SCALE_LINE_LENGTH3 (2.0) #define PS_IMAGE_SCALE_LINE_LENGTH4 (1.0) #define PS_IMAGE_SCALE_LINE_LENGTH00 (-10.0) #define PS_IMAGE_SCALE_LINE_LENGTH10 (-5.0) #define PS_IMAGE_SCALE_LINE_LENGTH20 (-3.0) #define PS_IMAGE_SCALE_LINE_LENGTH30 (-2.0) #define PS_IMAGE_SCALE_LINE_LENGTH40 (-1.0)
#define psContourMode_DifferentLineWidthContour (0x01) #define psContourMode_SameLineWidthContour (0x02)
#define PS_PLOT_MODE_AXIS (0x000000ff) #define PS_PLOT_MODE_AXIS_X_AXIS_POS (0x00000001) /* 0: Down 1: Up */ #define PS_PLOT_MODE_AXIS_Y_AXIS_POS (0x00000002) /* 0: Left 1: Write */ #define PS_PLOT_MODE_AXIS (0x000000ff)
描画する円のタイプ
#define PS_LINE_CIRCLE_MODE (0) #define PS_FILL_WHITE_CIRCLE_MODE (1) #define PS_FILL_BLACK_CIRCLE_MODE (2)
#define PS_PLOT_SCALE_X_AXIS_Y_POSITION_DOWN ( -5.0) #define PS_PLOT_SCALE_X_AXIS_Y_POSITION_UP (105.0) #define PS_PLOT_SCALE_X_AXIS_LENGTH (1.0)
構造体
typedef long psParaTypeInteger; typedef double psParaTypeReal;
typedef struct psInfo { psParaTypeInteger prologInfoNum; char** prologInfo; char label[MAX_STRING_LENGTH]; psParaTypeInteger page; psParaTypeInteger status; } psInfo;
typedef struct psPageInfo psPageInfo;
struct psPageInfo { psParaTypeInteger page; psParaTypeInteger byte; long start; long end; psPageInfo* next; };
typedef struct psFile { FILE* fpt; psInfo info; long headEnd; psPageInfo* current; psPageInfo* top; psPageInfo* end; long byte; } psFile;
typedef struct psImageInfo { /* For Image Space */ psParaTypeReal scaleX; psParaTypeReal scaleY; psParaTypeReal translateX; psParaTypeReal translateY; psParaTypeReal angle; /* Image Size */ psParaTypeInteger width; psParaTypeInteger height; psParaTypeInteger section; /* For Contour */ psParaTypeInteger bps; psParaTypeInteger nContour; psParaTypeReal* contourLevel; /* For Density Image */ unsigned char* image; /* For Contour */ float* floatImage; psParaTypeReal contourLineColorChange; psParaTypeReal contourLineWidthStart; psParaTypeReal contourLineWidthStep; /* For 3D Contour */ psParaTypeReal eyeX; /* Eye Position */ psParaTypeReal eyeY; psParaTypeReal eyeZ; psParaTypeReal pointX; /* Projection Surface Position */ psParaTypeReal pointY; /* Surface Normal: (position - eye) */ psParaTypeReal pointZ; /* For Colour */ psParaTypeInteger flagRGBColor; psParaTypeInteger flagRGBGradientColor; psParaTypeReal Red; psParaTypeReal Green; psParaTypeReal Blue; psParaTypeReal RedFirst; psParaTypeReal GreenFirst; psParaTypeReal BlueFirst; psParaTypeReal RedLast; psParaTypeReal GreenLast; psParaTypeReal BlueLast; psParaTypeInteger flagHSBColor; psParaTypeInteger flagHSBGradientColor; psParaTypeReal Hue; psParaTypeReal Saturation; psParaTypeReal Brightness; psParaTypeReal HueFirst; psParaTypeReal SaturationFirst; psParaTypeReal BrightnessFirst; psParaTypeReal HueLast; psParaTypeReal SaturationLast; psParaTypeReal BrightnessLast; /* For Line Colour */ psParaTypeInteger flagLineRGBColor; psParaTypeInteger flagLineRGBGradientColor; psParaTypeReal LineRed; psParaTypeReal LineGreen; psParaTypeReal LineBlue; psParaTypeReal LineRedFirst; psParaTypeReal LineGreenFirst; psParaTypeReal LineBlueFirst; psParaTypeReal LineRedLast; psParaTypeReal LineGreenLast; psParaTypeReal LineBlueLast; psParaTypeInteger flagLineHSBColor; psParaTypeInteger flagLineHSBGradientColor; psParaTypeReal LineHue; psParaTypeReal LineSaturation; psParaTypeReal LineBrightness; psParaTypeReal LineHueFirst; psParaTypeReal LineSaturationFirst; psParaTypeReal LineBrightnessFirst; psParaTypeReal LineHueLast; psParaTypeReal LineSaturationLast; psParaTypeReal LineBrightnessLast; /* For Circle */ psParaTypeReal CircleRadius; long dummy; } psImageInfo;
typedef struct psPlotInfo { psParaTypeReal scaleX; psParaTypeReal scaleY; psParaTypeReal translateX; psParaTypeReal translateY; psParaTypeReal dX; psParaTypeReal dXValue; psParaTypeReal minX; psParaTypeReal centreX; psParaTypeReal maxX; char* labelX; psParaTypeReal dY; psParaTypeReal dYValue; psParaTypeReal minY; psParaTypeReal centreY; psParaTypeReal maxY; char* labelY; psParaTypeInteger nData; psParaTypeReal *data; } psPlotInfo;
API
初期化
psファイル情報ps->info->prologInfoをメモリ確保して新規作成し、psファイルps->fptを新規作成します。
また、以降で使用するPostScriptの略記コマンドもここで定義しています。
extern void psFileInit(psFile* ps, psParaTypeInteger mode);
ヘッダ・フッタ・トレイラの書き込み
psファイルps->fptにヘッダを書き込みます。(ラベル: ps->info.label, ページNo.: ps->info.page) mode=0の場合は左下部から各1cmずつ右上の位置を、そうでない場合は左下部の位置を原点とします。
extern void psFilePageStart(psFile* ps, psParaTypeInteger mode);
psファイルps->fptにフッタを書き込みます。
extern void psFilePageEnd(psFile* ps, psParaTypeInteger mode);
psファイルps->fptにトレイラを追加します。
extern void psFileEnd(psFile* ps);
描画
基本的にこれらのAPIはim.width, im.heightにて描画サイズを設定し、
psFileImageSpaceSetによりスケール及び位置を設定して描画します。
画像データ
画像データim.imageをpsファイルps->fptへ書き込みます。
フラグ(imのメンバ)によって画像の種類を設定できます。
extern void psFileImage (psFile* ps, psImageInfo im, psParaTypeInteger mode);
imのフラグ | 説明 |
---|---|
flagRGBColor | RGB形式で書き込む |
flagRGBGradientColor | RGB(グラデーション)形式で書き込む |
flagHSBColor | HSB形式で書き込む(未対応) |
flagHSBGradientColor | HSB(グラデーション)形式で書き込む(未対応) |
それ以外 | モノクロ256階調形式で書き込む |
各フラグは上の方が優先され、重複はしない。
円
im.image内の正のデータを半径[pt]とした円を座標(im.width, imheight)[pt]まで描画します。
extern void psFileImageByCircles (psFile* ps, psImageInfo im, psParaTypeInteger mode);
ファイルpsに中心(cx, cy)[pt]、半径r[pt]の円を描画します。modeにより円のタイプが選択できます。
extern void psFileCircleCreate(psFile* ps, float cx, float cy, float r, long mode);
mode | 値 | 円のタイプ |
---|---|---|
PS_LINE_CIRCLE_MODE | 0 | 塗りつぶしなし |
PS_FILL_WHITE_CIRCLE_MODE | 1 | 白で塗りつぶす |
PS_FILL_BLACK_CIRCLE_MODE | 2 | 黒で塗りつぶす |
ファイルpsに中心マーカを描画します。
extern void psFileImageCentre (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageScale (psFile* ps, psImageInfo im, psParaTypeInteger mode);
スケール・原点・回転角度の設定
文字及び点のスケールを(im.scaleX, im.scaleY)[pt]で、原点を(im.translateX, im.translateY)[inch]とします。
extern void psFileImageSpaceSet (psFile* ps, psImageInfo im, psParaTypeInteger mode);
文字及び点のスケール、原点を元に戻します。
extern void psFileImageSpaceRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode);
文字及び点の回転角度im.angleを設定します。
extern void psFileImageSpaceRotateSet (psFile* ps, psImageInfo im, psParaTypeInteger mode);
文字及び点の回転角度を元に戻します。
extern void psFileImageSpaceRotateRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode);
これらのAPIは基本的に同じ~Setと~Restoreで処理を挟んで使用します。このとき、挟まれた処理にのみ~Setでの設定が反映されます。
使用例
psFileImageSpaceSet( 設定1 ) (処理1) psFileImageSpaceRotateSet( 角度設定1 ) (処理2) psFileImageSpaceSet( 設定2 ) (処理3) psFileImageSpaceRestore( ... ) (処理4) psFileImageSpaceRotateRestore( ... ) (処理5) psFileImageSpaceRestore( ... )
この例で、(設定1)の有効範囲は(処理1) ~ (処理5)、(角度設定1)の有効範囲は(処理2) ~ (処理4)、(設定2)の有効範囲は(処理3)となっています。但し、(処理3)のスケール・原点については(設定2)の方が(設定1)よりも後に設定されているので、こちらが反映されます。
psFileLine
extern void psFileLineWidthSet (psFile* ps, float lineWidth); extern void psFileLineDraw(psFile* ps, float x1,float y1,float x2,float y2); extern void psFileDendgramLineDraw(psFile* ps, float width,float height1, float height2, float x, float y);
psFileString
extern void psFileStringStatusSet(psFile* ps, char* fontname, double fontsize); extern void psFileStringDefaultStatusSet(psFile* ps); extern void psFileString (psFile* ps, char* message, double x, double y, psParaTypeInteger mode);
psFileContour
extern void psFileContour(psFile* ps, psImageInfo im, psParaTypeInteger mode);
psFileRead
extern void psFileRead(psFile* ps, FILE* fpt, long mode);
psFileUtil
extern long psFileIsStartPage(psFile* ps, char* s); extern long psFileIsEndPage(psFile* ps, char* s);