X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=docs%2Flibglabels%2Ftmpl%2Ftemplate.sgml;fp=docs%2Flibglabels%2Ftmpl%2Ftemplate.sgml;h=0000000000000000000000000000000000000000;hb=db2403f05e4bd16e08346e4896e8feead63d0b12;hp=e7a58879a76688eaebdd97e5c8ca8e2d51346a43;hpb=9971dd3e6268224ee930a26fdb30f22395406233;p=glabels
diff --git a/docs/libglabels/tmpl/template.sgml b/docs/libglabels/tmpl/template.sgml
deleted file mode 100644
index e7a58879..00000000
--- a/docs/libglabels/tmpl/template.sgml
+++ /dev/null
@@ -1,532 +0,0 @@
-
-The lglTemplate Structure
-
-
-How templates are represented in memory
-
-
-
-This section describes a set of structures that represent a template in memory. It also
-describes functions to help create and interpret these structures.
-
-
-
-
-
-
-
-
-
-
-
-
-This is the main structure of a libglabels template. A template represents a single sheet
-of peel-off labels or cards.
-
-
-@brand: Brand name of label or card. E.g. "Avery."
-@part: Part name or number of label or card. E.g. "8160."
-@description: A description of the template. E.g. "Mailing labels."
-@paper_id: A paper ID. E.g. "A4" or "US-Letter."
-@page_width: Page width in points. Used only if paper_id is "Other."
-@page_height: Page height in points. Used only if paper_id is "Other."
-@aliases: A list of alternate names for this template. Often a single template can be used for
-multiple products.
-@category_ids: A list of category IDs that this template belongs to.
-@frames: A list of (#lglTemplateFrame *) structures. GLabels currently only supports one frame
-per template -- future versions may support multiple frames per template.
-
-
-
-This structure defines an alias for the parent template structure. An alias is used for
-different products that can use the same template.
-
-
-@brand: Brand name of label or card. E.g. "Avery."
-@part: Part name or number of label or card. E.g. "8160."
-
-
-
-This enumeration defines frame types that are supported by libglabels
-
-
-@LGL_TEMPLATE_FRAME_SHAPE_RECT: A rectangular frame. (May have rounded corners.)
-@LGL_TEMPLATE_FRAME_SHAPE_ROUND: A round frame.
-@LGL_TEMPLATE_FRAME_SHAPE_CD: A CD or DVD frame. (Includes credit-card style CDs.)
-
-
-
-A union of all possible frame structures. The type of structure is indicated by the shape
-member, which overlays the first field of all other member structures.
-
-
-
-
-
-This structure is composed of a set of fields common to all frame structures. All frame types
-can be cast to this structure.
-
-
-@shape: The shape of the frame.
-@id: Reserved for future use. Should always be zero.
-@layouts: A list of (#lglTemplateLayout *) structures. Typically a frame will have a single
-layout, representing a simple grid of labels or cards. If the layout of labels or cards is
-more complex, multiple (#lglTemplateLayout *) structures may be needed.
-@markups: A list of (#lglTemplateMarkup *) structures, which represent non-printing markup lines.
-
-
-
-This structure defines the frame for a rectangular label or card.
-
-
-@shape: Common field. Always #LGL_TEMPLATE_FRAME_SHAPE_RECT for #lglTemplateFrameRect.
-@id: Common field. See #lglTemplateFrameAll.
-@layouts: Common field. See #lglTemplateFrameAll.
-@markups: Common field. See #lglTemplateFrameAll.
-@w: Width of label or card in points.
-@h: Height of label or card in points.
-@r: Radius of corners in points.
-@x_waste: Amount of horizontal over-print to allow in points.
-@y_waste: Amount of vertical over-print to allow in points.
-
-
-
-This structure defines the frame for a round label or card.
-
-
-@shape: Common field. Always #LGL_TEMPLATE_FRAME_SHAPE_ROUND for #lglTemplateFrameRound.
-@id: Common field. See #lglTemplateFrameAll.
-@layouts: Common field. See #lglTemplateFrameAll.
-@markups: Common field. See #lglTemplateFrameAll.
-@r: Radius of label or card in points.
-@waste: Amount of over-print to allow in points.
-
-
-
-This structure defines the frame for a CD or DVD label. This structure also supports
-credit-card CD labels.
-
-
-@shape: Common field. Always #LGL_TEMPLATE_FRAME_SHAPE_CD for #lglTemplateFrameCD.
-@id: Common field. See #lglTemplateFrameAll.
-@layouts: Common field. See #lglTemplateFrameAll.
-@markups: Common field. See #lglTemplateFrameAll.
-@r1: Outer radius of label in points.
-@r2: Radius of center hole in points.
-@w: Clip width in points. Used for credit-card CD labels. This field is ignored if zero.
-@h: Clip height in points. Used for credit-card CD labels. This field is ignored if zero.
-@waste: Amount of over-print to allow in points.
-
-
-
-This structure defines a simple grid layout of labels or cards.
-
-
-@nx: Number of labels or cards across in the grid (horizontal).
-@ny: Number of labels or cards down in the grid (vertical).
-@x0: Distance (in points) from the left edge of page to the left edge of the left column of
-cards or labels in the layout.
-@y0: Distance (in points) from the top edge of page to the top edge of the top row of
-cards or labels in the layout.
-@dx: Horizontal pitch of grid in points. This is the distance from left edge to left edge
-(not the gap between labels or cards).
-@dy: Vertical pitch of grid in points. This is the distance from top edge to top edge
-(not the gap between labels or cards).
-
-
-
-This enumeration defines markup types that are supported by libglabels
-
-
-@LGL_TEMPLATE_MARKUP_MARGIN: A margin line around perimeter of label or card.
-@LGL_TEMPLATE_MARKUP_LINE: A simple line segment.
-@LGL_TEMPLATE_MARKUP_CIRCLE: A circle.
-@LGL_TEMPLATE_MARKUP_RECT: A rectangle. Possibly with rounded corners.
-
-
-
-A union of all possible markup structures. The type of structure is indicated by the type
-member, which overlays the first field of all other member structures.
-
-
-
-
-
-This structure defines a simple margin markup around the perimeter of a label or card.
-
-
-@type: Common field. Always #LGL_TEMPLATE_MARKUP_MARGIN for #lglTemplateMarkupMargin.
-@size: Distance of margin from edge of label or card.
-
-
-
-This structure defines a simple line segment markup.
-
-
-@type: Common field. Always #LGL_TEMPLATE_MARKUP_LINE for #lglTemplateMarkupLine.
-@x1: Distance (in points) of first endpoint from left edge of label or card.
-@y1: Distance (in points) of first endpoint from top edge of label or card.
-@x2: Distance (in points) of second endpoint from left edge of label or card.
-@y2: Distance (in points) of second endpoint from top edge of label or card.
-
-
-
-This structure defines a simple circle markup.
-
-
-@type: Common field. Always #LGL_TEMPLATE_MARKUP_CIRCLE for #lglTemplateMarkupCircle.
-@x0: Distance (in points) of vertex from left edge of label or card.
-@y0: Distance (in points) of vertex from top edge of label or card.
-@r: Radius of circle in points.
-
-
-
-This structure defines a simple rectangle markup. The rectangle can have rounded corners.
-
-
-@type: Common field. Always #LGL_TEMPLATE_MARKUP_RECT for #lglTemplateMarkupRect.
-@x1: Distance (in points) of left edge of markup from left edge of label or card.
-@y1: Distance (in points) of top edge of markup from top edge of label or card.
-@w: Width of rectangle in points.
-@h: Height of rectangle in points.
-@r: Radius of corners in points. Should be zero for sharp corners.
-
-
-
-This structure represents the cartesian coordinates of the origin of a label or card on the page.
-The orign is the upper left corner of the extent of the label or card. These coordinates are
-relative to the upper left corner of the page.
-
-
-@x: Distance in points from top edge of page.
-@y: Distance in points from left edge of page.
-
-
-
-
-
-
-@brand:
-@part:
-@description:
-@paper_id:
-@page_width:
-@page_height:
-@Returns:
-
-
-
-
-
-
-
-@orig_template:
-@Returns:
-
-
-
-
-
-
-
-@template:
-
-
-
-
-
-
-
-@template:
-@category_id:
-
-
-
-
-
-
-
-@template:
-@frame:
-
-
-
-
-
-
-
-@template:
-@alias:
-
-
-
-
-
-
-
-@template:
-@Returns:
-
-
-
-
-
-
-
-@template1:
-@template2:
-@Returns:
-
-
-
-
-
-
-
-@template:
-@brand:
-@Returns:
-
-
-
-
-
-
-
-@template:
-@paper_id:
-@Returns:
-
-
-
-
-
-
-
-@template:
-@category_id:
-@Returns:
-
-
-
-
-
-
-
-@brand:
-@part:
-@Returns:
-
-
-
-
-
-
-
-@orig_alias:
-@Returns:
-
-
-
-
-
-
-
-@alias:
-
-
-
-
-
-
-
-@id:
-@w:
-@h:
-@r:
-@x_waste:
-@y_waste:
-@Returns:
-
-
-
-
-
-
-
-@id:
-@r:
-@waste:
-@Returns:
-
-
-
-
-
-
-
-@id:
-@r1:
-@r2:
-@w:
-@h:
-@waste:
-@Returns:
-
-
-
-
-
-
-
-@orig_frame:
-@Returns:
-
-
-
-
-
-
-
-@frame:
-
-
-
-
-
-
-
-@frame:
-@layout:
-
-
-
-
-
-
-
-@frame:
-@markup:
-
-
-
-
-
-
-
-@frame:
-@w:
-@h:
-
-
-
-
-
-
-
-@frame:
-@Returns:
-
-
-
-
-
-
-
-@frame:
-@Returns:
-
-
-
-
-
-
-
-@nx:
-@ny:
-@x0:
-@y0:
-@dx:
-@dy:
-@Returns:
-
-
-
-
-
-
-
-@orig_layout:
-@Returns:
-
-
-
-
-
-
-
-@layout:
-
-
-
-
-
-
-
-@size:
-@Returns:
-
-
-
-
-
-
-
-@x1:
-@y1:
-@x2:
-@y2:
-@Returns:
-
-
-
-
-
-
-
-@x0:
-@y0:
-@r:
-@Returns:
-
-
-
-
-
-
-
-@x1:
-@y1:
-@w:
-@h:
-@r:
-@Returns:
-
-
-
-
-
-
-
-@orig_markup:
-@Returns:
-
-
-
-
-
-
-
-@markup:
-
-