psFile(API) - Revision history

Kinoshita: /* Draw */

2014-10-09T05:34:48Z

‎Draw

Show changes

Kinoshita: /* Draw */

2014-10-09T04:33:34Z

‎Draw

Kinoshita: /* Setting Drawing */

2014-10-09T04:33:08Z

‎Setting Drawing

Kinoshita: /* API */

2014-10-09T04:32:37Z

‎API

Kinoshita at 04:09, 9 October 2014

2014-10-09T04:09:18Z

Show changes

Kinoshita: Created page with "Objects/DataExpress/'''psFile''' is API for ps file. == constant == #define MAX_STRING_LENGTH 256 #define PS_FILE_STATUS_ERROR (0) #d..."

2014-07-29T05:38:07Z

Created page with "Objects/DataExpress/'''psFile''' is API for ps file. == constant == #define MAX_STRING_LENGTH 256 #define PS_FILE_STATUS_ERROR (0) #d..."

New page

Objects/DataExpress/'''psFile''' is API for [[ps]] file.

== constant ==
#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)

== struct ==
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 ==
===psFileInit===
extern void psFileInit(psFile* ps, psParaTypeInteger mode);

===psFilePage===
extern void psFilePageStart(psFile* ps, psParaTypeInteger mode);
extern void psFilePageEnd(psFile* ps, psParaTypeInteger mode);

===psFileEnd===
extern void psFileEnd(psFile* ps);

===psFileImage===
extern void psFileImage (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageByCircles (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageCentre (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageScale (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageSpaceSet (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageSpaceRotateSet (psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageSpaceRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode);
extern void psFileImageSpaceRotateRestore(psFile* ps, psImageInfo im, psParaTypeInteger mode);

===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);

===psFileCircle===
extern void psFileCircleCreate(psFile* ps, float cx, float cy, float r, long 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);

@@ Line 240: / Line 240: @@
 === Draw ===
-基本的にこれらの[[API]]は引数psImageInfoの([[#描画Setting]])を使用したSettingで描画します.<br>
+基本的にこれらの[[API]]は引数psImageInfoの([[#Drawing Setting]])を使用したSettingで描画します.<br>
 <br>

@@ Line 336: / Line 336: @@
   extern void psFileImageScale       (psFile* ps, psImageInfo im, psParaTypeInteger mode);
-==== Setting Drawing ====
+==== Drawing Setting ====
 文字及び点のスケールを(im.scaleX, im.scaleY)[pt]で,原点を(im.translateX, im.translateY)[inch]とします.
   extern void psFileImageSpaceSet    (psFile* ps, psImageInfo im, psParaTypeInteger mode);

@@ Line 216: / Line 216: @@
 == API ==
 === Initialize ===
-psfileInformationps->info->prologInfoをメモリ確保して新規Createし,psfileps->fptを新規Createします.<br>
+Create new ps file Information '''ps->info->prologInfo''' allocating memory, and create new ps file '''ps->fpt'''.<br>
-また,以降で使用するPostScriptの略記Commandもここで定義しています.
+In addition, define short [[PostScript]] commands to use these [[API]].
   extern void psFileInit(psFile* ps, psParaTypeInteger mode);
-=== file読み出し ===
+=== File Read ===
-filefptを読み出し,psへ格納します.
+Read a file '''fpt''', and store to '''ps'''.
   extern void psFileRead(psFile* ps, FILE* fpt, long mode);
-=== Header・フッタ・トレイラのWrite ===
+=== Write Header, Footer, Trailer ===
-psfileps->fptにHeaderをWriteます.(ラベル: ps->info.label, ページNo.: ps->info.page)
+Write header to ps file '''ps->fpt'''. (Label: '''ps->info.label''', Page No.: '''ps->info.page''')
-mode=0の場合は左下部から各1cmずつ右上の位置を,そうでない場合は左下部の位置を原点とします.
+If mode=0, set the origin to a point at side of each 1 cm right top  from the left bottom end. Otherwise, set the origin to the left bottom end point.
   extern void psFilePageStart(psFile* ps, psParaTypeInteger mode);
-psfileps->fptにフッタをWriteます.
+Write footer to ps file '''ps->fpt'''.
   extern void psFilePageEnd(psFile* ps, psParaTypeInteger mode);
-psfileps->fptにトレイラを追加します.
+Write trailer to ps file '''ps->fpt'''.
   extern void psFileEnd(psFile* ps);
-=== data判定 ===
+=== Check data ===
-文字列sがHeaderの場合は1を,そうでない場合は0を返します.
+If string '''s''' is Header, return 1. Otherwise, return 0.
   extern long psFileIsStartPage(psFile* ps, char* s);
-文字列sがフッタの場合は1を,そうでない場合は0を返します.
+If string '''s''' is Footer, return 1. Otherwise, return 0.
   extern long psFileIsEndPage(psFile* ps, char* s);
-=== 描画 ===
+=== Draw ===
 基本的にこれらの[[API]]は引数psImageInfoの([[#描画Setting]])を使用したSettingで描画します.<br>
 <br>
-==== 画像data ====
+==== Image data ====
 画像dataim.imageをpsfileps->fptへWriteます.<br>
 フラグ(imのメンバ)によって画像の種類をSettingできます.
@@ Line 276: / Line 276: @@
 <br>
-==== 円 ====
+==== Circle ====
 im.image内の正のdataを半径[pt]とした円をcoordinates(im.width, imheight)[pt]まで描画します.
   extern void psFileImageByCircles   (psFile* ps, psImageInfo im, psParaTypeInteger mode);
@@ Line 305: / Line 305: @@
 <br>
-==== 線 ====
+==== Line ====
 psに描画する線のWidthlineWidthをSettingします.
   extern void psFileLineWidthSet     (psFile* ps, float lineWidth);
@@ Line 311: / Line 311: @@
   extern void psFileLineDraw(psFile* ps, float x1,float y1,float x2,float y2);
-==== 樹形図 ====
+==== Dendrogram ====
 psに2つの点をつなぐ樹形図を描画します.
 width: 2点間の距離(Width), heightN: 要素Nに引く線の長さ(高さ)(N=1, 2), (x, y): 上段に引く線の中点
   extern void psFileDendgramLineDraw(psFile* ps, float width,float height1, float height2, float x, float y);
-==== 文字列 ====
+==== String ====
 psに表示する文字列のフォントfontname,サイズfontsizeをSettingします.
   extern void psFileStringStatusSet(psFile* ps, char* fontname, double fontsize);
@@ Line 324: / Line 324: @@
   extern void psFileString (psFile* ps, char* message, double x, double y, psParaTypeInteger mode);
-==== 境界線 ====
+==== Contour ====
 psに画像im.floatimageの境界線を描画します.
   extern void psFileContour(psFile* ps, psImageInfo im, psParaTypeInteger mode);
-==== 中心マーカ ====
+==== Center marker ====
 psに中心マーカを描画します.
   extern void psFileImageCentre      (psFile* ps, psImageInfo im, psParaTypeInteger mode);
-==== スケール ====
+==== Scale ====
 psにスケールを描画します.mode=psImageScaleModeBottomLeftの場合は左下部に,mode=psImageScaleModeCenterの場合は左中部に描画します.
   extern void psFileImageScale       (psFile* ps, psImageInfo im, psParaTypeInteger mode);
-==== 描画Setting ====
+==== Setting Drawing ====
 文字及び点のスケールを(im.scaleX, im.scaleY)[pt]で,原点を(im.translateX, im.translateY)[inch]とします.
   extern void psFileImageSpaceSet    (psFile* ps, psImageInfo im, psParaTypeInteger mode);