MirOS Manual: rasops(9), rasops_init(9), rasops_reconfig(9)

RASOPS(9)                     BSD Kernel Manual                      RASOPS(9)


     rasops, rasops_init, rasops_reconfig - raster display operations


     #include <dev/wscons/wsdisplayvar.h>
     #include <dev/rasops/rasops.h>

     rasops_init(struct rasops_info *ri, int wantrows, int wantcols);

     rasops_reconfig(struct rasops_info *ri, int wantrows, int wantcols);


     The rasops subsystem is a set of raster operations for wscons(9).

     The primary data type for using the raster operations is the rasops_info
     structure in dev/rasops/rasops.h:

     struct rasops_info {

              * These must be filled in by the caller
             int     ri_depth;       /* depth in bits */
             u_char  *ri_bits;       /* ptr to bits */
             int     ri_width;       /* width (pels) */
             int     ri_height;      /* height (pels) */
             int     ri_stride;      /* stride in bytes */

              * These can optionally be left zeroed out. If you fill ri_font,
              * but aren't using wsfont, set ri_wsfcookie to -1.
             struct  wsdisplay_font *ri_font;
             int     ri_wsfcookie;   /* wsfont cookie */
             void    *ri_hw;         /* driver private data */
             int     ri_crow;        /* cursor row */
             int     ri_ccol;        /* cursor column */
             int     ri_flg;         /* various operational flags */

              * These are optional and will default if zero. Meaningless
              * on depths other than 15, 16, 24 and 32 bits per pel. On
              * 24 bit displays, ri_{r,g,b}num must be 8.
             u_char  ri_rnum;        /* number of bits for red */
             u_char  ri_gnum;        /* number of bits for green */
             u_char  ri_bnum;        /* number of bits for blue */
             u_char  ri_rpos;        /* which bit red starts at */
             u_char  ri_gpos;        /* which bit green starts at */
             u_char  ri_bpos;        /* which bit blue starts at */

              * These are filled in by rasops_init()
             int     ri_emuwidth;    /* width we actually care about */
             int     ri_emuheight;   /* height we actually care about */
             int     ri_emustride;   /* bytes per row we actually care about */
             int     ri_rows;        /* number of rows (characters) */
             int     ri_cols;        /* number of columns (characters) */
             int     ri_delta;       /* row delta in bytes */
             int     ri_pelbytes;    /* bytes per pel (may be zero) */
             int     ri_fontscale;   /* fontheight * fontstride */
             int     ri_xscale;      /* fontwidth * pelbytes */
             int     ri_yscale;      /* fontheight * stride */
             u_char  *ri_origbits;   /* where screen bits actually start */
             int     ri_xorigin;     /* where ri_bits begins (x) */
             int     ri_yorigin;     /* where ri_bits begins (y) */
             int32_t ri_devcmap[16]; /* color -> framebuffer data */

              * The emulops you need to use, and the screen caps for wscons
             struct  wsdisplay_emulops ri_ops;
             int     ri_caps;

              * Callbacks so we can share some code
             void    (*ri_do_cursor)(struct rasops_info *);
             void    (*ri_updatecursor)(struct rasops_info *);

     Valid values for the ri_flg member are:

           RI_FULLCLEAR   eraserows() hack to clear full screen
           RI_FORCEMONO   monochrome output even if we can do color
           RI_BSWAP       framebuffer endianness doesn't match CPU
           RI_CURSOR      cursor is switched on
           RI_CLEAR       clear display on startup
           RI_CENTER      center onscreen output
           RI_CURSORCLIP  cursor is currently clipped
           RI_CFGDONE     rasops_reconfig() completed successfully


     rasops_init(ri, wantrows, wantcols)
              Initialise a rasops_info descriptor. The arguments wantrows and
              wantcols are the number of rows and columns we'd like. In terms
              of optimization, fonts that are a multiple of 8 pixels wide work
              the best.

     rasops_reconfig(ri, wantrows, wantcols)
              Reconfigure a rasops_info descriptor because parameters have
              changed in some way. The arguments wantrows and wantcols are the
              number of rows and columns we'd like. If calling
              rasops_reconfig() to change the font and ri_wsfcookie >= 0, you
              must call wsfont_unlock() on it, and reset it to -1 (or a new,
              valid cookie).


     This section describes places within the OpenBSD source tree where actual
     code implementing or utilising the rasops subsystem can be found. All
     pathnames are relative to /usr/src.

     The rasops subsystem is implemented within the directory sys/dev/rasops.
     The rasops module itself is implemented within the file




     The rasops subsystem appeared in NetBSD 1.5 and OpenBSD first support ap-
     peared in OpenBSD 2.9.


     The rasops subsystem was written by Andrew Doran <ad@NetBSD.org>.

MirOS BSD #10-current          October 7, 2001                               1

Generated on 2015-10-25 00:47:46 by $MirOS: src/scripts/roff2htm,v 1.81 2015/10/16 13:19:09 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2015 The MirOS Project, Germany.
This product includes material provided by mirabilos.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.