dispextern.h 5.13 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Interface definitions for display code.
Karl Heuer's avatar
Karl Heuer committed
2
   Copyright (C) 1985, 1993, 1994 Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
3 4 5 6 7

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Jim Blandy's avatar
Jim Blandy committed
8
the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */

/* Nonzero means last display completed and cursor is really at
   cursX, cursY.  Zero means it was preempted. */
extern int display_completed;

#ifdef HAVE_X_WINDOWS
25 26 27 28 29
#include <X11/Xlib.h>

struct face
  {
    /* If this is non-zero, it is a GC we can use without modification
30
       to represent this face.  */
31 32
    GC gc;
  
33
    /* Pixel value for foreground color.  */
34
    EMACS_UINT foreground;
35
  
36
    /* Pixel value for background color.  */
37
    EMACS_UINT background;
38
  
39 40
    /* Font used for this face.  */
    XFontStruct *font;
41
  
42
    /* Background stipple or bitmap used for this face.  */
43
    Pixmap stipple;
44 45 46

    /* Pixmap_depth.  */
    unsigned int pixmap_w, pixmap_h;
47
  
48
    /* Whether or not to underline text in this face.  */
49 50 51
    char underline;
  };

52
/* Let's stop using this and get rid of it.  */
53 54
typedef struct face *FACE;

55
#define NORMAL_FACE ((struct face *) 0)
56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77

#define FACE_HAS_GC(f) ((f)->gc)
#define FACE_GC(f) ((f)->gc)
#define FACE_FOREGROUND(f) ((f)->foreground)
#define FACE_BACKGROUND(f) ((f)->background)
#define FACE_FONT(f) ((f)->font)
#define FACE_STIPPLE(f) ((f)->stipple)
#define FACE_UNDERLINE_P(f) ((f)->underline)

#else  /* Not X */

typedef int FACE;

#define NORMAL_FACE 0x0
#define HIGHLIGHT_FACE 0x1
#define UNDERLINE_FACE 0x2
#define HIGHLIGHT_UNDERLINE_FACE 0x3

#define FACE_HIGHLIGHT(f) ((f) & 0x1)
#define FACE_UNDERLINE(f) ((f) & 0x2)
#endif /* Not X */

Jim Blandy's avatar
Jim Blandy committed
78

Jim Blandy's avatar
Jim Blandy committed
79
/* This structure is used for the actual display of text on a frame.
Jim Blandy's avatar
Jim Blandy committed
80 81 82

   There are two instantiations of it:  the glyphs currently displayed,
   and the glyphs we desire to display.  The latter object is generated
83
   from buffers being displayed.  */
Jim Blandy's avatar
Jim Blandy committed
84

Jim Blandy's avatar
Jim Blandy committed
85
struct frame_glyphs
Jim Blandy's avatar
Jim Blandy committed
86
  {
Jim Blandy's avatar
Jim Blandy committed
87
#ifdef MULTI_FRAME
88
    struct  frame *frame;	/* Frame these glyphs belong to.  */
Jim Blandy's avatar
Jim Blandy committed
89
#endif /* MULTI_FRAME */
Jim Blandy's avatar
Jim Blandy committed
90 91 92
    int height;
    int width;

Jim Blandy's avatar
Jim Blandy committed
93
    /* Contents of the frame.
Jim Blandy's avatar
Jim Blandy committed
94 95 96
       glyphs[V][H] is the glyph at position V, H.
       Note that glyphs[V][-1],
                 glyphs[V][used[V]],
Jim Blandy's avatar
Jim Blandy committed
97
	     and glyphs[V][frame_width] are always '\0'.  */
Jim Blandy's avatar
Jim Blandy committed
98 99 100 101
    GLYPH **glyphs;
    /* long vector from which the strings in `glyphs' are taken.  */
    GLYPH *total_contents;

Jim Blandy's avatar
Jim Blandy committed
102 103
    /* When representing a desired frame,
         enable[n] == 0 means that line n is same as current frame.
104
	 Between updates, all lines should be disabled.
Jim Blandy's avatar
Jim Blandy committed
105
       When representing current frame contents,
Jim Blandy's avatar
Jim Blandy committed
106 107 108 109 110 111
         enable[n] == 0 means that line n is blank.  */
    char *enable;

    /* Everything on line n after column used[n] is considered blank.  */
    int *used;

Jim Blandy's avatar
Jim Blandy committed
112 113 114
    /* highlight[n] != 0 iff line n is highlighted.  */
    char *highlight;

Richard M. Stallman's avatar
Richard M. Stallman committed
115 116 117
    /* Buffer offset of this line's first char.
       This is not really implemented, and cannot be,
       and should be deleted.  */
Jim Blandy's avatar
Jim Blandy committed
118 119 120
    int   *bufp;

#ifdef HAVE_X_WINDOWS
121
    /* Pixel position of top left corner of line.  */
122
    short *top_left_x;
Jim Blandy's avatar
Jim Blandy committed
123 124
    short *top_left_y;

125
    /* Pixel width of line.  */
126 127
    short *pix_width;

128
    /* Pixel height of line.  */
129
    short *pix_height;
Jim Blandy's avatar
Jim Blandy committed
130

131
    /* Largest font ascent on this line.  */
132 133
    short *max_ascent;
#endif	/* HAVE_X_WINDOWS */
134

Richard M. Stallman's avatar
Richard M. Stallman committed
135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
    /* Mapping of coordinate pairs to buffer positions.
       This field holds a vector indexed by row number.
       Its elements are vectors indexed by column number.
       Each element of these vectors is a buffer position, 0, or -1.

       For a column where the image of a text character starts,
       the element value is the buffer position of that character.
       When a window's screen line starts in mid character,
       the element for the line's first column (at the window's left margin)
       is that character's position.
       For successive columns within a multicolumn character,
       the element is -1.
       For the column just beyond the last glyph on a line,
       the element is the buffer position of the end of the line.
       For following columns within the same window, the element is 0.
       For rows past the end of the accessible buffer text,
       the window's first column has ZV and other columns have 0.

       Mode lines and vertical separator lines have 0.

       The column of a window's left margin
       always has a positive value (a buffer position), not 0 or -1,
       for each line in that window's interior.  */

159 160 161 162
    int **charstarts;

    /* This holds all the space in the subvectors of the charstarts field.  */
    int *total_charstarts;
163
  };
Jim Blandy's avatar
Jim Blandy committed
164 165

extern void get_display_line ();
166
extern Lisp_Object sit_for ();