DBaddPlan

Top  Previous  Next

Put in of a plan.

With this routine a new plan is put on within a segment. Every plan can be understood as a subset of the co-ordinate area of a whole segment. Besides, the plans may overlap. Within a plan management some plans are looked separately. The plan with the ID 0 contains all objects which were still assigned to no regular plan. The plan with the ID 1 contains all objects which contain no graphic information and have thus also no co-ordinates. Then these must be loaded by all users.

Parametre

segment (PSEGMENT) [IN]

This is the trading of the segment in which the new plan should be put on. Of this Trading was generated either with DBnewSegment, or was delivered by one of the listing functions DBfirstSegment and DBnextSegment.

name (const char *) [IN]

This is the name of the plan and at the same time the name of the file in which this plan is protected. The path under which this file is to be found is determined with the parametre pfad. With the securing and store ""it is suspended in name a suitable suffix, possibly".DBB". So still no file extension may have name before.

version (USHORT) [IN]

This information is not transmitted inside.

xlow (STANDS IN) [IN]

This is the x co-ordinate of the left side of the new plan. These co-ordinates are given as absolute co-ordinates, so usually in the region innkeeper's system.

ylow (STANDS IN) [IN]

This is the Y co-ordinate of the left side of the new plan. These co-ordinates are given as absolute co-ordinates, so usually in the region innkeeper's system.

scale (stands in) [IN]

Herewith the relative size of the texts is fixed in this plan. Thus texts can be adapted according to plot graduation in her size. The graduation with which the size of the texts is right is given on this occasion. If the plot is given in another graduation, the text dimensions are converted. If a text with 2.5 mm is given with Textscale in 1000 and the plan becomes with 1:2000 geplottet, the text with 1.25-mm size is given.

xhigh (STANDS IN) [IN]

This is the x co-ordinate of the right side of the new plan. These co-ordinates are given as absolute co-ordinates, so usually in the region innkeeper's system.

yhigh (STANDS IN) [IN]

This is the Y co-ordinate of the right side of the new plan. These co-ordinates are given as absolute co-ordinates, so usually in the region innkeeper's system.

pfad (char *) [IN]

Under this path with the file name given on top name the file is protected and loaded.

writeable (BOOLEAN) [IN]

If writeable TRUE is, the user may change this plan. Then, moreover, the plan is closed with the store for other users. Though these may look at the plan, but not change. Is writeable FALSE, the user may carry out no changes in this plan, insert no objects so also.

blockId (ULONG) [IN]

sysId (ULONG) [IN]

This is the marking unequivocal within the segment of the plan. In a plan management the position and expansion of the plan is also determined by these ID. If as an ID the value 0 is given, the data bank puts down own value.

flags (int) [IN]

At the moment no Flags are defined as if this value can be any.

loader (char *) [IN]

Name of the data format with which this plan is treated. This format is automatically called with the securing of the plan. Examples are "HDF", "DGN" or "DBB". The full list of the formats is given with the command Load, however, is depending on the installed software.

resolution (stands in) [IN]

Resolution of the co-ordinates. This is only with data formats like DBB a significant value with which the co-ordinates are stored as a fixed comma number.

Result

(PPLANS) [OUT]

The procedure delivers the trading of the anew generated plan back, in the mistake case ZERO is delivered. With this trading, e.g., the new objects which are assigned then immediately to this plan can be put on.

Declaration

#include "database.h"

 

PPLANS DLLENTRY DBaddPlan (

PSEGMENT segment,

const char * name,

USHORT version,

STAND-IN xlow,

STAND-IN ylow,

stand in scale,

STAND-IN xhigh,

STAND-IN yhigh,

ULONG blockId,

ULONG sysId,

int flags,

char * loader,

stand in resolution

);

Related functions

DBaddSegment